


msgfmt(1)                                               msgfmt(1)


NNAAMMEE
       msgfmt - create a message object from a message file

SSYYNNOOPPSSIISS
       mmssggffmmtt [ --vv ] _f_i_l_e_n_a_m_e..ppoo ...

DDEESSCCRRIIPPTTIIOONN
       mmssggffmmtt creates a message object _f_i_l_e_n_a_m_e ..mmoo file from the
       portable message file _f_i_l_e_n_a_m_e..ppoo.

       The ..ppoo file contains strings extracted from source  code.
       ..ppoo  files  can  be  edited,  and the messages in them can
       changed to accomodate any language supported by  the  sys-
       tem.

       The xxggeetttteexxtt command (see xxggeetttteexxtt(1)) can be used to cre-
       ate the ddeeffaauulltt..ppoo file.

       The mmssggffmmtt command does not  modify  the  portable  object
       files.

   PPoorrttaabbllee OObbjjeecctt FFiilleess
       Each  ..ppoo file contains one or more lines.  Each line con-
       tains either a comment or a statement.  Comments start the
       line with a hash mark (#) and end with the newline charac-
       ter and are ignored.

       Each directive starts on a new line and is separated  from
       <<_v_a_l_u_e>>  by  white space (such as one or more space or tab
       characters).  <<_v_a_l_u_e>>  consists  of  one  or  more  quoted
       strings  separated  by white space or <CR>.  The following
       are valid directives:
              ddoommaaiinn _d_o_m_a_i_n_n_a_m_e
              mmssggiidd _m_e_s_s_a_g_e___i_d_e_n_t_i_f_i_e_r
              mmssggssttrr _m_e_s_s_a_g_e___s_t_r_i_n_g

       The ddoommaaiinn directive identifies all  following  directives
       until  another ddoommaaiinn directive is encountered as applying
       to the domain _d_o_m_a_i_n_n_a_m_e_.  The _d_o_m_a_i_n_n_a_m_e is a  string  up
       to  MAXDOMAIN  bytes  long, and can contain any characters
       allowed in legal filenames.  Until the first ddoommaaiinn direc-
       tive is encountered in the file, all target strings belong
       to the default  domain.   The  default  domain  is  called
       ddeeffaauulltt.

       The  mmssggiidd  directive specifies the message identifier for
       the following mmssggssttrr  ddiirreeccttiivvee..   The  _m_e_s_s_a_g_e___i_d_e_n_t_i_f_i_e_r
       string  identifies  a  target  string  at  retrieval time.
       Every statement containing a mmssggiidd directive must be  fol-
       lowed by a statement containing a mmssggssttrr directive.

       The  mmssggssttrr  directive specifies the target string associ-
       ated with the _m_e_s_s_a_g_e___i_d_e_n_t_i_f_i_e_r string  declared  in  the
       immediately preceding mmssggiidd directive.



                           25 July 1990                         1





msgfmt(1)                                               msgfmt(1)


OOPPTTIIOONNSS
       --vv        Verbose.   List  duplicate  message identifiers.
                 Message strings are not redefined.

EEXXAAMMPPLLEESS
       The following command creates a named  ..mmoo file  for  each
       domain named in the portable message objects  ffiilleennaammee11..ppoo
       and ffiilleennaammee22..ppoo.

              mmssggffmmtt ffiilleennaammee11..ppoo ffiilleennaammee22..ppoo

       Running mmssggffmmtt(1) on the following sample ..ppoo file creates
       two ..mmoo files, named ffiirrsstt..mmoo and sseeccoonndd..mmoo..
              domain "first.mo"
              msgid "aao"
              msgstr "first sample message"
              domain "second.mo"
              msgid "bbo"
              msgstr "second sample message"

SSEEEE AALLSSOO
       xxggeetttteexxtt(1),, ggeetttteexxtt(3)..



































                           25 July 1990                         2


