1PO4A-NORMALIZE.1P(1)  User Contributed Perl Documentation PO4A-NORMALIZE.1P(1)
2
3
4

NAME

6       po4a-normalize - normalize a documentation file by parsing it in po4a,
7       and writing it back
8

SYNOPSIS

10       po4a-normalize -f fmt master.doc
11

DESCRIPTION

13       The po4a (PO for anything) project goal is to ease translations (and
14       more interestingly, the maintenance of translations) using gettext
15       tools on areas where they were not expected like documentation.
16
17       The po4a-normalize script is a debugging tool used to make sure that
18       po4a don't change the document when it's not supposed to. Only use it
19       if you're developing a new module, or if you doubt the sanity of the
20       tools.
21
22       The generated document will be written to po4a-normalize.output while
23       the generated POT file will be written to po4a-normalize.po by default,
24       but you can use the --localized and --pot options to change that.
25

OPTIONS

27       -o, --option
28           Extra option(s) to pass to the format plugin. See the documentation
29           of each plugin for more information about the valid options and
30           their meanings. For example, you could pass '-o tablecells' to the
31           AsciiDoc parser, while the text parser would accept '-o
32           tabs=split'.
33
34       -b, --blank
35           Create an blank translated document.  The generated translated
36           document will be generated assuming all messages are translated by
37           a space or new line.
38
39           This is useful to check what parts of the document cannot be
40           translated.
41
42       -h, --help
43           Show a short help message.
44
45       --help-format
46           List the documentation formats understood by po4a.
47
48       -f, --format
49           Format of the documentation you want to handle. Use the
50           --help-format option to see the list of available formats.
51
52       -M, --master-charset
53           Charset of the file containing the document to translate.
54
55       -l, --localized
56           Name of the normalized file to produce (po4a-normalize.output by
57           default).
58
59       -p, --pot
60           Pot file to produce (po4a-normalize.po by default).
61
62       -V, --version
63           Display the version of the script and exit.
64

SEE ALSO

66       po4a-gettextize(1), po4a-translate(1), po4a-updatepo(1), po4a(7)
67

AUTHORS

69        Denis Barbier <barbier@linuxfr.org>
70        Nicolas François <nicolas.francois@centraliens.net>
71        Martin Quinson (mquinson#debian.org)
72
74       Copyright 2002-2020 by SPI, inc.
75
76       This program is free software; you may redistribute it and/or modify it
77       under the terms of GPL (see the COPYING file).
78
79
80
81perl v5.38.0                      2023-10-12              PO4A-NORMALIZE.1P(1)
Impressum