doc: liby's main arms the internationalization

Reported by Nicolas Bedon.
<https://lists.gnu.org/archive/html/bug-bison/2014-11/msg00005.html>

* doc/bison.texi (Yacc Library): Document the call the setlocale.

diff --git a/THANKS b/THANKS
index 4fc99849e0364ea7adf1bcf0ff117655fe9aa582..b9849103075145af48cf3c6ee2d98d7382d2a1da 100644 (file)
--- a/THANKS
+++ b/THANKS
@@ -95,6 +95,7 @@ Mike Sullivan             Mike.sullivan@Oracle.COM
 Neil Booth                NeilB@earthling.net
 Nelson H. F. Beebe        beebe@math.utah.edu
 Nick Bowler               nbowler@elliptictech.com
 Neil Booth                NeilB@earthling.net
 Nelson H. F. Beebe        beebe@math.utah.edu
 Nick Bowler               nbowler@elliptictech.com

+Nicolas Bedon             nicolas.bedon@univ-rouen.fr

 Nicolas Burrus            nicolas.burrus@epita.fr
 Nicolas Tisserand         nicolas.tisserand@epita.fr
 Noah Friedman             friedman@gnu.org
 Nicolas Burrus            nicolas.burrus@epita.fr
 Nicolas Tisserand         nicolas.tisserand@epita.fr
 Noah Friedman             friedman@gnu.org

diff --git a/doc/bison.texi b/doc/bison.texi
index d40221593d002078936592c5bf7f82f16f3b2e97..1a2b169bf1db909fab8b37c3d278533479a4cc25 100644 (file)
--- a/doc/bison.texi
+++ b/doc/bison.texi
@@ -10382,9 +10382,23 @@ declare @code{yyerror} as follows:
 int yyerror (char const *);
 @end example
 
 int yyerror (char const *);
 @end example
 

-Bison ignores the @code{int} value returned by this @code{yyerror}.
-If you use the Yacc library's @code{main} function, your
-@code{yyparse} function should have the following type signature:
+@noindent
+The @code{int} value returned by this @code{yyerror} is ignored.
+
+The implementation of Yacc library's @code{main} function is:
+
+@example
+int main (void)
+@{
+  setlocale (LC_ALL, "");
+  return yyparse ();
+@}
+@end example
+
+@noindent
+so if you use it, the internationalization support is enabled (e.g., error
+messages are translated), and your @code{yyparse} function should have the
+following type signature:

 
 @example
 int yyparse (void);
 
 @example
 int yyparse (void);