[Python-checkins] python/dist/src/Doc/lib libos.tex,1.133,1.134

[fdrake at users.sourceforge.net]

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv24722

Modified Files:
	libos.tex 
Log Message:
really scream out that people should use the file objects instead of
file descriptor operations for normal applications


Index: libos.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libos.tex,v
retrieving revision 1.133
retrieving revision 1.134
diff -C2 -d -r1.133 -r1.134
*** libos.tex	31 Dec 2003 18:37:28 -0000	1.133
--- libos.tex	16 Apr 2004 15:20:01 -0000	1.134
***************
*** 400,408 ****
  Availability: Macintosh, \UNIX, Windows.
  
! Note: this function is intended for low-level I/O and must be applied
  to a file descriptor as returned by \function{open()} or
  \function{pipe()}.  To close a ``file object'' returned by the
  built-in function \function{open()} or by \function{popen()} or
  \function{fdopen()}, use its \method{close()} method.
  \end{funcdesc}
  
--- 400,410 ----
  Availability: Macintosh, \UNIX, Windows.
  
! \begin{notice}
! This function is intended for low-level I/O and must be applied
  to a file descriptor as returned by \function{open()} or
  \function{pipe()}.  To close a ``file object'' returned by the
  built-in function \function{open()} or by \function{popen()} or
  \function{fdopen()}, use its \method{close()} method.
+ \end{notice}
  \end{funcdesc}
  
***************
*** 499,506 ****
  \constant{O_WRONLY}) are defined in this module too (see below).
  
! Note: this function is intended for low-level I/O.  For normal usage,
  use the built-in function \function{open()}, which returns a ``file
  object'' with \method{read()} and \method{write()} methods (and many
  more).
  \end{funcdesc}
  
--- 501,510 ----
  \constant{O_WRONLY}) are defined in this module too (see below).
  
! \begin{notice}
! This function is intended for low-level I/O.  For normal usage,
  use the built-in function \function{open()}, which returns a ``file
  object'' with \method{read()} and \method{write()} methods (and many
  more).
+ \end{notice}
  \end{funcdesc}
  
***************
*** 526,530 ****
  Availability: Macintosh, \UNIX, Windows.
  
! Note: this function is intended for low-level I/O and must be applied
  to a file descriptor as returned by \function{open()} or
  \function{pipe()}.  To read a ``file object'' returned by the
--- 530,535 ----
  Availability: Macintosh, \UNIX, Windows.
  
! \begin{notice}
! This function is intended for low-level I/O and must be applied
  to a file descriptor as returned by \function{open()} or
  \function{pipe()}.  To read a ``file object'' returned by the
***************
*** 532,535 ****
--- 537,541 ----
  \function{fdopen()}, or \code{sys.stdin}, use its
  \method{read()} or \method{readline()} methods.
+ \end{notice}
  \end{funcdesc}
  
***************
*** 559,563 ****
  Availability: Macintosh, \UNIX, Windows.
  
! Note: this function is intended for low-level I/O and must be applied
  to a file descriptor as returned by \function{open()} or
  \function{pipe()}.  To write a ``file object'' returned by the
--- 565,570 ----
  Availability: Macintosh, \UNIX, Windows.
  
! \begin{notice}
! This function is intended for low-level I/O and must be applied
  to a file descriptor as returned by \function{open()} or
  \function{pipe()}.  To write a ``file object'' returned by the
***************
*** 565,568 ****
--- 572,576 ----
  \function{fdopen()}, or \code{sys.stdout} or \code{sys.stderr}, use
  its \method{write()} method.
+ \end{notice}
  \end{funcdesc}
  
***************
*** 875,882 ****
  After the rename, directories corresponding to rightmost path segments
  of the old name will be pruned away using \function{removedirs()}.
  
! Note: this function can fail with the new directory structure made if
  you lack permissions needed to remove the leaf directory or file.
! \versionadded{1.5.2}
  \end{funcdesc}
  
--- 883,892 ----
  After the rename, directories corresponding to rightmost path segments
  of the old name will be pruned away using \function{removedirs()}.
+ \versionadded{1.5.2}
  
! \begin{notice}
! This function can fail with the new directory structure made if
  you lack permissions needed to remove the leaf directory or file.
! \end{notice}
  \end{funcdesc}
  
***************
*** 1229,1235 ****
  Availability: \UNIX, Windows.
  
! Note: the standard way to exit is \code{sys.exit(\var{n})}.
  \function{_exit()} should normally only be used in the child process
  after a \function{fork()}.
  \end{funcdesc}
  
--- 1239,1247 ----
  Availability: \UNIX, Windows.
  
! \begin{notice}
! The standard way to exit is \code{sys.exit(\var{n})}.
  \function{_exit()} should normally only be used in the child process
  after a \function{fork()}.
+ \end{notice}
  \end{funcdesc}