From owner-freebsd-doc Sat Sep 18 1:42:51 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nau.antar.bryansk.ru (ns2.bryansk.ru [195.239.214.80]) by hub.freebsd.org (Postfix) with ESMTP id C7ABE14D7E; Sat, 18 Sep 1999 01:42:44 -0700 (PDT) (envelope-from bitmcn!alex@kapran.bitmcnit.bryansk.su) Received: from bitmcn (uucp@localhost) by nau.antar.bryansk.ru (8.9.1a/8.9.1) with UUCP id MAA21559; Sat, 18 Sep 1999 12:53:09 +0400 (MSD) Received: (from uucp@localhost) by server.bitmcnit.bryansk.su (8.8.8/8.8.7) with UUCP id KAA16655; Sat, 18 Sep 1999 10:39:13 +0400 Received: (from alex@localhost) by kapran.bitmcnit.bryansk.su (8.9.1/8.8.8) id OAA01405; Fri, 17 Sep 1999 14:01:19 +0400 (MSD) (envelope-from alex) Date: Fri, 17 Sep 1999 14:01:19 +0400 (MSD) From: Alex Kapranoff Message-Id: <199909171001.OAA01405@kapran.bitmcnit.bryansk.su> To: Nik Clayton Cc: freebsd-doc@FreeBSD.ORG, freebsd-ports@FreeBSD.ORG Subject: Re: Building a page of installed software docs In-Reply-To: <19990915231305.A31588@kilt.nothing-going-on.org> Organization: BGTU User-Agent: tin/pre-1.4-19990413 ("Endemoniada") (UNIX) (FreeBSD/3.0-RELEASE (i386)) MIME-Version: 1.0 Content-Type: text/plain; charset=koi8-r Content-Transfer-Encoding: 8bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org In article <19990915231305.A31588@kilt.nothing-going-on.org> you wrote: > > Does anyone else think it would be useful if 'the system' could > automatically maintain an index page on behalf of the user (say, > /usr/local/share/doc/index.html). This file wouldn't be part of any one Just like the /usr/share/info/dir file. Those programs which use info as there documentation format add their entries to this file so that when I run just "info" it shows me the index of all intalled docs in appropriate format. > port, but it would include links to all the HTML manuals that have been > installed so far -- it could also include links to the HTML documentation > that's been installed from the FDP. > > Some as yet unwritten program could sit in /usr/local/etc/rc.d and rebuild > this file automatically at boot time, or perhaps make it a part of > /etc/periodic/daily*, or something like that? So that the user can just Lots of problems with figuring out where are the docs for a particular program, what's the display name and so far. > I think this is probably a good idea, but I'm not sure as to the best way to > implement it. This hypothetical rebuild-index.html-from-scratch script > needs to know which files form the 'root' of the documentation for a > particular package. Unfortunately, you can't just say "Anything that's > called 'index.html'", as not all apps follow this convention. For example, > bzip2's manual root is called manual_toc.html, tidy's root is Overview.html, > and so on. Yes, that's the problem. > > I thought about suggesting an additional Makefile variable, that could list > the name of the installed root file -- that fails for things that aren't > built from the ports tree, such as doc/*, so that's probably out. What do you mean? Why not a variable for a port, one for an item from doc and so on? BTW, variables are too limited so your suggestion with pkg/ONE_MORE_FILE is better, to my simple mind. -- Alex Kapranoff, Voice: +7(0832)791845, <--- !!!! Сменился телефон !!!! To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message