summaryrefslogtreecommitdiff
path: root/pod
Commit message (Collapse)AuthorAgeFilesLines
* [perl #111656] perldiag: ‘glob failed’ is S, not WFather Chrysostomos2012-03-261-1/+1
| | | | | | Prior to the preceding commit, the ‘glob failed’ warning would always occur, regardless of warnings settings, so W was never correct. Now it is S, which is was it used to be closest to.
* Merge branch 'abigail/for-5.17' into bleadAbigail2012-03-261-2/+3
|\
| * Clearify string parsing.abigail/for-5.17Abigail2012-03-231-2/+3
| | | | | | | | | | | | | | It was already documented that when scanning for the end of the string, backslashes escaping the closing delimiter are being eliminated; but this is true for backslashes escaping backslashes as well. This makes that C<< '.\.' eq '.\\.' >>. (Pointed out by Mithaldu)
* | Clarify VMS-specific handling of $/ = \N.Craig A. Berry2012-03-251-6/+4
|/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | When the record read feature was introduced in 5b2b9c687790241e8 in 1998 (but by Dan Sugalski, not Hans Mulder as the git history erroneously says), sysread() was a couple of years from learning about utf-8 and PerlIO was just a fancy way of calling stdio. The documentation was reasonable given that environment. Now it's potentially misleading to say that record reads are "the equivalent of C<sysread>" because sysread on filehandles opened with ":utf8" does characters, not bytes. The salient point about the analogy with sysread was always that the read is unbuffered. In the old days, this was in contrast to the buffering done in stdio's fread(), but now it's in contrast to the buffering in the perlio layer. By emphasizing the role of buffering, we can actually shorten and simplify the docs. Side note: Both Camel 3 and Camel 4 have the following problematic statement in the documentation of $/: "Record mode mixes with line mode only on systems where standard I/O supplies a read(3) function; VMS is a notable exception." VMS certainly does have a read(3) function and in fact that's what's used directly for record reads (via PerlLIO_read) on VMS only. And as far as I know, it is fread(), not read(), that is considered "standard I/O" everywhere. N.B. Record reads on non-record-oriented files on VMS will likely start using the same buffering as other platforms in a future version of Perl.
* [rt #79960] document how broken $/ = \N is for unicode streamsTony Cook2012-03-231-0/+7
| | | | | | It's kind of late in the release process to change how $/ = \N works for unicode streams, briefly document how broken it is and let the user know it may change.
* Create a perldelta for 5.15.9Abigail2012-03-204-185/+582
|
* Add 5.15.9 release to perlhist.podAbigail2012-03-201-1/+2
|
* Work around an HTML display issueAbigail2012-03-201-0/+2
|
* Final version of Module::CoreList is 2.65.Abigail2012-03-201-1/+1
|
* Clearify that perl can crash, not WindowsAbigail2012-03-201-1/+1
|
* Say "warnings" instead of "errors"Abigail2012-03-201-1/+1
|
* Removed the changes to Term::ReadLine from the bug fixes section.Abigail2012-03-201-4/+3
| | | | And added a line to the module upgrades section.
* Fix typo in pod/perldeltaAbigail2012-03-201-1/+1
|
* Reran Porting/acknowledgements.plAbigail2012-03-201-3/+1
|
* List 5.16 blockers in 'Known Problems' in perldeltaAbigail2012-03-201-2/+23
|
* yes, regression fixes are generally okay for maintRicardo Signes2012-03-201-0/+5
|
* Document the TRIE changes in perldeltaAbigail2012-03-201-0/+6
|
* Document upgrade of lib/charnames.Abigail2012-03-201-0/+4
| | | | Changed Module::Corelist and perldelta.pod
* Fix spelling errors in pod/perldelta.podAbigail2012-03-201-2/+2
|
* Document new versions of Data::Dumper and XS::APItest.Abigail2012-03-201-0/+8
| | | | Updated Module::CoreList and perldelta to reflect the changes.
* Paste in the output of Porting/corelist-perldelta.plAbigail2012-03-201-24/+55
| | | | | | | - Manually added feature. - Data::Dumper was upgraded while working on this; so we'll have to redo the corelist, and adjust the "Updated Modules and Pragmata" section.
* Deprecate utf8_to_uvchr() and utf8_to_uvuni()Karl Williamson2012-03-191-8/+24
| | | | | | These functions can read beyond the end of their input strings if presented with malformed UTF-8 input. Perl core code has been converted to use other functions instead of these.
* Use the new utf8 to code point functionsKarl Williamson2012-03-192-4/+6
| | | | | These functions should be used in preference to the old ones which can read beyond the end of the input string.
* utf8.c: Add utf8_to_uvchr_buf() and utf8_to_uvuni_buf()Karl Williamson2012-03-191-1/+5
| | | | | | | | The existing functions (utf8_to_uvchr and utf8_to_uvuni) have a deficiency in that they could read beyond the end of the input string if given malformed input. This commit creates two new functions which behave as the old ones did, but have an extra parameter each, which gives the upper limit to the string, so no read beyond it is done.
* perlguts, warnings.t: Update references to obsolete fcn namesKarl Williamson2012-03-191-6/+7
| | | | | These functions were replaced long ago, apparently in 5.8, but I didn't verify that for sure.
* perldelta: clarificationKarl Williamson2012-03-191-2/+2
|
* More perldelta work.Abigail2012-03-191-35/+2
|
* Mention the fix to perlfunc.html in "Configuration and Compilation" as well.Abigail2012-03-191-9/+2
| | | | Also, fix the spelling of html.
* Note in the source of perlhist.pod that "cow orker" is no typo.Nicholas Clark2012-03-191-0/+2
| | | | | This won't change the rendered pod, but will clarify to anyone thinking to patch the "mistake" that the seeming typo is intentional.
* Mention Porting/bisect.pl in perlgit.pod, before describing git bisect.Nicholas Clark2012-03-191-14/+53
| | | | | | | Porting/bisect.pl is intended to cover 90% of use cases, whilst being simpler to use than git bisect, so mention it first. Condense the description of git bisect slightly - it's giving implementation details which duplicate git help bisect, which we already refer the reader to.
* Move the example git bisect shell script from perlgit.pod to Porting/Nicholas Clark2012-03-191-29/+4
| | | | | This both avoids cluttering the flow of manpage with auxiliary data, and saves the user from having to extract the script from within the pod file.
* Add a placeholder man page for perltodo, directing people to look at git.Nicholas Clark2012-03-192-0/+11
| | | | (Done as a second commit to avoid confusing git's rename detection.)
* Move the todo list from pod/ to Porting/Nicholas Clark2012-03-192-1261/+0
| | | | | | Installing the Perl 5 to-do list as a manpage isn't that useful to anyone, as it's a snapshot that becomes increasingly out of date. Much better to point anyone interested in contributing direct to git HEAD, to view the current list.
* More work on perldeltaAbigail2012-03-191-84/+15
|
* Note the improvements to B::Deparse and feature in perldelta.Nicholas Clark2012-03-191-0/+9
|
* Note in perldelta that C<no feature;> now means reset to default.Nicholas Clark2012-03-191-1/+3
| | | | The behaviour was changed with commit 39ec54a59ce332fc.
* Retry first shot at perldelta.pod.Abigail2012-03-191-78/+89
| | | | Documents the differences between 5.15.8 and 5.15.9.
* Revert "First shot at perl5159delta.pod"Abigail2012-03-182-438/+1
| | | | | | This reverts commit 21ffc8459b739cc13a32f22a2edb7be485a062e0. Until I can figure out how to add a new perldelta and make all tests pass.
* Revert "Paste in the output of Porting/acknowledgements.pl in ↵Abigail2012-03-181-26/+2
| | | | | | | | pod/perl5159delta.pod" This reverts commit 98f0737d71a92167bf1aace8a8d8411b985e3200. Until I can figure out how to add a new perldelta and make all tests pass.
* Paste in the output of Porting/acknowledgements.pl in pod/perl5159delta.podAbigail2012-03-181-2/+26
|
* First shot at perl5159delta.podAbigail2012-03-182-1/+438
|
* In perlfunc, don't have functions in "Misc" and a second category.Nicholas Clark2012-03-171-4/+2
| | | | | | | | dump, eval, evalbytes and wantarray are now only in "flow control". local, my, our and state are only in "scoping". prototype is now only in "misc". Whilst *prototypes* affect parsing, and hence indirectly flow control, the prototype function is for introspecting prototypes.
* De-emphasise switch-related keywords in perlfunc.Nicholas Clark2012-03-171-103/+26
| | | | | | | | | | | Move the 3 non-function keywords into the summary cross reference section at the end of perlfunc. Eliminate the examples which duplicate examples in perlsyn. Merge the remaining 2 keywords into the "control flow" group. Note that the switch feature is considered experimental. With these changes, `perldoc -f default`, `perldoc -f given` and `perldoc -f when` will still return a helpful result, and as before will refer the reader to perlsyn for full information.
* In the perlfunc cross-reference sections, link to the section within a page.Nicholas Clark2012-03-171-5/+5
| | | | | | | perlfunc now has a section cross referencing keywords documented elsewhere. Keywords are grouped by man page, and for most manpages, all the cross-referenced keywords are in the same section. Hence make the L<> links more specific by including the section.
* DESTROY is documented in perlobj - correct the cross-reference in perlfunc.Nicholas Clark2012-03-171-2/+10
|
* Run podtidy on perlsource.podDave Rolsky2012-03-151-56/+63
|
* Add a missing word to perlsource.podDave Rolsky2012-03-151-1/+1
|
* perldelta for die propgation fixTony Cook2012-03-121-1/+2
|
* perlvar: Fix long linesFather Chrysostomos2012-03-071-132/+140
| | | | | Also, make all indented code start with a four-space indent. Before this it was inconsistent throughout.
* Dear perlvar: ${^WARNING_BITS} was added in 5.6Father Chrysostomos2012-03-071-1/+1
|