[Perl/perl5] 643108: perlfunc/stat: fix description of S_ENFMT and S_IFMT
Branch: refs/heads/blead Home: https://github.com/Perl/perl5 Commit: 643108fc9c03734b07078581bf534a62c1d2e597 https://github.com/Perl/perl5/commit/643108fc9c03734b07078581bf534a62c1d2e597 Author: Lukas Mai Date: 2024-05-17 (Fri, 17 May 2024) Changed paths: M pod/perlfunc.pod Log Message: --- perlfunc/stat: fix description of S_ENFMT and S_IFMT S_ENFMT properly belongs to the group of permission bits (like setuid/setgid), not file types. On systems that have it (like AIX), it can be set/cleared with chmod(). (In fact, it usually shares its value with S_ISGID because enforced locking is signaled by the combination of a non-executable file with the setgid bit set.) S_IFMT($mode) directly gives you one of the file types (S_IFREG, S_IFDIR, etc). You don't need to bit-and it further (especially not with the S_IS* functions), contrary to what the comment claims. (The confusion likely stems from the C side of things, where you'd do `mode & S_IFMT` to extract the file type from the mode bits, leading to code like `(mode & S_IFMT) == S_IFDIR`. But even then you could write `S_ISDIR(mode)` without any bit mask trickery.) Most of the symbols in the "S_IF* constants" section don't start with "S_IF", so change to "S_I* constants" everywhere. Most of the symbols in the "S_IF* functions" section don't start with "S_IF" (with the sole exception of S_IFMT, which is only a function in Perl; the C macro is a constant). (Historical note: This section label used to make more sense because it documented S_IFMODE and S_IFMT functions, but the former was just a typo for S_IMODE.) To unsubscribe from these emails, change your notification settings at https://github.com/Perl/perl5/settings/notifications
[Perl/perl5] 2fc32c: `perlbook.pod`: Fix few leftovers
Branch: refs/heads/blead Home: https://github.com/Perl/perl5 Commit: 2fc32c2024a28634f5bb168cc671dcf18056620b https://github.com/Perl/perl5/commit/2fc32c2024a28634f5bb168cc671dcf18056620b Author: Elvin Aslanov Date: 2024-05-17 (Fri, 17 May 2024) Changed paths: M pod/perlbook.pod Log Message: --- `perlbook.pod`: Fix few leftovers The "Safari" reference redirects to oreilly.com anyway. It is also renamed: https://en.wikipedia.org/wiki/O%27Reilly_Media#O'Reilly_Online_Learning_(formerly_Safari_Books_Online) To unsubscribe from these emails, change your notification settings at https://github.com/Perl/perl5/settings/notifications
[Perl/perl5] 430d36: perlsub: correct confusing references to local in...
Branch: refs/heads/blead Home: https://github.com/Perl/perl5 Commit: 430d3646c598b6c3cfdf523cdccace5c8ec82c37 https://github.com/Perl/perl5/commit/430d3646c598b6c3cfdf523cdccace5c8ec82c37 Author: Dan Book Date: 2024-05-17 (Fri, 17 May 2024) Changed paths: M pod/perlsub.pod Log Message: --- perlsub: correct confusing references to local in my docs The docs for lexical variable declarations referenced 'local' as a mechanism to declare global variables in a couple instances, which is incorrect. 'local' only localizes global variables, it doesn't create or declare them in the common case where strict 'vars' is in effect. To unsubscribe from these emails, change your notification settings at https://github.com/Perl/perl5/settings/notifications
[Perl/perl5] e9d23e: perldelta: add PERL_RC_STACK
Branch: refs/heads/davem/rc_delta Home: https://github.com/Perl/perl5 Commit: e9d23e8f7a66819aeaf3d526937beb5610da5f2d https://github.com/Perl/perl5/commit/e9d23e8f7a66819aeaf3d526937beb5610da5f2d Author: David Mitchell Date: 2024-05-17 (Fri, 17 May 2024) Changed paths: M pod/perldelta.pod Log Message: --- perldelta: add PERL_RC_STACK This is a final summary of the state of the new ref-counted stack facility at the 5.40.0 release: and is intended to be added to the 5.40.0 perldelta, to replace (rather than than be in addition to) any earlier mentions of PERL_RC_STACK in the 5.39.2 and .6 perldeltas. To unsubscribe from these emails, change your notification settings at https://github.com/Perl/perl5/settings/notifications