[Python-checkins] CVS: python/dist/src/Doc/lib libos.tex,1.71,1.72

[Fred L. Drake]

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory usw-pr-cvs1:/tmp/cvs-serv15265/lib

Modified Files:
	libos.tex 
Log Message:
Various cleanups & markup fixes, mostly relating to the stat and statvfs
result object changes.


Index: libos.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libos.tex,v
retrieving revision 1.71
retrieving revision 1.72
diff -C2 -d -r1.71 -r1.72
*** libos.tex	2001/11/28 07:26:15	1.71
--- libos.tex	2001/11/29 20:48:44	1.72
***************
*** 60,72 ****
  attribute, \member{filename}, which is the file name passed to the
  function.
- 
- When exceptions are strings, the string for the exception is
- \code{'OSError'}.
  \end{excdesc}
  
  \begin{datadesc}{name}
  The name of the operating system dependent module imported.  The
! following names have currently been registered: \code{'posix'}, \code{'nt'},
! \code{'dos'}, \code{'mac'}, \code{'os2'}, \code{'ce'}, \code{'java'}.
  \end{datadesc}
  
--- 60,70 ----
  attribute, \member{filename}, which is the file name passed to the
  function.
  \end{excdesc}
  
  \begin{datadesc}{name}
  The name of the operating system dependent module imported.  The
! following names have currently been registered: \code{'posix'},
! \code{'nt'}, \code{'dos'}, \code{'mac'}, \code{'os2'}, \code{'ce'},
! \code{'java'}, \code{'riscos'}.
  \end{datadesc}
  
***************
*** 746,792 ****
  \begin{funcdesc}{stat}{path}
  Perform a \cfunction{stat()} system call on the given path.  The
! return value is a tuple of at least 10 integers giving the most
! important (and portable) members of the \emph{stat} structure, in the
  order
! \code{st_mode},
! \code{st_ino},
! \code{st_dev},
! \code{st_nlink},
! \code{st_uid},
! \code{st_gid},
! \code{st_size},
! \code{st_atime},
! \code{st_mtime},
! \code{st_ctime}.
  More items may be added at the end by some implementations.  Note that
  on the Mac OS, the time values are floating point values, like all
  time values on the Mac OS.
  (On Windows, some items are filled with dummy values.)
  Availability: Macintosh, \UNIX, Windows.
  
! Note: The standard module \refmodule{stat}\refstmodindex{stat} defines
! functions and constants that are useful for extracting information
! from a \ctype{stat} structure.
  \end{funcdesc}
  
  \begin{funcdesc}{statvfs}{path}
  Perform a \cfunction{statvfs()} system call on the given path.  The
! return value is a tuple of 10 integers giving the most common
! members of the \ctype{statvfs} structure, in the order
! \code{f_bsize},
! \code{f_frsize},
! \code{f_blocks},
! \code{f_bfree},
! \code{f_bavail},
! \code{f_files},
! \code{f_ffree},
! \code{f_favail},
! \code{f_flag},
! \code{f_namemax}.
  Availability: \UNIX.
  
! Note: The standard module \module{statvfs}\refstmodindex{statvfs}
  defines constants that are useful for extracting information
! from a \ctype{statvfs} structure.
  \end{funcdesc}
  
--- 744,830 ----
  \begin{funcdesc}{stat}{path}
  Perform a \cfunction{stat()} system call on the given path.  The
