From owner-freebsd-questions@FreeBSD.ORG Thu Sep 8 20:46:34 2005 Return-Path: X-Original-To: freebsd-questions@freebsd.org Delivered-To: freebsd-questions@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3BFCB16A420 for ; Thu, 8 Sep 2005 20:46:34 +0000 (GMT) (envelope-from keramida@ceid.upatras.gr) Received: from aiolos.otenet.gr (aiolos.otenet.gr [195.170.0.93]) by mx1.FreeBSD.org (Postfix) with ESMTP id 594C943D48 for ; Thu, 8 Sep 2005 20:46:32 +0000 (GMT) (envelope-from keramida@ceid.upatras.gr) Received: from orion.daedalusnetworks.priv (aris.bedc.ondsl.gr [62.103.39.226]) by aiolos.otenet.gr (8.13.4/8.13.4/Debian-1) with SMTP id j88KkSEY031747; Thu, 8 Sep 2005 23:46:28 +0300 Received: from orion.daedalusnetworks.priv (orion [127.0.0.1]) by orion.daedalusnetworks.priv (8.13.4/8.13.4) with ESMTP id j88KkSZj039004; Thu, 8 Sep 2005 23:46:28 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Received: (from keramida@localhost) by orion.daedalusnetworks.priv (8.13.4/8.13.4/Submit) id j88KkSAI039003; Thu, 8 Sep 2005 23:46:28 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) X-Authentication-Warning: orion.daedalusnetworks.priv: keramida set sender to keramida@ceid.upatras.gr using -f Date: Thu, 8 Sep 2005 23:46:28 +0300 From: Giorgos Keramidas To: Stijn Hoop , Gerard Seibert , freebsd-questions Message-ID: <20050908204628.GC38895@orion.daedalusnetworks.priv> References: <43206857.1010803@daleco.biz> <20050908165328.GB37407@orion.daedalusnetworks.priv> <20050908173646.GO20229@pcwin002.win.tue.nl> <20050908175519.GA20222@falcon.midgard.homeip.net> <20050908203203.GP20229@pcwin002.win.tue.nl> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20050908203203.GP20229@pcwin002.win.tue.nl> Cc: Subject: Re: Printing MAN pages X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 08 Sep 2005 20:46:34 -0000 On 2005-09-08 22:32, Stijn Hoop wrote: > On Thu, Sep 08, 2005 at 07:55:19PM +0200, Erik Trulsson wrote: > > On Thu, Sep 08, 2005 at 07:36:46PM +0200, Stijn Hoop wrote: > > > Highly useful to know, but shouldn't we update the man page for man(1)? > > > > > > -t Use /usr/bin/groff -S -man to format the manual page, passing > > > the output to stdout. The output from /usr/bin/groff -S -man > > > may need to be passed through some filter or another before > > > being printed. > > > > > > This does not exactly spell 'output postscript' to me... > > > > It does if you know that postscript is the default output format of > > groff. If one doesn't know what format groff outputs by default, it is > > easily learned by reading the groff(1) manpage. > > True. I'm all in favor of a little bit more userfriendliness in man pages > as long as it's not overkill though. > > How about: > > -t Generate a Postscript version of the manpage, intended for > printing, by using /usr/bin/groff -S -man to format the manual > page, passing the output to stdout. The output from > /usr/bin/groff -S -man may need to be passed through some > filter or another before being printed. > > That way I can do /print in less and still get some useful hint. You all know that groff is thirdparty software, right? We have to take this with the groff developers, if the change is ever going to be imported in FreeBSD. Having said that, I'm in favor of making manpages more useful by a little verbosity (but not too much).