byterock

Small problem solving day here in the Dist-Pen.

Just a quick post-ette today to resolve the problem I was having in my last post, where I was trying to get [PodWeaver] to work with 'Pod::Elemental::Transformer'.

I was trying to get this;

=head1 Table Of Contents

=for :list

* Database::Accessor::Tutorial::GettingStarted

* Database::Accessor::Tutorial::Basics

=cut 

to work for my POD but it just did not want to play ball with me. I know this should work as I have seen it used in all sorts of other places and in the two tutorials I ran across.

I soon was looking on the MetaCPAN for 'weaver.ini' files so I could at least see where some-one else was using it. Now I did find a few and after having a look at a POD that was using a list I think went back to the modules source to see how they where using ''Pod::Elemental::Transformer::List“. After a few iteration though differing CPAN source re-pos and trying a number of things I finally stumbled upon it.

It seems that Weaver likes a space between commands. So a change to this

=head1 Table Of Contents

++

=for :list

…

and another clean and build with dzil I got

=head1 Table Of Contents


=over 4

=item *

Database::Accessor::Tutorial::GettingStarted

=item *

Database::Accessor::Tutorial::Basics

=back

So I will have to keep that in mind the further I go along with this.

Well it did save me some tying no more 'over~back' errors in pod if I use this.

The only sticky bit for me today was I did not like the line break after the '=item *'. One little trick I use now to see what my POD looks like is to upload it to git-hub and have a look at it. I did this with a little test and It looked fine to me.

So onto other things.