From owner-freebsd-ports  Fri Jan 10 07:46:52 1997
Return-Path: <owner-ports>
Received: (from root@localhost)
          by freefall.freebsd.org (8.8.4/8.8.4) id HAA16515
          for ports-outgoing; Fri, 10 Jan 1997 07:46:52 -0800 (PST)
Received: from cabri.obs-besancon.fr (cabri.obs-besancon.fr [193.52.184.3])
          by freefall.freebsd.org (8.8.4/8.8.4) with SMTP id HAA16508
          for <ports@freebsd.org>; Fri, 10 Jan 1997 07:46:40 -0800 (PST)
Received: by cabri.obs-besancon.fr (5.57/Ultrix3.0-C)
	id AA05998; Fri, 10 Jan 97 16:49:42 +0100
Date: Fri, 10 Jan 97 16:49:42 +0100
Message-Id: <9701101549.AA05998@cabri.obs-besancon.fr>
From: Jean-Marc Zucconi <jmz@cabri.obs-besancon.fr>
To: ports@freebsd.org
In-Reply-To: <199701100646.WAA07104@paris.CS.Berkeley.EDU> (message from Josh
	MacDonald on Thu, 09 Jan 1997 22:46:13 -0800)
Subject: html files [Re: texinfo changes ready]
X-Mailer: Emacs
Sender: owner-ports@freebsd.org
X-Loop: FreeBSD.org
Precedence: bulk

[taken fromn the -hackers list]

>>>>> Josh MacDonald writes:


 > That's the complete set of changes to the texinfo installation.
 > Now comes the set of changes that replaces the old method of 
 > installing the /usr/share/info/dir file.

 > 5. Modify share/mk/bsd.info.mk so that the building of info files
 >    uses install-info to add each file to the dir file.  No pre-built
 >    dir file is located anywhere in the source tree, only an empty
 >    template share/info/dir-tmpl which is copied to share/info/dir when
 >    building begins.

 > 6. Now info files in the source tree which are already annotated with
 >    the information required by install-info will install themselves
 >    correctly into share/info/dir the rest of the files (most of them)
 >    will require additional modifications to their respective Makefiles.

 > 7. For info files in package P not containing the annotations, the 
 >    Makefile previously reading.

 > INFO=  foo bar

 > Is modified to read:

 > INFOSECTION= "P Documentation"
 > INFOENTRY_foo= "* foo: (foo).		Documentation for the `foo' command."
 > INFOENTRY_bar= "* bar: (bar).		Documentation for the `bar' command."

 > The Makefile is otherwise unmodified.  After building, the dir
 > file will contain:

 > P Documentation
 > * foo: (foo).			Documentaiton for the `foo' command.
 > * bar: (bar).			Documentation for the `bar' command.

 > The directory share/info is given an install rule to install the dir
 > file.  

I think we could do something similar for the ports installing their
own html documentation. The html documentation is currently installed
in more or less random locations and is not always apparent.  What
about forcing the ports to install their html files in
/usr/local/share/html/PACKAGENAME/* and use a small utility to
maintain /usr/local/share/html/INDEX.html? 

Jean-Marc
 _____________________________________________________________________________
 Jean-Marc Zucconi       Observatoire de Besancon       F 25010 Besancon cedex
                   PGP Key: finger jmz@cabri.obs-besancon.fr
 =============================================================================