NAME    [Toc]    [Back]

       debconf-getlang - extract a language from a templates file

SYNOPSIS    [Toc]    [Back]

	debconf-getlang lang master [translation]
	debconf-getlang --stats master translation [...]

DESCRIPTION    [Toc]    [Back]

       This program helps make and manage translations of debconf templates.
       There are basically three situations in which this program might be
       called:

       A translation is just being started.
	   You want to provide the translator with a file they can work on
	   that has the English fields from your templates file, plus blank
	   Field-ll fields for the traget language that they can fill in.

	   To do this, run the program with first parameter being the code for
	   the language that is being translated to, and the second parameter
	   being the filename of the English templates file.

       A translation is well under way.
	   You have changed some English text, or added more items to your
	   templates file, and you want to send the translators a file with
	   the English text plus their current translations (or you are the
	   translator, and you want to generate such a file for your own use).

	   To accomplish this, run the program with the first parameter being
	   the the code for the language that is being translated to, the second
 parameter being the filename of the master English templates
	   file, and the third parameter being the filename of the current
	   translated file.

	   When run this way, the program is smart enough to notice fuzzy
	   translations. For example a fuzzy Description will be output as
	   Description-<lang>-fuzzy, and a new, blank Description-<lang> will
	   be added.  Translators should remove the -fuzzy fields as they correct
 the fuzzy translations.

       Checking the status of a translation
	   To check the status of a translation, use the --status flag, and
	   pass the english template file as the first parameter, and all the
	   other translated templates after that. It will output statistics
	   for each of them. For example:

	     debconf-getlang --stats debian/templates debian/templates.*

NOTE    [Toc]    [Back]

       Note that the text in the generated templates may be word-wrapped by
       debconf.

SEE ALSO    [Toc]    [Back]

       debconf-mergetemplate(1)

AUTHOR    [Toc]    [Back]

       Joey Hess <joey@kitenet.net>



3rd Berkeley Distribution	  2002-02-20		    DEBCONF-GETLANG(1)