www.delorie.com/archives/browse.cgi   search  
Mail Archives: djgpp-workers/2000/10/03/18:09:25

Sender: rich AT phekda DOT freeserve DOT co DOT uk
Message-ID: <39DA5498.7648334C@phekda.freeserve.co.uk>
Date: Tue, 03 Oct 2000 22:50:16 +0100
From: Richard Dawe <rich AT phekda DOT freeserve DOT co DOT uk>
X-Mailer: Mozilla 4.51 [en] (X11; I; Linux 2.2.14 i586)
X-Accept-Language: de,fr
MIME-Version: 1.0
To: Eli Zaretskii <eliz AT is DOT elta DOT co DOT il>
CC: DJGPP workers <djgpp-workers AT delorie DOT com>
Subject: Re: Doc for __dosexec_find_on_path()
References: <Pine DOT SUN DOT 3 DOT 91 DOT 1000903081819 DOT 24880H-100000 AT is>
Reply-To: djgpp-workers AT delorie DOT com

This is a multi-part message in MIME format.
--------------B25DE0E216469E58A0B18B3E
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit

Hello.

Eli Zaretskii wrote:
> 
> On Sat, 2 Sep 2000, Richard Dawe wrote:
> 
> > I also broke the the spawn*() declarations across two lines,
> > rather than relying on automatic breaks.
> 
> There's no automatic line breaks inside @example.  So breaking long
> lines by hand is a Good Thing.

I've written a Perl script to detect when @example/@end example and
@smallexample/@end smallexample sections exceed their respective maximum
line lengths (72 and 74 from a previous mail of yours). The script is
attached. Run it on all the DJGPP sources like so:

    cd /djgpp/top/level/directory
    txh-check-line.pl `find . -name '*.txh'`

It will then report which lines are excessively long.

> In fact, most of the library's .txh files need to be fixed like that:
> many Description sections overflow the page margins when a printable
> version of the reference is produced.  I think that every @example in
> the Description section should be replaced with @smallexample (with a
> suitable change to "@end example"), and then the lines which are longer
> than 60 characters should be broken into multiple lines.

I didn't change @example -> @smallexample, but I did fix the overly long
lines. A large (~55K) diff is attached. If this is too big, please tell me
and I'll split it up.

> Alternatively, we could change mkdoc.cc to do that automatically for us;
> but I'm not sure how ugly will the automatic line breaks look.

I don't think that would be a very pretty option. My script is quick to
run, so we can check frequently/before release if anything is broken.

> > Don't we need an interpreter line for '.cmd' using
> > __dosexec_command_exec()? I've probably misunderstood the point of
> > this table.

It's been a while, but thanks for your explanation of how
__dosexec_command_exec() works.

Thanks, bye, Rich =]

-- 
Richard Dawe
[ mailto:richdawe AT bigfoot DOT com | http://www.bigfoot.com/~richdawe/ ]
--------------B25DE0E216469E58A0B18B3E
Content-Type: application/x-perl;
 name="txh-check-line.pl"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline;
 filename="txh-check-line.pl"

#! /usr/bin/perl -w
#
# txh-check-line.pl
# Written by Richard Dawe <richdawe AT bigfoot DOT com>
#
# Check the line lengths in @example/@end example and
# @smallexample/@end smallexample blocks. Generate warning messages when
# lines need breaking.
#

use strict;
no strict 'vars';
use FileHandle;

# Maximum line lengths
$MAXLINE_NORMAL = 72;
$MAXLINE_SMALL  = 74; # NB: Eli wasn't quite sure about this number.

# Inside example or smallexample
$INSIDE_NONE   = 0;
$INSIDE_NORMAL = 1;
$INSIDE_SMALL  = 2;

foreach $file (@ARGV) {
    # Get the file contents
    $fh = new FileHandle('<'.$file);
    if (! defined($fh)) {
	# Skip files we can't open
	print $file.": Unable to open - skipping\n";
	next;
    }
    @lines = $fh->getlines();   
    $fh->close();

    for ($inside = $INSIDE_NONE, $i = 0; $i < $#lines; $i++) {
	$line = $lines[$i];
	chomp($line);

	if ($inside == $INSIDE_NONE) {
	    # Start of block?
	    if ($line =~ m/^\@example\s*$/) {
		$inside = $INSIDE_NORMAL;
	    } elsif ($line =~ m/^\@smallexample\s*$/) {
		$inside = $INSIDE_SMALL;
	    }
	} elsif ($inside == $INSIDE_NORMAL) {
	    if ($line =~ m/^\@end example\s*$/) {
		# End of block
		$inside = $INSIDE_NONE;		
	    } else {
		# Check line length
		if (length($line) > $MAXLINE_NORMAL) {
		    print  $file.': Line '.($i + 1).' is longer than '
			  .$MAXLINE_NORMAL." characters\n";
		}
	    }
	} elsif ($inside == $INSIDE_SMALL) {
	    if ($line =~ m/^\@end smallexample\s*$/) {
		# End of block
		$inside = $INSIDE_NONE;		
	    } else {
		# Check line length
		if (length($line) > $MAXLINE_SMALL) {
		    print  $file.': Line '.($i + 1).' is longer than '
			  .$MAXLINE_SMALL." characters\n";
		}
	    }
	}
    }
}

--------------B25DE0E216469E58A0B18B3E
Content-Type: text/plain; charset=us-ascii;
 name="diffs"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline;
 filename="diffs"

*** src/libc/ansi/stdio/fopen.txh	Sun Sep 27 16:20:44 1998
--- /home/rich/src/djgpp-toolong/src/libc/ansi/stdio/fopen.txh	Tue Oct  3 21:01:30 2000
***************
*** 83,88 ****
  @subheading Example
  
  @example
! FILE *f = fopen("foo", "rb+"); /* open existing file for read/write, binary mode */
  @end example
  
--- 83,89 ----
  @subheading Example
  
  @example
! FILE *f = fopen("foo", "rb+"); /* open existing file for read/write,
!                                 * binary mode */
  @end example
  
*** src/libc/bios/b_com.txh	Sun Sep 27 16:21:00 1998
--- /home/rich/src/djgpp-toolong/src/libc/bios/b_com.txh	Tue Oct  3 21:02:00 2000
***************
*** 4,10 ****
  @example
  #include <bios.h>
  
! unsigned _bios_serialcom(unsigned cmd, unsingned serialport, unsigned data);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <bios.h>
  
! unsigned _bios_serialcom(unsigned cmd, unsingned serialport,
!                          unsigned data);
  @end example
  
  @subheading Description
***************
*** 110,116 ****
  
  @example
  /* 9600 baud, no parity, one stop, 8 bits */
! _bios_serialcom(_COM_INIT, 0, _COM_9600|_COM_NOPARITY|_COM_STOP1|_COM_CHR8);
  for(i=0; buf[i]; i++)
    _bios_serialcom(_COM_SEND, 0, buf[i]);
  @end example
--- 111,118 ----
  
  @example
  /* 9600 baud, no parity, one stop, 8 bits */
! _bios_serialcom(_COM_INIT, 0,
!                 _COM_9600|_COM_NOPARITY|_COM_STOP1|_COM_CHR8);
  for(i=0; buf[i]; i++)
    _bios_serialcom(_COM_SEND, 0, buf[i]);
  @end example
*** src/libc/bios/biosequi.txh	Sun Sep 27 16:21:02 1998
--- /home/rich/src/djgpp-toolong/src/libc/bios/biosequi.txh	Tue Oct  3 22:31:23 2000
***************
*** 18,24 ****
  
  ---- ---- ---- ---X  1 = disk drive(s) installed
  ---- ---- ---- --X-  1 = math coprocessor installed
! ---- ---- ---- XX--  System memory 00=16k 01=32k 10=48k 11=64k (non PS/2)
  ---- ---- ---- -X--  1 = pointing device installed (PS/2)
  ---- ---- ---- X---  not used on PS/2
  ---- ---- --XX ----  initial video mode: 01=CO40 10=CO80 11=MONO
--- 18,25 ----
  
  ---- ---- ---- ---X  1 = disk drive(s) installed
  ---- ---- ---- --X-  1 = math coprocessor installed
! ---- ---- ---- XX--  System memory: 00=16k, 01=32k, 10=48k,
!                                     11=64k (non PS/2)
  ---- ---- ---- -X--  1 = pointing device installed (PS/2)
  ---- ---- ---- X---  not used on PS/2
  ---- ---- --XX ----  initial video mode: 01=CO40 10=CO80 11=MONO
*** src/libc/compat/ioctl/ioctl.txh	Mon Jun 29 00:12:40 1998
--- /home/rich/src/djgpp-toolong/src/libc/compat/ioctl/ioctl.txh	Tue Oct  3 22:31:37 2000
***************
*** 119,125 ****
  between retries, the second number of retries.  An example:
  
  @example
!  int ret_val = ioctl (fd, DOS_SETRETRY, pause_between_retries, max_retries);
  @end example
  
  @item DOS_GENCHARREQ
--- 119,126 ----
  between retries, the second number of retries.  An example:
  
  @example
!  int ret_val = ioctl (fd, DOS_SETRETRY, pause_between_retries,
!                       max_retries);
  @end example
  
  @item DOS_GENCHARREQ
***************
*** 127,133 ****
  
  @example
   int ret_val = ioctl (fd, DOS_GENCHARREQ, category_and_function,
!                       &param_block, si_value, di_value, param_block_size);
  @end example
  
  Refer to Ralf Brown's Interrupt List for the details about each function
--- 128,135 ----
  
  @example
   int ret_val = ioctl (fd, DOS_GENCHARREQ, category_and_function,
!                       &param_block, si_value, di_value,
!                       param_block_size);
  @end example
  
  Refer to Ralf Brown's Interrupt List for the details about each function
***************
*** 138,144 ****
  
  @example
   int ret_val = ioctl (drive_no, DOS_GENBLKREQ, category_and_function,
!                       &param_block, si_value, di_value, param_block_size);
  @end example
  
  Note that instead of the handle, the first argument is the disk drive
--- 140,147 ----
  
  @example
   int ret_val = ioctl (drive_no, DOS_GENBLKREQ, category_and_function,
!                       &param_block, si_value, di_value,
!                       param_block_size);
  @end example
  
  Note that instead of the handle, the first argument is the disk drive
*** src/libc/compat/mman/mprotect.txh	Sun Sep 27 16:21:06 1998
--- /home/rich/src/djgpp-toolong/src/libc/compat/mman/mprotect.txh	Tue Oct  3 22:38:32 2000
***************
*** 37,42 ****
  @example
  mprotect(readonly_buffer,8192,PROT_READ);
  mprotect(guard_area,4096,PROT_NONE);
! mprotect(NULL,4096,PROT_WRITE);	/* Let NULL pointers not generate exceptions */
  @end example
  
--- 37,43 ----
  @example
  mprotect(readonly_buffer,8192,PROT_READ);
  mprotect(guard_area,4096,PROT_NONE);
! mprotect(NULL,4096,PROT_WRITE); /* Let NULL pointers not generate
!                                  * exceptions */
  @end example
  
*** src/libc/compat/stdlib/itoa.txh	Sun Sep 27 16:21:08 1998
--- /home/rich/src/djgpp-toolong/src/libc/compat/stdlib/itoa.txh	Tue Oct  3 21:06:04 2000
***************
*** 42,48 ****
  @example
  #include <stdlib.h>
  
! char * ecvtbuf (double value, int ndigits, int *decpt, int *sign, char *buf)
  @end example
  
  @subheading Description
--- 42,49 ----
  @example
  #include <stdlib.h>
  
! char * ecvtbuf (double value, int ndigits, int *decpt, int *sign,
!                 char *buf)
  @end example
  
  @subheading Description
***************
*** 128,134 ****
  @example
  #include <stdlib.h>
  
! char * fcvtbuf (double value, int ndigits, int *decpt, int *sign, char *buf)
  @end example
  
  @subheading Description
--- 129,136 ----
  @example
  #include <stdlib.h>
  
! char * fcvtbuf (double value, int ndigits, int *decpt, int *sign,
!                 char *buf)
  @end example
  
  @subheading Description
*** src/libc/compat/time/select.txh	Tue Jan 25 19:37:14 2000
--- /home/rich/src/djgpp-toolong/src/libc/compat/time/select.txh	Tue Oct  3 21:06:31 2000
***************
*** 123,129 ****
          @}
        else
          fprintf(stderr,
!                 "%d: %s ready for input\n", i, select_result ? "" : "NOT");
        FD_ZERO (&write_fds);
        FD_SET (i, &write_fds);
        select_result = select (i + 1, 0, &write_fds, 0, &timeout);
