This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Merge branch 'autodoc update' into blead
authorKarl Williamson <khw@cpan.org>
Fri, 4 Sep 2020 22:13:57 +0000 (16:13 -0600)
committerKarl Williamson <khw@cpan.org>
Fri, 4 Sep 2020 22:13:57 +0000 (16:13 -0600)
commitdcde311cf1567131cd3ce74924cd9992edc1e398
tree0710612e544cfb5a245b2738f55344927832a0e4
parentbb05203f441fe4aeac7b5e8a6434bcde115333ca
parent9b983db70e037b6a98bf3404e80eb51d8ba197a6
Merge branch 'autodoc update' into blead

This series of commits updates autodoc to generate a more complete and
improved perlapi/perlintern

A major change is the ability to group multiple items in one entry.  We
have many cases where there are slightly different takes on essentially
the same functionality, such as handling magic or not.  All can be
grouped in the same entry, and only their differences noted.  This make
is easier to add new pod when adding a new variant, and it means a more
concise .pod file, with the user not having to jump from entry A that is
listed as similar to entry B, which in turn may even currently say it is
similar to entry C.

The elements in config.h are now included in perlapi, most in new
sections.

I posted an example of these changes in p5p and got zero comments, so am
pushing as it is now.  It is easy to add new sections and to move items
to different ones than they currently are in.

This commit series doesn't actually do any consolidation of entries;
merely enables the ability to do so.  Patches for doing this will come
over time, and hopefully by multiple members of the community.