msgcvt(1) [opensolaris man page]

msgcvt(1)							   User Commands							 msgcvt(1)

NAME

       msgcvt - convert message file to and from HTML

SYNOPSIS

       msgcvt [-hmr]

DESCRIPTION

       msgcvt  reads a gencat(1) format file on the standard input and converts it to HTML on the standard output. The input file must contain the
       control statement $quote " and use the " character to quote message text. The output is in a form suitable for automatic translation by web
       sites such as http://babelfish.altavista.com.

OPTIONS

       The following options are supported:

       -h	 Generate HTML from gencat(1) input.
       --html
		 This is the default.

       -m	 Generate a gencat(1) message file from (presumably translated) HTML. Wide characters are UTF-8 encoded.
       --msg

       -r	 The message file is raw message text, one message per line, with no quoting or line numbering.
       --raw

EXIT STATUS

       0     Successful completion.

       >0    One or more specified jobs does not exist.

EXAMPLES

       Example 1 Generating a gencat Message Catalog File

       The following example generates a gencat(1) message catalog file from an HTML file:

	 example% cat example.html | msgcvt -m > examplecat

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

       gencat(1), msgcc(1), msggen(1), attributes(5)

SunOS 5.11							    9 Oct 2007								 msgcvt(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)