This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
More filename portability tips.
authorJarkko Hietaniemi <jhi@iki.fi>
Sun, 17 Feb 2002 16:50:34 +0000 (16:50 +0000)
committerJarkko Hietaniemi <jhi@iki.fi>
Sun, 17 Feb 2002 16:50:34 +0000 (16:50 +0000)
p4raw-id: //depot/perl@14730

pod/perlport.pod

index 0fa8d26..8d229d6 100644 (file)
@@ -353,7 +353,8 @@ where it is undesirable.
 Don't use C<:> as a part of a filename since many systems use that for
 their own semantics (MacOS Classic for separating pathname components,
 many networking schemes and utilities for separating the nodename and
-the pathname, and so on).
+the pathname, and so on).  For the same reasons, avoid C<@>, C<;> and
+C<|>.
 
 The I<portable filename characters> as defined by ANSI C are
 
@@ -362,7 +363,12 @@ The I<portable filename characters> as defined by ANSI C are
  0 1 2 3 4 5 6 7 8 9
  . _ -
 
-and the "-" shouldn't be the first character.
+and the "-" shouldn't be the first character.  If you want to be
+hypercorrect, stay within the 8.3 naming convention (all the files and
+directories have to be unique within one directory if their names are
+lowercased and truncated to eight characters before the C<.>, if any,
+and to three characters after the C<.>, if any).  (And do not use
+C<.>s in directory names.)
 
 =head2 System Interaction