summaryrefslogtreecommitdiff
path: root/pod/perl.pod
Commit message (Collapse)AuthorAgeFilesLines
* Create a perldelta for 5.14.0Florian Ragwitz2011-03-201-0/+1
|
* Update TOC for perl51310deltaÆvar Arnfjörð Bjarmason2011-02-201-0/+1
| | | | | | | | | | | | | | | | Quoth Porting/perldelta_template.pod: "Run C<perl pod/buildtoc --build-all> to update the F<perldelta> version in the following files: MANIFEST Makefile.SH pod.lst pod/perl.pod vms/descrip_mms.template win32/Makefile win32/makefile.mk win32/pod.mak"
* multifile patch against blead/pod/*.podTom Christiansen2011-02-151-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | I mostly fixed spelling mistakes, some of very long standing, but a few files got more attentive word-smithying. I've updated: pod/perl.pod pod/perldelta.pod pod/perl592delta.pod pod/perl5120delta.pod pod/perl51310delta.pod pod/perl5139delta.pod pod/perlfunc.pod pod/perlop.pod pod/perlrebackslash.pod pod/perlrecharclass.pod pod/perlutil.pod pod/perlhack.pod pod/perlintern.pod pod/perlnetware.pod pod/perlpolicy.pod
* Major revision of perlhack and perlrepositoryDave Rolsky2011-02-041-1/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The existing perlhack is huge and takes a long time to get to key information like "how to submit a patch". It also contains a massive amount of (very useful) detail on the Perl interpreter, debugging, portability issues, and so on. Some parts of perlhack are just obsolete. For example, Larry really isn't deeply involved on p5p any more. Meanwhile, perlrepository _also_ contains a lot of useful information on patching Perl, as well as a small git tutorial focused on working with the Perl repository. Taken together, the two documents overlap and conflict with each other. This commit does the following: == Reconcile conflicts and overlaps, remove obsolete information I've separated out distinct pieces of information and organized them into individual pod files. More on that below. I've also removed anything that was obviously out of date. == Make it easier for casual contributors to contribute. The perlhack document now gets to "how to make a patch" very quickly. My assumption is that most contributors to Perl are doing something small, like fixing pod, adding a test, etc. The documentation aimed at people doing more extensive hacking is still there, but it's been moved so that it comes at the end of the document or has been moved to another document. I've made an effort to cross-reference the various documents so that nothing gets lost. == Get to the point The perlhack document had a lot of discussion of general Perl culture. I've trimmed a lot of this and moved some of it so it comes later. == Per-file summary === perlrepository.pod This is gone. Some of its content is now in perlhack. This includes the bits on writing good commit messages, how (and where) to submit a patch, etc. The rest is now called perlgit, and is _only_ a git how-to. === perlhack.pod This has been cut down quite a bit. I changed the opening so it starts with a quick guide to submitting small patches. The document covers bug reporting, the p5p list, a quick how-to on getting the source (including git, gitweb, and rsync), and a lot of general information on patching perl and running tests. Much of this material was already present, but I've done a fair amount of editing for modernization and clarity. Most of the information specific to C-level hacking has been moved to other documents. === perlsource.pod This is a guide to the Perl source tree. Most of the content was extracted from perlhack. I've edited existing content and added details on some parts of the tree that weren't covered. === perlinterp.pod This is a tour of the Perl interpreter source and a walkthrough of how it works that originally lived in perlhack. This has received very little editing. === perlhacktut.pod This is a walkthrough of creating a sample patch to the C core code that originally lived in perlhack. This has received very little editing. === perlhacktips.pod The perlhack document contained a lot of useful information on low-level hacking details like debugging, compilation issues, portability, etc. This has received very little editing. I did remove some bits on ancient stuff related to Tru64 and IRIX.
* Update TOC for perl51310deltaJesse Vincent2011-01-221-0/+1
|
* Add perl5123delta.pod to MANIFEST and pod.lst, after f1d4662fac7469d5.Nicholas Clark2011-01-221-0/+1
| | | | | re-run pod/buildtoc to propagate the new file to the relevant platform makefiles.
* remove perlapollo from perl.podRobin Barker2011-01-111-1/+0
|
* update TOC for perl5138delta and perl5139deltaZefram2010-12-201-0/+1
|
* Slightly update perl.pod's "DESCRIPTION"Jesse Vincent2010-12-091-5/+8
|
* Don't explicitly talk about our support for DBM files as a feature.Jesse Vincent2010-12-091-2/+2
| | | | It's not 1995 anymore.
* remove more a2p/s2p from perl.podJesse Vincent2010-12-091-3/+0
|
* Remove a now-inaccurate statement about setuid scriptsJesse Vincent2010-12-091-3/+1
|
* Remove a paragraph from perl.pod pimping it as a sed/awk replacement.Jesse Vincent2010-12-091-6/+0
|
* Clarify this is the Perl 5 interpreter for manpage and METADavid Golden2010-12-061-1/+1
|
* Update TOC for perl5.13.8Chris 'BinGOs' Williams2010-11-211-1/+2
|
* Link to perlbug's PODTom Hukins2010-11-051-1/+1
|
* update TOC for perl5137deltaTatsuhiko Miyagawa2010-10-201-0/+2
|
* Add perl5122deltaFlorian Ragwitz2010-10-131-0/+1
|
* Prepare perldelta for Perl 5.13.6Steve Hay2010-09-191-0/+1
|
* update TOC and perldelta referencesFlorian Ragwitz2010-08-201-0/+1
|
* update TOC and perldelta referencesDavid Golden2010-07-201-0/+1
|
* Add perl5121delta to MANIEST and other filesDavid Golden2010-06-291-1/+2
| | | | | Cherry picking this from 5.12.1 would lose all the 5.13.X additions, so these edits have been made by hand.
* create perl5133deltaNicholas Clark2010-06-231-0/+1
|
* create perl5132deltaDavid Golden2010-05-231-0/+1
|
* create perl5131deltaLeon Brocard2010-04-201-0/+1
|
* Create a perl5130delta.podJesse Vincent2010-04-121-0/+1
|
* Fix title of perluniprops in table of contentsRafael Garcia-Suarez2010-03-261-1/+1
| | | | (noticed by Frank Wiegand)
* perl 5.11.6 never happened. Remove the traces of its perldelta.Jesse Vincent2010-03-251-1/+1
| | | | Thanks to Ask for pointing it out.
* Create perl5116delta and update other versionsSteve Hay2010-02-211-0/+1
|
* Revised opening line of perl man pageDavid Golden2010-02-111-1/+4
| | | | | This patch was reviewed with Larry Wall via IRC. His stipulation was that both historical glossses be preserved to humorous effect.
* Help new users learn how to get helpDavid Golden2010-02-101-33/+15
|
* Add perl5120delta to pod.lst and MANIFESTJesse Vincent2010-01-251-0/+1
|
* create perl5115delta and update other versionsRicardo Signes2010-01-201-0/+1
|
* Add perl5114delta.podRafael Garcia-Suarez2010-01-121-1/+2
|
* Update .podsKarl Williamson2009-12-251-1/+1
| | | | Signed-off-by: Abigail <abigail@abigail.be>
* Add new pod file to various lists and makefilesRafael Garcia-Suarez2009-11-221-0/+1
|
* create perl5113deltaLeon Brocard2009-11-201-0/+1
|
* Add perl5112delta, and change 5111delta from being "the" perldelta.Nicholas Clark2009-10-241-0/+1
|
* Move the new "perl policy" document into pod/Jesse Vincent2009-10-131-0/+1
|
* Run "cd pod ; ../perl -I../lib buildtoc --build-all"Rafael Garcia-Suarez2009-10-041-2/+1
|
* Fix pod toc generation for new perldeltaJesse Vincent2009-10-041-0/+2
| | | | Spotted by Jerry Hedden
* add perl5101deltaDavid Mitchell2009-08-231-0/+1
|
* Removed vestigal support for Tenon Intersystems MachTen Unix layer for MacOS ↵Jesse Vincent2009-08-031-1/+0
| | | | | | Classic. Perl hasn't supported MachTen since 5.6.
* Remove the port to MiNT. It's a dead platform that hasn't had any love ↵Jesse Vincent2009-08-031-1/+0
| | | | since 5.005
* Add documentation for the method resolution plugin interface.Nicholas Clark2009-06-251-0/+1
|
* Add perl589delta.pod to pod.lst, and run pod/buildtoc --build-all.Nicholas Clark2009-05-121-0/+1
|
* Eliminate "Old Perl threads tutorial", which describes 5005 threads.Nicholas Clark2009-04-121-1/+0
| | | | pod/perlthrtut.pod is the same material reworked for ithreads.
* Disambiguate mention of -E in perl.pod and in perlrun.podRafael Garcia-Suarez2009-03-151-1/+1
| | | | As Gisle remarks, -eE doesn't even work.
* Add -E in the command-line usage in perl.podRafael Garcia-Suarez2009-03-131-1/+1
|
* Add the perlperf manpage, by Richard FoleyRafael Garcia-Suarez2008-12-211-0/+2
|