--- 123,130 ----
          @}
        else
          fprintf(stderr,
!                 "%d: %s ready for input\n", i,
!                 select_result ? "" : "NOT");
        FD_ZERO (&write_fds);
        FD_SET (i, &write_fds);
        select_result = select (i + 1, 0, &write_fds, 0, &timeout);
***************
*** 134,140 ****
          @}
        else
          fprintf(stderr,
!                 "%d: %s ready for output\n", i, select_result ? "" : "NOT");
      @}
  @end example
  
--- 135,142 ----
          @}
        else
          fprintf(stderr,
!                 "%d: %s ready for output\n", i,
!                 select_result ? "" : "NOT");
      @}
  @end example
  
*** src/libc/compat/unistd/llseek.txh	Mon Jun 19 19:00:56 2000
--- /home/rich/src/djgpp-toolong/src/libc/compat/unistd/llseek.txh	Tue Oct  3 21:06:53 2000
***************
*** 58,64 ****
  @example
  long long ret;
  
! ret = llseek(fd, (1<<32), SEEK_SET); /* Now ret equals 0 (unfortunately). */
  ret = llseek(fd, -1, SEEK_CUR); /* Now ret equals 2^32-1 (good!). */
  ret = llseek(fd, 0, SEEK_SET); /* Now ret equals 0 (good!). */
  ret = llseek(fd, -1, SEEK_CUR); /* Now ret equals 2^32-1 (bad). */
--- 58,65 ----
  @example
  long long ret;
  
! ret = llseek(fd, (1<<32), SEEK_SET); /* Now ret equals 0
!                                       * (unfortunately). */
  ret = llseek(fd, -1, SEEK_CUR); /* Now ret equals 2^32-1 (good!). */
  ret = llseek(fd, 0, SEEK_SET); /* Now ret equals 0 (good!). */
  ret = llseek(fd, -1, SEEK_CUR); /* Now ret equals 2^32-1 (bad). */
*** src/libc/compat/unistd/_irdlink.txh	Sun Aug 20 16:46:38 2000
--- /home/rich/src/djgpp-toolong/src/libc/compat/unistd/_irdlink.txh	Tue Oct  3 21:07:26 2000
***************
*** 4,10 ****
  @example
  #include <libc/symlink.h>
  
! int __internal_readlink(const char * path, int fhandle, char * buf, size_t max)
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <libc/symlink.h>
  
! int __internal_readlink(const char * path, int fhandle,
!                         char * buf, size_t max)
  @end example
  
  @subheading Description
***************
*** 31,37 ****
  
  @example
  char buf[FILENAME_MAX + 1];
! if (__internal_readlink(0, "/dev/env/DJDIR/bin/sh.exe", buf, FILENAME_MAX) == -1)
     if (errno == EINVAL)
        puts("/dev/env/DJDIR/bin/sh.exe is not a symbolic link.");
  @end example
--- 32,39 ----
  
  @example
  char buf[FILENAME_MAX + 1];
! if (__internal_readlink(0, "/dev/env/DJDIR/bin/sh.exe",
!                         buf, FILENAME_MAX) == -1)
     if (errno == EINVAL)
        puts("/dev/env/DJDIR/bin/sh.exe is not a symbolic link.");
  @end example
*** src/libc/dos/compat/d_creat.txh	Tue Jan 25 19:37:15 2000
--- /home/rich/src/djgpp-toolong/src/libc/dos/compat/d_creat.txh	Tue Oct  3 22:05:28 2000
***************
*** 4,10 ****
  @example
  #include <dos.h>
  
! unsigned int _dos_creat(const char *filename, unsigned short attr, int *handle);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <dos.h>
  
