Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, February 10, 2021
 
 

msgcc (1)

Name

msgcc - C language message catalog compiler

Synopsis

msgcc [-M-option] [cc-optionsoption] file...

Description

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 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 mes-
                                       sage 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(7) for descriptions of the following attributes:




       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE         |      ATTRIBUTE VALUE        |
       +-----------------------------+-----------------------------+
       |Availability                 |developer/astdev             |
       +-----------------------------+-----------------------------+
       |Interface Stability          |Volatile                     |
       +-----------------------------+-----------------------------+

SEE ALSO
       cpp(1),  gencat(1),   mkmsgs(1),   msggen(1),   msgcpp(1),   msgcvt(1),
       attributes(7)



Solaris 11.4                      9 Oct 2007                          msgcc(1)