This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Improve wrapping of arguments in perlintern.pod
authorFather Chrysostomos <sprout@cpan.org>
Sat, 16 Jul 2011 19:45:04 +0000 (12:45 -0700)
committerFather Chrysostomos <sprout@cpan.org>
Sat, 16 Jul 2011 19:45:04 +0000 (12:45 -0700)
commit06e9ce89328d9d04b2dd5693134f0ff0a14dec11
treee8eb18bdbb01fa44002f18b890fad662433efcc0
parent9e103e2695edf4f2a3c0c3d8a12299ebcd30e37a
Improve wrapping of arguments in perlintern.pod

Commit dee6204dc made a huge improvement to the formatting of argument
lists in perlapi (except for one pesky little entry, namely caller_cx,
that is 81 columns).

But I forgot to look through perlintern.

This just looks comical:

                       struct refcounted_he * refcounted_he_new_pv(struct refcounted_he *parent,
                                                                   const char *key,
                                                                   U32 hash,
                                                                   SV *value,
                                                                   U32 flags)

On an eighty-column terminal that wraps like this:

                       struct refcounted_he * refcounted_he_new_pv(struct refcoun
ted_he *parent,
                                                                   const char *k
ey,
                                                                   U32 hash,
                                                                   SV *value,
                                                                   U32 flags)

Ugh!!

So, for entries with individual arguments that don’t fit, this commit
wraps them like this:

                       struct refcounted_he * refcounted_he_new_pv(
                                                  struct refcounted_he *parent,
                                                  const char *key, U32 hash,
                                                  SV *value, U32 flags
                                              )
autodoc.pl
t/porting/known_pod_issues.dat