Now that the setup in configure.ac have been cleaned, moved the original documentation from the 'INSTALL-WMAKER' file into the dedicated doc 'README.i18n' and updated it.
The information is completely removed from 'INSTALL-WMAKER' with an invitation to see the new i18n doc in order to keep that file relatively small and to avoid duplicating information, which is always harder to maintain. Signed-off-by: Christophe CURIS <christophe.cu...@free.fr> --- INSTALL-WMAKER | 34 ++-------------------------------- doc/build/Translations.texi | 45 +++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 47 insertions(+), 32 deletions(-) diff --git a/INSTALL-WMAKER b/INSTALL-WMAKER index b47cca1..b6aa0ea 100644 --- a/INSTALL-WMAKER +++ b/INSTALL-WMAKER @@ -381,38 +381,8 @@ visible in the console or in the .xsession-errors file. LOCALES/INTERNATIONALIZATION ============================ -Window Maker has national language support. To enable national language -support, you must compile Window Maker with some additional parameters. - - -0 - You must have the GNU gettext package installed. It can be -obtained at ftp://prep.ai.mit.edu/pub/gnu/gettext-nnn.tar.gz - -Steps 1 to 3 can be skipped if you use the Install script. - -1 - You have to select the languages you want to support. Set the -LINGUAS to the list of locales you want. English is always -supported. Example: - -setenv LINGUAS "pt ja de" -in csh - -or - -export LINGUAS;LINGUAS="pt ja de" -in sh - -The list of supported locales can be found in po/README. -English is the default language. - -Read po/README if you wish to translate and maintain locale files -for other languages. - -2 - Additionally, if your language uses multi-byte characters, such -as Japanese or Korean, you must set the MultiByteText option to YES -in ~/GNUstep/Defaults/WMGLOBAL - -3 - Configure, build and install Window Maker normally. +Window Maker has national language support. The procedure to enable national +language support is described in the dedicated README.i18n file. 4 - To select a particular locale at run-time you must set the LANG environment variable to the locale you want. For example, if you want to set diff --git a/doc/build/Translations.texi b/doc/build/Translations.texi index fc5e21e..b9c6d48 100644 --- a/doc/build/Translations.texi +++ b/doc/build/Translations.texi @@ -79,8 +79,53 @@ This manual is for Window Maker, version @value{version}. @end ifnottex @menu +* Enabling Languages support:: How to compile Window Maker with i18n support @end menu +@c ------------------------------------------------------------------ Enabling Languages support --- + +@node Enabling Languages support +@chapter Enabling Languages support + +@sc{Window Maker} has the possibility to be translated in many languages, but by default none of +them will be installed, and the support for translation will not be compiled. + +To enable the translation capabilities, you have to specify which language(s) you want to be +installed: this is done with the variable @env{LINGUAS} when running the @command{configure} script. +This variable should contain the space-separated list of languages you want to install. + +You could for instance enable both French (@code{fr}) and Dutch (@code{nl}) with this: + +@example +./configure LINGUAS="fr nl" +@end example + +You can of course add any other option that you want to the @command{configure} command. +From the moment you specify the variable, the @command{configure} script will check that you have +the appropriate dependencies for this (basically the @code{gettext} function and the @code{libintl} +library); when you run @command{make} to compile the project, it will also compile the translation +(@code{mo} files) for the language(s) you asked (if available, of course), and during +@command{make install} it will install them in the usual directory. + + +@c --------------------------------------------------------------------- LINGUAS at system level --- +@section Setting @env{LINGUAS} at system level + +As the variable @env{LINGUAS} is quite standard, you also have the possibility to set its value in +the @file{config.site} file for @sc{Autoconf}. +This file can be placed in one of these paths: + +@itemize @bullet +@item @file{@emph{<prefix>}/share/config.site} +@item @file{@emph{<prefix>}/etc/config.site} +@end itemize + +This way, the same language list will be used for all the programs that use @sc{Autoconf} that you +would compile. +Please note that if you also specify a value on the command line, it will have precedence over the +value in that file. + + @c ------------------------------------------------------------------------------------- The End --- @bye -- 2.1.4 -- To unsubscribe, send mail to wmaker-dev-unsubscr...@lists.windowmaker.org.
