paweld/lazarus
1
0
Fork 0
mirror of https://gitlab.com/freepascal.org/lazarus/lazarus.git synced 2025-12-10 12:17:14 +01:00
Code Issues Packages Projects Releases Wiki Activity

Docs: LazUtils/lazutf8. Updates or removes topics for changes in e13533d1.

Browse Source 
* Updates: LazGetLanguageIDs for functionality merged from LazTrimLanguageID.
* Removes: LazTrimLanguageID.
This commit is contained in:
dsiders 2023-06-06 03:43:46 +01:00
parent 84bb887aee
commit aad8ebec07
1 changed files with 16 additions and 31 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

47
docs/xml/lazutils/lazutf8.xml
View File

@ -2839,19 +2839,30 @@ Unfinished source char has occurred
<short>Gets the Language ID and a fallback value for the platform.</short> <short>Gets the Language ID and a fallback value for the platform.</short>
<descr> <descr>
<p> <p>
<var>LazGetLanguageIDs</var> is a procedure used to get the primary language <var>LazGetLanguageIDs</var> is a procedure used to get the language
ID and a fallback value. The values are returned in the <var>Lang</var> and identifier and a fallback value. The values are returned in the
<var>FallbackLang</var> variable parameters. <var>Lang</var> and <var>FallbackLang</var> variable parameters.
</p> </p>
<p> <p>
The implementation for the routine is platform or operating-system specific. The implementation for the routine is platform or operating-system specific.
For the Darwin platform, localizations in the Main bundle are checked for For the Darwin platform, localizations in the Main bundle are checked for
language and fallback values. For other platforms, the language and fallback values. For other platforms, the
<var>GetLanguageIDs</var> routine in the <file>GetText</file> unit is called <var>GetLanguageIDs</var> routine in the <file>GetText</file> unit is called
is called to get the default Language Code ID. The value in FallbackLang is called to get the default Language Code ID. The value in FallbackLang
appends the country code to the value in Lang. includes the country code appended to the value in Lang.
</p>
<p>
On the Linux platform, the language identifier can be in the form
'ru_RU.utf8'. The encoding suffix can prevent loading of translations files in
the form 'project1.ru_RU.po'. To prevent this situation, the encoding suffix
is removed from the Lang argument value. It contains only the value prior to
the initial '.' character found in the language identifier.
</p> </p>
</descr> </descr>
<version>
Modified in LazUtils version 2.4.0 to merge the functionality from the now
removed LazTrimLanguageID routine.
</version>
<seealso/> <seealso/>
</element> </element>
<element name="LazGetLanguageIDs.Lang"> <element name="LazGetLanguageIDs.Lang">
@ -2885,32 +2896,6 @@ fallback language ID as the value for the Lang argument.
<short>Language ID examined in the routine.</short> <short>Language ID examined in the routine.</short>
</element> </element>
<element name="LazTrimLanguageID">
<short>
Returns the language identifier with an encoding suffix removed from the
specified value.
</short>
<descr>
<p>
The <var>Lang</var> argument can sometimes be in the form 'ru_RU.utf8',
which will prevent loading a file with a language identifier in the form
'project1.ru_RU.po'. This procedure trims the encoding value from the argument.
</p>
</descr>
<version>
Added in LazUtils version 2.4.0.
</version>
<seealso>
<link id="#lcl.lcltranslator.TranslateUnitResourceStringsEx">TranslateUnitResourceStringsEx</link>
</seealso>
</element>
<element name="LazTrimLanguageID.Lang">
<short>
Variable parameter with the language identifier examined and modified in the
routine.
</short>
</element>
<element name="FPUpChars"> <element name="FPUpChars">
<short> <short>
Contains uppercase characters for all values in the char type. Contains uppercase characters for all values in the char type.