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?