! unsigned int _dos_creat(const char *filename, unsigned short attr,
!                         int *handle);
  @end example
  
  @subheading Description
*** src/libc/dos/compat/d_creatn.txh	Tue Jan 25 19:37:15 2000
--- /home/rich/src/djgpp-toolong/src/libc/dos/compat/d_creatn.txh	Tue Oct  3 22:05:39 2000
***************
*** 4,10 ****
  @example
  #include <dos.h>
  
! unsigned int _dos_creatnew(const char *filename, unsigned short attr, int *handle);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <dos.h>
  
! unsigned int _dos_creatnew(const char *filename, unsigned short attr,
!                            int *handle);
  @end example
  
  @subheading Description
*** src/libc/dos/compat/d_getfa.txh	Sun Sep 27 16:21:20 1998
--- /home/rich/src/djgpp-toolong/src/libc/dos/compat/d_getfa.txh	Tue Oct  3 22:05:51 2000
***************
*** 4,10 ****
  @example
  #include <dos.h>
  
! unsigned int _dos_getfileattr(const char *filename, unsigned int *p_attr);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <dos.h>
  
! unsigned int _dos_getfileattr(const char *filename,
!                               unsigned int *p_attr);
  @end example
  
  @subheading Description
*** src/libc/dos/compat/d_getftm.txh	Sun Nov 15 14:19:28 1998
--- /home/rich/src/djgpp-toolong/src/libc/dos/compat/d_getftm.txh	Tue Oct  3 22:06:04 2000
***************
*** 4,10 ****
  @example
  #include <dos.h>
  
! unsigned int _dos_getftime(int handle, unsigned int *p_date, unsigned *p_time);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <dos.h>
  
! unsigned int _dos_getftime(int handle,
!                            unsigned int *p_date, unsigned *p_time);
  @end example
  
  @subheading Description
*** src/libc/dos/compat/d_open.txh	Tue Jan 25 19:37:15 2000
--- /home/rich/src/djgpp-toolong/src/libc/dos/compat/d_open.txh	Tue Oct  3 22:06:17 2000
***************
*** 6,12 ****
  #include <share.h>
  #include <dos.h>
  
! unsigned int _dos_open(const char *filename, unsigned short mode, int *handle);
  @end example
  
  @subheading Description
--- 6,13 ----
  #include <share.h>
  #include <dos.h>
  
! unsigned int _dos_open(const char *filename, unsigned short mode,
!                        int *handle);
  @end example
  
  @subheading Description
*** src/libc/dos/compat/d_read.txh	Tue Jan 25 19:37:15 2000
--- /home/rich/src/djgpp-toolong/src/libc/dos/compat/d_read.txh	Tue Oct  3 22:06:27 2000
***************
*** 4,10 ****
  @example
  #include <dos.h>
  
! unsigned int _dos_read(int handle, void *buffer, unsigned int count, unsigned int *result);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <dos.h>
  
! unsigned int _dos_read(int handle, void *buffer, unsigned int count,
!                        unsigned int *result);
  @end example
  
  @subheading Description
*** src/libc/dos/compat/d_setftm.txh	Sun Sep 27 16:21:22 1998
--- /home/rich/src/djgpp-toolong/src/libc/dos/compat/d_setftm.txh	Tue Oct  3 22:06:41 2000
***************
*** 4,10 ****
  @example
  #include <dos.h>
  
! unsigned int _dos_setftime(int handle, unsigned int date, unsigned time);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <dos.h>
  
! unsigned int _dos_setftime(int handle,
!                            unsigned int date, unsigned time);
  @end example
  
  @subheading Description
*** src/libc/dos/compat/d_write.txh	Tue Jan 25 19:37:15 2000
--- /home/rich/src/djgpp-toolong/src/libc/dos/compat/d_write.txh	Tue Oct  3 22:31:57 2000
***************
*** 4,10 ****
  @example
  #include <dos.h>
  
! unsigned int _dos_write(int handle, const void *buffer, unsigned int count,
                          unsigned int *result);
  @end example
  
--- 4,11 ----
  @example
  #include <dos.h>
  
! unsigned int _dos_write(int handle,
!                         const void *buffer, unsigned int count,
                          unsigned int *result);
  @end example
  
*** src/libc/dos/dir/ftreewlk.txh	Tue Jan 25 19:37:15 2000
--- /home/rich/src/djgpp-toolong/src/libc/dos/dir/ftreewlk.txh	Tue Oct  3 22:07:13 2000
***************
*** 5,11 ****
  #include <dir.h>
  
  int __file_tree_walk(const char *dir, 
!                    int (*func)(const char *path, const struct ffblk *ff));
  @end example
  
  @subheading Description
--- 5,12 ----
  #include <dir.h>
  
  int __file_tree_walk(const char *dir, 
!                      int (*func)(const char *path,
!                                  const struct ffblk *ff));
  @end example
  
  @subheading Description
*** src/libc/dos/dos/bdos.txh	Tue Jan 25 19:37:16 2000
--- /home/rich/src/djgpp-toolong/src/libc/dos/dos/bdos.txh	Tue Oct  3 22:07:38 2000
***************
*** 261,267 ****
  @example
  #include <dos.h>
  
! int int86x(int ivec, union REGS *in, union REGS *out, struct SREGS *seg);
  @end example
  
  @subheading Description
--- 261,268 ----
  @example
  #include <dos.h>
  
! int int86x(int ivec, union REGS *in, union REGS *out,
!            struct SREGS *seg);
  @end example
  
  @subheading Description
***************
*** 299,305 ****
  @example
  #include <dos.h>
  
! int int386x(int ivec, union REGS *in, union REGS *out, struct SREGS *seg);
  @end example
  
  @subheading Description
--- 300,307 ----
  @example
  #include <dos.h>
  
! int int386x(int ivec, union REGS *in, union REGS *out,
!             struct SREGS *seg);
  @end example
  
  @subheading Description
*** src/libc/dos/sys/timeb/ftime.txh	Sun Sep 27 16:21:36 1998
--- /home/rich/src/djgpp-toolong/src/libc/dos/sys/timeb/ftime.txh	Tue Oct  3 22:32:11 2000
***************
*** 17,23 ****
  struct timeb @{
    time_t         time;     /* seconds since 00:00:00 GMT 1/1/1970 */
    unsigned short millitm;  /* milliseconds */
!   short          timezone; /* difference between GMT and local, minutes */
    short          dstflag;  /* set if daylight savings time in affect */
  @};
  @end example
--- 17,24 ----
  struct timeb @{
    time_t         time;     /* seconds since 00:00:00 GMT 1/1/1970 */
    unsigned short millitm;  /* milliseconds */
!   short          timezone; /* difference between GMT and local,
!                             * minutes */
    short          dstflag;  /* set if daylight savings time in affect */
  @};
  @end example
*** src/libc/dpmi/api/d0006.txh	Sun Sep 27 16:21:36 1998
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0006.txh	Tue Oct  3 22:08:13 2000
***************
*** 4,10 ****
  @example
  #include <dpmi.h>
  
! int __dpmi_get_segment_base_address(int _selector, unsigned long *_addr);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <dpmi.h>
  
! int __dpmi_get_segment_base_address(int _selector,
!                                     unsigned long *_addr);
  @end example
  
  @subheading Description
*** src/libc/dpmi/api/d0009.txh	Tue Jan 25 19:37:17 2000
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0009.txh	Tue Oct  3 22:09:07 2000
***************
*** 23,29 ****
  @example
  ---- ---- ---- ---X = 0=not accessed, 1=accessed
  ---- ---- ---- --X- = data: 0=read, 1=r/w; code: 1=readable
! ---- ---- ---- -X-- = data: 0=expand-up, 1=expand-down; code: 0=non-conforming
  ---- ---- ---- X--- = 0=data, 1=code
  ---- ---- ---1 ---- = must be 1
  ---- ---- -XX- ---- = priviledge level (must equal CPL)
--- 23,30 ----
  @example
  ---- ---- ---- ---X = 0=not accessed, 1=accessed
  ---- ---- ---- --X- = data: 0=read, 1=r/w; code: 1=readable
