×
INTELLIGENT WORK FORUMS
FOR COMPUTER PROFESSIONALS

Log In

Come Join Us!

Are you a
Computer / IT professional?
Join Tek-Tips Forums!
  • Talk With Other Members
  • Be Notified Of Responses
    To Your Posts
  • Keyword Search
  • One-Click Access To Your
    Favorite Forums
  • Automated Signatures
    On Your Posts
  • Best Of All, It's Free!
  • Students Click Here

*Tek-Tips's functionality depends on members receiving e-mail. By joining you are opting in to receive e-mail.

Posting Guidelines

Promoting, selling, recruiting, coursework and thesis posting is forbidden.

Students Click Here

Jobs

Viewing POD Files

Viewing POD Files

Viewing POD Files

(OP)
Hi,

Can someone recommend a decent POD file viewer, I'm trying to create a POD document for the Catalyst Advent but I seem unable to check it.

If I use perldoc, none of the headings show, the formatting is awful and doesn't show like CPAN does.

How can I view a POD document with the correct formatting such as headings (=head1 My Title), like it displays on CPAN?

Thanks.
1DMF

"In complete darkness we are all the same, it is only our knowledge and wisdom that separates us, don't let your eyes deceive you."

"If a shortcut was meant to be easy, it wouldn't be a shortcut, it would be the way!"
Free Electronic Dance Music

RE: Viewing POD Files

Hi

Not sure what is your actual goal. Maybe one of these :
  • PAGER='less -R' perldoc file.pod - As perldoc formats with ANSI escape sequences, you have to tell that to the pager too. ( Supposing your pager is less. )
  • pod2html file.pod | lynx -stdin - This is closer to what you see on CPAN, but not sure how much it helps you.

Feherke.
feherke.github.io

RE: Viewing POD Files

(OP)
Hi feherke,

Quote:

Not sure what is your actual goal.
I've been asked by the Catalyst community to put together a POD for their Advent, I simply wanted to view it as I put it together to see how it will be displayed, so I get a feel for the formatting it will eventually look like.

I have found that I had an error (forgot to close a list item with =back) using podchecker, so at least I can now see my actual heading, but it's still basic when simply viewed using perldoc in a bash shell.

Though I have now found this : http://search.cpan.org/~davidrw/Pod-Advent-0.24/

Which hopefully will give me a 'Perl Advent' type view, if not I'll give pod2html a go.

Regards,
1DMF



"In complete darkness we are all the same, it is only our knowledge and wisdom that separates us, don't let your eyes deceive you."

"If a shortcut was meant to be easy, it wouldn't be a shortcut, it would be the way!"
Free Electronic Dance Music

Red Flag This Post

Please let us know here why this post is inappropriate. Reasons such as off-topic, duplicates, flames, illegal, vulgar, or students posting their homework.

Red Flag Submitted

Thank you for helping keep Tek-Tips Forums free from inappropriate posts.
The Tek-Tips staff will check this out and take appropriate action.

Reply To This Thread

Posting in the Tek-Tips forums is a member-only feature.

Click Here to join Tek-Tips and talk with other members! Already a Member? Login

Close Box

Join Tek-Tips® Today!

Join your peers on the Internet's largest technical computer professional community.
It's easy to join and it's free.

Here's Why Members Love Tek-Tips Forums:

Register now while it's still free!

Already a member? Close this window and log in.

Join Us             Close