msgcc - C language message catalog compiler
msgcc [-M-option] [cc-optionsoption] file...
msgcc(1) User Commands 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 mes-
sage 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 |
+-----------------------------+-----------------------------+
|Availability |developer/astdev |
+-----------------------------+-----------------------------+
|Interface Stability |Volatile |
+-----------------------------+-----------------------------+
SEE ALSO
cpp(1), gencat(1), mkmsgs(1), msggen(1), msgcpp(1), msgcvt(1),
attributes(7)
Solaris 11.4 9 Oct 2007 msgcc(1)