mirror of
https://github.com/gryf/wmaker.git
synced 2026-02-02 06:05:45 +01:00
doc: explain how to compile with language support
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.curis@free.fr>
This commit is contained in:
committed by
Carlos R. Mafra
parent
b944a4beb2
commit
bd49dbc2f5
@@ -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
|
||||
|
||||
45
doc/build/Translations.texi
vendored
45
doc/build/Translations.texi
vendored
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user