Date: Thu, 07 Oct 1999 23:58:09 +0100 (BST) From: Andrew Boothman <andrew@ukug.uk.FreeBSD.org> To: Mark Ovens <mark@ukug.uk.freebsd.org> Cc: doc@freebsd.org, nik@freebsd.org, wosch@cs.tu-berlin.de, nbm@mithrandr.moira.org Subject: Re: Automatic Documentation Index Message-ID: <XFMail.991007235809.andrew@ukug.uk.FreeBSD.org> In-Reply-To: <19991006175922.A373@marder-1>
next in thread | previous in thread | raw e-mail | index | archive | help
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 <andrew@ukug.uk.FreeBSD.org> 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?XFMail.991007235809.andrew>