Mercurial > repos > rliterman > csp2

annotate CSP2/CSP2_env/env-d9b9114564458d9d-741b3de822f2aaca6c6caa4325c4afce/share/man/man1/msgmerge.1 @ 68:5028fdace37b

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
planemo upload commit 2e9511a184a1ca667c7be0c6321a36dc4e3d116d
author jpayne
date Tue, 18 Mar 2025 16:23:26 -0400
parents
children
rev   line source
jpayne@68 1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6.
jpayne@68 2 .TH MSGMERGE "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands"
jpayne@68 3 .SH NAME
jpayne@68 4 msgmerge \- merge message catalog and template
jpayne@68 5 .SH SYNOPSIS
jpayne@68 6 .B msgmerge
jpayne@68 7 [\fI\,OPTION\/\fR] \fI\,def.po ref.pot\/\fR
jpayne@68 8 .SH DESCRIPTION
jpayne@68 9 .\" Add any additional description here
jpayne@68 10 .PP
jpayne@68 11 Merges two Uniforum style .po files together. The def.po file is an
jpayne@68 12 existing PO file with translations which will be taken over to the newly
jpayne@68 13 created file as long as they still match; comments will be preserved,
jpayne@68 14 but extracted comments and file positions will be discarded. The ref.pot
jpayne@68 15 file is the last created PO file with up\-to\-date source references but
jpayne@68 16 old translations, or a PO Template file (generally created by xgettext);
jpayne@68 17 any translations or comments in the file will be discarded, however dot
jpayne@68 18 comments and file positions will be preserved. Where an exact match
jpayne@68 19 cannot be found, fuzzy matching is used to produce better results.
jpayne@68 20 .PP
jpayne@68 21 Mandatory arguments to long options are mandatory for short options too.
jpayne@68 22 .SS "Input file location:"
jpayne@68 23 .TP
jpayne@68 24 def.po
jpayne@68 25 translations referring to old sources
jpayne@68 26 .TP
jpayne@68 27 ref.pot
jpayne@68 28 references to new sources
jpayne@68 29 .TP
jpayne@68 30 \fB\-D\fR, \fB\-\-directory\fR=\fI\,DIRECTORY\/\fR
jpayne@68 31 add DIRECTORY to list for input files search
jpayne@68 32 .TP
jpayne@68 33 \fB\-C\fR, \fB\-\-compendium\fR=\fI\,FILE\/\fR
jpayne@68 34 additional library of message translations,
jpayne@68 35 may be specified more than once
jpayne@68 36 .SS "Operation mode:"
jpayne@68 37 .TP
jpayne@68 38 \fB\-U\fR, \fB\-\-update\fR
jpayne@68 39 update def.po,
jpayne@68 40 do nothing if def.po already up to date
jpayne@68 41 .SS "Output file location:"
jpayne@68 42 .TP
jpayne@68 43 \fB\-o\fR, \fB\-\-output\-file\fR=\fI\,FILE\/\fR
jpayne@68 44 write output to specified file
jpayne@68 45 .PP
jpayne@68 46 The results are written to standard output if no output file is specified
jpayne@68 47 or if it is \-.
jpayne@68 48 .PP
jpayne@68 49 Output file location in update mode:
jpayne@68 50 The result is written back to def.po.
jpayne@68 51 .TP
jpayne@68 52 \fB\-\-backup\fR=\fI\,CONTROL\/\fR
jpayne@68 53 make a backup of def.po
jpayne@68 54 .TP
jpayne@68 55 \fB\-\-suffix\fR=\fI\,SUFFIX\/\fR
jpayne@68 56 override the usual backup suffix
jpayne@68 57 .PP
jpayne@68 58 The version control method may be selected via the \fB\-\-backup\fR option or through
jpayne@68 59 the VERSION_CONTROL environment variable. Here are the values:
jpayne@68 60 .TP
jpayne@68 61 none, off
jpayne@68 62 never make backups (even if \fB\-\-backup\fR is given)
jpayne@68 63 .TP
jpayne@68 64 numbered, t
jpayne@68 65 make numbered backups
jpayne@68 66 .TP
jpayne@68 67 existing, nil
jpayne@68 68 numbered if numbered backups exist, simple otherwise
jpayne@68 69 .TP
jpayne@68 70 simple, never
jpayne@68 71 always make simple backups
jpayne@68 72 .PP
jpayne@68 73 The backup suffix is '~', unless set with \fB\-\-suffix\fR or the SIMPLE_BACKUP_SUFFIX
jpayne@68 74 environment variable.
jpayne@68 75 .SS "Operation modifiers:"
jpayne@68 76 .TP
jpayne@68 77 \fB\-m\fR, \fB\-\-multi\-domain\fR
jpayne@68 78 apply ref.pot to each of the domains in def.po
jpayne@68 79 .TP
jpayne@68 80 \fB\-\-for\-msgfmt\fR
jpayne@68 81 produce output for 'msgfmt', not for a translator
jpayne@68 82 .TP
jpayne@68 83 \fB\-N\fR, \fB\-\-no\-fuzzy\-matching\fR
jpayne@68 84 do not use fuzzy matching
jpayne@68 85 .TP
jpayne@68 86 \fB\-\-previous\fR
jpayne@68 87 keep previous msgids of translated messages
jpayne@68 88 .SS "Input file syntax:"
jpayne@68 89 .TP
jpayne@68 90 \fB\-P\fR, \fB\-\-properties\-input\fR
jpayne@68 91 input files are in Java .properties syntax
jpayne@68 92 .TP
jpayne@68 93 \fB\-\-stringtable\-input\fR
jpayne@68 94 input files are in NeXTstep/GNUstep .strings
jpayne@68 95 syntax
jpayne@68 96 .SS "Output details:"
jpayne@68 97 .TP
jpayne@68 98 \fB\-\-lang\fR=\fI\,CATALOGNAME\/\fR
jpayne@68 99 set 'Language' field in the header entry
jpayne@68 100 .TP
jpayne@68 101 \fB\-\-color\fR
jpayne@68 102 use colors and other text attributes always
jpayne@68 103 .TP
jpayne@68 104 \fB\-\-color\fR=\fI\,WHEN\/\fR
jpayne@68 105 use colors and other text attributes if WHEN.
jpayne@68 106 WHEN may be 'always', 'never', 'auto', or 'html'.
jpayne@68 107 .TP
jpayne@68 108 \fB\-\-style\fR=\fI\,STYLEFILE\/\fR
jpayne@68 109 specify CSS style rule file for \fB\-\-color\fR
jpayne@68 110 .TP
jpayne@68 111 \fB\-e\fR, \fB\-\-no\-escape\fR
jpayne@68 112 do not use C escapes in output (default)
jpayne@68 113 .TP
jpayne@68 114 \fB\-E\fR, \fB\-\-escape\fR
jpayne@68 115 use C escapes in output, no extended chars
jpayne@68 116 .TP
jpayne@68 117 \fB\-\-force\-po\fR
jpayne@68 118 write PO file even if empty
jpayne@68 119 .TP
jpayne@68 120 \fB\-i\fR, \fB\-\-indent\fR
jpayne@68 121 indented output style
jpayne@68 122 .TP
jpayne@68 123 \fB\-\-no\-location\fR
jpayne@68 124 suppress '#: filename:line' lines
jpayne@68 125 .TP
jpayne@68 126 \fB\-n\fR, \fB\-\-add\-location\fR
jpayne@68 127 preserve '#: filename:line' lines (default)
jpayne@68 128 .TP
jpayne@68 129 \fB\-\-strict\fR
jpayne@68 130 strict Uniforum output style
jpayne@68 131 .TP
jpayne@68 132 \fB\-p\fR, \fB\-\-properties\-output\fR
jpayne@68 133 write out a Java .properties file
jpayne@68 134 .TP
jpayne@68 135 \fB\-\-stringtable\-output\fR
jpayne@68 136 write out a NeXTstep/GNUstep .strings file
jpayne@68 137 .TP
jpayne@68 138 \fB\-w\fR, \fB\-\-width\fR=\fI\,NUMBER\/\fR
jpayne@68 139 set output page width
jpayne@68 140 .TP
jpayne@68 141 \fB\-\-no\-wrap\fR
jpayne@68 142 do not break long message lines, longer than
jpayne@68 143 the output page width, into several lines
jpayne@68 144 .TP
jpayne@68 145 \fB\-s\fR, \fB\-\-sort\-output\fR
jpayne@68 146 generate sorted output
jpayne@68 147 .TP
jpayne@68 148 \fB\-F\fR, \fB\-\-sort\-by\-file\fR
jpayne@68 149 sort output by file location
jpayne@68 150 .SS "Informative output:"
jpayne@68 151 .TP
jpayne@68 152 \fB\-h\fR, \fB\-\-help\fR
jpayne@68 153 display this help and exit
jpayne@68 154 .TP
jpayne@68 155 \fB\-V\fR, \fB\-\-version\fR
jpayne@68 156 output version information and exit
jpayne@68 157 .TP
jpayne@68 158 \fB\-v\fR, \fB\-\-verbose\fR
jpayne@68 159 increase verbosity level
jpayne@68 160 .TP
jpayne@68 161 \fB\-q\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR
jpayne@68 162 suppress progress indicators
jpayne@68 163 .SH AUTHOR
jpayne@68 164 Written by Peter Miller.
jpayne@68 165 .SH "REPORTING BUGS"
jpayne@68 166 Report bugs in the bug tracker at <https://savannah.gnu.org/projects/gettext>
jpayne@68 167 or by email to <bug\-gettext@gnu.org>.
jpayne@68 168 .SH COPYRIGHT
jpayne@68 169 Copyright \(co 1995\-2023 Free Software Foundation, Inc.
jpayne@68 170 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>
jpayne@68 171 .br
jpayne@68 172 This is free software: you are free to change and redistribute it.
jpayne@68 173 There is NO WARRANTY, to the extent permitted by law.
jpayne@68 174 .SH "SEE ALSO"
jpayne@68 175 The full documentation for
jpayne@68 176 .B msgmerge
jpayne@68 177 is maintained as a Texinfo manual. If the
jpayne@68 178 .B info
jpayne@68 179 and
jpayne@68 180 .B msgmerge
jpayne@68 181 programs are properly installed at your site, the command
jpayne@68 182 .IP
jpayne@68 183 .B info msgmerge
jpayne@68 184 .PP
jpayne@68 185 should give you access to the complete manual.