Date: Thu, 7 Nov 1996 09:54:52 +0100 (MET)
From: Robert Hoehne <robert DOT hoehne AT mathematik DOT tu-chemnitz DOT de>
To: DJGPP workers <djgpp-workers AT delorie DOT com>
Subject: Some minor updates to the docs
Message-Id: <Pine.HPP.3.95.961107095053.1695B-100000@newton.mathematik.tu-chemnitz.de>
Mime-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII

During the make of the patch for dbgcom.c I checked the
docs and found, that the description for _open() and
_dos_open() (and also the low level file io functions)
have the same description, that they are the direct
connection to the DOS calls are. Because that's not correct
und the user may be confused I have added some text to the
docs.

Robert

*** src/libc/dos/io/_close.tx~	Mon Jul 10 01:40:14 1995
--- src/libc/dos/io/_close.txh	Tue Nov  5 16:56:30 1996
***************
*** 10,16 ****
  @subheading Description
  
  This is a direct connection to the MS-DOS close function call, int
! 0x21, %ah = 0x3e.
  
  @subheading Return Value
  
--- 10,18 ----
  @subheading Description
  
  This is a direct connection to the MS-DOS close function call, int
! 0x21, %ah = 0x3e. This function can be hooked by the
! @xref{File System Extensions}. If you don't want this, you should
! use @xref{_dos_close}.
  
  @subheading Return Value
  
*** src/libc/dos/io/_creat.tx~	Mon Jul 10 01:40:16 1995
--- src/libc/dos/io/_creat.txh	Tue Nov  5 16:47:04 1996
***************
*** 10,16 ****
  @subheading Description
  
  This is a direct connection to the MS-DOS creat function call, int
! 0x21, %ah = 0x3c.  The file is set to binary mode.
  
  @subheading Return Value
  
--- 10,18 ----
  @subheading Description
  
  This is a direct connection to the MS-DOS creat function call, int
! 0x21, %ah = 0x3c.  The file is set to binary mode. This function can
! be hooked by the @xref{File System Extensions}. If you don't want this
! you should use @xref{_dos_creat} or @xref{_dos_creatnew}.
  
  @subheading Return Value
  
*** src/libc/dos/io/_open.tx~	Mon Jul 10 01:40:16 1995
--- src/libc/dos/io/_open.txh	Tue Nov  5 16:47:58 1996
***************
*** 10,16 ****
  @subheading Description
  
  This is a direct connection to the MS-DOS open function call, int
! 0x21, %ah = 0x3d.  The file is set to binary mode.
  
  @subheading Return Value
  
--- 10,18 ----
  @subheading Description
  
  This is a direct connection to the MS-DOS open function call, int
! 0x21, %ah = 0x3d.  The file is set to binary mode. This function
! can be hooked by the @xref{File System Extensions}. If don't want
! this you should use @xref{_dos_open}.
  
  @subheading Return Value
  
*** src/libc/dos/io/_read.tx~	Mon Jul 10 01:40:16 1995
--- src/libc/dos/io/_read.txh	Tue Nov  5 16:49:22 1996
***************
*** 11,17 ****
  
  This is a direct connection to the MS-DOS read function call, int
  0x21, %ah = 0x3f.  No conversion is done on the data; it is read as
! raw binary data.
  
  @subheading Return Value
  
--- 11,19 ----
  
  This is a direct connection to the MS-DOS read function call, int
  0x21, %ah = 0x3f.  No conversion is done on the data; it is read as
! raw binary data. This function can be hooked by the
! @xref{File System Extensions}. If you don't want this, you should
! use @xref{_dos_read}.
  
  @subheading Return Value
  
*** src/libc/dos/io/_write.tx~	Mon Jul 10 01:40:16 1995
--- src/libc/dos/io/_write.txh	Tue Nov  5 16:50:34 1996
***************
*** 11,17 ****
  
  This is a direct connection to the MS-DOS write function call, int
  0x21, %ah = 0x40.  No conversion is done on the data; it is written as
! raw binary data.
  
  @subheading Return Value
  
--- 11,19 ----
  
  This is a direct connection to the MS-DOS write function call, int
  0x21, %ah = 0x40.  No conversion is done on the data; it is written as
! raw binary data. This function can be hooked by the
! @xref{File System Extensions}. If you don't want this, you should use
! @xref{_dos_write}.
  
  @subheading Return Value