From 8c07bb4565f5cd65c1188c865b08defaa2fc3a07 Mon Sep 17 00:00:00 2001
From: Guido van Rossum <guido@python.org>
Date: Mon, 12 Feb 1996 23:16:08 +0000
Subject: [PATCH] listdir no longer returns . or ..; added remove==unlink

---
 Doc/lib/libposix.tex | 12 +++++++++---
 Doc/libposix.tex     | 12 +++++++++---
 2 files changed, 18 insertions(+), 6 deletions(-)

diff --git a/Doc/lib/libposix.tex b/Doc/lib/libposix.tex
index 643cfda56cb..6696a28b735 100644
--- a/Doc/lib/libposix.tex
+++ b/Doc/lib/libposix.tex
@@ -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\)}
diff --git a/Doc/libposix.tex b/Doc/libposix.tex
index 643cfda56cb..6696a28b735 100644
--- a/Doc/libposix.tex
+++ b/Doc/libposix.tex
@@ -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\)}