Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

OpenSolaris 2009.06 - man page for msgcc (opensolaris section 1)

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)