Explain xgettext output file name.

diff --git a/doc/ChangeLog b/doc/ChangeLog
index a2436a046465413440c41abeb75776fb9e09fd5b..336fbd8304e98fa73250685e8f4ae735e02aaae2 100644 (file)
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2002-05-28  Bruno Haible  <bruno@clisp.org>
+
+       * gettext.texi (Template): Discuss the file extension.
+       Reported by Mark Eichin <eichin@thok.org>.
+
 2002-05-14  Bruno Haible  <bruno@clisp.org>
 
        * gettext.texi (PO Files): Add two examples.

diff --git a/doc/gettext.texi b/doc/gettext.texi
index 86d72c4a2320b63e8b8ec07fcae6c50d1e823add..ff1366008962ad3abddf649025ac101962d0624a 100644 (file)
--- a/doc/gettext.texi
+++ b/doc/gettext.texi
@@ -2359,6 +2359,13 @@ use this second method in this situation.
 After preparing the sources, the programmer creates a PO template file.
 This section explains how to use @code{xgettext} for this purpose.
 
+@code{xgettext} creates a file named @file{@var{domainname}.po}.  You
+should then rename it to @file{@var{domainname}.pot}.  (Why doesn't
+@code{xgettext} create it under the name @file{@var{domainname}.pot}
+right away?  The answer is: for historical reasons.  When @code{xgettext}
+was specified, the distinction between a PO file and PO file template
+was fuzzy, and the suffix @samp{.pot} wasn't in use at that time.)
+
 @c FIXME: Rewrite.
 
 @menu