[Perl/perl5] 9bdb17: perlapi: Note that some macros are back-compat only

[email protected] (Karl Williamson via perl5-changes)
Newsgroups perl.perl5.changes
Message-ID <Perl/perl5/push/refs/heads/blead/[email protected]>
  Branch: refs/heads/blead
  Home:   https://github.com/Perl/perl5
  Commit: 9bdb17d4ff024d79539c63f352141d3d764fda2b
      https://github.com/Perl/perl5/commit/9bdb17d4ff024d79539c63f352141d3d764fda2b
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M perl.h

  Log Message:
  -----------
  perlapi: Note that some macros are back-compat only


  Commit: 21e75427877c11a6b483f6bcd35f4f54b14047ff
      https://github.com/Perl/perl5/commit/21e75427877c11a6b483f6bcd35f4f54b14047ff
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M autodoc.pl

  Log Message:
  -----------
  autodoc: Add a blank to separate parts of a message


  Commit: 4f5653449542c7a3728811d9681019905a26c054
      https://github.com/Perl/perl5/commit/4f5653449542c7a3728811d9681019905a26c054
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M autodoc.pl

  Log Message:
  -----------
  autodoc: B and D flags are incompatible

Deprecating and preserving backwards compatibility don't make sense


  Commit: e928c169d8e128454ee0400bf8e9976670bc77e2
      https://github.com/Perl/perl5/commit/e928c169d8e128454ee0400bf8e9976670bc77e2
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M cop.h
    M regen/embed.pl
    M t/porting/symbol_visibility.dat

  Log Message:
  -----------
  perlapi: Document G_ARRAY


  Commit: 08b075d235f36920d6bc3dfb12b7a6bfdbc3a507
      https://github.com/Perl/perl5/commit/08b075d235f36920d6bc3dfb12b7a6bfdbc3a507
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M cv.h
    M regen/embed.pl
    M t/porting/symbol_visibility.dat

  Log Message:
  -----------
  perlapi: Document CvHASGV


  Commit: 94d870839ee69c6b96a92bccf242692a38da5b29
      https://github.com/Perl/perl5/commit/94d870839ee69c6b96a92bccf242692a38da5b29
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M gv.h
    M regen/embed.pl
    M t/porting/symbol_visibility.dat

  Log Message:
  -----------
  perlapi: Document GvIN_PAD backcompat macros


  Commit: 199df3e2d663c25018716a1757bda05596f3ba45
      https://github.com/Perl/perl5/commit/199df3e2d663c25018716a1757bda05596f3ba45
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M op.h
    M regen/embed.pl
    M t/porting/symbol_visibility.dat

  Log Message:
  -----------
  perlapi: Document IS_PADGV PADCONST


  Commit: d9bc66ab3964dea9142c8f8e8383e5bf87d1767a
      https://github.com/Perl/perl5/commit/d9bc66ab3964dea9142c8f8e8383e5bf87d1767a
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M gv.h
    M handy.h
    M hv.h
    M op.h
    M regen/embed.pl
    M t/porting/symbol_visibility.dat

  Log Message:
  -----------
  perlapi: Document NULL pointer macros for back-compat


  Commit: 9b975308130b87ed08e916f348da63c726944969
      https://github.com/Perl/perl5/commit/9b975308130b87ed08e916f348da63c726944969
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M handy.h
    M regen/embed.pl
    M t/porting/symbol_visibility.dat

  Log Message:
  -----------
  perlapi: Document NEWSV


  Commit: b3d3fcbe7bc6e20a923565c2a8bceff40199ec09
      https://github.com/Perl/perl5/commit/b3d3fcbe7bc6e20a923565c2a8bceff40199ec09
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M handy.h
    M regen/embed.pl
    M t/porting/symbol_visibility.dat

  Log Message:
  -----------
  perlapi: Document Newx[cz]?


  Commit: fe102eab5bade975b9c966e76ce35db5430789d8
      https://github.com/Perl/perl5/commit/fe102eab5bade975b9c966e76ce35db5430789d8
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M op.h
    M regen/embed.pl
    M t/porting/symbol_visibility.dat

  Log Message:
  -----------
  perlapi: Document cv_ckproto


  Commit: 772a0310b25ab3b75450eef9ef0c542c1e1759d3
      https://github.com/Perl/perl5/commit/772a0310b25ab3b75450eef9ef0c542c1e1759d3
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M op.h
    M regen/embed.pl
    M t/porting/symbol_visibility.dat

  Log Message:
  -----------
  perlapi: Document OP_SIBLING


  Commit: 749aa76198312b706a0f837b393f67fd6d2447a8
      https://github.com/Perl/perl5/commit/749aa76198312b706a0f837b393f67fd6d2447a8
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M pad.h
    M regen/embed.pl
    M t/porting/symbol_visibility.dat

  Log Message:
  -----------
  perlapi: Document SvPAD,PADNAMEt back-compat macros


  Commit: 3aae962f4409a785f2b1890712015a94609fa52b
      https://github.com/Perl/perl5/commit/3aae962f4409a785f2b1890712015a94609fa52b
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M regen/embed.pl
    M sv.h
    M t/porting/symbol_visibility.dat

  Log Message:
  -----------
  perlapi: Document SVf_AMAGIC


  Commit: 3ce2e9af211177f4bca32737f374d842af8e8431
      https://github.com/Perl/perl5/commit/3ce2e9af211177f4bca32737f374d842af8e8431
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M regen/embed.pl
    M sv.h
    M t/porting/symbol_visibility.dat

  Log Message:
  -----------
  perlapi: Document HvAMAGICfoo back-compat macros


  Commit: 82608c6d4f17f48892c1522afff9962a864ccfd9
      https://github.com/Perl/perl5/commit/82608c6d4f17f48892c1522afff9962a864ccfd9
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M regen/embed.pl
    M sv.h
    M t/porting/symbol_visibility.dat

  Log Message:
  -----------
  perlapi: Document SvPADMY_on


  Commit: 9101dec9c6d617ede799f47621d8652f644ef80a
      https://github.com/Perl/perl5/commit/9101dec9c6d617ede799f47621d8652f644ef80a
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M regen/embed.pl
    M sv.h
    M t/porting/symbol_visibility.dat

  Log Message:
  -----------
  perlapi: Document SvCOMPILEDfoo back-compat macros


  Commit: 6c5344ca6b4761deae376fc731ecec49a73d35a0
      https://github.com/Perl/perl5/commit/6c5344ca6b4761deae376fc731ecec49a73d35a0
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M regen/embed.pl
    M sv.h
    M t/porting/symbol_visibility.dat

  Log Message:
  -----------
  perlapi: Document BmFLAGS and kin back-compat macros


  Commit: 9dacd4fa4b4a16009abfb41c355ba260bd6e17ae
      https://github.com/Perl/perl5/commit/9dacd4fa4b4a16009abfb41c355ba260bd6e17ae
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M perl.h
    M pod/perlguts.pod

  Log Message:
  -----------
  perlapi: Document PERL_IMPLICIT_CONTEXT


  Commit: de2838f9b0501db0cbc01931513d2c78b3e40db7
      https://github.com/Perl/perl5/commit/de2838f9b0501db0cbc01931513d2c78b3e40db7
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M perl.h

  Log Message:
  -----------
  perlapi: Document CPERLarg back-compat macros


  Commit: 11ae540ffc515adefed03583c03d70f3ff06915c
      https://github.com/Perl/perl5/commit/11ae540ffc515adefed03583c03d70f3ff06915c
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M perl.h

  Log Message:
  -----------
  perlapi: Document PERL_OBJECT_THIS back-compat macros


  Commit: 3ce165357b45736fc69fad2bb3c9467daf9a7e40
      https://github.com/Perl/perl5/commit/3ce165357b45736fc69fad2bb3c9467daf9a7e40
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M perl.h
    M regen/embed.pl
    M t/porting/symbol_visibility.dat

  Log Message:
  -----------
  perlapi: Document CALL_FPTR,MEMBER_TO_FPTR back-compat macros


  Commit: 9ad37a9be48cadd33e327b937849992e3860352c
      https://github.com/Perl/perl5/commit/9ad37a9be48cadd33e327b937849992e3860352c
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M perl.h
    M regen/embed.pl
    M t/porting/symbol_visibility.dat

  Log Message:
  -----------
  perlapi: Document STATIC,VOL back-compat macros


  Commit: b46db2c9ae3838429ae54cf62c3f71d0997d4088
      https://github.com/Perl/perl5/commit/b46db2c9ae3838429ae54cf62c3f71d0997d4088
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M perl.h
    M regen/embed.pl
    M t/porting/symbol_visibility.dat

  Log Message:
  -----------
  perlapi: Document I_LIMITS,I_STDARG,STANDARD_C back-compat macros


  Commit: 02749af2a1113f6e3d00e37ced555c957fd59ba9
      https://github.com/Perl/perl5/commit/02749af2a1113f6e3d00e37ced555c957fd59ba9
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M perl.h
    M regen/embed.pl
    M t/porting/symbol_visibility.dat

  Log Message:
  -----------
  perlapi: Document CAN_PROTOTYPE


  Commit: 986b1e26ba40914dbc99701f0a1f8ebaad4570d0
      https://github.com/Perl/perl5/commit/986b1e26ba40914dbc99701f0a1f8ebaad4570d0
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M perl.h

  Log Message:
  -----------
  perlapi: Document _(...) back-compat macro


  Commit: 69dd88c788b1d881dae85031663e7605d4a416df
      https://github.com/Perl/perl5/commit/69dd88c788b1d881dae85031663e7605d4a416df
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M perl.h

  Log Message:
  -----------
  perlapi: Document PERL_FS_VER_FMT back-compat macro


  Commit: bda6daace97b1cae93e01b21048d27681da17d14
      https://github.com/Perl/perl5/commit/bda6daace97b1cae93e01b21048d27681da17d14
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M perl.h

  Log Message:
  -----------
  perlapi: Document PL_dirt, PL_encoding, PL_amagic_generation


  Commit: d3718f74f8fa355160feb8da2781c01fd30ac97a
      https://github.com/Perl/perl5/commit/d3718f74f8fa355160feb8da2781c01fd30ac97a
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M cv.h
    M regen/embed.pl
    M t/porting/symbol_visibility.dat

  Log Message:
  -----------
  perlapi: Document CVf_NAMED


  Commit: 0c2dda77922473c10fe7c8dae76edb8048052884
      https://github.com/Perl/perl5/commit/0c2dda77922473c10fe7c8dae76edb8048052884
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M cv.h
    M regen/embed.pl
    M t/porting/symbol_visibility.dat

  Log Message:
  -----------
  perlapi: Document CvNAMED-foo back-compat macros


  Commit: de80c8ecd40c6d5b677847699e5482b44bc748c6
      https://github.com/Perl/perl5/commit/de80c8ecd40c6d5b677847699e5482b44bc748c6
  Author: Karl Williamson <[email protected]>
  Date:   2026-08-13 (Thu, 13 Aug 2026)

  Changed paths:
    M autodoc.pl
    M cop.h
    M cv.h
    M gv.h
    M handy.h
    M hv.h
    M op.h
    M pad.h
    M perl.h
    M pod/perlguts.pod
    M regen/embed.pl
    M sv.h
    M t/porting/symbol_visibility.dat

  Log Message:
  -----------
  Merge branch 'Document back-compats' into blead

This is a series of tiny commits, each of which creates fairly minimal
documentation for elements that are retained only for backwards
compatibility.

Some of these are automatically generated for the ones I knew nothing
about and the intent wasn't immediately obvious.  The automatic boiler
plate for these basically says, don't add them to new code, and if you
know how they're supposed to work, patches welcome.  This provides a
modicum of information, good enough for most modern usage, and doesn't
require us to dig into how things used to work but don't now.


Compare: https://github.com/Perl/perl5/compare/057f28063d49...de80c8ecd40c

To unsubscribe from these emails, change your notification settings at https://github.com/Perl/perl5/settings/notifications
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.