! ---- ---- ---- -X-- = data: 0=expand-up, 1=expand-down; 
!                       code: 0=non-conforming
  ---- ---- ---- X--- = 0=data, 1=code
  ---- ---- ---1 ---- = must be 1
  ---- ---- -XX- ---- = priviledge level (must equal CPL)
*** src/libc/dpmi/api/d0100.txh	Sun Sep 27 16:21:38 1998
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0100.txh	Tue Oct  3 22:09:46 2000
***************
*** 4,10 ****
  @example
  #include <dpmi.h>
  
! int __dpmi_allocate_dos_memory(int _paragraphs, int *_ret_selector_or_max);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <dpmi.h>
  
! int __dpmi_allocate_dos_memory(int _paragraphs,
!                                int *_ret_selector_or_max);
  @end example
  
  @subheading Description
*** src/libc/dpmi/api/d0102.txh	Sun Sep 27 16:21:40 1998
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0102.txh	Tue Oct  3 22:09:58 2000
***************
*** 4,10 ****
  @example
  #include <dpmi.h>
  
! int __dpmi_resize_dos_memory(int _selector, int _newpara, int *_ret_max);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <dpmi.h>
  
! int __dpmi_resize_dos_memory(int _selector, int _newpara,
!                              int *_ret_max);
  @end example
  
  @subheading Description
*** src/libc/dpmi/api/d0200.txh	Sun Sep 27 16:21:40 1998
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0200.txh	Tue Oct  3 22:10:09 2000
***************
*** 4,10 ****
  @example
  #include <dpmi.h>
  
! int __dpmi_get_real_mode_interrupt_vector(int _vector, __dpmi_raddr *_address);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <dpmi.h>
  
! int __dpmi_get_real_mode_interrupt_vector(int _vector,
!                                           __dpmi_raddr *_address);
  @end example
  
  @subheading Description
*** src/libc/dpmi/api/d0201.txh	Sun Sep 27 16:21:40 1998
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0201.txh	Tue Oct  3 22:10:20 2000
***************
*** 4,10 ****
  @example
  #include <dpmi.h>
  
! int __dpmi_set_real_mode_interrupt_vector(int _vector, __dpmi_raddr *_address);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <dpmi.h>
  
! int __dpmi_set_real_mode_interrupt_vector(int _vector,
!                                           __dpmi_raddr *_address);
  @end example
  
  @subheading Description
*** src/libc/dpmi/api/d0202.txh	Sun Mar 21 01:38:29 1999
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0202.txh	Tue Oct  3 22:32:33 2000
***************
*** 4,10 ****
  @example
  #include <dpmi.h>
  
! int __dpmi_get_processor_exception_handler_vector(int _vector, __dpmi_paddr *_address);
  @end example
  
  @subheading Description
--- 4,12 ----
  @example
  #include <dpmi.h>
  
! int __dpmi_get_processor_exception_handler_vector(
!         int _vector, __dpmi_paddr *_address
! );
  @end example
  
  @subheading Description
*** src/libc/dpmi/api/d0203.txh	Sun Sep 27 16:21:40 1998
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0203.txh	Tue Oct  3 22:32:44 2000
***************
*** 4,10 ****
  @example
  #include <dpmi.h>
  
! int __dpmi_set_processor_exception_handler_vector(int _vector, __dpmi_paddr *_address);
  @end example
  
  @subheading Description
--- 4,12 ----
  @example
  #include <dpmi.h>
  
! int __dpmi_set_processor_exception_handler_vector(
!         int _vector, __dpmi_paddr *_address
! );
  @end example
  
  @subheading Description
*** src/libc/dpmi/api/d0204.txh	Sun Sep 27 16:21:40 1998
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0204.txh	Tue Oct  3 22:11:46 2000
***************
*** 4,10 ****
  @example
  #include <dpmi.h>
  
! int __dpmi_get_protected_mode_interrupt_vector(int _vector, __dpmi_paddr *_address);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <dpmi.h>
  
! int __dpmi_get_protected_mode_interrupt_vector(int _vector,
!                                                __dpmi_paddr *_address);
  @end example
  
  @subheading Description
*** src/libc/dpmi/api/d0205.txh	Sun Sep 27 16:21:42 1998
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0205.txh	Tue Oct  3 22:11:57 2000
***************
*** 4,10 ****
  @example
  #include <dpmi.h>
  
! int __dpmi_set_protected_mode_interrupt_vector(int _vector, __dpmi_paddr *_address);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <dpmi.h>
  
! int __dpmi_set_protected_mode_interrupt_vector(int _vector,
!                                                __dpmi_paddr *_address);
  @end example
  
  @subheading Description
*** src/libc/dpmi/api/d0210.txh	Tue Jan 25 19:37:18 2000
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0210.txh	Tue Oct  3 22:32:58 2000
***************
*** 4,11 ****
  @smallexample
  #include <dpmi.h>
  
! int __dpmi_get_extended_exception_handler_vector_pm(int vector, 
!                                                     __dpmi_paddr *address);
  @end smallexample
  
  @subheading Description
--- 4,12 ----
  @smallexample
  #include <dpmi.h>
  
! int __dpmi_get_extended_exception_handler_vector_pm(
!         int vector, __dpmi_paddr *address
! );
  @end smallexample
  
  @subheading Description
*** src/libc/dpmi/api/d0211.txh	Tue Jan 25 19:37:18 2000
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0211.txh	Tue Oct  3 22:33:11 2000
***************
*** 4,11 ****
  @smallexample
  #include <dpmi.h>
  
! int __dpmi_get_extended_exception_handler_vector_rm(int vector, 
!                                                     __dpmi_paddr *address);
  @end smallexample
  
  @subheading Description
--- 4,12 ----
  @smallexample
  #include <dpmi.h>
  
! int __dpmi_get_extended_exception_handler_vector_rm(
!         int vector, __dpmi_paddr *address
! );
  @end smallexample
  
  @subheading Description
*** src/libc/dpmi/api/d0212.txh	Tue Jan 25 19:37:18 2000
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0212.txh	Tue Oct  3 22:33:24 2000
***************
*** 4,11 ****
  @smallexample
  #include <dpmi.h>
  
! int __dpmi_set_extended_exception_handler_vector_pm(int vector, 
!                                                     __dpmi_paddr *address);
  @end smallexample
  
  @subheading Description
--- 4,12 ----
  @smallexample
  #include <dpmi.h>
  
! int __dpmi_set_extended_exception_handler_vector_pm(
!         int vector, __dpmi_paddr *address
! );
  @end smallexample
  
  @subheading Description
*** src/libc/dpmi/api/d0213.txh	Tue Jan 25 19:37:18 2000
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0213.txh	Tue Oct  3 22:33:35 2000
***************
*** 4,11 ****
  @smallexample
  #include <dpmi.h>
  
! int __dpmi_set_extended_exception_handler_vector_rm(int vector, 
!                                                     __dpmi_paddr *address);
  @end smallexample
  
  @subheading Description
--- 4,12 ----
  @smallexample
  #include <dpmi.h>
  
! int __dpmi_set_extended_exception_handler_vector_rm(
!         int vector, __dpmi_paddr *address
! );
  @end smallexample
  
  @subheading Description
*** src/libc/dpmi/api/d0300.txh	Sun Sep 27 16:21:42 1998
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0300.txh	Tue Oct  3 22:12:43 2000
***************
*** 4,10 ****
  @example
  #include <dpmi.h>
  
! int __dpmi_simulate_real_mode_interrupt(int _vector, __dpmi_regs *_regs);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <dpmi.h>
  
! int __dpmi_simulate_real_mode_interrupt(int _vector,
!                                         __dpmi_regs *_regs);
  @end example
  
  @subheading Description
*** src/libc/dpmi/api/d0301_s.txh	Thu Jun 10 18:46:56 1999
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0301_s.txh	Tue Oct  3 22:13:21 2000
***************
*** 4,10 ****
  @example
  #include <dpmi.h>
  
! int __dpmi_simulate_real_mode_procedure_retf_stack(__dpmi_regs *_regs, int stack_words_to_copy, const void *stack_data);
  @end example
  
  @subheading Description
--- 4,13 ----
  @example
  #include <dpmi.h>
  
