From owner-freebsd-doc Thu Sep 7 10: 9:19 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mta06-svc.ntlworld.com (mta06-svc.ntlworld.com [62.253.162.46]) by hub.freebsd.org (Postfix) with ESMTP id A3ED437B423; Thu, 7 Sep 2000 10:09:13 -0700 (PDT) Received: from parish.my.domain ([62.253.89.120]) by mta06-svc.ntlworld.com (InterMail vM.4.01.02.27 201-229-119-110) with ESMTP id <20000907170733.MVLG312.mta06-svc.ntlworld.com@parish.my.domain>; Thu, 7 Sep 2000 18:07:33 +0100 Received: (from mark@localhost) by parish.my.domain (8.9.3/8.9.3) id SAA00752; Thu, 7 Sep 2000 18:07:28 +0100 (BST) (envelope-from mark) Date: Thu, 7 Sep 2000 18:07:27 +0100 From: Mark Ovens To: Nik Clayton Cc: doc@freebsd.org, Andrew Boothman Subject: Re: Ports Documentation Index - the next installment Message-ID: <20000907180727.A255@parish> References: <20000906002540.M254@parish> <20000906101327.A5252@canyon.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit User-Agent: Mutt/1.2.5i In-Reply-To: <20000906101327.A5252@canyon.nothing-going-on.org>; from nik@freebsd.org on Wed, Sep 06, 2000 at 10:13:27AM +0100 Organization: Total lack of Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Sep 06, 2000 at 10:13:27AM +0100, Nik Clayton wrote: > On Wed, Sep 06, 2000 at 12:25:40AM +0100, Mark Ovens wrote: > > I've been doing some work on the perl(1) scripts that Andrew Boothman > > started sometime ago that create /var/db/pkg/${PORTNAME}/+DOCS for > > each installed port and then build an HTML file containing links to > > all the installed docs. > > Great. Looks nice Thanks > > (there's a "but" coming, you can tell. . .) > Isn't there always? > > 4. The filename is displayed instead of "Title Unknown" for > > non-HTML files (although HTML files that have no > > tag are still listed as "Title Unknown"). > > Try using the content of the first element, and falling back to the > filename as a last resort. > Good idea, I'll do it. > For ports with documentation split over multiple files it links to all of > them, instead of just the index file. That's going to be a problem with > any automated solution -- Yes, I'd already spotted that, but can't think of an easy solution. > as and when porters start writing +DOCS files > themselves that should be less of a problem. > should that not be "*if* and when"? ISTR that when Andrew first wrote this we got a rather cool response from the porters > There's another angle I think that's worth investigating. At the O'Reilly > docs summit a couple of months back, representatives from the GNOME, KDE, > and Linux documentation projects were all looking at the similar problem > of getting apps to register their documentation, and also to try and > provide an interface over and above simple HTML. > > >From memory, the two best people to liase with about this are Guyhelm > Aznar and Eric Bischoff . > I'll fire off an e-mail and let you know the outcome. > N > -- > Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. > Telephone line, $24.95 a month. Software, free. USENET transmission, > hundreds if not thousands of dollars. Thinking before posting, priceless. > Somethings in life you can't buy. For everything else, there's MasterCard. > -- Graham Reed, in the Scary Devil Monastery -- 4.4 - The number of the Beastie ________________________________________________________________ 51.44°N FreeBSD - The Power To Serve http://www.freebsd.org 2.057°W My Webpage http://ukug.uk.freebsd.org/~mark mailto:marko@freebsd.org http://www.radan.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message