hi, On Wed, Dec 13, 2000 at 08:35:45AM +1100, Drew Parsons wrote: > What's the "best" way of maintaining or creating a man page? > I'll be needing to do that with some of my packages, but it just occurred to > me I don't actually know how, apart from cutting and pasting in a text > editor. My guess is there's a simple manpage editor out there, or a > sensible emacs mode, so I wouldn't need to use anything so silly as a full > SGML environment.
well, there is a howto on writing a manpage which tells you the basic things. and the manpage to man (the syntax) is a good reference. imho it's not hard to use the direct nroff commands for normal manpages. at least i didn't had any problems once i know the commands and got used to it. i don't know on the sgml part put you got a reply to this already, so, look what you need or what to do and do it accordingly. but it's also good to know the essential commands when the manpage converter doesn't do what you want to do :). so long Othmar