Path: utzoo!utgpu!news-server.csri.toronto.edu!bonnie.concordia.ca!uunet!cs.utexas.edu!qt.cs.utexas.edu!yale.edu!ox.com!msen.com!emv
From: emv@msen.com (Ed Vielmetti)
Newsgroups: comp.text.sgml
Subject: Re: DTD for UNIX Manual Page
Message-ID: <EMV.91Jun28012346@bronte.aa.ox.com>
Date: 28 Jun 91 05:23:49 GMT
References: <1991Jun27.144331.17689@iscnvx.uucp>
Sender: usenet@ox.com (Usenet News Administrator)
Organization: MSEN, Inc. Ann Arbor MI
Lines: 62
In-Reply-To: lange@iscnvx.uucp's message of 27 Jun 91 14:43:31 GMT


structure of man page for mythical program.

the bsd folks are working on a new "man" macro package for man pages,
and I'm not sure what the current state of affairs is.  there was some
concern that since troff is not free they'd have a hard time shipping
troff based man pages, and they were considering scrapping troff
entirely for something else, but I don't know where that lead to.

--Ed

<manpage>
<name> verbify -- turn nouns into verbs </name>
<synopsis>
	verbify [ -s stemlist ] noun
	verbify -v [ -s stemlist ] verb
</synopsis>
<description>
	verbify verbifies nouns into a state of submission.

	The -v option forces verbify to nounify verbs.
</description>
<environment>
	Options can be specified in the VERBOPTS environment
	parameter.  Where conflicts exist, options on the
	command line take precedence.
</environment>
<examples>
	% verbify verification
	verify
	verificationalize
	% verbify -v negate
	negation
	negative
</examples>
<files>
	/usr/lib/verbify/stemming	stem rules
	/usr/dict/words			system dictionary
</files>
<limitations>
	Words can be no longer than 1024 characters.
<see-also>
	prepositionalize(1), gerundify(1)
</see-also>
<authors>
	Naomi Valentine
</authors>
<diagnostics>
	-- not a noun: unchanged
		When the input word is not a noun (i.e., a
		participle), it is left unaltered.
</diagnostics>
<bugs>
	The -v switch is a crock.

	Performance is slow and uses system resources prodigiously.

	The stemming rules' coverage is uneven; new installations will
	probably want to monitor the output for several months to
	gather local additions.
</bugs>
</manpage>