insertmsg(1)                                                   insertmsg(1)




 NAME    [Toc]    [Back]
      insertmsg - use findstr(1) output to insert calls to catgets(3C)

 SYNOPSIS    [Toc]    [Back]
      insertmsg [-h] [-nnumber] [-iamount] [-snumber] stringlist

 DESCRIPTION    [Toc]    [Back]
      insertmsg examines the file stringlist, which is assumed to be the
      output of findstr after subsequent editing to remove any strings that
      do not need to be localized (see findstr(1)).  If the -h option is
      specified, insertmsg places the following lines at the beginning of
      each file named in stringlist:

           #ifndef NLS
           #define catgets(i,sn,mn,s) (s)
           #else NLS
           #define NL_SETN number
           #include <nl_types.h>
           #endif NLS

      where number is a set number defined by the -s option; the default is
      1.  For each string in stringlist, insertmsg surrounds the string in
      the corresponding file with an expression of the form:

           (catgets(catd,NL_SETN,msg_num,"default string"))

      The default string is the original string referenced by the line in
      stringlist, and msg_num is replaced by the message number assigned to
      that string.  The assigned message numbers begin with the number
      defined by the -n option and are incremented by the amount defined by
      the -i option.  The default is 1 for both the starting message number
      and the increment.  If name.c is the file to be modified, as specified
      within the stringlist file, insertmsg places the modified source in
      nl_name.c.  The user must then manually edit the file nl_name.c to
      insert the following statements:

           nl_catd catd;
           catd = catopen("appropriate message catalog",0);

      The data type nl_catd is defined in <nl_types.h> and catd is a
      parameter to the calls to catgets, which are inserted for each string
      from stringlist.

      insertmsg also sends to the standard output a file that can be used as
      input to gencat (see gencat(1)).

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




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






 insertmsg(1)                                                   insertmsg(1)




      LC_MESSAGES determines the language in which messages are displayed.

      If LC_CTYPE or LC_MESSAGES 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, insertmsg behaves as if all internationalization
      variables are set to "C".  See environ(5).

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

 DIAGNOSTICS    [Toc]    [Back]
      If insertmsg does not find opening or closing double quotes where
      required in the strings file, it prints insertmsg exiting : lost in
      strings file and aborts.  If this happens, check the strings file to
      ensure that the lines that have been kept there have not been altered.

 WARNINGS    [Toc]    [Back]
      If the -h option is not used, it may be necessary to manually add the
      following statement to the file created by insertmsg:

           #include <nl_types.h>

      insertmsg inserts a pointer to a static area that is overwritten on
      each call.

      The insertmsg command is HP proprietary, not portable to other
      vendors' systems, and will not be provided in future HP-UX releases.

 AUTHOR    [Toc]    [Back]
      insertmsg was developed by HP.

 SEE ALSO    [Toc]    [Back]
      findstr(1), gencat(1), catgets(3C), catopen(3C).


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