From owner-freebsd-hackers@FreeBSD.ORG  Thu May  8 02:11:05 2003
Return-Path: <owner-freebsd-hackers@FreeBSD.ORG>
Delivered-To: freebsd-hackers@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 5178937B401
	for <freebsd-hackers@freebsd.org>;
	Thu,  8 May 2003 02:11:05 -0700 (PDT)
Received: from cirb503493.alcatel.com.au (c18609.belrs1.nsw.optusnet.com.au
	[210.49.80.204])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 8459943F93
	for <freebsd-hackers@freebsd.org>;
	Thu,  8 May 2003 02:11:03 -0700 (PDT)
	(envelope-from peterjeremy@optushome.com.au)
Received: from cirb503493.alcatel.com.au (localhost.alcatel.com.au
	[127.0.0.1])h489Aup9006689;	Thu, 8 May 2003 19:10:57 +1000 (EST)
	(envelope-from jeremyp@cirb503493.alcatel.com.au)
Received: (from jeremyp@localhost)
	by cirb503493.alcatel.com.au (8.12.8/8.12.8/Submit) id h489As6V006688;
	Thu, 8 May 2003 19:10:54 +1000 (EST)
Date: Thu, 8 May 2003 19:10:54 +1000
From: Peter Jeremy <peterjeremy@optushome.com.au>
To: William Michael Grim <wgrim@siue.edu>
Message-ID: <20030508091054.GA6640@cirb503493.alcatel.com.au>
References: <Pine.SO4.4.05.10305080324001.12960-100000@cougar.isg.siue.edu>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <Pine.SO4.4.05.10305080324001.12960-100000@cougar.isg.siue.edu>
User-Agent: Mutt/1.4.1i
cc: freebsd-hackers@freebsd.org
Subject: Re: What are .1 files in /usr/src?
X-BeenThere: freebsd-hackers@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Technical Discussions relating to FreeBSD
	<freebsd-hackers.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-hackers>,
	<mailto:freebsd-hackers-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-hackers>
List-Post: <mailto:freebsd-hackers@freebsd.org>
List-Help: <mailto:freebsd-hackers-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-hackers>,
	<mailto:freebsd-hackers-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 08 May 2003 09:11:05 -0000

On Thu, May 08, 2003 at 03:25:47AM -0500, William Michael Grim wrote:
>I was curious, what are all the .1 files in /usr/src?  A couple examples
>are /usr/src/bin/dd/dd.1 and /usr/src/bin/pax/pax.1.  Are these some sort
>of files that are converted to man pages in some way?  If so, how is this
>achieved?

As already mentioned, they are the man pages.  By default, they are
gzip(1)'d into /usr/share/man/manX/ to save space.  They are converted
into formatted text using groff(1).  As an example, you can get a
PostScript version of the dd(1) man page with either of the following:
	groff -man /usr/src/bin/dd/dd.1 > dd.ps
	gzcat /usr/share/man/man1/dd.1.gz | groff -man > dd.ps

Peter