<HTML> <HEAD> <!-- This HTML file has been created by texi2html 1.52b from gettext.texi on 27 November 2006 --> <META HTTP-EQUIV="content-type" CONTENT="text/html; charset=UTF-8"> <TITLE>GNU gettext utilities - 2 The User's View</TITLE> </HEAD> <BODY> Go to the <A HREF="gettext_1.html">first</A>, <A HREF="gettext_1.html">previous</A>, <A HREF="gettext_3.html">next</A>, <A HREF="gettext_25.html">last</A> section, <A HREF="gettext_toc.html">table of contents</A>. <P><HR><P> <H1><A NAME="SEC7" HREF="gettext_toc.html#TOC7">2 The User's View</A></H1> <P> When GNU <CODE>gettext</CODE> will truly have reached its goal, average users should feel some kind of astonished pleasure, seeing the effect of that strange kind of magic that just makes their own native language appear everywhere on their screens. As for naive users, they would ideally have no special pleasure about it, merely taking their own language for <EM>granted</EM>, and becoming rather unhappy otherwise. </P> <P> So, let's try to describe here how we would like the magic to operate, as we want the users' view to be the simplest, among all ways one could look at GNU <CODE>gettext</CODE>. All other software engineers: programmers, translators, maintainers, should work together in such a way that the magic becomes possible. This is a long and progressive undertaking, and information is available about the progress of the Translation Project. </P> <P> When a package is distributed, there are two kinds of users: <EM>installers</EM> who fetch the distribution, unpack it, configure it, compile it and install it for themselves or others to use; and <EM>end users</EM> that call programs of the package, once these have been installed at their site. GNU <CODE>gettext</CODE> is offering magic for both installers and end users. </P> <H2><A NAME="SEC8" HREF="gettext_toc.html#TOC8">2.1 The Current <TT>‘ABOUT-NLS’</TT> Matrix</A></H2> <P> <A NAME="IDX39"></A> <A NAME="IDX40"></A> <A NAME="IDX41"></A> </P> <P> Languages are not equally supported in all packages using GNU <CODE>gettext</CODE>. To know if some package uses GNU <CODE>gettext</CODE>, one may check the distribution for the <TT>‘ABOUT-NLS’</TT> information file, for some <TT>‘<VAR>ll</VAR>.po’</TT> files, often kept together into some <TT>‘po/’</TT> directory, or for an <TT>‘intl/’</TT> directory. Internationalized packages have usually many <TT>‘<VAR>ll</VAR>.po’</TT> files, where <VAR>ll</VAR> represents the language. section <A HREF="gettext_2.html#SEC9">2.2 Magic for End Users</A> for a complete description of the format for <VAR>ll</VAR>. </P> <P> More generally, a matrix is available for showing the current state of the Translation Project, listing which packages are prepared for multi-lingual messages, and which languages are supported by each. Because this information changes often, this matrix is not kept within this GNU <CODE>gettext</CODE> manual. This information is often found in file <TT>‘ABOUT-NLS’</TT> from various distributions, but is also as old as the distribution itself. A recent copy of this <TT>‘ABOUT-NLS’</TT> file, containing up-to-date information, should generally be found on the Translation Project sites, and also on most GNU archive sites. </P> <H2><A NAME="SEC9" HREF="gettext_toc.html#TOC9">2.2 Magic for End Users</A></H2> <P> <A NAME="IDX42"></A> <A NAME="IDX43"></A> <A NAME="IDX44"></A> </P> <P> <A NAME="IDX45"></A> We consider here those packages using GNU <CODE>gettext</CODE> internally, and for which the installers did not disable translation at <EM>configure</EM> time. Then, users only have to set the <CODE>LANG</CODE> environment variable to the appropriate <SAMP>‘<VAR>ll</VAR>_<VAR>CC</VAR>’</SAMP> combination prior to using the programs in the package. See section <A HREF="gettext_2.html#SEC8">2.1 The Current <TT>‘ABOUT-NLS’</TT> Matrix</A>. For example, let's presume a German site. At the shell prompt, users merely have to execute <SAMP>‘setenv LANG de_DE’</SAMP> (in <CODE>csh</CODE>) or <SAMP>‘export LANG; LANG=de_DE’</SAMP> (in <CODE>sh</CODE>). They could even do this from their <TT>‘.login’</TT> or <TT>‘.profile’</TT> file. </P> <P><HR><P> Go to the <A HREF="gettext_1.html">first</A>, <A HREF="gettext_1.html">previous</A>, <A HREF="gettext_3.html">next</A>, <A HREF="gettext_25.html">last</A> section, <A HREF="gettext_toc.html">table of contents</A>. </BODY> </HTML> |