develooper Front page | perl.perl5.porters | Postings from January 2001

[PATCH 5.[67].1]; as Re: [PATCH 5.6.1-TRIAL1 and @8223]; was Re: Perlbug 20000322.006 status update

Thread Next
From:
Robin Barker
Date:
January 2, 2001 07:35
Subject:
[PATCH 5.[67].1]; as Re: [PATCH 5.6.1-TRIAL1 and @8223]; was Re: Perlbug 20000322.006 status update
Message ID:
200101021535.PAA15161@tempest.npl.co.uk
----------
X-Sun-Data-Type: text
X-Sun-Data-Description: text
X-Sun-Data-Name: text
X-Sun-Charset: us-ascii
X-Sun-Content-Lines: 19

I wrote:
> The patch reformats some long =item lines so they give correct output via
> pod2man | nroff -man
> 
> There are two patch files: against perl-5.6.1-Trial1, and perl@8223. 
> 
> Robin 

Here is a _further_ patch which corrects a few more errors:
  * an empty C<=item> in CPAN.pm
  * patching the wrong file (pod/perlamiga.pod not README.amiga)
  * leaving empty C<=item>s which formatted incorrectly
  * over long C<=item>s revealed by latest patch to Pod::Man

Again, there are two patches for perl-5.[67].1, against perl-5.6.1-Trial1
and perl@8269.

Robin 

----------
X-Sun-Data-Type: default
X-Sun-Data-Description: default
X-Sun-Data-Name: longitem-rev-5.6.1.patch
X-Sun-Charset: us-ascii
X-Sun-Content-Lines: 128

diff -r -u perl-5.6.1-TRIAL1/README.amiga perl-5.6.1-TRIAL1-patched/README.amiga
--- perl-5.6.1-TRIAL1/README.amiga
+++ perl-5.6.1-TRIAL1-patched/README.amiga
@@ -103,14 +103,22 @@
 
 =over 6
 
-=item fork()
+=item *
 
-=item some features of the UNIX filesystem regarding link count and file dates
+fork()
 
-=item inplace operation (the -i switch) without backup file
+=item *
 
-=item umask() works, but the correct permissions are only set when the file is
-      finally close()d
+some features of the UNIX filesystem regarding link count and file dates
+
+=item *
+
+inplace operation (the B<-i> switch) without backup file
+
+=item *
+
+umask() works, but the correct permissions are only set when the file is
+finally close()d
 
 =back
 
diff -r -u perl-5.6.1-TRIAL1/lib/CPAN.pm perl-5.6.1-TRIAL1-patched/lib/CPAN.pm
--- perl-5.6.1-TRIAL1/lib/CPAN.pm
+++ perl-5.6.1-TRIAL1-patched/lib/CPAN.pm
@@ -6269,8 +6269,6 @@
 
 Returns the author's ID of the module.
 
-=item
-
 =back
 
 =head2 Cache Manager
diff -r -u perl-5.6.1-TRIAL1/lib/Win32.pod perl-5.6.1-TRIAL1-patched/lib/Win32.pod
--- perl-5.6.1-TRIAL1/lib/Win32.pod
+++ perl-5.6.1-TRIAL1-patched/lib/Win32.pod
@@ -175,9 +175,9 @@
 system boot. Resolution is limited to system timer ticks (about 10ms
 on WinNT and 55ms on Win9X).
 
-=item
+=item Win32::InitiateSystemShutdown
 
-Win32::InitiateSystemShutdown(MACHINE, MESSAGE, TIMEOUT, FORCECLOSE, REBOOT)
+(MACHINE, MESSAGE, TIMEOUT, FORCECLOSE, REBOOT)
 
 [EXT] Shutsdown the specified MACHINE, notifying users with the
 supplied MESSAGE, within the specified TIMEOUT interval. Forces
diff -r -u perl-5.6.1-TRIAL1/pod/perldelta.pod perl-5.6.1-TRIAL1-patched/pod/perldelta.pod
--- perl-5.6.1-TRIAL1/pod/perldelta.pod
+++ perl-5.6.1-TRIAL1-patched/pod/perldelta.pod
@@ -2638,11 +2638,12 @@
 
 In Perl 5.6.0 and later, C<"$$1"> always means C<"${$1}">.
 
-=item
+=item delete(), each(), values() and C<\(%h)>
 
-delete(), values() and C<\(%h)> operate on aliases to values, not copies
+operate on aliases to values, not copies
 
-delete(), each(), values() and hashes in a list context return the actual
+delete(), each(), values() and hashes (e.g. C<\(%h)>)
+in a list context return the actual
 values in the hash, instead of copies (as they used to in earlier
 versions).  Typical idioms for using these constructs copy the
 returned values, but this can make a significant difference when
@@ -2922,7 +2923,9 @@
 
 =item The DB module
 
-=item The regular expression constructs C<(?{ code })> and C<(??{ code })>
+=item The regular expression code constructs: 
+
+C<(?{ code })> and C<(??{ code })>
 
 =back
 
diff -r -u perl-5.6.1-TRIAL1/pod/perlrequick.pod perl-5.6.1-TRIAL1-patched/pod/perlrequick.pod
--- perl-5.6.1-TRIAL1/pod/perlrequick.pod
+++ perl-5.6.1-TRIAL1-patched/pod/perlrequick.pod
@@ -304,18 +304,30 @@
 
 =over 4
 
