Specced mkdir

S32-setting-library/IO.pod

@@ -22,8 +22,8 @@ DRAFT: Synopsis 32: Setting Library - IO
 
     Created: 19 Feb 2009 extracted from S29-functions.pod; added stuff from S16-IO later
 
-    Last Modified: 19 Aug 2013
-    Version: 21
+    Last Modified: 23 Sep 2013
+    Version: 22
 
 The document is a draft.
 
@@ -221,6 +221,14 @@ failure.
 Removes the directory given from disk.  Returns True on success, or an 
 L<X::IO::Rmdir|S32::Exception/X::IO::Rmdir> failure.
 
+=item mkdir
+
+    sub mkdir(Cool:D $directory)
+
+Makes (creates) the directory represented by the IO::Path. Returns True on success,
+or an L<X::IO::Mkdir|S32::Exception/X::IO::Mkdir> failure.
+
+
 =back
 
 =head1 IO Types
@@ -715,6 +723,13 @@ Removes (deletes) the directory represented by the IO::Path.  Typically fails
 unless the directory is empty.  Returns True on success; fails with an X::IO::Rmdir
 on error.
 
+=item mkdir
+
+Makes (creates) the directory represented by the IO::Path. Returns True on success.
+The method will C<fail> with L<X::IO::Mkdir|S32::Exception/X::IO::Mkdir> if it 
+can not create the directory, if file or directory already exists or if the parent
+directory of the path does not exist.
+
 =back
 
 =head3 OS Specific subclasses.