From: Jarkko Hietaniemi Date: Wed, 20 Mar 2002 01:12:28 +0000 (+0000) Subject: Whitespace tweaks. X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=666f95b95a2f6347f7b7bbc8951144df2db05479;p=p5sagit%2Fp5-mst-13.2.git Whitespace tweaks. p4raw-id: //depot/perl@15351 --- diff --git a/pod/perldebguts.pod b/pod/perldebguts.pod index f507ac8..cde70b2 100644 --- a/pod/perldebguts.pod +++ b/pod/perldebguts.pod @@ -111,15 +111,15 @@ calls are not possible, even though C<&DB::sub> exists. =head2 Writing Your Own Debugger =head3 Environment Variables - + The C environment variable can be used to define a debugger. For example, the minimal "working" debugger (it actually doesn't do anything) consists of one line: - + sub DB::DB {} It can easily be defined like this: - + $ PERL5DB="sub DB::DB {}" perl -d your-script Another brief debugger, slightly more useful, can be created @@ -130,9 +130,9 @@ with only the line: This debugger prints a number which increments for each statement encountered and waits for you to hit a newline before continuing to the next statement. - + The following debugger is actually useful: - + { package DB; sub DB {} diff --git a/pod/perlfaq5.pod b/pod/perlfaq5.pod index 9863334..701a757 100644 --- a/pod/perlfaq5.pod +++ b/pod/perlfaq5.pod @@ -496,7 +496,6 @@ literals open FILE, "<", " file "; # filename is " file " open FILE, ">", ">file"; # filename is ">file" - It may be a lot clearer to use sysopen(), though: diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod index b32cd94..9e667ab 100644 --- a/pod/perlfunc.pod +++ b/pod/perlfunc.pod @@ -3433,10 +3433,10 @@ aligned at a multiple of C bytes. For example, to pack() or unpack() C's C one may need to use the template C; this assumes that doubles must be aligned on the double's size. - + For alignment commands C of 0 is equivalent to C of 1; both result in no-ops. - + =item * A comment in a TEMPLATE starts with C<#> and goes to the end of line. diff --git a/pod/perltodo.pod b/pod/perltodo.pod index 6870696..eea756b 100644 --- a/pod/perltodo.pod +++ b/pod/perltodo.pod @@ -193,7 +193,7 @@ for the real and effective uids). Firstly, what exactly setuid() call gets invoked in which platform is simply a big mess that needs to be untangled. Secondly, the effects are apparently not standard across platforms, (if you first set $< and then $>, or vice versa, being -uid==euid== zero, or just euid==zero, or as a normal user, what are +uid == euid == zero, or just euid == zero, or as a normal user, what are the results?). The test suite not (usually) being run as root means that these things do not get much testing. Thirdly, there's quite often a third uid called saved uid, and Perl has no knowledge of that @@ -201,7 +201,7 @@ feature in any way. (If one has the saved uid of zero, one can get back any real and effective uids.) As an example, to change also the saved uid, one needs to set the real and effective uids B-- in most systems, that is: in HP-UX that doesn't seem to work. - + =head2 Custom opcodes Have a way to introduce user-defined opcodes without the subroutine call diff --git a/pod/perlunicode.pod b/pod/perlunicode.pod index 34e00c8..468f24c 100644 --- a/pod/perlunicode.pod +++ b/pod/perlunicode.pod @@ -975,7 +975,7 @@ on byte encoded strings. All functions that need to hop over characters such as length(), substr() or index() can work B faster when the underlying data are byte-encoded. Witness the following benchmark: - + % perl -e ' use Benchmark; use strict; @@ -994,7 +994,7 @@ following benchmark: LENGTH_U: 2 wallclock secs ( 2.11 usr + 0.00 sys = 2.11 CPU) @ 12155.45/s (n=25648) SUBSTR_B: 3 wallclock secs ( 2.16 usr + 0.00 sys = 2.16 CPU) @ 374480.09/s (n=808877) SUBSTR_U: 2 wallclock secs ( 2.11 usr + 0.00 sys = 2.11 CPU) @ 6791.00/s (n=14329) - + The numbers show an incredible slowness on long UTF-8 strings and you should carefully avoid to use these functions within tight loops. For example if you want to iterate over characters, it is infinitely @@ -1022,7 +1022,7 @@ benchmark shows: You see, the algorithm based on substr() was faster with byte encoded data but it is pathologically slow with UTF-8 data. - + =head1 SEE ALSO L, L, L, L, L, L,