From owner-freebsd-doc Mon Oct 4 15:50: 3 1999 Delivered-To: freebsd-doc@freebsd.org Received: from typhoon.mail.pipex.net (typhoon.mail.pipex.net [158.43.128.27]) by hub.freebsd.org (Postfix) with SMTP id B7F3414CF9 for ; Mon, 4 Oct 1999 15:49:57 -0700 (PDT) (envelope-from mark@dogma.freebsd-uk.eu.org) Received: (qmail 618 invoked from network); 4 Oct 1999 22:49:55 -0000 Received: from useraf16.uk.uudial.com (HELO marder-1.) (62.188.132.3) by smtp.dial.pipex.com with SMTP; 4 Oct 1999 22:49:55 -0000 Received: (from mark@localhost) by marder-1. (8.9.3/8.8.8) id XAA01344; Mon, 4 Oct 1999 23:49:56 +0100 (BST) (envelope-from mark) Date: Mon, 4 Oct 1999 23:49:56 +0100 From: Mark Ovens To: Andrew Boothman Cc: doc@freebsd.org, nik@freebsd.org, wosch@cs.tu-berlin.de, nbm@mithrandr.moira.org Subject: Re: Automatic Documentation Index Message-ID: <19991004234956.A977@marder-1> References: Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0pre2i In-Reply-To: Organization: Total lack of Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Oct 04, 1999 at 09:51:48PM +0100, Andrew Boothman wrote: > > On 29-Sep-99 Andrew Boothman wrote: > > Well, I've been quietly working away on this, and I'd like some opinions on > > what I've done so far. > > I've been a little disappointed in the response to this. Do we think > this is a worthwhile project, that we should encourage the Ports > team to adopt, or should I just drop the idea? > Seems like a good thing to me. I've just tried it out (had to change the paths to the FAQ and Handbook for the DocBook docs). There are quite a few ports that install docs other than (& sometimes instead of) manpages but don't advertise the fact. As a temporary solution, until the +DOC files are added, how about looking for html files in the +CONTENTS files? Something like # cd /var/db/pkg # grep '\.html$' */+CONTENTS and parsing the output in some way (e.g. if there are several .html files installed including "index.html" then just list the index and ignore the others). It's not perfect, but it would dig out all the "hidden" documentation. I've only ever dabbled with perl so I can't guarantee to make it work, but I'll have a go at implementing this if you feel that it's worthwhile. > I certainly think it's a good idea, but i'll need the support of at > least somebody else, otherwise it's just a one-man crusade. I need > the documentation project behind me on this. > > Do we think that newbies and busy sysadmins alike would benifit from > an index page like this or not? If so, how should we move forward > toward implementing it? > > Thanks. > > --- > 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 -- STATE-OF-THE-ART: Any computer you can't afford. OBSOLETE: Any computer you own. ________________________________________________________________ FreeBSD - The Power To Serve http://www.freebsd.org My Webpage http://ukug.uk.freebsd.org/~mark/ mailto:mark@ukug.uk.freebsd.org http://www.radan.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message