From owner-freebsd-doc Sat Oct 16 13:53:54 1999 Delivered-To: freebsd-doc@freebsd.org Received: from monsoon.mail.pipex.net (monsoon.mail.pipex.net [158.43.128.69]) by hub.freebsd.org (Postfix) with SMTP id A2840154F4 for ; Sat, 16 Oct 1999 13:53:40 -0700 (PDT) (envelope-from mark@dogma.freebsd-uk.eu.org) Received: (qmail 14196 invoked from network); 16 Oct 1999 20:53:39 -0000 Received: from userbe93.uk.uudial.com (HELO marder-1.) (62.188.142.15) by smtp.dial.pipex.com with SMTP; 16 Oct 1999 20:53:39 -0000 Received: (from mark@localhost) by marder-1. (8.9.3/8.8.8) id VAA01504; Sat, 16 Oct 1999 21:53:02 +0100 (BST) (envelope-from mark) Date: Sat, 16 Oct 1999 21:53:02 +0100 From: Mark Ovens To: Andrew Boothman Cc: FreeBSD-Doc@freebsd.org Subject: Re: Documentation index latest Message-ID: <19991016215302.A320@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 Sat, Oct 16, 1999 at 04:58:06PM +0100, Andrew Boothman wrote: > Furthering this automatically created index of documentation installed by > ports, I've written a tool that looks through the CONTENTS file of a port in > /var/db/pkg/* and has a guess at what files to put in the new DOCS file. > > It's all _very_ rough, and I'm gonna try and improve it a bit more before we > take the idea to -ports. > > The script is available on http://ukug.uk.freebsd.org/~andrew/docindex/docsmaker > > With information about the index itself on > http://ukug.uk.freebsd.org/~andrew/docindex/ > > As ever, all comments/help/flames welcome! > Good job Andrew! One thing I noticed is that ``@allfiles = readdir 'portsdir';'' in docindex.pl seems to list the sub-dirs in creation order, not alphabetical which would be better. I've knocked together the following wrapper script to build +DOCS files for all the ports/packages installed on the system it's running on. I've run it on mine and now I've got and index of all the docs installed by ports/packages :) #! /bin/sh PKG_DIR=/var/db/pkg for FILE in `ls ${PKG_DIR}` do if [ -f "${PKG_DIR}/${FILE}/+CONTENTS" ]; then # echo ${PKG_DIR}/${FILE} ./docsmaker ${PKG_DIR}/${FILE}/+CONTENTS ${PKG_DIR}/${FILE}/+DOCS fi done # This is just for testing/debugging purposes to force # docindex.pl to rebuild the index file touch -t 9901010101 /usr/local/share/doc/index.html ./docindex.pl > --- > 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