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)
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.


Trivial merge