[Python-checkins] python/dist/src/Doc/lib libmmap.tex,1.8,1.9

[tim_one at users.sourceforge.net]

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

Modified Files:
	libmmap.tex 
Log Message:
SF 964876 mapping a 0 length file
Document that it can't be done on Windows.


Index: libmmap.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libmmap.tex,v
retrieving revision 1.8
retrieving revision 1.9
diff -C2 -d -r1.8 -r1.9
*** libmmap.tex	3 Dec 2001 18:27:22 -0000	1.8
--- libmmap.tex	6 Jun 2004 16:51:46 -0000	1.9
***************
*** 43,50 ****
    \strong{(Windows version)} Maps \var{length} bytes from the file
    specified by the file handle \var{fileno}, and returns a mmap
!   object.  If \var{length} is \code{0}, the maximum length of the map
!   will be the current size of the file when \function{mmap()} is
!   called.
!   
    \var{tagname}, if specified and not \code{None}, is a string giving
    a tag name for the mapping.  Windows allows you to have many
--- 43,52 ----
    \strong{(Windows version)} Maps \var{length} bytes from the file
    specified by the file handle \var{fileno}, and returns a mmap
!   object.  If \var{length} is larger than the current size of the file,
!   the file is extended to contain \var{length} bytes.  If \var{length}
!   is \code{0}, the maximum length of the map is the current size
!   of the file, except that if the file is empty Windows raises an
!   exception (you cannot create an empty mapping on Windows).
! 
    \var{tagname}, if specified and not \code{None}, is a string giving
    a tag name for the mapping.  Windows allows you to have many
***************
*** 62,66 ****
    specified by the file descriptor \var{fileno}, and returns a mmap
    object.
!   
    \var{flags} specifies the nature of the mapping.
    \constant{MAP_PRIVATE} creates a private copy-on-write mapping, so
--- 64,68 ----
    specified by the file descriptor \var{fileno}, and returns a mmap
    object.
! 
    \var{flags} specifies the nature of the mapping.
    \constant{MAP_PRIVATE} creates a private copy-on-write mapping, so
***************
*** 69,78 ****
    with all other processes mapping the same areas of the file.  The
    default value is \constant{MAP_SHARED}.
!   
    \var{prot}, if specified, gives the desired memory protection; the
    two most useful values are \constant{PROT_READ} and
    \constant{PROT_WRITE}, to specify that the pages may be read or
    written.  \var{prot} defaults to \constant{PROT_READ | PROT_WRITE}.
!   
    \var{access} may be specified in lieu of \var{flags} and \var{prot}
    as an optional keyword parameter.  It is an error to specify both
--- 71,80 ----
    with all other processes mapping the same areas of the file.  The
    default value is \constant{MAP_SHARED}.
! 
    \var{prot}, if specified, gives the desired memory protection; the
    two most useful values are \constant{PROT_READ} and
    \constant{PROT_WRITE}, to specify that the pages may be read or
    written.  \var{prot} defaults to \constant{PROT_READ | PROT_WRITE}.
! 
    \var{access} may be specified in lieu of \var{flags} and \var{prot}
    as an optional keyword parameter.  It is an error to specify both
***************
*** 124,128 ****
  
  \begin{methoddesc}{readline}{}
!   Returns a single line, starting at the current file position and up to 
    the next newline.
  \end{methoddesc}
--- 126,130 ----
  
  \begin{methoddesc}{readline}{}
!   Returns a single line, starting at the current file position and up to
    the next newline.
  \end{methoddesc}