listdir no longer returns . or ..; added remove==unlink

1 files changed, 9 insertions, 3 deletions

diff --git a/Doc/libposix.tex b/Doc/libposix.tex
index 643cfda..6696a28 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\)}