HP-UX Reference (11i v2 04/09) - 1 User Commands A-M (vol 1)

i
insertmsg(1) insertmsg(1)
NAME
insertmsg - use findstr output to insert calls to catgets()
SYNOPSIS
insertmsg [-h][-iamount][
-nnumber][-snumber] stringlist
DESCRIPTION
insertmsg examines the file stringlist , which is assumed to be the output of
findstr after subse-
quent 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,"defaultstring"))
defaultstring 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
cat-
gets(), 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 gen-
cat(1)).
EXTERNAL INFLUENCES
Environment Variables
LC_CTYPE determines the interpretation of text as single- and/or multi-byte characters.
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
Single- and multi-byte character code sets are supported.
DIAGNOSTICS
insertmsg exiting : lost in strings file
insertmsg did not find opening or closing double quotes where required in the strings file. It
aborts. Check the strings file to ensure that the lines that have been kept there have not been
altered.
WARNINGS
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.
HP-UX 11i Version 2: September 2004 − 1 − Hewlett-Packard Company Section 1−−381