[thirdparty/util-linux.git] / po-man / README.md

# Working with man page translations

## Add a new .po file

To enable a new .po file, add its basename (in fact, the language code), to
the first line of po4a.cfg:

    [po4a_langs] de es fr pl uk

It is not crucial to sort the entries alphabetically, but do it anyway for
better readability.

## Update the template and create translated files

This is done in one step using the following simple command:

    po4a po4a.cfg

If there's something wrong with a .po file, the command will fail. In any case,
have a look at the first line of po4a.cfg if all of the mentioned files are
present.

To the man page authors: Please don't forget to add your new man page to po4a.cfg!
Commit	Line	Data
f99003fb MB	1	# Working with man page translations
	2
	3	## Add a new .po file
	4
b09a9007	5	To enable a new .po file, add its basename (in fact, the language code), to
f99003fb MB	6	the first line of po4a.cfg:
	7
	8	[po4a_langs] de es fr pl uk
	9
	10	It is not crucial to sort the entries alphabetically, but do it anyway for
	11	better readability.
	12
	13	## Update the template and create translated files
	14
	15	This is done in one step using the following simple command:
	16
	17	po4a po4a.cfg
e08e3d58	18
b09a9007	19	If there's something wrong with a .po file, the command will fail. In any case,
f99003fb MB	20	have a look at the first line of po4a.cfg if all of the mentioned files are
	21	present.
	22
	23	To the man page authors: Please don't forget to add your new man page to po4a.cfg!