1MSGCAT(1)                        User Commands                       MSGCAT(1)
2
3
4

NAME

6       msgcat - combines several message catalogs
7

SYNOPSIS

9       msgcat [OPTION] [INPUTFILE]...
10

DESCRIPTION

12       Concatenates  and  merges  the specified PO files.  Find messages which
13       are common to two or more of the specified  PO  files.   By  using  the
14       --more-than  option,  greater  commonality may be requested before mes‐
15       sages are printed.  Conversely, the --less-than option may be  used  to
16       specify   less   commonality   before   messages   are   printed  (i.e.
17       --less-than=2 will only print the unique messages).  Translations, com‐
18       ments, extracted comments, and file positions will be cumulated, except
19       that if --use-first is specified, they will be taken from the first  PO
20       file to define them.
21
22       Mandatory  arguments  to  long  options are mandatory for short options
23       too.
24
25   Input file location:
26       INPUTFILE ...
27              input files
28
29       -f, --files-from=FILE
30              get list of input files from FILE
31
32       -D, --directory=DIRECTORY
33              add DIRECTORY to list for input files search
34
35       If input file is -, standard input is read.
36
37   Output file location:
38       -o, --output-file=FILE
39              write output to specified file
40
41       The results are written to standard output if no output file is  speci‐
42       fied or if it is -.
43
44   Message selection:
45       -<, --less-than=NUMBER
46              print messages with less than this many definitions, defaults to
47              infinite if not set
48
49       ->, --more-than=NUMBER
50              print messages with more than this many definitions, defaults to
51              0 if not set
52
53       -u, --unique
54              shorthand  for --less-than=2, requests that only unique messages
55              be printed
56
57   Input file syntax:
58       -P, --properties-input
59              input files are in Java .properties syntax
60
61       --stringtable-input
62              input files are in NeXTstep/GNUstep .strings syntax
63
64   Output details:
65       -t, --to-code=NAME
66              encoding for output
67
68       --use-first
69              use first available translation for each  message,  don't  merge
70              several translations
71
72       --lang=CATALOGNAME
73              set 'Language' field in the header entry
74
75       --color
76              use colors and other text attributes always
77
78       --color=WHEN
79              use  colors and other text attributes if WHEN.  WHEN may be 'al‐
80              ways', 'never', 'auto', or 'html'.
81
82       --style=STYLEFILE
83              specify CSS style rule file for --color
84
85       -e, --no-escape
86              do not use C escapes in output (default)
87
88       -E, --escape
89              use C escapes in output, no extended chars
90
91       --force-po
92              write PO file even if empty
93
94       -i, --indent
95              write the .po file using indented style
96
97       --no-location
98              do not write '#: filename:line' lines
99
100       -n, --add-location
101              generate '#: filename:line' lines (default)
102
103       --strict
104              write out strict Uniforum conforming .po file
105
106       -p, --properties-output
107              write out a Java .properties file
108
109       --stringtable-output
110              write out a NeXTstep/GNUstep .strings file
111
112       -w, --width=NUMBER
113              set output page width
114
115       --no-wrap
116              do not break long message lines, longer  than  the  output  page
117              width, into several lines
118
119       -s, --sort-output
120              generate sorted output
121
122       -F, --sort-by-file
123              sort output by file location
124
125   Informative output:
126       -h, --help
127              display this help and exit
128
129       -V, --version
130              output version information and exit
131

AUTHOR

133       Written by Bruno Haible.
134

REPORTING BUGS

136       Report     bugs    in    the    bug    tracker    at    <https://savan‐
137       nah.gnu.org/projects/gettext> or by email to <bug-gettext@gnu.org>.
138

COPYRIGHT

140       Copyright © 2001-2023 Free Software Foundation, Inc.   License  GPLv3+:
141       GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>
142       This  is  free  software:  you  are free to change and redistribute it.
143       There is NO WARRANTY, to the extent permitted by law.
144

SEE ALSO

146       The full documentation for msgcat is maintained as  a  Texinfo  manual.
147       If  the  info  and msgcat programs are properly installed at your site,
148       the command
149
150              info msgcat
151
152       should give you access to the complete manual.
153
154
155
156GNU gettext-tools 0.22             June 2023                         MSGCAT(1)