From owner-freebsd-current@FreeBSD.ORG  Wed Aug 12 20:56:20 2009
Return-Path: <owner-freebsd-current@FreeBSD.ORG>
Delivered-To: freebsd-current@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 3E25C106566B
	for <freebsd-current@freebsd.org>; Wed, 12 Aug 2009 20:56:20 +0000 (UTC)
	(envelope-from andreast-list@fgznet.ch)
Received: from smtp.fgznet.ch (mail.fgznet.ch [81.92.96.47])
	by mx1.freebsd.org (Postfix) with ESMTP id D438C8FC43
	for <freebsd-current@freebsd.org>; Wed, 12 Aug 2009 20:56:19 +0000 (UTC)
Received: from deuterium.andreas.nets ([91.190.8.131])
	by smtp.fgznet.ch (8.13.8/8.13.8/Submit_SMTPAUTH) with ESMTP id
	n7CKuHmd032595 for <freebsd-current@freebsd.org>;
	Wed, 12 Aug 2009 22:56:17 +0200 (CEST)
	(envelope-from andreast-list@fgznet.ch)
Message-ID: <4A832C70.4030600@fgznet.ch>
Date: Wed, 12 Aug 2009 22:56:16 +0200
From: Andreas Tobler <andreast-list@fgznet.ch>
User-Agent: Thunderbird 2.0.0.22 (Macintosh/20090605)
MIME-Version: 1.0
To: freebsd-current <freebsd-current@freebsd.org>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-Scanned-By: MIMEDefang 2.64 on 81.92.96.47
Subject: tools/kerneldoc
X-BeenThere: freebsd-current@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Discussions about the use of FreeBSD-current
	<freebsd-current.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-current>, 
	<mailto:freebsd-current-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-current>
List-Post: <mailto:freebsd-current@freebsd.org>
List-Help: <mailto:freebsd-current-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-current>,
	<mailto:freebsd-current-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 12 Aug 2009 20:56:20 -0000

Hi,

does anybody care about this 'kerneldoc' package?

Robert's call for testers made me browse through this tools directory 
and as a newbie I wanted to start with something easy.

But I horribly fail to build the docs.

%deuterium_fbsd# make
%make: don't know how to make device_if.m. Stop

I then dived into the subsys dir and started a 'make all'.

Here too, I failed since a few .m files are no more or they are placed 
on a different place. Well, this was easy, more or less. Commenting them 
made the build work, but this is only half the truth, what about the new 
.m files?

I launched a 'find . -name "*.m" | sort | sed s_\./_MFILES+=_' in the 
/usr/src/sys dir and adjusted the Makefile in subsys. Still building... 
but it is building!

So, my simple question, is this kerneldoc something we want to have 
maintained? Or is it an artifact from earlier times?

TIA,
Andreas