From owner-freebsd-doc Thu Oct 7 16: 1: 4 1999 Delivered-To: freebsd-doc@freebsd.org Received: from scrabble.freeuk.net (scrabble.freeuk.net [212.126.144.6]) by hub.freebsd.org (Postfix) with ESMTP id D002114A2B; Thu, 7 Oct 1999 16:00:42 -0700 (PDT) (envelope-from andrew@ukug.uk.FreeBSD.org) Received: from [212.126.150.11] (helo=cream.org) by scrabble.freeuk.net with esmtp (Exim 2.11 #1) id 11ZMUR-0002Wh-00; Thu, 7 Oct 1999 23:58:23 +0100 Content-Length: 1154 Message-ID: X-Mailer: XFMail 1.3 [p0] on FreeBSD X-Priority: 3 (Normal) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 8bit MIME-Version: 1.0 In-Reply-To: <19991006175922.A373@marder-1> Date: Thu, 07 Oct 1999 23:58:09 +0100 (BST) From: Andrew Boothman To: Mark Ovens Subject: Re: Automatic Documentation Index Cc: doc@freebsd.org, nik@freebsd.org, wosch@cs.tu-berlin.de, nbm@mithrandr.moira.org Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On 06-Oct-99 Mark Ovens wrote: > I also considered that it could automatically generate initial > +DOCS files. This would be sufficient for many ports and the rest > would need tweaking by hand (the ports related to DocBook itself > are a case in point; there's masses of HTML files there). Maybe > this would encourage support from the ports maintainers as they > would have some (maybe all) the work done for them. I think this is the best idea. Lets have a seperate script that can be used to automatically generate +DOCS files. This can be run, once, by ourselves or by someone on -ports to generate the file, which can then be tweaked and added to the pkg directory. Of course, this won't find documentation which isn't HTML, and I know that a lot of ports still favour text documentation. We could also look for things like 'docs' and 'readme' to give us a start in the +DOCS files, but many ports could require a LOT of tweaking. I still think it's a good idea though. It'll give us and -ports a head start. --- Andrew Boothman FreeBSD UK User Group http://ukug.uk.FreeBSD.org/~andrew/ http://ukug.uk.FreeBSD.org/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message