home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume17 / parseargs / patch01 / TXTPATCH < prev   
Encoding:
Text File  |  1991-03-18  |  9.4 KB  |  415 lines
  1. No differences encountered
  2. *** parseargs1.txt.OLD    Mon Mar 18 09:24:28 1991
  3. --- parseargs1.txt    Mon Mar 18 09:25:29 1991
  4. ***************
  5. *** 607,615 ****
  6.        If    the environment    variable ``PARSECNTL'' is empty    or
  7.        undefined,    then parsing behavior set by the programmer is
  8.        used.  If the programmer has not explicitly used
  9. !      parsecntl(3) to modify the    parsing    behavior will be
  10. !      ``!Prompt + !Ignore'' for Unix MS-DOS, OS/2, and AmigaDOS
  11. !      systems, and ``Prompt'' for VMS systems.
  12.   
  13.   USAGE MESSAGES
  14.        Through the use of    an environment variable    (or a VMS
  15. --- 607,616 ----
  16.        If    the environment    variable ``PARSECNTL'' is empty    or
  17.        undefined,    then parsing behavior set by the programmer is
  18.        used.  If the programmer has not explicitly used
  19. !      parsecntl(3) to modify the    parsing    behavior, then the
  20. !      default behavior will be ``Flags1st'' for Unix systems,
  21. !      ``!Prompt + !Ignore'' for AmigaDOS    systems, ``CaseIgnore''
  22. !      for MS-DOS    and OS/2 systems, and ``Prompt'' for VMS systems.
  23.   
  24.   USAGE MESSAGES
  25.        Through the use of    an environment variable    (or a VMS
  26. ***************
  27. *** 650,656 ****
  28.        Description
  29.         The command description is printed.
  30.   
  31. -      Terse
  32.   
  33.   
  34.   
  35. --- 651,656 ----
  36. ***************
  37. *** 665,670 ****
  38. --- 665,671 ----
  39.   
  40.   
  41.   
  42. +      Terse
  43.         Terse    mode, just print command-line synopsis.
  44.   
  45.        Verbose
  46. ***************
  47. *** 716,722 ****
  48.               FALSE (an empty string).
  49.   
  50.         -X        A Boolean ``X Rated'' flag.     This is not
  51. -             printed in the usage message.
  52.   
  53.   
  54.   
  55. --- 717,722 ----
  56. ***************
  57. *** 731,736 ****
  58. --- 731,738 ----
  59.   
  60.   
  61.   
  62. +             printed in the usage message.
  63. + 
  64.        The two positional    arguments are both strings, as is the
  65.        final list.  If we    were to    invoke the above script    with the
  66.        following command line:
  67. ***************
  68. *** 781,788 ****
  69.   
  70.        ##    parse command-line and save assignments    in a temporary file ##
  71.        parseargs -s sh -e    ARGUMENTS -u --    "$NAME"    "$@" >/tmp/tmp$$
  72. -      if    [ $? -ne 0 ]
  73. -        then rm -f /tmp/tmp$$; exit 2  ## non-zero status (usage    given)
  74.   
  75.   
  76.   
  77. --- 783,788 ----
  78. ***************
  79. *** 797,802 ****
  80. --- 797,804 ----
  81.   
  82.   
  83.   
  84. +      if    [ $? -ne 0 ]
  85. +        then rm -f /tmp/tmp$$; exit 2  ## non-zero status (usage    given)
  86.        fi
  87.   
  88.        ##    evaluate results from parseargs    and remove temporary file
  89. ***************
  90. *** 846,857 ****
  91.        4      A syntax error was encountered in the    argument
  92.         specification    string that was    specified to parseargs.
  93.   
  94. - FILES
  95. -      /usr/local/parseargs.pl
  96. -       This file defines a perl function named parseargs to
  97.   
  98.   
  99.   
  100.   Page 13
  101.   
  102.   
  103. --- 848,857 ----
  104.        4      A syntax error was encountered in the    argument
  105.         specification    string that was    specified to parseargs.
  106.   
  107.   
  108.   
  109.   
  110. + 
  111.   Page 13
  112.   
  113.   
  114. ***************
  115. *** 863,868 ****
  116. --- 863,871 ----
  117.   
  118.   
  119.   
  120. + FILES
  121. +      /usr/local/parseargs.pl
  122. +       This file defines a perl function named parseargs to
  123.         parse    arguments more conveniently for    perl-scripts. The
  124.         function is both documented and implemented in this
  125.         file.    The user should    ``require'' this file in his/her
  126. ***************
  127. *** 913,923 ****
  128.        Hence multiple ``leading dash'' arguments may specified as
  129.        follows:
  130.   
  131. -       -f-dash_arg1 -f-dash_arg2  ...
  132.   
  133.   
  134. - 
  135. - 
  136.   Page 14
  137.   
  138.   
  139. --- 916,923 ----
  140. ***************
  141. *** 929,934 ****
  142. --- 929,936 ----
  143.   
  144.   
  145.   
  146. +       -f-dash_arg1 -f-dash_arg2  ...
  147. + 
  148.   BUGS
  149.        It    does not make sense to use any arguments of type argTBool
  150.        since parseargs currently has no way of knowing what the
  151. ***************
  152. *** 971,978 ****
  153.   AUTHOR
  154.        Brad Appleton  (brad@ssd.csd.harris.com)
  155.        Harris Computer Systems, Fort Lauderdale, FL USA
  156. - 
  157. - 
  158.   
  159.   
  160.   
  161. --- 973,978 ----
  162. *** parseargs3.txt.OLD    Mon Mar 18 09:24:29 1991
  163. --- parseargs3.txt    Mon Mar 18 09:25:47 1991
  164. ***************
  165. *** 643,656 ****
  166.        If    the environment    variable ``PARSECNTL'' is empty    or unde-
  167.        fined, then parsing behavior set by the programmer    is used.
  168.        If    the programmer has not explicitly used parsecntl(3) to
  169. !      modify the    parsing    behavior will be ``!Prompt + !Ignore''
  170. !      for Unix MS-DOS, OS/2, and    AmigaDOS systems, and ``Prompt''
  171. !      for VMS systems.
  172.   
  173.   USAGE MESSAGES
  174.        Through the use of    an environment variable    (or a VMS sym-
  175.        bol), the user may    control    the syntax and the verbosity of
  176. -      the command-usage messages    that are printed by parseargs.
  177.   
  178.   
  179.   
  180. --- 643,656 ----
  181.        If    the environment    variable ``PARSECNTL'' is empty    or unde-
  182.        fined, then parsing behavior set by the programmer    is used.
  183.        If    the programmer has not explicitly used parsecntl(3) to
  184. !      modify the    parsing    behavior, then the default behavior will
  185. !      be    ``Flags1st'' for Unix systems, ``!Prompt + !Ignore'' for
  186. !      AmigaDOS systems, ``CaseIgnore'' for MS-DOS and OS/2 sys-
  187. !      tems, and ``Prompt'' for VMS systems.
  188.   
  189.   USAGE MESSAGES
  190.        Through the use of    an environment variable    (or a VMS sym-
  191.        bol), the user may    control    the syntax and the verbosity of
  192.   
  193.   
  194.   
  195. ***************
  196. *** 665,670 ****
  197. --- 665,671 ----
  198.   
  199.   
  200.   
  201. +      the command-usage messages    that are printed by parseargs.
  202.        The desired level of verbosity may    be set by defining the
  203.        environment variable ``USAGECNTL" to be a combination of
  204.        strings (case insensitive). The value of each string con-
  205. ***************
  206. *** 715,725 ****
  207.         Same as LongOpts.
  208.   
  209.   
  210. -      If    the environment    variable ``USAGECNTL'' is empty    or unde-
  211. -      fined, then the default usage level (which    is presently
  212.   
  213.   
  214.   
  215.   Page 11
  216.   
  217.   
  218. --- 716,725 ----
  219.         Same as LongOpts.
  220.   
  221.   
  222.   
  223.   
  224.   
  225. + 
  226.   Page 11
  227.   
  228.   
  229. ***************
  230. *** 731,736 ****
  231. --- 731,738 ----
  232.   
  233.   
  234.   
  235. +      If    the environment    variable ``USAGECNTL'' is empty    or unde-
  236. +      fined, then the default usage level (which    is presently
  237.        ``Verbose + Options'') will be used.
  238.   
  239.   MULTI-VALUED ARGUMENTS
  240. ***************
  241. *** 781,791 ****
  242.         ( StrVec.array[ StrVec.count ] == (char *)NULL )
  243.   
  244.        is    always true, and character-vectors will    always have an
  245. -      extra NUL-character at the    end such that:
  246.   
  247.   
  248.   
  249. - 
  250.   Page 12
  251.   
  252.   
  253. --- 783,791 ----
  254. ***************
  255. *** 797,802 ****
  256. --- 797,804 ----
  257.   
  258.   
  259.   
  260. +      extra NUL-character at the    end such that:
  261. + 
  262.         ( CharVec.array[ CharVec.count ] == '\0' )
  263.   
  264.        is    always true. Integer and floating point    vectors    contain
  265. ***************
  266. *** 847,854 ****
  267.               i, StrVec.array[i], StrVec.flags[i] );
  268.   
  269.            for ( i = 0 ; i < NumVec.count ; i++ )
  270. -         printf(    "Number[%d]=%s,    flags=%x\n",
  271. -             i, NumVec.array[i], NumVec.flags[i] );
  272.   
  273.   
  274.   
  275. --- 849,854 ----
  276. ***************
  277. *** 863,868 ****
  278. --- 863,871 ----
  279.   
  280.   
  281.   
  282. +         printf(    "Number[%d]=%s,    flags=%x\n",
  283. +             i, NumVec.array[i], NumVec.flags[i] );
  284. + 
  285.            listFree( StrList );
  286.            StrList = ARGLISTNULL;
  287.   
  288. ***************
  289. *** 912,920 ****
  290.         typedef ARGVEC_T(FILE    *)  FILEvec_t;
  291.   
  292.         BOOL    argReadFile(  ARGDESC *ad,  char *vp,  BOOL copyf  )
  293. -       {
  294. -            register    FILE *fp;
  295. -            fp = fopen(vp, "r");
  296.   
  297.   
  298.   
  299. --- 915,920 ----
  300. ***************
  301. *** 929,934 ****
  302. --- 929,938 ----
  303.   
  304.   
  305.   
  306. +       {
  307. +            register    FILE *fp;
  308. +            fp = fopen(vp, "r");
  309. + 
  310.              if ( ! fp ) {
  311.               usrerr("cannot open    '%s' for reading", vp);
  312.               return (FALSE);
  313. ***************
  314. *** 978,989 ****
  315.        ment descriptor) is always    used to    match for possible argu-
  316.        ments (or keywords, or qualifiers).
  317.   
  318. -      For all supported operating systems, a long option    may be
  319. -      matched in    one of two ways: it may    match all uppercase char-
  320. -      acters in the prompt field, or it may match all characters
  321.   
  322.   
  323. - 
  324.   Page 15
  325.   
  326.   
  327. --- 982,989 ----
  328. ***************
  329. *** 995,1000 ****
  330. --- 995,1003 ----
  331.   
  332.   
  333.   
  334. +      For all supported operating systems, a long option    may be
  335. +      matched in    one of two ways: it may    match all uppercase char-
  336. +      acters in the prompt field, or it may match all characters
  337.        in    the prompt field (as in    ``+count=4'' and ``+rep-
  338.        count=4'').
  339.   
  340. ***************
  341. *** 1045,1055 ****
  342.         the pc_ARGFLAGS functions code) was found in the given
  343.         argdesc-array    or in its default-list.
  344.   
  345. -      pe_BADMODE
  346. -       Bad mode for given command in    parsecntl. This    occurs
  347.   
  348.   
  349. - 
  350.   Page 16
  351.   
  352.   
  353. --- 1048,1055 ----
  354. ***************
  355. *** 1061,1066 ****
  356. --- 1061,1068 ----
  357.   
  358.   
  359.   
  360. +      pe_BADMODE
  361. +       Bad mode for given command in    parsecntl. This    occurs
  362.         when pc_WRITE    or pc_RDWR mode    is passed to parsecntl in
  363.         conjunction with the pc_ARGFLAGS functions code.  Par-
  364.         secntl will not modify existing arguments.
  365. ***************
  366. *** 1110,1121 ****
  367.   
  368.         -f-dash_arg1 -f-dash_arg2  ...
  369.   
  370. - BUGS
  371. -      When a non-multivalued argument appears more than once on
  372. -      the command-line then only    the last value supplied    is used.
  373.   
  374.   
  375.   
  376.   Page 17
  377.   
  378.   
  379. --- 1112,1121 ----
  380.   
  381.         -f-dash_arg1 -f-dash_arg2  ...
  382.   
  383.   
  384.   
  385.   
  386. + 
  387.   Page 17
  388.   
  389.   
  390. ***************
  391. *** 1127,1132 ****
  392. --- 1127,1135 ----
  393.   
  394.   
  395.   
  396. + BUGS
  397. +      When a non-multivalued argument appears more than once on
  398. +      the command-line then only    the last value supplied    is used.
  399.        A problem occurs however in the following scenario: suppose
  400.        `-s' is an    option that takes an optional string argument (nd
  401.        suppose `-x' is some boolean flag). Then if the following
  402. ***************
  403. *** 1156,1164 ****
  404.        argument flags ARGPOS, ARGVALOPT, ARGVALREQ, ARGVALGIVEN,
  405.        ARGNOVAL, and ARGVEC; and VAX/VMS version and IBM-PC version
  406.        by    Brad Appleton
  407. - 
  408. - 
  409. - 
  410.   
  411.   
  412.   
  413. --- 1159,1164 ----
  414. No differences encountered
  415.