From owner-freebsd-questions Sat Nov 22 06:21:51 1997 Return-Path: Received: (from root@localhost) by hub.freebsd.org (8.8.7/8.8.7) id GAA07706 for questions-outgoing; Sat, 22 Nov 1997 06:21:51 -0800 (PST) (envelope-from owner-freebsd-questions) Received: from awfulhak.demon.co.uk (awfulhak.demon.co.uk [158.152.17.1]) by hub.freebsd.org (8.8.7/8.8.7) with ESMTP id GAA07686; Sat, 22 Nov 1997 06:21:18 -0800 (PST) (envelope-from brian@awfulhak.org) Received: from gate.lan.awfulhak.org (localhost [127.0.0.1]) by awfulhak.demon.co.uk (8.8.7/8.8.7) with ESMTP id OAA14836; Sat, 22 Nov 1997 14:15:59 GMT (envelope-from brian@gate.lan.awfulhak.org) Message-Id: <199711221415.OAA14836@awfulhak.demon.co.uk> X-Mailer: exmh version 2.0zeta 7/24/97 To: David Petrou cc: freebsd-doc@freebsd.org, freebsd-questions@freebsd.org Subject: Re: [Q] Making man pages... In-reply-to: Your message of "Fri, 21 Nov 1997 23:17:44 EST." <199711220417.UAA10771@hub.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Date: Sat, 22 Nov 1997 14:15:59 +0000 From: Brian Somers Sender: owner-freebsd-questions@freebsd.org X-Loop: FreeBSD.org Precedence: bulk > I've recently written some software for FreeBSD and I would like to > write some man pages for them. How do people make manpages today? Do > they write in troff directly? I know nothing of troff. Are > there tools that perhaps convert a subset of TeX to troff? > > Do people generally take existing man pages and modify them to create > new ones, or is there a blank template for new man pages? > > I've checked the FAQ and Handbook and came up empty on this topic. I just started writing, and found the macros that I needed from other man pages. Writing them directly gives you a lot more control :-) > Thanks, > David > > P.S.: Please reply to dpetrou@cs.cmu.edu besides the list, as I'm not > subscribed to these lists. -- Brian , , Don't _EVER_ lose your sense of humour....