In perl.git, the branch smoke-me/Pod-Functions has been created
<http://perl5.git.perl.org/perl.git/commitdiff/b91006aa53e552452850789a4eb78108e26efda4?hp=0000000000000000000000000000000000000000>
at b91006aa53e552452850789a4eb78108e26efda4 (commit)
- Log -----------------------------------------------------------------
commit b91006aa53e552452850789a4eb78108e26efda4
Author: Nicholas Clark <[email protected]>
Date: Sun Jan 29 17:21:27 2012 +0000
Change ext/Pod-Functions to generate Functions.pm from a Perl script.
For the first step, simply output the current file in one hit.
M MANIFEST
D ext/Pod-Functions/Functions.pm
A ext/Pod-Functions/Functions_pm.PL
A ext/Pod-Functions/Makefile.PL
commit bfa3bf2088292ce58ef25e77560baa8061819b16
Author: Nicholas Clark <[email protected]>
Date: Sun Jan 29 14:56:01 2012 +0000
Add annotations to perlfunc.pod for Pod::Functions.
In the list for "Perl Functions by Category" each item is annotated with its
type as used internally by Pod::Functions.
In the "Alphabetical Listing of Perl Functions" each function is annotated
with the summary description returned by %Pod::Functions::Flavor.
M pod/perlfunc.pod
commit 19ddc71f3f7998aab869f5436b659d671fee470d
Author: Nicholas Clark <[email protected]>
Date: Sun Jan 29 13:00:41 2012 +0000
Move Pod::Functions from lib/ to ext/
M MANIFEST
M Porting/Maintainers.pl
A ext/Pod-Functions/Functions.pm
A ext/Pod-Functions/t/Functions.t
M lib/.gitignore
D lib/Pod/Functions.pm
D lib/Pod/t/Functions.t
commit 89abda4937da6bcf4a2281b0e8ca67ca1507e7b1
Author: Nicholas Clark <[email protected]>
Date: Sun Jan 29 12:23:31 2012 +0000
Bring the joy of strict and warnings to Functions.t
This reveals that use_ok() was not in a BEGIN block, and in turn that the
test count needs to be declared before this BEGIN block runs. Now fixed.
M lib/Pod/t/Functions.t
commit b40b5c6e432076fb14af3e8a1d08403ba2da9b54
Author: Nicholas Clark <[email protected]>
Date: Sun Jan 29 12:06:05 2012 +0000
Terser code in Pod::Functions to generate $Type_Description and @Type_Order.
M lib/Pod/Functions.pm
commit df0ae854918df3d20243dc3c98651a220003d9ce
Author: Nicholas Clark <[email protected]>
Date: Mon Jan 23 23:38:43 2012 +0100
Teach Pod::Functions that each, keys and values also operate on arrays.
These were added to the section 'Functions for real @ARRAYs' in perlfunc.pod
by commit a5ce339cb0c533c9 in Sep 2010.
As ever, tweak the golden results in the test to match these changes.
M lib/Pod/Functions.pm
M lib/Pod/t/Functions.t
commit c8e823181cd3eec4ed48646869193cea9dc9143a
Author: Nicholas Clark <[email protected]>
Date: Mon Jan 23 23:16:56 2012 +0100
Add all missing functions to Pod::Functions.
evalbytes was added to perlfunc.pod by commit 7289c5e6ca773d7c in Nov 2011.
say was added by commit 0d863452f5cac863 in Dec 2005.
state was added.pod by commit 36fb85f3330d45ee in Jul 2006.
__FILE__, __LINE__ and __PACKAGE__ were added by commit cfa52385fa426b5e in
Aug 2011, and __SUB__ by commit 84ed01088568ffe9 in Nov 2011.
Again, tweak the golden results in the test to match these changes.
M lib/Pod/Functions.pm
M lib/Pod/t/Functions.t
commit 3d33f30e22cbb8cc2315662902793dad6a94f581
Author: Nicholas Clark <[email protected]>
Date: Mon Jan 23 22:44:52 2012 +0100
Teach Pod::Functions about 'Keywords related to the switch feature'.
Commit 0d863452f5cac863 in Dec 2005 added the switch feature, along with
documentation in perlfunc.pod, but did not update Pod::Functions.
Again, tweak the golden results in the test to match these changes.
M lib/Pod/Functions.pm
M lib/Pod/t/Functions.t
commit eca717ecddd54ece6849ff14d70be12960d7ba18
Author: Nicholas Clark <[email protected]>
Date: Mon Jan 23 21:47:16 2012 +0100
Update Pod::Functions with changes from perlfunc.pod
Updated description of Binary from commit 5dac7880bdc47787 in Feb 2011.
Updated description of Flow from commit cf2649810f00335b in Jul 2005, and
added the "the" which has always been missing from Pod::Function's version.
Updated description of Modules from commit 3b10bc60979cfe9a in Jan 2010.
Updated description of Objects from commit 353c650532037e40 in Oct 2007.
The description of Namespaces had always differed from that in perlfunc.pod.
Remove stray tabs from the descriptions of gets and sprintf.
Commit 19799a22062ef658 (May 1999) added lock to perlfunc.pod without a
it is the only function in "Threads", move it to "Misc", instead of creating
a category just for it.
use always had two entries with different descriptions in the __DATA__
section. This isn't actually sensible, as the code that builds the exported
data structures ends up taking Types from both, and using the last
description that it sees. So merge the two together to reflect this.
Drop the CHANGES section from the Pod, which is both incomplete and
redundant, given that version control does this job much better.
Tweak the golden results in the test to match these changes.
M lib/Pod/Functions.pm
M lib/Pod/t/Functions.t
commit ee900e14da1d708caf09adddf2a91fa73d541360
Author: Nicholas Clark <[email protected]>
Date: Mon Jan 23 17:51:48 2012 +0100
In perlfunc.pod, sort the descriptions more consistently.
The order is neither strictly lexical, nor strictly dictionary, but now for
all cases __FOO__ follows foo, and qx// is after qw//.
In the "Regular expressions and pattern matching" summary, put qr// in the
correct position alphabetically.
M pod/perlfunc.pod
commit b0c0bd19b6934a2200c2c26a6cae46ac57ffedae
Author: Nicholas Clark <[email protected]>
Date: Mon Jan 23 17:32:17 2012 +0100
Add 4 functions missing from perlfunc.pod's 'Perl Functions by Category'.
C<readline> added to 'Input and output functions'
Documentation on readline was added by commit 8490252049bf42d3 in Aug 1997.
That commit also added readpipe without adding it to a category group, an
omission that was fixed by commit 4319b00c03e6a517 in Nov 2011.
C<sysseek> added to 'Functions for fixed-length data or records'
Documentation on sysseek was added by commit 137443ea0a858c43 in Apr 1997,
which implemented sysseek.
C<prototype> added to both 'Keywords related to the control flow of your
Perl
program' and 'Miscellaneous functions', as Pod::Functions places it in both.
Commit da0045b73af6f504 in Jul 1996, included 'Add documentation for new
"prototype" operator', but only added the main documentation, not an entry
in a category group.
C<lock> added to 'Miscellaneous functions'.
Documentation on lock was added by commit 19799a22062ef658 in May 1999.
M pod/perlfunc.pod
-----------------------------------------------------------------------
--
Perl5 Master Repository