! int __dpmi_simulate_real_mode_procedure_retf_stack(
!         __dpmi_regs *_regs,
!         int stack_words_to_copy, const void *stack_data
! );
  @end example
  
  @subheading Description
*** src/libc/dpmi/api/d0303.txh	Sun Sep 27 16:21:44 1998
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0303.txh	Tue Oct  3 22:13:41 2000
***************
*** 4,10 ****
  @example
  #include <dpmi.h>
  
! int __dpmi_allocate_real_mode_callback(void (*_handler)(void), __dpmi_regs *_regs, __dpmi_raddr *_ret);
  @end example
  
  @subheading Description
--- 4,12 ----
  @example
  #include <dpmi.h>
  
! int __dpmi_allocate_real_mode_callback(void (*_handler)(void),
!                                        __dpmi_regs *_regs,
!                                        __dpmi_raddr *_ret);
  @end example
  
  @subheading Description
*** src/libc/dpmi/api/d0305.txh	Sun Sep 27 16:21:44 1998
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0305.txh	Tue Oct  3 22:13:56 2000
***************
*** 4,10 ****
  @example
  #include <dpmi.h>
  
! int __dpmi_get_state_save_restore_addr(__dpmi_raddr *_rm, __dpmi_paddr *_pm);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <dpmi.h>
  
! int __dpmi_get_state_save_restore_addr(__dpmi_raddr *_rm,
!                                        __dpmi_paddr *_pm);
  @end example
  
  @subheading Description
*** src/libc/dpmi/api/d0306.txh	Sun Sep 27 16:21:44 1998
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0306.txh	Tue Oct  3 22:14:05 2000
***************
*** 4,10 ****
  @example
  #include <dpmi.h>
  
! int __dpmi_get_raw_mode_switch_addr(__dpmi_raddr *_rm, __dpmi_paddr *_pm);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <dpmi.h>
  
! int __dpmi_get_raw_mode_switch_addr(__dpmi_raddr *_rm,
!                                     __dpmi_paddr *_pm);
  @end example
  
  @subheading Description
*** src/libc/dpmi/api/d0509.txh	Tue Jan 25 19:37:19 2000
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0509.txh	Tue Oct  3 22:33:47 2000
***************
*** 4,11 ****
  @smallexample
  #include <dpmi.h>
  
! int __dpmi_map_conventional_memory_in_memory_block(__dpmi_meminfo *info, 
!                                                    unsigned long physaddr);
  @end smallexample
  
  @subheading Description
--- 4,12 ----
  @smallexample
  #include <dpmi.h>
  
! int __dpmi_map_conventional_memory_in_memory_block(
!         __dpmi_meminfo *info, unsigned long physaddr
! );
  @end smallexample
  
  @subheading Description
*** src/libc/dpmi/api/d0a00.txh	Sun Sep 27 16:21:50 1998
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0a00.txh	Tue Oct  3 22:14:34 2000
***************
*** 4,10 ****
  @example
  #include <dpmi.h>
  
! int __dpmi_get_vendor_specific_api_entry_point(char *_id, __dpmi_paddr *_api);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <dpmi.h>
  
! int __dpmi_get_vendor_specific_api_entry_point(char *_id,
!                                                __dpmi_paddr *_api);
  @end example
  
  @subheading Description
*** src/libc/dpmi/api/d0b02.txh	Sun Sep 27 16:21:52 1998
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0b02.txh	Tue Oct  3 22:14:46 2000
***************
*** 4,10 ****
  @example
  #include <dpmi.h>
  
! int __dpmi_get_state_of_debug_watchpoint(unsigned long _handle, int *_status);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <dpmi.h>
  
! int __dpmi_get_state_of_debug_watchpoint(unsigned long _handle,
!                                          int *_status);
  @end example
  
  @subheading Description
*** src/libc/dpmi/api/d0c00.txh	Tue Jan 25 19:37:19 2000
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/api/d0c00.txh	Tue Oct  3 22:34:00 2000
***************
*** 4,11 ****
  @smallexample
  #include <dpmi.h>
  
! int 
! __dpmi_install_resident_service_provider_callback(__dpmi_callback_info *info);
  @end smallexample
  
  @subheading Description
--- 4,12 ----
  @smallexample
  #include <dpmi.h>
  
! int __dpmi_install_resident_service_provider_callback(
!         __dpmi_callback_info *info
! );
  @end smallexample
  
  @subheading Description
*** src/libc/dpmi/helper/mapmem.txh	Sun Sep 27 16:21:54 1998
--- /home/rich/src/djgpp-toolong/src/libc/dpmi/helper/mapmem.txh	Tue Oct  3 22:15:02 2000
***************
*** 41,46 ****
  @subheading Example
  
  @example
! if (__djgpp_map_physical_memory (my_page_aligned_memory, 16384, 0x40000000))
    printf ("Failed to map physical addresses!\n");
  @end example
--- 41,47 ----
  @subheading Example
  
  @example
! if (__djgpp_map_physical_memory (my_page_aligned_memory, 16384,
!                                  0x40000000))
    printf ("Failed to map physical addresses!\n");
  @end example
*** src/libc/fsext/fsext.txh	Sun Aug 20 00:31:03 2000
--- /home/rich/src/djgpp-toolong/src/libc/fsext/fsext.txh	Tue Oct  3 22:15:34 2000
***************
*** 398,405 ****
            return 0;
         @}
  
