FINDMSG(1)			 HP-UX 5.0		    FINDMSG(1)

     NAME
	  findmsg, dumpmsg - create message catalog file for
	  modification

     SYNOPSIS
	  findmsg file ...
	  dumpmsg file ...

     HP-UX COMPATIBILITY
	  Level:    HP-UX/STANDARD

	  Origin:   HP

     DESCRIPTION
	  Findmsg extracts messages from C  program  source  file  and
	  writes   them	  to  the  standard  output,  along  with  set
	  information.	The source file lines from  which  the	string
	  literals  are	 to be extracted must have nl_msg and " in the
	  same line.  There are four cases to be handled:

		    printf(nl_msg(1, "message"));

		    #define NLSMESS "message"	  /* nl_msg 1 */

		    char nlsmess[] = "message"	  /* nl_msg 1 */

		    char *nlsmess[] = {
			 "message 1",	/* nl_msg 1 */
			 "message 2",	/* nl_msg 2 */
			 0
		    };

	  In each of the latter	 three	cases,	there  are  executable
	  lines	 elsewhere which contain nl_msg in an executable form,
	  along with the necessary reference.

	  Findmsg derives message  catalog  set	 numbers  from	source
	  lines which appear as:

		    #define NL_SETN 1

	  Typically  a	single	such  line  will  appear  toward   the
	  beginning of the source file.

	  Dumpmsg dumps out messages which are	stored	in  a  message
	  catalog file which was generated by the gencat(1) command.

	  The output of either command is in the form:

		    $set 1
		    1 message1\n
		    2 message two\n
	  Each	message	 can  then  be	changed	 as  necessary,	  then
	  processed by the gencat(1) command.

     SEE ALSO
	  findstr(1), gencat(1), insertmsg(1), getmsg(3C).

     BUGS
	  For use with gencat(1), the output of findmsg must have  the
	  $set line appear first in its output.	 Thus the

	       #define NL_SETN 1

	  must appear before any messages.

	  Only one message may appear on  each	physical  line.	  Each
	  message  must	 appear	 completely on one line along with the
	  nl_msg token.