documentation fixes from p5p

p4raw-id: //depot/perl@5779

4 files changed, 13 insertions, 8 deletions

diff --git a/ext/B/B/Bblock.pm b/ext/B/B/Bblock.pm
index b914bc661b..fe7fc52139 100644
--- a/ext/B/B/Bblock.pm
+++ b/ext/B/B/Bblock.pm
@@ -169,7 +169,9 @@ B::Bblock - Walk basic blocks
 
 =head1 DESCRIPTION
 
-See F<ext/B/README>.
+This module is used by the B::CC back end.  It walks "basic blocks".
+A basic block is a series of operations which is known to execute from
+start to finish, with no possiblity of branching or halting.
 
 =head1 AUTHOR
 
diff --git a/lib/File/Spec/Unix.pm b/lib/File/Spec/Unix.pm
index 0cbc8c7e57..2305b75b76 100644
--- a/lib/File/Spec/Unix.pm
+++ b/lib/File/Spec/Unix.pm
@@ -242,11 +242,13 @@ $directories must be only the directory portion of the path on systems
 that have the concept of a volume or that have path syntax that differentiates
 files from directories.
 
-Unlike just splitting the directories on the separator, leading empty and 
-trailing directory entries can be returned, because these are significant
-on some OSs. So,
+Unlike just splitting the directories on the separator, empty
+directory names (C<''>) can be returned, because these are significant
+on some OSs (e.g. MacOS).
 
-    File::Spec->splitdir( "/a/b/c" );
+On Unix,
+
+    File::Spec->splitdir( "/a/b//c/" );
 
 Yields:
 
diff --git a/pod/perlcompile.pod b/pod/perlcompile.pod
index 8f31fc6032..697cb80d40 100644
--- a/pod/perlcompile.pod
+++ b/pod/perlcompile.pod
@@ -306,8 +306,9 @@ I<assemble> program that produces bytecode.
 
 =item B::Bblock
 
-This module is used by the B::CC back end.  It walks "basic blocks",
-whatever they may be.
+This module is used by the B::CC back end.  It walks "basic blocks".
+A basic block is a series of operations which is known to execute from
+start to finish, with no possiblity of branching or halting.
 
 =item B::Bytecode
 
diff --git a/pod/perldebug.pod b/pod/perldebug.pod
index 5b7a2bdbb0..ead5414ccf 100644
--- a/pod/perldebug.pod
+++ b/pod/perldebug.pod
@@ -620,7 +620,7 @@ specified in the C<TTY> option at startup, or to a tty found at
 runtime using the C<Term::Rendezvous> module of your choice.
 
 This module should implement a method named C<new> that returns an object
-with two methods: C<IN> and C<OUT.  These should return filehandles to use
+with two methods: C<IN> and C<OUT>.  These should return filehandles to use
 for debugging input and output correspondingly.  The C<new> method should
 inspect an argument containing the value of C<$ENV{PERLDB_NOTTY}> at
 startup, or C<"/tmp/perldbtty$$"> otherwise.  This file is not