-=item * C<a?> = match 'a' 1 or 0 times
+=item *
 
-=item * C<a*> = match 'a' 0 or more times, i.e., any number of times
+C<a?> = match 'a' 1 or 0 times
 
-=item * C<a+> = match 'a' 1 or more times, i.e., at least once
+=item *
 
-=item * C<a{n,m}> = match at least C<n> times, but not more than C<m>
+C<a*> = match 'a' 0 or more times, i.e., any number of times
+
+=item *
+
+C<a+> = match 'a' 1 or more times, i.e., at least once
+
+=item *
+
+C<a{n,m}> = match at least C<n> times, but not more than C<m>
 times.
 
-=item * C<a{n,}> = match at least C<n> or more times
+=item *
+
+C<a{n,}> = match at least C<n> or more times
+
+=item *
 
-=item * C<a{n}> = match exactly C<n> times
+C<a{n}> = match exactly C<n> times
 
 =back
 
----------
X-Sun-Data-Type: default
X-Sun-Data-Description: default
X-Sun-Data-Name: longitem-rev-5.7.1.patch
X-Sun-Charset: us-ascii
X-Sun-Content-Lines: 126

--- README.amiga.orig	Tue Dec 12 03:29:40 2000
+++ README.amiga
@@ -101,16 +101,24 @@
 Perl under AmigaOS lacks some features of perl under UNIX because of
 deficiencies in the UNIX-emulation, most notably:
 
-=over 6
+=over 4
 
-=item fork()
+=item * 
 
-=item some features of the UNIX filesystem regarding link count and file dates
+fork()
 
-=item inplace operation (the -i switch) without backup file
+=item *
 
-=item umask() works, but the correct permissions are only set when the file is
-      finally close()d
+some features of the UNIX filesystem regarding link count and file dates
+
+=item *
+
+inplace operation (the -i switch) without backup file
+
+=item *
+
+umask() works, but the correct permissions are only set when the file is
+finally close()d
 
 =back
 
--- lib/CPAN.pm.orig	Fri Dec 22 15:28:06 2000
+++ lib/CPAN.pm
@@ -6269,8 +6269,6 @@
 
 Returns the author's ID of the module.
 
-=item
-
 =back
 
 =head2 Cache Manager
--- lib/Win32.pod.orig	Fri Dec 22 15:28:06 2000
+++ lib/Win32.pod
@@ -175,9 +175,9 @@
 system boot. Resolution is limited to system timer ticks (about 10ms
 on WinNT and 55ms on Win9X).
 
-=item
+=item Win32::InitiateSystemShutdown
 
-Win32::InitiateSystemShutdown(MACHINE, MESSAGE, TIMEOUT, FORCECLOSE, REBOOT)
+(MACHINE, MESSAGE, TIMEOUT, FORCECLOSE, REBOOT)
 
 [EXT] Shutsdown the specified MACHINE, notifying users with the
 supplied MESSAGE, within the specified TIMEOUT interval. Forces
--- pod/perl56delta.pod.orig	Fri Dec 22 15:28:07 2000
+++ pod/perl56delta.pod
@@ -2631,11 +2631,12 @@
 
 In Perl 5.6.0 and later, C<"$$1"> always means C<"${$1}">.
 
-=item
+=item delete(), each(), values() and C<\(%h)>
 
-delete(), values() and C<\(%h)> operate on aliases to values, not copies
+operate on aliases to values, not copies
 
-delete(), each(), values() and hashes in a list context return the actual
+delete(), each(), values() and hashes (e.g. C<\(%h)>)
+in a list context return the actual
 values in the hash, instead of copies (as they used to in earlier
 versions).  Typical idioms for using these constructs copy the
 returned values, but this can make a significant difference when
@@ -2915,7 +2916,9 @@
 
 =item The DB module
 
-=item The regular expression constructs C<(?{ code })> and C<(??{ code })>
+=item The regular expression code constructs: 
+
+C<(?{ code })> and C<(??{ code })>
 
 =back
 
--- pod/perlrequick.pod.orig	Fri Dec 22 15:28:08 2000
+++ pod/perlrequick.pod
@@ -304,18 +304,30 @@
 
 =over 4
 
-=item * C<a?> = match 'a' 1 or 0 times
+=item *
 
-=item * C<a*> = match 'a' 0 or more times, i.e., any number of times
+C<a?> = match 'a' 1 or 0 times
 
-=item * C<a+> = match 'a' 1 or more times, i.e., at least once
+=item *
 
-=item * C<a{n,m}> = match at least C<n> times, but not more than C<m>
+C<a*> = match 'a' 0 or more times, i.e., any number of times
+
+=item *
+
+C<a+> = match 'a' 1 or more times, i.e., at least once
+
+=item *
+
+C<a{n,m}> = match at least C<n> times, but not more than C<m>
 times.
 
-=item * C<a{n,}> = match at least C<n> or more times
+=item *
+
+C<a{n,}> = match at least C<n> or more times
+
+=item *
 
-=item * C<a{n}> = match exactly C<n> times
+C<a{n}> = match exactly C<n> times
 
 =back
 

-- 
Robin Barker                        | Email: Robin.Barker@npl.co.uk
CMSC, Building 10,                  | Phone: +44 (0) 20 8943 7090
National Physical Laboratory,       | Fax:   +44 (0) 20 8977 7091
Teddington, Middlesex, UK. TW11 OLW | WWW:   http://www.npl.co.uk

Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About