Mail Archives: djgpp-workers/1997/07/17/20:05:41
Comments, anyone?
------- Start of forwarded message -------
X-Authentication-Warning: kruuna.Helsinki.FI: peuha owned process doing -bs
Date: Thu, 17 Jul 1997 10:52:01 +0300 (EET DST)
From: Esa A E Peuha <peuha AT cc DOT helsinki DOT fi>
X-Sender: peuha AT kruuna DOT Helsinki DOT FI
Reply-To: Esa DOT Peuha AT Helsinki DOT FI
To: dj AT delorie DOT com
Subject: Patches for libc.inf sources
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Here are some patches for libc.inf source files. Some correct obvious
errors, others add (mostly incomplete) function descriptions. Feel free to
use them as you will.
diff -r -c -C2 -N olddoc/src/libc/ansi/stdio/fopen.txh newdoc/src/libc/ansi/stdio/fopen.txh
*** olddoc/src/libc/ansi/stdio/fopen.txh Fri Apr 26 21:10:02 1996
- --- newdoc/src/libc/ansi/stdio/fopen.txh Tue Jul 15 17:17:12 1997
***************
*** 4,7 ****
- --- 4,8 ----
@example
#include <stdio.h>
+
FILE *fopen(const char *filename, const char *mode);
@end example
diff -r -c -C2 -N olddoc/src/libc/ansi/stdio/fwalk.txh newdoc/src/libc/ansi/stdio/fwalk.txh
*** olddoc/src/libc/ansi/stdio/fwalk.txh Mon Jul 17 03:42:48 1995
- --- newdoc/src/libc/ansi/stdio/fwalk.txh Tue Jul 15 18:06:08 1997
***************
*** 3,6 ****
- --- 3,8 ----
@example
+ #include <libc/file.h>
+
void _fwalk(void (*function)(FILE *file));
@end example
diff -r -c -C2 -N olddoc/src/libc/ansi/stdlib/calloc.txh newdoc/src/libc/ansi/stdlib/calloc.txh
*** olddoc/src/libc/ansi/stdlib/calloc.txh Mon Jul 10 01:39:54 1995
- --- newdoc/src/libc/ansi/stdlib/calloc.txh Tue Jul 15 17:54:04 1997
***************
*** 3,7 ****
@example
! #include <malloc.h>
void *calloc(size_t num_elements, size_t size);
- --- 3,7 ----
@example
! #include <stdlib.h>
void *calloc(size_t num_elements, size_t size);
diff -r -c -C2 -N olddoc/src/libc/ansi/stdlib/malloc.txh newdoc/src/libc/ansi/stdlib/malloc.txh
*** olddoc/src/libc/ansi/stdlib/malloc.txh Mon Jul 10 01:39:56 1995
- --- newdoc/src/libc/ansi/stdlib/malloc.txh Tue Jul 15 17:55:54 1997
***************
*** 31,35 ****
@example
! #include <stdio.h>
void free(void *ptr);
- --- 31,35 ----
@example
! #include <stdlib.h>
void free(void *ptr);
diff -r -c -C2 -N olddoc/src/libc/ansi/stdlib/rand.txh newdoc/src/libc/ansi/stdlib/rand.txh
*** olddoc/src/libc/ansi/stdlib/rand.txh Mon Jul 10 01:39:56 1995
- --- newdoc/src/libc/ansi/stdlib/rand.txh Wed Jul 16 17:08:08 1997
***************
*** 23,24 ****
- --- 23,43 ----
@end example
+ @c ----------------------------------------------------------------------
+ @node srand, random number
+ @subheading Syntax
+
+ @example
+ #include <stdlib.h>
+
+ void srand(unsigned seed);
+ @end example
+
+ @subheading Description
+
+ Initializes the random number generator (@pxref{rand}). Passing the same
+ @var{seed} results in @code{rand} returning predictable sequences of numbers.
+
+ @subheading Return Value
+
+ None.
+
diff -r -c -C2 -N olddoc/src/libc/ansi/time/ctime.txh newdoc/src/libc/ansi/time/ctime.txh
*** olddoc/src/libc/ansi/time/ctime.txh Mon Jul 10 01:40:06 1995
- --- newdoc/src/libc/ansi/time/ctime.txh Wed Jul 16 20:24:36 1997
***************
*** 139,140 ****
- --- 139,159 ----
in that format.
+ @c ----------------------------------------------------------------------
+ @node tzset, time
+ @subheading Syntax
+
+ @example
+ #include <time.h>
+
+ void tzset(void);
+ @end example
+
+ @subheading Description
+
+ This function initializes @code{tzname} according to environment variable
+ TZ.
+
+ @subheading Return Value
+
+ None.
+
diff -r -c -C2 -N olddoc/src/libc/bios/biosprin.txh newdoc/src/libc/bios/biosprin.txh
*** olddoc/src/libc/bios/biosprin.txh Mon Jul 17 03:24:50 1995
- --- newdoc/src/libc/bios/biosprin.txh Tue Jul 15 17:53:12 1997
***************
*** 3,7 ****
@example
! #include <stdio.h>
int biosprint(int cmd, int byte, int port)
- --- 3,7 ----
@example
! #include <bios.h>
int biosprint(int cmd, int byte, int port)
diff -r -c -C2 -N olddoc/src/libc/compat/stdio/tempnam.txh newdoc/src/libc/compat/stdio/tempnam.txh
*** olddoc/src/libc/compat/stdio/tempnam.txh Thu Jan 1 00:00:00 1970
- --- newdoc/src/libc/compat/stdio/tempnam.txh Wed Jul 16 17:04:56 1997
***************
*** 0 ****
- --- 1,19 ----
+ @node tempnam, stdio
+ @subheading Syntax
+
+ @example
+ #include <stdio.h>
+
+ char *tempnam(const char *dir, const char *prefix);
+ @end example
+
+ @subheading Description
+
+ Currently, this function ignores its arguments and just calls
+ @pxref{tmpnam}.
+
+ @subheading Return Value
+
+ Pointer to internal static buffer that contains currently unused
+ valid filename.
+
diff -r -c -C2 -N olddoc/src/libc/compat/stdlib/random.txh newdoc/src/libc/compat/stdlib/random.txh
*** olddoc/src/libc/compat/stdlib/random.txh Sun Jul 23 03:01:26 1995
- --- newdoc/src/libc/compat/stdlib/random.txh Wed Jul 16 15:36:44 1997
***************
*** 10,16 ****
@subheading Description
! This function initialized the random number generator (@pxref{random}).
! Passing the same @var{seed} results in @code{random} returning predictable
! sequences of numbers.
@subheading Return Value
- --- 10,16 ----
@subheading Description
! Initializes the random number generator (@pxref{random}). Passing the
! same @var{seed} results in @code{random} returning predictable sequences
! of numbers, unless @pxref{initstate} or @pxref{setstate} are called.
@subheading Return Value
***************
*** 41,42 ****
- --- 41,82 ----
0 .. MAXINT
+
+ @c ----------------------------------------------------------------------
+ @node initstate, random number
+ @subheading Syntax
+
+ @example
+ #include <stdlib.h>
+
+ char *initstate(unsigned seed, char *arg_state, int n);
+ @end example
+
+ @subheading Description
+
+ Initializes the random number generator (@pxref{random}) with pointer
+ @var{arg_state} to array of @var{n} bytes, then calls @code{srandom} with
+ @var{seed}.
+
+ @subheading Return Value
+
+ Pointer to old state information.
+
+ @c ----------------------------------------------------------------------
+ @node setstate, random number
+ @subheading Syntax
+
+ @example
+ #include <stdlib.h>
+
+ char *setstate(char *arg_state);
+ @end example
+
+ @subheading Description
+
+ Restores the random number generator (@pxref{random}) state from pointer
+ @var{arg_state} to state array.
+
+ @subheading Return Value
+
+ Pointer to old state information.
+
diff -r -c -C2 -N olddoc/src/libc/compat/sys/stat/mknod.txh newdoc/src/libc/compat/sys/stat/mknod.txh
*** olddoc/src/libc/compat/sys/stat/mknod.txh Sun Jul 23 02:55:32 1995
- --- newdoc/src/libc/compat/sys/stat/mknod.txh Wed Jul 16 16:03:44 1997
***************
*** 1,3 ****
- --- 1,10 ----
@node mknod, unix
+ @subheading Syntax
+
+ @example
+ #include <sys/stat.h>
+
+ int mknod(const char *path, mode_t mode, dev_t dev);
+ @end example
@subheading Description
diff -r -c -C2 -N olddoc/src/libc/compat/unistd/sync.txh newdoc/src/libc/compat/unistd/sync.txh
*** olddoc/src/libc/compat/unistd/sync.txh Mon Jul 10 01:41:18 1995
- --- newdoc/src/libc/compat/unistd/sync.txh Tue Jul 15 17:41:48 1997
***************
*** 1,3 ****
- --- 1,10 ----
@node sync, unix
+ @subheading Syntax
+
+ @example
+ #include <unistd.h>
+
+ int sync(void);
+ @end example
@subheading Description
diff -r -c -C2 -N olddoc/src/libc/compat/unistd/vfork.txh newdoc/src/libc/compat/unistd/vfork.txh
*** olddoc/src/libc/compat/unistd/vfork.txh Thu Jan 1 00:00:00 1970
- --- newdoc/src/libc/compat/unistd/vfork.txh Wed Jul 16 16:01:26 1997
***************
*** 0 ****
- --- 1,15 ----
+ @node vfork, unix
+ @subheading Syntax
+
+ @example
+ #include <unistd.h>
+
+ pid_t vfork(void);
+ @end example
+
+ @subheading Description
+
+ This function always returns -1 and sets `errno' to ENOMEM, as MS-DOS
+ does not support multiple processes. It exists only to assist in
+ porting Unix programs.
+
diff -r -c -C2 -N olddoc/src/libc/crt0/crt0.txh newdoc/src/libc/crt0/crt0.txh
*** olddoc/src/libc/crt0/crt0.txh Sat Oct 5 20:33:20 1996
- --- newdoc/src/libc/crt0/crt0.txh Wed Jul 16 19:56:44 1997
***************
*** 3,7 ****
@example
! #include <stdlib.h>
int brk(void *ptr);
- --- 3,7 ----
@example
! #include <unistd.h>
int brk(void *ptr);
***************
*** 103,107 ****
@example
! #include <stdlib.h>
void _exit(int exit_code);
- --- 103,107 ----
@example
! #include <unistd.h>
void _exit(int exit_code);
***************
*** 127,131 ****
@example
! #include <stdlib.h>
void __exit(int exit_code);
- --- 127,131 ----
@example
! #include <unistd.h>
void __exit(int exit_code);
diff -r -c -C2 -N olddoc/src/libc/dos/compat/d_getdf.txh newdoc/src/libc/dos/compat/d_getdf.txh
*** olddoc/src/libc/dos/compat/d_getdf.txh Mon Oct 9 02:00:00 1995
- --- newdoc/src/libc/dos/compat/d_getdf.txh Tue Jul 15 17:05:28 1997
***************
*** 1,4 ****
@node _dos_getdiskfree, dos
- - @heading @code{_dos_getdiskfree}
@subheading Syntax
- --- 1,3 ----
diff -r -c -C2 -N olddoc/src/libc/dos/compat/d_getdrv.txh newdoc/src/libc/dos/compat/d_getdrv.txh
*** olddoc/src/libc/dos/compat/d_getdrv.txh Mon Oct 9 02:00:00 1995
- --- newdoc/src/libc/dos/compat/d_getdrv.txh Tue Jul 15 17:07:18 1997
***************
*** 1,4 ****
@node _dos_getdrive, dos
- - @heading @code{_dos_getdrive}
@subheading Syntax
- --- 1,3 ----
diff -r -c -C2 -N olddoc/src/libc/dos/compat/d_getfa.txh newdoc/src/libc/dos/compat/d_getfa.txh
*** olddoc/src/libc/dos/compat/d_getfa.txh Mon Oct 9 02:00:00 1995
- --- newdoc/src/libc/dos/compat/d_getfa.txh Tue Jul 15 17:07:16 1997
***************
*** 1,4 ****
@node _dos_getfileattr, dos
- - @heading @code{_dos_getfileattr}
@subheading Syntax
- --- 1,3 ----
diff -r -c -C2 -N olddoc/src/libc/dos/compat/d_setdrv.txh newdoc/src/libc/dos/compat/d_setdrv.txh
*** olddoc/src/libc/dos/compat/d_setdrv.txh Mon Oct 9 02:00:00 1995
- --- newdoc/src/libc/dos/compat/d_setdrv.txh Tue Jul 15 17:07:16 1997
***************
*** 1,4 ****
@node _dos_setdrive, dos
- - @heading @code{_dos_setdrive}
@subheading Syntax
- --- 1,3 ----
diff -r -c -C2 -N olddoc/src/libc/dos/compat/d_setfa.txh newdoc/src/libc/dos/compat/d_setfa.txh
*** olddoc/src/libc/dos/compat/d_setfa.txh Mon Oct 9 02:00:00 1995
- --- newdoc/src/libc/dos/compat/d_setfa.txh Tue Jul 15 17:07:14 1997
***************
*** 1,4 ****
@node _dos_setfileattr, dos
- - @heading @code{_dos_setfileattr}
@subheading Syntax
- --- 1,3 ----
diff -r -c -C2 -N olddoc/src/libc/dos/dos/delay.txh newdoc/src/libc/dos/dos/delay.txh
*** olddoc/src/libc/dos/dos/delay.txh Mon Jul 10 01:40:08 1995
- --- newdoc/src/libc/dos/dos/delay.txh Tue Jul 15 18:03:18 1997
***************
*** 3,6 ****
- --- 3,8 ----
@example
+ #include <dos.h>
+
void delay(unsigned msec);
@end example
diff -r -c -C2 -N olddoc/src/libc/dos/dos/gettimeo.txh newdoc/src/libc/dos/dos/gettimeo.txh
*** olddoc/src/libc/dos/dos/gettimeo.txh Mon Jul 10 01:40:10 1995
- --- newdoc/src/libc/dos/dos/gettimeo.txh Tue Jul 15 17:56:50 1997
***************
*** 3,7 ****
@example
! #include <sys/time.h>
int gettimeofday(struct timeval *tp, struct timezone *tzp);
- --- 3,7 ----
@example
! #include <time.h>
int gettimeofday(struct timeval *tp, struct timezone *tzp);
diff -r -c -C2 -N olddoc/src/libc/dos/io/crlf2nl.txh newdoc/src/libc/dos/io/crlf2nl.txh
*** olddoc/src/libc/dos/io/crlf2nl.txh Mon Jul 10 01:40:16 1995
- --- newdoc/src/libc/dos/io/crlf2nl.txh Tue Jul 15 18:04:08 1997
***************
*** 3,6 ****
- --- 3,8 ----
@example
+ #include <io.h>
+
size_t crlf2nl(char *buf, ssize_t len);
@end example
diff -r -c -C2 -N olddoc/src/libc/pc_hw/co80/conio.txh newdoc/src/libc/pc_hw/co80/conio.txh
*** olddoc/src/libc/pc_hw/co80/conio.txh Tue Jul 23 23:05:36 1996
- --- newdoc/src/libc/pc_hw/co80/conio.txh Tue Jul 15 17:16:28 1997
***************
*** 574,585 ****
- --- 574,590 ----
times when you need to call it again, typically after calling some video
BIOS function which affects screen parameters.
+
@c ----------------------------------------------------------------------
@node _set_screen_lines, conio
@subheading Syntax
+
@example
#include <conio.h>
+
void _set_screen_lines(int nlines);
@end example
+
@subheading Description
+
This function sets the text screen width to 80 and its height to the
value given by @var{nlines}, which can be one of the following: 25, 28,
***************
*** 597,600 ****
- --- 602,606 ----
application programs which use it should make their own arrangements to
redisplay it.
+
@c ----------------------------------------------------------------------
@node blinkvideo, conio
***************
*** 604,607 ****
- --- 610,614 ----
@example
#include <conio.h>
+
void blinkvideo(void);
@end example
***************
*** 622,625 ****
- --- 629,633 ----
indicates the current state: if it's 1 (the default), blinking
characters will be displayed.
+
@c ----------------------------------------------------------------------
@node intensevideo, conio
***************
*** 629,632 ****
- --- 637,641 ----
@example
#include <conio.h>
+
void intensevideo(void);
@end example
diff -r -c -C2 -N olddoc/src/libc/pc_hw/mono/mono.txh newdoc/src/libc/pc_hw/mono/mono.txh
*** olddoc/src/libc/pc_hw/mono/mono.txh Mon Jul 10 01:41:10 1995
- --- newdoc/src/libc/pc_hw/mono/mono.txh Tue Jul 15 18:07:40 1997
***************
*** 31,35 ****
@example
! #include <mono.h>
void _mono_putc(int c);
- --- 31,35 ----
@example
! #include <sys/mono.h>
void _mono_putc(int c);
diff -r -c -C2 -N olddoc/src/libc/posix/signal/kill.txh newdoc/src/libc/posix/signal/kill.txh
*** olddoc/src/libc/posix/signal/kill.txh Mon Jul 10 01:40:58 1995
- --- newdoc/src/libc/posix/signal/kill.txh Tue Jul 15 17:11:02 1997
***************
*** 1,3 ****
- --- 1,4 ----
@node kill, process
+ @subheading Syntax
@example
diff -r -c -C2 -N olddoc/src/libc/posix/signal/sigactio.txh newdoc/src/libc/posix/signal/sigactio.txh
*** olddoc/src/libc/posix/signal/sigactio.txh Thu Jan 1 00:00:00 1970
- --- newdoc/src/libc/posix/signal/sigactio.txh Wed Jul 16 20:37:20 1997
***************
*** 0 ****
- --- 1,13 ----
+ @node sigaction, process
+ @subheading Syntax
+
+ @example
+ #include <signal.h>
+
+ int sigaction(int sig, const struct sigaction *act, struct sigaction *oact);
+ @end example
+
+ @subheading Description
+
+ @subheading Return Value
+
diff -r -c -C2 -N olddoc/src/libc/posix/signal/sigaddse.txh newdoc/src/libc/posix/signal/sigaddse.txh
*** olddoc/src/libc/posix/signal/sigaddse.txh Thu Jan 1 00:00:00 1970
- --- newdoc/src/libc/posix/signal/sigaddse.txh Wed Jul 16 20:41:34 1997
***************
*** 0 ****
- --- 1,13 ----
+ @node sigaddset, process
+ @subheading Syntax
+
+ @example
+ #include <signal.h>
+
+ int sigaddset(sigset_t *set, int signo);
+ @end example
+
+ @subheading Description
+
+ @subheading Return Value
+
diff -r -c -C2 -N olddoc/src/libc/posix/signal/sigdelse.txh newdoc/src/libc/posix/signal/sigdelse.txh
*** olddoc/src/libc/posix/signal/sigdelse.txh Thu Jan 1 00:00:00 1970
- --- newdoc/src/libc/posix/signal/sigdelse.txh Wed Jul 16 20:43:08 1997
***************
*** 0 ****
- --- 1,13 ----
+ @node sigdelset, process
+ @subheading Syntax
+
+ @example
+ #include <signal.h>
+
+ int sigdelset(sigset_t *set, int signo);
+ @end example
+
+ @subheading Description
+
+ @subheading Return Value
+
diff -r -c -C2 -N olddoc/src/libc/posix/signal/sigempty.txh newdoc/src/libc/posix/signal/sigempty.txh
*** olddoc/src/libc/posix/signal/sigempty.txh Thu Jan 1 00:00:00 1970
- --- newdoc/src/libc/posix/signal/sigempty.txh Wed Jul 16 20:44:26 1997
***************
*** 0 ****
- --- 1,13 ----
+ @node sigemptyset, process
+ @subheading Syntax
+
+ @example
+ #include <signal.h>
+
+ int sigemptyset(sigset_t *set);
+ @end example
+
+ @subheading Description
+
+ @subheading Return Value
+
diff -r -c -C2 -N olddoc/src/libc/posix/signal/sigfills.txh newdoc/src/libc/posix/signal/sigfills.txh
*** olddoc/src/libc/posix/signal/sigfills.txh Thu Jan 1 00:00:00 1970
- --- newdoc/src/libc/posix/signal/sigfills.txh Wed Jul 16 20:45:34 1997
***************
*** 0 ****
- --- 1,13 ----
+ @node sigfillset, process
+ @subheading Syntax
+
+ @example
+ #include <signal.h>
+
+ int sigfillset(sigset_t *set);
+ @end example
+
+ @subheading Description
+
+ @subheading Return Value
+
diff -r -c -C2 -N olddoc/src/libc/posix/signal/sigismem.txh newdoc/src/libc/posix/signal/sigismem.txh
*** olddoc/src/libc/posix/signal/sigismem.txh Thu Jan 1 00:00:00 1970
- --- newdoc/src/libc/posix/signal/sigismem.txh Wed Jul 16 20:47:20 1997
***************
*** 0 ****
- --- 1,13 ----
+ @node sigismember, process
+ @subheading Syntax
+
+ @example
+ #include <signal.h>
+
+ int sigismember(const sigset_t *set, int signo);
+ @end example
+
+ @subheading Description
+
+ @subheading Return Value
+
diff -r -c -C2 -N olddoc/src/libc/posix/signal/sigpendi.txh newdoc/src/libc/posix/signal/sigpendi.txh
*** olddoc/src/libc/posix/signal/sigpendi.txh Thu Jan 1 00:00:00 1970
- --- newdoc/src/libc/posix/signal/sigpendi.txh Wed Jul 16 20:49:20 1997
***************
*** 0 ****
- --- 1,13 ----
+ @node sigpending, process
+ @subheading Syntax
+
+ @example
+ #include <signal.h>
+
+ int sigpending(sigset_t *set);
+ @end example
+
+ @subheading Description
+
+ @subheading Return Value
+
diff -r -c -C2 -N olddoc/src/libc/posix/signal/sigprocm.txh newdoc/src/libc/posix/signal/sigprocm.txh
*** olddoc/src/libc/posix/signal/sigprocm.txh Thu Jan 1 00:00:00 1970
- --- newdoc/src/libc/posix/signal/sigprocm.txh Wed Jul 16 20:51:12 1997
***************
*** 0 ****
- --- 1,15 ----
+ @node sigprocmask, process
+ @subheading Syntax
+
+ @example
+ #include <signal.h>
+
+ int sigprocmask(int how, const sigset_t *set, sigset_t *oset);
+ @end example
+
+ @subheading Description
+
+ @subheading Return Value
+
+ Zero.
+
diff -r -c -C2 -N olddoc/src/libc/posix/signal/sigsuspe.txh newdoc/src/libc/posix/signal/sigsuspe.txh
*** olddoc/src/libc/posix/signal/sigsuspe.txh Thu Jan 1 00:00:00 1970
- --- newdoc/src/libc/posix/signal/sigsuspe.txh Wed Jul 16 20:52:28 1997
***************
*** 0 ****
- --- 1,15 ----
+ @node sigsuspend, process
+ @subheading Syntax
+
+ @example
+ #include <signal.h>
+
+ int sigsuspend(const sigset_t *set);
+ @end example
+
+ @subheading Description
+
+ @subheading Return Value
+
+ Zero.
+
diff -r -c -C2 -N olddoc/src/libc/posix/sys/stat/mkfifo.txh newdoc/src/libc/posix/sys/stat/mkfifo.txh
*** olddoc/src/libc/posix/sys/stat/mkfifo.txh Sun Jul 23 02:54:46 1995
- --- newdoc/src/libc/posix/sys/stat/mkfifo.txh Wed Jul 16 16:03:46 1997
***************
*** 1,3 ****
- --- 1,10 ----
@node mkfifo, unix
+ @subheading Syntax
+
+ @example
+ #include <sys/stat.h>
+
+ int mkfifo(const char *path, mode_t mode);
+ @end example
@subheading Description
diff -r -c -C2 -N olddoc/src/libc/posix/sys/stat/umask.txh newdoc/src/libc/posix/sys/stat/umask.txh
*** olddoc/src/libc/posix/sys/stat/umask.txh Mon Jul 10 01:40:52 1995
- --- newdoc/src/libc/posix/sys/stat/umask.txh Tue Jul 15 17:12:12 1997
***************
*** 1,3 ****
- --- 1,4 ----
@node umask, file system
+ @subheading Syntax
@example
diff -r -c -C2 -N olddoc/src/libc/posix/unistd/ctermid.txh newdoc/src/libc/posix/unistd/ctermid.txh
*** olddoc/src/libc/posix/unistd/ctermid.txh Thu Jan 1 00:00:00 1970
- --- newdoc/src/libc/posix/unistd/ctermid.txh Wed Jul 16 17:04:54 1997
***************
*** 0 ****
- --- 1,19 ----
+ @node ctermid, posix
+ @subheading Syntax
+
+ @example
+ #include <unistd.h>
+
+ char *ctermid(char *s);
+ @end example
+
+ @subheading Description
+
+ This function returns the name of the current terminal device. Under MS-DOS,
+ this is always "con".
+
+ @subheading Return Value
+
+ If @var{s} is null, returns pointer to internal static string "con".
+ Otherwise, copies "con" to buffer pointed by @var{s}.
+
diff -r -c -C2 -N olddoc/src/libc/posix/unistd/fork.txh newdoc/src/libc/posix/unistd/fork.txh
*** olddoc/src/libc/posix/unistd/fork.txh Mon Jul 10 01:42:42 1995
- --- newdoc/src/libc/posix/unistd/fork.txh Tue Jul 15 17:39:50 1997
***************
*** 1,4 ****
- --- 1,11 ----
@c ----------------------------------------------------------------------
@node fork, unix
+ @subheading Syntax
+
+ @example
+ #include <unistd.h>
+
+ pid_t fork(void);
+ @end example
@subheading Description
diff -r -c -C2 -N olddoc/src/libc/posix/unistd/getgroup.txh newdoc/src/libc/posix/unistd/getgroup.txh
*** olddoc/src/libc/posix/unistd/getgroup.txh Thu Jan 1 00:00:00 1970
- --- newdoc/src/libc/posix/unistd/getgroup.txh Wed Jul 16 17:08:06 1997
***************
*** 0 ****
- --- 1,17 ----
+ @node getgroups, unix
+ @subheading Syntax
+
+ @example
+ #include <unistd.h>
+
+ int getgroups(int size, gid_t *grouplist);
+ @end example
+
+ @subheading Description
+
+ This function always returns zero. It exists to assist porting from Unix.
+
+ @subheading Return Value
+
+ Zero.
+
diff -r -c -C2 -N olddoc/src/libc/posix/unistd/getopt.txh newdoc/src/libc/posix/unistd/getopt.txh
*** olddoc/src/libc/posix/unistd/getopt.txh Fri Apr 26 21:13:52 1996
- --- newdoc/src/libc/posix/unistd/getopt.txh Tue Jul 15 18:05:12 1997
***************
*** 3,6 ****
- --- 3,8 ----
@example
+ #include <unistd.h>
+
int getopt(int argc, char * const *argv, const char *options);
extern char *optarg;
diff -r -c -C2 -N olddoc/src/libc/posix/unistd/pipe.txh newdoc/src/libc/posix/unistd/pipe.txh
*** olddoc/src/libc/posix/unistd/pipe.txh Sun Jul 23 05:46:52 1995
- --- newdoc/src/libc/posix/unistd/pipe.txh Wed Jul 16 16:04:38 1997
***************
*** 1,3 ****
- --- 1,10 ----
@node pipe, unix
+ @subheading Syntax
+
+ @example
+ #include <unistd.h>
+
+ int pipe(int fildes[2]);
+ @end example
@subheading Description
diff -r -c -C2 -N olddoc/src/libc/posix/unistd/setgid.txh newdoc/src/libc/posix/unistd/setgid.txh
*** olddoc/src/libc/posix/unistd/setgid.txh Thu Jan 1 00:00:00 1970
- --- newdoc/src/libc/posix/unistd/setgid.txh Wed Jul 16 17:04:54 1997
***************
*** 0 ****
- --- 1,18 ----
+ @node setgid, unix
+ @subheading Syntax
+
+ @example
+ #include <unistd.h>
+
+ int setgid(gid_t gid);
+ @end example
+
+ @subheading Description
+
+ This function is simulated, since MS-DOS does not support group IDs.
+
+ @subheading Return Value
+
+ If @var{gid} is equal to that returned by @pxref{getgid}, returns zero.
+ Otherwise, returns -1 and sets @code{errno} to EPERM.
+
diff -r -c -C2 -N olddoc/src/libc/posix/unistd/setsid.txh newdoc/src/libc/posix/unistd/setsid.txh
*** olddoc/src/libc/posix/unistd/setsid.txh Thu Jan 1 00:00:00 1970
- --- newdoc/src/libc/posix/unistd/setsid.txh Wed Jul 16 17:08:08 1997
***************
*** 0 ****
- --- 1,17 ----
+ @node setsid, unix
+ @subheading Syntax
+
+ @example
+ #include <unistd.h>
+
+ pid_t setsid(void);
+ @end example
+
+ @subheading Description
+
+ This function does not do anything. It exists to assist porting from Unix.
+
+ @subheading Return Value
+
+ Return value of @pxref{getpid}.
+
diff -r -c -C2 -N olddoc/src/libc/posix/unistd/setuid.txh newdoc/src/libc/posix/unistd/setuid.txh
*** olddoc/src/libc/posix/unistd/setuid.txh Thu Jan 1 00:00:00 1970
- --- newdoc/src/libc/posix/unistd/setuid.txh Wed Jul 16 17:04:56 1997
***************
*** 0 ****
- --- 1,18 ----
+ @node setuid, unix
+ @subheading Syntax
+
+ @example
+ #include <unistd.h>
+
+ int setuid(uid_t uid);
+ @end example
+
+ @subheading Description
+
+ This function is simulated, since MS-DOS does not support user IDs.
+
+ @subheading Return Value
+
+ If @var{uid} is equal to that returned by @pxref{getuid}, returns zero.
+ Otherwise, returns -1 and sets @code{errno} to EPERM.
+
- ----- end of patch -----
Esa Peuha
student of mathematics at the University of Helsinki
http://www.helsinki.fi/~peuha/
------- End of forwarded message -------
- Raw text -