From owner-freebsd-doc Tue Apr 16 20:34:52 2002 Delivered-To: freebsd-doc@freebsd.org Received: from rwcrmhc53.attbi.com (rwcrmhc53.attbi.com [204.127.198.39]) by hub.freebsd.org (Postfix) with ESMTP id 6F6D937B416 for ; Tue, 16 Apr 2002 20:34:49 -0700 (PDT) Received: from localhost ([12.252.32.143]) by rwcrmhc53.attbi.com (InterMail vM.4.01.03.27 201-229-121-127-20010626) with ESMTP id <20020417033449.NFVJ1083.rwcrmhc53.attbi.com@localhost>; Wed, 17 Apr 2002 03:34:49 +0000 Date: Tue, 16 Apr 2002 21:34:48 -0600 (MDT) Message-Id: <20020416.213448.41628282.horikawa@attbi.com> To: keramida@ceid.upatras.gr, rdm@cfcl.com Cc: doc@FreeBSD.ORG Subject: Re: Which man macros should I use? From: Kazuo Horikawa In-Reply-To: <20020417013517.GA28850@hades.hell.gr> References: <20020417013517.GA28850@hades.hell.gr> X-Mailer: Mew version 2.2 on Emacs 20.7 / Mule 4.0 (HANANOEN) Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org Giorgos Keramidas wrote: > On 2002-04-16 13:59, Rich Morin wrote: > > This may seem like a dumb question (OK; it IS a dumb question :-), but > > I'm hoping that someone here can give me an authoritative answer: > > > > Which troff macros should I use to format the FreeBSD 4.5 man pages? > > > > I've been using "groff -man", but I'm getting some errors. I tried > > "groff -mdoc", as suggested in mdoc(7), but that gives far MORE errors. > > I tried "groff -mandoc", but it acts about like "groff -man". Wazzup? > > If you want plain text output, the following two are equivalent: > > nroff -mandoc file.1 | more > > groff -mandoc -Tascii file.1 | more > > If you want PostScript output, or DVI, or something that is not plain > text, the more general groff -T command is what you need. My recommendation for terminal output is: groff -te -mandoc -Tascii -mtty-char file.1 | more and recommendation for non-terminal output is: groff -te -mandoc -mtty-char file.1 -T Manpages require tbl (e.g., phantasia(6)) want -t specified for groff and manpages require eqn (e.g., groff_out(5) want -e specified for groff. Some special characters (e.g, sigma in groff_out(5)) to be printed on terminal want -mtty-char specified for groff. -- Kazuo Horikawa To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message