! return value is an object whose attributes correspond to the members of
! the \ctype{stat} structure, namely:
! \member{st_mode} (protection bits),
! \member{st_ino} (inode number),
! \member{st_dev} (device),
! \member{st_nlink} (number of hard links,
! \member{st_uid} (user ID of owner),
! \member{st_gid} (group ID of owner),
! \member{st_size} (size of file, in bytes),
! \member{st_atime} (time of most recent access),
! \member{st_mtime} (time of most recent content modification),
! \member{st_ctime}
! (time of most recent content modification or metadata change).
! 
! On some Unix systems (such as Linux), the following attributes may
! also be available:
! \member{st_blocks} (number of blocks allocated for file),
! \member{st_blksize} (filesystem blocksize),
! \member{st_rdev} (type of device if an inode device).
! 
! On Mac OS systems, the following attributes may also be available:
! \member{st_rsize},
! \member{st_creator},
! \member{st_type}.
! 
! On RISCOS systems, the following attributes are also available:
! \member{st_ftype} (file type),
! \member{st_attrs} (attributes),
! \member{st_obtype} (object type).
! 
! For backward compatibility, the return value of \function{stat()} is
! also accessible as a tuple of at least 10 integers giving the most
! important (and portable) members of the \ctype{stat} structure, in the
  order
! \member{st_mode},
! \member{st_ino},
! \member{st_dev},
! \member{st_nlink},
! \member{st_uid},
! \member{st_gid},
! \member{st_size},
! \member{st_atime},
! \member{st_mtime},
! \member{st_ctime}.
  More items may be added at the end by some implementations.  Note that
  on the Mac OS, the time values are floating point values, like all
  time values on the Mac OS.
+ The standard module \refmodule{stat}\refstmodindex{stat} defines
+ functions and constants that are useful for extracting information
+ from a \ctype{stat} structure.
  (On Windows, some items are filled with dummy values.)
  Availability: Macintosh, \UNIX, Windows.
  
! \versionchanged
! [Added access to values as attributes of the returned object]{2.2}
  \end{funcdesc}
  
  \begin{funcdesc}{statvfs}{path}
  Perform a \cfunction{statvfs()} system call on the given path.  The
! return value is an object whose attributes describe the filesystem on
! the given path, and correspond to the members of the
! \ctype{statvfs} structure, namely:
! \member{f_frsize},
! \member{f_blocks},
! \member{f_bfree},
! \member{f_bavail},
! \member{f_files},
! \member{f_ffree},
! \member{f_favail},
! \member{f_flag},
! \member{f_namemax}.
  Availability: \UNIX.
  
! For backward compatibility, the return value is also accessible as a
! tuple whose values correspond to the attributes, in the order given above.
! The standard module \refmodule{statvfs}\refstmodindex{statvfs}
  defines constants that are useful for extracting information
! from a \ctype{statvfs} structure when accessing it as a sequence; this
! remains useful when writing code that needs to work with versions of
! Python that don't support accessing the fields as attributes.
! 
! \versionchanged
! [Added access to values as attributes of the returned object]{2.2}
  \end{funcdesc}
  
***************
*** 934,938 ****
  controlling terminal. Return a pair of \code{(\var{pid}, \var{fd})},
  where \var{pid} is \code{0} in the child, the new child's process id
! in the parent, and \code{fd} is the file descriptor of the master end
  of the pseudo-terminal.  For a more portable approach, use the
  \refmodule{pty} module.
--- 972,976 ----
  controlling terminal. Return a pair of \code{(\var{pid}, \var{fd})},
  where \var{pid} is \code{0} in the child, the new child's process id
! in the parent, and \var{fd} is the file descriptor of the master end
  of the pseudo-terminal.  For a more portable approach, use the
  \refmodule{pty} module.
***************
*** 1267,1272 ****
  
  \begin{datadesc}{defpath}
! The default search path used by \function{exec*p*()} if the environment
! doesn't have a \code{'PATH'} key.
  \end{datadesc}
  
--- 1305,1311 ----
  
  \begin{datadesc}{defpath}
! The default search path used by \function{exec*p*()} and
! \function{spawn*p*()} if the environment doesn't have a \code{'PATH'}
! key.
  \end{datadesc}
  
***************
*** 1274,1278 ****
  The string used to separate (or, rather, terminate) lines on the
  current platform.  This may be a single character, such as \code{'\e
! n'} for \POSIX{} or \code{'\e r'} for the Mac OS, or multiple characters,
  for example, \code{'\e r\e n'} for DOS and Windows.
  \end{datadesc}
--- 1313,1317 ----
  The string used to separate (or, rather, terminate) lines on the
  current platform.  This may be a single character, such as \code{'\e
! n'} for \POSIX{} or \code{'\e r'} for Mac OS, or multiple characters,
  for example, \code{'\e r\e n'} for DOS and Windows.
  \end{datadesc}