Re: Re: proper names

[Bruno Haible]

Ben Pfaff wrote on 2006-09-06, about the proposed 'propername' module:
> I like the module.  But I think that the background and usage
> that you included in your message should be checked in also, so
> that it's clear.  I would not, for example, immediately think to
> update the XGETTEXT_OPTIONS variable, but your message tells me
> to do so and gives the right syntax.

Thanks for the remarks. I added comments and make the XGETTEXT_OPTIONS variable
augmentation automatic.


2008-05-18  Bruno Haible  <address@hidden>

        * modules/propername (Notice): New field.
        (configure.ac): Invoke AM_GETTEXT_OPTION.
        * lib/propername.h: Add more comments.
        Reported by Ben Pfaff <address@hidden>.

*** modules/propername  4 Mar 2007 22:17:49 -0000       1.3
--- modules/propername  18 May 2008 11:35:29 -0000
***************
*** 1,6 ****
--- 1,12 ----
  Description:
  Localization of proper names.
  
+ Notice:
+ If you are using GNU gettext version 0.16.1 or older, add the following 
options
+ to XGETTEXT_OPTIONS in your po/Makevars:
+   --keyword=proper_name:1,'This is a proper name. See the gettext manual, 
section Names.'
+   --keyword=proper_name_utf8:1,'This is a proper name. See the gettext 
manual, section Names.'
+ 
  Files:
  lib/propername.h
  lib/propername.c
***************
*** 16,21 ****
--- 22,30 ----
  gettext-h
  
  configure.ac:
+ m4_ifdef([AM_XGETTEXT_OPTION],
+   [AM_XGETTEXT_OPTION([--keyword=proper_name:1,'This is a proper name. See 
the gettext manual, section Names.'])
+    AM_XGETTEXT_OPTION([--keyword=proper_name_utf8:1,'This is a proper name. 
See the gettext manual, section Names.'])])
  
  Makefile.am:
  lib_SOURCES += propername.h propername.c
*** lib/propername.h    7 Oct 2007 19:35:37 -0000       1.2
--- lib/propername.h    18 May 2008 11:35:29 -0000
***************
*** 1,5 ****
  /* Localization of proper names.
!    Copyright (C) 2006 Free Software Foundation, Inc.
     Written by Bruno Haible <address@hidden>, 2006.
  
     This program is free software: you can redistribute it and/or modify
--- 1,5 ----
  /* Localization of proper names.
!    Copyright (C) 2006, 2008 Free Software Foundation, Inc.
     Written by Bruno Haible <address@hidden>, 2006.
  
     This program is free software: you can redistribute it and/or modify
***************
*** 15,20 ****
--- 15,83 ----
     You should have received a copy of the GNU General Public License
     along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  
+ /* INTRODUCTION
+ 
+    What do
+ 
+       Torbjörn Granlund    (coreutils)
+       François Pinard      (coreutils)
+       Danilo Šegan         (gettext)
+ 
+    have in common?
+ 
+    A non-ASCII name. This causes trouble in the --version output. The simple
+    "solution", unfortunately mutilates the name.
+ 
+      $ du --version| grep Granlund
+      Écrit par Torbjorn Granlund, David MacKenzie, Paul Eggert et Jim 
Meyering.
+ 
+      $ ptx --version| grep Pinard
+      Écrit par F. Pinard.
+ 
+    What is desirable, is to print the full name if the output character set
+    allows it, and the ASCIIfied name only as a fallback.
+ 
+      $ recode-sr-latin --version
+      ...
+      Written by Danilo Šegan and Bruno Haible.
+ 
+      $ LC_ALL=C recode-sr-latin --version
+      ...
+      Written by Danilo Segan and Bruno Haible.
+ 
+    The 'propername' module does exactly this. Plus, for languages that use
+    a different writing system than the Latin alphabet, it allows a translator
+    to write the name using that different writing system. In that case the
+    output will look like this:
+       <translated name> (<original name in English>)
+ 
+    To use the 'propername' module is done in three simple steps:
+ 
+      1) Add it to the list of gnulib modules to import,
+ 
+      2) Change the arguments of version_etc, from
+ 
+           from "Paul Eggert"
+           to   proper_name ("Paul Eggert")
+ 
+           from "Torbjorn Granlund"
+           to   proper_name_utf8 ("Torbjorn Granlund", "Torbj\303\266rn 
Granlund")
+ 
+           from "F. Pinard"
+           to   proper_name_utf8 ("Franc,ois Pinard", "Fran\303\247ois Pinard")
+ 
+         (Optionally, here you can also add / * TRANSLATORS: ... * / comments
+         explaining how the name is written or pronounced.)
+ 
+      3) If you are using GNU gettext version 0.16.1 or older, in po/Makevars,
+         in the definition of the XGETTEXT_OPTIONS variable, add:
+ 
+            --keyword=proper_name:1,"This is a proper name. See the gettext 
manual, section Names."
+            --keyword=proper_name_utf8:1,"This is a proper name. See the 
gettext manual, section Names."
+ 
+         This specifies automatic comments for the translator. (Requires
+         xgettext >= 0.15.)
+ 
  #ifndef _PROPERNAME_H
  #define _PROPERNAME_H