]> granicus.if.org Git - python/commitdiff
listdir no longer returns . or ..; added remove==unlink
authorGuido van Rossum <guido@python.org>
Mon, 12 Feb 1996 23:16:08 +0000 (23:16 +0000)
committerGuido van Rossum <guido@python.org>
Mon, 12 Feb 1996 23:16:08 +0000 (23:16 +0000)
Doc/lib/libposix.tex
Doc/libposix.tex

index 643cfda56cb246ca131ba562107f9203a0007a76..6696a28b735fd4381171495167df5998927bf17e 100644 (file)
@@ -177,8 +177,9 @@ Create a hard link pointing to \var{src} named \var{dst}.
 
 \begin{funcdesc}{listdir}{path}
 Return a list containing the names of the entries in the directory.
-The list is in arbitrary order.  It includes the special entries
-\code{'.'} and \code{'..'} if they are present in the directory.
+The list is in arbitrary order.  It does not include the special
+entries \code{'.'} and \code{'..'} even if they are present in the
+directory.
 \end{funcdesc}
 
 \begin{funcdesc}{lseek}{fd\, pos\, how}
@@ -245,6 +246,10 @@ points.  (On systems without symbolic links, this always raises
 \code{posix.error}.)
 \end{funcdesc}
 
+\begin{funcdesc}{remove}{path}
+Remove the file \var{path}.  See \code{rmdir} below to remove a directory.
+\end{funcdesc}
+
 \begin{funcdesc}{rename}{src\, dst}
 Rename the file or directory \var{src} to \var{dst}.
 \end{funcdesc}
@@ -324,7 +329,8 @@ hostname is \code{socket.gethostname()}.  (Not on MS-DOS, nor on older
 \end{funcdesc}
 
 \begin{funcdesc}{unlink}{path}
-Unlink \var{path}.
+Remove the file \var{path}.  This is the same function as \code{remove};
+the \code{unlink} name is its traditional \UNIX{} name.
 \end{funcdesc}
 
 \begin{funcdesc}{utime}{path\, \(atime\, mtime\)}
index 643cfda56cb246ca131ba562107f9203a0007a76..6696a28b735fd4381171495167df5998927bf17e 100644 (file)
@@ -177,8 +177,9 @@ Create a hard link pointing to \var{src} named \var{dst}.
 
 \begin{funcdesc}{listdir}{path}
 Return a list containing the names of the entries in the directory.
-The list is in arbitrary order.  It includes the special entries
-\code{'.'} and \code{'..'} if they are present in the directory.
+The list is in arbitrary order.  It does not include the special
+entries \code{'.'} and \code{'..'} even if they are present in the
+directory.
 \end{funcdesc}
 
 \begin{funcdesc}{lseek}{fd\, pos\, how}
@@ -245,6 +246,10 @@ points.  (On systems without symbolic links, this always raises
 \code{posix.error}.)
 \end{funcdesc}
 
+\begin{funcdesc}{remove}{path}
+Remove the file \var{path}.  See \code{rmdir} below to remove a directory.
+\end{funcdesc}
+
 \begin{funcdesc}{rename}{src\, dst}
 Rename the file or directory \var{src} to \var{dst}.
 \end{funcdesc}
@@ -324,7 +329,8 @@ hostname is \code{socket.gethostname()}.  (Not on MS-DOS, nor on older
 \end{funcdesc}
 
 \begin{funcdesc}{unlink}{path}
-Unlink \var{path}.
+Remove the file \var{path}.  This is the same function as \code{remove};
+the \code{unlink} name is its traditional \UNIX{} name.
 \end{funcdesc}
 
 \begin{funcdesc}{utime}{path\, \(atime\, mtime\)}