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
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)