opensolaris man page for msgcc

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)