gettext: po/POTFILES.in

1 
1 13.4.1 ‘POTFILES.in’ in ‘po/’
1 -----------------------------
1 
1    The ‘po/’ directory should receive a file named ‘POTFILES.in’.  This
1 file tells which files, among all program sources, have marked strings
1 needing translation.  Here is an example of such a file:
1 
1      # List of source files containing translatable strings.
1      # Copyright (C) 1995 Free Software Foundation, Inc.
1 
1      # Common library files
1      lib/error.c
1      lib/getopt.c
1      lib/xmalloc.c
1 
1      # Package source files
1      src/gettext.c
1      src/msgfmt.c
1      src/xgettext.c
1 
1 Hash-marked comments and white lines are ignored.  All other lines list
11 those source files containing strings marked for translation (⇒Mark
 Keywords), in a notation relative to the top level of your whole
1 distribution, rather than the location of the ‘POTFILES.in’ file itself.
1 
1    When a C file is automatically generated by a tool, like ‘flex’ or
1 ‘bison’, that doesn’t introduce translatable strings by itself, it is
1 recommended to list in ‘po/POTFILES.in’ the real source file (ending in
1 ‘.l’ in the case of ‘flex’, or in ‘.y’ in the case of ‘bison’), not the
1 generated C file.
1