Some minor clarifications for find()'s arguments based on SF bug

warsaw · warsaw · commit 91b81c480200 · 2001-10-18T19:41:48.000Z
#463572.  Closing.
diff --git a/Doc/lib/libgettext.tex b/Doc/lib/libgettext.tex
@@ -98,18 +98,19 @@ \subsection{Class-based API}
 \begin{funcdesc}{find}{domain\optional{, localedir\optional{, languages}}}
 This function implements the standard \file{.mo} file search
 algorithm.  It takes a \var{domain}, identical to what
-\function{textdomain()} takes, and optionally a \var{localedir} (as in
-\function{bindtextdomain()}), and a list of languages.  All arguments
-are strings.
+\function{textdomain()} takes.  Optional \var{localedir} is as in
+\function{bindtextdomain()}  Optional \var{languages} is a list of
+strings, where each string is a language code.
 
 If \var{localedir} is not given, then the default system locale
 directory is used.\footnote{See the footnote for
 \function{bindtextdomain()} above.}  If \var{languages} is not given,
 then the following environment variables are searched: \envvar{LANGUAGE},
 \envvar{LC_ALL}, \envvar{LC_MESSAGES}, and \envvar{LANG}.  The first one
 returning a non-empty value is used for the \var{languages} variable.
-The environment variables can contain a colon separated list of
-languages, which will be split.
+The environment variables should contain a colon separated list of
+languages, which will be split on the colon to produce the expected
+list of language code strings.
 
 \function{find()} then expands and normalizes the languages, and then
 iterates through them, searching for an existing file built of these