!        /* Now store our note about this file descriptor so we can lookup it
!           up quickly later. */
         __FSEXT_set_data(fd, MPtr);
  
         /* Return the file descriptor
--- 398,405 ----
            return 0;
         @}
  
!        /* Now store our note about this file descriptor so we can
!         * look it up quickly later. */
         __FSEXT_set_data(fd, MPtr);
  
         /* Return the file descriptor
*** src/libc/go32/gopint.txh	Tue Jan 25 19:37:23 2000
--- /home/rich/src/djgpp-toolong/src/libc/go32/gopint.txh	Tue Oct  3 22:16:13 2000
***************
*** 48,54 ****
  @example
  #include <dpmi.h>
  
! int _go32_dpmi_chain_protected_mode_interrupt_vector(int vector, _go32_dpmi_seginfo *info);
  @end example
  
  @subheading Description
--- 48,56 ----
  @example
  #include <dpmi.h>
  
! int _go32_dpmi_chain_protected_mode_interrupt_vector(
!         int vector, _go32_dpmi_seginfo *info
! );
  @end example
  
  @subheading Description
***************
*** 156,162 ****
  
  void lock_my_handler()
  @{
!   _go32_dpmi_lock_code(my_handler, (unsigned long)(lock_my_handler - my_handler));
  @}
  @end example
  
--- 158,165 ----
  
  void lock_my_handler()
  @{
!   _go32_dpmi_lock_code(my_handler,
!                        (unsigned long)(lock_my_handler - my_handler));
  @}
  @end example
  
*** src/libc/go32/gopvec.txh	Tue Jan 25 19:37:23 2000
--- /home/rich/src/djgpp-toolong/src/libc/go32/gopvec.txh	Tue Oct  3 22:16:40 2000
***************
*** 4,10 ****
  @example
  #include <dpmi.h>
  
! int _go32_dpmi_get_protected_mode_interrupt_vector(int vector, _go32_dpmi_seginfo *info);
  @end example
  
  @subheading Description
--- 4,12 ----
  @example
  #include <dpmi.h>
  
! int _go32_dpmi_get_protected_mode_interrupt_vector(
!         int vector, _go32_dpmi_seginfo *info
! );
  @end example
  
  @subheading Description
***************
*** 37,43 ****
  @example
  #include <dpmi.h>
  
! int _go32_dpmi_set_protected_mode_interrupt_vector(int vector, _go32_dpmi_seginfo *info);
  @end example
  
  @subheading Description
--- 39,47 ----
  @example
  #include <dpmi.h>
  
! int _go32_dpmi_set_protected_mode_interrupt_vector(
!         int vector, _go32_dpmi_seginfo *info
! );
  @end example
  
  @subheading Description
*** src/libc/go32/gormcb.txh	Tue Jan 25 19:37:23 2000
--- /home/rich/src/djgpp-toolong/src/libc/go32/gormcb.txh	Tue Oct  3 22:17:07 2000
***************
*** 4,10 ****
  @example
  #include <dpmi.h>
  
! int _go32_dpmi_allocate_real_mode_callback_iret(_go32_dpmi_seginfo *info, _go32_dpmi_registers *regs);
  @end example
  
  @subheading Description
--- 4,12 ----
  @example
  #include <dpmi.h>
  
! int _go32_dpmi_allocate_real_mode_callback_iret(
!         _go32_dpmi_seginfo *info, _go32_dpmi_registers *regs
! );
  @end example
  
  @subheading Description
***************
*** 61,67 ****
  @example
  #include <dpmi.h>
  
! int _go32_dpmi_allocate_real_mode_callback_retf(_go32_dpmi_seginfo *info, _go32_dpmi_registers *regs);
  @end example
  
  @subheading Description
--- 63,71 ----
  @example
  #include <dpmi.h>
  
! int _go32_dpmi_allocate_real_mode_callback_retf(
!         _go32_dpmi_seginfo *info, _go32_dpmi_registers *regs
! );
  @end example
  
  @subheading Description
*** src/libc/go32/gorvec.txh	Tue Jan 25 19:37:23 2000
--- /home/rich/src/djgpp-toolong/src/libc/go32/gorvec.txh	Tue Oct  3 22:17:26 2000
***************
*** 4,10 ****
  @example
  #include <dpmi.h>
  
! int _go32_dpmi_get_real_mode_interrupt_vector(int vector, _go32_dpmi_seginfo *info);
  @end example
  
  @subheading Description
--- 4,12 ----
  @example
  #include <dpmi.h>
  
! int _go32_dpmi_get_real_mode_interrupt_vector(
!         int vector, _go32_dpmi_seginfo *info
! );
  @end example
  
  @subheading Description
***************
*** 35,41 ****
  @example
  #include <dpmi.h>
  
! int _go32_dpmi_set_real_mode_interrupt_vector(int vector, _go32_dpmi_seginfo *info);
  @end example
  
  @subheading Description
--- 37,45 ----
  @example
  #include <dpmi.h>
  
! int _go32_dpmi_set_real_mode_interrupt_vector(
!         int vector, _go32_dpmi_seginfo *info
! );
  @end example
  
  @subheading Description
*** src/libc/go32/infostrc.txh	Sun Sep 27 16:21:58 1998
--- /home/rich/src/djgpp-toolong/src/libc/go32/infostrc.txh	Tue Oct  3 22:17:40 2000
***************
*** 106,111 ****
  @subheading Example
  
  @example
! dosmemget(_go32_info_block.linear_address_of_primary_screen, 80*25*2, buf);
  @end example
  
--- 106,112 ----
  @subheading Example
  
  @example
! dosmemget(_go32_info_block.linear_address_of_primary_screen,
!           80*25*2, buf);
  @end example
  
*** src/libc/pc_hw/co80/conio.txh	Thu May 13 23:29:09 1999
--- /home/rich/src/djgpp-toolong/src/libc/pc_hw/co80/conio.txh	Tue Oct  3 22:18:13 2000
***************
*** 251,257 ****
  @example
  #include <conio.h>
  
! int     gettext(int _left, int _top, int _right, int _bottom, void *_destin);
  @end example
  
  @subheading Description
--- 251,258 ----
  @example
  #include <conio.h>
  
! int     gettext(int _left, int _top, int _right, int _bottom,
!                 void *_destin);
  @end example
  
  @subheading Description
***************
*** 406,412 ****
  @example
  #include <conio.h>
  
! int puttext(int _left, int _top, int _right, int _bottom, void *_source);
  @end example
  
  @subheading Description
--- 407,414 ----
  @example
  #include <conio.h>
  
! int puttext(int _left, int _top, int _right, int _bottom,
!             void *_source);
  @end example
  
  @subheading Description
*** src/libc/pc_hw/farptr/farptr.txh	Sun Sep 27 16:22:00 1998
--- /home/rich/src/djgpp-toolong/src/libc/pc_hw/farptr/farptr.txh	Tue Oct  3 22:18:36 2000
***************
*** 9,17 ****
  unsigned short _farpeekw(unsigned short selector, unsigned long offset);
  unsigned long _farpeekl(unsigned short selector, unsigned long offset);
  
! void _farpokeb(unsigned short sel, unsigned long off, unsigned char val);
! void _farpokew(unsigned short sel, unsigned long off, unsigned short val);
! void _farpokel(unsigned short sel, unsigned long off, unsigned long val);
  
  void _farsetsel(unsigned short selector);
  unsigned short _fargetsel(void);
--- 9,20 ----
  unsigned short _farpeekw(unsigned short selector, unsigned long offset);
  unsigned long _farpeekl(unsigned short selector, unsigned long offset);
  
! void _farpokeb(unsigned short sel, unsigned long off,
!                unsigned char val);
! void _farpokew(unsigned short sel, unsigned long off,
!                unsigned short val);
! void _farpokel(unsigned short sel, unsigned long off,
!                unsigned long val);
  
  void _farsetsel(unsigned short selector);
  unsigned short _fargetsel(void);
*** src/libc/pc_hw/fpu/cntrl87.txh	Sun Sep 27 16:22:00 1998
--- /home/rich/src/djgpp-toolong/src/libc/pc_hw/fpu/cntrl87.txh	Tue Oct  3 22:19:18 2000
***************
*** 19,25 ****
  float.h, and shown in this table:
  
  @example
! ---- ---- --XX XXXX = MCW_EM - exception masks (1=handle exception internally, 0=fault)
  ---- ---- ---- ---X = EM_INVALID - invalid operation
  ---- ---- ---- --X- = EM_DENORMAL - denormal operand
  ---- ---- ---- -X-- = EM_ZERODIVIDE - divide by zero
--- 19,26 ----
  float.h, and shown in this table:
  
  @example
! ---- ---- --XX XXXX = MCW_EM - exception masks (1=handle exception
!                                                 internally, 0=fault)
  ---- ---- ---- ---X = EM_INVALID - invalid operation
  ---- ---- ---- --X- = EM_DENORMAL - denormal operand
  ---- ---- ---- -X-- = EM_ZERODIVIDE - divide by zero
***************
*** 35,41 ****
  ---- 01-- ---- ---- = RC_DOWN - round towards -Inf
  ---- 10-- ---- ---- = RC_UP - round towards +Inf
  ---- 11-- ---- ---- = RC_CHOP - round towards zero
! ---X ---- ---- ---- = MCW_IC - infinity control (obsolete, always affine)
  ---0 ---- ---- ---- = IC_AFFINE - -Inf < +Inf
  ---1 ---- ---- ---- = IC_PROJECTIVE - -Inf == +Inf
  @end example
--- 36,43 ----
  ---- 01-- ---- ---- = RC_DOWN - round towards -Inf
  ---- 10-- ---- ---- = RC_UP - round towards +Inf
  ---- 11-- ---- ---- = RC_CHOP - round towards zero
! ---X ---- ---- ---- = MCW_IC - infinity control (obsolete,
!                                                  always affine)
  ---0 ---- ---- ---- = IC_AFFINE - -Inf < +Inf
  ---1 ---- ---- ---- = IC_PROJECTIVE - -Inf == +Inf
  @end example
*** src/libc/pc_hw/fpu/libm.txh	Tue Jan 25 19:37:23 2000
--- /home/rich/src/djgpp-toolong/src/libc/pc_hw/fpu/libm.txh	Tue Oct  3 22:40:41 2000
***************
*** 5,11 ****
  @example
  #include <libm/math.h>
  
! enum fdversion @{fdlibm_ieee = -1, fdlibm_svid, fdlibm_xopen, fdlibm_posix@};
  
  #define _LIB_VERSION_TYPE enum fdversion
  #define _LIB_VERSION _fdlib_version  
--- 5,12 ----
  @example
  #include <libm/math.h>
  
! enum fdversion @{fdlibm_ieee = -1, fdlibm_svid, fdlibm_xopen,
!                 fdlibm_posix@};
  
  #define _LIB_VERSION_TYPE enum fdversion
  #define _LIB_VERSION _fdlib_version  
***************
*** 144,153 ****
  #include <assert.h>
  #include <errno.h>
  #include <stdio.h>
! #include <libm/math.h>	/* or #define _USE_LIBM_MATH_H and #include <math.h> */
  #include <float.h>
  
