Date: Wed, 27 Oct 1999 13:00:02 -0700 (PDT) From: Nik Clayton <nik@freebsd.org> To: freebsd-doc@freebsd.org Subject: Re: docs/14165: FDP introduction article Message-ID: <199910272000.NAA57591@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/14165; it has been noted by GNATS. From: Nik Clayton <nik@freebsd.org> To: nbm@rucus.ru.ac.za Cc: FreeBSD-gnats-submit@freebsd.org Subject: Re: docs/14165: FDP introduction article Date: Tue, 26 Oct 1999 21:51:25 +0100 On Wed, Oct 06, 1999 at 02:24:29PM -0000, nbm@rucus.ru.ac.za wrote: > >Synopsis: FDP introduction article <...> > >Description: > > This provides an index of the (English) documentation provided by > the FreeBSD Documentation Project. It installs as > /usr/share/doc/index.en_US.ISO_8859-1.html, and index.html is > symlinked to it, if English is the primary language. <ponder> Assuming for the moment that the effort underway to automatically generate a hyperlinked list of pointers to documentation about ports/packages available on the local machine succeeds (I hope it does), and further assuming that this effort will need to read files in /var/db/pkg (COMMENT and DESCR, to name two) in order to build this list, and knowing that the documentation is now pkg_add'able. . . . . . would we not be better off massaging the package target to automatically pull out the title and/or <abstract> from each document, as text for COMMENT and DESCR files (assuming they didn't already exist). "make install" could be tweaked to do the install, and then put the necessary files in /var/db/pkg (I'm somewhat hazy about how the ports system does this). The docs would then automatically appear on this automatically generated list of links to documentation. The list would also be up to date with respect to the documentation the user had actually installed. Thoughts? N 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?199910272000.NAA57591>