From owner-freebsd-questions@FreeBSD.ORG  Thu Jan 12 20:14:18 2006
Return-Path: <owner-freebsd-questions@FreeBSD.ORG>
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 1407616A41F
	for <freebsd-questions@freebsd.org>;
	Thu, 12 Jan 2006 20:14:18 +0000 (GMT)
	(envelope-from dkelly@Grumpy.DynDNS.org)
Received: from smtp.knology.net (smtp.knology.net [24.214.63.101])
	by mx1.FreeBSD.org (Postfix) with SMTP id 279D643D4C
	for <freebsd-questions@freebsd.org>;
	Thu, 12 Jan 2006 20:14:16 +0000 (GMT)
	(envelope-from dkelly@Grumpy.DynDNS.org)
Received: (qmail 7248 invoked by uid 0); 12 Jan 2006 20:14:16 -0000
Received: from user-69-73-60-132.knology.net (HELO Grumpy.DynDNS.org)
	(69.73.60.132)
	by smtp1.knology.net with SMTP; 12 Jan 2006 20:14:16 -0000
Received: by Grumpy.DynDNS.org (Postfix, from userid 928)
	id 73A6961D8; Thu, 12 Jan 2006 14:14:15 -0600 (CST)
Date: Thu, 12 Jan 2006 14:14:15 -0600
From: David Kelly <dkelly@hiwaay.net>
To: SPYRIDON PAPADOPOULOS <SP373@student.apu.ac.uk>
Message-ID: <20060112201415.GB44823@Grumpy.DynDNS.org>
References: <1137094538.8ba70fa0SP373@student.apu.ac.uk>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <1137094538.8ba70fa0SP373@student.apu.ac.uk>
User-Agent: Mutt/1.4.2.1i
Cc: freebsd-questions@freebsd.org
Subject: Re: How to create a manual page in FreeBSD
X-BeenThere: freebsd-questions@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: User questions <freebsd-questions.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-questions>, 
	<mailto:freebsd-questions-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-questions>
List-Post: <mailto:freebsd-questions@freebsd.org>
List-Help: <mailto:freebsd-questions-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-questions>, 
	<mailto:freebsd-questions-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 12 Jan 2006 20:14:18 -0000

On Thu, Jan 12, 2006 at 07:35:38PM +0000, SPYRIDON PAPADOPOULOS wrote:
> Hi all,
> 
> Can anyone describe/give info, of how one can create a manual page for
> a custom program in FreeBSD. A manual page that would be accessible
> through the #man command. Is it possible?

Study troff and write your man page with any old text editor. Suggest
you place it in /usr/local/man/ the same as many others.

Easier than learning troff from the beginning would be to take an
existing man page and make a copy of it. Edit the copy. Proofread every
little change. Suggest /usr/share/man1/man.1.gz would be a good man page
to use as your template.

Gzipping man pages is optional.

-- 
David Kelly N4HHE, dkelly@HiWAAY.net
========================================================================
Whom computers would destroy, they must first drive mad.