MSGCC(1) User Commands MSGCC(1)
msgcc - C language message catalog compiler
msgcc [-M-option] [cc-optionsoption] file...
msgcc is a C language message catalog compiler. It accepts cc style
options and arguments.
A msgcpp(1) .mso file is generated for each input .c file. If the -c
option is not specified then a gencat(1) format .msg file is
generated from the input .mso and .msg files. If -c is not specified
then a .msg suffix is appended to the -o file if it doesn't already
have a suffix. The default output is a.out.msg if -c and -o are not
specified.
If -M-new is not specified then messages are merged with those in the
pre-existing -o file.
The following options are supported:
cc-options
Specify cc style options and arguments.
-M-option
Set a msgcc option.
Specify option as one of the following:
mkmsgs
The -o file is assumed to be in
mkmsgs(1) format.
new
Create a new -o file.
preserve
Messages in the -o file that are not
in new .msg file arguments are
preserved. The default is to either
reuse the message numbers with new
message text that is similar to the
old or to delete the message text,
leaving an unused message number.
set=number
Set the message set number to number.
The default is 1.
similar=number
The message text similarity message
threshold. The similarity measure
between old and new message text is:
100*(2*gzip(old+new)\
/(gzip(old)+gzip(new))-1)
where gzip(x) is the size of text x
when compressed by gzip. The default
threshold is $__similar__$.A
threshold of 0 turns off message
replacement, but unused old messages
are still deleted. Use -M-preserve to
preserve all old messages.
verbose
Trace similar message replacements on
the standard error.
The following operands are supported:
file
Specifies the name of the file on which msgcc operates.
0
Successful completion.
>0
An error occurred.
The following example uses msgcc to extract localizable strings from
the file hello.c, marked using ERROR_dictionary(), writes them to the
file hello.mso, and creates a gencat format xxx.msg file:
example% cat hello.c
#include <stdio.h>
#include <stdlib.h>
/*
* dummy macro to avoid including
* libast headers
*/
#define ERROR_dictionary(x) x
int main(int ac, char *av[])
{
puts( ERROR_dictionary("hello world") );
return( EXIT_SUCCESS );
}
example% msgcc -o xxx -D__STDC__ -D__i386 hello.c
example% cat hello.mso
str "hello world"
example% cat xxx.msg
$ xxx message catalog
$translation msgcc 2007-09-25
$set 1
$quote "
1 "hello world"
Glenn Fowler, gsf@research.att.com
See attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Volatile |
+--------------------+-----------------+
cpp(1), gencat(1), mkmsgs(1), msgcpp(1), msgcvt(1), msggen(1),
attributes(7)
October 9, 2007 MSGCC(1)
NAME
msgcc - C language message catalog compiler
SYNOPSIS
msgcc [-M-option] [cc-optionsoption] file...
DESCRIPTION
msgcc is a C language message catalog compiler. It accepts cc style
options and arguments.
A msgcpp(1) .mso file is generated for each input .c file. If the -c
option is not specified then a gencat(1) format .msg file is
generated from the input .mso and .msg files. If -c is not specified
then a .msg suffix is appended to the -o file if it doesn't already
have a suffix. The default output is a.out.msg if -c and -o are not
specified.
If -M-new is not specified then messages are merged with those in the
pre-existing -o file.
OPTIONS
The following options are supported:
cc-options
Specify cc style options and arguments.
-M-option
Set a msgcc option.
Specify option as one of the following:
mkmsgs
The -o file is assumed to be in
mkmsgs(1) format.
new
Create a new -o file.
preserve
Messages in the -o file that are not
in new .msg file arguments are
preserved. The default is to either
reuse the message numbers with new
message text that is similar to the
old or to delete the message text,
leaving an unused message number.
set=number
Set the message set number to number.
The default is 1.
similar=number
The message text similarity message
threshold. The similarity measure
between old and new message text is:
100*(2*gzip(old+new)\
/(gzip(old)+gzip(new))-1)
where gzip(x) is the size of text x
when compressed by gzip. The default
threshold is $__similar__$.A
threshold of 0 turns off message
replacement, but unused old messages
are still deleted. Use -M-preserve to
preserve all old messages.
verbose
Trace similar message replacements on
the standard error.
OPERANDS
The following operands are supported:
file
Specifies the name of the file on which msgcc operates.
EXIT STATUS
0
Successful completion.
>0
An error occurred.
EXAMPLES
Example 1: Using msgcc
The following example uses msgcc to extract localizable strings from
the file hello.c, marked using ERROR_dictionary(), writes them to the
file hello.mso, and creates a gencat format xxx.msg file:
example% cat hello.c
#include <stdio.h>
#include <stdlib.h>
/*
* dummy macro to avoid including
* libast headers
*/
#define ERROR_dictionary(x) x
int main(int ac, char *av[])
{
puts( ERROR_dictionary("hello world") );
return( EXIT_SUCCESS );
}
example% msgcc -o xxx -D__STDC__ -D__i386 hello.c
example% cat hello.mso
str "hello world"
example% cat xxx.msg
$ xxx message catalog
$translation msgcc 2007-09-25
$set 1
$quote "
1 "hello world"
AUTHORS
Glenn Fowler, gsf@research.att.com
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Volatile |
+--------------------+-----------------+
SEE ALSO
cpp(1), gencat(1), mkmsgs(1), msgcpp(1), msgcvt(1), msggen(1),
attributes(7)
October 9, 2007 MSGCC(1)