Date: Thu, 17 Jul 1997 20:04:06 -0400 (EDT) Message-Id: <199707180004.UAA26878@delorie.com> From: DJ Delorie To: djgpp-workers AT delorie DOT com Subject: [peuha AT cc DOT helsinki DOT fi: Patches for libc.inf sources] Precedence: bulk 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 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 + 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 + 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 void *calloc(size_t num_elements, size_t size); - --- 3,7 ---- @example ! #include 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 void free(void *ptr); - --- 31,35 ---- @example ! #include 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 + + 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 + + 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 int biosprint(int cmd, int byte, int port) - --- 3,7 ---- @example ! #include 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 + + 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 + + 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 + + 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 + + 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 + + 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 + + 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 int brk(void *ptr); - --- 3,7 ---- @example ! #include int brk(void *ptr); *************** *** 103,107 **** @example ! #include void _exit(int exit_code); - --- 103,107 ---- @example ! #include void _exit(int exit_code); *************** *** 127,131 **** @example ! #include void __exit(int exit_code); - --- 127,131 ---- @example ! #include 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 + 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 int gettimeofday(struct timeval *tp, struct timezone *tzp); - --- 3,7 ---- @example ! #include 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 + 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 + 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 + 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 + 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 void _mono_putc(int c); - --- 31,35 ---- @example ! #include 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 + + 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 + + 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 + + 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 + + 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 + + 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 + + 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 + + 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 + + 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 + + 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 + + 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 + + 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 + + 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 + + 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 + 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 + + 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 + + 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 + + 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 + + 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 -------