Beefy Boxes and Bandwidth Generously Provided by pair Networks
Clear questions and runnable code
get the best and fastest answer
 
PerlMonks  

Re: Re: Pod::Master

by PodMaster (Abbot)
on Nov 07, 2002 at 17:45 UTC ( #211153=note: print w/ replies, xml ) Need Help??


in reply to Re: Pod::Master
in thread Pod::Master

Thanks!.

Oh yeah, I switched SYNOPSIS/DESCRIPTION, d'oh ;)

And the 2nd d'oh, I generated that page by hand , without the --header option, here's what it really looks like by default (d'oh).

Now, I am not subclassing Pod::Html, so whatever Pod::Html does, it does on its own (i myself like the toc)

What does Will this be handled in a generic POD way, or will it take advantage of that nifty INSTALLED MODULES format? mean?

What is a "generic POD way"? And how would I take advantage of "that nifty INSTALLED MODULES format?"

I kind of think DEPENDENCIES belong in the README/Makefile.PL, so that's why I didn't put it in the pod.

I'm pretty satisfied with Pod::Html and I don't plan on re-inventing it any time soon (i'm satisfied in writing patches ;)

____________________________________________________
** The Third rule of perl club is a statement of fact: pod is sexy.


Comment on Re: Re: Pod::Master
Replies are listed 'Best First'.
Re: Re: Re: Pod::Master
by mojotoad (Monsignor) on Nov 07, 2002 at 18:00 UTC
    Don't get me wrong, I like the TOC as well -- it was just an issue of visually locating the name of the module immediately.

    By generic POD I just meant normal =head1 plus either items or a comma-separated list of dependencies. It wasn't really a clearly thought-out question, but it seemed you had more going on with the code that generated the INSTALLED MODULES than merely POD parsing. I guess I'm secretly desiring some tool, other than perl -c, that will recursively trace dependencies and present them in an outline format.

    You are right that lots of modules do indeed put the dependencies in README/Makefile.PL (as well as perhaps POD). A dependency-sniffer would no doubt get tripped up on optional dynamic dependencies as well. :(

    Matt

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://211153]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others contemplating the Monastery: (10)
As of 2015-07-31 08:09 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    The top three priorities of my open tasks are (in descending order of likelihood to be worked on) ...









    Results (275 votes), past polls