Date: Tue, 04 Mar 2003 18:23:06 +0000 From: "Richard Dawe" Sender: rich AT phekda DOT freeserve DOT co DOT uk To: djgpp-workers AT delorie DOT com X-Mailer: Emacs 21.3.50 (via feedmail 8.3.emacs20_6 I) and Blat ver 1.8.6 Subject: Add vindex entries for environment variables, revision 2 [PATCH] Message-Id: Reply-To: djgpp-workers AT delorie DOT com Hello. Below is revision 2 of the patch to add @vindex entries for environment variables. Thanks for the comments. OK to commit? Thanks, bye, Rich =] Index: ./src/libc/ansi/stdio/rename.txh =================================================================== RCS file: /cvs/djgpp/djgpp/src/libc/ansi/stdio/rename.txh,v retrieving revision 1.4 diff -p -c -3 -r1.4 rename.txh *** ./src/libc/ansi/stdio/rename.txh 29 Jan 2003 12:28:44 -0000 1.4 --- ./src/libc/ansi/stdio/rename.txh 4 Mar 2003 18:14:38 -0000 *************** rename("c:/path1/mydir", "c:/path2"); *** 50,55 **** --- 50,56 ---- @node _rename, file system @findex _rename + @vindex LFN AT r{ environment variable and }@code{_rename} @subheading Syntax @example Index: ./src/libc/ansi/stdio/tmpnam.txh =================================================================== RCS file: /cvs/djgpp/djgpp/src/libc/ansi/stdio/tmpnam.txh,v retrieving revision 1.4 diff -p -c -3 -r1.4 tmpnam.txh *** ./src/libc/ansi/stdio/tmpnam.txh 29 Jan 2003 12:28:44 -0000 1.4 --- ./src/libc/ansi/stdio/tmpnam.txh 4 Mar 2003 18:14:38 -0000 *************** *** 1,5 **** --- 1,8 ---- @node tmpnam, stdio @findex tmpnam + @vindex TMPDIR AT r{ environment variable, and }@code{tmpnam} + @vindex TEMP AT r{ environment variable, and }@code{tmpnam} + @vindex TMP AT r{ environment variable, and }@code{tmpnam} @subheading Syntax @example Index: ./src/libc/ansi/stdlib/malloc.txh =================================================================== RCS file: /cvs/djgpp/djgpp/src/libc/ansi/stdlib/malloc.txh,v retrieving revision 1.8 diff -p -c -3 -r1.8 malloc.txh *** ./src/libc/ansi/stdlib/malloc.txh 7 Feb 2003 18:13:51 -0000 1.8 --- ./src/libc/ansi/stdlib/malloc.txh 4 Mar 2003 18:14:50 -0000 *************** heap passes all tests, or zero of some o *** 275,280 **** --- 275,281 ---- @node malloc_debug, memory @findex malloc_debug + @vindex MALLOC_DEBUG AT r{ environment variable} @subheading Syntax @example Index: ./src/libc/ansi/stdlib/system.txh =================================================================== RCS file: /cvs/djgpp/djgpp/src/libc/ansi/stdlib/system.txh,v retrieving revision 1.6 diff -p -c -3 -r1.6 system.txh *** ./src/libc/ansi/stdlib/system.txh 29 Jan 2003 12:30:21 -0000 1.6 --- ./src/libc/ansi/stdlib/system.txh 4 Mar 2003 18:14:51 -0000 *************** *** 1,5 **** --- 1,9 ---- @node system, process @findex system + @vindex SHELL AT r{ environment variable, and }@code{system} + @vindex COMSPEC AT r{ environment variable, and }@code{system} + @vindex CMDLINE AT r{ environment variable, and }@code{system} + @vindex DJSYSFLAGS AT r{ environment variable, and the behaviour of }@code{system} @subheading Syntax @example Index: ./src/libc/ansi/time/ctime.txh =================================================================== RCS file: /cvs/djgpp/djgpp/src/libc/ansi/time/ctime.txh,v retrieving revision 1.9 diff -p -c -3 -r1.9 ctime.txh *** ./src/libc/ansi/time/ctime.txh 7 Feb 2003 18:13:51 -0000 1.9 --- ./src/libc/ansi/time/ctime.txh 4 Mar 2003 18:14:59 -0000 *************** A pointer to a static structure which is *** 160,165 **** --- 160,166 ---- @c ---------------------------------------------------------------------- @node mktime, time @findex mktime + @vindex TZ AT r{ environment variable, and time since 1970} @subheading Syntax @example *************** in that format. *** 211,216 **** --- 212,218 ---- @node tzset, time @vindex tzname @findex tzset + @vindex TZ AT r{ environment variable, and }@code{tzname} @subheading Syntax @example Index: ./src/libc/compat/stdio/tempnam.txh =================================================================== RCS file: /cvs/djgpp/djgpp/src/libc/compat/stdio/tempnam.txh,v retrieving revision 1.2 diff -p -c -3 -r1.2 tempnam.txh *** ./src/libc/compat/stdio/tempnam.txh 29 Jan 2003 12:39:19 -0000 1.2 --- ./src/libc/compat/stdio/tempnam.txh 4 Mar 2003 18:15:00 -0000 *************** *** 2,7 **** --- 2,10 ---- @node tempnam, file system @findex tempnam + @vindex TMPDIR AT r{ environment variable, and }@code{tempnam} + @vindex TEMP AT r{ environment variable, and }@code{tempnam} + @vindex TMP AT r{ environment variable, and }@code{tempnam} @subheading Syntax @example Index: ./src/libc/compat/unistd/gethostn.txh =================================================================== RCS file: /cvs/djgpp/djgpp/src/libc/compat/unistd/gethostn.txh,v retrieving revision 1.3 diff -p -c -3 -r1.3 gethostn.txh *** ./src/libc/compat/unistd/gethostn.txh 29 Jan 2003 12:44:35 -0000 1.3 --- ./src/libc/compat/unistd/gethostn.txh 4 Mar 2003 18:15:12 -0000 *************** *** 1,5 **** --- 1,6 ---- @node gethostname, misc @findex gethostname + @vindex HOSTNAME AT r{ environment variable} @subheading Syntax @example Index: ./src/libc/crt0/crt1.txh =================================================================== RCS file: /cvs/djgpp/djgpp/src/libc/crt0/crt1.txh,v retrieving revision 1.6 diff -p -c -3 -r1.6 crt1.txh *** ./src/libc/crt0/crt1.txh 29 Jan 2003 12:46:06 -0000 1.6 --- ./src/libc/crt0/crt1.txh 4 Mar 2003 18:15:13 -0000 *************** with filenames which have embedded white *** 58,63 **** --- 58,64 ---- @c ---------------------------------------------------------------------- @node __crt0_load_environment_file, startup @findex __crt0_load_environment_file + @vindex DJGPP AT r{ environment variable} @subheading Syntax @example *************** function that does nothing. *** 84,89 **** --- 85,92 ---- @c ---------------------------------------------------------------------- @node _crt0_startup_flags, startup @vindex _crt0_startup_flags + @vindex LFN AT r{ environment variable, how to disable at start-up} + @vindex FNCASE AT r{ environment variable, how to disable at start-up} @subheading Syntax @example Index: ./src/libc/dos/dir/srchpath.txh =================================================================== RCS file: /cvs/djgpp/djgpp/src/libc/dos/dir/srchpath.txh,v retrieving revision 1.4 diff -p -c -3 -r1.4 srchpath.txh *** ./src/libc/dos/dir/srchpath.txh 29 Jan 2003 12:47:41 -0000 1.4 --- ./src/libc/dos/dir/srchpath.txh 4 Mar 2003 18:15:25 -0000 *************** *** 1,5 **** --- 1,6 ---- @node searchpath, file system @findex searchpath + @vindex PATH AT r{ environment variable, and finding files with }@code{searchpath} @subheading Syntax @example Index: ./src/libc/dos/lfn/_use_lfn.txh =================================================================== RCS file: /cvs/djgpp/djgpp/src/libc/dos/lfn/_use_lfn.txh,v retrieving revision 1.8 diff -p -c -3 -r1.8 _use_lfn.txh *** ./src/libc/dos/lfn/_use_lfn.txh 29 Jan 2003 12:49:30 -0000 1.8 --- ./src/libc/dos/lfn/_use_lfn.txh 4 Mar 2003 18:15:30 -0000 *************** *** 1,5 **** --- 1,6 ---- @node _use_lfn, file system @findex _use_lfn + @vindex LFN AT r{ environment variable} @subheading Syntax @example *************** either @code{ENODEV} or @code{ENXIO}. *** 147,152 **** --- 148,155 ---- @node _preserve_fncase, file system @findex _preserve_fncase + @vindex FNCASE AT r{ environment variable} + @vindex LFN AT r{ environment variable, and file-name case} @subheading Syntax @example Index: ./src/libc/dos/process/dosexec.txh =================================================================== RCS file: /cvs/djgpp/djgpp/src/libc/dos/process/dosexec.txh,v retrieving revision 1.11 diff -p -c -3 -r1.11 dosexec.txh *** ./src/libc/dos/process/dosexec.txh 29 Jan 2003 12:49:53 -0000 1.11 --- ./src/libc/dos/process/dosexec.txh 4 Mar 2003 18:15:36 -0000 *************** *** 7,12 **** --- 7,15 ---- @findex spawnve @findex spawnvp @findex spawnvpe + @vindex COMSPEC AT r{ environment variable, and }@code{spawn*} + @vindex PATH AT r{ environment variable, and }@code{spawn*} + @vindex CMDLINE AT r{ environment variable, and }@code{spawn*} @subheading Syntax @smallexample Index: ./src/libc/emu387/fpu.txh =================================================================== RCS file: /cvs/djgpp/djgpp/src/libc/emu387/fpu.txh,v retrieving revision 1.3 diff -p -c -3 -r1.3 fpu.txh *** ./src/libc/emu387/fpu.txh 29 Jan 2003 12:50:59 -0000 1.3 --- ./src/libc/emu387/fpu.txh 4 Mar 2003 18:15:36 -0000 *************** if (_detect_80387()) *** 32,37 **** --- 32,39 ---- @c ---------------------------------------------------------------------- @node _8087, cpu @vindex _8087 + @vindex 387 AT r{ environment variable, and numeric coprocessor detection} + @vindex 387 AT r{ environment variable, and math coprocessor detection} @subheading Syntax @example Index: ./src/libc/posix/glob/glob.txh =================================================================== RCS file: /cvs/djgpp/djgpp/src/libc/posix/glob/glob.txh,v retrieving revision 1.6 diff -p -c -3 -r1.6 glob.txh *** ./src/libc/posix/glob/glob.txh 7 Feb 2003 18:13:55 -0000 1.6 --- ./src/libc/posix/glob/glob.txh 4 Mar 2003 18:15:41 -0000 *************** *** 1,6 **** --- 1,8 ---- @node glob, shell @findex glob @tindex glob_t AT r{ type} + @vindex LFN AT r{ environment variable, and file-name globbing} + @vindex FNCASE AT r{ environment variable, and file-name globbing} @subheading Syntax @example Index: ./src/libc/posix/grp/getgrent.txh =================================================================== RCS file: /cvs/djgpp/djgpp/src/libc/posix/grp/getgrent.txh,v retrieving revision 1.6 diff -p -c -3 -r1.6 getgrent.txh *** ./src/libc/posix/grp/getgrent.txh 7 Feb 2003 18:13:55 -0000 1.6 --- ./src/libc/posix/grp/getgrent.txh 4 Mar 2003 18:15:42 -0000 *************** *** 2,7 **** --- 2,8 ---- @node getgrent, unix @findex getgrent @tindex group AT r{ structure} + @vindex GROUP AT r{ environment variable, and group entries} @subheading Syntax @example *************** struct group *getgrent(void); *** 13,19 **** @subheading Description This function returns the next available group entry. Note that for ! MS-DOS, this is simulated. If the environment variable GROUP is set, that is the name of the only group returned, else the only group is "dos". Thus, under DOS, @code{getgrent} will always fail on the second and subsequent calls. --- 14,20 ---- @subheading Description This function returns the next available group entry. Note that for ! MS-DOS, this is simulated. If the environment variable @code{GROUP} is set, that is the name of the only group returned, else the only group is "dos". Thus, under DOS, @code{getgrent} will always fail on the second and subsequent calls. Index: ./src/libc/posix/pwd/pwent.txh =================================================================== RCS file: /cvs/djgpp/djgpp/src/libc/posix/pwd/pwent.txh,v retrieving revision 1.6 diff -p -c -3 -r1.6 pwent.txh *** ./src/libc/posix/pwd/pwent.txh 7 Feb 2003 18:13:55 -0000 1.6 --- ./src/libc/posix/pwd/pwent.txh 4 Mar 2003 18:15:50 -0000 *************** *** 1,6 **** --- 1,9 ---- @node getpwent, unix @findex getpwent @tindex passwd AT r{ structure} + @vindex HOME AT r{ environment variable, and password file entries} + @vindex SHELL AT r{ environment variable, and password file entries} + @vindex COMSPEC AT r{ environment variable, and password file entries} @subheading Syntax @example *************** If the environment variable @code{SHELL} *** 41,48 **** @code{SHELL}. @item ! If @code{SHELL} is not set, but @code{COMSPEC} is, the value of ! @code{COMSPEC}. @item If neither of the above variables is defined, @code{pw_shell} is set to --- 44,51 ---- @code{SHELL}. @item ! If @code{SHELL} is not set, but the environment variable @code{COMSPEC} is, ! the value of @code{COMSPEC}. @item If neither of the above variables is defined, @code{pw_shell} is set to Index: ./src/libc/posix/unistd/getlogin.txh =================================================================== RCS file: /cvs/djgpp/djgpp/src/libc/posix/unistd/getlogin.txh,v retrieving revision 1.5 diff -p -c -3 -r1.5 getlogin.txh *** ./src/libc/posix/unistd/getlogin.txh 29 Jan 2003 12:51:41 -0000 1.5 --- ./src/libc/posix/unistd/getlogin.txh 4 Mar 2003 18:15:50 -0000 *************** *** 1,5 **** --- 1,8 ---- @node getlogin, unix @findex getlogin + @vindex USERNAME AT r{ environment variable, and the user's login ID} + @vindex LOGNAME AT r{ environment variable, and the user's login ID} + @vindex USER AT r{ environment variable, and the user's login ID} @subheading Syntax @example