Re^3: Perl Module Documentation

Sorry; I thought you were gratuitously "bustin' my chops;" I see differently now and apologize for the deficiencies in my reply. They were numerous.

The options I mentioned allow you to selectively produce a plain text file (formatted with spaces and newlines) of the relevant doc (and pod, TBOMK) using a CLI command like this (under Win):

F:\pl_docs>perldoc -d nextpod.out -T -o f next
Perldoc (Pod::Perldoc::ToText) output saved to nextpod.out
[download]

The -d argument is the outfile name; -T says "don't page" and -o can specify a format, but is not something I've played with seriously. (Note, NO hyphen before the "f" preceding the function name. I have no clue why it works that way.)

From there, wrap the output in minimal html,

html
<head>
<title> <!-- (module or function title) --> </title>
</head>
<body>
<pre>
<!-- (content of your output from above, verbatim) -->
</pre>
</body>
</html>
[download]

However, automating the above in a script may be more work than I've considered. Making the .html 'semantic' would certainly be more work.

So, in all honesty (/me flushes with pseudo-embarassment and pride at his self-congratulatory caveat), RichardK's pointer to Pod::Webserver now seems likely to be a far better way to do the job, unless it's bug-ridden. And in further honesty, you're right about needing to be obvious -- I just thought it would be to a Monk as experienced and wise (if sometimes, a tad sharp with others) as you. But since the post will stand for others, apologies, also, for failing to follow that guidance.

But, afterthought, would you please stick <c>readmore<c>s in there somewhere?

Comment on Re^3: Perl Module Documentation Select or Download Code

Replies are listed 'Best First'.
Re^4: Perl Module Documentation by BrowserUk (Patriarch) on Dec 20, 2011 at 21:03 UTC
But, afterthought, would you please stick `readmore`s in there somewhere? As all the long stuff is wrapped in `<spoiler>` tags, you should not be seeing any of it unless you explicitly click one of the links in: `<Reveal this spoiler or all spoilers in this node or all in this thread>`. Whereas, if I had used `<readmore>`'s, everyone would have to suffer it all as soon as they opened the post. With the rise and rise of 'Social' network sites: 'Computers are making people easier to use everyday' Examine what is said, not who speaks -- Silence betokens consent -- Love the truth but pardon error. "Science is about questioning the status quo. Questioning authority". In the absence of evidence, opinion is indistinguishable from prejudice. The start of some sanity?	[reply] [d/l] [select]

Replies are listed 'Best First'.

Re^4: Perl Module Documentation
by BrowserUk (Patriarch) on Dec 20, 2011 at 21:03 UTC

But, afterthought, would you please stick readmores in there somewhere?

As all the long stuff is wrapped in <spoiler> tags, you should not be seeing any of it unless you explicitly click one of the links in: <Reveal this spoiler or all spoilers in this node or all in this thread>.

Whereas, if I had used <readmore>'s, everyone would have to suffer it all as soon as they opened the post.

With the rise and rise of 'Social' network sites: 'Computers are making people easier to use everyday'

Examine what is said, not who speaks -- Silence betokens consent -- Love the truth but pardon error.

"Science is about questioning the status quo. Questioning authority".

In the absence of evidence, opinion is indistinguishable from prejudice.

The start of some sanity?

[reply]
[d/l]
[select]