From: Michael G. Schwern <schwern@pobox.com>
Date: Wed, 6 Jul 2005 13:06:20 +0000 (-0700)
Subject: Mention File::Spec in File::Basename
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=6eae9758ed9397ecd63d15ce9ba0eb49710ef187;p=p5sagit%2Fp5-mst-13.2.git

Mention File::Spec in File::Basename
Message-ID: <20050706200620.GE15644@windhund.schwern.org>

(plus bump $VERSION)

p4raw-id: //depot/perl@25091
---

diff --git a/lib/File/Basename.pm b/lib/File/Basename.pm
index 972849e..345edcf 100644
--- a/lib/File/Basename.pm
+++ b/lib/File/Basename.pm
@@ -18,9 +18,11 @@ File::Basename - Parse file paths into directory, filename and suffix.
 These routines allow you to parse file paths into their directory, filename
 and suffix.
 
-B<NOTE>: C<dirname()> and C<basename()> emulate the behaviours, and quirks, of
-the shell and C functions of the same name.  See each function's documention
-for details.
+B<NOTE>: C<dirname()> and C<basename()> emulate the behaviours, and
+quirks, of the shell and C functions of the same name.  See each
+function's documention for details.  If your concern is just parsing
+paths it is safer to use L<File::Spec>'s C<splitpath()> and
+C<splitdir()> methods.
 
 It is guaranteed that
 
@@ -29,6 +31,7 @@ It is guaranteed that
 
 is equivalent to the original path for all systems but VMS.
 
+
 =cut
 
 
@@ -51,7 +54,7 @@ our(@ISA, @EXPORT, $VERSION, $Fileparse_fstype, $Fileparse_igncase);
 require Exporter;
 @ISA = qw(Exporter);
 @EXPORT = qw(fileparse fileparse_set_fstype basename dirname);
-$VERSION = "2.73";
+$VERSION = "2.74";
 
 fileparse_set_fstype($^O);
 
@@ -365,3 +368,8 @@ sub fileparse_set_fstype {
 
 
 1;
+
+
+=head1 SEE ALSO
+
+L<dirname(1)>, L<basename(1)>, L<File::Spec>