man/man1/msgcc.1

         te
 Copyright (c) 2000-2007 AT&T Knowledge Ventures
 To view license terms, see http://www.opensource.org/licenses/cpl1.0.txt
 Portions Copyright (c) 2007, Sun Microsystems, Inc.
 msgcc 1 "9 Oct 2007" "SunOS 5.11" "User Commands"
 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)\e
 /(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 TYPEATTRIBUTE VALUE
Interface StabilityVolatile


 SEE ALSO

cpp(1), gencat(1), mkmsgs(1), msggen(1),
msgcpp(1), msgcvt(1), attributes(5)