Cleanup: move public doc-strings into headers for 'blentranslation'

Ref T92709
This commit is contained in:
Campbell Barton 2021-12-08 17:54:22 +11:00
parent ca0c9757f2
commit 07726ef1b6
Notes: blender-bot 2023-02-14 08:39:23 +01:00
Referenced by issue #93854, Relocate doc-strings into public headers
Referenced by issue #92709, Code Style: documentation at declaration or definition
3 changed files with 14 additions and 13 deletions

View File

@ -46,6 +46,15 @@ const char *BLT_lang_get(void);
* Non-null elements are always MEM_mallocN'ed, it's the caller's responsibility to free them.
* NOTE: Always available, even in non-WITH_INTERNATIONAL builds.
*/
/**
* Get locale's elements (if relevant pointer is not NULL and element actually exists, e.g.
* if there is no variant,
* *variant and *language_variant will always be NULL).
* Non-null elements are always MEM_mallocN'ed, it's the caller's responsibility to free them.
*
* \note Keep that one always available, you never know,
* may become useful even in no #WITH_INTERNATIONAL context.
*/
void BLT_lang_locale_explode(const char *locale,
char **language,
char **country,

View File

@ -44,6 +44,11 @@ const char *BLT_translate_do_iface(const char *msgctxt, const char *msgid);
const char *BLT_translate_do_tooltip(const char *msgctxt, const char *msgid);
const char *BLT_translate_do_new_dataname(const char *msgctxt, const char *msgid);
/**
* Note that "lang" here is the _output_ display language. We used to restrict
* IME for keyboard _input_ language because our multilingual font was only used
* when some output languages were selected. That font is used all the time now.
*/
bool BLT_lang_is_ime_supported(void);
/* The "translation-marker" macro. */

View File

@ -282,7 +282,6 @@ void BLT_lang_set(const char *str)
IMB_thumb_clear_translations();
}
/* Get the current locale (short code, e.g. es_ES). */
const char *BLT_lang_get(void)
{
#ifdef WITH_INTERNATIONAL
@ -303,15 +302,6 @@ const char *BLT_lang_get(void)
#undef LOCALE
#undef ULANGUAGE
/**
* Get locale's elements (if relevant pointer is not NULL and element actually exists, e.g.
* if there is no variant,
* *variant and *language_variant will always be NULL).
* Non-null elements are always MEM_mallocN'ed, it's the caller's responsibility to free them.
*
* \note Keep that one always available, you never know,
* may become useful even in no #WITH_INTERNATIONAL context.
*/
void BLT_lang_locale_explode(const char *locale,
char **language,
char **country,
@ -372,9 +362,6 @@ void BLT_lang_locale_explode(const char *locale,
}
}
/* Note that "lang" here is the _output_ display language. We used to restrict
* IME for keyboard _input_ language because our multilingual font was only used
* when some output languages were selected. That font is used all the time now. */
bool BLT_lang_is_ime_supported(void)
{
#ifdef WITH_INPUT_IME