On Fri, Jul 9, 2010 at 4:42 PM, Daniel Carrera <[email protected]> wrote: > On Fri, Jul 9, 2010 at 11:15 PM, P Kishor <[email protected]> wrote: >> Why so convoluted? Anyone (you, me, Daniel...), anyone who has >> installed PDL on their own computer already has all the docs installed >> under mandir (wherever that is for PDL). In fact, the docs are there >> in the PDL source package. Also, when PDL is installed, it also >> generates HTML documentation (although, I must confess, I don't know >> where it sticks them). All that is needed is to copy the files to the >> web server. > > First, those HTML docs are precisely what we have on the server right now: > > http://pdl.perl.org/?docs=FAQ&title=Frequently%20Asked%20Questions > > Second, you asked for an analogue of "perldl> help foo". Trust me, > coying the HTML files is not the hard part. Just copying files does > not give you PDL's help function, and it certainly doesn't give you an > HTML-aware version of the help function.
No, no. I understand that. I was referring to using David's perl script (the one that glues together the queries made to the piddlebot in the IRC to the PDL documents) to search through the PDL docs. Yes, it won't be the equivalent of perldl> help, but it could be pretty good. I don't know if David's IRC script actually invokes perldl> in the background. In any case, I think now we have a pretty useful search in the Google search box. That is in itself a great step forward. Many thanks, > > >> Now, all that is left is to glue the search box and the docs directory >> together with your perl script. >> >> Also, with regards to the auto-suggest, the easiest auto-suggest would >> be for the various functions. PDL has a finite number, albeit a lot, >> of functions/methods in its various packages. Even a flat-file db (or >> a DBM) would be able to power a useful auto-suggest. > > > Patches welcome. > > > Daniel. > -- > No trees were killed in the generation of this message. A large number > of electrons were, however, severely inconvenienced. > -- Puneet Kishor http://www.punkish.org Carbon Model http://carbonmodel.org Charter Member, Open Source Geospatial Foundation http://www.osgeo.org Science Commons Fellow, http://sciencecommons.org/about/whoweare/kishor Nelson Institute, UW-Madison http://www.nelson.wisc.edu ----------------------------------------------------------------------- Assertions are politics; backing up assertions with evidence is science ======================================================================= _______________________________________________ Perldl mailing list [email protected] http://mailman.jach.hawaii.edu/mailman/listinfo/perldl
