Hi,
Working on the FAQs, I found another issue with the POD linking. I think that when linking directly to a document (like by using L<faqs::mod_perl>), the expected behaviour should be to insert the title of the document if another one isn't provided for. This would make linking easier as we wouldn't have to put in the whole title each time (which is subject to change).
That would be making a revolution on how pod is handled :) Not that I'm against this feature. It'd make it much easier to create and maintain the docs. It's a very good idea.
Why stop then at the title of the document (which is almost never used as is), we can do the same for a subsection's title, which is what used most in our documents.
We can just add this to the TODO for DocSet, and take a big TODO-squashing session sometime soon :) Lots to be done!
Sure, I'll add it to the todo list. Though don't expect it turn into code anytime soon, I have planned DocSet to be a helper tool, not a project of my life :) I should put it on CPAN and let people improve on it. I was holding this off, since the namespace needs to be discussed first.
But DocSet needs to solve some other items of higher priority first. Like a better caching mechanism. e.g. currently if you move the order of chapters in config.cfg or remove docs, you must force the rebuild, since it's not smart enough that the cache entries need to be invalidated. I didn't get around rewriting the caching mechanism, yet. patches are as always welcome :)
__________________________________________________________________
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
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
