From owner-freebsd-doc@FreeBSD.ORG  Thu Feb  8 19:35:20 2007
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
X-Original-To: freebsd-doc@FreeBSD.org
Delivered-To: freebsd-doc@FreeBSD.org
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 91BC316A409
	for <freebsd-doc@FreeBSD.org>; Thu,  8 Feb 2007 19:35:20 +0000 (UTC)
	(envelope-from niclas.zeising@gmail.com)
Received: from pne-smtpout1-sn1.fre.skanova.net
	(pne-smtpout1-sn1.fre.skanova.net [81.228.11.98])
	by mx1.freebsd.org (Postfix) with ESMTP id 56DF613C46B
	for <freebsd-doc@FreeBSD.org>; Thu,  8 Feb 2007 19:35:20 +0000 (UTC)
	(envelope-from niclas.zeising@gmail.com)
Received: from [81.229.125.188] (81.229.125.188) by
	pne-smtpout1-sn1.fre.skanova.net (7.2.076.2)
	id 45AE5BE8005BE6C9; Thu, 8 Feb 2007 19:26:08 +0100
Message-ID: <45CB6B3B.2020606@gmail.com>
Date: Thu, 08 Feb 2007 19:26:03 +0100
From: Niclas Zeising <niclas.zeising@gmail.com>
User-Agent: Thunderbird 1.5.0.9 (Windows/20061207)
MIME-Version: 1.0
To: pav@FreeBSD.org
References: <b0ba59300702080643y1eeadfcp5c7750dfcb45c251@mail.gmail.com>	
	<bc292860702080742u4868e627p70b1a8a89624bfe5@mail.gmail.com>
	<1170951416.33675.61.camel@pav.hide.vol.cz>
In-Reply-To: <1170951416.33675.61.camel@pav.hide.vol.cz>
Content-Type: text/plain; charset=ISO-8859-2; format=flowed
Content-Transfer-Encoding: 8bit
Cc: Jonatan B <onatan@gmail.com>, freebsd-doc@FreeBSD.org
Subject: Re: missing man pages
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 08 Feb 2007 19:35:20 -0000

Pav Lucistnik wrote:
> Niclas Zeising píše v čt 08. 02. 2007 v 16:42 +0100:
>> On 2/8/07, Jonatan B <onatan@gmail.com> wrote:
>>> Hey all,
>>> I came up with a little utility to scan the man pages
>>> in the base system and report references to missing man
>>> pages. The result is 636 wrong references. Some of these
>>> are valid (like the reference to zsh(1) in sysctl(1)) and some
>>> are not (like the reference to dhcpd(8) from dhclient(8)), and
>>> surely some bugs in my util.
>>>
>>> How do we go about fixing the man pages?
>>>
>>> (Please CC me as I'm not subscribed).
>>>
>>> Regards,
>>> Jonathan
>> I think the best way is to post your findings in a PR, or to clean up
>> the man  pages and send the patch in diff format as a PR.
> 
> Best thing is to write all those missing man pages. You volunteer? :)
> 

Uhm... Well, that's true of course. ;)

But some of the man pages are probably not supposed to be in FreeBSD 
base at all, dhcpd(8) as an example. It was axed long ago, IIRC, and the 
xref from dhclient(8) is maybe just an artifact of that.

It would be good to have the list of missing manpages though, or at 
least the script to find them. That way me or someone else can see which 
manpages are missing, and maybe hack something together.
Regards!
//Niclas