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 suf-
fix. 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 re-
use 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(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWastdev |
+-----------------------------+-----------------------------+
|Interface Stability |Volatile |
+-----------------------------+-----------------------------+
SEE ALSO
cpp(1), gencat(1), mkmsgs(1), msggen(1), msgcpp(1), msgcvt(1), attributes(5)
SunOS 5.11 9 Oct 2007 msgcc(1)