Sure I'd be happy to work on it. Though the only difficult thing about it is getting all the html documentation uniformly placed I think it can be done very simply. What I think would be great is if every package had a index.html file in /sw/share/doc/$PACKAGENAME which would either say the html docs hadn't been created yet, or pointed or was symlinked to docs in /sw/share/doc/$PACKAGENAME/html/
The following can be done now. This example assume the Apache included with OS X and fink in the usual place.. Edit /etc/httpd/httpd.conf and Put something like this in Alias /finkdoc /sw/share/doc <Directory /sw/share/doc> order allow,deny allow from all #or if you want to keep it on a local vpn or somesuch #allow from 192.168.1.0/24 #deny from all #hopefully my rather mid level older iMac won't get swamped with #people trying to read fink docs Options Indexes FollowSymLinks </Directory> This makes my it so I can type in http://www.ssimr.com/finkdoc and look at the doc directory. This is enough to get to the html docs in two or three clicks. The downside is that many packages don't have html documentation. Though most browser can also read the text files. I could write a perl script to create a web page that just included the html docs. Though I think simply asking that all packages have an index.html in /sw/share/doc/$PACKAGENAME would work. This isn't to say a lot more couldn't be done -- thorough indexing and crossreferencing, etc. Obviously in the ideal world everything would be done in SGML and the install scripts would generate all the extremely comprehensive and accurate docs in man, texinfo, and html format (maybe even some pdf and/or ps books) in the right place. On Sat, Mar 02, 2002 at 12:13:45PM -0500, David R. Morrison wrote: > Josh Kuperman wrote: > > > When I install fink packages, the documentation gets [snip] > > > > Would it be possible to make it standarder? I am running the default > > Apache that comes with OSX, though I'm sure some are using the one > > that comes with fink. I would like to make it so that I could - at [snip] > I think this is a great idea for an enhancement to fink. Would you (or > someone else) like to work on implementing it? Here's how it could go: > > You make a new fink package which sets up /sw/share/finkdocs and has > some magic index.php file (or some other Web back of tricks) whose > function is to display a page containing all links specified within > other files in the directory that have some magic format. Then you > ask fink developers to include an appropriately formatted file > /sw/share/finkdocs/package.php in each of their packages which points to > the starting point of the html documentation fpr that package. > > Your new package will probably have to make a symbolic link from within > someplace like /Library/Web (I forget exactly where this goes) to > /sw/share/finkdocs, which is normally not allowed, but in my opinion an > exception would be warranted for a feature like this. > > -- Dave -- Josh Kuperman [EMAIL PROTECTED] _______________________________________________ Fink-users mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/fink-users
