Stas Bekman wrote: > Stephen, > >> I downloaded DocSet-0.14 and got the example running. >> See the results here. >> >> http://www.officevision.com/pub/DocSet/example/dst_html >> http://www.officevision.com/pub/DocSet/example/dst_ps >> >> FYI: I had to change the "id" in example/src/config.cfg >> from "docs" to "home" (I assume anything would have worked) >> because the "id" => "docs" was already in use in >> example/src/docs/config.cfg. (It complained about a >> duplicate id when I first ran it.) >> (I don't have a patch file.) > > > Sorry about that. This example wasn't kept in sync with the doc, as i > was mainly concentrating to finish perl.apache.org. I'm going to nuke > this example and replace with a short version of perl.apache.org that > really demonstrates all the features. > >> If I understand how to use this correctly, I need my own >> distribution (perhaps "Devel::Perldocs") in which I >> have my own version of your "example" directory full of files. >> This defines styles, structure of resulting documents, and so forth. >> Devel::Perldocs would be the application component >> which uses [Module::Info and/or Devel::Metadata and/or Modinfo >> to gather the metadata (perhaps by implementing a replacement >> for DocSet::Source::* ?) and then uses DocSet to produce the >> documentation (with custom templates to create the >> desired look). > > > First, the best place to look at the usage is to download: > http://cvs.apache.org/snapshots/modperl-docs/ > > or using the cvs: > http://perl.apache.org/download/docs.html#Download > > it includes the whole DocSet in its ./lib, but this is just to be safe > and the site will always built properly if something goes wrong with > system wide libraries. But otherwise this package sans the lib directory > is all you need. (it creates the pds, src, etc). > > so basically you need to have your distribution prerequisite DocSet.
I've finally released DocSet on CPAN. It includes two full projects under examples to play with. (give it some time to propogate to the CPAN mirrors before you try) __________________________________________________________________ Stas Bekman JAm_pH ------> Just Another mod_perl Hacker http://stason.org/ mod_perl Guide ---> http://perl.apache.org mailto:[EMAIL PROTECTED] http://use.perl.org http://apacheweek.com http://modperlbook.org http://apache.org http://ticketmaster.com
