gettext: po/POTFILES

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