potooledit(1) [debian man page]

POEDIT(1)						      General Commands Manual							 POEDIT(1)

NAME

       poedit - program to aid editing gettext po files

SYNOPSIS

       poedit [-a] [-n] <file.po>

       potooledit [-a] [-n] <file.po>

DESCRIPTION

       poedit is a shell script, which uses potool(1), iconv(1) and your favourite editor to help you edit gettext po files.

       It  first  retrieves  only the untranslated entries from the file (or, if -a is specified, reorders the entries so that the translated ones
       are grouped separately from the untranslated ones) and puts them into a temporary file.	Then recodes the file to the charmap of your  cur-
       rent  locale, and runs your favourite editor on the temporary file so you can add new translations. After you have finished, it recodes the
       file back to the original charset and merges the new translations back into the original file.

       poedit is also known as potooledit on Debian systems, to avoid a name clash with an unrelated program of the same name.

OPTIONS

       -a     causes poedit to include already translated entries as well in the temporary file for editing (they are grouped separately, though).
	      Without this option, only the untranslated entries (and the file header) are presented for editing.

       -n     causes poedit not to do any charset recoding before nor after editing the file.
	      You should only use this option if you know what you are doing. Be particularly careful when using this option (without -a) on files
	      that are in an encoding incompatible with your locale's charmap. In that case, the intermediate file to be edited will probably only
	      contain ASCII characters, which means your editor will be free to interpret this as your default locale encoding. This in turn, will
	      make the file invalid when it is merged together with the already translated messages. See Debian bug #297074 for an example of this
	      happening.

SEE ALSO

       potool(1), postats(1), locale charmap(1), msgmerge(1), msgfmt(1).

AUTHOR

       Poedit was written by Zbigniew Chyla and is now being maintained by Marcin Owsiany <porridge@debian.org>.

								September 21, 2007							 POEDIT(1)

Debian::L10n::Debconf(3pm)				User Contributed Perl Documentation				Debian::L10n::Debconf(3pm)

NAME

       Debian::L10n::Debconf - translation status of Debconf templates

SYNOPSIS

	use Debian::L10n::Debconf;
	my $tmpl = Debian::L10n::Debconf->new();
	$tmpl->read_compact($file);
	my @languages = $tmpl->langs();
	foreach (sort @languages) {
	       my ($t,$f,$u) = $tmpl->stats($_);
	       print "$_:${t}t${f}f${u}u
";
	}

DESCRIPTION

       This module extracts informations about translation status of Debconf templates files.

METHODS

       new This is the constructor.

	      my $tmpl = Debian::L10n::Debconf->new();

       read_compact
	   Read a templates file containing all translations.  An optional second argument may be used, any non-zero value tells that this file
	   comes with translations in other files.  In such a case no warning is raised if this file contains translated fields, because
	   maintainer is assumed to be responsible for such translations.

	      $tmpl->read_compact($file);

       read_dispatched
	   Read templates contained in several files.  First argument is the English file, all other arguments are translated templates files.

	      @trans = qw(templates.de templates.fr templates.ja templates.nl);
	      $tmpl->read_dispatched('templates', @trans);

       langs
	   Return the languages in which this templates file is translated.

	      my @list = $tmpl->langs();

       filename
	   When templates are dispatched into several files, return the filename in which the language passed as argument is found.

	      my $filename = $tmpl->filename("de");

       count
	   Return the number of translatable strings in this templates file.

	      my $number = $tmpl->count();

       stats
	   With an argument, return an array consisting of the number of translated, fuzzy and untranslated strings for the language given as
	   argument.  Without argument, return a hash array indexed by language and returning an array of the number of translated, fuzzy and
	   untranslated strings.

	      my ($t, $f, $u) = $tmpl->stats("de");
	      my %stats  = $tmpl->stats();
	      foreach (keys %stats) {
		      print $_.':'. $stats{$_}->[0].'t'.$stats{$_}->[1].'f'.
			   $stats{$_}->[2]."u
";
	      }

       entries
	   Return an array containing all Debconf ids found in this templates file.

	      my @ids = $tmpl->entries();

AUTHOR

       Copyright (C) 2001  Denis Barbier <barbier@debian.org>

       This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by
       the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

perl v5.14.2							    2011-03-30						Debian::L10n::Debconf(3pm)