! /* Setting _LIB_VERSION to anything but _IEEE_ will turn on errno handling. */
  _LIB_VERSION_TYPE _LIB_VERSION = _POSIX_;
  
  int main (void)
--- 145,156 ----
  #include <assert.h>
  #include <errno.h>
  #include <stdio.h>
! #include <libm/math.h> /* or #define _USE_LIBM_MATH_H
!                         * and #include <math.h> */
  #include <float.h>
  
! /* Setting _LIB_VERSION to anything but _IEEE_ will turn on
!  * errno handling. */
  _LIB_VERSION_TYPE _LIB_VERSION = _POSIX_;
  
  int main (void)
***************
*** 160,166 ****
    errno = 0;
    assert(errno == 0);
    sqrt(-1.0);
!   assert(errno == EDOM); /* this line should NOT cause the assertion to fail */
  
    return(0);
  @}
--- 163,170 ----
    errno = 0;
    assert(errno == 0);
    sqrt(-1.0);
!   assert(errno == EDOM); /* this line should NOT cause
!                           * the assertion to fail */
  
    return(0);
  @}
*** src/libc/pc_hw/fpu/s_mather.txh	Tue Jan 25 19:37:23 2000
--- /home/rich/src/djgpp-toolong/src/libc/pc_hw/fpu/s_mather.txh	Tue Oct  3 22:21:06 2000
***************
*** 110,116 ****
            return 1; /* be silent: no message, don't set errno */
          @} /* FALL THROUGH */
        case SING:
!         /* all other domain or sing exceptions, print message and abort */
          fprintf(stderr, "domain exception in %s\n", x->name);
          abort();
          break;
--- 110,117 ----
            return 1; /* be silent: no message, don't set errno */
          @} /* FALL THROUGH */
        case SING:
!         /* all other domain or sing exceptions,
!          * print message and abort */
          fprintf(stderr, "domain exception in %s\n", x->name);
          abort();
          break;
*** src/libc/pc_hw/fpu/stat87.txh	Sun Sep 27 16:22:00 1998
--- /home/rich/src/djgpp-toolong/src/libc/pc_hw/fpu/stat87.txh	Tue Oct  3 22:21:24 2000
***************
*** 27,33 ****
  ---- --X- ---- ---- = SW_C1
  ---- -X-- ---- ---- = SW_C2
  -X-- ---- ---- ---- = SW_C3
! --XX X--- ---- ---- = SW_TOP - top of stack (use SW_TOP_SHIFT to shift it)
  X--- ---- ---- ---- = SW_BUSY - fpu is busy
  @end example
  
--- 27,34 ----
  ---- --X- ---- ---- = SW_C1
  ---- -X-- ---- ---- = SW_C2
  -X-- ---- ---- ---- = SW_C3
! --XX X--- ---- ---- = SW_TOP - top of stack (use SW_TOP_SHIFT
!                                              to shift it)
  X--- ---- ---- ---- = SW_BUSY - fpu is busy
  @end example
  
*** src/libc/pc_hw/io/isw.txh	Sun Sep 27 16:22:02 1998
--- /home/rich/src/djgpp-toolong/src/libc/pc_hw/io/isw.txh	Tue Oct  3 22:21:40 2000
***************
*** 4,10 ****
  @example
  #include <pc.h>
  
! void inportsw(unsigned short _port, unsigned short *_buf, unsigned _len);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <pc.h>
  
! void inportsw(unsigned short _port,
!               unsigned short *_buf, unsigned _len);
  @end example
  
  @subheading Description
*** src/libc/pc_hw/io/osb.txh	Sun Sep 27 16:22:04 1998
--- /home/rich/src/djgpp-toolong/src/libc/pc_hw/io/osb.txh	Tue Oct  3 22:21:52 2000
***************
*** 4,10 ****
  @example
  #include <pc.h>
  
! void outportsb(unsigned short _port, const unsigned char *_buf, unsigned _len);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <pc.h>
  
! void outportsb(unsigned short _port,
!                const unsigned char *_buf, unsigned _len);
  @end example
  
  @subheading Description
*** src/libc/pc_hw/io/osl.txh	Sun Sep 27 16:22:04 1998
--- /home/rich/src/djgpp-toolong/src/libc/pc_hw/io/osl.txh	Tue Oct  3 22:22:00 2000
***************
*** 4,10 ****
  @example
  #include <pc.h>
  
! void outportsl(unsigned short _port, const unsigned long *_buf, unsigned _len);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <pc.h>
  
! void outportsl(unsigned short _port,
!                const unsigned long *_buf, unsigned _len);
  @end example
  
  @subheading Description
*** src/libc/pc_hw/io/osw.txh	Sun Sep 27 16:22:04 1998
--- /home/rich/src/djgpp-toolong/src/libc/pc_hw/io/osw.txh	Tue Oct  3 22:22:08 2000
***************
*** 4,10 ****
  @example
  #include <pc.h>
  
! void outportsw(unsigned short _port, const unsigned short *_buf, unsigned _len);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <pc.h>
  
! void outportsw(unsigned short _port,
!                const unsigned short *_buf, unsigned _len);
  @end example
  
  @subheading Description
*** src/libc/pc_hw/mem/dmpb.txh	Sun Sep 27 16:22:06 1998
--- /home/rich/src/djgpp-toolong/src/libc/pc_hw/mem/dmpb.txh	Tue Oct  3 22:22:21 2000
***************
*** 4,10 ****
  @example
  #include <sys/movedata.h>
  
! void _dosmemputb(const void *buffer, size_t xfers, unsigned long offset);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <sys/movedata.h>
  
! void _dosmemputb(const void *buffer, size_t xfers,
!                  unsigned long offset);
  @end example
  
  @subheading Description
*** src/libc/pc_hw/mem/dmpl.txh	Sun Sep 27 16:22:06 1998
--- /home/rich/src/djgpp-toolong/src/libc/pc_hw/mem/dmpl.txh	Tue Oct  3 22:22:31 2000
***************
*** 4,10 ****
  @example
  #include <sys/movedata.h>
  
! void _dosmemputl(const void *buffer, size_t xfers, unsigned long offset);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <sys/movedata.h>
  
! void _dosmemputl(const void *buffer, size_t xfers,
!                  unsigned long offset);
  @end example
  
  @subheading Description
*** src/libc/pc_hw/mem/dmpw.txh	Sun Sep 27 16:22:08 1998
--- /home/rich/src/djgpp-toolong/src/libc/pc_hw/mem/dmpw.txh	Tue Oct  3 22:22:40 2000
***************
*** 4,10 ****
  @example
  #include <sys/movedata.h>
  
! void _dosmemputw(const void *buffer, size_t xfers, unsigned long offset);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <sys/movedata.h>
  
! void _dosmemputw(const void *buffer, size_t xfers,
!                  unsigned long offset);
  @end example
  
  @subheading Description
*** src/libc/pc_hw/timer/uclock.txh	Mon May 24 19:31:34 1999
--- /home/rich/src/djgpp-toolong/src/libc/pc_hw/timer/uclock.txh	Tue Oct  3 22:23:03 2000
***************
*** 47,52 ****
  @subheading Example
  
  @example
! printf("%Ld seconds have elapsed\n", (long long)(uclock()/UCLOCKS_PER_SEC));
  @end example
  
--- 47,53 ----
  @subheading Example
  
  @example
! printf("%Ld seconds have elapsed\n",
!        (long long)(uclock()/UCLOCKS_PER_SEC));
  @end example
  
*** src/libc/posix/signal/itimer.txh	Tue Jan 25 19:37:25 2000
--- /home/rich/src/djgpp-toolong/src/libc/posix/signal/itimer.txh	Tue Oct  3 22:23:15 2000
***************
*** 51,57 ****
    struct timeval it_value;       /* current value */
  @};
  
! int setitimer(int which, struct itimerval *value, struct itimerval *ovalue);
  @end example
  
  @subheading Description
--- 51,58 ----
    struct timeval it_value;       /* current value */
  @};
  
