summaryrefslogtreecommitdiff
path: root/pod/perlretut.pod
Commit message (Collapse)AuthorAgeFilesLines
* fix POD errors reported by newer pod2manDominic Hargreaves2013-10-061-17/+17
|
* perlretut.pod: Rephrase about \p{}.Karl Williamson2013-07-021-39/+20
| | | | | | | | | | This is in response to ticket [perl #118667]. This commit removes the confusing table of equivalent Unicode properties. It contained material about Unicode without adequate explanation beyond what a tutorial reader would be expected to know, so I just pulled it out. The POSIX classes haven't been introduced at this point, which really are needed for understanding this. Below, where they are introduced, I believe the examples make things adequately clear.
* perlretut.pod: Rephrase to be consistent with other podsKarl Williamson2013-07-021-3/+9
| | | | | | | This pod was calling bracketed character classes as just plain "character classes", but in one place it referred to the period as a character class as well, which is the terminology used elsewhere. This commit notes the distinction.
* Fixed verbatim lines in POD over 79 charactersBrian Gottreu2013-06-221-46/+48
|
* re-enable Copy-on-Write by default.David Mitchell2013-05-261-3/+9
| | | | | | | | | | | | COW was first introduced (and enabled by default) in 5.17.7. It was disabled by default in 5.17.10, because it was though to have too many rough edges for the 5.18.0 release. By re-enabling it now, early in the 5.19.x release cycle, hopefully it will be ready for production use by 5.20. This commit mainly reverts 9f351b45f4 and e1fd41328c (with modifications), then updates perldelta.
* Revert "Update docs to concur with $`,$&,$' changes"David Mitchell2013-05-061-9/+3
| | | | | | | | This reverts commit d78f32f607952d58a998c5b7554572320dc57b2a. Since COW has now not been enabled by default for 5.18, revert the documentation changes which say that that $' etc no longer have a performance penalty, etc.
* Update docs to concur with $`,$&,$' changesFather Chrysostomos2012-11-271-3/+9
| | | | plus a couple of other pod tweaks.
* perlretut: #109408Brian Fraser2012-06-271-6/+6
|
* update docs for (?{}) jumbo fixDavid Mitchell2012-06-141-11/+11
| | | | | | Update the docs and add perldelta entries summarising the changes and fixes related to (?{}) and (??{}) accumulated over the 120 or so commits in this branch.
* Correct variable name in example.Paul Johnson2012-05-021-3/+3
| | | | As noticed by Lawrence Statton <lawrence@cluon.com>
* Autoload charnames for \N{name}Karl Williamson2011-12-201-6/+4
| | | | | | | | | | | | | | | | This autoloads charnames.pm when needed. It uses the :full and :short options. :loose is not used because of its relative unfamiliarity in the Perl community, and is slower. (If someone later added a typical "use charnames qw(:full)", things that previously matched under :loose would start to fail, causing confustion. If :loose does become more common, we can change this in the future to use it; the converse isn't true.) The callable functions in the module are not automatically loaded. To access them, an explicity "use charnames" must be provided. Thanks to Tony Cook for doing a code inspection and finding a missing SPAGAIN.
* pod nitsKarl Williamson2011-12-201-2/+4
|
* [RT #36079] Convert ` to '.jkeenan2011-11-221-12/+12
|
* Fix typos in several pod/perl*.pod filesKeith Thompson2011-08-021-2/+2
|
* Fix typos in several pod/perl*.pod filesKeith Thompson2011-07-311-3/+3
|
* perlretut: Remove references to /dulKarl Williamson2011-07-051-9/+8
| | | | | | These modifiers are automatically selected when various pragmas are in effect, and their explicit use is rarely called for, so shouldn't be mentioned in a tutorial introduction.
* perlretut: Fix link problemKarl Williamson2011-06-211-1/+2
|
* perlretut: Update for 5.14 /a, /uKarl Williamson2011-04-121-12/+34
|
* perlretut: /o no longer very usefulKarl Williamson2011-03-311-33/+9
| | | | | perlretut still says /o is needed to prevent regex re-compilation in loops.
* perlretut: Remove references to Unicode blocksKarl Williamson2011-03-311-4/+1
| | | | | | | blocks are mostly useless, and not suitable for an introduction to regular expressions. It was not always the case, as in very early Unicode these were the best approximation to the much more useful Script concept. But that changed 10 or so years ago.
* perlretut: nitsKarl Williamson2011-03-311-5/+8
|
* perlretut: Emphasize difference of /rKarl Williamson2011-03-311-1/+2
|
* perlretut: Use generic Unicode web page linkKarl Williamson2011-03-311-1/+1
| | | | Use the link to Unicode that gives the latest version, whatever it might be
* perlretut: Mention 'alert' for \aKarl Williamson2011-03-311-1/+1
|
* perlretut: Add info about \NKarl Williamson2011-03-311-0/+5
|
* [perl #87128] Unclear note about \Q, etc., in perlretutFather Chrysostomos2011-03-281-3/+5
|
* [perl #86992] perlretut: Reference the Unicode standard for data filesDavid Leadbeater2011-03-251-3/+2
| | | | | | Since e4ed29fb stopped installing NamesList.txt the documentation can no longer suggest use of it, instead reference the Unicode standard in use by this version of perl.
* Mention when reflags was addedFather Chrysostomos2011-03-081-1/+2
|
* Another typo in perlretutFather Chrysostomos2011-03-081-1/+1
|
* mention reflags in perlretutFather Chrysostomos2011-03-081-0/+7
|
* Even more perlretut tweaksFather Chrysostomos2011-03-081-9/+10
|
* More changes to perlretutFather Chrysostomos2011-03-061-15/+18
| | | | | | | | | | Mostly minor punctuation changes, but also: • Some of the ‘new’ features are no longer new. • Explain that \Q\L\U only apply to literal regexps, not interpolated ones. • The charnames pragma is not required for \p • The section on [:POSIX:] char classes was still explaining 5.6.
* More perlretut tweaksFather Chrysostomos2011-03-061-15/+17
| | | | | | | | | | | In particular: • The word ‘substitute’ was misused. I changed it to substitution, but then realised that it was actually wordy and redundant, so I removed it. • The /e modifier does not do an eval{...} or eval '...' or anything of the sort. s/foo/die/e demonstrates this clearly. (/ee is a diffe- rent matter, but is not covered in perlretut.)
* perlretut: Mention /pFather Chrysostomos2011-03-061-0/+3
|
* perlretut tweaksFather Chrysostomos2011-03-061-5/+5
| | | | In particular, remove the obsolete mention of new features ‘in 5.6.0’.
* Fix links to POD sectionsFather Chrysostomos2011-02-121-1/+1
|
* Small change to perlretut and perlrequick to fix Bug 76604Noirin Shirley2011-01-251-5/+6
|
* perlretut: incorrect output in "Non-capturing groupings"Ævar Arnfjörð Bjarmason2010-09-301-1/+1
| | | | | | | | | | Change the example split output in a "Non-capturing groupings" example from ('12','a','34','b','5') to ('12','a','34','a','5'). This way it'll match the example code that goes along with it: split /(a|b)+/, "12aba34ba5" Reported-by: Antonio Bonifati <antonio.bonifati@gmail.com>
* Add \o{} escapeKarl Williamson2010-07-171-4/+5
| | | | | | | | | | This commit adds the new construct \o{} to express a character constant by its octal ordinal value, along with ancillary tests and documentation. A function to handle this is added to util.c, and it is called from the 3 parsing places it could occur. The function is a candidate for in-lining, though I doubt that it will ever be used frequently.
* Prefer \g1 over \1 in podsKarl Williamson2010-06-281-11/+11
| | | | | | | \g was added to avoid ambiguities that \digit causes. This updates the pod documentation to use \g in examples, and to prefer it when explaining the concepts. Some non-symmetrical outlined text dealing with it was also cleaned up.
* Standardize on use of 'capture group' over 'buffer'Karl Williamson2010-06-281-11/+11
| | | | | | Both terms 'capture group' and 'capture buffer' are used in the documentation. This patch changes most uses of the latter to the former, as they are referenced using "\g".
* Add s///r (non-destructive substitution).David Caldwell2010-05-221-0/+25
| | | | | | | | | | | | | | | | This changes s/// so that it doesn't act destructively on its target. Instead it returns the result of the substitution (or the original string if there was no match). In addition this patch: * Adds a new warning when s///r happens in void context. * Adds a error when you try to use s///r with !~ * Makes it so constant strings can be bound to s///r with =~ * Adds documentation. * Adds some tests. * Updates various debug code so it knows about the /r flag. * Adds some new 'r' words to B::Deparse.
* Clarify that some examples are for ASCII machinesKarl Williamson2010-03-281-1/+1
|
* Document \N{U+...}Karl Williamson2010-02-281-2/+2
|
* * Em dash cleanup in pod/brian d foy2010-01-131-6/+6
| | | | | | | | | | | | | I looked at all the instances of spaces around -- and in most cases converted the sentences to use more appropriate punctuation. In general, the -- in the perl docs seem to be there only to make really complicated and really long sentences. I didn't look at the closed em-dashes. They probably have the same sentence-complexity problem. I left some open em-dashes in place. Those are the ones used in lists.
* PATCH: minor typo cleanup of pod/ directoryTom Christiansen2010-01-051-1/+1
| | | | | | | | | | | | | | These are all in the pod/ directory, and only the first is a code fix. There was also a single lingering ISO 8859-1 encoding that missed the UTF-8 upconvert. The rest are cleanups for typos, some of which seem to have been around for a rather long time: spelling errors, incorrect possessives, and extra, missing, or duplicated words. If you actually read through, I bet you'll realize what sparked this. :) --tom Signed-off-by: Abigail <abigail@abigail.be>
* Update .podsKarl Williamson2009-12-251-10/+19
| | | | Signed-off-by: Abigail <abigail@abigail.be>
* [perl #69903] 5.10.1 perlretut section "A bit of magic: executing Perl code ↵Rafael Garcia-Suarez2009-10-231-4/+4
| | | | | | in a regular expression" documentation The docs were now wrong, due to new optimisations to the regexp engine.
* Small typo in example.H.Merijn Brand2009-06-101-1/+1
| | | | Thanks to "Jim Ferguson"
* Docs: Typo: \{-1} -> \g{-1}Michael Witten2009-04-071-1/+1
| | | | Signed-off-by: Michael Witten <mfwitten@gmail.com>