home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / misc / volume20 / parseargs / patch07 / PATCH07
Encoding:
Text File  |  1991-07-17  |  9.8 KB  |  252 lines
  1. *** Intro.OLD    Mon Jul 15 10:28:10 1991
  2. --- Intro    Wed Jun  5 10:38:05 1991
  3. ***************
  4. *** 73,79 ****
  5.    Once the above array/string is declared it is a simple matter to invoke
  6.    parseargs from C as in the following example:
  7.   
  8. !     status = parseargs( argdesc_array, argv );
  9.   
  10.    or from a shell script as in the following example:
  11.   
  12. --- 73,79 ----
  13.    Once the above array/string is declared it is a simple matter to invoke
  14.    parseargs from C as in the following example:
  15.   
  16. !     status = parseargs( argv, argdesc_array );
  17.   
  18.    or from a shell script as in the following example:
  19.   
  20. *** README.OLD    Mon Jul 15 10:28:33 1991
  21. --- README    Fri Jun 21 10:10:30 1991
  22. ***************
  23. *** 332,338 ****
  24.    name for shell scripts. Furthermore, I changed the contents of USAGECNTL
  25.    from a number to a sequence of mnemonic strings (for better readability).
  26.    I also made USAGECNTL control whether or not a command-description is
  27. !  printed and whther or not the message is piped to a pager on Unix.
  28.   
  29.    Under VMS, the global symbol USAGECNTL is used in lieu of an environment
  30.    variable.  See the parseargs(3) and parseargs(1) manual pages for more
  31. --- 332,338 ----
  32.    name for shell scripts. Furthermore, I changed the contents of USAGECNTL
  33.    from a number to a sequence of mnemonic strings (for better readability).
  34.    I also made USAGECNTL control whether or not a command-description is
  35. !  printed and whether or not the message is piped to a pager on Unix.
  36.   
  37.    Under VMS, the global symbol USAGECNTL is used in lieu of an environment
  38.    variable.  See the parseargs(3) and parseargs(1) manual pages for more
  39. ***************
  40. *** 360,367 ****
  41.    Programs that use parseargs may be given default arguments under UNIX
  42.    and PCs through the use of environment variables (symbols are used for
  43.    VMS systems). If a C-program or a shell-script uses parseargs to imple-
  44. !  ment a command named "foo" then the environment variable (or global
  45. !  synbol) FOO_ARGS will be parsed for any "default" arguments before argv
  46.    is parsed.  Argv will over-ride any options that are specified in
  47.    FOO_ARGS (except that ARGLISTs and ARGVECs set in FOO_ARGS will be
  48.    appended from argv[]).
  49. --- 360,367 ----
  50.    Programs that use parseargs may be given default arguments under UNIX
  51.    and PCs through the use of environment variables (symbols are used for
  52.    VMS systems). If a C-program or a shell-script uses parseargs to imple-
  53. !  -ment a command named "foo" then the environment variable (or global
  54. !  symbol) FOO_ARGS will be parsed for any "default" arguments before argv
  55.    is parsed.  Argv will over-ride any options that are specified in
  56.    FOO_ARGS (except that ARGLISTs and ARGVECs set in FOO_ARGS will be
  57.    appended from argv[]).
  58. ***************
  59. *** 765,770 ****
  60. --- 765,797 ----
  61.    AT&T Unix Systems using both ANSI and non-ANSI C Compilers.
  62.   
  63.   
  64. +  COMPILE-TIME CONSTANTS
  65. +  ======================
  66. +  If any of the following macros are #defined at compile time then they will
  67. +  have the following effect:
  68. + 
  69. +     USE_PAGER    --  for Unix systems only. Parseargs will include the code
  70. +                      which pipes usage messages to a paging program
  71. + 
  72. +     NOFLOAT      --  Parseargs will NOT include the code for the predefined
  73. +                      floating point arg-types argFloat() and argDouble().
  74. + 
  75. +     SVR4         --  Parseargs(1) with the -M option will generate the new
  76. +                      Style Unix manual template.
  77. + 
  78. +     USE_CURSES
  79. +     USE_TERMINFO
  80. +     USE_TERMCAP  --  Parseargs will use curses/terminfo/termcap when trying
  81. +                      to figure out the size of the screen.
  82. + 
  83. +     UNWRITABLE_STRING_LITERALS
  84. +                  --  This should be used only for compilers and/or machines
  85. +                      that do NOT allow the programmer to modify the contents
  86. +                      of string literals such as "hello, world". If this
  87. +                      constant is #defined, then all modified strings will be
  88. +                      duplicated (using strdup()) before they are changed.
  89. + 
  90. + 
  91.    IBM-PC VERSION OF parseargs(3)
  92.    ==============================
  93.    I also added ibm_args.c for MS-DOS and OS/2.
  94. ***************
  95. *** 794,803 ****
  96.    ===============================
  97.    I also added vms_args.c for VAX/VMS.
  98.   
  99. !  VMS_ARGS.C HAS NOT BEEN TESTED ON A VMS SYSTEM!!! I did not have one
  100. !  to test it on. It should accept command-line arguments as described in
  101. !  the "Grammar Rules" section of the VAX manual but I  cant guarantee
  102. !  anything so you'll have to test it out for yourself.
  103.   
  104.    ARGLIST and ARGVEC are comma-separated lists in the VMS version of
  105.    parseargs (not whitespace separated lists). In order to preserve a
  106. --- 821,831 ----
  107.    ===============================
  108.    I also added vms_args.c for VAX/VMS.
  109.   
  110. !  vms_args.c has been tested by people (other than myself) on a VAX/VMS
  111. !  system and seems to work okay. It does not use the CLI$XXXXX routines
  112. !  for parsing. It should accept command-line arguments as described in
  113. !  the "Grammar Rules" section of the VAX manual with one slight exception
  114. !  which is noted below.
  115.   
  116.    ARGLIST and ARGVEC are comma-separated lists in the VMS version of
  117.    parseargs (not whitespace separated lists). In order to preserve a
  118. ***************
  119. *** 890,901 ****
  120.   
  121.    Thanx also to Jim Barbour for helping me with some VMS specific things
  122.    (like getting the original, unparsed command-line from DCL and
  123. !  retreiving the value of a symbol), and to Tom Christiansen and Raymond
  124.    Chen for their help in getting parseargs(1) to work for perl scripts.
  125.   
  126. !  Thanx also to Gillmer J. Derge, Marco Nijdam, & Chris Johnston for sending
  127. !  me their bug reports and fixes so that I could incorporate them into the
  128. !  latest patch of parseargs.
  129.   
  130.    Lastly, thanks to all those who use and will continue to improve
  131.    parseargs, all I ask is that you keep me updated of your efforts (so I
  132. --- 918,929 ----
  133.   
  134.    Thanx also to Jim Barbour for helping me with some VMS specific things
  135.    (like getting the original, unparsed command-line from DCL and
  136. !  retrieving the value of a symbol), and to Tom Christiansen and Raymond
  137.    Chen for their help in getting parseargs(1) to work for perl scripts.
  138.   
  139. !  Thanx also to Gillmer J. Derge, Marco Nijdam, Chris Johnston, & Earl Chew
  140. !  for sending me their bug reports and fixes so that I could incorporate them
  141. !  into the latest patch of parseargs.
  142.   
  143.    Lastly, thanks to all those who use and will continue to improve
  144.    parseargs, all I ask is that you keep me updated of your efforts (so I
  145. *** doc/parseargs.man1.OLD    Mon Jul 15 10:30:33 1991
  146. --- doc/parseargs.man1    Tue Jun 18 17:10:00 1991
  147. ***************
  148. *** 219,225 ****
  149.   message printed and execution terminated). Specifying \fB\-1\fP will force
  150.   all non-positional parameters to precede any positional parameters on the
  151.   command-line (hence anything on the command-line after a positional parameter
  152. ! that resembles a keyword parameter will nevertheles be interpreted as a
  153.   positional parameter).
  154.   .\"----------------------------------------------------------------
  155.   .so argvalopt.inc
  156. --- 219,225 ----
  157.   message printed and execution terminated). Specifying \fB\-1\fP will force
  158.   all non-positional parameters to precede any positional parameters on the
  159.   command-line (hence anything on the command-line after a positional parameter
  160. ! that resembles a keyword parameter will nevertheless be interpreted as a
  161.   positional parameter).
  162.   .\"----------------------------------------------------------------
  163.   .so argvalopt.inc
  164. *** patchlevel.h.OLD    Mon Jul 15 10:32:11 1991
  165. --- patchlevel.h    Mon Jul 15 10:18:26 1991
  166. ***************
  167. *** 2,7 ****
  168. --- 2,18 ----
  169.   ** ^FILE: patchlevel.h - current patchlevel for parseargs
  170.   **
  171.   ** ^HISTORY:
  172. + **    06/05/91    Brad Appleton    <brad@ssd.csd.harris.com>
  173. + **    Patch07
  174. + **    - fixed the "Intro" file to correctly show how to invoke parseargs(3)
  175. + **      (the arguments where in the wrong order).
  176. + **    - added stuff in #ifdef UNWRITABLE_STRING_LITERALS to work for machines
  177. + **      and compilers that dont allow the programmer to modify string literals.
  178. + **    - documented in the README file, all the various compile-time constants
  179. + **      that may change the behavior of parseargs.
  180. + **    - sparseargs neglected to free the argument-vector when it was done
  181. + **      using it.
  182. + **
  183.   **    05/11/91    Brad Appleton    <brad@ssd.csd.harris.com>
  184.   **    Patch06
  185.   **    - parsecntl(3) now correctly handles mispelled keywords for the
  186. ***************
  187. *** 80,86 ****
  188.   
  189.   #define  VERSION     2
  190.   #define  REVISION    0
  191. ! #define  PATCHLEVEL  6
  192.   
  193.   #ifdef __STDC__
  194.      static const char
  195. --- 91,97 ----
  196.   
  197.   #define  VERSION     2
  198.   #define  REVISION    0
  199. ! #define  PATCHLEVEL  7
  200.   
  201.   #ifdef __STDC__
  202.      static const char
  203. ***************
  204. *** 87,90 ****
  205.   #else
  206.      static char
  207.   #endif
  208. !    _Ident[] = "@(#)parseargs  2.0  patchlevel 6";
  209. --- 98,101 ----
  210.   #else
  211.      static char
  212.   #endif
  213. !    _Ident[] = "@(#)parseargs  2.0  patchlevel 7";
  214. *** xparse.c.OLD    Mon Jul 15 10:33:49 1991
  215. --- xparse.c    Wed Jun 19 09:38:14 1991
  216. ***************
  217. *** 542,547 ****
  218. --- 542,551 ----
  219.         if (ARG_isBOOLEAN(ad) || ARG_isPSEUDOARG(ad))
  220.            BSET( arg_flags(ad), ARGNOVAL );
  221.   
  222. + #ifdef UNWRITABLE_STRING_LITERALS
  223. +       ad->ad_prompt = strdup( ad->ad_prompt );
  224. + #endif
  225. + 
  226.         description = get_description( (char *)arg_sname(ad) );
  227.         if ( description )  {
  228.            BSET(arg_flags(ad), ARGDESCRIBED);
  229. ***************
  230. *** 576,581 ****
  231. --- 580,589 ----
  232.      }
  233.   #endif
  234.   
  235. + #ifdef UNWRITABLE_STRING_LITERALS
  236. +    cmd_name(argd) = strdup( cmd_name(argd) );
  237. + #endif
  238. + 
  239.        /* if new-style, get the purpose from the command name */
  240.      if ( !old_style  &&  cmd_name(argd) ) {
  241.         purpose = get_description( (char *)cmd_name(argd) );
  242. ***************
  243. *** 1881,1886 ****
  244. --- 1889,1895 ----
  245.      }
  246.   
  247.      rc = parse_argv_style( argv, parse_init( &argd ) );
  248. +    free( argv );
  249.   
  250.         /* scan for missing required arguments */
  251.      if ( SYNTAX_ERROR(rc, argd) ) {
  252.