| Commit message (Collapse) | Author | Age | Files | Lines |
|
|
|
|
|
|
|
| |
perl.pod already contained virtually all the information in pod.lst. Add
the remainder as =begin and =for Pod blocks.
As perl.pod no longer needs to be regenerated, remove the redundant code from
Porting/pod_rules.pl. Update (nearly) all references to pod.lst.
|
| |
|
|
|
|
|
|
|
| |
perldoc has a manpage prominently linked from the perl manpage. Hence it
makes no sense to also have it listed at the end of perltoc in the section
described as "Here should be listed all the extra programs' documentation,
but they don't all have manual pages yet"
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
|
|
|
|
|
| |
where appropriate
Used buildtoc to regenerate pod-related files
|
|
|
|
|
|
|
|
| |
The odd-numbered releases are for internal development, and their
individual perldeltas are collated togeter for the next even numbered
dot 0 release. This means that the individual perldeltas are no longer
useful once that dot 0 release is made, and they clutter things up,
giving duplicate information.
|
| |
|
| |
|
|
|
|
|
|
| |
perlcompile.pod is now maintained with B::C, and much more complete there.
[Subsequent build and test fixes by the committer]
|
|
|
|
|
| |
nearly all this work merged from brian d foy's briandfoy/perlexperiment branch,
tidied up and squished by rjbs
|
| |
|
| |
|
|
|
|
|
| |
This just does the general bookkeeping necessary when a new pod
(like the one in the previous commit) is added.
|
| |
|
| |
|
| |
|
| |
|
|
|
|
|
|
|
|
|
| |
As the edited perldelta is now always pod/perldelta.pod (instead of a file with
version numbers in it), we don't need a 'D' flag to mark it. As perldelta.pod
contains within itself the number of the version it refers to, we can use that
to infer the 'd' flag for the target filename.
This simplifies the release manager's tasklist for version bumping.
|
| |
|
|
|
|
| |
It has been deprecated in 5.14. Now is the time to remove it.
|
| |
|
| |
|
| |
|
|
|
|
|
|
|
|
|
|
|
| |
Quoth Porting/release_managers_guide.pod:
"Edit F<pod.lst>: add the new entry, flagged as 'd', and unflag
the previous entry from being 'd'; for example:
-d perl5101delta Perl changes in version 5.10.1
+d perl5102delta Perl changes in version 5.10.2
+ perl5101delta Perl changes in version 5.10.1"
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
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.
|
| |
|
|
|
|
|
| |
re-run pod/buildtoc to propagate the new file to the relevant platform
makefiles.
|
|
|
|
| |
hadn't worked for years before that.
|
| |
|
| |
|
| |
|
| |
|
|
|
|
|
|
|
|
| |
Upstream removed the wrappers from the scripts pod2man and pod2text which
will require some re-engineering. I've reinstated the wrappers until after
v5.13.6 ships.
Added perlpodstyle to pod.lst
|
| |
|
| |
|
|
|
|
|
| |
This way patches including perldelta entries will apply properly, no matter when
they are applied. If there's conflicts, they'll at least be in the right file.
|
| |
|
| |
|
|
|
|
|
| |
Cherry picking this from 5.12.1 would lose all the 5.13.X additions, so
these edits have been made by hand.
|
| |
|
| |
|
| |
|
| |
|
|
|
|
| |
(noticed by Frank Wiegand)
|
|
|
|
| |
Thanks to Ask for pointing it out.
|