Re: [Edward S. Peschko] gettext and glibc

[Paul Eggert]

Bruno Haible <address@hidden> writes:

> What concrete counter-actions do you propose?

Perhaps the FAQ should suggest that people use AM_GNU_GETTEXT([external])?
That would avoid some of these hassles.

Here's a proposed patch.

--- gettext-FAQ.html-old        Sun Feb 22 03:53:51 2004
+++ gettext-FAQ.html    Tue Feb 24 10:51:47 2004
@@ -29,6 +29,7 @@ fail: “ld: fatal error ... -lrpathz”
 </ul>
 <h3>Problems integrating GNU gettext</h3>
 <ul>
+  <li><a href="#simplifying_integration">What's a simple way to integrate GNU 
gettext?</a></li>
   <li><a href="#integrating_undefined">I get a linker error “undefined
 reference to libintl_gettext”</a></li>
   <li><a href="#integrating_abuse_gettextize">gettextize adds multiple
@@ -186,6 +187,26 @@ If “<span style="font-family: monospac
  style="font-family: monospace;">DESTDIR</span> fails, it's a bug which
 you are welcome to report to the usual bug report address.
 <h3>Problems integrating GNU gettext</h3>
+<h4><a name="simplifying_integration"></a>What's a simple way to integrate
+GNU gettext?</h4>
+First, make sure you are using the latest versions of <a
+href="http://www.gnu.org/software/m4/";>GNU m4</a>, <a
+href="http://www.gnu.org/software/autoconf/";>Autoconf</a> and GNU
+gettext, as it will simplify your integration task if you don't have
+to worry about compatibility with older versions. Then, put the
+following into your <samp>configure.ac</samp> file:<br>
+    <br>
+    <div style="margin-left: 40px;"><code>AM_GNU_GETTEXT([external], 
[need-formatstring-macros])</code></br>
+    </div>
+    </br>
+Assuming you are using C, put the following near the start of each C 
module:<br>
+    <br>
+    <div style="margin-left: 40px;"><code>#include &lt;libintl.h&gt;</code><br>
+    <code>#define _(String) gettext (String)</code></br>
+    </div>
+    </br>
+Then invoke <samp>gettextize -c</samp> to get started on the rest of
+the process, which is discussed further in the GNU gettext manual.
 <h4><a name="integrating_undefined"></a>I get a linker error “undefined
 reference to libintl_gettext”</h4>
 This error means that the program uses the <span
@@ -196,6 +217,10 @@ file from GNU gettext (which remaps it t
 link time a function of this name could not be linked in. (It is
 expected to come from the <span style="font-family: monospace;">libintl</span>
 library, installed by GNU gettext.)<br>
+<br>
+A simple way to avoid this error is to use
+<code>AM_GNU_GETTEXT([external])</code> as suggested <a
+href="#simplifying_integration">above</a>.<br>
 <br>
 There are many possible reasons for this error, but in any case you
 should consider the <span style="font-family: monospace;">-I</span>, <span