Open System Services Shell and Utilities Reference Manual (G06.27+, H06.04+)

User Commands (g - j) gencat(1)
line. If you place the escape character \ (backslash) as the last character on the line, the
message text continues on the following line. Consider the following example:
This is the text associated with \
message number 5.
The preceding two lines define this single-line message:
This is the text associated with message number 5.
4. The following example shows the use of the $quote command:
$quote " Use a double quote to delimit message text
$set 10 Message Facility - Quote command messages
1 "Use the $quote command to define a character \
\n for delimiting message text" \n
2 "You can include the \"quote\" character in a message \n \
by placinga\infront of it" \n
3 You can include the "quote" character in a message \n \
by beginning it with any other character $quote
4 You can disable the quote mechanism by \n \
using the $quote command without \n a character \
after it \n
In this example, the $quote command defines the " (double quote) as the quote charac-
ter. The quote character must immediately follow the message number and the single
blank character. Any text following the next occurrence of the quote character is
ignored.
The example shows two ways the quote character can be included in the message text:
• Place a single backslash (\) in front of the quote character.
• Begin the message text with another character, as in message 3. The quote char-
acter is not treated specially unless it is the first character after the blank.
The example shows the following:
• A backslash (\) is still required to split a quoted message across lines, as in mes-
sages 2, 3, and 4.
• To display a \ in a message, you must place another \ in front of it, as in mes-
sage 1.
• You can format your message with a newline character by using \n, as in mes-
sage 3.
• If you use the $quote command with no character argument, you disable the
quote mechanism.
NOTES
The $len command is not described by X/OPEN. Other implementations of gencat may not
recognize $len.
DIAGNOSTICS
The gencat utility generates these error messages:
Usage: gencat CatalogFile [SourceFile...]
gencat: Cannot open target file \%s.\n
gencat: The realloc system call failed.
gencat: The following message text is longer than the en
527188-004 Hewlett-Packard Company 4−5