home *** CD-ROM | disk | FTP | other *** search
open in: 
MacOS 8.1
|
Win98
|
DOS
browse contents |
view JSON data
|
view as text
This file was processed as: SHell self-extracting ARchive
(archive/shar).
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 100%
| dexvert
| Newsgroup Content (archive/news)
| magic
| Supported |
| 100%
| dexvert
| SHell self-extracting ARchive (archive/shar)
| magic
| Supported |
| 100%
| dexvert
| Internet Message Format (text/imf)
| magic
| Supported |
| 1%
| dexvert
| Text File (text/txt)
| fallback
| Supported |
| 100%
| file
| news or mail, ASCII text
| default
| |
| 100%
| TrID
| E-Mail message (Var. 2)
| default
| |
| 100%
| checkBytes
| Printable ASCII
| default
| |
| 100%
| perlTextCheck
| Likely Text (Perl)
| default
| |
| 100%
| siegfried
| fmt/329 Shell Archive Format
| default
| |
| 100%
| detectItEasy
| Format: plain text[LF]
| default (weak)
| |
| 100%
| xdgMime
| message/rfc822
| default
|
|
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 46 72 6f 6d 3a 20 62 72 | 61 64 40 68 63 78 31 2e |From: br|ad@hcx1.|
|00000010| 73 73 64 2e 63 73 64 2e | 68 61 72 72 69 73 2e 63 |ssd.csd.|harris.c|
|00000020| 6f 6d 20 28 42 72 61 64 | 20 41 70 70 6c 65 74 6f |om (Brad| Appleto|
|00000030| 6e 29 0a 4e 65 77 73 67 | 72 6f 75 70 73 3a 20 63 |n).Newsg|roups: c|
|00000040| 6f 6d 70 2e 73 6f 75 72 | 63 65 73 2e 6d 69 73 63 |omp.sour|ces.misc|
|00000050| 0a 53 75 62 6a 65 63 74 | 3a 20 76 31 38 69 31 30 |.Subject|: v18i10|
|00000060| 31 3a 20 20 70 61 72 73 | 65 61 72 67 73 20 2d 20 |1: pars|eargs - |
|00000070| 66 75 6e 63 74 69 6f 6e | 73 20 74 6f 20 70 61 72 |function|s to par|
|00000080| 73 65 20 63 6f 6d 6d 61 | 6e 64 20 6c 69 6e 65 20 |se comma|nd line |
|00000090| 61 72 67 75 6d 65 6e 74 | 73 2c 20 50 61 74 63 68 |argument|s, Patch|
|000000a0| 30 34 61 2f 34 0a 4d 65 | 73 73 61 67 65 2d 49 44 |04a/4.Me|ssage-ID|
|000000b0| 3a 20 3c 31 39 39 31 41 | 70 72 32 36 2e 30 33 35 |: <1991A|pr26.035|
|000000c0| 36 35 31 2e 31 38 36 39 | 37 40 73 70 61 72 6b 79 |651.1869|7@sparky|
|000000d0| 2e 49 4d 44 2e 53 74 65 | 72 6c 69 6e 67 2e 43 4f |.IMD.Ste|rling.CO|
|000000e0| 4d 3e 0a 44 61 74 65 3a | 20 32 36 20 41 70 72 20 |M>.Date:| 26 Apr |
|000000f0| 39 31 20 30 33 3a 35 36 | 3a 35 31 20 47 4d 54 0a |91 03:56|:51 GMT.|
|00000100| 41 70 70 72 6f 76 65 64 | 3a 20 6b 65 6e 74 40 73 |Approved|: kent@s|
|00000110| 70 61 72 6b 79 2e 69 6d | 64 2e 73 74 65 72 6c 69 |parky.im|d.sterli|
|00000120| 6e 67 2e 63 6f 6d 0a 58 | 2d 43 68 65 63 6b 73 75 |ng.com.X|-Checksu|
|00000130| 6d 2d 53 6e 65 66 72 75 | 3a 20 61 61 31 30 62 34 |m-Snefru|: aa10b4|
|00000140| 34 31 20 30 31 37 32 66 | 34 32 64 20 32 36 33 38 |41 0172f|42d 2638|
|00000150| 66 65 64 39 20 39 33 31 | 38 32 64 39 30 0a 0a 53 |fed9 931|82d90..S|
|00000160| 75 62 6d 69 74 74 65 64 | 2d 62 79 3a 20 42 72 61 |ubmitted|-by: Bra|
|00000170| 64 20 41 70 70 6c 65 74 | 6f 6e 20 3c 62 72 61 64 |d Applet|on <brad|
|00000180| 40 68 63 78 31 2e 73 73 | 64 2e 63 73 64 2e 68 61 |@hcx1.ss|d.csd.ha|
|00000190| 72 72 69 73 2e 63 6f 6d | 3e 0a 50 6f 73 74 69 6e |rris.com|>.Postin|
|000001a0| 67 2d 6e 75 6d 62 65 72 | 3a 20 56 6f 6c 75 6d 65 |g-number|: Volume|
|000001b0| 20 31 38 2c 20 49 73 73 | 75 65 20 31 30 31 0a 41 | 18, Iss|ue 101.A|
|000001c0| 72 63 68 69 76 65 2d 6e | 61 6d 65 3a 20 70 61 72 |rchive-n|ame: par|
|000001d0| 73 65 61 72 67 73 2f 70 | 61 74 63 68 30 34 61 0a |seargs/p|atch04a.|
|000001e0| 50 61 74 63 68 2d 54 6f | 3a 20 70 61 72 73 65 61 |Patch-To|: parsea|
|000001f0| 72 67 73 3a 20 56 6f 6c | 75 6d 65 20 31 37 2c 20 |rgs: Vol|ume 17, |
|00000200| 49 73 73 75 65 20 34 35 | 2d 35 37 0a 0a 54 68 69 |Issue 45|-57..Thi|
|00000210| 73 20 69 73 20 70 61 74 | 63 68 30 34 20 66 6f 72 |s is pat|ch04 for|
|00000220| 20 70 61 72 73 65 61 72 | 67 73 2e 20 49 74 20 69 | parsear|gs. It i|
|00000230| 73 20 61 20 66 6f 75 72 | 20 70 61 72 74 20 70 61 |s a four| part pa|
|00000240| 74 63 68 20 74 68 61 74 | 20 79 6f 75 20 77 69 6c |tch that| you wil|
|00000250| 6c 20 6e 65 65 64 0a 74 | 6f 20 75 6e 73 68 61 72 |l need.t|o unshar|
|00000260| 20 69 6e 20 6f 72 64 65 | 72 2e 20 20 49 74 20 66 | in orde|r. It f|
|00000270| 69 78 65 73 20 73 6f 6d | 65 20 6d 61 6a 6f 72 20 |ixes som|e major |
|00000280| 62 75 67 73 2c 20 61 20 | 66 65 77 20 6d 69 6e 6f |bugs, a |few mino|
|00000290| 72 20 6f 6e 65 73 2c 20 | 61 6e 64 0a 63 6f 72 72 |r ones, |and.corr|
|000002a0| 65 63 74 73 20 73 6f 6d | 65 20 6d 6f 72 65 20 65 |ects som|e more e|
|000002b0| 72 72 6f 72 73 20 69 6e | 20 74 68 65 20 64 6f 63 |rrors in| the doc|
|000002c0| 75 6d 65 6e 74 61 74 69 | 6f 6e 2e 20 54 77 6f 20 |umentati|on. Two |
|000002d0| 6e 65 77 20 66 69 6c 65 | 73 20 61 72 65 20 67 69 |new file|s are gi|
|000002e0| 76 65 6e 20 68 65 72 65 | 0a 28 70 61 74 63 68 6c |ven here|.(patchl|
|000002f0| 65 76 65 6c 2e 68 20 26 | 20 64 6f 63 2f 65 66 66 |evel.h &| doc/eff|
|00000300| 65 63 74 73 2e 69 6e 63 | 29 2e 20 54 77 6f 20 6f |ects.inc|). Two o|
|00000310| 6c 64 20 66 69 6c 65 73 | 20 61 72 65 20 72 65 73 |ld files| are res|
|00000320| 75 62 6d 69 74 74 65 64 | 20 28 4d 61 6b 65 66 69 |ubmitted| (Makefi|
|00000330| 6c 65 20 26 0a 64 6f 63 | 2f 4d 61 6b 65 66 69 6c |le &.doc|/Makefil|
|00000340| 65 29 20 61 6d 64 20 74 | 77 6f 20 70 61 74 63 68 |e) amd t|wo patch|
|00000350| 66 69 6c 65 73 20 61 72 | 65 20 69 6e 63 6c 75 64 |files ar|e includ|
|00000360| 65 64 20 28 50 41 54 43 | 48 20 61 6e 64 20 44 4f |ed (PATC|H and DO|
|00000370| 43 50 41 54 43 48 29 2e | 0a 0a 20 5f 5f 5f 5f 5f |CPATCH).|.. _____|
|00000380| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00000390| 5f 20 22 41 6e 64 20 6d | 69 6c 65 73 20 74 6f 20 |_ "And m|iles to |
|000003a0| 67 6f 20 62 65 66 6f 72 | 65 20 49 20 73 6c 65 65 |go befor|e I slee|
|000003b0| 70 2e 22 20 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |p." ____|________|
|000003c0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 0a 20 42 72 61 64 |________|__. Brad|
|000003d0| 20 41 70 70 6c 65 74 6f | 6e 20 20 20 20 20 20 20 | Appleto|n |
|000003e0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000003f0| 20 20 48 61 72 72 69 73 | 20 43 6f 72 70 2e 2c 20 | Harris| Corp., |
|00000400| 43 6f 6d 70 75 74 65 72 | 20 53 79 73 74 65 6d 73 |Computer| Systems|
|00000410| 20 44 69 76 69 73 69 6f | 6e 0a 20 20 20 53 6f 66 | Divisio|n. Sof|
|00000420| 74 77 61 72 65 20 45 6e | 67 69 6e 65 65 72 20 20 |tware En|gineer |
|00000430| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00000440| 20 32 31 30 31 20 57 65 | 73 74 20 43 79 70 72 65 | 2101 We|st Cypre|
|00000450| 73 73 20 43 72 65 65 6b | 20 52 6f 61 64 2c 20 20 |ss Creek| Road, |
|00000460| 4d 2f 53 20 31 36 31 20 | 0a 20 20 20 20 20 62 72 |M/S 161 |. br|
|00000470| 61 64 40 73 73 64 2e 63 | 73 64 2e 68 61 72 72 69 |ad@ssd.c|sd.harri|
|00000480| 73 2e 63 6f 6d 20 20 20 | 20 20 20 20 20 20 20 20 |s.com | |
|00000490| 46 6f 72 74 20 4c 61 75 | 64 65 72 64 61 6c 65 2c |Fort Lau|derdale,|
|000004a0| 20 46 4c 20 20 33 33 33 | 30 39 2d 31 38 39 32 20 | FL 333|09-1892 |
|000004b0| 20 55 53 41 0a 20 20 20 | 20 20 20 20 2e 2e 2e 21 | USA. | ...!|
|000004c0| 75 75 6e 65 74 21 68 63 | 78 31 21 62 72 61 64 20 |uunet!hc|x1!brad |
|000004d0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000004e0| 50 68 6f 6e 65 3a 20 28 | 33 30 35 29 20 39 37 33 |Phone: (|305) 973|
|000004f0| 2d 35 33 36 30 0a 20 7e | 7e 7e 7e 7e 7e 7e 7e 7e |-5360. ~|~~~~~~~~|
|00000500| 7e 7e 7e 7e 7e 7e 7e 7e | 7e 7e 7e 20 44 69 73 63 |~~~~~~~~|~~~ Disc|
|00000510| 6c 61 69 6d 65 72 3a 20 | 49 20 73 61 69 64 20 69 |laimer: |I said i|
|00000520| 74 2c 20 6e 6f 74 20 6d | 79 20 63 6f 6d 70 61 6e |t, not m|y compan|
|00000530| 79 21 20 7e 7e 7e 7e 7e | 7e 7e 7e 7e 7e 7e 7e 7e |y! ~~~~~|~~~~~~~~|
|00000540| 7e 7e 7e 7e 7e 7e 0a 23 | 21 2f 62 69 6e 2f 73 68 |~~~~~~.#|!/bin/sh|
|00000550| 0a 23 20 54 68 69 73 20 | 69 73 20 61 20 73 68 65 |.# This |is a she|
|00000560| 6c 6c 20 61 72 63 68 69 | 76 65 20 28 70 72 6f 64 |ll archi|ve (prod|
|00000570| 75 63 65 64 20 62 79 20 | 73 68 61 72 20 33 2e 34 |uced by |shar 3.4|
|00000580| 39 29 0a 23 20 54 6f 20 | 65 78 74 72 61 63 74 20 |9).# To |extract |
|00000590| 74 68 65 20 66 69 6c 65 | 73 20 66 72 6f 6d 20 74 |the file|s from t|
|000005a0| 68 69 73 20 61 72 63 68 | 69 76 65 2c 20 73 61 76 |his arch|ive, sav|
|000005b0| 65 20 69 74 20 74 6f 20 | 61 20 66 69 6c 65 2c 20 |e it to |a file, |
|000005c0| 72 65 6d 6f 76 65 0a 23 | 20 65 76 65 72 79 74 68 |remove.#| everyth|
|000005d0| 69 6e 67 20 61 62 6f 76 | 65 20 74 68 65 20 22 21 |ing abov|e the "!|
|000005e0| 2f 62 69 6e 2f 73 68 22 | 20 6c 69 6e 65 20 61 62 |/bin/sh"| line ab|
|000005f0| 6f 76 65 2c 20 61 6e 64 | 20 74 79 70 65 20 22 73 |ove, and| type "s|
|00000600| 68 20 66 69 6c 65 5f 6e | 61 6d 65 22 2e 0a 23 0a |h file_n|ame"..#.|
|00000610| 23 20 6d 61 64 65 20 30 | 34 2f 32 34 2f 31 39 39 |# made 0|4/24/199|
|00000620| 31 20 32 31 3a 35 30 20 | 55 54 43 20 62 79 20 6b |1 21:50 |UTC by k|
|00000630| 65 6e 74 40 73 70 61 72 | 6b 79 2e 49 4d 44 2e 53 |ent@spar|ky.IMD.S|
|00000640| 74 65 72 6c 69 6e 67 2e | 43 4f 4d 0a 23 0a 23 20 |terling.|COM.#.# |
|00000650| 65 78 69 73 74 69 6e 67 | 20 66 69 6c 65 73 20 57 |existing| files W|
|00000660| 49 4c 4c 20 62 65 20 6f | 76 65 72 77 72 69 74 74 |ILL be o|verwritt|
|00000670| 65 6e 0a 23 0a 23 20 54 | 68 69 73 20 69 73 20 70 |en.#.# T|his is p|
|00000680| 61 72 74 20 31 20 6f 66 | 20 61 20 6d 75 6c 74 69 |art 1 of| a multi|
|00000690| 70 61 72 74 20 61 72 63 | 68 69 76 65 20 20 20 20 |part arc|hive |
|000006a0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000006b0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000006c0| 0a 23 20 64 6f 20 6e 6f | 74 20 63 6f 6e 63 61 74 |.# do no|t concat|
|000006d0| 65 6e 61 74 65 20 74 68 | 65 73 65 20 70 61 72 74 |enate th|ese part|
|000006e0| 73 2c 20 75 6e 70 61 63 | 6b 20 74 68 65 6d 20 69 |s, unpac|k them i|
|000006f0| 6e 20 6f 72 64 65 72 20 | 77 69 74 68 20 2f 62 69 |n order |with /bi|
|00000700| 6e 2f 73 68 20 20 20 20 | 20 20 20 20 0a 23 0a 23 |n/sh | .#.#|
|00000710| 20 54 68 69 73 20 73 68 | 61 72 20 63 6f 6e 74 61 | This sh|ar conta|
|00000720| 69 6e 73 3a 0a 23 20 6c | 65 6e 67 74 68 20 20 6d |ins:.# l|ength m|
|00000730| 6f 64 65 20 20 20 20 20 | 20 20 6e 61 6d 65 0a 23 |ode | name.#|
|00000740| 20 2d 2d 2d 2d 2d 2d 20 | 2d 2d 2d 2d 2d 2d 2d 2d | ------ |--------|
|00000750| 2d 2d 20 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |-- -----|--------|
|00000760| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00000770| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 0a 23 20 |--------|-----.# |
|00000780| 20 36 36 31 30 33 20 2d | 72 77 2d 72 77 2d 72 2d | 66103 -|rw-rw-r-|
|00000790| 2d 20 44 4f 43 50 41 54 | 43 48 0a 23 20 20 20 34 |- DOCPAT|CH.# 4|
|000007a0| 36 31 30 20 2d 72 77 2d | 72 77 2d 72 2d 2d 20 4d |610 -rw-|rw-r-- M|
|000007b0| 61 6b 65 66 69 6c 65 0a | 23 20 20 37 39 30 33 34 |akefile.|# 79034|
|000007c0| 20 2d 72 77 2d 72 77 2d | 72 2d 2d 20 50 41 54 43 | -rw-rw-|r-- PATC|
|000007d0| 48 0a 23 20 20 20 32 36 | 36 37 20 2d 72 77 2d 72 |H.# 26|67 -rw-r|
|000007e0| 77 2d 72 2d 2d 20 64 6f | 63 2f 4d 61 6b 65 66 69 |w-r-- do|c/Makefi|
|000007f0| 6c 65 0a 23 20 20 20 31 | 30 36 30 20 2d 72 77 2d |le.# 1|060 -rw-|
|00000800| 72 77 2d 72 2d 2d 20 64 | 6f 63 2f 65 66 66 65 63 |rw-r-- d|oc/effec|
|00000810| 74 73 2e 69 6e 63 0a 23 | 20 20 20 32 34 30 39 20 |ts.inc.#| 2409 |
|00000820| 2d 72 77 2d 72 77 2d 72 | 2d 2d 20 70 61 74 63 68 |-rw-rw-r|-- patch|
|00000830| 6c 65 76 65 6c 2e 68 0a | 23 0a 69 66 20 74 65 73 |level.h.|#.if tes|
|00000840| 74 20 2d 72 20 5f 73 68 | 61 72 5f 73 65 71 5f 2e |t -r _sh|ar_seq_.|
|00000850| 74 6d 70 3b 20 74 68 65 | 6e 0a 09 65 63 68 6f 20 |tmp; the|n..echo |
|00000860| 27 4d 75 73 74 20 75 6e | 70 61 63 6b 20 61 72 63 |'Must un|pack arc|
|00000870| 68 69 76 65 73 20 69 6e | 20 73 65 71 75 65 6e 63 |hives in| sequenc|
|00000880| 65 21 27 0a 09 65 63 68 | 6f 20 50 6c 65 61 73 65 |e!'..ech|o Please|
|00000890| 20 75 6e 70 61 63 6b 20 | 70 61 72 74 20 60 63 61 | unpack |part `ca|
|000008a0| 74 20 5f 73 68 61 72 5f | 73 65 71 5f 2e 74 6d 70 |t _shar_|seq_.tmp|
|000008b0| 60 20 6e 65 78 74 0a 09 | 65 78 69 74 20 31 0a 66 |` next..|exit 1.f|
|000008c0| 69 0a 23 20 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |i.# ====|========|
|000008d0| 3d 20 44 4f 43 50 41 54 | 43 48 20 3d 3d 3d 3d 3d |= DOCPAT|CH =====|
|000008e0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 0a 65 63 68 6f 20 27 |========|=.echo '|
|000008f0| 78 20 2d 20 65 78 74 72 | 61 63 74 69 6e 67 20 44 |x - extr|acting D|
|00000900| 4f 43 50 41 54 43 48 20 | 28 54 65 78 74 29 27 0a |OCPATCH |(Text)'.|
|00000910| 73 65 64 20 27 73 2f 5e | 58 2f 2f 27 20 3c 3c 20 |sed 's/^|X//' << |
|00000920| 27 53 48 41 52 5f 45 4f | 46 27 20 3e 20 27 44 4f |'SHAR_EO|F' > 'DO|
|00000930| 43 50 41 54 43 48 27 20 | 26 26 0a 2a 2a 2a 20 2f |CPATCH' |&&.*** /|
|00000940| 68 78 31 64 33 2f 6c 70 | 2f 62 72 61 64 2f 70 61 |hx1d3/lp|/brad/pa|
|00000950| 72 73 65 61 72 67 73 5f | 70 61 74 63 68 30 33 2f |rseargs_|patch03/|
|00000960| 70 61 72 73 65 61 72 67 | 73 2f 61 72 67 74 79 70 |parsearg|s/argtyp|
|00000970| 65 33 2e 74 78 74 09 57 | 65 64 20 41 70 72 20 31 |e3.txt.W|ed Apr 1|
|00000980| 30 20 30 39 3a 35 35 3a | 35 31 20 31 39 39 31 0a |0 09:55:|51 1991.|
|00000990| 2d 2d 2d 20 61 72 67 74 | 79 70 65 33 2e 74 78 74 |--- argt|ype3.txt|
|000009a0| 09 4d 6f 6e 20 41 70 72 | 20 31 35 20 30 38 3a 33 |.Mon Apr| 15 08:3|
|000009b0| 31 3a 30 30 20 31 39 39 | 31 0a 2a 2a 2a 2a 2a 2a |1:00 199|1.******|
|000009c0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 0a 2a 2a 2a 20 34 32 |********|*.*** 42|
|000009d0| 2c 35 31 20 2a 2a 2a 2a | 0a 58 20 20 20 20 20 20 |,51 ****|.X |
|000009e0| 20 63 61 6c 6c 65 64 20 | 77 68 65 6e 20 61 6e 20 | called |when an |
|000009f0| 61 72 67 75 6d 65 6e 74 | 20 6f 66 09 74 68 61 74 |argument| of.that|
|00000a00| 20 70 61 72 74 69 63 75 | 6c 61 72 09 74 79 70 65 | particu|lar.type|
|00000a10| 20 69 73 09 6d 61 74 63 | 68 65 64 0a 58 20 20 20 | is.matc|hed.X |
|00000a20| 20 20 20 20 62 79 09 6f | 6e 65 20 6f 66 20 74 68 | by.o|ne of th|
|00000a30| 65 20 61 72 67 75 6d 65 | 6e 74 20 70 61 72 73 69 |e argume|nt parsi|
|00000a40| 6e 67 20 66 75 6e 63 74 | 69 6f 6e 20 69 6e 09 70 |ng funct|ion in.p|
|00000a50| 61 72 73 65 61 72 67 73 | 28 33 29 2e 0a 58 20 20 |arseargs|(3)..X |
|00000a60| 20 20 20 20 20 57 68 65 | 6e 20 73 75 63 68 20 61 | Whe|n such a|
|00000a70| 6e 20 61 72 67 75 6d 65 | 6e 74 20 69 73 20 6d 61 |n argume|nt is ma|
|00000a80| 74 63 68 65 64 2c 20 69 | 74 73 20 61 72 67 75 6d |tched, i|ts argum|
|00000a90| 65 6e 74 20 74 72 61 6e | 73 6c 61 74 69 6f 6e 0a |ent tran|slation.|
|00000aa0| 21 20 20 20 20 20 20 72 | 6f 75 74 69 6e 65 73 20 |! r|outines |
|00000ab0| 69 73 20 69 6e 76 6f 6b | 65 64 20 61 6e 64 20 69 |is invok|ed and i|
|00000ac0| 73 09 70 61 73 73 65 64 | 20 28 31 29 20 74 68 65 |s.passed| (1) the|
|00000ad0| 20 61 64 64 72 65 73 73 | 20 6f 66 20 74 68 65 0a | address| of the.|
|00000ae0| 58 20 20 20 20 20 20 20 | 61 72 67 75 6d 65 6e 74 |X |argument|
|00000af0| 20 64 65 73 63 72 69 70 | 74 6f 72 20 66 6f 72 20 | descrip|tor for |
|00000b00| 74 68 65 20 6d 61 74 63 | 68 65 64 20 61 72 67 75 |the matc|hed argu|
|00000b10| 6d 65 6e 74 2c 20 28 32 | 29 20 74 68 65 20 70 6f |ment, (2|) the po|
|00000b20| 73 73 69 2d 0a 58 20 20 | 20 20 20 20 20 62 6c 65 |ssi-.X | ble|
|00000b30| 20 61 72 67 75 6d 65 6e | 74 20 73 74 72 69 6e 67 | argumen|t string|
|00000b40| 20 66 6f 72 20 74 68 61 | 74 20 6d 61 74 63 68 65 | for tha|t matche|
|00000b50| 64 20 61 72 67 75 6d 65 | 6e 74 2c 20 61 6e 64 09 |d argume|nt, and.|
|00000b60| 28 33 29 20 61 0a 21 20 | 20 20 20 20 20 62 6f 6f |(3) a.! | boo|
|00000b70| 6c 65 61 6e 20 66 69 6c | 65 64 20 74 68 61 74 09 |lean fil|ed that.|
|00000b80| 69 73 20 54 52 55 45 09 | 6f 6e 6c 79 20 69 66 09 |is TRUE.|only if.|
|00000b90| 74 68 65 20 73 65 63 6f | 6e 64 20 70 61 72 61 6d |the seco|nd param|
|00000ba0| 65 74 65 72 0a 58 20 20 | 20 20 20 20 20 70 6f 69 |eter.X | poi|
|00000bb0| 6e 74 73 20 74 6f 20 74 | 65 6d 70 6f 72 61 72 79 |nts to t|emporary|
|00000bc0| 20 73 74 6f 72 61 67 65 | 20 28 69 6e 64 69 63 61 | storage| (indica|
|00000bd0| 74 69 6e 67 20 74 68 61 | 74 20 73 6f 6d 65 20 63 |ting tha|t some c|
|00000be0| 6f 70 79 69 6e 67 0a 58 | 20 20 20 20 20 20 20 6d |opying.X| m|
|00000bf0| 61 79 20 6e 65 65 64 20 | 74 6f 20 62 65 20 64 6f |ay need |to be do|
|00000c00| 6e 65 20 69 6e 73 74 65 | 61 64 20 6f 66 20 6a 75 |ne inste|ad of ju|
|00000c10| 73 74 20 70 6f 69 6e 74 | 69 6e 67 20 74 6f 20 74 |st point|ing to t|
|00000c20| 68 65 20 73 61 6d 65 0a | 58 20 20 20 20 20 20 20 |he same.|X |
|00000c30| 6f 62 6a 65 63 74 29 2e | 0a 2d 2d 2d 20 34 32 2c |object).|.--- 42,|
|00000c40| 35 31 20 2d 2d 2d 2d 0a | 58 20 20 20 20 20 20 20 |51 ----.|X |
|00000c50| 63 61 6c 6c 65 64 20 77 | 68 65 6e 20 61 6e 20 61 |called w|hen an a|
|00000c60| 72 67 75 6d 65 6e 74 20 | 6f 66 09 74 68 61 74 20 |rgument |of.that |
|00000c70| 70 61 72 74 69 63 75 6c | 61 72 09 74 79 70 65 20 |particul|ar.type |
|00000c80| 69 73 09 6d 61 74 63 68 | 65 64 0a 58 20 20 20 20 |is.match|ed.X |
|00000c90| 20 20 20 62 79 09 6f 6e | 65 20 6f 66 20 74 68 65 | by.on|e of the|
|00000ca0| 20 61 72 67 75 6d 65 6e | 74 20 70 61 72 73 69 6e | argumen|t parsin|
|00000cb0| 67 20 66 75 6e 63 74 69 | 6f 6e 20 69 6e 09 70 61 |g functi|on in.pa|
|00000cc0| 72 73 65 61 72 67 73 28 | 33 29 2e 0a 58 20 20 20 |rseargs(|3)..X |
|00000cd0| 20 20 20 20 57 68 65 6e | 20 73 75 63 68 20 61 6e | When| such an|
|00000ce0| 20 61 72 67 75 6d 65 6e | 74 20 69 73 20 6d 61 74 | argumen|t is mat|
|00000cf0| 63 68 65 64 2c 20 69 74 | 73 20 61 72 67 75 6d 65 |ched, it|s argume|
|00000d00| 6e 74 20 74 72 61 6e 73 | 6c 61 74 69 6f 6e 0a 21 |nt trans|lation.!|
|00000d10| 20 20 20 20 20 20 72 6f | 75 74 69 6e 65 20 69 73 | ro|utine is|
|00000d20| 09 69 6e 76 6f 6b 65 64 | 09 61 6e 64 20 69 73 20 |.invoked|.and is |
|00000d30| 70 61 73 73 65 64 20 28 | 31 29 20 74 68 65 20 61 |passed (|1) the a|
|00000d40| 64 64 72 65 73 73 20 6f | 66 20 74 68 65 0a 58 20 |ddress o|f the.X |
|00000d50| 20 20 20 20 20 20 61 72 | 67 75 6d 65 6e 74 20 64 | ar|gument d|
|00000d60| 65 73 63 72 69 70 74 6f | 72 20 66 6f 72 20 74 68 |escripto|r for th|
|00000d70| 65 20 6d 61 74 63 68 65 | 64 20 61 72 67 75 6d 65 |e matche|d argume|
|00000d80| 6e 74 2c 20 28 32 29 20 | 74 68 65 20 70 6f 73 73 |nt, (2) |the poss|
|00000d90| 69 2d 0a 58 20 20 20 20 | 20 20 20 62 6c 65 20 61 |i-.X | ble a|
|00000da0| 72 67 75 6d 65 6e 74 20 | 73 74 72 69 6e 67 20 66 |rgument |string f|
|00000db0| 6f 72 20 74 68 61 74 20 | 6d 61 74 63 68 65 64 20 |or that |matched |
|00000dc0| 61 72 67 75 6d 65 6e 74 | 2c 20 61 6e 64 09 28 33 |argument|, and.(3|
|00000dd0| 29 20 61 0a 21 20 20 20 | 20 20 20 62 6f 6f 6c 65 |) a.! | boole|
|00000de0| 61 6e 20 66 69 65 6c 64 | 20 74 68 61 74 09 69 73 |an field| that.is|
|00000df0| 20 54 52 55 45 09 6f 6e | 6c 79 20 69 66 09 74 68 | TRUE.on|ly if.th|
|00000e00| 65 20 73 65 63 6f 6e 64 | 20 70 61 72 61 6d 65 74 |e second| paramet|
|00000e10| 65 72 0a 58 20 20 20 20 | 20 20 20 70 6f 69 6e 74 |er.X | point|
|00000e20| 73 20 74 6f 20 74 65 6d | 70 6f 72 61 72 79 20 73 |s to tem|porary s|
|00000e30| 74 6f 72 61 67 65 20 28 | 69 6e 64 69 63 61 74 69 |torage (|indicati|
|00000e40| 6e 67 20 74 68 61 74 20 | 73 6f 6d 65 20 63 6f 70 |ng that |some cop|
|00000e50| 79 69 6e 67 0a 58 20 20 | 20 20 20 20 20 6d 61 79 |ying.X | may|
|00000e60| 20 6e 65 65 64 20 74 6f | 20 62 65 20 64 6f 6e 65 | need to| be done|
|00000e70| 20 69 6e 73 74 65 61 64 | 20 6f 66 20 6a 75 73 74 | instead| of just|
|00000e80| 20 70 6f 69 6e 74 69 6e | 67 20 74 6f 20 74 68 65 | pointin|g to the|
|00000e90| 20 73 61 6d 65 0a 58 20 | 20 20 20 20 20 20 6f 62 | same.X | ob|
|00000ea0| 6a 65 63 74 29 2e 0a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |ject)..*|********|
|00000eb0| 2a 2a 2a 2a 2a 2a 0a 2a | 2a 2a 20 32 32 39 2c 32 |******.*|** 229,2|
|00000ec0| 33 35 20 2a 2a 2a 2a 0a | 58 20 20 20 20 20 20 20 |35 ****.|X |
|00000ed0| 66 6f 6c 6c 6f 77 65 64 | 20 62 79 20 74 68 65 20 |followed| by the |
|00000ee0| 74 79 70 65 20 6f 66 20 | 74 68 65 20 69 74 65 6d |type of |the item|
|00000ef0| 73 20 69 6e 20 74 68 65 | 20 76 65 63 74 6f 72 2e |s in the| vector.|
|00000f00| 0a 58 20 20 0a 58 20 20 | 53 45 45 20 41 4c 53 4f |.X .X |SEE ALSO|
|00000f10| 0a 21 20 20 20 20 20 20 | 70 61 72 73 65 61 72 67 |.! |parsearg|
|00000f20| 73 28 33 29 2c 20 70 61 | 72 73 65 61 72 67 73 28 |s(3), pa|rseargs(|
|00000f30| 33 29 2c 20 70 61 72 73 | 65 63 6e 74 6c 28 31 29 |3), pars|ecntl(1)|
|00000f40| 2c 0a 58 20 20 0a 58 20 | 20 0a 58 20 20 0a 2d 2d |,.X .X | .X .--|
|00000f50| 2d 20 32 32 39 2c 32 33 | 35 20 2d 2d 2d 2d 0a 58 |- 229,23|5 ----.X|
|00000f60| 20 20 20 20 20 20 20 66 | 6f 6c 6c 6f 77 65 64 20 | f|ollowed |
|00000f70| 62 79 20 74 68 65 20 74 | 79 70 65 20 6f 66 20 74 |by the t|ype of t|
|00000f80| 68 65 20 69 74 65 6d 73 | 20 69 6e 20 74 68 65 20 |he items| in the |
|00000f90| 76 65 63 74 6f 72 2e 0a | 58 20 20 0a 58 20 20 53 |vector..|X .X S|
|00000fa0| 45 45 20 41 4c 53 4f 0a | 21 20 20 20 20 20 20 70 |EE ALSO.|! p|
|00000fb0| 61 72 73 65 61 72 67 73 | 28 33 29 2c 20 70 61 72 |arseargs|(3), par|
|00000fc0| 73 65 61 72 67 73 28 31 | 29 2c 20 70 61 72 73 65 |seargs(1|), parse|
|00000fd0| 63 6e 74 6c 28 33 29 0a | 58 20 20 0a 58 20 20 0a |cntl(3).|X .X .|
|00000fe0| 58 20 20 0a 2a 2a 2a 20 | 2f 68 78 31 64 33 2f 6c |X .*** |/hx1d3/l|
|00000ff0| 70 2f 62 72 61 64 2f 70 | 61 72 73 65 61 72 67 73 |p/brad/p|arseargs|
|00001000| 5f 70 61 74 63 68 30 33 | 2f 70 61 72 73 65 61 72 |_patch03|/parsear|
|00001010| 67 73 2f 70 61 72 73 65 | 61 72 67 73 31 2e 74 78 |gs/parse|args1.tx|
|00001020| 74 09 57 65 64 20 41 70 | 72 20 31 30 20 30 39 3a |t.Wed Ap|r 10 09:|
|00001030| 35 35 3a 35 32 20 31 39 | 39 31 0a 2d 2d 2d 20 70 |55:52 19|91.--- p|
|00001040| 61 72 73 65 61 72 67 73 | 31 2e 74 78 74 09 4d 6f |arseargs|1.txt.Mo|
|00001050| 6e 20 41 70 72 20 31 35 | 20 30 38 3a 33 31 3a 31 |n Apr 15| 08:31:1|
|00001060| 38 20 31 39 39 31 0a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |8 1991.*|********|
|00001070| 2a 2a 2a 2a 2a 2a 0a 2a | 2a 2a 20 39 2c 31 39 20 |******.*|** 9,19 |
|00001080| 2a 2a 2a 2a 0a 58 20 20 | 20 20 20 20 20 70 61 72 |****.X | par|
|00001090| 73 65 61 72 67 73 20 2d | 20 70 61 72 73 65 20 63 |seargs -| parse c|
|000010a0| 6f 6d 6d 61 6e 64 20 6c | 69 6e 65 20 61 72 67 75 |ommand l|ine argu|
|000010b0| 6d 65 6e 74 73 20 69 6e | 20 73 68 65 6c 6c 20 73 |ments in| shell s|
|000010c0| 63 72 69 70 74 73 0a 58 | 20 20 0a 58 20 20 53 59 |cripts.X| .X SY|
|000010d0| 4e 4f 50 53 49 53 0a 21 | 20 20 20 20 20 20 70 61 |NOPSIS.!| pa|
|000010e0| 72 73 65 61 72 67 73 09 | 20 5b 2d 55 5d 20 5b 2d |rseargs.| [-U] [-|
|000010f0| 4d 5d 20 5b 2d 54 20 73 | 74 72 69 6e 67 5d 20 5b |M] [-T s|tring] [|
|00001100| 2d 46 20 73 74 72 69 6e | 67 5d 20 5b 2d 41 5d 09 |-F strin|g] [-A].|
|00001110| 5b 2d 61 20 61 72 67 2d | 0a 21 20 09 09 20 73 70 |[-a arg-|.! .. sp|
|00001120| 65 63 5d 20 5b 2d 65 20 | 6e 61 6d 65 5d 20 5b 2d |ec] [-e |name] [-|
|00001130| 66 20 66 69 6c 65 5d 20 | 5b 2d 6c 5d 09 5b 2d 6f |f file] |[-l].[-o|
|00001140| 5d 20 5b 2d 73 20 73 68 | 65 6c 6c 5d 0a 21 20 09 |] [-s sh|ell].! .|
|00001150| 09 20 5b 2d 75 5d 20 5b | 2d 69 5d 20 5b 2d 70 5d |. [-u] [|-i] [-p]|
|00001160| 09 2d 2d 20 6e 61 6d 65 | 09 5b 61 72 67 75 6d 65 |.-- name|.[argume|
|00001170| 6e 74 73 20 2e 2e 2e 5d | 0a 58 20 20 0a 58 20 20 |nts ...]|.X .X |
|00001180| 4f 50 54 49 4f 4e 53 0a | 58 20 20 20 20 20 20 20 |OPTIONS.|X |
|00001190| 2d 55 09 09 20 20 20 6a | 75 73 74 09 70 72 69 6e |-U.. j|ust.prin|
|000011a0| 74 20 70 72 6f 67 72 61 | 6d 20 75 73 61 67 65 2c |t progra|m usage,|
|000011b0| 20 64 6f 09 6e 6f 74 20 | 70 61 72 73 65 20 74 68 | do.not |parse th|
|000011c0| 65 0a 58 20 20 09 09 20 | 20 20 63 6f 6d 6d 61 6e |e.X .. | comman|
|000011d0| 64 20 6c 69 6e 65 0a 58 | 20 20 0a 2d 2d 2d 20 39 |d line.X| .--- 9|
|000011e0| 2c 32 32 20 2d 2d 2d 2d | 0a 58 20 20 20 20 20 20 |,22 ----|.X |
|000011f0| 20 70 61 72 73 65 61 72 | 67 73 20 2d 20 70 61 72 | parsear|gs - par|
|00001200| 73 65 20 63 6f 6d 6d 61 | 6e 64 20 6c 69 6e 65 20 |se comma|nd line |
|00001210| 61 72 67 75 6d 65 6e 74 | 73 20 69 6e 20 73 68 65 |argument|s in she|
|00001220| 6c 6c 20 73 63 72 69 70 | 74 73 0a 58 20 20 0a 58 |ll scrip|ts.X .X|
|00001230| 20 20 53 59 4e 4f 50 53 | 49 53 0a 21 20 20 20 20 | SYNOPS|IS.! |
|00001240| 20 20 70 61 72 73 65 61 | 72 67 73 09 20 5b 2d 23 | parsea|rgs. [-#|
|00001250| 55 4d 43 41 6c 6f 75 69 | 70 31 5d 09 5b 2d 53 20 |UMCAloui|p1].[-S |
|00001260| 73 65 70 61 72 61 74 6f | 72 5d 20 5b 2d 54 20 73 |separato|r] [-T s|
|00001270| 74 72 69 6e 67 5d 0a 21 | 20 09 09 20 5b 2d 46 20 |tring].!| .. [-F |
|00001280| 73 74 72 69 6e 67 5d 20 | 5b 2d 61 20 61 72 67 2d |string] |[-a arg-|
|00001290| 73 70 65 63 5d 20 5b 2d | 65 20 6e 61 6d 65 5d 20 |spec] [-|e name] |
|000012a0| 5b 2d 66 20 66 69 6c 65 | 5d 0a 21 20 09 09 20 5b |[-f file|].! .. [|
|000012b0| 2d 73 20 73 68 65 6c 6c | 5d 20 2d 2d 20 6e 61 6d |-s shell|] -- nam|
|000012c0| 65 20 5b 61 72 67 75 6d | 65 6e 74 73 20 2e 2e 2e |e [argum|ents ...|
|000012d0| 5d 0a 58 20 20 0a 58 20 | 20 4f 50 54 49 4f 4e 53 |].X .X | OPTIONS|
|000012e0| 0a 2b 20 20 20 20 20 20 | 2d 23 09 09 20 20 20 6a |.+ |-#.. j|
|000012f0| 75 73 74 09 70 72 69 6e | 74 20 74 68 65 20 76 65 |ust.prin|t the ve|
|00001300| 72 73 69 6f 6e 20 61 6e | 64 20 70 61 74 63 68 6c |rsion an|d patchl|
|00001310| 65 76 65 6c 2c 20 64 6f | 20 6e 6f 74 0a 2b 20 09 |evel, do| not.+ .|
|00001320| 09 20 20 20 70 61 72 73 | 65 20 74 68 65 20 63 6f |. pars|e the co|
|00001330| 6d 6d 61 6e 64 20 6c 69 | 6e 65 0a 2b 20 0a 58 20 |mmand li|ne.+ .X |
|00001340| 20 20 20 20 20 20 2d 55 | 09 09 20 20 20 6a 75 73 | -U|.. jus|
|00001350| 74 09 70 72 69 6e 74 20 | 70 72 6f 67 72 61 6d 20 |t.print |program |
|00001360| 75 73 61 67 65 2c 20 64 | 6f 09 6e 6f 74 20 70 61 |usage, d|o.not pa|
|00001370| 72 73 65 20 74 68 65 0a | 58 20 20 09 09 20 20 20 |rse the.|X .. |
|00001380| 63 6f 6d 6d 61 6e 64 20 | 6c 69 6e 65 0a 58 20 20 |command |line.X |
|00001390| 0a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |.*******|********|
|000013a0| 0a 2a 2a 2a 20 32 30 2c | 32 35 20 2a 2a 2a 2a 0a |.*** 20,|25 ****.|
|000013b0| 2d 2d 2d 20 32 33 2c 33 | 31 20 2d 2d 2d 2d 0a 58 |--- 23,3|1 ----.X|
|000013c0| 20 20 20 20 20 20 20 2d | 4d 09 09 20 20 20 6a 75 | -|M.. ju|
|000013d0| 73 74 09 70 72 69 6e 74 | 20 28 6e 7c 74 29 72 6f |st.print| (n|t)ro|
|000013e0| 66 66 09 2d 6d 61 6e 20 | 6d 61 6e 75 61 6c 20 70 |ff.-man |manual p|
|000013f0| 61 67 65 0a 58 20 20 09 | 09 20 20 20 74 65 6d 70 |age.X .|. temp|
|00001400| 6c 61 74 65 2c 20 64 6f | 09 6e 6f 74 20 70 61 72 |late, do|.not par|
|00001410| 73 65 20 74 68 65 20 63 | 6f 6d 6d 61 6e 64 20 6c |se the c|ommand l|
|00001420| 69 6e 65 0a 58 20 20 0a | 2b 20 20 20 20 20 20 2d |ine.X .|+ -|
|00001430| 53 09 73 65 70 61 72 61 | 74 6f 72 20 20 66 69 65 |S.separa|tor fie|
|00001440| 6c 64 2d 73 65 70 61 72 | 61 74 6f 72 2d 73 74 72 |ld-separ|ator-str|
|00001450| 69 6e 67 20 75 73 65 64 | 20 74 6f 20 64 65 6c 69 |ing used| to deli|
|00001460| 6d 69 74 20 61 72 72 61 | 79 0a 2b 20 09 09 20 20 |mit arra|y.+ .. |
|00001470| 20 65 6c 65 6d 65 6e 74 | 73 20 20 28 64 65 66 61 | element|s (defa|
|00001480| 75 6c 74 3d 0a 2b 20 0a | 58 20 20 20 20 20 20 20 |ult=.+ .|X |
|00001490| 2d 54 09 73 74 72 69 6e | 67 09 20 20 20 73 74 72 |-T.strin|g. str|
|000014a0| 69 6e 67 20 74 6f 20 75 | 73 65 20 66 6f 72 20 74 |ing to u|se for t|
|000014b0| 72 75 65 20 62 6f 6f 6c | 65 61 6e 20 61 72 67 75 |rue bool|ean argu|
|000014c0| 6d 65 6e 74 73 0a 58 20 | 20 09 09 20 20 20 28 64 |ments.X | .. (d|
|000014d0| 65 66 61 75 6c 74 3d 60 | 60 54 52 55 45 27 27 29 |efault=`|`TRUE'')|
|000014e0| 0a 58 20 20 0a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |.X .***|********|
|000014f0| 2a 2a 2a 2a 0a 2a 2a 2a | 20 32 36 2c 33 31 20 2a |****.***| 26,31 *|
|00001500| 2a 2a 2a 0a 2d 2d 2d 20 | 33 32 2c 34 30 20 2d 2d |***.--- |32,40 --|
|00001510| 2d 2d 0a 58 20 20 20 20 | 20 20 20 2d 46 09 73 74 |--.X | -F.st|
|00001520| 72 69 6e 67 09 20 20 20 | 73 74 72 69 6e 67 20 74 |ring. |string t|
|00001530| 6f 20 75 73 65 20 66 6f | 72 20 66 61 6c 73 65 20 |o use fo|r false |
|00001540| 62 6f 6f 6c 65 61 6e 20 | 61 72 67 75 6d 65 6e 74 |boolean |argument|
|00001550| 73 0a 58 20 20 09 09 20 | 20 20 28 64 65 66 61 75 |s.X .. | (defau|
|00001560| 6c 74 3d 60 60 27 27 29 | 0a 58 20 20 0a 2b 20 20 |lt=``'')|.X .+ |
|00001570| 20 20 20 20 2d 43 09 09 | 20 20 20 49 67 6e 6f 72 | -C..| Ignor|
|00001580| 65 20 74 68 65 20 64 69 | 66 66 65 72 65 6e 63 65 |e the di|fference|
|00001590| 20 62 65 74 77 65 65 6e | 20 75 70 70 65 72 20 61 | between| upper a|
|000015a0| 6e 64 20 6c 6f 77 65 72 | 0a 2b 20 09 09 20 20 20 |nd lower|.+ .. |
|000015b0| 63 61 73 65 09 77 68 65 | 6e 20 70 61 72 73 69 6e |case.whe|n parsin|
|000015c0| 67 20 73 69 6e 67 6c 65 | 20 63 68 61 72 61 63 74 |g single| charact|
|000015d0| 65 72 20 6f 70 74 69 6f | 6e 73 2e 0a 2b 20 0a 58 |er optio|ns..+ .X|
|000015e0| 20 20 20 20 20 20 20 2d | 41 09 09 20 20 20 6d 6f | -|A.. mo|
|000015f0| 64 69 66 79 20 61 72 72 | 61 79 09 62 65 68 61 76 |dify arr|ay.behav|
|00001600| 69 6f 72 20 66 6f 72 20 | 74 68 65 20 73 70 65 63 |ior for |the spec|
|00001610| 69 66 69 65 64 20 73 68 | 65 6c 6c 2e 0a 58 20 20 |ified sh|ell..X |
|00001620| 0a 58 20 20 20 20 20 20 | 20 2d 61 09 61 72 67 2d |.X | -a.arg-|
|00001630| 73 70 65 63 20 20 20 61 | 72 67 75 6d 65 6e 74 20 |spec a|rgument |
|00001640| 73 70 65 63 69 66 69 63 | 61 74 69 6f 6e 20 73 74 |specific|ation st|
|00001650| 72 69 6e 67 0a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |ring.***|********|
|00001660| 2a 2a 2a 2a 0a 2a 2a 2a | 20 34 38 2c 37 36 20 2a |****.***| 48,76 *|
|00001670| 2a 2a 2a 0a 58 20 20 0a | 58 20 20 20 20 20 20 20 |***.X .|X |
|00001680| 2d 70 09 09 20 20 20 70 | 72 6f 6d 70 74 20 74 68 |-p.. p|rompt th|
|00001690| 65 20 75 73 65 72 20 66 | 6f 72 20 6d 69 73 73 69 |e user f|or missi|
|000016a0| 6e 67 20 72 65 71 75 69 | 72 65 64 09 61 72 67 75 |ng requi|red.argu|
|000016b0| 6d 65 6e 74 73 0a 58 20 | 20 0a 2d 20 20 20 20 20 |ments.X | .- |
|000016c0| 20 2d 69 09 09 20 20 20 | 69 67 6e 6f 72 65 20 62 | -i.. |ignore b|
|000016d0| 61 64 20 63 6f 6d 6d 61 | 6e 64 2d 6c 69 6e 65 20 |ad comma|nd-line |
|000016e0| 73 79 6e 74 61 78 20 61 | 6e 64 20 63 6f 6e 74 69 |syntax a|nd conti|
|000016f0| 6e 75 65 0a 2d 20 09 09 | 20 20 20 70 72 6f 63 65 |nue.- ..| proce|
|00001700| 73 73 69 6e 67 20 28 69 | 6e 73 74 65 61 64 20 6f |ssing (i|nstead o|
|00001710| 66 20 61 62 6f 72 74 69 | 6e 67 29 0a 58 20 20 0a |f aborti|ng).X .|
|00001720| 2d 20 41 52 47 55 4d 45 | 4e 54 53 0a 2d 20 20 20 |- ARGUME|NTS.- |
|00001730| 20 20 20 2d 2d 09 09 20 | 20 20 49 6e 64 69 63 61 | --.. | Indica|
|00001740| 74 65 73 20 74 68 61 74 | 20 61 6e 79 20 72 65 6d |tes that| any rem|
|00001750| 61 69 6e 69 6e 67 09 6f | 70 74 69 6f 6e 73 09 61 |aining.o|ptions.a|
|00001760| 72 65 0a 2d 20 09 09 20 | 20 20 69 6e 74 65 6e 64 |re.- .. | intend|
|00001770| 65 64 20 66 6f 72 09 74 | 68 65 20 63 61 6c 6c 69 |ed for.t|he calli|
|00001780| 6e 67 20 70 72 6f 67 72 | 61 6d 2e 0a 58 20 20 0a |ng progr|am..X .|
|00001790| 2d 20 20 20 20 20 20 6e | 61 6d 65 09 20 20 20 6e |- n|ame. n|
|000017a0| 61 6d 65 09 6f 66 20 63 | 61 6c 6c 69 6e 67 20 70 |ame.of c|alling p|
|000017b0| 72 6f 67 72 61 6d 0a 58 | 20 20 0a 58 20 20 0a 58 |rogram.X| .X .X|
|000017c0| 20 20 0a 58 20 20 0a 2d | 20 50 61 67 65 20 31 0a | .X .-| Page 1.|
|000017d0| 58 20 20 0a 58 20 20 0a | 58 20 20 0a 58 20 20 0a |X .X .|X .X .|
|000017e0| 58 20 20 0a 58 20 20 0a | 21 20 50 41 52 53 45 41 |X .X .|! PARSEA|
|000017f0| 52 47 53 28 31 29 09 09 | 09 09 09 20 20 20 20 20 |RGS(1)..|... |
|00001800| 50 41 52 53 45 41 52 47 | 53 28 31 29 0a 58 20 20 |PARSEARG|S(1).X |
|00001810| 0a 58 20 20 0a 58 20 20 | 0a 58 20 20 20 20 20 20 |.X .X |.X |
|00001820| 20 61 72 67 75 6d 65 6e | 74 73 09 20 20 20 61 72 | argumen|ts. ar|
|00001830| 67 75 6d 65 6e 74 73 20 | 74 6f 09 63 61 6c 6c 69 |guments |to.calli|
|00001840| 6e 67 09 70 72 6f 67 72 | 61 6d 0a 58 20 20 0a 58 |ng.progr|am.X .X|
|00001850| 20 20 44 45 53 43 52 49 | 50 54 49 4f 4e 0a 2d 2d | DESCRI|PTION.--|
|00001860| 2d 20 35 37 2c 38 39 20 | 2d 2d 2d 2d 0a 58 20 20 |- 57,89 |----.X |
|00001870| 0a 58 20 20 20 20 20 20 | 20 2d 70 09 09 20 20 20 |.X | -p.. |
|00001880| 70 72 6f 6d 70 74 20 74 | 68 65 20 75 73 65 72 20 |prompt t|he user |
|00001890| 66 6f 72 20 6d 69 73 73 | 69 6e 67 20 72 65 71 75 |for miss|ing requ|
|000018a0| 69 72 65 64 09 61 72 67 | 75 6d 65 6e 74 73 0a 58 |ired.arg|uments.X|
|000018b0| 20 20 0a 58 20 20 0a 58 | 20 20 0a 58 20 20 0a 2b | .X .X| .X .+|
|000018c0| 20 50 61 67 65 20 31 0a | 58 20 20 0a 58 20 20 0a | Page 1.|X .X .|
|000018d0| 58 20 20 0a 58 20 20 0a | 58 20 20 0a 58 20 20 0a |X .X .|X .X .|
|000018e0| 2b 20 50 41 52 53 45 41 | 52 47 53 28 31 29 09 09 |+ PARSEA|RGS(1)..|
|000018f0| 09 09 09 20 20 20 20 20 | 50 41 52 53 45 41 52 47 |... |PARSEARG|
|00001900| 53 28 31 29 0a 58 20 20 | 0a 58 20 20 0a 58 20 20 |S(1).X |.X .X |
|00001910| 0a 21 20 20 20 20 20 20 | 2d 69 09 09 20 20 20 69 |.! |-i.. i|
|00001920| 67 6e 6f 72 65 20 62 61 | 64 20 63 6f 6d 6d 61 6e |gnore ba|d comman|
|00001930| 64 2d 6c 69 6e 65 20 73 | 79 6e 74 61 78 20 61 6e |d-line s|yntax an|
|00001940| 64 20 63 6f 6e 74 69 6e | 75 65 0a 21 20 09 09 20 |d contin|ue.! .. |
|00001950| 20 20 70 72 6f 63 65 73 | 73 69 6e 67 20 28 69 6e | proces|sing (in|
|00001960| 73 74 65 61 64 20 6f 66 | 20 61 62 6f 72 74 69 6e |stead of| abortin|
|00001970| 67 29 0a 58 20 20 0a 2b | 20 20 20 20 20 20 2d 31 |g).X .+| -1|
|00001980| 09 09 20 20 20 46 6f 72 | 63 65 20 61 6e 79 20 61 |.. For|ce any a|
|00001990| 6e 64 20 61 6c 6c 20 6e | 6f 6e 2d 70 6f 73 69 74 |nd all n|on-posit|
|000019a0| 69 6f 6e 61 6c 20 70 61 | 72 61 6d 65 74 65 72 73 |ional pa|rameters|
|000019b0| 20 74 6f 0a 2b 20 09 09 | 20 20 20 62 65 20 73 70 | to.+ ..| be sp|
|000019c0| 65 63 69 66 69 65 64 09 | 62 65 66 6f 72 65 20 61 |ecified.|before a|
|000019d0| 6e 79 20 70 6f 73 69 74 | 69 6f 6e 61 6c 20 70 61 |ny posit|ional pa|
|000019e0| 72 61 6d 65 74 65 72 73 | 0a 2b 20 09 09 20 20 20 |rameters|.+ .. |
|000019f0| 6f 6e 20 74 68 65 20 63 | 6f 6d 6d 61 6e 64 2d 6c |on the c|ommand-l|
|00001a00| 69 6e 65 2e 0a 58 20 20 | 0a 2b 20 41 52 47 55 4d |ine..X |.+ ARGUM|
|00001a10| 45 4e 54 53 0a 2b 20 20 | 20 20 20 20 2d 2d 09 09 |ENTS.+ | --..|
|00001a20| 20 20 20 49 6e 64 69 63 | 61 74 65 73 20 74 68 61 | Indic|ates tha|
|00001a30| 74 20 61 6e 79 20 72 65 | 6d 61 69 6e 69 6e 67 09 |t any re|maining.|
|00001a40| 6f 70 74 69 6f 6e 73 09 | 61 72 65 0a 2b 20 09 09 |options.|are.+ ..|
|00001a50| 20 20 20 69 6e 74 65 6e | 64 65 64 20 66 6f 72 09 | inten|ded for.|
|00001a60| 74 68 65 20 63 61 6c 6c | 69 6e 67 20 70 72 6f 67 |the call|ing prog|
|00001a70| 72 61 6d 2e 0a 58 20 20 | 0a 2b 20 20 20 20 20 20 |ram..X |.+ |
|00001a80| 6e 61 6d 65 09 20 20 20 | 6e 61 6d 65 09 6f 66 20 |name. |name.of |
|00001a90| 63 61 6c 6c 69 6e 67 20 | 70 72 6f 67 72 61 6d 0a |calling |program.|
|00001aa0| 2b 20 0a 58 20 20 20 20 | 20 20 20 61 72 67 75 6d |+ .X | argum|
|00001ab0| 65 6e 74 73 09 20 20 20 | 61 72 67 75 6d 65 6e 74 |ents. |argument|
|00001ac0| 73 20 74 6f 09 63 61 6c | 6c 69 6e 67 09 70 72 6f |s to.cal|ling.pro|
|00001ad0| 67 72 61 6d 0a 58 20 20 | 0a 58 20 20 44 45 53 43 |gram.X |.X DESC|
|00001ae0| 52 49 50 54 49 4f 4e 0a | 2a 2a 2a 2a 2a 2a 2a 2a |RIPTION.|********|
|00001af0| 2a 2a 2a 2a 2a 2a 2a 0a | 2a 2a 2a 20 39 38 2c 31 |*******.|*** 98,1|
|00001b00| 33 31 20 2a 2a 2a 2a 0a | 58 20 20 20 20 20 20 20 |31 ****.|X |
|00001b10| 6f 6e 09 73 74 61 6e 64 | 61 72 64 20 6f 75 74 70 |on.stand|ard outp|
|00001b20| 75 74 09 74 68 61 74 20 | 69 73 09 73 75 69 74 61 |ut.that |is.suita|
|00001b30| 62 6c 65 20 66 6f 72 20 | 69 6e 70 75 74 20 74 6f |ble for |input to|
|00001b40| 20 6e 72 6f 66 66 20 6f | 72 0a 58 20 20 20 20 20 | nroff o|r.X |
|00001b50| 20 20 74 72 6f 66 66 20 | 75 73 69 6e 67 20 74 68 | troff |using th|
|00001b60| 65 20 2d 6d 61 6e 20 6d | 61 63 72 6f 09 70 61 63 |e -man m|acro.pac|
|00001b70| 6b 61 67 65 2e 0a 58 20 | 20 0a 58 20 20 20 20 20 |kage..X | .X |
|00001b80| 20 20 54 68 65 20 61 72 | 67 75 6d 65 6e 74 20 73 | The ar|gument s|
|00001b90| 70 65 63 69 66 69 63 61 | 74 69 6f 6e 09 73 74 72 |pecifica|tion.str|
|00001ba0| 69 6e 67 20 63 6f 6e 74 | 61 69 6e 73 09 6f 6e 65 |ing cont|ains.one|
|00001bb0| 20 65 6e 74 72 79 20 66 | 6f 72 0a 21 20 20 20 20 | entry f|or.! |
|00001bc0| 20 20 65 61 63 68 20 70 | 6f 73 73 69 62 6c 65 20 | each p|ossible |
|00001bd0| 66 6c 61 67 2e 20 20 45 | 6e 74 72 69 65 73 20 69 |flag. E|ntries i|
|00001be0| 6e 20 74 68 65 20 61 72 | 67 75 6d 65 6e 74 73 20 |n the ar|guments |
|00001bf0| 73 70 65 63 69 66 69 63 | 61 74 69 6f 6e 0a 58 20 |specific|ation.X |
|00001c00| 20 20 20 20 20 20 73 74 | 72 69 6e 67 20 61 72 65 | st|ring are|
|00001c10| 09 73 65 70 61 72 61 74 | 65 64 20 62 79 20 63 6f |.separat|ed by co|
|00001c20| 6d 6d 61 73 2e 20 20 45 | 61 63 68 20 65 6e 74 72 |mmas. E|ach entr|
|00001c30| 79 20 68 61 73 20 66 69 | 76 65 20 63 6f 6d 6d 61 |y has fi|ve comma|
|00001c40| 2d 0a 58 20 20 20 20 20 | 20 20 73 65 70 61 72 61 |-.X | separa|
|00001c50| 74 65 64 20 66 69 65 6c | 64 73 3a 09 61 20 6e 61 |ted fiel|ds:.a na|
|00001c60| 6d 65 2c 09 73 6f 6d 65 | 20 66 6c 61 67 73 2c 20 |me,.some| flags, |
|00001c70| 61 20 74 79 70 65 2c 20 | 61 20 76 61 72 69 61 62 |a type, |a variab|
|00001c80| 6c 65 2d 0a 58 20 20 20 | 20 20 20 20 6e 61 6d 65 |le-.X | name|
|00001c90| 2c 20 61 6e 64 20 61 20 | 70 72 6f 6d 70 74 2e 20 |, and a |prompt. |
|00001ca0| 20 45 61 63 68 20 6f 66 | 20 74 68 65 73 65 09 66 | Each of| these.f|
|00001cb0| 69 65 6c 64 73 20 61 72 | 65 20 64 65 73 63 72 69 |ields ar|e descri|
|00001cc0| 62 65 64 0a 58 20 20 20 | 20 20 20 20 62 65 6c 6f |bed.X | belo|
|00001cd0| 77 3a 0a 58 20 20 0a 2d | 20 20 20 20 20 20 6e 61 |w:.X .-| na|
|00001ce0| 6d 65 20 20 20 20 20 20 | 54 68 65 20 73 69 6e 67 |me |The sing|
|00001cf0| 6c 65 20 63 68 61 72 61 | 63 74 65 72 20 6e 61 6d |le chara|cter nam|
|00001d00| 65 20 6f 66 20 74 68 65 | 09 61 73 73 6f 63 69 61 |e of the|.associa|
|00001d10| 74 65 64 20 66 6c 61 67 | 2e 0a 2d 20 09 20 20 20 |ted flag|..- . |
|00001d20| 20 20 20 20 46 6f 72 20 | 65 78 61 6d 70 6c 65 2c | For |example,|
|00001d30| 20 74 6f 20 69 6e 64 69 | 63 61 74 65 09 74 68 61 | to indi|cate.tha|
|00001d40| 74 20 74 68 65 20 70 72 | 6f 67 72 61 6d 20 69 73 |t the pr|ogram is|
|00001d50| 0a 2d 20 09 20 20 20 20 | 20 20 20 65 78 70 65 63 |.- . | expec|
|00001d60| 74 69 6e 67 20 61 20 60 | 60 2d 78 27 27 20 66 6c |ting a `|`-x'' fl|
|00001d70| 61 67 2c 09 74 68 69 73 | 20 66 69 65 6c 64 20 77 |ag,.this| field w|
|00001d80| 6f 75 6c 64 20 63 6f 6e | 74 61 69 6e 0a 2d 20 09 |ould con|tain.- .|
|00001d90| 20 20 20 20 20 20 20 27 | 78 27 2e 20 20 50 6f 73 | '|x'. Pos|
|00001da0| 69 74 69 6f 6e 61 6c 09 | 61 72 67 75 6d 65 6e 74 |itional.|argument|
|00001db0| 73 20 28 74 68 6f 73 65 | 20 77 69 74 68 6f 75 74 |s (those| without|
|00001dc0| 20 61 20 60 60 2d 78 27 | 27 0a 2d 20 09 20 20 20 | a ``-x'|'.- . |
|00001dd0| 20 20 20 20 70 72 65 66 | 69 78 29 20 61 72 65 20 | pref|ix) are |
|00001de0| 69 6e 64 69 63 61 74 65 | 64 20 62 79 09 70 61 73 |indicate|d by.pas|
|00001df0| 73 69 6e 67 09 61 20 60 | 60 73 70 61 63 65 27 27 |sing.a `|`space''|
|00001e00| 0a 2d 20 09 20 20 20 20 | 20 20 20 63 68 61 72 61 |.- . | chara|
|00001e10| 63 74 65 72 2e 0a 58 20 | 20 0a 2d 20 20 20 20 20 |cter..X | .- |
|00001e20| 20 66 6c 61 67 73 20 20 | 20 20 20 46 6c 61 67 73 | flags | Flags|
|00001e30| 20 6d 6f 64 69 66 79 69 | 6e 67 20 74 68 65 20 73 | modifyi|ng the s|
|00001e40| 65 6d 61 6e 74 69 63 73 | 20 6f 66 09 74 68 69 73 |emantics| of.this|
|00001e50| 20 65 6e 74 72 79 2e 0a | 2d 20 09 20 20 20 20 20 | entry..|- . |
|00001e60| 20 20 54 68 65 73 65 20 | 73 68 6f 75 6c 64 20 68 | These |should h|
|00001e70| 61 76 65 20 6f 6e 65 20 | 6f 66 09 41 52 47 52 45 |ave one |of.ARGRE|
|00001e80| 51 20 74 6f 20 69 6e 64 | 69 63 61 74 65 20 61 0a |Q to ind|icate a.|
|00001e90| 2d 20 09 20 20 20 20 20 | 20 20 72 65 71 75 69 72 |- . | requir|
|00001ea0| 65 64 09 61 72 67 75 6d | 65 6e 74 20 6f 72 20 41 |ed.argum|ent or A|
|00001eb0| 52 47 4f 50 54 20 74 6f | 20 69 6e 64 69 63 61 74 |RGOPT to| indicat|
|00001ec0| 65 20 61 6e 0a 2d 20 09 | 20 20 20 20 20 20 20 6f |e an.- .| o|
|00001ed0| 70 74 69 6f 6e 61 6c 09 | 61 72 67 75 6d 65 6e 74 |ptional.|argument|
|00001ee0| 20 28 41 52 47 4f 50 54 | 20 69 73 20 74 68 65 09 | (ARGOPT| is the.|
|00001ef0| 64 65 66 61 75 6c 74 09 | 75 6e 6c 65 73 73 0a 2d |default.|unless.-|
|00001f00| 20 09 20 20 20 20 20 20 | 20 41 52 47 52 45 51 20 | . | ARGREQ |
|00001f10| 69 73 20 73 70 65 63 69 | 66 69 65 64 29 2e 20 20 |is speci|fied). |
|00001f20| 41 52 47 50 4f 53 20 63 | 61 6e 20 62 65 20 60 60 |ARGPOS c|an be ``|
|00001f30| 6f 72 65 64 27 27 20 69 | 6e 0a 2d 20 09 20 20 20 |ored'' i|n.- . |
|00001f40| 20 20 20 20 74 6f 20 69 | 6e 64 69 63 61 74 65 20 | to i|ndicate |
|00001f50| 61 20 70 6f 73 69 74 69 | 6f 6e 61 6c 09 61 72 67 |a positi|onal.arg|
|00001f60| 75 6d 65 6e 74 20 74 68 | 61 74 20 6d 61 79 20 61 |ument th|at may a|
|00001f70| 6c 73 6f 20 62 65 0a 2d | 20 09 20 20 20 20 20 20 |lso be.-| . |
|00001f80| 20 6b 65 79 77 6f 72 64 | 20 6d 61 74 63 68 65 64 | keyword| matched|
|00001f90| 2e 09 20 41 52 47 4e 4f | 56 41 4c 20 63 61 6e 20 |.. ARGNO|VAL can |
|00001fa0| 62 65 20 60 60 6f 72 65 | 64 27 27 20 69 6e 20 74 |be ``ore|d'' in t|
|00001fb0| 6f 0a 2d 20 09 20 20 20 | 20 20 20 20 69 6e 64 69 |o.- . | indi|
|00001fc0| 63 61 74 65 09 74 68 61 | 74 20 61 6e 09 61 72 67 |cate.tha|t an.arg|
|00001fd0| 75 6d 65 6e 74 20 69 73 | 20 61 6e 20 6f 70 74 69 |ument is| an opti|
|00001fe0| 6f 6e 20 6f 72 20 61 0a | 2d 20 09 20 20 20 20 20 |on or a.|- . |
|00001ff0| 20 20 6b 65 79 77 6f 72 | 64 20 74 68 61 74 20 64 | keywor|d that d|
|00002000| 6f 65 73 20 6e 6f 74 20 | 75 73 65 20 61 6e 20 61 |oes not |use an a|
|00002010| 63 63 6f 6d 70 61 6e 79 | 69 6e 67 20 61 72 67 75 |ccompany|ing argu|
|00002020| 6d 65 6e 74 0a 2d 20 09 | 20 20 20 20 20 20 20 28 |ment.- .| (|
|00002030| 73 75 63 68 20 61 73 09 | 61 20 62 6f 6f 6c 65 61 |such as.|a boolea|
|00002040| 6e 20 66 6c 61 67 29 2e | 20 54 68 69 73 20 66 6c |n flag).| This fl|
|00002050| 61 67 20 69 73 20 6f 6e | 6c 79 0a 2d 20 09 20 20 |ag is on|ly.- . |
|00002060| 20 20 20 20 20 72 65 71 | 75 69 72 65 64 09 66 6f | req|uired.fo|
|00002070| 72 20 63 6f 72 72 65 73 | 70 6f 6e 64 69 6e 67 20 |r corres|ponding |
|00002080| 61 72 67 75 6d 65 6e 74 | 20 74 79 70 65 73 20 74 |argument| types t|
|00002090| 68 61 74 20 61 72 65 0a | 58 20 20 0a 58 20 20 0a |hat are.|X .X .|
|000020a0| 2d 20 0a 58 20 20 50 61 | 67 65 20 32 0a 58 20 20 |- .X Pa|ge 2.X |
|000020b0| 0a 58 20 20 0a 2d 2d 2d | 20 31 31 31 2c 31 33 31 |.X .---| 111,131|
|000020c0| 20 2d 2d 2d 2d 0a 58 20 | 20 20 20 20 20 20 6f 6e | ----.X | on|
|000020d0| 09 73 74 61 6e 64 61 72 | 64 20 6f 75 74 70 75 74 |.standar|d output|
|000020e0| 09 74 68 61 74 20 69 73 | 09 73 75 69 74 61 62 6c |.that is|.suitabl|
|000020f0| 65 20 66 6f 72 20 69 6e | 70 75 74 20 74 6f 20 6e |e for in|put to n|
|00002100| 72 6f 66 66 20 6f 72 0a | 58 20 20 20 20 20 20 20 |roff or.|X |
|00002110| 74 72 6f 66 66 20 75 73 | 69 6e 67 20 74 68 65 20 |troff us|ing the |
|00002120| 2d 6d 61 6e 20 6d 61 63 | 72 6f 09 70 61 63 6b 61 |-man mac|ro.packa|
|00002130| 67 65 2e 0a 58 20 20 0a | 2b 20 20 20 20 20 20 47 |ge..X .|+ G|
|00002140| 69 76 65 6e 20 6e 6f 20 | 6f 74 68 65 72 20 61 72 |iven no |other ar|
|00002150| 67 75 6d 65 6e 74 73 20 | 70 61 72 73 65 61 72 67 |guments |parsearg|
|00002160| 73 09 2d 23 20 70 72 69 | 6e 74 73 20 6f 6e 20 73 |s.-# pri|nts on s|
|00002170| 74 61 6e 64 61 72 64 0a | 2b 20 20 20 20 20 20 6f |tandard.|+ o|
|00002180| 75 74 70 75 74 2c 20 74 | 68 65 20 63 75 72 72 65 |utput, t|he curre|
|00002190| 6e 74 20 76 65 72 73 69 | 6f 6e 20 61 6e 64 20 70 |nt versi|on and p|
|000021a0| 61 74 63 68 6c 65 76 65 | 6c 09 6f 66 20 74 68 65 |atchleve|l.of the|
|000021b0| 20 72 75 6e 6e 69 6e 67 | 0a 2b 20 20 20 20 20 20 | running|.+ |
|000021c0| 76 65 72 73 69 6f 6e 20 | 6f 66 09 70 61 72 73 65 |version |of.parse|
|000021d0| 61 72 67 73 2e 0a 2b 20 | 0a 2b 20 0a 58 20 20 20 |args..+ |.+ .X |
|000021e0| 20 20 20 20 54 68 65 20 | 61 72 67 75 6d 65 6e 74 | The |argument|
|000021f0| 20 73 70 65 63 69 66 69 | 63 61 74 69 6f 6e 09 73 | specifi|cation.s|
|00002200| 74 72 69 6e 67 20 63 6f | 6e 74 61 69 6e 73 09 6f |tring co|ntains.o|
|00002210| 6e 65 20 65 6e 74 72 79 | 20 66 6f 72 0a 21 20 20 |ne entry| for.! |
|00002220| 20 20 20 20 65 61 63 68 | 20 70 6f 73 73 69 62 6c | each| possibl|
|00002230| 65 20 66 6c 61 67 2e 20 | 20 45 6e 74 72 69 65 73 |e flag. | Entries|
|00002240| 20 69 6e 20 74 68 65 20 | 61 72 67 75 6d 65 6e 74 | in the |argument|
|00002250| 20 73 70 65 63 69 66 69 | 63 61 74 69 6f 6e 0a 58 | specifi|cation.X|
|00002260| 20 20 20 20 20 20 20 73 | 74 72 69 6e 67 20 61 72 | s|tring ar|
|00002270| 65 09 73 65 70 61 72 61 | 74 65 64 20 62 79 20 63 |e.separa|ted by c|
|00002280| 6f 6d 6d 61 73 2e 20 20 | 45 61 63 68 20 65 6e 74 |ommas. |Each ent|
|00002290| 72 79 20 68 61 73 20 66 | 69 76 65 20 63 6f 6d 6d |ry has f|ive comm|
|000022a0| 61 2d 0a 58 20 20 20 20 | 20 20 20 73 65 70 61 72 |a-.X | separ|
|000022b0| 61 74 65 64 20 66 69 65 | 6c 64 73 3a 09 61 20 6e |ated fie|lds:.a n|
|000022c0| 61 6d 65 2c 09 73 6f 6d | 65 20 66 6c 61 67 73 2c |ame,.som|e flags,|
|000022d0| 20 61 20 74 79 70 65 2c | 20 61 20 76 61 72 69 61 | a type,| a varia|
|000022e0| 62 6c 65 2d 0a 58 20 20 | 20 20 20 20 20 6e 61 6d |ble-.X | nam|
|000022f0| 65 2c 20 61 6e 64 20 61 | 20 70 72 6f 6d 70 74 2e |e, and a| prompt.|
|00002300| 20 20 45 61 63 68 20 6f | 66 20 74 68 65 73 65 09 | Each o|f these.|
|00002310| 66 69 65 6c 64 73 20 61 | 72 65 20 64 65 73 63 72 |fields a|re descr|
|00002320| 69 62 65 64 0a 58 20 20 | 20 20 20 20 20 62 65 6c |ibed.X | bel|
|00002330| 6f 77 3a 0a 58 20 20 0a | 58 20 20 0a 58 20 20 0a |ow:.X .|X .X .|
|00002340| 58 20 20 0a 58 20 20 50 | 61 67 65 20 32 0a 58 20 |X .X P|age 2.X |
|00002350| 20 0a 58 20 20 0a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a | .X .**|********|
|00002360| 2a 2a 2a 2a 2a 0a 2a 2a | 2a 20 31 33 37 2c 31 35 |*****.**|* 137,15|
|00002370| 34 20 2a 2a 2a 2a 0a 58 | 20 20 0a 58 20 20 0a 58 |4 ****.X| .X .X|
|00002380| 20 20 0a 21 20 09 20 20 | 20 20 20 20 20 69 6d 70 | .! . | imp|
|00002390| 6c 65 6d 65 6e 74 65 64 | 20 62 79 20 74 68 65 20 |lemented| by the |
|000023a0| 70 72 6f 67 72 61 6d 6d | 65 72 3b 20 70 61 72 73 |programm|er; pars|
|000023b0| 65 61 72 67 73 09 61 6c | 72 65 61 64 79 0a 21 20 |eargs.al|ready.! |
|000023c0| 09 20 20 20 20 20 20 20 | 6b 6e 6f 77 73 20 77 68 |. |knows wh|
|000023d0| 69 63 68 20 70 72 65 2d | 64 65 66 69 6e 65 64 20 |ich pre-|defined |
|000023e0| 61 72 67 75 6d 65 6e 74 | 09 74 79 70 65 73 20 74 |argument|.types t|
|000023f0| 61 6b 65 20 61 6e 0a 21 | 20 09 20 20 20 20 20 20 |ake an.!| . |
|00002400| 20 61 72 67 75 6d 65 6e | 74 2e 20 20 41 52 47 56 | argumen|t. ARGV|
|00002410| 41 4c 4f 50 54 20 63 61 | 6e 09 62 65 20 60 60 6f |ALOPT ca|n.be ``o|
|00002420| 72 65 64 27 27 20 69 6e | 20 74 6f 0a 58 20 20 09 |red'' in| to.X .|
|00002430| 20 20 20 20 20 20 20 69 | 6e 64 69 63 61 74 65 09 | i|ndicate.|
|00002440| 74 68 61 74 20 61 6e 09 | 61 72 67 75 6d 65 6e 74 |that an.|argument|
|00002450| 20 74 6f 20 74 68 65 09 | 6f 70 74 69 6f 6e 20 6d | to the.|option m|
|00002460| 61 79 20 62 65 0a 58 20 | 20 09 20 20 20 20 20 20 |ay be.X | . |
|00002470| 20 6f 70 74 69 6f 6e 61 | 6c 6c 79 20 73 75 70 70 | optiona|lly supp|
|00002480| 6c 69 65 64 20 6f 6e 20 | 74 68 65 20 63 6f 6d 6d |lied on |the comm|
|00002490| 61 6e 64 2d 6c 69 6e 65 | 2c 09 62 75 74 20 69 73 |and-line|,.but is|
|000024a0| 0a 21 20 09 20 20 20 20 | 20 20 20 6e 6f 74 20 72 |.! . | not r|
|000024b0| 65 71 75 69 72 65 64 2e | 20 20 41 52 47 56 41 4c |equired.| ARGVAL|
|000024c0| 52 45 51 09 63 61 6e 20 | 62 65 20 60 60 6f 72 65 |REQ.can |be ``ore|
|000024d0| 64 27 27 09 69 6e 20 74 | 6f 0a 58 20 20 09 20 20 |d''.in t|o.X . |
|000024e0| 20 20 20 20 20 69 6e 64 | 69 63 61 74 65 09 74 68 | ind|icate.th|
|000024f0| 61 74 20 61 6e 09 61 72 | 67 75 6d 65 6e 74 20 74 |at an.ar|gument t|
|00002500| 6f 20 74 68 65 09 6f 70 | 74 69 6f 6e 20 69 73 0a |o the.op|tion is.|
|00002510| 58 20 20 09 20 20 20 20 | 20 20 20 72 65 71 75 69 |X . | requi|
|00002520| 72 65 64 09 28 74 68 69 | 73 20 69 73 20 74 68 65 |red.(thi|s is the|
|00002530| 20 64 65 66 61 75 6c 74 | 20 62 65 68 61 76 69 6f | default| behavio|
|00002540| 72 20 66 6f 72 20 6f 70 | 74 69 6f 6e 73 0a 21 20 |r for op|tions.! |
|00002550| 09 20 20 20 20 20 20 20 | 74 68 61 74 20 74 61 6b |. |that tak|
|00002560| 65 20 61 72 67 75 6d 65 | 6e 74 73 29 2e 20 20 41 |e argume|nts). A|
|00002570| 52 47 4c 49 53 54 20 63 | 61 6e 20 62 65 20 60 60 |RGLIST c|an be ``|
|00002580| 6f 72 65 64 27 27 20 69 | 6e 0a 58 20 20 09 20 20 |ored'' i|n.X . |
|00002590| 20 20 20 20 20 28 75 73 | 69 6e 67 20 74 68 65 20 | (us|ing the |
|000025a0| 60 7c 27 20 63 68 61 72 | 61 63 74 65 72 29 20 74 |`|' char|acter) t|
|000025b0| 6f 20 69 6e 64 69 63 61 | 74 65 20 74 68 61 74 20 |o indica|te that |
|000025c0| 61 6e 0a 58 20 20 09 20 | 20 20 20 20 20 20 61 72 |an.X . | ar|
|000025d0| 67 75 6d 65 6e 74 09 69 | 73 20 61 63 74 75 61 6c |gument.i|s actual|
|000025e0| 6c 79 20 61 20 6c 69 73 | 74 20 6f 66 20 6f 6e 65 |ly a lis|t of one|
|000025f0| 20 6f 72 20 6d 6f 72 65 | 0a 21 20 09 20 20 20 20 | or more|.! . |
|00002600| 20 20 20 61 72 67 75 6d | 65 6e 74 73 20 66 72 6f | argum|ents fro|
|00002610| 6d 20 74 68 65 20 63 6f | 6d 6d 61 6e 64 20 6c 69 |m the co|mmand li|
|00002620| 6e 65 2e 09 20 41 52 47 | 48 49 44 44 45 4e 20 63 |ne.. ARG|HIDDEN c|
|00002630| 61 6e 20 62 65 0a 58 20 | 20 09 20 20 20 20 20 20 |an be.X | . |
|00002640| 20 60 60 6f 72 65 64 27 | 27 09 69 6e 20 74 6f 20 | ``ored'|'.in to |
|00002650| 69 6e 64 69 63 61 74 65 | 20 61 20 66 6c 61 67 20 |indicate| a flag |
|00002660| 74 68 61 74 20 73 68 6f | 75 6c 64 20 6e 6f 74 20 |that sho|uld not |
|00002670| 62 65 0a 58 20 20 09 20 | 20 20 20 20 20 20 70 72 |be.X . | pr|
|00002680| 69 6e 74 65 64 20 69 6e | 20 75 73 61 67 65 09 6d |inted in| usage.m|
|00002690| 65 73 73 61 67 65 73 20 | 2d 20 66 6f 72 20 65 78 |essages |- for ex|
|000026a0| 61 6d 70 6c 65 2c 09 66 | 6c 61 67 73 0a 58 20 20 |ample,.f|lags.X |
|000026b0| 09 20 20 20 20 20 20 20 | 69 6e 74 65 6e 64 65 64 |. |intended|
|000026c0| 09 66 6f 72 20 69 6e 74 | 65 72 6e 61 6c 20 64 65 |.for int|ernal de|
|000026d0| 62 75 67 67 69 6e 67 20 | 70 75 72 70 6f 73 65 73 |bugging |purposes|
|000026e0| 2e 0a 2d 2d 2d 20 31 33 | 37 2c 31 36 35 20 2d 2d |..--- 13|7,165 --|
|000026f0| 2d 2d 0a 58 20 20 0a 58 | 20 20 0a 58 20 20 0a 21 |--.X .X| .X .!|
|00002700| 20 20 20 20 20 20 6e 61 | 6d 65 20 20 20 20 20 20 | na|me |
|00002710| 54 68 65 20 73 69 6e 67 | 6c 65 20 63 68 61 72 61 |The sing|le chara|
|00002720| 63 74 65 72 20 6e 61 6d | 65 20 6f 66 20 74 68 65 |cter nam|e of the|
|00002730| 09 61 73 73 6f 63 69 61 | 74 65 64 20 66 6c 61 67 |.associa|ted flag|
|00002740| 2e 0a 21 20 09 20 20 20 | 20 20 20 20 46 6f 72 20 |..! . | For |
|00002750| 65 78 61 6d 70 6c 65 2c | 20 74 6f 20 69 6e 64 69 |example,| to indi|
|00002760| 63 61 74 65 09 74 68 61 | 74 20 74 68 65 20 70 72 |cate.tha|t the pr|
|00002770| 6f 67 72 61 6d 20 69 73 | 0a 21 20 09 20 20 20 20 |ogram is|.! . |
|00002780| 20 20 20 65 78 70 65 63 | 74 69 6e 67 20 61 20 60 | expec|ting a `|
|00002790| 60 2d 78 27 27 20 66 6c | 61 67 2c 09 74 68 69 73 |`-x'' fl|ag,.this|
|000027a0| 20 66 69 65 6c 64 20 77 | 6f 75 6c 64 20 63 6f 6e | field w|ould con|
|000027b0| 74 61 69 6e 0a 21 20 09 | 20 20 20 20 20 20 20 27 |tain.! .| '|
|000027c0| 78 27 2e 20 20 50 6f 73 | 69 74 69 6f 6e 61 6c 09 |x'. Pos|itional.|
|000027d0| 61 72 67 75 6d 65 6e 74 | 73 20 28 74 68 6f 73 65 |argument|s (those|
|000027e0| 20 77 69 74 68 6f 75 74 | 20 61 20 60 60 2d 78 27 | without| a ``-x'|
|000027f0| 27 0a 21 20 09 20 20 20 | 20 20 20 20 70 72 65 66 |'.! . | pref|
|00002800| 69 78 29 20 61 72 65 20 | 69 6e 64 69 63 61 74 65 |ix) are |indicate|
|00002810| 64 20 62 79 09 70 61 73 | 73 69 6e 67 09 61 20 60 |d by.pas|sing.a `|
|00002820| 60 73 70 61 63 65 27 27 | 0a 21 20 09 20 20 20 20 |`space''|.! . |
|00002830| 20 20 20 63 68 61 72 61 | 63 74 65 72 2e 0a 21 20 | chara|cter..! |
|00002840| 0a 21 20 20 20 20 20 20 | 66 6c 61 67 73 20 20 20 |.! |flags |
|00002850| 20 20 46 6c 61 67 73 20 | 6d 6f 64 69 66 79 69 6e | Flags |modifyin|
|00002860| 67 20 74 68 65 20 73 65 | 6d 61 6e 74 69 63 73 20 |g the se|mantics |
|00002870| 6f 66 09 74 68 69 73 20 | 65 6e 74 72 79 2e 0a 21 |of.this |entry..!|
|00002880| 20 09 20 20 20 20 20 20 | 20 54 68 65 73 65 20 73 | . | These s|
|00002890| 68 6f 75 6c 64 20 68 61 | 76 65 20 6f 6e 65 20 6f |hould ha|ve one o|
|000028a0| 66 09 41 52 47 52 45 51 | 20 74 6f 20 69 6e 64 69 |f.ARGREQ| to indi|
|000028b0| 63 61 74 65 20 61 0a 21 | 20 09 20 20 20 20 20 20 |cate a.!| . |
|000028c0| 20 72 65 71 75 69 72 65 | 64 09 61 72 67 75 6d 65 | require|d.argume|
|000028d0| 6e 74 20 6f 72 20 41 52 | 47 4f 50 54 20 74 6f 20 |nt or AR|GOPT to |
|000028e0| 69 6e 64 69 63 61 74 65 | 20 61 6e 0a 21 20 09 20 |indicate| an.! . |
|000028f0| 20 20 20 20 20 20 6f 70 | 74 69 6f 6e 61 6c 09 61 | op|tional.a|
|00002900| 72 67 75 6d 65 6e 74 20 | 28 41 52 47 4f 50 54 20 |rgument |(ARGOPT |
|00002910| 69 73 20 74 68 65 09 64 | 65 66 61 75 6c 74 09 75 |is the.d|efault.u|
|00002920| 6e 6c 65 73 73 0a 21 20 | 09 20 20 20 20 20 20 20 |nless.! |. |
|00002930| 41 52 47 52 45 51 20 69 | 73 20 73 70 65 63 69 66 |ARGREQ i|s specif|
|00002940| 69 65 64 29 2e 20 20 41 | 52 47 50 4f 53 20 6d 61 |ied). A|RGPOS ma|
|00002950| 79 20 62 65 20 60 60 6f | 72 65 64 27 27 20 69 6e |y be ``o|red'' in|
|00002960| 0a 21 20 09 20 20 20 20 | 20 20 20 74 6f 20 69 6e |.! . | to in|
|00002970| 64 69 63 61 74 65 20 61 | 20 70 6f 73 69 74 69 6f |dicate a| positio|
|00002980| 6e 61 6c 09 61 72 67 75 | 6d 65 6e 74 20 74 68 61 |nal.argu|ment tha|
|00002990| 74 20 6d 61 79 20 61 6c | 73 6f 20 62 65 0a 21 20 |t may al|so be.! |
|000029a0| 09 20 20 20 20 20 20 20 | 6b 65 79 77 6f 72 64 20 |. |keyword |
|000029b0| 6d 61 74 63 68 65 64 2e | 09 20 41 52 47 56 41 4c |matched.|. ARGVAL|
|000029c0| 4f 50 54 20 6d 61 79 20 | 62 65 20 60 60 6f 72 65 |OPT may |be ``ore|
|000029d0| 64 27 27 20 69 6e 20 74 | 6f 0a 58 20 20 09 20 20 |d'' in t|o.X . |
|000029e0| 20 20 20 20 20 69 6e 64 | 69 63 61 74 65 09 74 68 | ind|icate.th|
|000029f0| 61 74 20 61 6e 09 61 72 | 67 75 6d 65 6e 74 20 74 |at an.ar|gument t|
|00002a00| 6f 20 74 68 65 09 6f 70 | 74 69 6f 6e 20 6d 61 79 |o the.op|tion may|
|00002a10| 20 62 65 0a 58 20 20 09 | 20 20 20 20 20 20 20 6f | be.X .| o|
|00002a20| 70 74 69 6f 6e 61 6c 6c | 79 20 73 75 70 70 6c 69 |ptionall|y suppli|
|00002a30| 65 64 20 6f 6e 20 74 68 | 65 20 63 6f 6d 6d 61 6e |ed on th|e comman|
|00002a40| 64 2d 6c 69 6e 65 2c 09 | 62 75 74 20 69 73 0a 21 |d-line,.|but is.!|
|00002a50| 20 09 20 20 20 20 20 20 | 20 6e 6f 74 20 72 65 71 | . | not req|
|00002a60| 75 69 72 65 64 2e 20 20 | 41 52 47 56 41 4c 52 45 |uired. |ARGVALRE|
|00002a70| 51 09 6d 61 79 20 62 65 | 20 60 60 6f 72 65 64 27 |Q.may be| ``ored'|
|00002a80| 27 09 69 6e 20 74 6f 0a | 58 20 20 09 20 20 20 20 |'.in to.|X . |
|00002a90| 20 20 20 69 6e 64 69 63 | 61 74 65 09 74 68 61 74 | indic|ate.that|
|00002aa0| 20 61 6e 09 61 72 67 75 | 6d 65 6e 74 20 74 6f 20 | an.argu|ment to |
|00002ab0| 74 68 65 09 6f 70 74 69 | 6f 6e 20 69 73 0a 58 20 |the.opti|on is.X |
|00002ac0| 20 09 20 20 20 20 20 20 | 20 72 65 71 75 69 72 65 | . | require|
|00002ad0| 64 09 28 74 68 69 73 20 | 69 73 20 74 68 65 20 64 |d.(this |is the d|
|00002ae0| 65 66 61 75 6c 74 20 62 | 65 68 61 76 69 6f 72 20 |efault b|ehavior |
|00002af0| 66 6f 72 20 6f 70 74 69 | 6f 6e 73 0a 21 20 09 20 |for opti|ons.! . |
|00002b00| 20 20 20 20 20 20 74 68 | 61 74 20 74 61 6b 65 20 | th|at take |
|00002b10| 61 72 67 75 6d 65 6e 74 | 73 29 2e 20 20 41 52 47 |argument|s). ARG|
|00002b20| 4c 49 53 54 20 6d 61 79 | 20 62 65 20 60 60 6f 72 |LIST may| be ``or|
|00002b30| 65 64 27 27 20 69 6e 0a | 58 20 20 09 20 20 20 20 |ed'' in.|X . |
|00002b40| 20 20 20 28 75 73 69 6e | 67 20 74 68 65 20 60 7c | (usin|g the `||
|00002b50| 27 20 63 68 61 72 61 63 | 74 65 72 29 20 74 6f 20 |' charac|ter) to |
|00002b60| 69 6e 64 69 63 61 74 65 | 20 74 68 61 74 20 61 6e |indicate| that an|
|00002b70| 0a 58 20 20 09 20 20 20 | 20 20 20 20 61 72 67 75 |.X . | argu|
|00002b80| 6d 65 6e 74 09 69 73 20 | 61 63 74 75 61 6c 6c 79 |ment.is |actually|
|00002b90| 20 61 20 6c 69 73 74 20 | 6f 66 20 6f 6e 65 20 6f | a list |of one o|
|00002ba0| 72 20 6d 6f 72 65 0a 21 | 20 09 20 20 20 20 20 20 |r more.!| . |
|00002bb0| 20 61 72 67 75 6d 65 6e | 74 73 20 66 72 6f 6d 20 | argumen|ts from |
|00002bc0| 74 68 65 20 63 6f 6d 6d | 61 6e 64 20 6c 69 6e 65 |the comm|and line|
|00002bd0| 2e 09 20 41 52 47 48 49 | 44 44 45 4e 20 6d 61 79 |.. ARGHI|DDEN may|
|00002be0| 20 62 65 0a 58 20 20 09 | 20 20 20 20 20 20 20 60 | be.X .| `|
|00002bf0| 60 6f 72 65 64 27 27 09 | 69 6e 20 74 6f 20 69 6e |`ored''.|in to in|
|00002c00| 64 69 63 61 74 65 20 61 | 20 66 6c 61 67 20 74 68 |dicate a| flag th|
|00002c10| 61 74 20 73 68 6f 75 6c | 64 20 6e 6f 74 20 62 65 |at shoul|d not be|
|00002c20| 0a 58 20 20 09 20 20 20 | 20 20 20 20 70 72 69 6e |.X . | prin|
|00002c30| 74 65 64 20 69 6e 20 75 | 73 61 67 65 09 6d 65 73 |ted in u|sage.mes|
|00002c40| 73 61 67 65 73 20 2d 20 | 66 6f 72 20 65 78 61 6d |sages - |for exam|
|00002c50| 70 6c 65 2c 09 66 6c 61 | 67 73 0a 58 20 20 09 20 |ple,.fla|gs.X . |
|00002c60| 20 20 20 20 20 20 69 6e | 74 65 6e 64 65 64 09 66 | in|tended.f|
|00002c70| 6f 72 20 69 6e 74 65 72 | 6e 61 6c 20 64 65 62 75 |or inter|nal debu|
|00002c80| 67 67 69 6e 67 20 70 75 | 72 70 6f 73 65 73 2e 0a |gging pu|rposes..|
|00002c90| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 0a |********|*******.|
|00002ca0| 2a 2a 2a 20 31 37 37 2c | 31 39 34 20 2a 2a 2a 2a |*** 177,|194 ****|
|00002cb0| 0a 58 20 20 20 20 20 20 | 20 54 68 65 20 61 72 67 |.X | The arg|
|00002cc0| 75 6d 65 6e 74 20 73 70 | 65 63 69 66 69 63 61 74 |ument sp|ecificat|
|00002cd0| 69 6f 6e 09 73 74 72 69 | 6e 67 20 6d 75 73 74 20 |ion.stri|ng must |
|00002ce0| 62 65 20 74 65 72 6d 69 | 6e 61 74 65 64 20 62 79 |be termi|nated by|
|00002cf0| 20 74 68 65 0a 58 20 20 | 20 20 20 20 20 73 69 6e | the.X | sin|
|00002d00| 67 6c 65 20 73 74 72 69 | 6e 67 3a 20 20 60 60 45 |gle stri|ng: ``E|
|00002d10| 4e 44 4f 46 41 52 47 53 | 27 27 2e 0a 58 20 20 0a |NDOFARGS|''..X .|
|00002d20| 2d 20 20 20 20 20 20 4e | 6f 74 65 20 74 68 61 74 |- N|ote that|
|00002d30| 20 74 68 65 20 63 6f 6d | 6d 61 20 63 68 61 72 61 | the com|ma chara|
|00002d40| 63 74 65 72 20 28 27 2c | 27 29 20 69 73 20 75 73 |cter (',|') is us|
|00002d50| 65 64 20 74 6f 20 73 65 | 70 61 72 61 74 65 20 61 |ed to se|parate a|
|00002d60| 6c 6c 0a 2d 20 20 20 20 | 20 20 66 69 65 6c 64 73 |ll.- | fields|
|00002d70| 20 77 69 74 68 69 6e 20 | 61 6e 20 65 6e 74 72 79 | within |an entry|
|00002d80| 2c 20 61 6e 64 20 74 6f | 20 73 65 70 61 72 61 74 |, and to| separat|
|00002d90| 65 20 74 68 65 20 65 6e | 74 72 69 65 73 0a 2d 20 |e the en|tries.- |
|00002da0| 20 20 20 20 20 74 68 65 | 6d 73 65 6c 76 65 73 2e | the|mselves.|
|00002db0| 20 20 46 6f 72 20 74 68 | 69 73 20 72 65 61 73 6f | For th|is reaso|
|00002dc0| 6e 2c 20 6e 6f 20 66 69 | 65 6c 64 20 69 6e 20 61 |n, no fi|eld in a|
|00002dd0| 6e 79 20 65 6e 74 72 79 | 20 6d 61 79 0a 2d 20 20 |ny entry| may.- |
|00002de0| 20 20 20 20 63 6f 6e 74 | 61 69 6e 20 61 20 63 6f | cont|ain a co|
|00002df0| 6d 6d 61 20 75 6e 6c 65 | 73 73 20 69 74 20 61 70 |mma unle|ss it ap|
|00002e00| 70 65 61 72 73 20 69 6e | 73 69 64 65 20 6f 66 20 |pears in|side of |
|00002e10| 64 6f 75 62 6c 65 09 6f | 72 20 73 69 6e 67 6c 65 |double.o|r single|
|00002e20| 0a 2d 20 20 20 20 20 20 | 71 75 6f 74 65 73 2e 0a |.- |quotes..|
|00002e30| 58 20 20 0a 2d 20 20 20 | 20 20 20 50 61 72 73 65 |X .- | Parse|
|00002e40| 61 72 67 73 20 77 69 6c | 6c 20 70 61 72 73 65 20 |args wil|l parse |
|00002e50| 61 6c 6c 20 63 6f 6d 6d | 61 6e 64 2d 6c 69 6e 65 |all comm|and-line|
|00002e60| 20 61 72 67 75 6d 65 6e | 74 73 20 66 6f 72 20 74 | argumen|ts for t|
|00002e70| 68 65 0a 2d 20 20 20 20 | 20 20 63 61 6c 6c 69 6e |he.- | callin|
|00002e80| 67 20 73 63 72 69 70 74 | 20 61 6e 64 09 6d 61 74 |g script| and.mat|
|00002e90| 63 68 20 74 68 65 6d 20 | 61 67 61 69 6e 73 74 20 |ch them |against |
|00002ea0| 74 68 65 20 61 72 67 75 | 6d 65 6e 74 0a 2d 20 20 |the argu|ment.- |
|00002eb0| 20 20 20 20 73 70 65 63 | 69 66 69 63 61 74 69 6f | spec|ificatio|
|00002ec0| 6e 20 73 74 72 69 6e 67 | 20 70 72 6f 76 69 64 65 |n string| provide|
|00002ed0| 64 2e 20 54 68 65 09 61 | 72 67 75 6d 65 6e 74 20 |d. The.a|rgument |
|00002ee0| 73 70 65 63 69 66 69 63 | 61 74 69 6f 6e 0a 2d 20 |specific|ation.- |
|00002ef0| 20 20 20 20 20 73 74 72 | 69 6e 67 20 69 73 20 72 | str|ing is r|
|00002f00| 65 61 64 20 66 72 6f 6d | 20 73 74 61 6e 64 61 72 |ead from| standar|
|00002f10| 64 20 69 6e 70 75 74 09 | 62 79 20 64 65 66 61 75 |d input.|by defau|
|00002f20| 6c 74 20 62 75 74 20 6d | 61 79 20 6e 6f 74 0a 2d |lt but m|ay not.-|
|00002f30| 20 20 20 20 20 20 63 6f | 6d 65 20 66 72 6f 6d 20 | co|me from |
|00002f40| 61 20 74 65 72 6d 69 6e | 61 6c 2e 20 54 68 65 20 |a termin|al. The |
|00002f50| 61 72 67 75 6d 65 6e 74 | 09 73 70 65 63 69 66 69 |argument|.specifi|
|00002f60| 63 61 74 69 6f 6e 20 73 | 74 72 69 6e 67 20 6d 61 |cation s|tring ma|
|00002f70| 79 0a 2d 20 20 20 20 20 | 20 62 65 09 73 75 70 70 |y.- | be.supp|
|00002f80| 6c 69 65 64 20 61 73 20 | 61 20 73 69 6e 67 6c 65 |lied as |a single|
|00002f90| 20 73 74 72 69 6e 67 20 | 61 72 67 75 6d 65 6e 74 | string |argument|
|00002fa0| 20 62 79 09 75 73 69 6e | 67 20 74 68 65 20 2d 61 | by.usin|g the -a|
|00002fb0| 0a 58 20 20 0a 58 20 20 | 0a 58 20 20 0a 2d 2d 2d |.X .X |.X .---|
|00002fc0| 20 31 38 38 2c 31 39 34 | 20 2d 2d 2d 2d 0a 2a 2a | 188,194| ----.**|
|00002fd0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 0a 2a 2a |********|*****.**|
|00002fe0| 2a 20 32 30 33 2c 32 30 | 38 20 2a 2a 2a 2a 0a 2d |* 203,20|8 ****.-|
|00002ff0| 2d 2d 20 32 30 33 2c 32 | 32 30 20 2d 2d 2d 2d 0a |-- 203,2|20 ----.|
|00003000| 58 20 20 0a 58 20 20 0a | 58 20 20 0a 2b 20 20 20 |X .X .|X .+ |
|00003010| 20 20 20 4e 6f 74 65 20 | 74 68 61 74 20 74 68 65 | Note |that the|
|00003020| 20 63 6f 6d 6d 61 20 63 | 68 61 72 61 63 74 65 72 | comma c|haracter|
|00003030| 20 28 27 2c 27 29 20 69 | 73 20 75 73 65 64 20 74 | (',') i|s used t|
|00003040| 6f 20 73 65 70 61 72 61 | 74 65 20 61 6c 6c 0a 2b |o separa|te all.+|
|00003050| 20 20 20 20 20 20 66 69 | 65 6c 64 73 20 77 69 74 | fi|elds wit|
|00003060| 68 69 6e 20 61 6e 20 65 | 6e 74 72 79 2c 20 61 6e |hin an e|ntry, an|
|00003070| 64 20 74 6f 20 73 65 70 | 61 72 61 74 65 20 74 68 |d to sep|arate th|
|00003080| 65 20 65 6e 74 72 69 65 | 73 0a 2b 20 20 20 20 20 |e entrie|s.+ |
|00003090| 20 74 68 65 6d 73 65 6c | 76 65 73 2e 20 20 46 6f | themsel|ves. Fo|
|000030a0| 72 20 74 68 69 73 20 72 | 65 61 73 6f 6e 2c 20 6e |r this r|eason, n|
|000030b0| 6f 20 66 69 65 6c 64 20 | 69 6e 20 61 6e 79 20 65 |o field |in any e|
|000030c0| 6e 74 72 79 20 6d 61 79 | 0a 2b 20 20 20 20 20 20 |ntry may|.+ |
|000030d0| 63 6f 6e 74 61 69 6e 20 | 61 20 63 6f 6d 6d 61 20 |contain |a comma |
|000030e0| 75 6e 6c 65 73 73 20 69 | 74 20 61 70 70 65 61 72 |unless i|t appear|
|000030f0| 73 20 69 6e 73 69 64 65 | 20 6f 66 20 64 6f 75 62 |s inside| of doub|
|00003100| 6c 65 09 6f 72 20 73 69 | 6e 67 6c 65 0a 2b 20 20 |le.or si|ngle.+ |
|00003110| 20 20 20 20 71 75 6f 74 | 65 73 2e 0a 2b 20 0a 2b | quot|es..+ .+|
|00003120| 20 20 20 20 20 20 50 61 | 72 73 65 61 72 67 73 20 | Pa|rseargs |
|00003130| 77 69 6c 6c 20 70 61 72 | 73 65 20 61 6c 6c 20 63 |will par|se all c|
|00003140| 6f 6d 6d 61 6e 64 2d 6c | 69 6e 65 20 61 72 67 75 |ommand-l|ine argu|
|00003150| 6d 65 6e 74 73 20 66 6f | 72 20 74 68 65 0a 2b 20 |ments fo|r the.+ |
|00003160| 20 20 20 20 20 63 61 6c | 6c 69 6e 67 20 73 63 72 | cal|ling scr|
|00003170| 69 70 74 20 61 6e 64 09 | 6d 61 74 63 68 20 74 68 |ipt and.|match th|
|00003180| 65 6d 20 61 67 61 69 6e | 73 74 20 74 68 65 20 61 |em again|st the a|
|00003190| 72 67 75 6d 65 6e 74 0a | 2b 20 20 20 20 20 20 73 |rgument.|+ s|
|000031a0| 70 65 63 69 66 69 63 61 | 74 69 6f 6e 20 73 74 72 |pecifica|tion str|
|000031b0| 69 6e 67 20 70 72 6f 76 | 69 64 65 64 2e 20 54 68 |ing prov|ided. Th|
|000031c0| 65 09 61 72 67 75 6d 65 | 6e 74 20 73 70 65 63 69 |e.argume|nt speci|
|000031d0| 66 69 63 61 74 69 6f 6e | 0a 2b 20 20 20 20 20 20 |fication|.+ |
|000031e0| 73 74 72 69 6e 67 20 69 | 73 20 72 65 61 64 20 66 |string i|s read f|
|000031f0| 72 6f 6d 20 73 74 61 6e | 64 61 72 64 20 69 6e 70 |rom stan|dard inp|
|00003200| 75 74 09 62 79 20 64 65 | 66 61 75 6c 74 20 62 75 |ut.by de|fault bu|
|00003210| 74 20 6d 61 79 20 6e 6f | 74 0a 2b 20 20 20 20 20 |t may no|t.+ |
|00003220| 20 63 6f 6d 65 20 66 72 | 6f 6d 20 61 20 74 65 72 | come fr|om a ter|
|00003230| 6d 69 6e 61 6c 2e 20 54 | 68 65 20 61 72 67 75 6d |minal. T|he argum|
|00003240| 65 6e 74 09 73 70 65 63 | 69 66 69 63 61 74 69 6f |ent.spec|ificatio|
|00003250| 6e 20 73 74 72 69 6e 67 | 20 6d 61 79 0a 2b 20 20 |n string| may.+ |
|00003260| 20 20 20 20 62 65 09 73 | 75 70 70 6c 69 65 64 20 | be.s|upplied |
|00003270| 61 73 20 61 20 73 69 6e | 67 6c 65 20 73 74 72 69 |as a sin|gle stri|
|00003280| 6e 67 20 61 72 67 75 6d | 65 6e 74 20 62 79 09 75 |ng argum|ent by.u|
|00003290| 73 69 6e 67 20 74 68 65 | 20 2d 61 0a 58 20 20 20 |sing the| -a.X |
|000032a0| 20 20 20 20 60 60 73 74 | 72 69 6e 67 27 27 09 66 | ``st|ring''.f|
|000032b0| 6c 61 67 2e 20 20 4c 6f | 6e 67 20 61 72 67 75 6d |lag. Lo|ng argum|
|000032c0| 65 6e 74 20 73 70 65 63 | 69 66 69 63 61 74 69 6f |ent spec|ificatio|
|000032d0| 6e 20 73 74 72 69 6e 67 | 73 0a 58 20 20 20 20 20 |n string|s.X |
|000032e0| 20 20 68 6f 77 65 76 65 | 72 2c 20 6d 61 79 20 6c | howeve|r, may l|
|000032f0| 69 6d 69 74 09 74 68 65 | 20 6e 75 6d 62 65 72 20 |imit.the| number |
|00003300| 6f 66 20 61 72 67 75 6d | 65 6e 74 73 09 74 6f 20 |of argum|ents.to |
|00003310| 74 68 65 20 73 63 72 69 | 70 74 20 69 66 0a 58 20 |the scri|pt if.X |
|00003320| 20 20 20 20 20 20 74 68 | 65 72 65 20 69 73 20 61 | th|ere is a|
|00003330| 09 6c 69 6d 69 74 20 74 | 6f 20 74 68 65 20 6e 75 |.limit t|o the nu|
|00003340| 6d 62 65 72 20 6f 66 20 | 61 72 67 75 6d 65 6e 74 |mber of |argument|
|00003350| 73 20 61 6e 64 2f 6f 72 | 0a 2a 2a 2a 2a 2a 2a 2a |s and/or|.*******|
|00003360| 2a 2a 2a 2a 2a 2a 2a 2a | 0a 2a 2a 2a 20 32 34 34 |********|.*** 244|
|00003370| 2c 32 36 33 20 2a 2a 2a | 2a 0a 58 20 20 20 20 20 |,263 ***|*.X |
|00003380| 20 20 73 74 72 69 6e 67 | 20 6f 70 74 69 6f 6e 2e | string| option.|
|00003390| 20 20 54 68 65 20 73 61 | 6d 65 20 6d 61 79 20 61 | The sa|me may a|
|000033a0| 6c 73 6f 20 62 65 20 64 | 6f 6e 65 20 66 6f 72 20 |lso be d|one for |
|000033b0| 61 20 62 6f 6f 6c 65 61 | 6e 20 66 6c 61 67 0a 58 |a boolea|n flag.X|
|000033c0| 20 20 20 20 20 20 20 74 | 68 61 74 20 69 73 20 66 | t|hat is f|
|000033d0| 61 6c 73 65 20 75 73 69 | 6e 67 20 74 68 65 20 2d |alse usi|ng the -|
|000033e0| 46 09 73 74 72 69 6e 67 | 20 6f 70 74 69 6f 6e 2e |F.string| option.|
|000033f0| 0a 58 20 20 0a 2d 20 20 | 20 20 20 20 50 61 72 73 |.X .- | Pars|
|00003400| 65 61 72 67 73 20 77 69 | 6c 6c 20 6f 6e 6c 79 20 |eargs wi|ll only |
|00003410| 73 65 74 20 74 68 65 20 | 76 61 6c 75 65 73 09 6f |set the |values.o|
|00003420| 66 20 76 61 72 69 61 62 | 6c 65 73 20 74 68 61 74 |f variab|les that|
|00003430| 0a 2d 20 20 20 20 20 20 | 63 6f 72 72 65 73 70 6f |.- |correspo|
|00003440| 6e 64 09 74 6f 20 61 72 | 67 75 6d 65 6e 74 73 20 |nd.to ar|guments |
|00003450| 74 68 61 74 20 77 65 72 | 65 20 67 69 76 65 6e 20 |that wer|e given |
|00003460| 6f 6e 09 74 68 65 20 63 | 6f 6d 6d 61 6e 64 20 6c |on.the c|ommand l|
|00003470| 69 6e 65 2e 0a 2d 20 20 | 20 20 20 20 49 66 09 61 |ine..- | If.a|
|00003480| 20 70 61 72 74 69 63 75 | 6c 61 72 20 61 72 67 75 | particu|lar argu|
|00003490| 6d 65 6e 74 20 77 61 73 | 20 6e 6f 74 20 73 75 70 |ment was| not sup|
|000034a0| 70 6c 69 65 64 20 6f 6e | 20 74 68 65 20 63 6f 6d |plied on| the com|
|000034b0| 6d 61 6e 64 0a 2d 20 20 | 20 20 20 20 6c 69 6e 65 |mand.- | line|
|000034c0| 2c 20 74 68 65 6e 09 6e | 6f 20 61 73 73 69 67 6e |, then.n|o assign|
|000034d0| 6d 65 6e 74 20 69 73 20 | 6d 61 64 65 20 66 6f 72 |ment is |made for|
|000034e0| 20 74 68 65 20 63 6f 72 | 72 65 73 70 6f 6e 64 69 | the cor|respondi|
|000034f0| 6e 67 20 73 68 65 6c 6c | 0a 2d 20 20 20 20 20 20 |ng shell|.- |
|00003500| 76 61 72 69 61 62 6c 65 | 20 61 6e 64 20 69 74 20 |variable| and it |
|00003510| 77 69 6c 6c 20 68 61 76 | 65 20 74 68 65 20 73 61 |will hav|e the sa|
|00003520| 6d 65 09 76 61 6c 75 65 | 20 74 68 61 74 20 69 74 |me.value| that it|
|00003530| 20 68 61 64 20 62 65 66 | 6f 72 65 0a 2d 20 20 20 | had bef|ore.- |
|00003540| 20 20 20 70 61 72 73 65 | 61 72 67 73 20 77 61 73 | parse|args was|
|00003550| 20 69 6e 76 6f 6b 65 64 | 2e 20 54 68 65 09 6f 6e | invoked|. The.on|
|00003560| 6c 79 20 65 78 63 65 70 | 74 69 6f 6e 20 74 6f 20 |ly excep|tion to |
|00003570| 74 68 69 73 20 69 73 20 | 74 68 61 74 20 69 66 0a |this is |that if.|
|00003580| 2d 20 20 20 20 20 20 74 | 68 65 20 2d 75 20 6f 70 |- t|he -u op|
|00003590| 74 69 6f 6e 20 69 73 20 | 73 70 65 63 69 66 69 65 |tion is |specifie|
|000035a0| 64 2c 20 74 68 65 6e 20 | 74 68 65 20 70 6f 73 69 |d, then |the posi|
|000035b0| 74 69 6f 6e 61 6c 20 70 | 61 72 61 6d 65 74 65 72 |tional p|arameter|
|000035c0| 73 0a 2d 20 20 20 20 20 | 20 61 72 65 20 75 6e 73 |s.- | are uns|
|000035d0| 65 74 20 62 65 66 6f 72 | 65 20 61 6e 79 20 73 68 |et befor|e any sh|
|000035e0| 65 6c 6c 09 76 61 72 69 | 61 62 6c 65 20 61 73 73 |ell.vari|able ass|
|000035f0| 69 67 6e 6d 65 6e 74 73 | 20 28 77 68 69 63 68 20 |ignments| (which |
|00003600| 6d 61 79 0a 2d 20 20 20 | 20 20 20 72 65 73 65 74 |may.- | reset|
|00003610| 20 74 68 65 20 70 6f 73 | 69 74 69 6f 6e 61 6c 20 | the pos|itional |
|00003620| 70 61 72 61 6d 65 74 65 | 72 73 29 20 61 72 65 20 |paramete|rs) are |
|00003630| 6d 61 64 65 2e 0a 58 20 | 20 0a 58 20 20 0a 2d 20 |made..X | .X .- |
|00003640| 0a 2d 20 0a 2d 20 0a 58 | 20 20 50 61 67 65 20 34 |.- .- .X| Page 4|
|00003650| 0a 58 20 20 0a 58 20 20 | 0a 2d 2d 2d 20 32 35 36 |.X .X |.--- 256|
|00003660| 2c 32 36 33 20 2d 2d 2d | 2d 0a 2a 2a 2a 2a 2a 2a |,263 ---|-.******|
|00003670| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 0a 2a 2a 2a 20 32 36 |********|*.*** 26|
|00003680| 39 2c 32 37 34 20 2a 2a | 2a 2a 0a 2d 2d 2d 20 32 |9,274 **|**.--- 2|
|00003690| 36 39 2c 32 38 34 20 2d | 2d 2d 2d 0a 58 20 20 0a |69,284 -|---.X .|
|000036a0| 58 20 20 0a 58 20 20 0a | 2b 20 20 20 20 20 20 50 |X .X .|+ P|
|000036b0| 61 72 73 65 61 72 67 73 | 20 77 69 6c 6c 20 6f 6e |arseargs| will on|
|000036c0| 6c 79 20 73 65 74 20 74 | 68 65 20 76 61 6c 75 65 |ly set t|he value|
|000036d0| 73 09 6f 66 20 76 61 72 | 69 61 62 6c 65 73 20 74 |s.of var|iables t|
|000036e0| 68 61 74 0a 2b 20 20 20 | 20 20 20 63 6f 72 72 65 |hat.+ | corre|
|000036f0| 73 70 6f 6e 64 09 74 6f | 20 61 72 67 75 6d 65 6e |spond.to| argumen|
|00003700| 74 73 20 74 68 61 74 20 | 77 65 72 65 20 67 69 76 |ts that |were giv|
|00003710| 65 6e 20 6f 6e 09 74 68 | 65 20 63 6f 6d 6d 61 6e |en on.th|e comman|
|00003720| 64 20 6c 69 6e 65 2e 0a | 2b 20 20 20 20 20 20 49 |d line..|+ I|
|00003730| 66 09 61 20 70 61 72 74 | 69 63 75 6c 61 72 20 61 |f.a part|icular a|
|00003740| 72 67 75 6d 65 6e 74 20 | 77 61 73 20 6e 6f 74 20 |rgument |was not |
|00003750| 73 75 70 70 6c 69 65 64 | 20 6f 6e 20 74 68 65 20 |supplied| on the |
|00003760| 63 6f 6d 6d 61 6e 64 0a | 2b 20 20 20 20 20 20 6c |command.|+ l|
|00003770| 69 6e 65 2c 20 74 68 65 | 6e 09 6e 6f 20 61 73 73 |ine, the|n.no ass|
|00003780| 69 67 6e 6d 65 6e 74 20 | 69 73 20 6d 61 64 65 20 |ignment |is made |
|00003790| 66 6f 72 20 74 68 65 20 | 63 6f 72 72 65 73 70 6f |for the |correspo|
|000037a0| 6e 64 69 6e 67 20 73 68 | 65 6c 6c 0a 2b 20 20 20 |nding sh|ell.+ |
|000037b0| 20 20 20 76 61 72 69 61 | 62 6c 65 20 61 6e 64 20 | varia|ble and |
|000037c0| 69 74 20 77 69 6c 6c 20 | 68 61 76 65 20 74 68 65 |it will |have the|
|000037d0| 20 73 61 6d 65 09 76 61 | 6c 75 65 20 74 68 61 74 | same.va|lue that|
|000037e0| 20 69 74 20 68 61 64 20 | 62 65 66 6f 72 65 0a 2b | it had |before.+|
|000037f0| 20 20 20 20 20 20 70 61 | 72 73 65 61 72 67 73 20 | pa|rseargs |
|00003800| 77 61 73 20 69 6e 76 6f | 6b 65 64 2e 20 54 68 65 |was invo|ked. The|
|00003810| 09 6f 6e 6c 79 20 65 78 | 63 65 70 74 69 6f 6e 20 |.only ex|ception |
|00003820| 74 6f 20 74 68 69 73 20 | 69 73 20 74 68 61 74 20 |to this |is that |
|00003830| 69 66 0a 2b 20 20 20 20 | 20 20 74 68 65 20 2d 75 |if.+ | the -u|
|00003840| 20 6f 70 74 69 6f 6e 20 | 69 73 20 73 70 65 63 69 | option |is speci|
|00003850| 66 69 65 64 2c 20 74 68 | 65 6e 20 74 68 65 20 70 |fied, th|en the p|
|00003860| 6f 73 69 74 69 6f 6e 61 | 6c 20 70 61 72 61 6d 65 |ositiona|l parame|
|00003870| 74 65 72 73 0a 2b 20 20 | 20 20 20 20 61 72 65 20 |ters.+ | are |
|00003880| 75 6e 73 65 74 20 62 65 | 66 6f 72 65 20 61 6e 79 |unset be|fore any|
|00003890| 20 73 68 65 6c 6c 09 76 | 61 72 69 61 62 6c 65 20 | shell.v|ariable |
|000038a0| 61 73 73 69 67 6e 6d 65 | 6e 74 73 20 28 77 68 69 |assignme|nts (whi|
|000038b0| 63 68 20 6d 61 79 0a 2b | 20 20 20 20 20 20 72 65 |ch may.+| re|
|000038c0| 73 65 74 20 74 68 65 20 | 70 6f 73 69 74 69 6f 6e |set the |position|
|000038d0| 61 6c 20 70 61 72 61 6d | 65 74 65 72 73 29 20 61 |al param|eters) a|
|000038e0| 72 65 20 6d 61 64 65 2e | 0a 2b 20 0a 58 20 20 20 |re made.|.+ .X |
|000038f0| 20 20 20 20 54 68 65 20 | 64 6f 75 62 6c 65 2d 64 | The |double-d|
|00003900| 61 73 68 20 28 60 60 2d | 2d 27 27 29 20 77 68 69 |ash (``-|-'') whi|
|00003910| 63 68 20 70 72 65 63 65 | 64 65 73 20 74 68 65 20 |ch prece|des the |
|00003920| 6e 61 6d 65 20 61 6e 64 | 0a 58 20 20 20 20 20 20 |name and|.X |
|00003930| 20 61 72 67 75 6d 65 6e | 74 73 20 6f 66 20 74 68 | argumen|ts of th|
|00003940| 65 20 63 61 6c 6c 69 6e | 67 20 70 72 6f 67 72 61 |e callin|g progra|
|00003950| 6d 20 69 73 20 6e 65 65 | 64 65 64 09 69 6e 20 6f |m is nee|ded.in o|
|00003960| 72 64 65 72 20 66 6f 72 | 0a 58 20 20 20 20 20 20 |rder for|.X |
|00003970| 20 70 61 72 73 65 61 72 | 67 73 20 74 6f 20 62 65 | parsear|gs to be|
|00003980| 20 61 62 6c 65 20 74 6f | 20 64 69 73 74 69 6e 67 | able to| disting|
|00003990| 75 69 73 68 20 6f 70 74 | 69 6f 6e 73 20 74 6f 20 |uish opt|ions to |
|000039a0| 69 74 73 65 6c 66 20 66 | 72 6f 6d 0a 2a 2a 2a 2a |itself f|rom.****|
|000039b0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 0a 2a 2a 2a 20 |********|***.*** |
|000039c0| 32 38 30 2c 32 38 35 20 | 2a 2a 2a 2a 0a 2d 2d 2d |280,285 |****.---|
|000039d0| 20 32 39 30 2c 33 31 30 | 20 2d 2d 2d 2d 0a 58 20 | 290,310| ----.X |
|000039e0| 20 20 20 20 20 20 6f 70 | 74 69 6f 6e 73 29 20 61 | op|tions) a|
|000039f0| 72 65 20 74 6f 20 62 65 | 09 70 65 72 6d 69 74 74 |re to be|.permitt|
|00003a00| 65 64 20 62 79 20 73 70 | 65 63 69 66 79 69 6e 67 |ed by sp|ecifying|
|00003a10| 09 74 68 65 20 2d 6f 20 | 28 2d 6c 29 0a 58 20 20 |.the -o |(-l).X |
|00003a20| 20 20 20 20 20 6f 70 74 | 69 6f 6e 20 6f 6e 20 74 | opt|ion on t|
|00003a30| 68 65 20 63 6f 6d 6d 61 | 6e 64 2d 6c 69 6e 65 2e |he comma|nd-line.|
|00003a40| 0a 58 20 20 0a 2b 20 53 | 50 45 43 49 46 59 49 4e |.X .+ S|PECIFYIN|
|00003a50| 47 20 50 41 52 53 45 2d | 42 45 48 41 56 49 4f 52 |G PARSE-|BEHAVIOR|
|00003a60| 0a 2b 20 20 20 20 20 20 | 54 68 65 20 2d 43 2c 20 |.+ |The -C, |
|00003a70| 2d 70 2c 20 2d 69 2c 20 | 61 6e 64 20 2d 31 20 73 |-p, -i, |and -1 s|
|00003a80| 77 69 74 63 68 65 73 20 | 6d 61 79 20 62 65 20 75 |witches |may be u|
|00003a90| 73 65 64 20 74 6f 20 6d | 6f 64 69 66 79 20 74 68 |sed to m|odify th|
|00003aa0| 65 0a 2b 20 20 20 20 20 | 20 63 6f 6d 6d 61 6e 64 |e.+ | command|
|00003ab0| 2d 6c 69 6e 65 20 70 61 | 72 73 69 6e 67 20 62 65 |-line pa|rsing be|
|00003ac0| 68 61 76 69 6f 72 20 6f | 66 20 74 68 65 20 69 6e |havior o|f the in|
|00003ad0| 76 6f 6b 69 6e 67 20 73 | 63 72 69 70 74 2e 0a 2b |voking s|cript..+|
|00003ae0| 20 20 20 20 20 20 53 70 | 65 63 69 66 79 69 6e 67 | Sp|ecifying|
|00003af0| 09 2d 43 20 77 69 6c 6c | 09 63 61 75 73 65 20 63 |.-C will|.cause c|
|00003b00| 61 73 65 2d 64 69 66 66 | 65 72 65 6e 63 65 73 20 |ase-diff|erences |
|00003b10| 69 6e 20 73 69 6e 67 6c | 65 2d 0a 2b 20 20 20 20 |in singl|e-.+ |
|00003b20| 20 20 63 68 61 72 61 63 | 74 65 72 20 6f 70 74 69 | charac|ter opti|
|00003b30| 6f 6e 73 20 74 6f 20 62 | 65 20 69 67 6e 6f 72 65 |ons to b|e ignore|
|00003b40| 64 2e 20 53 70 65 63 69 | 66 79 69 6e 67 20 2d 70 |d. Speci|fying -p|
|00003b50| 20 77 69 6c 6c 20 63 61 | 75 73 65 0a 2b 20 20 20 | will ca|use.+ |
|00003b60| 20 20 20 74 68 65 20 75 | 73 65 72 20 74 6f 20 62 | the u|ser to b|
|00003b70| 65 20 69 6e 74 65 72 61 | 63 74 69 76 65 6c 79 20 |e intera|ctively |
|00003b80| 70 72 6f 6d 70 74 65 64 | 20 66 6f 72 20 61 6e 79 |prompted| for any|
|00003b90| 20 6d 69 73 73 69 6e 67 | 0a 2b 20 20 20 20 20 20 | missing|.+ |
|00003ba0| 72 65 71 75 69 72 65 64 | 20 61 72 67 75 6d 65 6e |required| argumen|
|00003bb0| 74 73 2e 20 53 70 65 63 | 69 66 79 69 6e 67 20 2d |ts. Spec|ifying -|
|00003bc0| 69 20 77 69 6c 6c 20 63 | 61 75 73 65 20 73 79 6e |i will c|ause syn|
|00003bd0| 74 61 63 74 69 63 61 6c | 6c 79 0a 2b 20 20 20 20 |tactical|ly.+ |
|00003be0| 20 20 69 6e 63 6f 72 72 | 65 63 74 20 61 72 67 75 | incorr|ect argu|
|00003bf0| 6d 65 6e 74 73 20 74 6f | 20 62 65 20 69 67 6e 6f |ments to| be igno|
|00003c00| 72 65 64 20 28 69 6e 73 | 74 65 61 64 09 6f 66 20 |red (ins|tead.of |
|00003c10| 68 61 76 69 6e 67 20 61 | 20 75 73 61 67 65 0a 2b |having a| usage.+|
|00003c20| 20 20 20 20 20 20 6d 65 | 73 73 61 67 65 20 70 72 | me|ssage pr|
|00003c30| 69 6e 74 65 64 20 61 6e | 64 20 65 78 65 63 75 74 |inted an|d execut|
|00003c40| 69 6f 6e 20 74 65 72 6d | 69 6e 61 74 65 64 29 2e |ion term|inated).|
|00003c50| 09 53 70 65 63 69 66 79 | 69 6e 67 20 2d 31 0a 2b |.Specify|ing -1.+|
|00003c60| 20 20 20 20 20 20 77 69 | 6c 6c 20 66 6f 72 63 65 | wi|ll force|
|00003c70| 09 61 6c 6c 20 6e 6f 6e | 2d 70 6f 73 69 74 69 6f |.all non|-positio|
|00003c80| 6e 61 6c 20 70 61 72 61 | 6d 65 74 65 72 73 20 74 |nal para|meters t|
|00003c90| 6f 20 70 72 65 63 65 64 | 65 20 61 6e 79 0a 2b 20 |o preced|e any.+ |
|00003ca0| 20 20 20 20 20 70 6f 73 | 69 74 69 6f 6e 61 6c 09 | pos|itional.|
|00003cb0| 70 61 72 61 6d 65 74 65 | 72 73 20 6f 6e 20 74 68 |paramete|rs on th|
|00003cc0| 65 20 63 6f 6d 6d 61 6e | 64 2d 6c 69 6e 65 20 28 |e comman|d-line (|
|00003cd0| 68 65 6e 63 65 20 61 6e | 79 74 68 69 6e 67 20 6f |hence an|ything o|
|00003ce0| 6e 0a 2b 20 20 20 20 20 | 20 74 68 65 20 63 6f 6d |n.+ | the com|
|00003cf0| 6d 61 6e 64 2d 6c 69 6e | 65 20 61 66 74 65 72 20 |mand-lin|e after |
|00003d00| 61 20 70 6f 73 69 74 69 | 6f 6e 61 6c 20 70 61 72 |a positi|onal par|
|00003d10| 61 6d 65 74 65 72 20 74 | 68 61 74 09 72 65 73 65 |ameter t|hat.rese|
|00003d20| 6d 62 6c 65 73 0a 2b 20 | 20 20 20 20 20 61 20 6b |mbles.+ | a k|
|00003d30| 65 79 77 6f 72 64 20 70 | 61 72 61 6d 65 74 65 72 |eyword p|arameter|
|00003d40| 20 77 69 6c 6c 20 6e 65 | 76 65 72 74 68 65 6c 65 | will ne|verthele|
|00003d50| 73 20 62 65 20 69 6e 74 | 65 72 70 72 65 74 65 64 |s be int|erpreted|
|00003d60| 20 61 73 20 61 0a 2b 20 | 20 20 20 20 20 70 6f 73 | as a.+ | pos|
|00003d70| 69 74 69 6f 6e 61 6c 09 | 70 61 72 61 6d 65 74 65 |itional.|paramete|
|00003d80| 72 29 2e 0a 2b 20 0a 58 | 20 20 4f 50 54 49 4f 4e |r)..+ .X| OPTION|
|00003d90| 53 09 57 49 54 48 20 4f | 50 54 49 4f 4e 41 4c 20 |S.WITH O|PTIONAL |
|00003da0| 41 52 47 55 4d 45 4e 54 | 53 0a 58 20 20 20 20 20 |ARGUMENT|S.X |
|00003db0| 20 20 4f 70 74 69 6f 6e | 73 20 74 68 61 74 20 6d | Option|s that m|
|00003dc0| 61 79 20 74 61 6b 65 20 | 61 6e 20 6f 70 74 69 6f |ay take |an optio|
|00003dd0| 6e 61 6c 20 61 72 67 75 | 6d 65 6e 74 09 6e 65 65 |nal argu|ment.nee|
|00003de0| 64 20 73 70 65 63 69 61 | 6c 0a 58 20 20 20 20 20 |d specia|l.X |
|00003df0| 20 20 63 6f 6e 73 69 64 | 65 72 61 74 69 6f 6e 2e | consid|eration.|
|00003e00| 20 20 54 68 65 20 73 68 | 65 6c 6c 20 70 72 6f 67 | The sh|ell prog|
|00003e10| 72 61 6d 6d 65 72 20 6e | 65 65 64 73 09 74 6f 20 |rammer n|eeds.to |
|00003e20| 6b 6e 6f 77 09 77 68 65 | 74 68 65 72 0a 2a 2a 2a |know.whe|ther.***|
|00003e30| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 0a 2a 2a 2a |********|****.***|
|00003e40| 20 32 39 37 2c 33 30 32 | 20 2a 2a 2a 2a 0a 2d 2d | 297,302| ****.--|
|00003e50| 2d 20 33 32 32 2c 33 34 | 30 20 2d 2d 2d 2d 0a 58 |- 322,34|0 ----.X|
|00003e60| 20 20 20 20 20 20 20 74 | 68 65 20 73 68 65 6c 6c | t|he shell|
|00003e70| 20 76 61 72 69 61 62 6c | 65 09 61 73 73 6f 63 69 | variabl|e.associ|
|00003e80| 61 74 65 64 20 77 69 74 | 68 09 74 68 65 20 6f 70 |ated wit|h.the op|
|00003e90| 74 69 6f 6e 20 69 6e 20 | 74 68 65 0a 58 20 20 20 |tion in |the.X |
|00003ea0| 20 20 20 20 61 72 67 75 | 6d 65 6e 74 20 64 65 73 | argu|ment des|
|00003eb0| 63 72 69 70 74 69 6f 6e | 20 73 74 72 69 6e 67 2e |cription| string.|
|00003ec0| 0a 58 20 20 0a 2b 20 0a | 2b 20 0a 2b 20 50 61 67 |.X .+ .|+ .+ Pag|
|00003ed0| 65 20 35 0a 2b 20 0a 2b | 20 0a 2b 20 0a 2b 20 0a |e 5.+ .+| .+ .+ .|
|00003ee0| 2b 20 0a 2b 20 0a 2b 20 | 50 41 52 53 45 41 52 47 |+ .+ .+ |PARSEARG|
|00003ef0| 53 28 31 29 09 09 09 09 | 09 20 20 20 20 20 50 41 |S(1)....|. PA|
|00003f00| 52 53 45 41 52 47 53 28 | 31 29 0a 2b 20 0a 2b 20 |RSEARGS(|1).+ .+ |
|00003f10| 0a 2b 20 0a 58 20 20 41 | 52 47 55 4d 45 4e 54 20 |.+ .X A|RGUMENT |
|00003f20| 4c 49 53 54 53 0a 58 20 | 20 20 20 20 20 20 50 61 |LISTS.X | Pa|
|00003f30| 72 73 65 61 72 67 73 20 | 74 72 65 61 74 73 20 41 |rseargs |treats A|
|00003f40| 52 47 4c 49 53 54 20 61 | 72 67 75 6d 65 6e 74 73 |RGLIST a|rguments|
|00003f50| 09 69 6e 20 61 20 73 70 | 65 63 69 61 6c 20 77 61 |.in a sp|ecial wa|
|00003f60| 79 2e 20 54 68 65 0a 58 | 20 20 20 20 20 20 20 6d |y. The.X| m|
|00003f70| 65 74 68 6f 64 20 75 73 | 65 64 20 66 6f 72 20 73 |ethod us|ed for s|
|00003f80| 65 74 74 69 6e 67 20 75 | 70 09 61 6e 20 61 72 67 |etting u|p.an arg|
|00003f90| 75 6d 65 6e 74 20 6c 69 | 73 74 20 64 65 70 65 6e |ument li|st depen|
|00003fa0| 64 73 20 6c 61 72 67 65 | 6c 79 0a 2a 2a 2a 2a 2a |ds large|ly.*****|
|00003fb0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 0a 2a 2a 2a 20 33 |********|**.*** 3|
|00003fc0| 32 31 2c 33 34 30 20 2a | 2a 2a 2a 0a 58 20 20 20 |21,340 *|***.X |
|00003fd0| 20 20 20 20 70 6f 73 69 | 74 69 6f 6e 61 6c 09 70 | posi|tional.p|
|00003fe0| 61 72 61 6d 65 74 65 72 | 73 20 6f 66 20 74 68 65 |arameter|s of the|
|00003ff0| 20 63 61 6c 6c 69 6e 67 | 20 70 72 6f 67 72 61 6d | calling| program|
|00004000| 20 77 69 6c 6c 20 62 65 | 20 72 65 2d 0a 58 20 20 | will be| re-.X |
|00004010| 20 20 20 20 20 61 73 73 | 69 67 6e 65 64 20 74 6f | ass|igned to|
|00004020| 20 74 68 65 20 63 6f 6e | 74 65 6e 74 73 20 6f 66 | the con|tents of|
|00004030| 20 74 68 65 20 61 72 67 | 75 6d 65 6e 74 20 6c 69 | the arg|ument li|
|00004040| 73 74 2e 0a 58 20 20 0a | 2d 20 0a 2d 20 0a 2d 20 |st..X .|- .- .- |
|00004050| 0a 2d 20 50 61 67 65 20 | 35 0a 2d 20 0a 2d 20 0a |.- Page |5.- .- .|
|00004060| 2d 20 0a 2d 20 0a 2d 20 | 0a 2d 20 0a 2d 20 50 41 |- .- .- |.- .- PA|
|00004070| 52 53 45 41 52 47 53 28 | 31 29 09 09 09 09 09 20 |RSEARGS(|1)..... |
|00004080| 20 20 20 20 50 41 52 53 | 45 41 52 47 53 28 31 29 | PARS|EARGS(1)|
|00004090| 0a 2d 20 0a 2d 20 0a 2d | 20 0a 58 20 20 20 20 20 |.- .- .-| .X |
|000040a0| 20 20 46 6f 72 20 74 68 | 65 20 50 6c 61 6e 20 39 | For th|e Plan 9|
|000040b0| 20 73 68 65 6c 6c 20 28 | 72 63 29 2c 09 69 66 20 | shell (|rc),.if |
|000040c0| 74 68 65 20 76 61 72 69 | 61 62 6c 65 09 6e 61 6d |the vari|able.nam|
|000040d0| 65 0a 58 20 20 20 20 20 | 20 20 63 6f 72 72 65 73 |e.X | corres|
|000040e0| 70 6f 6e 64 69 6e 67 20 | 74 6f 20 74 68 65 20 41 |ponding |to the A|
|000040f0| 52 47 4c 49 53 54 20 61 | 72 67 75 6d 65 6e 74 20 |RGLIST a|rgument |
|00004100| 69 73 20 60 60 2a 27 27 | 2c 20 74 68 65 6e 20 74 |is ``*''|, then t|
|00004110| 68 65 0a 58 20 20 20 20 | 20 20 20 70 6f 73 69 74 |he.X | posit|
|00004120| 69 6f 6e 61 6c 09 70 61 | 72 61 6d 65 74 65 72 73 |ional.pa|rameters|
|00004130| 20 6f 66 20 74 68 65 20 | 63 61 6c 6c 69 6e 67 20 | of the |calling |
|00004140| 70 72 6f 67 72 61 6d 20 | 77 69 6c 6c 20 62 65 20 |program |will be |
|00004150| 72 65 2d 0a 2d 2d 2d 20 | 33 35 39 2c 33 36 34 20 |re-.--- |359,364 |
|00004160| 2d 2d 2d 2d 0a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |----.***|********|
|00004170| 2a 2a 2a 2a 0a 2a 2a 2a | 20 33 34 34 2c 33 34 39 |****.***| 344,349|
|00004180| 20 2a 2a 2a 2a 0a 2d 2d | 2d 20 33 36 38 2c 33 37 | ****.--|- 368,37|
|00004190| 34 20 2d 2d 2d 2d 0a 58 | 20 20 20 20 20 20 20 41 |4 ----.X| A|
|000041a0| 52 47 4c 49 53 54 20 61 | 72 67 75 6d 65 6e 74 20 |RGLIST a|rgument |
|000041b0| 69 73 20 60 60 41 52 47 | 56 27 27 2c 20 74 68 65 |is ``ARG|V'', the|
|000041c0| 6e 09 74 68 65 20 70 6f | 73 69 74 69 6f 6e 61 6c |n.the po|sitional|
|000041d0| 20 70 61 72 61 6d 65 74 | 65 72 73 0a 58 20 20 20 | paramet|ers.X |
|000041e0| 20 20 20 20 6f 66 09 74 | 68 65 20 63 61 6c 6c 69 | of.t|he calli|
|000041f0| 6e 67 20 70 72 6f 67 72 | 61 6d 20 77 69 6c 6c 20 |ng progr|am will |
|00004200| 62 65 20 72 65 2d 61 73 | 73 69 67 6e 65 64 09 74 |be re-as|signed.t|
|00004210| 6f 20 74 68 65 20 63 6f | 6e 74 65 6e 74 73 0a 58 |o the co|ntents.X|
|00004220| 20 20 20 20 20 20 20 6f | 66 09 74 68 65 20 61 72 | o|f.the ar|
|00004230| 67 75 6d 65 6e 74 20 6c | 69 73 74 2e 0a 2b 20 0a |gument l|ist..+ .|
|00004240| 58 20 20 20 20 20 20 20 | 42 6f 75 72 6e 65 20 53 |X |Bourne S|
|00004250| 68 65 6c 6c 20 41 72 67 | 75 6d 65 6e 74 20 4c 69 |hell Arg|ument Li|
|00004260| 73 74 73 0a 58 20 20 0a | 58 20 20 20 20 20 20 20 |sts.X .|X |
|00004270| 46 6f 72 20 74 68 65 20 | 42 6f 75 72 6e 65 20 73 |For the |Bourne s|
|00004280| 68 65 6c 6c 2c 20 69 66 | 20 74 68 65 20 61 73 73 |hell, if| the ass|
|00004290| 6f 63 69 61 74 65 64 20 | 76 61 72 69 61 62 6c 65 |ociated |variable|
|000042a0| 20 6e 61 6d 65 20 69 73 | 20 4e 4f 54 0a 2a 2a 2a | name is| NOT.***|
|000042b0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 0a 2a 2a 2a |********|****.***|
|000042c0| 20 33 35 36 2c 33 36 32 | 20 2a 2a 2a 2a 0a 58 20 | 356,362| ****.X |
|000042d0| 20 20 20 20 20 20 63 6f | 6e 74 61 69 6e 73 20 61 | co|ntains a|
|000042e0| 6e 20 49 46 53 20 63 68 | 61 72 61 63 74 65 72 20 |n IFS ch|aracter |
|000042f0| 28 73 75 63 68 20 61 73 | 09 61 20 73 70 61 63 65 |(such as|.a space|
|00004300| 09 6f 72 20 61 20 74 61 | 62 29 2c 20 74 68 65 6e |.or a ta|b), then|
|00004310| 0a 58 20 20 20 20 20 20 | 20 74 68 61 74 20 70 61 |.X | that pa|
|00004320| 72 74 69 63 75 6c 61 72 | 20 77 6f 72 64 20 77 69 |rticular| word wi|
|00004330| 6c 6c 20 62 65 20 74 72 | 65 61 74 65 64 20 62 79 |ll be tr|eated by|
|00004340| 20 74 68 65 20 42 6f 75 | 72 6e 65 09 73 68 65 6c | the Bou|rne.shel|
|00004350| 6c 20 61 73 0a 58 20 20 | 20 20 20 20 20 74 77 6f |l as.X | two|
|00004360| 20 64 69 73 74 69 6e 63 | 74 20 77 6f 72 64 73 2e | distinc|t words.|
|00004370| 0a 2d 20 0a 58 20 20 20 | 20 20 20 20 41 6c 73 6f |.- .X | Also|
|00004380| 20 66 6f 72 20 74 68 65 | 20 42 6f 75 72 6e 65 20 | for the| Bourne |
|00004390| 73 68 65 6c 6c 2c 09 49 | 66 20 74 68 65 20 61 73 |shell,.I|f the as|
|000043a0| 73 6f 63 69 61 74 65 64 | 20 76 61 72 69 61 62 6c |sociated| variabl|
|000043b0| 65 20 6e 61 6d 65 0a 58 | 20 20 20 20 20 20 20 69 |e name.X| i|
|000043c0| 73 09 4e 4f 54 20 60 60 | 2d 2d 27 27 20 61 6e 64 |s.NOT ``|--'' and|
|000043d0| 20 74 68 65 20 2d 41 20 | 6f 70 74 69 6f 6e 20 57 | the -A |option W|
|000043e0| 41 53 20 73 70 65 63 69 | 66 69 65 64 2c 20 74 68 |AS speci|fied, th|
|000043f0| 65 6e 20 74 68 61 74 0a | 58 20 20 20 20 20 20 20 |en that.|X |
|00004400| 76 61 72 69 61 62 6c 65 | 20 69 73 20 74 72 65 61 |variable| is trea|
|00004410| 74 65 64 20 61 73 20 74 | 68 65 09 72 6f 6f 74 20 |ted as t|he.root |
|00004420| 6e 61 6d 65 20 6f 66 20 | 61 6e 09 61 72 72 61 79 |name of |an.array|
|00004430| 20 74 68 61 74 20 69 73 | 20 73 65 74 0a 2d 2d 2d | that is| set.---|
|00004440| 20 33 38 31 2c 33 38 36 | 20 2d 2d 2d 2d 0a 2a 2a | 381,386| ----.**|
|00004450| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 0a 2a 2a |********|*****.**|
|00004460| 2a 20 33 36 33 2c 33 36 | 38 20 2a 2a 2a 2a 0a 2d |* 363,36|8 ****.-|
|00004470| 2d 2d 20 33 38 37 2c 34 | 30 36 20 2d 2d 2d 2d 0a |-- 387,4|06 ----.|
|00004480| 58 20 20 20 20 20 20 20 | 75 73 69 6e 67 20 74 68 |X |using th|
|00004490| 65 20 66 6f 6c 6c 6f 77 | 69 6e 67 20 73 79 6e 74 |e follow|ing synt|
|000044a0| 61 78 3a 0a 58 20 20 09 | 20 20 6e 61 6d 65 31 3d |ax:.X .| name1=|
|000044b0| 27 61 72 67 31 27 0a 58 | 20 20 09 20 20 6e 61 6d |'arg1'.X| . nam|
|000044c0| 65 32 3d 27 61 72 67 32 | 27 0a 2b 20 0a 2b 20 0a |e2='arg2|'.+ .+ .|
|000044d0| 2b 20 0a 2b 20 50 61 67 | 65 20 36 0a 2b 20 0a 2b |+ .+ Pag|e 6.+ .+|
|000044e0| 20 0a 2b 20 0a 2b 20 0a | 2b 20 0a 2b 20 0a 2b 20 | .+ .+ .|+ .+ .+ |
|000044f0| 50 41 52 53 45 41 52 47 | 53 28 31 29 09 09 09 09 |PARSEARG|S(1)....|
|00004500| 09 20 20 20 20 20 50 41 | 52 53 45 41 52 47 53 28 |. PA|RSEARGS(|
|00004510| 31 29 0a 2b 20 0a 2b 20 | 0a 2b 20 0a 58 20 20 09 |1).+ .+ |.+ .X .|
|00004520| 20 20 20 20 20 20 2e 2e | 2e 0a 58 20 20 20 20 20 | ..|..X |
|00004530| 20 20 61 6e 64 20 74 68 | 65 20 76 61 72 69 61 62 | and th|e variab|
|00004540| 6c 65 20 60 60 6e 61 6d | 65 5f 63 6f 75 6e 74 27 |le ``nam|e_count'|
|00004550| 27 20 77 69 6c 6c 20 62 | 65 20 73 65 74 20 74 6f |' will b|e set to|
|00004560| 20 63 6f 6e 74 61 69 6e | 20 74 68 65 0a 58 20 20 | contain| the.X |
|00004570| 20 20 20 20 20 6e 75 6d | 62 65 72 20 6f 66 20 69 | num|ber of i|
|00004580| 74 65 6d 73 20 69 6e 09 | 74 68 65 20 61 72 72 61 |tems in.|the arra|
|00004590| 79 2e 20 20 54 68 65 09 | 75 73 65 72 20 6d 61 79 |y. The.|user may|
|000045a0| 20 74 68 65 6e 20 73 74 | 65 70 0a 2a 2a 2a 2a 2a | then st|ep.*****|
|000045b0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 0a 2a 2a 2a 20 33 |********|**.*** 3|
|000045c0| 38 37 2c 34 30 36 20 2a | 2a 2a 2a 0a 58 20 20 20 |87,406 *|***.X |
|000045d0| 20 20 20 20 6f 76 65 72 | 77 72 69 74 74 65 6e 20 | over|written |
|000045e0| 62 79 20 74 68 65 09 73 | 65 74 20 63 6f 6d 6d 61 |by the.s|et comma|
|000045f0| 6e 64 29 2e 0a 58 20 20 | 20 20 20 20 20 49 74 09 |nd)..X | It.|
|00004600| 73 68 6f 75 6c 64 20 62 | 65 20 6e 6f 74 65 64 09 |should b|e noted.|
|00004610| 74 68 61 74 20 74 68 65 | 72 65 20 69 73 20 61 09 |that the|re is a.|
|00004620| 62 75 67 20 69 6e 20 76 | 65 72 73 69 6f 6e 73 09 |bug in v|ersions.|
|00004630| 6f 66 20 74 68 65 0a 58 | 20 20 20 20 20 20 20 4b |of the.X| K|
|00004640| 6f 72 6e 20 73 68 65 6c | 6c 09 65 61 72 6c 69 65 |orn shel|l.earlie|
|00004650| 72 09 74 68 61 6e 20 31 | 31 2f 31 36 2f 38 38 61 |r.than 1|1/16/88a|
|00004660| 2c 09 69 6e 20 77 68 69 | 63 68 20 74 68 65 20 66 |,.in whi|ch the f|
|00004670| 6f 6c 6c 6f 77 69 6e 67 | 3a 0a 2d 20 0a 2d 20 0a |ollowing|:.- .- .|
|00004680| 2d 20 0a 2d 20 50 61 67 | 65 20 36 0a 2d 20 0a 2d |- .- Pag|e 6.- .-|
|00004690| 20 0a 2d 20 0a 2d 20 0a | 2d 20 0a 2d 20 0a 2d 20 | .- .- .|- .- .- |
|000046a0| 50 41 52 53 45 41 52 47 | 53 28 31 29 09 09 09 09 |PARSEARG|S(1)....|
|000046b0| 09 20 20 20 20 20 50 41 | 52 53 45 41 52 47 53 28 |. PA|RSEARGS(|
|000046c0| 31 29 0a 2d 20 0a 2d 20 | 0a 2d 20 0a 58 20 20 09 |1).- .- |.- .X .|
|000046d0| 20 20 73 65 74 20 20 2d | 41 20 20 6e 61 6d 65 09 | set -|A name.|
|000046e0| 20 27 61 72 67 31 27 09 | 20 27 61 72 67 32 27 09 | 'arg1'.| 'arg2'.|
|000046f0| 20 2e 2e 2e 0a 58 20 20 | 20 20 20 20 20 63 61 75 | ....X | cau|
|00004700| 73 65 73 20 74 68 65 09 | 70 6f 73 69 74 69 6f 6e |ses the.|position|
|00004710| 61 6c 20 70 61 72 61 6d | 65 74 65 72 73 20 74 6f |al param|eters to|
|00004720| 20 62 65 20 6f 76 65 72 | 77 72 69 74 74 65 6e 09 | be over|written.|
|00004730| 61 73 20 61 6e 0a 58 20 | 20 20 20 20 20 20 75 6e |as an.X | un|
|00004740| 69 6e 74 65 6e 74 69 6f | 6e 61 6c 20 73 69 64 65 |intentio|nal side|
|00004750| 2d 65 66 66 65 63 74 2e | 09 49 66 20 79 6f 75 72 |-effect.|.If your|
|00004760| 09 76 65 72 73 69 6f 6e | 09 6f 66 20 74 68 65 20 |.version|.of the |
|00004770| 4b 6f 72 6e 20 73 68 65 | 6c 6c 0a 2d 2d 2d 20 34 |Korn she|ll.--- 4|
|00004780| 32 35 2c 34 33 30 20 2d | 2d 2d 2d 0a 2a 2a 2a 2a |25,430 -|---.****|
|00004790| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 0a 2a 2a 2a 20 |********|***.*** |
|000047a0| 34 30 39 2c 34 31 34 20 | 2a 2a 2a 2a 0a 2d 2d 2d |409,414 |****.---|
|000047b0| 20 34 33 33 2c 34 33 39 | 20 2d 2d 2d 2d 0a 58 20 | 433,439| ----.X |
|000047c0| 20 20 20 20 20 20 6d 75 | 73 74 20 73 61 76 65 20 | mu|st save |
|000047d0| 74 68 65 6d 20 79 6f 75 | 72 73 65 6c 66 20 62 65 |them you|rself be|
|000047e0| 66 6f 72 65 20 79 6f 75 | 09 63 61 6c 6c 20 70 61 |fore you|.call pa|
|000047f0| 72 73 65 61 72 67 73 2e | 09 54 68 69 73 20 6d 61 |rseargs.|.This ma|
|00004800| 79 0a 58 20 20 20 20 20 | 20 20 62 65 09 61 63 63 |y.X | be.acc|
|00004810| 6f 6d 70 6c 69 73 68 65 | 64 20 62 79 09 74 68 65 |omplishe|d by.the|
|00004820| 20 66 6f 6c 6c 6f 77 69 | 6e 67 3a 0a 58 20 20 09 | followi|ng:.X .|
|00004830| 20 20 73 65 74 20 20 2d | 41 20 20 73 61 76 65 5f | set -|A save_|
|00004840| 70 61 72 6d 73 20 20 22 | 24 40 22 0a 2b 20 0a 58 |parms "|$@".+ .X|
|00004850| 20 20 20 20 20 20 20 43 | 20 61 6e 64 20 54 43 20 | C| and TC |
|00004860| 53 68 65 6c 6c 20 41 72 | 67 75 6d 65 6e 74 20 4c |Shell Ar|gument L|
|00004870| 69 73 74 73 0a 58 20 20 | 0a 58 20 20 20 20 20 20 |ists.X |.X |
|00004880| 20 46 6f 72 20 74 68 65 | 20 43 20 61 6e 64 20 54 | For the| C and T|
|00004890| 43 20 73 68 65 6c 6c 73 | 2c 20 41 52 47 4c 49 53 |C shells|, ARGLIS|
|000048a0| 54 20 76 61 72 69 61 62 | 6c 65 73 09 61 72 65 20 |T variab|les.are |
|000048b0| 74 72 65 61 74 65 64 20 | 61 73 0a 2a 2a 2a 2a 2a |treated |as.*****|
|000048c0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 0a 2a 2a 2a 20 34 |********|**.*** 4|
|000048d0| 31 38 2c 34 33 36 20 2a | 2a 2a 2a 0a 58 20 20 20 |18,436 *|***.X |
|000048e0| 20 20 20 20 69 6e 09 24 | 6e 61 6d 65 5b 32 5d 2c | in.$|name[2],|
|000048f0| 20 65 74 63 20 2e 2e 2e | 2c 20 61 6e 64 20 61 6c | etc ...|, and al|
|00004900| 6c 20 69 74 65 6d 73 20 | 6d 61 79 20 62 65 09 67 |l items |may be.g|
|00004910| 69 76 65 6e 20 62 79 20 | 24 6e 61 6d 65 2e 0a 58 |iven by |$name..X|
|00004920| 20 20 20 20 20 20 20 4e | 6f 74 69 63 65 20 74 68 | N|otice th|
|00004930| 61 74 20 4b 6f 72 6e 20 | 73 68 65 6c 6c 20 61 72 |at Korn |shell ar|
|00004940| 72 61 79 73 20 73 74 61 | 72 74 20 61 74 20 69 6e |rays sta|rt at in|
|00004950| 64 65 78 20 7a 65 72 6f | 20 77 68 65 72 65 61 73 |dex zero| whereas|
|00004960| 20 43 0a 58 20 20 20 20 | 20 20 20 61 6e 64 20 54 | C.X | and T|
|00004970| 43 20 73 68 65 6c 6c 20 | 77 6f 72 64 2d 6c 69 73 |C shell |word-lis|
|00004980| 74 73 20 73 74 61 72 74 | 20 61 74 20 69 6e 64 65 |ts start| at inde|
|00004990| 78 20 6f 6e 65 2e 0a 2d | 20 0a 58 20 20 20 20 20 |x one..-| .X |
|000049a0| 20 20 42 6f 75 72 6e 65 | 2d 41 67 61 69 6e 20 53 | Bourne|-Again S|
|000049b0| 68 65 6c 6c 09 41 72 67 | 75 6d 65 6e 74 20 4c 69 |hell.Arg|ument Li|
|000049c0| 73 74 73 0a 58 20 20 0a | 58 20 20 20 20 20 20 20 |sts.X .|X |
|000049d0| 41 74 09 70 72 65 73 65 | 6e 74 2c 20 74 68 65 20 |At.prese|nt, the |
|000049e0| 46 72 65 65 20 53 6f 66 | 74 77 61 72 65 20 46 6f |Free Sof|tware Fo|
|000049f0| 75 6e 64 61 74 69 6f 6e | 27 73 09 42 6f 75 72 6e |undation|'s.Bourn|
|00004a00| 65 2d 41 67 61 69 6e 0a | 58 20 20 20 20 20 20 20 |e-Again.|X |
|00004a10| 73 68 65 6c 6c 20 69 73 | 20 74 72 65 61 74 65 64 |shell is| treated|
|00004a20| 20 65 78 61 63 74 6c 79 | 20 74 68 65 20 73 61 6d | exactly| the sam|
|00004a30| 65 20 61 73 20 74 68 65 | 20 42 6f 75 72 6e 65 20 |e as the| Bourne |
|00004a40| 53 68 65 6c 6c 2e 20 54 | 68 69 73 0a 58 20 20 20 |Shell. T|his.X |
|00004a50| 20 20 20 20 77 69 6c 6c | 20 63 68 61 6e 67 65 20 | will| change |
|00004a60| 77 68 65 6e 20 62 61 73 | 68 20 73 75 70 70 6f 72 |when bas|h suppor|
|00004a70| 74 73 20 61 72 72 61 79 | 73 2e 0a 58 20 20 20 20 |ts array|s..X |
|00004a80| 20 20 20 50 6c 61 6e 20 | 39 20 53 68 65 6c 6c 20 | Plan |9 Shell |
|00004a90| 41 72 67 75 6d 65 6e 74 | 20 4c 69 73 74 73 0a 58 |Argument| Lists.X|
|00004aa0| 20 20 0a 58 20 20 20 20 | 20 20 20 46 6f 72 20 74 | .X | For t|
|00004ab0| 68 65 20 50 6c 61 6e 20 | 39 20 73 68 65 6c 6c 2c |he Plan |9 shell,|
|00004ac0| 20 69 66 20 74 68 65 20 | 61 73 73 6f 63 69 61 74 | if the |associat|
|00004ad0| 65 64 20 76 61 72 69 61 | 62 6c 65 20 6e 61 6d 65 |ed varia|ble name|
|00004ae0| 20 69 73 20 6e 6f 74 0a | 21 20 20 20 20 20 20 60 | is not.|! `|
|00004af0| 60 2a 27 27 20 74 68 65 | 6e 09 69 74 20 69 73 20 |`*'' the|n.it is |
|00004b00| 63 6f 6e 73 69 64 65 72 | 65 64 20 74 6f 20 62 65 |consider|ed to be|
|00004b10| 20 77 6f 72 64 2d 6c 69 | 73 74 20 61 6e 64 20 73 | word-li|st and s|
|00004b20| 65 74 20 75 73 69 6e 67 | 0a 58 20 20 20 20 20 20 |et using|.X |
|00004b30| 20 74 68 65 20 66 6f 6c | 6c 6f 77 69 6e 67 20 73 | the fol|lowing s|
|00004b40| 79 6e 74 61 78 3a 0a 58 | 20 20 09 20 20 6e 61 6d |yntax:.X| . nam|
|00004b50| 65 3d 28 20 27 61 72 67 | 31 27 09 20 27 61 72 67 |e=( 'arg|1'. 'arg|
|00004b60| 32 27 09 20 2e 2e 2e 20 | 29 0a 2d 20 0a 58 20 20 |2'. ... |).- .X |
|00004b70| 20 20 20 20 20 41 77 6b | 20 41 72 67 75 6d 65 6e | Awk| Argumen|
|00004b80| 74 20 4c 69 73 74 73 0a | 58 20 20 20 20 20 20 20 |t Lists.|X |
|00004b90| 46 6f 72 20 61 77 6b 2c | 20 69 66 20 74 68 65 20 |For awk,| if the |
|00004ba0| 2d 41 09 6f 70 74 69 6f | 6e 20 69 73 20 6e 6f 74 |-A.optio|n is not|
|00004bb0| 20 67 69 76 65 6e 2c 20 | 74 68 65 6e 20 74 68 65 | given, |then the|
|00004bc0| 20 6f 75 74 70 75 74 20 | 66 6f 72 0a 58 20 20 20 | output |for.X |
|00004bd0| 20 20 20 20 74 68 65 73 | 20 76 61 72 69 61 62 6c | thes| variabl|
|00004be0| 65 2d 6c 69 73 74 09 77 | 69 6c 6c 20 62 65 09 61 |e-list.w|ill be.a|
|00004bf0| 20 6c 69 6e 65 20 77 69 | 74 68 20 74 68 65 09 76 | line wi|th the.v|
|00004c00| 61 72 69 61 62 6c 65 20 | 6e 61 6d 65 2c 0a 2d 2d |ariable |name,.--|
|00004c10| 2d 20 34 34 33 2c 34 37 | 34 20 2d 2d 2d 2d 0a 58 |- 443,47|4 ----.X|
|00004c20| 20 20 20 20 20 20 20 69 | 6e 09 24 6e 61 6d 65 5b | i|n.$name[|
|00004c30| 32 5d 2c 20 65 74 63 20 | 2e 2e 2e 2c 20 61 6e 64 |2], etc |..., and|
|00004c40| 20 61 6c 6c 20 69 74 65 | 6d 73 20 6d 61 79 20 62 | all ite|ms may b|
|00004c50| 65 09 67 69 76 65 6e 20 | 62 79 20 24 6e 61 6d 65 |e.given |by $name|
|00004c60| 2e 0a 58 20 20 20 20 20 | 20 20 4e 6f 74 69 63 65 |..X | Notice|
|00004c70| 20 74 68 61 74 20 4b 6f | 72 6e 20 73 68 65 6c 6c | that Ko|rn shell|
|00004c80| 20 61 72 72 61 79 73 20 | 73 74 61 72 74 20 61 74 | arrays |start at|
|00004c90| 20 69 6e 64 65 78 20 7a | 65 72 6f 20 77 68 65 72 | index z|ero wher|
|00004ca0| 65 61 73 20 43 0a 58 20 | 20 20 20 20 20 20 61 6e |eas C.X | an|
|00004cb0| 64 20 54 43 20 73 68 65 | 6c 6c 20 77 6f 72 64 2d |d TC she|ll word-|
|00004cc0| 6c 69 73 74 73 20 73 74 | 61 72 74 20 61 74 20 69 |lists st|art at i|
|00004cd0| 6e 64 65 78 20 6f 6e 65 | 2e 0a 58 20 20 20 20 20 |ndex one|..X |
|00004ce0| 20 20 42 6f 75 72 6e 65 | 2d 41 67 61 69 6e 20 53 | Bourne|-Again S|
|00004cf0| 68 65 6c 6c 09 41 72 67 | 75 6d 65 6e 74 20 4c 69 |hell.Arg|ument Li|
|00004d00| 73 74 73 0a 58 20 20 0a | 58 20 20 20 20 20 20 20 |sts.X .|X |
|00004d10| 41 74 09 70 72 65 73 65 | 6e 74 2c 20 74 68 65 20 |At.prese|nt, the |
|00004d20| 46 72 65 65 20 53 6f 66 | 74 77 61 72 65 20 46 6f |Free Sof|tware Fo|
|00004d30| 75 6e 64 61 74 69 6f 6e | 27 73 09 42 6f 75 72 6e |undation|'s.Bourn|
|00004d40| 65 2d 41 67 61 69 6e 0a | 58 20 20 20 20 20 20 20 |e-Again.|X |
|00004d50| 73 68 65 6c 6c 20 69 73 | 20 74 72 65 61 74 65 64 |shell is| treated|
|00004d60| 20 65 78 61 63 74 6c 79 | 20 74 68 65 20 73 61 6d | exactly| the sam|
|00004d70| 65 20 61 73 20 74 68 65 | 20 42 6f 75 72 6e 65 20 |e as the| Bourne |
|00004d80| 53 68 65 6c 6c 2e 20 54 | 68 69 73 0a 58 20 20 20 |Shell. T|his.X |
|00004d90| 20 20 20 20 77 69 6c 6c | 20 63 68 61 6e 67 65 20 | will| change |
|00004da0| 77 68 65 6e 20 62 61 73 | 68 20 73 75 70 70 6f 72 |when bas|h suppor|
|00004db0| 74 73 20 61 72 72 61 79 | 73 2e 0a 2b 20 0a 58 20 |ts array|s..+ .X |
|00004dc0| 20 20 20 20 20 20 50 6c | 61 6e 20 39 20 53 68 65 | Pl|an 9 She|
|00004dd0| 6c 6c 20 41 72 67 75 6d | 65 6e 74 20 4c 69 73 74 |ll Argum|ent List|
|00004de0| 73 0a 58 20 20 0a 58 20 | 20 20 20 20 20 20 46 6f |s.X .X | Fo|
|00004df0| 72 20 74 68 65 20 50 6c | 61 6e 20 39 20 73 68 65 |r the Pl|an 9 she|
|00004e00| 6c 6c 2c 20 69 66 20 74 | 68 65 20 61 73 73 6f 63 |ll, if t|he assoc|
|00004e10| 69 61 74 65 64 20 76 61 | 72 69 61 62 6c 65 20 6e |iated va|riable n|
|00004e20| 61 6d 65 20 69 73 20 6e | 6f 74 0a 21 20 20 20 20 |ame is n|ot.! |
|00004e30| 20 20 60 60 2a 27 27 20 | 74 68 65 6e 09 69 74 20 | ``*'' |then.it |
|00004e40| 69 73 20 63 6f 6e 73 69 | 64 65 72 65 64 20 74 6f |is consi|dered to|
|00004e50| 20 62 65 20 61 20 77 6f | 72 64 2d 6c 69 73 74 20 | be a wo|rd-list |
|00004e60| 61 6e 64 20 73 65 74 20 | 75 73 69 6e 67 0a 21 20 |and set |using.! |
|00004e70| 0a 21 20 0a 21 20 0a 21 | 20 50 61 67 65 20 37 0a |.! .! .!| Page 7.|
|00004e80| 21 20 0a 21 20 0a 21 20 | 0a 21 20 0a 21 20 0a 21 |! .! .! |.! .! .!|
|00004e90| 20 0a 21 20 50 41 52 53 | 45 41 52 47 53 28 31 29 | .! PARS|EARGS(1)|
|00004ea0| 09 09 09 09 09 20 20 20 | 20 20 50 41 52 53 45 41 |..... | PARSEA|
|00004eb0| 52 47 53 28 31 29 0a 21 | 20 0a 21 20 0a 21 20 0a |RGS(1).!| .! .! .|
|00004ec0| 58 20 20 20 20 20 20 20 | 74 68 65 20 66 6f 6c 6c |X |the foll|
|00004ed0| 6f 77 69 6e 67 20 73 79 | 6e 74 61 78 3a 0a 58 20 |owing sy|ntax:.X |
|00004ee0| 20 09 20 20 6e 61 6d 65 | 3d 28 20 27 61 72 67 31 | . name|=( 'arg1|
|00004ef0| 27 09 20 27 61 72 67 32 | 27 09 20 2e 2e 2e 20 29 |'. 'arg2|'. ... )|
|00004f00| 0a 58 20 20 20 20 20 20 | 20 41 77 6b 20 41 72 67 |.X | Awk Arg|
|00004f10| 75 6d 65 6e 74 20 4c 69 | 73 74 73 0a 58 20 20 20 |ument Li|sts.X |
|00004f20| 20 20 20 20 46 6f 72 20 | 61 77 6b 2c 20 69 66 20 | For |awk, if |
|00004f30| 74 68 65 20 2d 41 09 6f | 70 74 69 6f 6e 20 69 73 |the -A.o|ption is|
|00004f40| 20 6e 6f 74 20 67 69 76 | 65 6e 2c 20 74 68 65 6e | not giv|en, then|
|00004f50| 20 74 68 65 20 6f 75 74 | 70 75 74 20 66 6f 72 0a | the out|put for.|
|00004f60| 58 20 20 20 20 20 20 20 | 74 68 65 73 20 76 61 72 |X |thes var|
|00004f70| 69 61 62 6c 65 2d 6c 69 | 73 74 09 77 69 6c 6c 20 |iable-li|st.will |
|00004f80| 62 65 09 61 20 6c 69 6e | 65 20 77 69 74 68 20 74 |be.a lin|e with t|
|00004f90| 68 65 09 76 61 72 69 61 | 62 6c 65 20 6e 61 6d 65 |he.varia|ble name|
|00004fa0| 2c 0a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |,.******|********|
|00004fb0| 2a 0a 2a 2a 2a 20 34 34 | 32 2c 34 34 38 20 2a 2a |*.*** 44|2,448 **|
|00004fc0| 2a 2a 0a 58 20 20 20 20 | 20 20 20 49 66 09 74 68 |**.X | If.th|
|00004fd0| 65 20 2d 41 20 6f 70 74 | 69 6f 6e 20 69 73 20 67 |e -A opt|ion is g|
|00004fe0| 69 76 65 6e 2c 09 74 68 | 65 6e 20 74 68 65 20 61 |iven,.th|en the a|
|00004ff0| 73 73 6f 63 69 61 74 65 | 64 20 76 61 72 69 61 62 |ssociate|d variab|
|00005000| 6c 65 20 69 73 0a 58 20 | 20 20 20 20 20 20 63 6f |le is.X | co|
|00005010| 6e 73 69 64 65 72 65 64 | 09 74 68 65 20 72 6f 6f |nsidered|.the roo|
|00005020| 74 20 6e 61 6d 65 20 6f | 66 20 61 6e 20 61 72 72 |t name o|f an arr|
|00005030| 61 79 2e 20 54 68 65 20 | 6f 75 70 75 74 20 66 6f |ay. The |ouput fo|
|00005040| 72 20 74 68 65 0a 58 20 | 20 20 20 20 20 20 61 72 |r the.X | ar|
|00005050| 72 61 79 20 77 69 6c 6c | 09 63 6f 6e 73 69 73 74 |ray will|.consist|
|00005060| 09 6f 66 20 74 77 6f 20 | 6c 69 6e 65 73 20 66 6f |.of two |lines fo|
|00005070| 72 20 65 61 63 68 20 69 | 74 65 6d 20 69 6e 20 74 |r each i|tem in t|
|00005080| 68 65 20 6c 69 73 74 0a | 21 20 20 20 20 20 20 28 |he list.|! (|
|00005090| 61 73 20 69 6e 20 74 68 | 65 09 66 6f 6c 6c 6f 77 |as in th|e.follow|
|000050a0| 69 6e 67 20 65 78 70 61 | 6d 70 6c 65 29 3a 0a 58 |ing expa|mple):.X|
|000050b0| 20 20 09 20 20 6e 61 6d | 65 31 0a 58 20 20 09 20 | . nam|e1.X . |
|000050c0| 20 61 72 67 31 0a 58 20 | 20 0a 2d 2d 2d 20 34 38 | arg1.X | .--- 48|
|000050d0| 30 2c 34 38 36 20 2d 2d | 2d 2d 0a 58 20 20 20 20 |0,486 --|--.X |
|000050e0| 20 20 20 49 66 09 74 68 | 65 20 2d 41 20 6f 70 74 | If.th|e -A opt|
|000050f0| 69 6f 6e 20 69 73 20 67 | 69 76 65 6e 2c 09 74 68 |ion is g|iven,.th|
|00005100| 65 6e 20 74 68 65 20 61 | 73 73 6f 63 69 61 74 65 |en the a|ssociate|
|00005110| 64 20 76 61 72 69 61 62 | 6c 65 20 69 73 0a 58 20 |d variab|le is.X |
|00005120| 20 20 20 20 20 20 63 6f | 6e 73 69 64 65 72 65 64 | co|nsidered|
|00005130| 09 74 68 65 20 72 6f 6f | 74 20 6e 61 6d 65 20 6f |.the roo|t name o|
|00005140| 66 20 61 6e 20 61 72 72 | 61 79 2e 20 54 68 65 20 |f an arr|ay. The |
|00005150| 6f 75 70 75 74 20 66 6f | 72 20 74 68 65 0a 58 20 |ouput fo|r the.X |
|00005160| 20 20 20 20 20 20 61 72 | 72 61 79 20 77 69 6c 6c | ar|ray will|
|00005170| 09 63 6f 6e 73 69 73 74 | 09 6f 66 20 74 77 6f 20 |.consist|.of two |
|00005180| 6c 69 6e 65 73 20 66 6f | 72 20 65 61 63 68 20 69 |lines fo|r each i|
|00005190| 74 65 6d 20 69 6e 20 74 | 68 65 20 6c 69 73 74 0a |tem in t|he list.|
|000051a0| 21 20 20 20 20 20 20 28 | 61 73 20 69 6e 20 74 68 |! (|as in th|
|000051b0| 65 09 66 6f 6c 6c 6f 77 | 69 6e 67 20 65 78 61 6d |e.follow|ing exam|
|000051c0| 70 6c 65 29 3a 0a 58 20 | 20 09 20 20 6e 61 6d 65 |ple):.X | . name|
|000051d0| 31 0a 58 20 20 09 20 20 | 61 72 67 31 0a 58 20 20 |1.X . |arg1.X |
|000051e0| 0a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |.*******|********|
|000051f0| 0a 2a 2a 2a 20 34 35 32 | 2c 34 37 37 20 2a 2a 2a |.*** 452|,477 ***|
|00005200| 2a 0a 58 20 20 20 20 20 | 20 20 61 6e 64 20 74 68 |*.X | and th|
|00005210| 65 20 76 61 72 69 61 62 | 6c 65 20 60 60 6e 61 6d |e variab|le ``nam|
|00005220| 65 5f 63 6f 75 6e 74 27 | 27 20 77 69 6c 6c 20 68 |e_count'|' will h|
|00005230| 61 76 65 20 61 6e 20 6f | 75 74 70 75 74 20 6c 69 |ave an o|utput li|
|00005240| 6e 65 0a 58 20 20 20 20 | 20 20 20 73 68 6f 77 69 |ne.X | showi|
|00005250| 6e 67 20 74 68 65 20 6e | 75 6d 62 65 72 09 6f 66 |ng the n|umber.of|
|00005260| 20 69 74 65 6d 73 20 69 | 6e 20 74 68 65 09 61 72 | items i|n the.ar|
|00005270| 72 61 79 2e 0a 58 20 20 | 0a 2d 20 0a 2d 20 0a 2d |ray..X |.- .- .-|
|00005280| 20 0a 2d 20 0a 2d 20 50 | 61 67 65 20 37 0a 2d 20 | .- .- P|age 7.- |
|00005290| 0a 2d 20 0a 2d 20 0a 2d | 20 0a 2d 20 0a 2d 20 0a |.- .- .-| .- .- .|
|000052a0| 2d 20 50 41 52 53 45 41 | 52 47 53 28 31 29 09 09 |- PARSEA|RGS(1)..|
|000052b0| 09 09 09 20 20 20 20 20 | 50 41 52 53 45 41 52 47 |... |PARSEARG|
|000052c0| 53 28 31 29 0a 2d 20 0a | 2d 20 0a 2d 20 0a 58 20 |S(1).- .|- .- .X |
|000052d0| 20 20 20 20 20 20 50 65 | 72 6c 20 41 72 67 75 6d | Pe|rl Argum|
|000052e0| 65 6e 74 20 4c 69 73 74 | 73 0a 58 20 20 0a 58 20 |ent List|s.X .X |
|000052f0| 20 20 20 20 20 20 46 6f | 72 20 70 65 72 6c 2c 20 | Fo|r perl, |
|00005300| 65 61 63 68 20 61 72 67 | 75 6d 65 6e 74 20 6c 69 |each arg|ument li|
|00005310| 73 74 20 69 73 20 63 6f | 6e 73 69 64 65 72 65 64 |st is co|nsidered|
|00005320| 09 61 6e 20 61 72 72 61 | 79 20 61 6e 64 20 69 73 |.an arra|y and is|
|00005330| 0a 58 20 20 20 20 20 20 | 20 73 65 74 20 75 73 69 |.X | set usi|
|00005340| 6e 67 20 74 68 65 20 66 | 6f 6c 6c 6f 77 69 6e 67 |ng the f|ollowing|
|00005350| 20 73 79 6e 74 61 78 3a | 0a 21 20 09 20 20 40 6e | syntax:|.! . @n|
|00005360| 61 6d 65 3d 28 20 61 72 | 67 31 20 2c 20 61 72 67 |ame=( ar|g1 , arg|
|00005370| 32 20 2c 09 20 2e 2e 2e | 20 29 3b 0a 58 20 20 20 |2 ,. ...| );.X |
|00005380| 20 20 20 20 41 20 46 69 | 6e 61 6c 20 4e 6f 74 65 | A Fi|nal Note|
|00005390| 20 6f 6e 20 41 72 67 75 | 6d 65 6e 74 20 4c 69 73 | on Argu|ment Lis|
|000053a0| 74 73 0a 58 20 20 0a 58 | 20 20 20 20 20 20 20 54 |ts.X .X| T|
|000053b0| 68 65 20 77 6f 72 64 2d | 6c 69 73 74 73 20 75 73 |he word-|lists us|
|000053c0| 65 64 20 62 79 20 74 68 | 65 09 43 20 73 68 65 6c |ed by th|e.C shel|
|000053d0| 6c 2c 20 74 68 65 20 61 | 72 72 61 79 73 20 75 73 |l, the a|rrays us|
|000053e0| 65 64 20 62 79 20 74 68 | 65 0a 2d 2d 2d 20 34 39 |ed by th|e.--- 49|
|000053f0| 30 2c 35 30 31 20 2d 2d | 2d 2d 0a 58 20 20 20 20 |0,501 --|--.X |
|00005400| 20 20 20 61 6e 64 20 74 | 68 65 20 76 61 72 69 61 | and t|he varia|
|00005410| 62 6c 65 20 60 60 6e 61 | 6d 65 5f 63 6f 75 6e 74 |ble ``na|me_count|
|00005420| 27 27 20 77 69 6c 6c 20 | 68 61 76 65 20 61 6e 20 |'' will |have an |
|00005430| 6f 75 74 70 75 74 20 6c | 69 6e 65 0a 58 20 20 20 |output l|ine.X |
|00005440| 20 20 20 20 73 68 6f 77 | 69 6e 67 20 74 68 65 20 | show|ing the |
|00005450| 6e 75 6d 62 65 72 09 6f | 66 20 69 74 65 6d 73 20 |number.o|f items |
|00005460| 69 6e 20 74 68 65 09 61 | 72 72 61 79 2e 0a 58 20 |in the.a|rray..X |
|00005470| 20 0a 58 20 20 20 20 20 | 20 20 50 65 72 6c 20 41 | .X | Perl A|
|00005480| 72 67 75 6d 65 6e 74 20 | 4c 69 73 74 73 0a 58 20 |rgument |Lists.X |
|00005490| 20 0a 58 20 20 20 20 20 | 20 20 46 6f 72 20 70 65 | .X | For pe|
|000054a0| 72 6c 2c 20 65 61 63 68 | 20 61 72 67 75 6d 65 6e |rl, each| argumen|
|000054b0| 74 20 6c 69 73 74 20 69 | 73 20 63 6f 6e 73 69 64 |t list i|s consid|
|000054c0| 65 72 65 64 09 61 6e 20 | 61 72 72 61 79 20 61 6e |ered.an |array an|
|000054d0| 64 20 69 73 0a 58 20 20 | 20 20 20 20 20 73 65 74 |d is.X | set|
|000054e0| 20 75 73 69 6e 67 20 74 | 68 65 20 66 6f 6c 6c 6f | using t|he follo|
|000054f0| 77 69 6e 67 20 73 79 6e | 74 61 78 3a 0a 21 20 09 |wing syn|tax:.! .|
|00005500| 20 20 40 6e 61 6d 65 3d | 28 20 27 61 72 67 31 27 | @name=|( 'arg1'|
|00005510| 20 2c 20 27 61 72 67 32 | 27 20 2c 20 20 2e 2e 2e | , 'arg2|' , ...|
|00005520| 20 29 3b 0a 21 20 0a 58 | 20 20 20 20 20 20 20 41 | );.! .X| A|
|00005530| 20 46 69 6e 61 6c 20 4e | 6f 74 65 20 6f 6e 20 41 | Final N|ote on A|
|00005540| 72 67 75 6d 65 6e 74 20 | 4c 69 73 74 73 0a 58 20 |rgument |Lists.X |
|00005550| 20 0a 58 20 20 20 20 20 | 20 20 54 68 65 20 77 6f | .X | The wo|
|00005560| 72 64 2d 6c 69 73 74 73 | 20 75 73 65 64 20 62 79 |rd-lists| used by|
|00005570| 20 74 68 65 09 43 20 73 | 68 65 6c 6c 2c 20 74 68 | the.C s|hell, th|
|00005580| 65 20 61 72 72 61 79 73 | 20 75 73 65 64 20 62 79 |e arrays| used by|
|00005590| 20 74 68 65 0a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a | the.***|********|
|000055a0| 2a 2a 2a 2a 0a 2a 2a 2a | 20 34 39 35 2c 35 30 30 |****.***| 495,500|
|000055b0| 20 2a 2a 2a 2a 0a 2d 2d | 2d 20 35 31 39 2c 35 33 | ****.--|- 519,53|
|000055c0| 38 20 2d 2d 2d 2d 0a 58 | 20 20 20 20 20 20 20 41 |8 ----.X| A|
|000055d0| 52 47 4c 49 53 54 73 20 | 61 6e 64 20 41 52 47 56 |RGLISTs |and ARGV|
|000055e0| 45 43 73 20 73 65 74 20 | 69 6e 20 60 60 43 4d 44 |ECs set |in ``CMD|
|000055f0| 5f 41 52 47 53 27 27 20 | 77 69 6c 6c 20 62 65 20 |_ARGS'' |will be |
|00005600| 61 70 70 65 6e 64 65 64 | 0a 58 20 20 20 20 20 20 |appended|.X |
|00005610| 20 66 72 6f 6d 20 74 68 | 65 20 63 6f 6d 6d 61 6e | from th|e comman|
|00005620| 64 2d 6c 69 6e 65 20 69 | 66 20 74 68 65 79 20 61 |d-line i|f they a|
|00005630| 72 65 20 73 65 6c 65 63 | 74 65 64 29 2e 0a 58 20 |re selec|ted)..X |
|00005640| 20 0a 2b 20 0a 2b 20 0a | 2b 20 0a 2b 20 50 61 67 | .+ .+ .|+ .+ Pag|
|00005650| 65 20 38 0a 2b 20 0a 2b | 20 0a 2b 20 0a 2b 20 0a |e 8.+ .+| .+ .+ .|
|00005660| 2b 20 0a 2b 20 0a 2b 20 | 50 41 52 53 45 41 52 47 |+ .+ .+ |PARSEARG|
|00005670| 53 28 31 29 09 09 09 09 | 09 20 20 20 20 20 50 41 |S(1)....|. PA|
|00005680| 52 53 45 41 52 47 53 28 | 31 29 0a 2b 20 0a 2b 20 |RSEARGS(|1).+ .+ |
|00005690| 0a 2b 20 0a 58 20 20 20 | 20 20 20 20 49 74 09 69 |.+ .X | It.i|
|000056a0| 73 20 69 6d 70 6f 72 74 | 61 6e 74 20 74 6f 09 6e |s import|ant to.n|
|000056b0| 6f 74 65 20 74 68 61 74 | 20 74 68 65 20 63 6f 6e |ote that| the con|
|000056c0| 74 65 6e 74 73 20 6f 66 | 20 74 68 65 0a 58 20 20 |tents of| the.X |
|000056d0| 20 20 20 20 20 60 60 43 | 4d 44 5f 41 52 47 53 27 | ``C|MD_ARGS'|
|000056e0| 27 20 65 6e 76 69 72 6f | 6e 6d 65 6e 74 20 76 61 |' enviro|nment va|
|000056f0| 72 69 61 62 6c 65 20 61 | 72 65 20 4e 4f 54 20 65 |riable a|re NOT e|
|00005700| 78 70 61 6e 64 65 64 09 | 62 79 20 74 68 65 0a 58 |xpanded.|by the.X|
|00005710| 20 20 20 20 20 20 20 73 | 68 65 6c 6c 20 61 6e 64 | s|hell and|
|00005720| 20 68 65 6e 63 65 20 61 | 6e 79 20 73 70 65 63 69 | hence a|ny speci|
|00005730| 61 6c 20 63 68 61 72 61 | 63 74 65 72 73 20 28 73 |al chara|cters (s|
|00005740| 75 63 68 20 61 73 20 71 | 75 6f 74 65 73 20 6f 72 |uch as q|uotes or|
|00005750| 0a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |.*******|********|
|00005760| 0a 2a 2a 2a 20 35 31 39 | 2c 35 33 38 20 2a 2a 2a |.*** 519|,538 ***|
|00005770| 2a 0a 58 20 20 20 20 20 | 20 20 6f 66 09 70 61 72 |*.X | of.par|
|00005780| 73 65 63 6e 74 6c 28 33 | 29 2e 20 20 54 68 65 20 |secntl(3|). The |
|00005790| 75 73 65 72 09 6d 61 79 | 20 73 65 74 09 68 69 73 |user.may| set.his|
|000057a0| 20 28 6f 72 09 68 65 72 | 29 20 6f 77 6e 20 64 65 | (or.her|) own de|
|000057b0| 73 69 72 65 64 0a 58 20 | 20 20 20 20 20 20 70 61 |sired.X | pa|
|000057c0| 72 73 69 6e 67 20 62 65 | 68 61 76 69 6f 72 20 74 |rsing be|havior t|
|000057d0| 68 72 6f 75 67 68 20 74 | 68 65 20 75 73 65 20 6f |hrough t|he use o|
|000057e0| 66 20 74 68 65 20 60 60 | 50 41 52 53 45 43 4e 54 |f the ``|PARSECNT|
|000057f0| 4c 27 27 0a 58 20 20 20 | 20 20 20 20 65 6e 76 69 |L''.X | envi|
|00005800| 72 6f 6e 6d 65 6e 74 20 | 76 61 72 69 61 62 6c 65 |ronment |variable|
|00005810| 2e 20 20 42 79 20 69 6e | 64 69 63 61 74 69 6e 67 |. By in|dicating|
|00005820| 20 61 6e 79 20 6e 75 6d | 62 65 72 20 6f 66 09 66 | any num|ber of.f|
|00005830| 6c 61 67 73 0a 2d 20 0a | 2d 20 0a 2d 20 0a 2d 20 |lags.- .|- .- .- |
|00005840| 50 61 67 65 20 38 0a 2d | 20 0a 2d 20 0a 2d 20 0a |Page 8.-| .- .- .|
|00005850| 2d 20 0a 2d 20 0a 2d 20 | 0a 2d 20 50 41 52 53 45 |- .- .- |.- PARSE|
|00005860| 41 52 47 53 28 31 29 09 | 09 09 09 09 20 20 20 20 |ARGS(1).|.... |
|00005870| 20 50 41 52 53 45 41 52 | 47 53 28 31 29 0a 2d 20 | PARSEAR|GS(1).- |
|00005880| 0a 2d 20 0a 2d 20 0a 58 | 20 20 20 20 20 20 20 28 |.- .- .X| (|
|00005890| 70 6f 73 73 69 62 6c 79 | 20 6e 65 67 61 74 65 64 |possibly| negated|
|000058a0| 29 09 74 68 65 20 75 73 | 65 72 20 77 69 6c 6c 20 |).the us|er will |
|000058b0| 64 69 72 65 63 74 6c 79 | 20 6d 6f 64 69 66 79 20 |directly| modify |
|000058c0| 74 68 65 0a 58 20 20 20 | 20 20 20 20 62 65 68 61 |the.X | beha|
|000058d0| 76 69 6f 72 20 6f 66 20 | 74 68 65 20 70 61 72 73 |vior of |the pars|
|000058e0| 65 61 72 67 73 20 6c 69 | 62 72 61 72 79 2e 09 46 |eargs li|brary..F|
|000058f0| 6c 61 67 73 20 6d 61 79 | 20 62 65 20 63 6f 6d 62 |lags may| be comb|
|00005900| 69 6e 65 64 20 62 79 0a | 58 20 20 20 20 20 20 20 |ined by.|X |
|00005910| 70 6c 61 63 69 6e 67 20 | 61 20 60 2b 27 20 6f 72 |placing |a `+' or|
|00005920| 20 60 7c 27 20 63 68 61 | 72 61 63 74 65 72 20 69 | `|' cha|racter i|
|00005930| 6e 20 62 65 74 77 65 65 | 6e 20 66 6c 61 67 73 2e |n betwee|n flags.|
|00005940| 20 41 09 73 77 69 74 63 | 68 20 69 73 0a 2d 2d 2d | A.switc|h is.---|
|00005950| 20 35 35 37 2c 35 36 32 | 20 2d 2d 2d 2d 0a 2a 2a | 557,562| ----.**|
|00005960| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 0a 2a 2a |********|*****.**|
|00005970| 2a 20 35 35 31 2c 35 37 | 30 20 2a 2a 2a 2a 0a 58 |* 551,57|0 ****.X|
|00005980| 20 20 20 20 20 20 20 49 | 67 6e 6f 72 65 0a 58 20 | I|gnore.X |
|00005990| 20 09 20 20 49 67 6e 6f | 72 65 20 61 6e 79 20 75 | . Igno|re any u|
|000059a0| 6e 72 65 63 6f 67 6e 69 | 7a 65 64 20 6f 72 20 69 |nrecogni|zed or i|
|000059b0| 6d 70 72 6f 70 65 72 6c | 79 09 73 70 65 63 69 66 |mproperl|y.specif|
|000059c0| 69 65 64 0a 58 20 20 09 | 20 20 63 6f 6d 6d 61 6e |ied.X .| comman|
|000059d0| 64 2d 6c 69 6e 65 20 61 | 72 67 75 6d 65 6e 74 73 |d-line a|rguments|
|000059e0| 20 61 6e 64 20 63 6f 6e | 74 69 6e 75 65 20 65 78 | and con|tinue ex|
|000059f0| 65 63 75 74 69 6f 6e 09 | 6f 66 20 74 68 65 0a 21 |ecution.|of the.!|
|00005a00| 20 09 20 20 70 72 6f 67 | 72 61 6d 2e 20 4e 6f 72 | . prog|ram. Nor|
|00005a10| 6d 61 6c 6c 79 2c 20 69 | 66 09 61 6e 20 61 72 67 |mally, i|f.an arg|
|00005a20| 75 6d 65 6e 74 20 69 73 | 20 75 6e 6d 61 74 63 68 |ument is| unmatch|
|00005a30| 65 64 20 28 6f 72 20 69 | 73 0a 21 20 09 20 20 69 |ed (or i|s.! . i|
|00005a40| 6d 70 72 6f 70 65 72 6c | 79 20 73 70 65 63 69 66 |mproperl|y specif|
|00005a50| 69 65 64 29 2c 20 61 20 | 75 73 61 67 65 20 6d 65 |ied), a |usage me|
|00005a60| 73 73 61 67 65 20 69 73 | 20 70 72 69 6e 74 65 64 |ssage is| printed|
|00005a70| 20 61 6e 64 0a 21 20 09 | 20 20 70 72 6f 67 72 61 | and.! .| progra|
|00005a80| 6d 20 65 78 65 63 75 74 | 69 6f 6e 20 69 73 20 74 |m execut|ion is t|
|00005a90| 65 72 6d 69 6e 61 74 65 | 64 2e 0a 58 20 20 0a 58 |erminate|d..X .X|
|00005aa0| 20 20 20 20 20 20 20 4f | 70 74 73 4f 6e 6c 79 0a | O|ptsOnly.|
|00005ab0| 58 20 20 09 20 20 55 6e | 64 65 72 09 55 4e 49 58 |X . Un|der.UNIX|
|00005ac0| 2c 20 73 65 74 74 69 6e | 67 20 74 68 69 73 20 66 |, settin|g this f|
|00005ad0| 6c 61 67 09 77 69 6c 6c | 20 64 69 73 61 62 6c 65 |lag.will| disable|
|00005ae0| 20 74 68 65 20 70 61 72 | 73 69 6e 67 0a 58 20 20 | the par|sing.X |
|00005af0| 09 20 20 6f 66 20 6c 6f | 6e 67 2d 6f 70 74 69 6f |. of lo|ng-optio|
|00005b00| 6e 20 73 79 6e 74 61 78 | 2e 20 54 68 69 73 20 77 |n syntax|. This w|
|00005b10| 69 6c 6c 20 63 61 75 73 | 65 20 61 6c 6c 20 61 72 |ill caus|e all ar|
|00005b20| 67 75 6d 65 6e 74 73 0a | 21 20 09 20 20 73 74 61 |guments.|! . sta|
|00005b30| 72 74 69 6e 67 20 77 69 | 74 68 09 27 2b 27 20 74 |rting wi|th.'+' t|
|00005b40| 6f 20 61 6c 77 61 79 73 | 20 62 65 20 74 72 65 61 |o always| be trea|
|00005b50| 74 65 64 20 61 73 20 61 | 20 70 6f 73 69 74 69 6f |ted as a| positio|
|00005b60| 6e 61 6c 0a 58 20 20 09 | 20 20 70 61 72 61 6d 65 |nal.X .| parame|
|00005b70| 74 65 72 20 28 69 6e 73 | 74 65 61 64 20 6f 66 09 |ter (ins|tead of.|
|00005b80| 61 20 6c 6f 6e 67 2d 6f | 70 74 69 6f 6e 29 2e 0a |a long-o|ption)..|
|00005b90| 58 20 20 0a 58 20 20 20 | 20 20 20 20 4b 77 64 73 |X .X | Kwds|
|00005ba0| 4f 6e 6c 79 0a 58 20 20 | 09 20 20 55 6e 64 65 72 |Only.X |. Under|
|00005bb0| 09 55 4e 49 58 2c 20 73 | 65 74 74 69 6e 67 20 74 |.UNIX, s|etting t|
|00005bc0| 68 69 73 20 66 6c 61 67 | 09 64 69 73 61 62 6c 65 |his flag|.disable|
|00005bd0| 73 20 74 68 65 20 70 61 | 72 73 69 6e 67 20 6f 66 |s the pa|rsing of|
|00005be0| 0a 58 20 20 09 20 20 73 | 69 6e 67 6c 65 2d 63 68 |.X . s|ingle-ch|
|00005bf0| 61 72 61 63 74 65 72 20 | 6f 70 74 69 6f 6e 73 2e |aracter |options.|
|00005c00| 20 20 54 68 69 73 20 77 | 69 6c 6c 20 63 61 75 73 | This w|ill caus|
|00005c10| 65 20 61 6c 6c 0a 21 20 | 09 20 20 61 72 67 75 6d |e all.! |. argum|
|00005c20| 65 6e 74 73 20 73 74 61 | 72 74 69 6e 67 20 77 69 |ents sta|rting wi|
|00005c30| 74 68 20 27 2d 27 20 74 | 6f 20 61 6c 77 61 79 73 |th '-' t|o always|
|00005c40| 09 62 65 20 74 72 65 61 | 74 65 64 20 61 73 20 61 |.be trea|ted as a|
|00005c50| 0a 58 20 20 09 20 20 70 | 6f 73 69 74 69 6f 6e 61 |.X . p|ositiona|
|00005c60| 6c 20 70 61 72 61 6d 65 | 74 65 72 20 28 69 6e 73 |l parame|ter (ins|
|00005c70| 74 65 61 64 09 6f 66 20 | 61 6e 20 6f 70 74 69 6f |tead.of |an optio|
|00005c80| 6e 29 2e 0a 58 20 20 0a | 58 20 20 20 20 20 20 20 |n)..X .|X |
|00005c90| 4c 6f 70 74 73 4f 6e 6c | 79 0a 2d 2d 2d 20 35 37 |LoptsOnl|y.--- 57|
|00005ca0| 35 2c 36 30 38 20 2d 2d | 2d 2d 0a 58 20 20 20 20 |5,608 --|--.X |
|00005cb0| 20 20 20 49 67 6e 6f 72 | 65 0a 58 20 20 09 20 20 | Ignor|e.X . |
|00005cc0| 49 67 6e 6f 72 65 20 61 | 6e 79 20 75 6e 72 65 63 |Ignore a|ny unrec|
|00005cd0| 6f 67 6e 69 7a 65 64 20 | 6f 72 20 69 6d 70 72 6f |ognized |or impro|
|00005ce0| 70 65 72 6c 79 09 73 70 | 65 63 69 66 69 65 64 0a |perly.sp|ecified.|
|00005cf0| 58 20 20 09 20 20 63 6f | 6d 6d 61 6e 64 2d 6c 69 |X . co|mmand-li|
|00005d00| 6e 65 20 61 72 67 75 6d | 65 6e 74 73 20 61 6e 64 |ne argum|ents and|
|00005d10| 20 63 6f 6e 74 69 6e 75 | 65 20 65 78 65 63 75 74 | continu|e execut|
|00005d20| 69 6f 6e 09 6f 66 20 74 | 68 65 0a 21 20 09 20 20 |ion.of t|he.! . |
|00005d30| 70 72 6f 67 72 61 6d 2e | 20 4e 6f 72 6d 61 6c 6c |program.| Normall|
|00005d40| 79 2c 20 69 66 09 61 20 | 72 65 71 75 69 72 65 64 |y, if.a |required|
|00005d50| 20 61 72 67 75 6d 65 6e | 74 20 69 73 20 75 6e 6d | argumen|t is unm|
|00005d60| 61 74 63 68 65 64 0a 21 | 20 09 20 20 28 6f 72 20 |atched.!| . (or |
|00005d70| 61 6e 20 61 72 67 75 6d | 65 6e 74 20 69 73 20 69 |an argum|ent is i|
|00005d80| 6d 70 72 6f 70 65 72 6c | 79 09 73 70 65 63 69 66 |mproperl|y.specif|
|00005d90| 69 65 64 29 2c 20 61 20 | 75 73 61 67 65 0a 21 20 |ied), a |usage.! |
|00005da0| 09 20 20 6d 65 73 73 61 | 67 65 20 69 73 20 70 72 |. messa|ge is pr|
|00005db0| 69 6e 74 65 64 20 70 72 | 6f 67 72 61 6d 20 65 78 |inted pr|ogram ex|
|00005dc0| 65 63 75 74 69 6f 6e 20 | 69 73 20 74 65 72 6d 69 |ecution |is termi|
|00005dd0| 6e 61 74 65 64 2e 0a 58 | 20 20 0a 58 20 20 20 20 |nated..X| .X |
|00005de0| 20 20 20 4f 70 74 73 4f | 6e 6c 79 0a 58 20 20 09 | OptsO|nly.X .|
|00005df0| 20 20 55 6e 64 65 72 09 | 55 4e 49 58 2c 20 73 65 | Under.|UNIX, se|
|00005e00| 74 74 69 6e 67 20 74 68 | 69 73 20 66 6c 61 67 09 |tting th|is flag.|
|00005e10| 77 69 6c 6c 20 64 69 73 | 61 62 6c 65 20 74 68 65 |will dis|able the|
|00005e20| 20 70 61 72 73 69 6e 67 | 0a 58 20 20 09 20 20 6f | parsing|.X . o|
|00005e30| 66 20 6c 6f 6e 67 2d 6f | 70 74 69 6f 6e 20 73 79 |f long-o|ption sy|
|00005e40| 6e 74 61 78 2e 20 54 68 | 69 73 20 77 69 6c 6c 20 |ntax. Th|is will |
|00005e50| 63 61 75 73 65 20 61 6c | 6c 20 61 72 67 75 6d 65 |cause al|l argume|
|00005e60| 6e 74 73 0a 21 20 09 20 | 20 73 74 61 72 74 69 6e |nts.! . | startin|
|00005e70| 67 20 77 69 74 68 09 60 | 2b 27 20 74 6f 20 61 6c |g with.`|+' to al|
|00005e80| 77 61 79 73 20 62 65 20 | 74 72 65 61 74 65 64 20 |ways be |treated |
|00005e90| 61 73 20 61 20 70 6f 73 | 69 74 69 6f 6e 61 6c 0a |as a pos|itional.|
|00005ea0| 58 20 20 09 20 20 70 61 | 72 61 6d 65 74 65 72 20 |X . pa|rameter |
|00005eb0| 28 69 6e 73 74 65 61 64 | 20 6f 66 09 61 20 6c 6f |(instead| of.a lo|
|00005ec0| 6e 67 2d 6f 70 74 69 6f | 6e 29 2e 0a 58 20 20 0a |ng-optio|n)..X .|
|00005ed0| 2b 20 0a 2b 20 0a 2b 20 | 0a 2b 20 50 61 67 65 20 |+ .+ .+ |.+ Page |
|00005ee0| 39 0a 2b 20 0a 2b 20 0a | 2b 20 0a 2b 20 0a 2b 20 |9.+ .+ .|+ .+ .+ |
|00005ef0| 0a 2b 20 0a 2b 20 50 41 | 52 53 45 41 52 47 53 28 |.+ .+ PA|RSEARGS(|
|00005f00| 31 29 09 09 09 09 09 20 | 20 20 20 20 50 41 52 53 |1)..... | PARS|
|00005f10| 45 41 52 47 53 28 31 29 | 0a 2b 20 0a 2b 20 0a 2b |EARGS(1)|.+ .+ .+|
|00005f20| 20 0a 58 20 20 20 20 20 | 20 20 4b 77 64 73 4f 6e | .X | KwdsOn|
|00005f30| 6c 79 0a 58 20 20 09 20 | 20 55 6e 64 65 72 09 55 |ly.X . | Under.U|
|00005f40| 4e 49 58 2c 20 73 65 74 | 74 69 6e 67 20 74 68 69 |NIX, set|ting thi|
|00005f50| 73 20 66 6c 61 67 09 64 | 69 73 61 62 6c 65 73 20 |s flag.d|isables |
|00005f60| 74 68 65 20 70 61 72 73 | 69 6e 67 20 6f 66 0a 58 |the pars|ing of.X|
|00005f70| 20 20 09 20 20 73 69 6e | 67 6c 65 2d 63 68 61 72 | . sin|gle-char|
|00005f80| 61 63 74 65 72 20 6f 70 | 74 69 6f 6e 73 2e 20 20 |acter op|tions. |
|00005f90| 54 68 69 73 20 77 69 6c | 6c 20 63 61 75 73 65 20 |This wil|l cause |
|00005fa0| 61 6c 6c 0a 21 20 09 20 | 20 61 72 67 75 6d 65 6e |all.! . | argumen|
|00005fb0| 74 73 20 73 74 61 72 74 | 69 6e 67 20 77 69 74 68 |ts start|ing with|
|00005fc0| 20 60 2d 27 20 74 6f 20 | 61 6c 77 61 79 73 09 62 | `-' to |always.b|
|00005fd0| 65 20 74 72 65 61 74 65 | 64 20 61 73 20 61 0a 58 |e treate|d as a.X|
|00005fe0| 20 20 09 20 20 70 6f 73 | 69 74 69 6f 6e 61 6c 20 | . pos|itional |
|00005ff0| 70 61 72 61 6d 65 74 65 | 72 20 28 69 6e 73 74 65 |paramete|r (inste|
|00006000| 61 64 09 6f 66 20 61 6e | 20 6f 70 74 69 6f 6e 29 |ad.of an| option)|
|00006010| 2e 0a 58 20 20 0a 58 20 | 20 20 20 20 20 20 4c 6f |..X .X | Lo|
|00006020| 70 74 73 4f 6e 6c 79 0a | 2a 2a 2a 2a 2a 2a 2a 2a |ptsOnly.|********|
|00006030| 2a 2a 2a 2a 2a 2a 2a 0a | 2a 2a 2a 20 35 38 35 2c |*******.|*** 585,|
|00006040| 36 30 39 20 2a 2a 2a 2a | 0a 58 20 20 09 20 20 6f |609 ****|.X . o|
|00006050| 6e 65 20 70 6f 73 69 74 | 69 6f 6e 61 6c 20 61 72 |ne posit|ional ar|
|00006060| 67 75 6d 65 6e 74 2e 0a | 58 20 20 0a 58 20 20 20 |gument..|X .X |
|00006070| 20 20 20 20 43 61 73 65 | 49 67 6e 6f 72 65 0a 58 | Case|Ignore.X|
|00006080| 20 20 0a 2d 20 0a 2d 20 | 0a 2d 20 50 61 67 65 20 | .- .- |.- Page |
|00006090| 39 0a 2d 20 0a 2d 20 0a | 2d 20 0a 2d 20 0a 2d 20 |9.- .- .|- .- .- |
|000060a0| 0a 2d 20 0a 2d 20 50 41 | 52 53 45 41 52 47 53 28 |.- .- PA|RSEARGS(|
|000060b0| 31 29 09 09 09 09 09 20 | 20 20 20 20 50 41 52 53 |1)..... | PARS|
|000060c0| 45 41 52 47 53 28 31 29 | 0a 2d 20 0a 2d 20 0a 2d |EARGS(1)|.- .- .-|
|000060d0| 20 0a 2d 20 09 20 20 53 | 65 74 74 69 6e 67 20 74 | .- . S|etting t|
|000060e0| 68 69 73 20 66 6c 61 67 | 20 63 61 75 73 65 73 20 |his flag| causes |
|000060f0| 63 68 61 72 61 63 74 65 | 72 2d 63 61 73 65 20 74 |characte|r-case t|
|00006100| 6f 20 62 65 09 69 67 6e | 6f 72 65 64 0a 2d 20 09 |o be.ign|ored.- .|
|00006110| 20 20 77 68 65 6e 20 61 | 74 74 65 6d 70 74 69 6e | when a|ttemptin|
|00006120| 67 20 74 6f 20 6d 61 74 | 63 68 20 73 69 6e 67 6c |g to mat|ch singl|
|00006130| 65 2d 63 68 61 72 61 63 | 74 65 72 20 61 72 67 75 |e-charac|ter argu|
|00006140| 6d 65 6e 74 0a 2d 20 09 | 20 20 6e 61 6d 65 73 09 |ment.- .| names.|
|00006150| 28 69 2e 65 2e 20 63 61 | 75 73 65 73 20 22 2d 69 |(i.e. ca|uses "-i|
|00006160| 22 20 61 6e 64 20 22 2d | 49 22 20 77 69 6c 6c 09 |" and "-|I" will.|
|00006170| 62 65 20 63 6f 6e 73 69 | 64 65 72 65 64 0a 2d 20 |be consi|dered.- |
|00006180| 09 20 20 65 71 75 69 76 | 61 6c 65 6e 74 29 2e 0a |. equiv|alent)..|
|00006190| 2d 20 0a 58 20 20 20 20 | 20 20 20 49 66 09 74 68 |- .X | If.th|
|000061a0| 65 20 65 6e 76 69 72 6f | 6e 6d 65 6e 74 09 76 61 |e enviro|nment.va|
|000061b0| 72 69 61 62 6c 65 20 60 | 60 50 41 52 53 45 43 4e |riable `|`PARSECN|
|000061c0| 54 4c 27 27 20 69 73 20 | 65 6d 70 74 79 09 6f 72 |TL'' is |empty.or|
|000061d0| 0a 58 20 20 20 20 20 20 | 20 75 6e 64 65 66 69 6e |.X | undefin|
|000061e0| 65 64 2c 09 74 68 65 6e | 20 74 68 65 20 70 61 72 |ed,.then| the par|
|000061f0| 73 69 6e 67 20 62 65 68 | 61 76 69 6f 72 20 73 65 |sing beh|avior se|
|00006200| 74 20 62 79 20 74 68 65 | 20 70 72 6f 67 72 61 6d |t by the| program|
|00006210| 6d 65 72 0a 58 20 20 20 | 20 20 20 20 69 73 09 75 |mer.X | is.u|
|00006220| 73 65 64 2e 20 20 49 66 | 20 74 68 65 20 70 72 6f |sed. If| the pro|
|00006230| 67 72 61 6d 6d 65 72 20 | 68 61 73 20 6e 6f 74 20 |grammer |has not |
|00006240| 65 78 70 6c 69 63 69 74 | 6c 79 20 75 73 65 64 0a |explicit|ly used.|
|00006250| 2d 2d 2d 20 36 32 33 2c | 36 33 33 20 2d 2d 2d 2d |--- 623,|633 ----|
|00006260| 0a 58 20 20 09 20 20 6f | 6e 65 20 70 6f 73 69 74 |.X . o|ne posit|
|00006270| 69 6f 6e 61 6c 20 61 72 | 67 75 6d 65 6e 74 2e 0a |ional ar|gument..|
|00006280| 58 20 20 0a 58 20 20 20 | 20 20 20 20 43 61 73 65 |X .X | Case|
|00006290| 49 67 6e 6f 72 65 0a 2b | 20 09 20 20 53 65 74 74 |Ignore.+| . Sett|
|000062a0| 69 6e 67 20 74 68 69 73 | 20 66 6c 61 67 20 77 69 |ing this| flag wi|
|000062b0| 6c 6c 20 63 61 75 73 65 | 20 63 68 61 72 61 63 74 |ll cause| charact|
|000062c0| 65 72 2d 63 61 73 65 20 | 74 6f 20 62 65 0a 2b 20 |er-case |to be.+ |
|000062d0| 09 20 20 69 67 6e 6f 72 | 65 64 20 77 68 65 6e 20 |. ignor|ed when |
|000062e0| 61 74 74 65 6d 70 74 69 | 6e 67 20 74 6f 20 6d 61 |attempti|ng to ma|
|000062f0| 74 63 68 20 73 69 6e 67 | 6c 65 2d 63 68 61 72 61 |tch sing|le-chara|
|00006300| 63 74 65 72 0a 2b 20 09 | 20 20 61 72 67 75 6d 65 |cter.+ .| argume|
|00006310| 6e 74 20 6e 61 6d 65 73 | 20 28 69 2e 65 2e 20 63 |nt names| (i.e. c|
|00006320| 61 75 73 65 73 20 22 2d | 69 22 20 61 6e 64 20 22 |auses "-|i" and "|
|00006330| 2d 49 22 20 74 6f 20 62 | 65 0a 2b 20 09 20 20 63 |-I" to b|e.+ . c|
|00006340| 6f 6e 73 69 64 65 72 65 | 64 20 65 71 75 69 76 61 |onsidere|d equiva|
|00006350| 6c 65 6e 74 29 2e 0a 58 | 20 20 0a 58 20 20 20 20 |lent)..X| .X |
|00006360| 20 20 20 49 66 09 74 68 | 65 20 65 6e 76 69 72 6f | If.th|e enviro|
|00006370| 6e 6d 65 6e 74 09 76 61 | 72 69 61 62 6c 65 20 60 |nment.va|riable `|
|00006380| 60 50 41 52 53 45 43 4e | 54 4c 27 27 20 69 73 20 |`PARSECN|TL'' is |
|00006390| 65 6d 70 74 79 09 6f 72 | 0a 58 20 20 20 20 20 20 |empty.or|.X |
|000063a0| 20 75 6e 64 65 66 69 6e | 65 64 2c 09 74 68 65 6e | undefin|ed,.then|
|000063b0| 20 74 68 65 20 70 61 72 | 73 69 6e 67 20 62 65 68 | the par|sing beh|
|000063c0| 61 76 69 6f 72 20 73 65 | 74 20 62 79 20 74 68 65 |avior se|t by the|
|000063d0| 20 70 72 6f 67 72 61 6d | 6d 65 72 0a 58 20 20 20 | program|mer.X |
|000063e0| 20 20 20 20 69 73 09 75 | 73 65 64 2e 20 20 49 66 | is.u|sed. If|
|000063f0| 20 74 68 65 20 70 72 6f | 67 72 61 6d 6d 65 72 20 | the pro|grammer |
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.