! int setitimer(int which, struct itimerval *value,
!               struct itimerval *ovalue);
  @end example
  
  @subheading Description
*** src/libc/posix/signal/sigprocm.txh	Tue Jan 25 19:37:25 2000
--- /home/rich/src/djgpp-toolong/src/libc/posix/signal/sigprocm.txh	Tue Oct  3 22:24:47 2000
***************
*** 144,151 ****
        sigset_t new_set, old_set;
        sigemptyset (&new_set);
        sigaddset (&new_set, SIGINT);
!       sigprocmask (SIG_UNBLOCK, &new_set, &old_set);  /* will raise SIGINT */
!       sigprocmask (SIG_SETMASK, &old_set, &new_set);  /* restore mask */
      @}
  
  @end example
--- 144,155 ----
        sigset_t new_set, old_set;
        sigemptyset (&new_set);
        sigaddset (&new_set, SIGINT);
! 
!       /* This sigprocmask() call will raise SIGINT. */
!       sigprocmask (SIG_UNBLOCK, &new_set, &old_set);
! 
!       /* Restore mask */
!       sigprocmask (SIG_SETMASK, &old_set, &new_set);
      @}
  
  @end example
*** src/libc/posix/signal/sigactio.txh	Mon May 24 14:14:42 1999
--- /home/rich/src/djgpp-toolong/src/libc/posix/signal/sigactio.txh	Tue Oct  3 22:25:29 2000
***************
*** 4,10 ****
  @example
  #include <signal.h>
  
! int sigaction (int sig, const struct sigaction *act, struct sigaction *oact);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <signal.h>
  
! int sigaction (int sig, const struct sigaction *act,
!                struct sigaction *oact);
  @end example
  
  @subheading Description
***************
*** 15,21 ****
  
  @example
   struct sigaction @{
!    int sa_flags;             /* flags for the action; currently ignored */
     void (*sa_handler)(int);  /* the handler for the signal */
     sigset_t sa_mask;         /* additional signals to be blocked */
   @};
--- 16,23 ----
  
  @example
   struct sigaction @{
!    int sa_flags;             /* flags for the action;
!                               * currently ignored */
     void (*sa_handler)(int);  /* the handler for the signal */
     sigset_t sa_mask;         /* additional signals to be blocked */
   @};
*** src/libc/posix/sys/stat/is_exec.txh	Thu Aug 24 21:24:17 2000
--- /home/rich/src/djgpp-toolong/src/libc/posix/sys/stat/is_exec.txh	Tue Oct  3 22:25:46 2000
***************
*** 4,10 ****
  @example
  #include <sys/stat.h>
  
! int _is_executable(const char *path, int fhandle, const char *extension);
  @end example
  
  @subheading Description
--- 4,11 ----
  @example
  #include <sys/stat.h>
  
! int _is_executable(const char *path, int fhandle,
!                    const char *extension);
  @end example
  
  @subheading Description
*** src/libc/posix/sys/stat/xstat.txh	Sun Sep 27 16:22:18 1998
--- /home/rich/src/djgpp-toolong/src/libc/posix/sys/stat/xstat.txh	Tue Oct  3 22:25:59 2000
***************
*** 2,8 ****
  @subheading Syntax
  @example
  ino_t
! _invent_inode(const char *name, unsigned time_stamp, unsigned long fsize)
  @end example
  
  @subheading Description
--- 2,9 ----
  @subheading Syntax
  @example
  ino_t
! _invent_inode(const char *name, unsigned time_stamp,
!               unsigned long fsize)
  @end example
  
  @subheading Description
*** src/libc/posix/sys/times/times.txh	Sun Sep 27 16:22:18 1998
--- /home/rich/src/djgpp-toolong/src/libc/posix/sys/times/times.txh	Tue Oct  3 22:26:07 2000
***************
*** 38,43 ****
  @subheading Example
  
  @example
! printf("We used %d seconds of elapsed time\n", times(&buf)/CLOCKS_PER_SEC);
  @end example
  
--- 38,44 ----
  @subheading Example
  
  @example
! printf("We used %d seconds of elapsed time\n",
!        times(&buf)/CLOCKS_PER_SEC);
  @end example
  
*** src/libc/posix/unistd/exec.txh	Sun Sep 27 16:22:22 1998
--- /home/rich/src/djgpp-toolong/src/libc/posix/unistd/exec.txh	Tue Oct  3 22:26:30 2000
***************
*** 5,13 ****
  #include <unistd.h>
  
  int execl(const char *path, const char *argv0, ...);
! int execle(const char *path, const char *argv0, ... /*, char *const envp[] */);
  int execlp(const char *path, const char *argv0, ...);
! int execlpe(const char *path, const char *argv0, ... /*, char *const envp[] */);
  
  int execv(const char *path, char *const argv[]);
  int execve(const char *path, char *const argv[], char *const envp[]);
--- 5,15 ----
  #include <unistd.h>
  
  int execl(const char *path, const char *argv0, ...);
! int execle(const char *path, const char *argv0, ...
!            /*, char *const envp[] */);
  int execlp(const char *path, const char *argv0, ...);
! int execlpe(const char *path, const char *argv0, ...
!             /*, char *const envp[] */);
  
  int execv(const char *path, char *const argv[]);
  int execve(const char *path, char *const argv[], char *const envp[]);
*** src/libc/debug.txh	Tue Jan 25 19:36:40 2000
--- /home/rich/src/djgpp-toolong/src/libc/debug.txh	Tue Oct  3 22:30:55 2000
***************
*** 338,344 ****
  @example
  #include <debug/dbgcom.h>
  
! void read_sel_addr (unsigned offset, void *buf, unsigned len, unsigned sel);
  @end example
  
  @subheading Description
--- 338,345 ----
  @example
  #include <debug/dbgcom.h>
  
! void read_sel_addr (unsigned offset, void *buf, unsigned len,
!                     unsigned sel);
  @end example
  
  @subheading Description
***************
*** 366,372 ****
  @example
  #include <debug/dbgcom.h>
  
! void write_sel_addr (unsigned sel, unsigned offset, void *buf, unsigned len);
  @end example
  
  @subheading Description
--- 367,374 ----
  @example
  #include <debug/dbgcom.h>
  
! void write_sel_addr (unsigned sel, unsigned offset,
!                      void *buf, unsigned len);
  @end example
  
  @subheading Description
***************
*** 414,420 ****
  @example
  #include <debug/v2load.h>
  
! int v2loadimage (const char *program, const char *cmdline, jmp_buf load_state);
  @end example
  
  @subheading Description
--- 416,423 ----
  @example
  #include <debug/v2load.h>
  
! int v2loadimage (const char *program, const char *cmdline,
!                  jmp_buf load_state);
  @end example
  
  @subheading Description
***************
*** 573,579 ****
  struct dbg_redirect @{
    int inf_handle;   /* debuggee's handle */
    int our_handle;   /* debugger's handle */
!   char *file_name;  /* file name where debuggee's handle is redirected */
    int mode;         /* mode used to open() the above file */
    off_t filepos;    /* file position of debuggee's handle; unused */
  @};
--- 576,583 ----
  struct dbg_redirect @{
    int inf_handle;   /* debuggee's handle */
    int our_handle;   /* debugger's handle */
!   char *file_name;  /* file name where debuggee's handle is
!                      * redirected */
    int mode;         /* mode used to open() the above file */
    off_t filepos;    /* file position of debuggee's handle; unused */
  @};
***************
*** 1034,1040 ****
    char *file_name;
    syms_init ("foo.exe");
    file_name = syms_val2line (0x1c12, &lineno);
!   printf ("The address %x is on %s, line %d\n", 0x1c12, file_name, line);
  @end example
  
  @c ----------------------------------------------------------------------
--- 1038,1045 ----
    char *file_name;
    syms_init ("foo.exe");
    file_name = syms_val2line (0x1c12, &lineno);
!   printf ("The address %x is on %s, line %d\n",
!           0x1c12, file_name, line);
  @end example
  
  @c ----------------------------------------------------------------------

--------------B25DE0E216469E58A0B18B3E--

- Raw text -


  webmaster     delorie software   privacy  
  Copyright © 2019   by DJ Delorie     Updated Jul 2019