Beefy Boxes and Bandwidth Generously Provided by pair Networks
Perl Monk, Perl Meditation
 
PerlMonks  

Re: VERSION section in POD

by LanX (Saint)
on May 18, 2016 at 15:27 UTC ( [id://1163349]=note: print w/replies, xml ) Need Help??


in reply to VERSION section in POD

I once wrote a little script ("podbuilder") creating a .pod file for my module (and manifest, README and so on) from templates.

( because perldoc <MODULE> will show the content of <MODULE>.pod (if present) instead of <MODULE>.pm )

It also does a parsing of my module's POD for comments which are meant to be part of the interface description including $VERSION

Since the script is part of the test suite and/or commit-hook all files are automatically updated.

So instead of "reversioning" all files I only update the main code's $VERSION. ²

But I have to admit I never really used Pod::Weaver or Dist::Zilla , so I can't tell how many wheels I reinvented, BUT it has no dependencies³.

Cheers Rolf
(addicted to the Perl Programming Language and ☆☆☆☆ :)
Je suis Charlie!

²) which shouldn't be done without running the test-suite anyway

³) which means I can distribute it with my module, without blowing up the dependencies.

Replies are listed 'Best First'.
Re^2: VERSION section in POD
by polettix (Vicar) on May 19, 2016 at 07:31 UTC
    It would be interesting to take a look at it, for inspiration...

    The dependencies observation hits the nail right in the head, as the whole thread started (in my mind at least) from a dependency error I was having in Travis-CI for a corner case. I'm currently using a small templating system to do the job, although it's probably way overkill. I might embed the templating system in the transformation program or... avoid using it.

    perl -ple'$_=reverse' <<<ti.xittelop@oivalf

    Io ho capito... ma tu che hai detto?

Log In?
Username:
Password:

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

How do I use this?Last hourOther CB clients
Other Users?
Others studying the Monastery: (5)
As of 2024-04-18 09:41 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found