[DBIx-Class-Devel] Review request topic/populate_doc (unrelated to Brendan's work)

[Brendan Byrd]

On Thu, Dec 13, 2012 at 1:57 PM, Peter Rabbitson <rabbit+dbic at rabbit.us> wrote:
>
> You hold the "pod-style baton" now - so go with whatever you think fits
> best the overall picture.

Bah.  I put out a doc branch or two and suddenly I'm Senior
Documentation Specialist?  OSS FTW.

On Thu, Dec 13, 2012 at 2:17 PM, fREW Schmidt <frioux at gmail.com> wrote:
> I disagree and use \%foo and \@bar all the time.  Additionally []
> apparently means optional in our pod, so how do you make it clear
> what's an arrayref of arrayrefs (as in popuplate) or an optional list
> of arrayrefs?
>
> Note that I think this is stupid and that [] as optional only makes
> sense for commandline help, but I don't care enough to change minds :)

Oh man, I'm already tired of documentation...  No, I don't like the
"optional" thingy, either.  I care enough, but don't quite have the
energy for it today.

Wait, are you sure?  We use ? for optional.

https://metacpan.org/module/BBYRD/DBIx-Class-0.08204_01/lib/DBIx/Class/Manual/Reading.pod

Yeah, I got nothing for [].  It's ?.

-- 
Brendan Byrd <Perl at ResonatorSoft.org>
Brendan Byrd <BBYRD at CPAN.org>