In perl.git, the branch smoke-me/khw-simple has been created
<https://perl5.git.perl.org/perl.git/commitdiff/605eb671bcf5a192b40e31c645831008ef8f842e?hp=0000000000000000000000000000000000000000>
at 605eb671bcf5a192b40e31c645831008ef8f842e (commit)
- Log -----------------------------------------------------------------
commit 605eb671bcf5a192b40e31c645831008ef8f842e
Author: Karl Williamson <[email protected]>
Date: Thu May 30 16:11:16 2019 -0600
f
commit 1446e8fc208440236c92634af45e0b486818825c
Author: Karl Williamson <[email protected]>
Date: Wed May 29 21:37:06 2019 -0600
merged
commit ff7ebf48b1792866db847884835f7a15ff6b3379
Author: Karl Williamson <[email protected]>
Date: Wed May 29 19:11:04 2019 -0600
perlguts: Remove documentation about embed.fnc flags
embed.fnc now has sufficient comments within it. Anyone changing that
file will see those comments first. Having them redundantly explained
here adds little value, and is out-of-date. So just remove them, with a
ptr to embed.fnc
commit d924b89c81fbdff61d9d0a6ecca73b23d0796a83
Author: Karl Williamson <[email protected]>
Date: Wed May 29 19:10:19 2019 -0600
embed.fnc: Add more extensive comments
This revises the comments significantly to better inform the reader.
commit 491a27975d11ecdc9d3a26c353642ff54bb6f858
Author: Karl Williamson <[email protected]>
Date: Wed May 29 18:33:25 2019 -0600
Remove redundant info on =for apidoc lines
This information is already in embed.fnc, and we know it compiles. Some
of this information is now out-of-date. Get rid of it.
There was one bit of information that was (apparently) wrong in
embed.fnc. The apidoc line asked that there be no usage example
generated for newXS. I added that flag to the embed.fnc entry.
commit 52894317654917b74ca6c4b88c116cdcae087b46
Author: Karl Williamson <[email protected]>
Date: Wed May 29 16:06:51 2019 -0600
autodoc.pl: Use embed.fnc entry when available
Having two different pod definitions for the same function leads to
things being out of sync. This commit ignores the one in the '=for
apidoc' line if there is one in embed.fnc.
Doing so led to a bunch of changes in perlapi, showing that the apidoc
lines were inaccurate. The ones in embed.fnc must be accurate enough to
get perl to compile.
I added a warning for when there's a redundant entry, and in the next
commit I will remove the many such.
commit f2e4e2d60d0c949112503f3b2bf02b014f3abcac
Author: Karl Williamson <[email protected]>
Date: Wed May 29 16:01:34 2019 -0600
autodoc.pl: Add N flag
This adds a check that the macro or function name for the pod entry is a
legitimate name, as almost all are. If this had been in effect, the bug
fixed by the previous commit would not have been necessary.
But there are a very few things that are documented that aren't strict
names. This adds a flag so that autodoc can be notified to not warn on
them. This will allow Devel::PPPort to not have to special case
situations like this, which it now does.
commit dd90616e260bb79bff1f971464c4ce2a7364e3ba
Author: Karl Williamson <[email protected]>
Date: Wed May 29 15:58:20 2019 -0600
autodoc.pl: Check for misuse of the 'n' flag
This flag indicates that the macro has no arguments. It makes no sense
to use in some situations, which are now checked for.
This commit also documents the long existing 'n' flag.
commit ce074818ae38bc4fc825ebbc24c29b7ef2a91b93
Author: Karl Williamson <[email protected]>
Date: Wed May 29 15:50:45 2019 -0600
autodoc.pl: Make 's' flag independent of 'n'
The 's' flag is used by autodoc.pl to add a semi-colon to the end of a
usage example. This commit allows that to happen even if the macro has
parameters.
This allows two macros in scope.c to be properly documented. Previously
they weren't, and caused warnings in Devel::PPPort as a result.
This commit adds documentation to embed.fnc for the 's' flag, which has
long existed, undocumented.
commit 77b3d18bdb45d8e4e3a019a881bdbbf13deaeceb
Author: Karl Williamson <[email protected]>
Date: Wed May 29 15:41:23 2019 -0600
autodoc.pl: Notice the no-thread context flag
I realized reading the code that it would be possible for a function
definition to be wrongly output if it isn't called with a thread context
variable. The information for that is already in embed.fnc, and so we
just have to use it to avoid printing the variable if not present
commit d237c609c007f3be5450859a55406414578a17c5
Author: Karl Williamson <[email protected]>
Date: Wed May 29 15:28:44 2019 -0600
embed.fnc: Add flag for bypass macro existence
Sometimes a function is reduced to be a wrapper, and we want for code to
directly call the underlying one, but we retain the old 'Perl_foo'
function to avoid breaking code that used that form. I've tried various
kludges around that, but this seems more promising.
commit 610dc11141f4ddd98336cf2f862f54959033a3cf
Author: Karl Williamson <[email protected]>
Date: Wed May 29 15:05:05 2019 -0600
autodoc.pl: Use O flag from embed.fnc for warning
This is for ancient 'perl_' forms of function calls, which is
deprecated. It turns out that there were a couple of entries that were
getting this warning when that form doesn't even exist.
commit 2e76da0f4c3c1510ef34bcff3eb4b5a07fab3f57
Author: Karl Williamson <[email protected]>
Date: Wed May 29 14:49:57 2019 -0600
Let embed.fnc define the my_str_foo() fcns
We don't always define a Perl_ form for these, expecting all calls to be
made through the macro, which will use the native form on the systems
that have one.
Removing these extra #defines helps future commits
commit de75ab99b8cc61b33b0d4bceead248ba368fad70
Author: Karl Williamson <[email protected]>
Date: Wed May 29 10:14:55 2019 -0600
embed.fnc: Change M flag to x
The M flag in embed.fnc and the x flag in the '=for apidoc' lines both
mean the same, thing, the entity may change, it is experimental.
Devel::PPPort combines both these things, and expects things to be
consistent.
This commit changes the 'M' in embed.fnc to be 'x'. Changing embed.fnc
and makedef.pl keeps the changes more contained, and lessens the chance
that some module will be adversely affected (I didn't see anything
likely in grepping cpan).
commit afabcd417aaf86a5ffa024e974c8ef318a8e6d83
Author: Karl Williamson <[email protected]>
Date: Tue May 28 22:02:57 2019 -0600
embed.fnc: Change x flag to e
autodoc.pl has the x flag in the '=for apidoc' lines mean something
completely different, but Devel::PPPort combines both these lines and
the contents of embed.fnc into one file, expecting the flags to be
consistent.
This commit changes the 'e' in embed.fnc to be 'e', which means to not
export this function. Changing embed.fnc and makedef.pl keeps the
changes more contained, and lessens the chance that some module will be
adversely affected (I didn't see anything likely in grepping cpan).
commit fb16628482069cc3b569741bf4174b9fc3503bed
Author: Karl Williamson <[email protected]>
Date: Tue May 28 20:28:07 2019 -0600
embed.fnc: Change s flag to S
autodoc.pl has the s flag in the '=for apidoc' lines mean something
completely different, but Devel::PPPort combines both these lines and
the contents of embed.fnc into one file, expecting the flags to be
consistent.
This commit changes the 's' in embed.fnc to be 'S', which means the
function is static and has an 'S_' prefix. Changing embed.fnc keeps the
changes more contained, and lessens the chance that some module will be
adversely affected (I didn't see anything likely in grepping cpan).
commit 6c29b578f3f391605f6bf8838aad89e9138e0f34
Author: Karl Williamson <[email protected]>
Date: Tue May 28 20:52:07 2019 -0600
croak_memory_wrap is an inline function.
Update embed.fnc to correspond
commit c3c14dacc6a546356ef8ce9d5a288240e3658647
Author: Karl Williamson <[email protected]>
Date: Tue May 28 20:03:58 2019 -0600
embed.fnc: Change n flag to T
autodoc.pl has the n flag in the '=for apidoc' lines mean something
completely different, but Devel::PPPort combines both these lines and
the contents of embed.fnc into one file, expecting the flags to be
consistent.
This commit changes the 'n' in embed.fnc to be 'T', which means no
thread context passed. Changing embed.fnc keeps the changes more
contained, and lessens the chance that some module will be adversely
affected (I didn't see anything likely in grepping cpan).
commit 93f0b80fff511c66eb95815d2d72a6d9ec4de7fc
Author: Karl Williamson <[email protected]>
Date: Tue May 28 12:55:19 2019 -0600
Add 'n' flag to various =for apidoc lines
This indicates to not output the macro with parentheses for parameters.
Currently that doesn't happen anyway, but a future commit will change
things so this is required (so that a bug can be fixed)
commit 5ea4aecdd84691b105f2c2362da03bc8c346f40c
Author: Karl Williamson <[email protected]>
Date: Tue May 28 11:02:42 2019 -0600
autodoc.pl: Strip, lead/trail space from =for apidoc
The components of a =for apidoc entry can have spaces between the '|'
separators. Ignore them.
commit 003ff49f4e2d350e2f5992b9a193df91b2a62015
Author: Karl Williamson <[email protected]>
Date: Tue May 28 10:42:21 2019 -0600
autodoc.pl: White-space only
This indents to correspond with the new block formed by the previous
commit.
commit faf81a45e97235681e2762e7f172fc08c4520faf
Author: Karl Williamson <[email protected]>
Date: Tue May 28 10:35:57 2019 -0600
autodoc.pl: Refactor slightly
This breaks a chain of 'elsif' lines so that they are all now part of an
'else' from the first 'if'. This is in preparation for a later commit.
commit c192710ef5bfd0deeae6a4bdd70ea0287a58da59
Author: Karl Williamson <[email protected]>
Date: Tue May 28 10:21:56 2019 -0600
autodoc.pl: Change name of variable
This makes it clear that the source for the lines being processed is
embed.fnc
commit 1931ac189ef028335fb4236ac6ce81ede54604ff
Author: Karl Williamson <[email protected]>
Date: Mon May 27 12:53:48 2019 -0600
JustPod_corpus.t: Suppress expected warns under harness
commit 9fccbf94b31e296c5133bf378de8b7a832a7ab68
Author: Karl Williamson <[email protected]>
Date: Wed May 22 10:23:50 2019 -0600
Bump VERSION to 3.37
-----------------------------------------------------------------------
--
Perl5 Master Repository
