<!-- ##### SECTION Title ##### -->
translate

<!-- ##### SECTION Short_Description ##### -->
library initialization and core functions

<!-- ##### SECTION Long_Description ##### -->
<para>
The following functions, variables and macros are used to determine
the libtranslate version, initialize libtranslate, manipulate
services, languages and the network proxy.
</para>

<!-- ##### SECTION See_Also ##### -->
<para>

</para>

<!-- ##### MACRO TRANSLATE_MAJOR_VERSION ##### -->
<para>
Like #translate_major_version, but from the headers used at
application compile time, rather than from the library linked against
at application runtime.
</para>



<!-- ##### MACRO TRANSLATE_MINOR_VERSION ##### -->
<para>
Like #translate_minor_version, but from the headers used at
application compile time, rather than from the library linked against
at application runtime.
</para>



<!-- ##### MACRO TRANSLATE_MICRO_VERSION ##### -->
<para>
Like #translate_micro_version, but from the headers used at
application compile time, rather than from the library linked against
at application runtime.
</para>



<!-- ##### VARIABLE translate_major_version ##### -->
<para>
The major version number of libtranslate.

This variable is in the library, so it represents the translate
library you have linked against. Contrast with the
#TRANSLATE_MAJOR_VERSION macro, which represents the major version of
the libtranslate headers you have included.
</para>


<!-- ##### VARIABLE translate_minor_version ##### -->
<para>
The minor version number of libtranslate.

This variable is in the library, so it represents the translate
library you have linked against. Contrast with the
#TRANSLATE_MINOR_VERSION macro, which represents the minor version of
the libtranslate headers you have included.
</para>


<!-- ##### VARIABLE translate_micro_version ##### -->
<para>
The micro version number of libtranslate.

This variable is in the library, so it represents the translate
library you have linked against. Contrast with the
#TRANSLATE_MICRO_VERSION macro, which represents the micro version of
the libtranslate headers you have included.
</para>


<!-- ##### MACRO TRANSLATE_ERROR ##### -->
<para>
Generic libtranslate error domain. Errors in this domain are from the
#TranslateError enumeration.
</para>



<!-- ##### MACRO TRANSLATE_INIT_ERROR ##### -->
<para>
The error domain of translate_init(). Errors in this domain are from
the #TranslateInitError enumeration.
</para>



<!-- ##### ENUM TranslateError ##### -->
<para>
Generic error codes returned by libtranslate routines when more
specialized error codes are not relevant.
</para>

@TRANSLATE_ERROR_FAILED: a generic error has occurred
@TRANSLATE_ERROR_CANCELLED: the user has cancelled the operation

<!-- ##### ENUM TranslateInitError ##### -->
<para>
Error codes returned by translate_init().
</para>

@TRANSLATE_INIT_ERROR_MULTI_THREADING_NOT_SUPPORTED: multi-threading is not supported

<!-- ##### USER_FUNCTION TranslateModuleInitFunc ##### -->
<para>

</para>

@err: 
@Returns: 


<!-- ##### VARIABLE translate_initialized ##### -->
<para>
Whether libtranslate is initialized or not (read-only). You probably
do not need to use this variable, as translate_init() can be called
multiple times.
</para>


<!-- ##### FUNCTION translate_init ##### -->
<para>

</para>

@err: 
@Returns: 


<!-- ##### FUNCTION translate_add_service ##### -->
<para>

</para>

@service: 
@Returns: 


<!-- ##### FUNCTION translate_get_service ##### -->
<para>

</para>

@name: 
@Returns: 


<!-- ##### FUNCTION translate_get_services ##### -->
<para>

</para>

@Returns: 


<!-- ##### FUNCTION translate_add_language ##### -->
<para>

</para>

@tag: 
@name: 
@Returns: 


<!-- ##### FUNCTION translate_get_language_name ##### -->
<para>

</para>

@tag: 
@Returns: 


<!-- ##### FUNCTION translate_set_proxy ##### -->
<para>

</para>

@uri: 


<!-- ##### FUNCTION translate_get_proxy ##### -->
<para>

</para>

@Returns: 


