👤
Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

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 speci-
       fied 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 simi-
				       larity 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  mes-
				       sages  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)


All times are GMT -4. The time now is 01:34 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password