Branch: refs/heads/blead
  Home:   https://github.com/Perl/perl5
  Commit: bb1192d2e523bf790d192a2003e3bc9d81f9f8da
      
https://github.com/Perl/perl5/commit/bb1192d2e523bf790d192a2003e3bc9d81f9f8da
  Author: Karl Williamson <k...@cpan.org>
  Date:   2024-06-24 (Mon, 24 Jun 2024)

  Changed paths:
    M handy.h
    M toke.c

  Log Message:
  -----------
  perlapi: Combine all forms of lex_stuff into one group

And move one api declaration to be adjacent to its definition

Having one group containing the descriptions of all closely related
functions makes the pod more compact and makes maintenance easier; fixes
only need to be applied in one place.  And it encourages the
documentation authors to compare and contrast the variants, paying
closer attention to the subtle differences between them.

And it is easier for the reader to choose the variant that is best for
their current purpose, rather than hopping around the file, unsure if
the current text is identical to that found elsewhere, or if there is a
subtle nuance (or three).



To unsubscribe from these emails, change your notification settings at 
https://github.com/Perl/perl5/settings/notifications

Reply via email to