mkmsgs(1)                                                         mkmsgs(1)




 NAME    [Toc]    [Back]
      mkmsgs - create message files for use by gettxt()

 SYNOPSIS    [Toc]    [Back]
      mkmsgs [-o] [-i locale] textfile msgfile

 DESCRIPTION    [Toc]    [Back]
      The mkmsgs command takes as input a file of localized text strings and
      generates a message file that can be accessed by the gettxt(3C)
      routine.  textfile is the name of the file that contains the text
      strings.  msgfile is the name of the output message file.  mkmsgs
      appends the suffix .cat to the message file name.  The combined length
      of the file name should be less than 14 bytes for short file name file
      system.  The msgfile file should not contain a colon since it will
      confuse the formatting routines.

      The textfile file contains the localized text strings.  The text
      strings are separated by a newline character.  The text strings are
      processed sequentially and copied to the msgfile message file.  An
      empty line in the input results in a corresponding empty message
      written to the msgfile message file.

    Options    [Toc]    [Back]
      The mkmsgs command supports the following options:

           -o             Overwrite the msgfile message file if it exists.

           -i locale      The msgfile message file is installed in the
                          system-wide localization directory corresponding
                          to the specified locale.  Only a user with the
                          appropriate privileges can create or overwrite the
                          message file in that directory.  The directory
                          will be created if it does not exist.

 EXTERNAL INFLUENCES    [Toc]    [Back]
    Environment Variables
      LC_CTYPE determines the interpretation of messages as single- and/or
      multibyte characters.

      Messages are issued in LANG if it is set to a valid language and LANG
      messages are available.  Otherwise "C" locale messages are issued.

      If LC_CTYPE is not specified in the environment or is set to the empty
      string, the value of LANG is used as a default for each unspecified or
      empty variable.  If LANG is not specified or is set to the empty
      string, a default of "C" (see lang(5)) is used instead of LANG.  If
      any internationalization variable contains an invalid setting, mkmsgs
      behaves as if all internationalization variables are set to "C".  See
      environ(5).





 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 mkmsgs(1)                                                         mkmsgs(1)




    International Code Set Support    [Toc]    [Back]
      Single- and multibyte character code sets are supported.

 EXAMPLES    [Toc]    [Back]
      The following example shows the format of the input text strings:

           global %s not found\n
           \n\n<press return to continue>\n\n
           \t%s, %d, %d,typ = %d, disp = '%s'\n

 WARNINGS    [Toc]    [Back]
      mkmsgs is provided for SVID3 compatibility only.  The user is
      encouraged to use the NLS mechanism developed by HP and the X/Open
      Company, Ltd.

 SEE ALSO    [Toc]    [Back]
      gencat(1), gettxt(3C), setlocale(3C).

 STANDARDS COMPLIANCE    [Toc]    [Back]
      mkmsgs: SVID3


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003