KDE_3_4_BRANCH: kdesdk/debian
CVS commit by benb:
More options for cvs2dist and environment variables for split2po. This finishes the manpage updates for kdesdk/scripts and kdesdk/poxml.
M +28 -3 cvs2dist.1 1.2.4.2
M +14 -0 split2po.1 1.7.4.2
--- kdesdk/debian/cvs2dist.1 #1.2.4.1:1.2.4.2
@@ -29,4 +29,5 @@
[ \fB\-B, \-\-branch\fP \fIbranch\fP ]
[ \fB\-\-no-i18n\fP ]
+[ \fB\-\-no-i18n-lang\fP \fIlanguages\fP ]
[ \fB\-\-log=\fP\fIlogfile\fP | \fB\-l\fP ]
[ \fB\-m, \-\-make-unpackaged\fP ]
@@ -37,4 +38,5 @@
[ \fB\-e, \-\-required-header-error-message\fP \fImessage\fP ]
[ \fB\-d, \-\-remove-hidden\fP ]
+[ \fB\-\-replace-files\fP \fIpairs\fP ]
[[--] \fIaddfile\fP ... ]
.PP
@@ -50,8 +52,9 @@
download, build and install.
.PP
-By default, cvs2dist automatically tries to check out translations
+By default, cvs2dist automatically tries to check out all translations
of strings and documentation from the corresponding parts of the
\fIkde-i18n\fP CVS module and include them in the final packages.
-This can be suppressed by passing the option \-\-no-i18n.
+This can be suppressed or modified using the options \-\-no-i18n or
+\-\-no-i18n-lang.
.PP
The initial argument \fIpath-to-module\fP should specify where the CVS
@@ -108,5 +111,10 @@
.TP
\fB\-\-no-i18n\fP
-Do not try to check out translations from CVS.
+Do not check out any translations from CVS.
+.TP
+\fB\-\-no-i18n-lang\fP \fIlanguages\fP
+Exclude the given language(s) when checking out translations from CVS.
+The list of languages should be comma-separated,
+such as \fI\-\-no-i18n-lang uk,de,en_GB\fP .
.TP
\fB\-\-log=\fP\fIlogfile\fP
@@ -144,4 +152,21 @@
\fB\-h, \-\-help\fP
Display instructions on how to use cvs2dist.
+.TP
+\fB\-\-replace-files\fP \fIpairs\fP
+Move one or more files around in the final distribution packages.
+The \fIpairs\fP argument should be a comma-separated list of
+replacements to make. Each replacement specifies a single file to move, and
+should be of the form \fIsource\fP@\fIdest\fP.
+.br
+For each replacement, the source file will be moved to the
+destination file (in particular, the source file will be deleted).
+All filenames are relative to the top-level directory
+of the package. Spaces in filenames are not allowed.
+.br
+Please be careful when using this option! Try to avoid the use of ..
+in the filenames, since it may cause unexpected problems.
+.br
+An example of this option might be
+\fI\-\-replace-files take_this_file@move_it_here,configure.in.bot.dist@configure.in.bot\fP .
.SH EXAMPLE
The following example creates packages of the kolf picture plugin from
--- kdesdk/debian/split2po.1 #1.7.4.1:1.7.4.2
@@ -34,4 +34,18 @@
.PP
This utility is part of the KDE Software Development Kit.
+.SH ENVIRONMENT VARIABLES
+.TP
+NO_CREDITS
+If set, the "ROLES_OF_TRANSLATORS" and "CREDIT_FOR_TRANSLATORS" messages
+will be omitted. By default these are always included at the end of
+the PO-file, with empty message strings.
+.br
+These messages are used with KDE documentation, so you may wish to set
+NO_CREDITS if you are working with some other type of non-KDE documentation.
+.TP
+REPORT_MISMATCHES
+Set this variable to "no" if you wish mismatch reporting to be
+suppressed. By default, any apparent mismatches between the two XML
+files will be noted on standard error.
.SH SEE ALSO
.BR po2xml (1),
Reply to: