home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2007 September / PCWSEP07.iso / Software / Linux / Linux Mint 3.0 Light / LinuxMint-3.0-Light.iso / casper / filesystem.squashfs / usr / share / intltool-debian / intltool-update < prev   
Encoding:
Text File  |  2006-11-08  |  27.9 KB  |  1,101 lines
  1. #!/usr/bin/perl -w
  2. # -*- Mode: perl; indent-tabs-mode: nil; c-basic-offset: 4  -*-
  3.  
  4. #
  5. #  The Intltool Message Updater
  6. #
  7. #  Copyright (C) 2000-2003 Free Software Foundation.
  8. #
  9. #  Intltool is free software; you can redistribute it and/or
  10. #  modify it under the terms of the GNU General Public License 
  11. #  version 2 published by the Free Software Foundation.
  12. #
  13. #  Intltool is distributed in the hope that it will be useful,
  14. #  but WITHOUT ANY WARRANTY; without even the implied warranty of
  15. #  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16. #  General Public License for more details.
  17. #
  18. #  You should have received a copy of the GNU General Public License
  19. #  along with this program; if not, write to the Free Software
  20. #  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  21. #
  22. #  As a special exception to the GNU General Public License, if you
  23. #  distribute this file as part of a program that contains a
  24. #  configuration script generated by Autoconf, you may include it under
  25. #  the same distribution terms that you use for the rest of that program.
  26. #
  27. #  Authors: Kenneth Christiansen <kenneth@gnu.org>
  28. #           Maciej Stachowiak
  29. #           Darin Adler <darin@bentspoon.com>
  30.  
  31. ## Release information
  32. my $PROGRAM = "intltool-update";
  33. my $VERSION = "0.35.0";
  34. my $PACKAGE = "intltool";
  35.  
  36. ## Loaded modules
  37. use strict;
  38. use Getopt::Long;
  39. use Cwd;
  40. use File::Copy;
  41. use File::Find;
  42.  
  43. ## Scalars used by the option stuff
  44. my $HELP_ARG        = 0;
  45. my $VERSION_ARG    = 0;
  46. my $DIST_ARG       = 0;
  47. my $POT_ARG       = 0;
  48. my $HEADERS_ARG    = 0;
  49. my $MAINTAIN_ARG   = 0;
  50. my $REPORT_ARG     = 0;
  51. my $VERBOSE       = 0;
  52. my $GETTEXT_PACKAGE = "";
  53. my $OUTPUT_FILE    = "";
  54.  
  55. my @languages;
  56. my %varhash = ();
  57. my %po_files_by_lang = ();
  58.  
  59. # Regular expressions to categorize file types.
  60. # FIXME: Please check if the following is correct
  61.  
  62. my $xml_support =
  63. "xml(?:\\.in)*|".    # http://www.w3.org/XML/ (Note: .in is not required)
  64. "ui|".            # Bonobo specific - User Interface desc. files
  65. "lang|".        # ?
  66. "glade2?(?:\\.in)*|".    # Glade specific - User Interface desc. files (Note: .in is not required)
  67. "scm(?:\\.in)*|".    # ? (Note: .in is not required)
  68. "oaf(?:\\.in)+|".    # DEPRECATED: Replaces by Bonobo .server files 
  69. "etspec|".        # ?
  70. "server(?:\\.in)+|".    # Bonobo specific
  71. "sheet(?:\\.in)+|".    # ?
  72. "schemas(?:\\.in)+|".    # GConf specific
  73. "pong(?:\\.in)+|".    # DEPRECATED: PONG is not used [by GNOME] any longer.
  74. "kbd(?:\\.in)+";    # GOK specific. 
  75.  
  76. my $ini_support =
  77. "icon(?:\\.in)+|".    # http://www.freedesktop.org/Standards/icon-theme-spec
  78. "desktop(?:\\.in)+|".    # http://www.freedesktop.org/Standards/menu-spec
  79. "caves(?:\\.in)+|".    # GNOME Games specific
  80. "directory(?:\\.in)+|".    # http://www.freedesktop.org/Standards/menu-spec
  81. "soundlist(?:\\.in)+|".    # GNOME specific
  82. "keys(?:\\.in)+|".    # GNOME Mime database specific
  83. "theme(?:\\.in)+|".    # http://www.freedesktop.org/Standards/icon-theme-spec
  84. "service(?:\\.in)+";    # DBus specific
  85.  
  86. my $buildin_gettext_support = 
  87. "c|y|cs|cc|cpp|c\\+\\+|h|hh|gob|py";
  88.  
  89. ## Always flush buffer when printing
  90. $| = 1;
  91.  
  92. ## Sometimes the source tree will be rooted somewhere else.
  93. my $SRCDIR = ".";
  94. my $POTFILES_in;
  95.  
  96. $SRCDIR = $ENV{"srcdir"} if $ENV{"srcdir"};
  97. $POTFILES_in = "<$SRCDIR/POTFILES.in";
  98.  
  99. my $devnull = ($^O eq 'MSWin32' ? 'NUL:' : '/dev/null');
  100.  
  101. ## Handle options
  102. GetOptions 
  103. (
  104.  "help"            => \$HELP_ARG,
  105.  "version"            => \$VERSION_ARG,
  106.  "dist|d"           => \$DIST_ARG,
  107.  "pot|p"           => \$POT_ARG,
  108.  "headers|s"           => \$HEADERS_ARG,
  109.  "maintain|m"           => \$MAINTAIN_ARG,
  110.  "report|r"           => \$REPORT_ARG,
  111.  "verbose|x"           => \$VERBOSE,
  112.  "gettext-package|g=s" => \$GETTEXT_PACKAGE,
  113.  "output-file|o=s"     => \$OUTPUT_FILE,
  114.  ) or &Console_WriteError_InvalidOption;
  115.  
  116. &Console_Write_IntltoolHelp if $HELP_ARG;
  117. &Console_Write_IntltoolVersion if $VERSION_ARG;
  118.  
  119. my $arg_count = ($DIST_ARG > 0)
  120.     + ($POT_ARG > 0)
  121.     + ($HEADERS_ARG > 0)
  122.     + ($MAINTAIN_ARG > 0)
  123.     + ($REPORT_ARG > 0);
  124.  
  125. &Console_Write_IntltoolHelp if $arg_count > 1;
  126.  
  127. # --version and --help don't require a module name
  128. my $MODULE = $GETTEXT_PACKAGE || &FindPackageName || "unknown";
  129.  
  130. if ($POT_ARG)
  131. {
  132.     &GenerateHeaders;
  133.     &GeneratePOTemplate;
  134. }
  135. elsif ($HEADERS_ARG)
  136. {
  137.     &GenerateHeaders;
  138. }
  139. elsif ($MAINTAIN_ARG)
  140. {
  141.     &FindLeftoutFiles;
  142. }
  143. elsif ($REPORT_ARG)
  144. {
  145.     &GenerateHeaders;
  146.     &GeneratePOTemplate;
  147.     &Console_Write_CoverageReport;
  148. }
  149. elsif ((defined $ARGV[0]) && $ARGV[0] =~ /^[a-z]/)
  150. {
  151.     my $lang = $ARGV[0];
  152.  
  153.     ## Report error if the language file supplied
  154.     ## to the command line is non-existent
  155.     &Console_WriteError_NotExisting("$SRCDIR/$lang.po")
  156.         if ! -s "$SRCDIR/$lang.po";
  157.  
  158.     if (!$DIST_ARG)
  159.     {
  160.     print "Working, please wait..." if $VERBOSE;
  161.     &GenerateHeaders;
  162.     &GeneratePOTemplate;
  163.     }
  164.     &POFile_Update ($lang, $OUTPUT_FILE);
  165.     &Console_Write_TranslationStatus ($lang, $OUTPUT_FILE) if $VERBOSE;
  166. } 
  167. else 
  168. {
  169.     &Console_Write_IntltoolHelp;
  170. }
  171.  
  172. exit;
  173.  
  174. #########
  175.  
  176. sub Console_Write_IntltoolVersion
  177. {
  178.     print <<_EOF_;
  179. ${PROGRAM} (${PACKAGE}) $VERSION
  180. Written by Kenneth Christiansen, Maciej Stachowiak, and Darin Adler.
  181.  
  182. Copyright (C) 2000-2003 Free Software Foundation, Inc.
  183. This is free software; see the source for copying conditions.  There is NO
  184. warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  185. _EOF_
  186.     exit;
  187. }
  188.  
  189. sub Console_Write_IntltoolHelp
  190. {
  191.     print <<_EOF_;
  192. Usage: ${PROGRAM} [OPTION]... LANGCODE
  193. Updates PO template files and merge them with the translations.
  194.  
  195. Mode of operation (only one is allowed):
  196.   -p, --pot                   generate the PO template only
  197.   -s, --headers               generate the header files in POTFILES.in
  198.   -m, --maintain              search for left out files from POTFILES.in
  199.   -r, --report                display a status report for the module
  200.   -d, --dist                  merge LANGCODE.po with existing PO template
  201.  
  202. Extra options:
  203.   -g, --gettext-package=NAME  override PO template name, useful with --pot
  204.   -o, --output-file=FILE      write merged translation to FILE
  205.   -x, --verbose               display lots of feedback
  206.       --help                  display this help and exit
  207.       --version               output version information and exit
  208.  
  209. Examples of use:
  210. ${PROGRAM} --pot    just create a new PO template
  211. ${PROGRAM} xy       create new PO template and merge xy.po with it
  212.  
  213. Report bugs to http://bugzilla.gnome.org/ (product name "$PACKAGE")
  214. or send email to <xml-i18n-tools\@gnome.org>.
  215. _EOF_
  216.     exit;
  217. }
  218.  
  219. sub echo_n
  220. {
  221.     my $str = shift;
  222.     my $ret = `echo "$str"`;
  223.  
  224.     $ret =~ s/\n$//; # do we need the "s" flag?
  225.  
  226.     return $ret;
  227. }
  228.  
  229. sub POFile_DetermineType ($) 
  230. {
  231.    my $type = $_;
  232.    my $gettext_type;
  233.  
  234.    my $xml_regex     = "(?:" . $xml_support . ")";
  235.    my $ini_regex     = "(?:" . $ini_support . ")";
  236.    my $buildin_regex = "(?:" . $buildin_gettext_support . ")";
  237.  
  238.    if ($type =~ /\[type: gettext\/([^\]].*)]/) 
  239.    {
  240.     $gettext_type=$1;
  241.    }
  242.    elsif ($type =~ /schemas(\.in)+$/) 
  243.    {
  244.     $gettext_type="schemas";
  245.    }
  246.    elsif ($type =~ /glade2?(\.in)*$/) 
  247.    {
  248.        $gettext_type="glade";
  249.    }
  250.    elsif ($type =~ /scm(\.in)*$/) 
  251.    {
  252.        $gettext_type="scheme";
  253.    }
  254.    elsif ($type =~ /keys(\.in)+$/) 
  255.    {
  256.        $gettext_type="keys";
  257.    }
  258.  
  259.    # bucket types
  260.  
  261.    elsif ($type =~ /$xml_regex$/) 
  262.    {
  263.        $gettext_type="xml";
  264.    }
  265.    elsif ($type =~ /$ini_regex$/) 
  266.    { 
  267.        $gettext_type="ini";
  268.    }
  269.    elsif ($type =~ /$buildin_regex$/) 
  270.    {
  271.        $gettext_type="buildin";
  272.    }
  273.    else
  274.    { 
  275.        $gettext_type="unknown"; 
  276.    }
  277.  
  278.    return "gettext\/$gettext_type";
  279. }
  280.  
  281. sub TextFile_DetermineEncoding ($) 
  282. {
  283.     my $gettext_code="ASCII"; # All files are ASCII by default
  284.     return $gettext_code;
  285. }
  286.  
  287. sub isNotValidMissing
  288. {
  289.     my ($file) = @_;
  290.  
  291.     return if $file =~ /^\{arch\}\/.*$/;
  292.     return if $file =~ /^$varhash{"PACKAGE"}-$varhash{"VERSION"}\/.*$/;
  293. }
  294.  
  295. sub FindLeftoutFiles
  296. {
  297.     my (@buf_i18n_plain,
  298.     @buf_i18n_xml,
  299.     @buf_i18n_xml_unmarked,
  300.     @buf_i18n_ini,
  301.     @buf_potfiles,
  302.     @buf_potfiles_ignore,
  303.     @buf_allfiles,
  304.     @buf_allfiles_sorted,
  305.     @buf_potfiles_sorted
  306.     );
  307.  
  308.     ## Search and find all translatable files
  309.     find sub { 
  310.     push @buf_i18n_plain,        "$File::Find::name" if /\.($buildin_gettext_support)$/;
  311.     push @buf_i18n_xml,          "$File::Find::name" if /\.($xml_support)$/;
  312.     push @buf_i18n_ini,          "$File::Find::name" if /\.($ini_support)$/;
  313.     push @buf_i18n_xml_unmarked, "$File::Find::name" if /\.(schemas(\.in)+)$/;
  314.     }, "..";
  315.  
  316.  
  317.     open POTFILES, $POTFILES_in or die "$PROGRAM:  there's no POTFILES.in!\n";
  318.     @buf_potfiles = grep !/^(#|\s*$)/, <POTFILES>;
  319.     close POTFILES;
  320.  
  321.     foreach (@buf_potfiles) {
  322.     s/^\[.*]\s*//;
  323.     }
  324.  
  325.     print "Searching for missing translatable files...\n" if $VERBOSE;
  326.  
  327.     ## Check if we should ignore some found files, when
  328.     ## comparing with POTFILES.in
  329.     foreach my $ignore ("POTFILES.skip", "POTFILES.ignore")
  330.     {
  331.     (-s $ignore) or next;
  332.  
  333.     if ("$ignore" eq "POTFILES.ignore")
  334.     {
  335.         print "The usage of POTFILES.ignore is deprecated. Please consider moving the\n".
  336.           "content of this file to POTFILES.skip.\n";
  337.     }
  338.  
  339.     print "Found $ignore: Ignoring files...\n" if $VERBOSE;
  340.     open FILE, "<$ignore" or die "ERROR: Failed to open $ignore!\n";
  341.         
  342.     while (<FILE>)
  343.     {
  344.         push @buf_potfiles_ignore, $_ unless /^(#|\s*$)/;
  345.     }
  346.     close FILE;
  347.  
  348.     @buf_potfiles = (@buf_potfiles_ignore, @buf_potfiles);
  349.     }
  350.  
  351.     foreach my $file (@buf_i18n_plain)
  352.     {
  353.     my $in_comment = 0;
  354.     my $in_macro = 0;
  355.  
  356.     open FILE, "<$file";
  357.     while (<FILE>)
  358.     {
  359.         # Handle continued multi-line comment.
  360.         if ($in_comment)
  361.         {
  362.         next unless s-.*\*/--;
  363.         $in_comment = 0;
  364.         }
  365.  
  366.         # Handle continued macro.
  367.         if ($in_macro)
  368.         {
  369.         $in_macro = 0 unless /\\$/;
  370.         next;
  371.         }
  372.  
  373.         # Handle start of macro (or any preprocessor directive).
  374.         if (/^\s*\#/)
  375.         {
  376.         $in_macro = 1 if /^([^\\]|\\.)*\\$/;
  377.         next;
  378.         }
  379.  
  380.         # Handle comments and quoted text.
  381.         while (m-(/\*|//|\'|\")-) # \' and \" keep emacs perl mode happy
  382.         {
  383.         my $match = $1;
  384.         if ($match eq "/*")
  385.         {
  386.             if (!s-/\*.*?\*/--)
  387.             {
  388.             s-/\*.*--;
  389.             $in_comment = 1;
  390.             }
  391.         }
  392.         elsif ($match eq "//")
  393.         {
  394.             s-//.*--;
  395.         }
  396.         else # ' or "
  397.         {
  398.             if (!s-$match([^\\]|\\.)*?$match-QUOTEDTEXT-)
  399.             {
  400.             warn "mismatched quotes at line $. in $file\n";
  401.             s-$match.*--;
  402.             }
  403.         }
  404.         }        
  405.  
  406.         if (/\.GetString ?\(QUOTEDTEXT/)
  407.         {
  408.                 if (defined isNotValidMissing (unpack("x3 A*", $file))) {
  409.                     ## Remove the first 3 chars and add newline
  410.                     push @buf_allfiles, unpack("x3 A*", $file) . "\n";
  411.                 }
  412.         last;
  413.         }
  414.  
  415.         if (/_\(QUOTEDTEXT/)
  416.         {
  417.                 if (defined isNotValidMissing (unpack("x3 A*", $file))) {
  418.                     ## Remove the first 3 chars and add newline
  419.                     push @buf_allfiles, unpack("x3 A*", $file) . "\n";
  420.                 }
  421.         last;
  422.         }
  423.     }
  424.     close FILE;
  425.     }
  426.  
  427.     foreach my $file (@buf_i18n_xml) 
  428.     {
  429.     open FILE, "<$file";
  430.     
  431.     while (<FILE>) 
  432.     {
  433.         # FIXME: share the pattern matching code with intltool-extract
  434.         if (/\s_[-A-Za-z0-9._:]+\s*=\s*\"([^"]+)\"/ || /<_[^>]+>/ || /translatable=\"yes\"/)
  435.         {
  436.                 if (defined isNotValidMissing (unpack("x3 A*", $file))) {
  437.                     push @buf_allfiles, unpack("x3 A*", $file) . "\n";
  438.                 }
  439.         last;
  440.         }
  441.     }
  442.     close FILE;
  443.     }
  444.  
  445.     foreach my $file (@buf_i18n_ini)
  446.     {
  447.     open FILE, "<$file";
  448.     while (<FILE>) 
  449.     {
  450.         if (/_(.*)=/)
  451.         {
  452.                 if (defined isNotValidMissing (unpack("x3 A*", $file))) {
  453.                     push @buf_allfiles, unpack("x3 A*", $file) . "\n";
  454.                 }
  455.         last;
  456.         }
  457.     }
  458.     close FILE;
  459.     }
  460.  
  461.     foreach my $file (@buf_i18n_xml_unmarked)
  462.     {
  463.         if (defined isNotValidMissing (unpack("x3 A*", $file))) {
  464.             push @buf_allfiles, unpack("x3 A*", $file) . "\n";
  465.         }
  466.     }
  467.  
  468.  
  469.     @buf_allfiles_sorted = sort (@buf_allfiles);
  470.     @buf_potfiles_sorted = sort (@buf_potfiles);
  471.  
  472.     my %in2;
  473.     foreach (@buf_potfiles_sorted) 
  474.     {
  475.     $in2{$_} = 1;
  476.     }
  477.  
  478.     my @result;
  479.  
  480.     foreach (@buf_allfiles_sorted)
  481.     {
  482.     if (!exists($in2{$_}))
  483.     {
  484.         push @result, $_
  485.     }
  486.     }
  487.  
  488.     my @buf_potfiles_notexist;
  489.  
  490.     foreach (@buf_potfiles_sorted)
  491.     {
  492.     chomp (my $dummy = $_);
  493.     if ("$dummy" ne "" and ! -f "../$dummy")
  494.     {
  495.         push @buf_potfiles_notexist, $_;
  496.     }
  497.     }
  498.  
  499.     ## Save file with information about the files missing
  500.     ## if any, and give information about this procedure.
  501.     if (@result + @buf_potfiles_notexist > 0)
  502.     {
  503.     if (@result) 
  504.     {
  505.         print "\n" if $VERBOSE;
  506.         unlink "missing";
  507.         open OUT, ">missing";
  508.         print OUT @result;
  509.         close OUT;
  510.         warn "\e[1mThe following files contain translations and are currently not in use. Please\e[0m\n".
  511.              "\e[1mconsider adding these to the POTFILES.in file, located in the po/ directory.\e[0m\n\n";
  512.         print STDERR @result, "\n";
  513.         warn "If some of these files are left out on purpose then please add them to\n".
  514.          "POTFILES.skip instead of POTFILES.in. A file \e[1m'missing'\e[0m containing this list\n".
  515.          "of left out files has been written in the current directory.\n";
  516.     }
  517.     if (@buf_potfiles_notexist)
  518.     {
  519.         unlink "notexist";
  520.         open OUT, ">notexist";
  521.         print OUT @buf_potfiles_notexist;
  522.         close OUT;
  523.         warn "\n" if ($VERBOSE or @result);
  524.         warn "\e[1mThe following files do not exist anymore:\e[0m\n\n";
  525.         warn @buf_potfiles_notexist, "\n";
  526.         warn "Please remove them from POTFILES.in or POTFILES.skip. A file \e[1m'notexist'\e[0m\n".
  527.          "containing this list of absent files has been written in the current directory.\n";
  528.     }
  529.     }
  530.  
  531.     ## If there is nothing to complain about, notify the user
  532.     else {
  533.     print "\nAll files containing translations are present in POTFILES.in.\n" if $VERBOSE;
  534.     }
  535. }
  536.  
  537. sub Console_WriteError_InvalidOption
  538. {
  539.     ## Handle invalid arguments
  540.     print STDERR "Try `${PROGRAM} --help' for more information.\n";
  541.     exit 1;
  542. }
  543.  
  544. sub GenerateHeaders
  545. {
  546.     my $EXTRACT = "/usr/bin/intltool-extract";
  547.     chomp $EXTRACT;
  548.  
  549.     $EXTRACT = $ENV{"INTLTOOL_EXTRACT"} if $ENV{"INTLTOOL_EXTRACT"};
  550.  
  551.     ## Generate the .h header files, so we can allow glade and
  552.     ## xml translation support
  553.     if (! -x "$EXTRACT")
  554.     {
  555.     print STDERR "\n *** The intltool-extract script wasn't found!"
  556.          ."\n *** Without it, intltool-update can not generate files.\n";
  557.     exit;
  558.     }
  559.     else
  560.     {
  561.     open (FILE, $POTFILES_in) or die "$PROGRAM: POTFILES.in not found.\n";
  562.     
  563.     while (<FILE>) 
  564.     {
  565.        chomp;
  566.        next if /^\[\s*encoding/;
  567.  
  568.        ## Find xml files in POTFILES.in and generate the
  569.        ## files with help from the extract script
  570.  
  571.        my $gettext_type= &POFile_DetermineType ($1);
  572.  
  573.        if (/\.($xml_support|$ini_support)$/ || /^\[/)
  574.        {
  575.            s/^\[[^\[].*]\s*//;
  576.  
  577.            my $filename = "../$_";
  578.  
  579.            if ($VERBOSE)
  580.            {
  581.            system ($EXTRACT, "--update", "--srcdir=$SRCDIR",
  582.                "--type=$gettext_type", $filename);
  583.            } 
  584.            else 
  585.            {
  586.             system ($EXTRACT, "--update", "--type=$gettext_type", 
  587.                "--srcdir=$SRCDIR", "--quiet", $filename);
  588.            }
  589.        }
  590.        }
  591.        close FILE;
  592.    }
  593. }
  594.  
  595. #
  596. # Generate .pot file from POTFILES.in
  597. #
  598. sub GeneratePOTemplate
  599. {
  600.     my $XGETTEXT = $ENV{"XGETTEXT"} || "/usr/bin/xgettext";
  601.     my $XGETTEXT_ARGS = $ENV{"XGETTEXT_ARGS"} || '';
  602.     chomp $XGETTEXT;
  603.  
  604.     if (! -x $XGETTEXT)
  605.     {
  606.     print STDERR " *** xgettext is not found on this system!\n".
  607.              " *** Without it, intltool-update can not extract strings.\n";
  608.     exit;
  609.     }
  610.  
  611.     print "Building $MODULE.pot...\n" if $VERBOSE;
  612.  
  613.     open INFILE, $POTFILES_in;
  614.     unlink "POTFILES.in.temp";
  615.     open OUTFILE, ">POTFILES.in.temp" or die("Cannot open POTFILES.in.temp for writing");
  616.  
  617.     my $gettext_support_nonascii = 0;
  618.  
  619.     # checks for GNU gettext >= 0.12
  620.     my $dummy = `$XGETTEXT --version --from-code=UTF-8 >$devnull 2>$devnull`;
  621.     if ($? == 0)
  622.     {
  623.     $gettext_support_nonascii = 1;
  624.     }
  625.     else
  626.     {
  627.     # urge everybody to upgrade gettext
  628.     print STDERR "WARNING: This version of gettext does not support extracting non-ASCII\n".
  629.              "         strings. That means you should install a version of gettext\n".
  630.              "         that supports non-ASCII strings (such as GNU gettext >= 0.12),\n".
  631.              "         or have to let non-ASCII strings untranslated. (If there is any)\n";
  632.     }
  633.  
  634.     my $encoding = "ASCII";
  635.     my $forced_gettext_code;
  636.     my @temp_headers;
  637.     my $encoding_problem_is_reported = 0;
  638.  
  639.     while (<INFILE>) 
  640.     {
  641.     next if (/^#/ or /^\s*$/);
  642.  
  643.     chomp;
  644.  
  645.     my $gettext_code;
  646.  
  647.     if (/^\[\s*encoding:\s*(.*)\s*\]/)
  648.     {
  649.         $forced_gettext_code=$1;
  650.     }
  651.     elsif (/\.($xml_support|$ini_support)$/ || /^\[/)
  652.     {
  653.         s/^\[.*]\s*//;
  654.             print OUTFILE "../$_.h\n";
  655.         push @temp_headers, "../$_.h";
  656.         $gettext_code = &TextFile_DetermineEncoding ("../$_.h") if ($gettext_support_nonascii and not defined $forced_gettext_code);
  657.     } 
  658.     else 
  659.     {
  660.         if ($SRCDIR eq ".") {
  661.             print OUTFILE "../$_\n";
  662.         } else {
  663.             print OUTFILE "$SRCDIR/../$_\n";
  664.         }
  665.         $gettext_code = &TextFile_DetermineEncoding ("../$_") if ($gettext_support_nonascii and not defined $forced_gettext_code);
  666.     }
  667.  
  668.     next if (! $gettext_support_nonascii);
  669.  
  670.     if (defined $forced_gettext_code)
  671.     {
  672.         $encoding=$forced_gettext_code;
  673.     }
  674.     elsif (defined $gettext_code and "$encoding" ne "$gettext_code")
  675.     {
  676.         if ($encoding eq "ASCII")
  677.         {
  678.         $encoding=$gettext_code;
  679.         }
  680.         elsif ($gettext_code ne "ASCII")
  681.         {
  682.         # Only report once because the message is quite long
  683.         if (! $encoding_problem_is_reported)
  684.         {
  685.             print STDERR "WARNING: You should use the same file encoding for all your project files,\n".
  686.                  "         but $PROGRAM thinks that most of the source files are in\n".
  687.                  "         $encoding encoding, while \"$_\" is (likely) in\n".
  688.                         "         $gettext_code encoding. If you are sure that all translatable strings\n".
  689.                  "         are in same encoding (say UTF-8), please \e[1m*prepend*\e[0m the following\n".
  690.                  "         line to POTFILES.in:\n\n".
  691.                  "                 [encoding: UTF-8]\n\n".
  692.                  "         and make sure that configure.in/ac checks for $PACKAGE >= 0.27 .\n".
  693.                  "(such warning message will only be reported once.)\n";
  694.             $encoding_problem_is_reported = 1;
  695.         }
  696.         }
  697.     }
  698.     }
  699.  
  700.     close OUTFILE;
  701.     close INFILE;
  702.  
  703.     unlink "$MODULE.pot-update";
  704.     my @xgettext_argument=("$XGETTEXT",
  705.                "--add-comments",
  706.                "--directory\=\.",
  707.                "--output\=$MODULE\.pot-update",
  708.                "--files-from\=\.\/POTFILES\.in\.temp");
  709.     my $XGETTEXT_KEYWORDS = &FindPOTKeywords;
  710.     push @xgettext_argument, $XGETTEXT_KEYWORDS;
  711.     my $MSGID_BUGS_ADDRESS = &FindMakevarsBugAddress;
  712.     push @xgettext_argument, "--msgid-bugs-address\=$MSGID_BUGS_ADDRESS" if $MSGID_BUGS_ADDRESS;
  713.     push @xgettext_argument, "--from-code\=$encoding" if ($gettext_support_nonascii);
  714.     push @xgettext_argument, $XGETTEXT_ARGS if $XGETTEXT_ARGS;
  715.     my $xgettext_command = join ' ', @xgettext_argument;
  716.  
  717.     # intercept xgettext error message
  718.     print "Running $xgettext_command\n" if $VERBOSE;
  719.     my $xgettext_error_msg = `$xgettext_command 2>\&1`;
  720.     my $command_failed = $?;
  721.  
  722.     unlink "POTFILES.in.temp";
  723.  
  724.     print "Removing generated header (.h) files..." if $VERBOSE;
  725.     unlink foreach (@temp_headers);
  726.     print "done.\n" if $VERBOSE;
  727.  
  728.     if (! $command_failed)
  729.     {
  730.     if (! -e "$MODULE.pot-update")
  731.     {
  732.         print STDERR "None of the files in POTFILES.in contain strings marked for translation.\n";
  733.     }
  734.     if (-e "$MODULE.pot")
  735.     {
  736.         RemovePOHeader("$MODULE.pot", "$MODULE.1po");
  737.         RemovePOHeader("$MODULE.pot-update", "$MODULE.2po");
  738.         system("cmp", "-s", "$MODULE.1po", "$MODULE.2po");
  739.         rename("$MODULE.pot-update", "$MODULE.pot") if $?;
  740.         unlink "$MODULE.1po", "$MODULE.2po", "$MODULE.pot-update";
  741.     }
  742.     else
  743.     {
  744.         rename("$MODULE.pot-update", "$MODULE.pot");
  745.     }
  746.     print "Wrote $MODULE.pot\n" if $VERBOSE;
  747.     }
  748.     else
  749.     {
  750.     if ($xgettext_error_msg =~ /--from-code/)
  751.     {
  752.         # replace non-ASCII error message with a more useful one.
  753.         print STDERR "ERROR: xgettext failed to generate PO template file because there is non-ASCII\n".
  754.              "       string marked for translation. Please make sure that all strings marked\n".
  755.              "       for translation are in uniform encoding (say UTF-8), then \e[1m*prepend*\e[0m the\n".
  756.              "       following line to POTFILES.in and rerun $PROGRAM:\n\n".
  757.              "           [encoding: UTF-8]\n\n";
  758.     }
  759.     else
  760.     {
  761.         print STDERR "$xgettext_error_msg";
  762.         if (-e "$MODULE.pot-update")
  763.         {
  764.         # is this possible?
  765.         print STDERR "ERROR: xgettext failed but still managed to generate PO template file.\n".
  766.                  "       Please consult error message above if there is any.\n";
  767.         }
  768.         else
  769.         {
  770.         print STDERR "ERROR: xgettext failed to generate PO template file. Please consult\n".
  771.                  "       error message above if there is any.\n";
  772.         }
  773.     }
  774.     exit (1);
  775.     }
  776. }
  777.  
  778. sub RemovePOHeader
  779. {
  780.     my ($infile, $outfile) = @_;
  781.     my $first = 1;
  782.  
  783.     open (IN, "< $infile") || die "file $infile does not exist";
  784.     open (OUT, "> $outfile") || die "Unable to write into $outfile: $!";
  785.     local $/ = "\n\n";
  786.     while (<IN>) {
  787.         next if m/^msgid ""\nmsgstr/m;
  788.         print OUT;
  789.     }
  790.     close IN;
  791.     close OUT;
  792. }
  793.  
  794. sub POFile_Update
  795. {
  796.     -f "$MODULE.pot" or die "$PROGRAM: $MODULE.pot does not exist.\n";
  797.  
  798.     my $MSGMERGE = $ENV{"MSGMERGE"} || "/usr/bin/msgmerge";
  799.     my ($lang, $outfile) = @_;
  800.  
  801.     print "Merging $SRCDIR/$lang.po with $MODULE.pot..." if $VERBOSE;
  802.  
  803.     my $infile = "$SRCDIR/$lang.po";
  804.     $outfile = "$SRCDIR/$lang.po" if ($outfile eq "");
  805.  
  806.     # I think msgmerge won't overwrite old file if merge is not successful
  807.     system ("$MSGMERGE", "-q", "-o", $outfile, $infile, "$MODULE.pot");
  808. }
  809.  
  810. sub Console_WriteError_NotExisting
  811. {
  812.     my ($file) = @_;
  813.  
  814.     ## Report error if supplied language file is non-existing
  815.     print STDERR "$PROGRAM: $file does not exist!\n";
  816.     print STDERR "Try '$PROGRAM --help' for more information.\n";
  817.     exit;
  818. }
  819.  
  820. sub GatherPOFiles
  821. {
  822.     my @po_files = glob ("./*.po");
  823.  
  824.     @languages = map (&POFile_GetLanguage, @po_files);
  825.  
  826.     foreach my $lang (@languages) 
  827.     {
  828.     $po_files_by_lang{$lang} = shift (@po_files);
  829.     }
  830. }
  831.  
  832. sub POFile_GetLanguage ($)
  833. {
  834.     s/^(.*\/)?(.+)\.po$/$2/;
  835.     return $_;
  836. }
  837.  
  838. sub Console_Write_TranslationStatus
  839. {
  840.     my ($lang, $output_file) = @_;
  841.     my $MSGFMT = $ENV{"MSGFMT"} || "/usr/bin/msgfmt";
  842.  
  843.     $output_file = "$SRCDIR/$lang.po" if ($output_file eq "");
  844.  
  845.     system ("$MSGFMT", "-o", "$devnull", "--verbose", $output_file);
  846. }
  847.  
  848. sub Console_Write_CoverageReport
  849. {
  850.     my $MSGFMT = $ENV{"MSGFMT"} || "/usr/bin/msgfmt";
  851.  
  852.     &GatherPOFiles;
  853.  
  854.     foreach my $lang (@languages) 
  855.     {
  856.     print "$lang: ";
  857.     &POFile_Update ($lang, "");
  858.     }
  859.  
  860.     print "\n\n * Current translation support in $MODULE \n\n";
  861.  
  862.     foreach my $lang (@languages)
  863.     {
  864.     print "$lang: ";
  865.     system ("$MSGFMT", "-o", "$devnull", "--verbose", "$SRCDIR/$lang.po");
  866.     }
  867. }
  868.  
  869. sub SubstituteVariable
  870. {
  871.     my ($str) = @_;
  872.     
  873.     # always need to rewind file whenever it has been accessed
  874.     seek (CONF, 0, 0);
  875.  
  876.     # cache each variable. varhash is global to we can add
  877.     # variables elsewhere.
  878.     while (<CONF>)
  879.     {
  880.     if (/^(\w+)=(.*)$/)
  881.     {
  882.         ($varhash{$1} = $2) =~  s/^["'](.*)["']$/$1/;
  883.     }
  884.     }
  885.     
  886.     if ($str =~ /^(.*)\${?([A-Z_]+)}?(.*)$/)
  887.     {
  888.     my $rest = $3;
  889.     my $untouched = $1;
  890.     my $sub = "";
  891.         # Ignore recursive definitions of variables
  892.         $sub = $varhash{$2} if defined $varhash{$2} and $varhash{$2} !~ /\${?$2}?/;
  893.  
  894.     return SubstituteVariable ("$untouched$sub$rest");
  895.     }
  896.     
  897.     # We're using Perl backticks ` and "echo -n" here in order to 
  898.     # expand any shell escapes (such as backticks themselves) in every variable
  899.     return echo_n ($str);
  900. }
  901.  
  902. sub CONF_Handle_Open
  903. {
  904.     my $base_dirname = getcwd();
  905.     $base_dirname =~ s@.*/@@;
  906.  
  907.     my ($conf_in, $src_dir);
  908.  
  909.     if ($base_dirname =~ /^po(-.+)?$/) 
  910.     {
  911.     if (-f "Makevars") 
  912.     {
  913.         my $makefile_source;
  914.  
  915.         local (*IN);
  916.         open (IN, "<Makevars") || die "can't open Makevars: $!";
  917.  
  918.         while (<IN>) 
  919.         {
  920.         if (/^top_builddir[ \t]*=/) 
  921.         {
  922.             $src_dir = $_;
  923.             $src_dir =~ s/^top_builddir[ \t]*=[ \t]*([^ \t\n\r]*)/$1/;
  924.  
  925.             chomp $src_dir;
  926.                     if (-f "$src_dir" . "/configure.ac") {
  927.                         $conf_in = "$src_dir" . "/configure.ac" . "\n";
  928.                     } else {
  929.                         $conf_in = "$src_dir" . "/configure.in" . "\n";
  930.                     }
  931.             last;
  932.         }
  933.         }
  934.         close IN;
  935.  
  936.         $conf_in || die "Cannot find top_builddir in Makevars.";
  937.     }
  938.     elsif (-f "../configure.ac") 
  939.     {
  940.         $conf_in = "../configure.ac";
  941.     } 
  942.     elsif (-f "../configure.in") 
  943.     {
  944.         $conf_in = "../configure.in";
  945.     } 
  946.     else 
  947.     {
  948.         my $makefile_source;
  949.  
  950.         local (*IN);
  951.         open (IN, "<Makefile") || return;
  952.  
  953.         while (<IN>) 
  954.         {
  955.         if (/^top_srcdir[ \t]*=/) 
  956.         {
  957.             $src_dir = $_;            
  958.             $src_dir =~ s/^top_srcdir[ \t]*=[ \t]*([^ \t\n\r]*)/$1/;
  959.  
  960.             chomp $src_dir;
  961.             $conf_in = "$src_dir" . "/configure.in" . "\n";
  962.  
  963.             last;
  964.         }
  965.         }
  966.         close IN;
  967.  
  968.         $conf_in || die "Cannot find top_srcdir in Makefile.";
  969.     }
  970.  
  971.     open (CONF, "<$conf_in");
  972.     }
  973.     else
  974.     {
  975.     print STDERR "$PROGRAM: Unable to proceed.\n" .
  976.              "Make sure to run this script inside the po directory.\n";
  977.     exit;
  978.     }
  979. }
  980.  
  981. sub FindPackageName
  982. {
  983.     my $version;
  984.     my $domain = &FindMakevarsDomain;
  985.     my $name = $domain || "untitled";
  986.  
  987.     &CONF_Handle_Open;
  988.  
  989.     my $conf_source; {
  990.     local (*IN);
  991.     open (IN, "<&CONF") || return $name;
  992.     seek (IN, 0, 0);
  993.     local $/; # slurp mode
  994.     $conf_source = <IN>;
  995.     close IN;
  996.     }
  997.  
  998.     # priority for getting package name:
  999.     # 1. GETTEXT_PACKAGE
  1000.     # 2. first argument of AC_INIT (with >= 2 arguments)
  1001.     # 3. first argument of AM_INIT_AUTOMAKE (with >= 2 argument)
  1002.  
  1003.     # /^AM_INIT_AUTOMAKE\([\s\[]*([^,\)\s\]]+)/m 
  1004.     # the \s makes this not work, why?
  1005.     if ($conf_source =~ /^AM_INIT_AUTOMAKE\(([^,\)]+),([^,\)]+)/m)
  1006.     {
  1007.     ($name, $version) = ($1, $2);
  1008.     $name    =~ s/[\[\]\s]//g;
  1009.     $version =~ s/[\[\]\s]//g;
  1010.     $varhash{"PACKAGE_NAME"} = $name if (not $name =~ /\${?AC_PACKAGE_NAME}?/);
  1011.     $varhash{"PACKAGE"} = $name if (not $name =~ /\${?PACKAGE}?/);
  1012.     $varhash{"PACKAGE_VERSION"} = $version if (not $name =~ /\${?AC_PACKAGE_VERSION}?/);
  1013.     $varhash{"VERSION"} = $version if (not $name =~ /\${?VERSION}?/);
  1014.     }
  1015.     
  1016.     if ($conf_source =~ /^AC_INIT\(([^,\)]+),([^,\)]+)/m) 
  1017.     {
  1018.     ($name, $version) = ($1, $2);
  1019.     $name    =~ s/[\[\]\s]//g;
  1020.     $version =~ s/[\[\]\s]//g;
  1021.     $varhash{"PACKAGE_NAME"} = $name if (not $name =~ /\${?AC_PACKAGE_NAME}?/);
  1022.     $varhash{"PACKAGE"} = $name if (not $name =~ /\${?PACKAGE}?/);
  1023.     $varhash{"PACKAGE_VERSION"} = $version if (not $name =~ /\${?AC_PACKAGE_VERSION}?/);
  1024.     $varhash{"VERSION"} = $version if (not $name =~ /\${?VERSION}?/);
  1025.     }
  1026.  
  1027.     # \s makes this not work, why?
  1028.     $name = $1 if $conf_source =~ /^GETTEXT_PACKAGE=\[?([^\n\]]+)/m;
  1029.     
  1030.     # m4 macros AC_PACKAGE_NAME, AC_PACKAGE_VERSION etc. have same value
  1031.     # as corresponding $PACKAGE_NAME, $PACKAGE_VERSION etc. shell variables.
  1032.     $name =~ s/\bAC_PACKAGE_/\$PACKAGE_/g;
  1033.  
  1034.     $name = $domain if $domain;
  1035.  
  1036.     $name = SubstituteVariable ($name);
  1037.     $name =~ s/^["'](.*)["']$/$1/;
  1038.  
  1039.     return $name if $name;
  1040. }
  1041.  
  1042.  
  1043. sub FindPOTKeywords
  1044. {
  1045.  
  1046.     my $keywords = "--keyword\=\_ --keyword\=N\_ --keyword\=U\_ --keyword\=Q\_";
  1047.     my $varname = "XGETTEXT_OPTIONS";
  1048.     my $make_source; {
  1049.     local (*IN);
  1050.     open (IN, "<Makevars") || (open(IN, "<Makefile.in.in") && ($varname = "XGETTEXT_KEYWORDS")) || return $keywords;
  1051.     seek (IN, 0, 0);
  1052.     local $/; # slurp mode
  1053.     $make_source = <IN>;
  1054.     close IN;
  1055.     }
  1056.  
  1057.     $keywords = $1 if $make_source =~ /^$varname[ ]*=\[?([^\n\]]+)/m;
  1058.     
  1059.     return $keywords;
  1060. }
  1061.  
  1062. sub FindMakevarsDomain
  1063. {
  1064.  
  1065.     my $domain = "";
  1066.     my $makevars_source; { 
  1067.     local (*IN);
  1068.     open (IN, "<Makevars") || return $domain;
  1069.     seek (IN, 0, 0);
  1070.     local $/; # slurp mode
  1071.     $makevars_source = <IN>;
  1072.     close IN;
  1073.     }
  1074.  
  1075.     $domain = $1 if $makevars_source =~ /^DOMAIN[ ]*=\[?([^\n\]\$]+)/m;
  1076.     $domain =~ s/^\s+//;
  1077.     $domain =~ s/\s+$//;
  1078.     
  1079.     return $domain;
  1080. }
  1081.  
  1082. sub FindMakevarsBugAddress
  1083. {
  1084.  
  1085.     my $address = "";
  1086.     my $makevars_source; { 
  1087.     local (*IN);
  1088.     open (IN, "<Makevars") || return undef;
  1089.     seek (IN, 0, 0);
  1090.     local $/; # slurp mode
  1091.     $makevars_source = <IN>;
  1092.     close IN;
  1093.     }
  1094.  
  1095.     $address = $1 if $makevars_source =~ /^MSGID_BUGS_ADDRESS[ ]*=\[?([^\n\]\$]+)/m;
  1096.     $address =~ s/^\s+//;
  1097.     $address =~ s/\s+$//;
  1098.     
  1099.     return $address;
  1100. }
  1101.