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
| SHell self-extracting ARchive (archive/shar)
| magic
| Supported |
| 1%
| dexvert
| Text File (text/txt)
| fallback
| Supported |
| 100%
| file
| ASCII text
| 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)
|
|
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 4e 65 77 73 67 72 6f 75 | 70 73 3a 20 63 6f 6d 70 |Newsgrou|ps: comp|
|00000010| 2e 73 6f 75 72 63 65 73 | 2e 6d 69 73 63 0a 46 72 |.sources|.misc.Fr|
|00000020| 6f 6d 3a 20 62 72 61 64 | 40 68 63 78 31 2e 73 73 |om: brad|@hcx1.ss|
|00000030| 64 2e 63 73 64 2e 68 61 | 72 72 69 73 2e 63 6f 6d |d.csd.ha|rris.com|
|00000040| 20 28 42 72 61 64 20 41 | 70 70 6c 65 74 6f 6e 29 | (Brad A|ppleton)|
|00000050| 0a 53 75 62 6a 65 63 74 | 3a 20 20 76 32 39 69 31 |.Subject|: v29i1|
|00000060| 31 39 3a 20 20 70 61 72 | 73 65 61 72 67 73 20 2d |19: par|seargs -|
|00000070| 20 66 75 6e 63 74 69 6f | 6e 73 20 74 6f 20 70 61 | functio|ns to pa|
|00000080| 72 73 65 20 63 6f 6d 6d | 61 6e 64 20 6c 69 6e 65 |rse comm|and line|
|00000090| 20 61 72 67 75 6d 65 6e | 74 73 2c 20 50 61 72 74 | argumen|ts, Part|
|000000a0| 30 34 2f 31 30 0a 4d 65 | 73 73 61 67 65 2d 49 44 |04/10.Me|ssage-ID|
|000000b0| 3a 20 3c 31 39 39 32 4d | 61 79 31 37 2e 31 38 32 |: <1992M|ay17.182|
|000000c0| 33 34 32 2e 32 38 37 30 | 39 40 73 70 61 72 6b 79 |342.2870|9@sparky|
|000000d0| 2e 69 6d 64 2e 73 74 65 | 72 6c 69 6e 67 2e 63 6f |.imd.ste|rling.co|
|000000e0| 6d 3e 0a 58 2d 4d 64 34 | 2d 53 69 67 6e 61 74 75 |m>.X-Md4|-Signatu|
|000000f0| 72 65 3a 20 38 64 30 66 | 62 65 36 36 37 39 37 65 |re: 8d0f|be66797e|
|00000100| 39 31 65 32 33 62 61 65 | 38 61 65 65 63 38 36 35 |91e23bae|8aeec865|
|00000110| 32 63 64 38 0a 44 61 74 | 65 3a 20 53 75 6e 2c 20 |2cd8.Dat|e: Sun, |
|00000120| 31 37 20 4d 61 79 20 31 | 39 39 32 20 31 38 3a 32 |17 May 1|992 18:2|
|00000130| 33 3a 34 32 20 47 4d 54 | 0a 41 70 70 72 6f 76 65 |3:42 GMT|.Approve|
|00000140| 64 3a 20 6b 65 6e 74 40 | 73 70 61 72 6b 79 2e 69 |d: kent@|sparky.i|
|00000150| 6d 64 2e 73 74 65 72 6c | 69 6e 67 2e 63 6f 6d 0a |md.sterl|ing.com.|
|00000160| 0a 53 75 62 6d 69 74 74 | 65 64 2d 62 79 3a 20 62 |.Submitt|ed-by: b|
|00000170| 72 61 64 40 68 63 78 31 | 2e 73 73 64 2e 63 73 64 |rad@hcx1|.ssd.csd|
|00000180| 2e 68 61 72 72 69 73 2e | 63 6f 6d 20 28 42 72 61 |.harris.|com (Bra|
|00000190| 64 20 41 70 70 6c 65 74 | 6f 6e 29 0a 50 6f 73 74 |d Applet|on).Post|
|000001a0| 69 6e 67 2d 6e 75 6d 62 | 65 72 3a 20 56 6f 6c 75 |ing-numb|er: Volu|
|000001b0| 6d 65 20 32 39 2c 20 49 | 73 73 75 65 20 31 31 39 |me 29, I|ssue 119|
|000001c0| 0a 41 72 63 68 69 76 65 | 2d 6e 61 6d 65 3a 20 70 |.Archive|-name: p|
|000001d0| 61 72 73 65 61 72 67 73 | 2f 70 61 72 74 30 34 0a |arseargs|/part04.|
|000001e0| 45 6e 76 69 72 6f 6e 6d | 65 6e 74 3a 20 55 4e 49 |Environm|ent: UNI|
|000001f0| 58 2c 20 56 4d 53 2c 20 | 4d 53 2d 44 4f 53 2c 20 |X, VMS, |MS-DOS, |
|00000200| 4f 53 2f 32 2c 20 41 6d | 69 67 61 0a 53 75 70 65 |OS/2, Am|iga.Supe|
|00000210| 72 73 65 64 65 73 3a 20 | 70 61 72 73 65 61 72 67 |rsedes: |parsearg|
|00000220| 73 3a 20 56 6f 6c 75 6d | 65 20 31 37 2c 20 49 73 |s: Volum|e 17, Is|
|00000230| 73 75 65 20 34 36 2d 35 | 37 0a 0a 23 21 20 2f 62 |sue 46-5|7..#! /b|
|00000240| 69 6e 2f 73 68 0a 23 20 | 54 68 69 73 20 69 73 20 |in/sh.# |This is |
|00000250| 61 20 73 68 65 6c 6c 20 | 61 72 63 68 69 76 65 2e |a shell |archive.|
|00000260| 20 20 52 65 6d 6f 76 65 | 20 61 6e 79 74 68 69 6e | Remove| anythin|
|00000270| 67 20 62 65 66 6f 72 65 | 20 74 68 69 73 20 6c 69 |g before| this li|
|00000280| 6e 65 2c 20 74 68 65 6e | 20 75 6e 70 61 63 6b 0a |ne, then| unpack.|
|00000290| 23 20 69 74 20 62 79 20 | 73 61 76 69 6e 67 20 69 |# it by |saving i|
|000002a0| 74 20 69 6e 74 6f 20 61 | 20 66 69 6c 65 20 61 6e |t into a| file an|
|000002b0| 64 20 74 79 70 69 6e 67 | 20 22 73 68 20 66 69 6c |d typing| "sh fil|
|000002c0| 65 22 2e 20 20 54 6f 20 | 6f 76 65 72 77 72 69 74 |e". To |overwrit|
|000002d0| 65 20 65 78 69 73 74 69 | 6e 67 0a 23 20 66 69 6c |e existi|ng.# fil|
|000002e0| 65 73 2c 20 74 79 70 65 | 20 22 73 68 20 66 69 6c |es, type| "sh fil|
|000002f0| 65 20 2d 63 22 2e 20 20 | 59 6f 75 20 63 61 6e 20 |e -c". |You can |
|00000300| 61 6c 73 6f 20 66 65 65 | 64 20 74 68 69 73 20 61 |also fee|d this a|
|00000310| 73 20 73 74 61 6e 64 61 | 72 64 20 69 6e 70 75 74 |s standa|rd input|
|00000320| 20 76 69 61 0a 23 20 75 | 6e 73 68 61 72 2c 20 6f | via.# u|nshar, o|
|00000330| 72 20 62 79 20 74 79 70 | 69 6e 67 20 22 73 68 20 |r by typ|ing "sh |
|00000340| 3c 66 69 6c 65 22 2c 20 | 65 2e 67 2e 2e 20 20 49 |<file", |e.g.. I|
|00000350| 66 20 74 68 69 73 20 61 | 72 63 68 69 76 65 20 69 |f this a|rchive i|
|00000360| 73 20 63 6f 6d 70 6c 65 | 74 65 2c 20 79 6f 75 0a |s comple|te, you.|
|00000370| 23 20 77 69 6c 6c 20 73 | 65 65 20 74 68 65 20 66 |# will s|ee the f|
|00000380| 6f 6c 6c 6f 77 69 6e 67 | 20 6d 65 73 73 61 67 65 |ollowing| message|
|00000390| 20 61 74 20 74 68 65 20 | 65 6e 64 3a 0a 23 09 09 | at the |end:.#..|
|000003a0| 22 45 6e 64 20 6f 66 20 | 61 72 63 68 69 76 65 20 |"End of |archive |
|000003b0| 34 20 28 6f 66 20 31 30 | 29 2e 22 0a 23 20 43 6f |4 (of 10|).".# Co|
|000003c0| 6e 74 65 6e 74 73 3a 20 | 20 64 6f 63 2f 70 61 72 |ntents: | doc/par|
|000003d0| 73 65 61 72 67 73 2e 6d | 61 6e 31 20 64 6f 63 2f |seargs.m|an1 doc/|
|000003e0| 70 61 72 73 65 61 72 67 | 73 2e 6d 61 6e 33 20 70 |parsearg|s.man3 p|
|000003f0| 67 6f 70 65 6e 2e 63 20 | 73 74 65 73 74 2e 63 0a |gopen.c |stest.c.|
|00000400| 23 20 20 20 75 6e 69 78 | 5f 6d 61 6e 2e 63 20 75 |# unix|_man.c u|
|00000410| 73 65 66 75 6c 2e 68 0a | 23 20 57 72 61 70 70 65 |seful.h.|# Wrappe|
|00000420| 64 20 62 79 20 62 72 61 | 64 40 68 63 78 31 20 6f |d by bra|d@hcx1 o|
|00000430| 6e 20 54 68 75 20 4d 61 | 79 20 20 37 20 31 32 3a |n Thu Ma|y 7 12:|
|00000440| 31 32 3a 32 32 20 31 39 | 39 32 0a 50 41 54 48 3d |12:22 19|92.PATH=|
|00000450| 2f 62 69 6e 3a 2f 75 73 | 72 2f 62 69 6e 3a 2f 75 |/bin:/us|r/bin:/u|
|00000460| 73 72 2f 75 63 62 20 3b | 20 65 78 70 6f 72 74 20 |sr/ucb ;| export |
|00000470| 50 41 54 48 0a 69 66 20 | 74 65 73 74 20 2d 66 20 |PATH.if |test -f |
|00000480| 27 64 6f 63 2f 70 61 72 | 73 65 61 72 67 73 2e 6d |'doc/par|seargs.m|
|00000490| 61 6e 31 27 20 2d 61 20 | 22 24 7b 31 7d 22 20 21 |an1' -a |"${1}" !|
|000004a0| 3d 20 22 2d 63 22 20 3b | 20 74 68 65 6e 20 0a 20 |= "-c" ;| then . |
|000004b0| 20 65 63 68 6f 20 73 68 | 61 72 3a 20 57 69 6c 6c | echo sh|ar: Will|
|000004c0| 20 6e 6f 74 20 63 6c 6f | 62 62 65 72 20 65 78 69 | not clo|bber exi|
|000004d0| 73 74 69 6e 67 20 66 69 | 6c 65 20 5c 22 27 64 6f |sting fi|le \"'do|
|000004e0| 63 2f 70 61 72 73 65 61 | 72 67 73 2e 6d 61 6e 31 |c/parsea|rgs.man1|
|000004f0| 27 5c 22 0a 65 6c 73 65 | 0a 65 63 68 6f 20 73 68 |'\".else|.echo sh|
|00000500| 61 72 3a 20 45 78 74 72 | 61 63 74 69 6e 67 20 5c |ar: Extr|acting \|
|00000510| 22 27 64 6f 63 2f 70 61 | 72 73 65 61 72 67 73 2e |"'doc/pa|rseargs.|
|00000520| 6d 61 6e 31 27 5c 22 20 | 5c 28 31 33 37 37 38 20 |man1'\" |\(13778 |
|00000530| 63 68 61 72 61 63 74 65 | 72 73 5c 29 0a 73 65 64 |characte|rs\).sed|
|00000540| 20 22 73 2f 5e 58 2f 2f | 22 20 3e 27 64 6f 63 2f | "s/^X//|" >'doc/|
|00000550| 70 61 72 73 65 61 72 67 | 73 2e 6d 61 6e 31 27 20 |parsearg|s.man1' |
|00000560| 3c 3c 27 45 4e 44 5f 4f | 46 5f 46 49 4c 45 27 0a |<<'END_O|F_FILE'.|
|00000570| 58 2e 5c 22 20 24 48 65 | 61 64 65 72 3a 20 70 61 |X.\" $He|ader: pa|
|00000580| 72 73 65 61 72 67 73 2e | 31 2c 76 20 31 2e 30 20 |rseargs.|1,v 1.0 |
|00000590| 39 30 2f 30 37 2f 32 34 | 20 42 72 61 64 20 41 70 |90/07/24| Brad Ap|
|000005a0| 70 6c 65 74 6f 6e 20 24 | 0a 58 2e 64 65 20 53 53 |pleton $|.X.de SS|
|000005b0| 0a 58 2e 73 70 20 38 70 | 0a 58 5c 73 2b 31 5c 66 |.X.sp 8p|.X\s+1\f|
|000005c0| 42 5c 5c 24 31 5c 66 50 | 5c 73 2d 31 0a 58 2e 62 |B\\$1\fP|\s-1.X.b|
|000005d0| 72 0a 58 2e 2e 0a 58 2e | 54 48 20 50 41 52 53 45 |r.X...X.|TH PARSE|
|000005e0| 41 52 47 53 20 31 0a 58 | 2e 6e 68 0a 58 2e 53 48 |ARGS 1.X|.nh.X.SH|
|000005f0| 20 4e 41 4d 45 0a 58 70 | 61 72 73 65 61 72 67 73 | NAME.Xp|arseargs|
|00000600| 20 5c 2d 20 70 61 72 73 | 65 20 63 6f 6d 6d 61 6e | \- pars|e comman|
|00000610| 64 20 6c 69 6e 65 20 61 | 72 67 75 6d 65 6e 74 73 |d line a|rguments|
|00000620| 20 69 6e 20 73 68 65 6c | 6c 20 73 63 72 69 70 74 | in shel|l script|
|00000630| 73 0a 58 2e 5c 22 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |s.X.\"--|--------|
|00000640| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00000650| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00000660| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00000670| 2d 0a 58 2e 53 48 20 53 | 59 4e 4f 50 53 49 53 0a |-.X.SH S|YNOPSIS.|
|00000680| 58 2e 54 50 20 31 32 0a | 58 5c 66 42 70 61 72 73 |X.TP 12.|X\fBpars|
|00000690| 65 61 72 67 73 5c 66 50 | 0a 58 5b 5c 66 42 5c 2d |eargs\fP|.X[\fB\-|
|000006a0| 23 55 4d 43 41 6c 6f 75 | 69 70 31 5c 66 50 5d 0a |#UMCAlou|ip1\fP].|
|000006b0| 58 5b 5c 66 42 5c 2d 53 | 5c 66 50 5c 20 5c 66 49 |X[\fB\-S|\fP\ \fI|
|000006c0| 73 65 70 61 72 61 74 6f | 72 5c 66 50 5d 0a 58 5b |separato|r\fP].X[|
|000006d0| 5c 66 42 5c 2d 54 5c 66 | 50 5c 20 5c 66 49 73 74 |\fB\-T\f|P\ \fIst|
|000006e0| 72 69 6e 67 5c 66 50 5d | 0a 58 5b 5c 66 42 5c 2d |ring\fP]|.X[\fB\-|
|000006f0| 46 5c 66 50 5c 20 5c 66 | 49 73 74 72 69 6e 67 5c |F\fP\ \f|Istring\|
|00000700| 66 50 5d 0a 58 5b 5c 66 | 42 5c 2d 61 5c 66 50 5c |fP].X[\f|B\-a\fP\|
|00000710| 20 5c 66 49 61 72 67 2d | 73 70 65 63 5c 66 50 5d | \fIarg-|spec\fP]|
|00000720| 0a 58 5b 5c 66 42 5c 2d | 65 5c 66 50 5c 20 5c 66 |.X[\fB\-|e\fP\ \f|
|00000730| 49 6e 61 6d 65 5c 66 50 | 5d 0a 58 5b 5c 66 42 5c |Iname\fP|].X[\fB\|
|00000740| 2d 66 5c 66 50 5c 20 5c | 66 49 66 69 6c 65 5c 66 |-f\fP\ \|fIfile\f|
|00000750| 50 5d 0a 58 5b 5c 66 42 | 5c 2d 73 5c 66 50 5c 20 |P].X[\fB|\-s\fP\ |
|00000760| 5c 66 49 73 68 65 6c 6c | 5c 66 50 5c 5e 5d 0a 58 |\fIshell|\fP\^].X|
|00000770| 5c 66 42 5c 2d 5c 5e 5c | 2d 5c 66 50 0a 58 5c 66 |\fB\-\^\|-\fP.X\f|
|00000780| 49 6e 61 6d 65 5c 66 50 | 0a 58 5b 5c 66 49 61 72 |Iname\fP|.X[\fIar|
|00000790| 67 75 6d 65 6e 74 73 5c | 66 50 5c 20 2e 5c 5e 2e |guments\|fP\ .\^.|
|000007a0| 5c 5e 2e 5c 5e 5d 0a 58 | 2e 5c 22 2d 2d 2d 2d 2d |\^.\^].X|.\"-----|
|000007b0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000007c0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000007d0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000007e0| 2d 2d 2d 2d 2d 2d 0a 58 | 2e 53 48 20 4f 50 54 49 |------.X|.SH OPTI|
|000007f0| 4f 4e 53 0a 58 2e 54 50 | 20 31 34 0a 58 5c 66 42 |ONS.X.TP| 14.X\fB|
|00000800| 5c 2d 23 5c 66 50 0a 58 | 6a 75 73 74 20 70 72 69 |\-#\fP.X|just pri|
|00000810| 6e 74 20 74 68 65 20 76 | 65 72 73 69 6f 6e 20 61 |nt the v|ersion a|
|00000820| 6e 64 20 70 61 74 63 68 | 6c 65 76 65 6c 2c 20 64 |nd patch|level, d|
|00000830| 6f 20 6e 6f 74 20 70 61 | 72 73 65 20 74 68 65 20 |o not pa|rse the |
|00000840| 63 6f 6d 6d 61 6e 64 20 | 6c 69 6e 65 0a 58 2e 54 |command |line.X.T|
|00000850| 50 20 31 34 0a 58 5c 66 | 42 5c 2d 55 5c 66 50 0a |P 14.X\f|B\-U\fP.|
|00000860| 58 6a 75 73 74 20 70 72 | 69 6e 74 20 70 72 6f 67 |Xjust pr|int prog|
|00000870| 72 61 6d 20 75 73 61 67 | 65 2c 20 64 6f 20 6e 6f |ram usag|e, do no|
|00000880| 74 20 70 61 72 73 65 20 | 74 68 65 20 63 6f 6d 6d |t parse |the comm|
|00000890| 61 6e 64 20 6c 69 6e 65 | 0a 58 2e 54 50 20 31 34 |and line|.X.TP 14|
|000008a0| 0a 58 5c 66 42 5c 2d 4d | 5c 66 50 0a 58 6a 75 73 |.X\fB\-M|\fP.Xjus|
|000008b0| 74 20 70 72 69 6e 74 20 | 28 6e 7c 74 29 72 6f 66 |t print |(n|t)rof|
|000008c0| 66 20 5c 2d 6d 61 6e 20 | 6d 61 6e 75 61 6c 20 70 |f \-man |manual p|
|000008d0| 61 67 65 20 74 65 6d 70 | 6c 61 74 65 2c 20 64 6f |age temp|late, do|
|000008e0| 20 6e 6f 74 20 70 61 72 | 73 65 20 74 68 65 20 63 | not par|se the c|
|000008f0| 6f 6d 6d 61 6e 64 20 6c | 69 6e 65 0a 58 2e 54 50 |ommand l|ine.X.TP|
|00000900| 20 31 34 0a 58 5c 66 42 | 2d 53 5c 66 50 5c 20 5c | 14.X\fB|-S\fP\ \|
|00000910| 66 49 73 65 70 61 72 61 | 74 6f 72 5c 66 50 0a 58 |fIsepara|tor\fP.X|
|00000920| 66 69 65 6c 64 2d 73 65 | 70 61 72 61 74 6f 72 2d |field-se|parator-|
|00000930| 73 74 72 69 6e 67 20 75 | 73 65 64 20 74 6f 20 64 |string u|sed to d|
|00000940| 65 6c 69 6d 69 74 20 61 | 72 72 61 79 20 65 6c 65 |elimit a|rray ele|
|00000950| 6d 65 6e 74 73 20 20 28 | 5c 66 49 64 65 66 61 75 |ments (|\fIdefau|
|00000960| 6c 74 3d 60 60 5c 30 27 | 27 5c 66 50 5c 7c 29 0a |lt=``\0'|'\fP\|).|
|00000970| 58 2e 54 50 20 31 34 0a | 58 5c 66 42 5c 2d 54 5c |X.TP 14.|X\fB\-T\|
|00000980| 66 50 20 5c 66 49 73 74 | 72 69 6e 67 5c 66 50 0a |fP \fIst|ring\fP.|
|00000990| 58 73 74 72 69 6e 67 20 | 74 6f 20 75 73 65 20 66 |Xstring |to use f|
|000009a0| 6f 72 20 74 72 75 65 20 | 62 6f 6f 6c 65 61 6e 20 |or true |boolean |
|000009b0| 61 72 67 75 6d 65 6e 74 | 73 5c 7c 20 20 28 5c 66 |argument|s\| (\f|
|000009c0| 49 64 65 66 61 75 6c 74 | 3d 60 60 5c 73 2d 31 54 |Idefault|=``\s-1T|
|000009d0| 52 55 45 5c 73 2b 31 5c | 5e 27 27 5c 66 50 5c 7c |RUE\s+1\|^''\fP\||
|000009e0| 29 0a 58 2e 54 50 20 31 | 34 0a 58 5c 66 42 5c 2d |).X.TP 1|4.X\fB\-|
|000009f0| 46 5c 66 50 20 5c 66 49 | 73 74 72 69 6e 67 5c 66 |F\fP \fI|string\f|
|00000a00| 50 0a 58 73 74 72 69 6e | 67 20 74 6f 20 75 73 65 |P.Xstrin|g to use|
|00000a10| 20 66 6f 72 20 66 61 6c | 73 65 20 62 6f 6f 6c 65 | for fal|se boole|
|00000a20| 61 6e 20 61 72 67 75 6d | 65 6e 74 73 20 20 28 5c |an argum|ents (\|
|00000a30| 66 49 64 65 66 61 75 6c | 74 3d 60 60 5c 5e 27 27 |fIdefaul|t=``\^''|
|00000a40| 5c 66 50 5c 7c 29 0a 58 | 2e 54 50 20 31 34 0a 58 |\fP\|).X|.TP 14.X|
|00000a50| 5c 66 42 5c 2d 43 5c 66 | 50 0a 58 49 67 6e 6f 72 |\fB\-C\f|P.XIgnor|
|00000a60| 65 20 74 68 65 20 64 69 | 66 66 65 72 65 6e 63 65 |e the di|fference|
|00000a70| 20 62 65 74 77 65 65 6e | 20 75 70 70 65 72 20 61 | between| upper a|
|00000a80| 6e 64 20 6c 6f 77 65 72 | 20 63 61 73 65 20 77 68 |nd lower| case wh|
|00000a90| 65 6e 20 70 61 72 73 69 | 6e 67 20 73 69 6e 67 6c |en parsi|ng singl|
|00000aa0| 65 0a 58 63 68 61 72 61 | 63 74 65 72 20 6f 70 74 |e.Xchara|cter opt|
|00000ab0| 69 6f 6e 73 2e 0a 58 2e | 54 50 20 31 34 0a 58 5c |ions..X.|TP 14.X\|
|00000ac0| 66 42 5c 2d 41 5c 66 50 | 0a 58 6d 6f 64 69 66 79 |fB\-A\fP|.Xmodify|
|00000ad0| 20 61 72 72 61 79 20 62 | 65 68 61 76 69 6f 72 20 | array b|ehavior |
|00000ae0| 66 6f 72 20 74 68 65 20 | 73 70 65 63 69 66 69 65 |for the |specifie|
|00000af0| 64 20 73 68 65 6c 6c 2e | 0a 58 2e 54 50 20 31 34 |d shell.|.X.TP 14|
|00000b00| 0a 58 5c 66 42 5c 2d 61 | 5c 66 50 20 5c 66 49 61 |.X\fB\-a|\fP \fIa|
|00000b10| 72 67 2d 73 70 65 63 5c | 66 50 0a 58 61 72 67 75 |rg-spec\|fP.Xargu|
|00000b20| 6d 65 6e 74 20 73 70 65 | 63 69 66 69 63 61 74 69 |ment spe|cificati|
|00000b30| 6f 6e 20 73 74 72 69 6e | 67 0a 58 2e 54 50 20 31 |on strin|g.X.TP 1|
|00000b40| 34 0a 58 5c 66 42 5c 2d | 65 5c 66 50 5c 20 5c 66 |4.X\fB\-|e\fP\ \f|
|00000b50| 49 6e 61 6d 65 5c 66 50 | 0a 58 72 65 61 64 20 74 |Iname\fP|.Xread t|
|00000b60| 68 65 20 61 72 67 2d 73 | 70 65 63 20 73 74 72 69 |he arg-s|pec stri|
|00000b70| 6e 67 20 66 72 6f 6d 20 | 74 68 65 20 65 6e 76 69 |ng from |the envi|
|00000b80| 72 6f 6e 6d 65 6e 74 20 | 76 61 72 69 61 62 6c 65 |ronment |variable|
|00000b90| 20 6e 61 6d 65 64 20 5c | 66 49 6e 61 6d 65 5c 66 | named \|fIname\f|
|00000ba0| 50 0a 58 2e 54 50 20 31 | 34 0a 58 5c 66 42 5c 2d |P.X.TP 1|4.X\fB\-|
|00000bb0| 66 5c 66 50 20 5c 66 49 | 66 69 6c 65 5c 66 50 0a |f\fP \fI|file\fP.|
|00000bc0| 58 72 65 61 64 20 74 68 | 65 20 61 72 67 2d 73 70 |Xread th|e arg-sp|
|00000bd0| 65 63 20 66 72 6f 6d 20 | 5c 66 49 66 69 6c 65 5c |ec from |\fIfile\|
|00000be0| 66 50 20 20 28 5c 66 49 | 64 65 66 61 75 6c 74 3d |fP (\fI|default=|
|00000bf0| 73 74 64 69 6e 5c 66 50 | 29 0a 58 2e 54 50 20 31 |stdin\fP|).X.TP 1|
|00000c00| 34 0a 58 5c 66 42 5c 2d | 6c 5c 66 50 0a 58 4c 6f |4.X\fB\-|l\fP.XLo|
|00000c10| 6e 67 2d 6f 70 74 69 6f | 6e 73 20 6f 6e 6c 79 2e |ng-optio|ns only.|
|00000c20| 20 44 69 73 61 62 6c 65 | 20 74 68 65 20 70 61 72 | Disable| the par|
|00000c30| 73 69 6e 67 20 6f 66 20 | 28 73 69 6e 67 6c 65 2d |sing of |(single-|
|00000c40| 63 68 61 72 61 63 74 65 | 72 29 20 6f 70 74 69 6f |characte|r) optio|
|00000c50| 6e 73 2e 0a 58 2e 54 50 | 20 31 34 0a 58 5c 66 42 |ns..X.TP| 14.X\fB|
|00000c60| 5c 2d 6f 5c 66 50 0a 58 | 4f 70 74 69 6f 6e 73 20 |\-o\fP.X|Options |
|00000c70| 6f 6e 6c 79 2e 20 44 69 | 73 61 62 6c 65 20 74 68 |only. Di|sable th|
|00000c80| 65 20 70 61 72 73 69 6e | 67 20 6f 66 20 6c 6f 6e |e parsin|g of lon|
|00000c90| 67 2d 6f 70 74 69 6f 6e | 73 20 28 6b 65 79 77 6f |g-option|s (keywo|
|00000ca0| 72 64 73 29 2e 0a 58 2e | 54 50 20 31 34 0a 58 5c |rds)..X.|TP 14.X\|
|00000cb0| 66 42 5c 2d 73 5c 66 50 | 20 5c 66 49 73 68 65 6c |fB\-s\fP| \fIshel|
|00000cc0| 6c 5c 66 50 0a 58 75 73 | 65 20 5c 66 49 73 68 65 |l\fP.Xus|e \fIshe|
|00000cd0| 6c 6c 5c 66 50 20 63 6f | 6d 6d 61 6e 64 20 73 79 |ll\fP co|mmand sy|
|00000ce0| 6e 74 61 78 5c 7c 20 20 | 28 5c 66 49 64 65 66 61 |ntax\| |(\fIdefa|
|00000cf0| 75 6c 74 3d 60 60 73 68 | 27 27 5c 66 50 5c 7c 29 |ult=``sh|''\fP\|)|
|00000d00| 0a 58 2e 54 50 20 31 34 | 0a 58 5c 66 42 5c 2d 75 |.X.TP 14|.X\fB\-u|
|00000d10| 5c 66 50 0a 58 75 6e 73 | 65 74 20 70 6f 73 69 74 |\fP.Xuns|et posit|
|00000d20| 69 6f 6e 61 6c 20 70 61 | 72 61 6d 65 74 65 72 73 |ional pa|rameters|
|00000d30| 20 62 65 66 6f 72 65 20 | 61 73 73 69 67 6e 69 6e | before |assignin|
|00000d40| 67 20 76 61 72 69 61 62 | 6c 65 73 0a 58 2e 54 50 |g variab|les.X.TP|
|00000d50| 20 31 34 0a 58 5c 66 42 | 5c 2d 70 5c 66 50 0a 58 | 14.X\fB|\-p\fP.X|
|00000d60| 70 72 6f 6d 70 74 20 74 | 68 65 20 75 73 65 72 20 |prompt t|he user |
|00000d70| 66 6f 72 20 6d 69 73 73 | 69 6e 67 20 72 65 71 75 |for miss|ing requ|
|00000d80| 69 72 65 64 20 61 72 67 | 75 6d 65 6e 74 73 0a 58 |ired arg|uments.X|
|00000d90| 2e 54 50 20 31 34 0a 58 | 5c 66 42 5c 2d 69 5c 66 |.TP 14.X|\fB\-i\f|
|00000da0| 50 0a 58 69 67 6e 6f 72 | 65 20 62 61 64 20 63 6f |P.Xignor|e bad co|
|00000db0| 6d 6d 61 6e 64 2d 6c 69 | 6e 65 20 73 79 6e 74 61 |mmand-li|ne synta|
|00000dc0| 78 20 61 6e 64 20 63 6f | 6e 74 69 6e 75 65 20 70 |x and co|ntinue p|
|00000dd0| 72 6f 63 65 73 73 69 6e | 67 20 28 69 6e 73 74 65 |rocessin|g (inste|
|00000de0| 61 64 20 6f 66 20 61 62 | 6f 72 74 69 6e 67 29 0a |ad of ab|orting).|
|00000df0| 58 2e 54 50 20 31 34 0a | 58 5c 66 42 5c 2d 31 5c |X.TP 14.|X\fB\-1\|
|00000e00| 66 50 0a 58 46 6f 72 63 | 65 20 61 6e 79 20 61 6e |fP.XForc|e any an|
|00000e10| 64 20 61 6c 6c 20 6e 6f | 6e 2d 70 6f 73 69 74 69 |d all no|n-positi|
|00000e20| 6f 6e 61 6c 20 70 61 72 | 61 6d 65 74 65 72 73 20 |onal par|ameters |
|00000e30| 74 6f 20 62 65 20 73 70 | 65 63 69 66 69 65 64 20 |to be sp|ecified |
|00000e40| 62 65 66 6f 72 65 20 61 | 6e 79 0a 58 70 6f 73 69 |before a|ny.Xposi|
|00000e50| 74 69 6f 6e 61 6c 20 70 | 61 72 61 6d 65 74 65 72 |tional p|arameter|
|00000e60| 73 20 6f 6e 20 74 68 65 | 20 63 6f 6d 6d 61 6e 64 |s on the| command|
|00000e70| 2d 6c 69 6e 65 2e 0a 58 | 2e 5c 22 2d 2d 2d 2d 2d |-line..X|.\"-----|
|00000e80| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00000e90| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00000ea0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00000eb0| 2d 2d 2d 2d 2d 2d 0a 58 | 2e 53 48 20 41 52 47 55 |------.X|.SH ARGU|
|00000ec0| 4d 45 4e 54 53 0a 58 2e | 54 50 20 31 34 0a 58 5c |MENTS.X.|TP 14.X\|
|00000ed0| 66 49 5c 2d 5c 5e 5c 2d | 5c 66 50 0a 58 49 6e 64 |fI\-\^\-|\fP.XInd|
|00000ee0| 69 63 61 74 65 73 20 74 | 68 61 74 20 61 6e 79 20 |icates t|hat any |
|00000ef0| 72 65 6d 61 69 6e 69 6e | 67 20 6f 70 74 69 6f 6e |remainin|g option|
|00000f00| 73 20 61 72 65 20 69 6e | 74 65 6e 64 65 64 20 66 |s are in|tended f|
|00000f10| 6f 72 20 74 68 65 20 63 | 61 6c 6c 69 6e 67 20 70 |or the c|alling p|
|00000f20| 72 6f 67 72 61 6d 2e 0a | 58 2e 54 50 20 31 34 0a |rogram..|X.TP 14.|
|00000f30| 58 5c 66 49 6e 61 6d 65 | 5c 66 50 0a 58 6e 61 6d |X\fIname|\fP.Xnam|
|00000f40| 65 20 6f 66 20 63 61 6c | 6c 69 6e 67 20 70 72 6f |e of cal|ling pro|
|00000f50| 67 72 61 6d 0a 58 2e 54 | 50 20 31 34 0a 58 5c 66 |gram.X.T|P 14.X\f|
|00000f60| 49 61 72 67 75 6d 65 6e | 74 73 5c 66 50 0a 58 61 |Iargumen|ts\fP.Xa|
|00000f70| 72 67 75 6d 65 6e 74 73 | 20 74 6f 20 63 61 6c 6c |rguments| to call|
|00000f80| 69 6e 67 20 70 72 6f 67 | 72 61 6d 0a 58 2e 5c 22 |ing prog|ram.X.\"|
|00000f90| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00000fa0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00000fb0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00000fc0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 0a 58 2e 73 6f |--------|---.X.so|
|00000fd0| 20 70 61 72 73 65 61 72 | 67 73 31 2e 69 6e 63 0a | parsear|gs1.inc.|
|00000fe0| 58 2e 5c 22 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |X.\"----|--------|
|00000ff0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00001000| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00001010| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 0a |--------|-------.|
|00001020| 58 2e 50 50 0a 58 54 68 | 65 20 61 72 67 75 6d 65 |X.PP.XTh|e argume|
|00001030| 6e 74 20 73 70 65 63 69 | 66 69 63 61 74 69 6f 6e |nt speci|fication|
|00001040| 20 73 74 72 69 6e 67 20 | 63 6f 6e 74 61 69 6e 73 | string |contains|
|00001050| 20 6f 6e 65 20 65 6e 74 | 72 79 20 66 6f 72 20 65 | one ent|ry for e|
|00001060| 61 63 68 20 70 6f 73 73 | 69 62 6c 65 20 66 6c 61 |ach poss|ible fla|
|00001070| 67 2e 0a 58 45 6e 74 72 | 69 65 73 20 69 6e 20 74 |g..XEntr|ies in t|
|00001080| 68 65 20 61 72 67 75 6d | 65 6e 74 20 73 70 65 63 |he argum|ent spec|
|00001090| 69 66 69 63 61 74 69 6f | 6e 20 73 74 72 69 6e 67 |ificatio|n string|
|000010a0| 20 61 72 65 20 73 65 70 | 61 72 61 74 65 64 20 62 | are sep|arated b|
|000010b0| 79 20 63 6f 6d 6d 61 73 | 2e 0a 58 45 61 63 68 20 |y commas|..XEach |
|000010c0| 65 6e 74 72 79 20 68 61 | 73 20 66 69 76 65 20 63 |entry ha|s five c|
|000010d0| 6f 6d 6d 61 2d 73 65 70 | 61 72 61 74 65 64 20 66 |omma-sep|arated f|
|000010e0| 69 65 6c 64 73 3a 0a 58 | 61 20 6e 61 6d 65 2c 20 |ields:.X|a name, |
|000010f0| 73 6f 6d 65 20 66 6c 61 | 67 73 2c 20 61 20 74 79 |some fla|gs, a ty|
|00001100| 70 65 2c 20 61 20 76 61 | 72 69 61 62 6c 65 2d 6e |pe, a va|riable-n|
|00001110| 61 6d 65 2c 20 61 6e 64 | 20 61 20 70 72 6f 6d 70 |ame, and| a promp|
|00001120| 74 2e 0a 58 45 61 63 68 | 20 6f 66 20 74 68 65 73 |t..XEach| of thes|
|00001130| 65 20 66 69 65 6c 64 73 | 20 61 72 65 20 64 65 73 |e fields| are des|
|00001140| 63 72 69 62 65 64 20 62 | 65 6c 6f 77 3a 0a 58 2e |cribed b|elow:.X.|
|00001150| 54 50 20 31 30 0a 58 5c | 66 49 6e 61 6d 65 5c 66 |TP 10.X\|fIname\f|
|00001160| 50 0a 58 54 68 65 20 73 | 69 6e 67 6c 65 20 63 68 |P.XThe s|ingle ch|
|00001170| 61 72 61 63 74 65 72 20 | 6e 61 6d 65 20 6f 66 20 |aracter |name of |
|00001180| 74 68 65 20 61 73 73 6f | 63 69 61 74 65 64 20 66 |the asso|ciated f|
|00001190| 6c 61 67 2e 0a 58 46 6f | 72 20 65 78 61 6d 70 6c |lag..XFo|r exampl|
|000011a0| 65 2c 20 74 6f 20 69 6e | 64 69 63 61 74 65 20 74 |e, to in|dicate t|
|000011b0| 68 61 74 20 74 68 65 20 | 70 72 6f 67 72 61 6d 20 |hat the |program |
|000011c0| 69 73 20 65 78 70 65 63 | 74 69 6e 67 20 61 20 60 |is expec|ting a `|
|000011d0| 60 5c 2d 78 27 27 20 66 | 6c 61 67 2c 0a 58 74 68 |`\-x'' f|lag,.Xth|
|000011e0| 69 73 20 66 69 65 6c 64 | 20 77 6f 75 6c 64 20 63 |is field| would c|
|000011f0| 6f 6e 74 61 69 6e 20 5c | 27 78 5c 27 2e 0a 58 50 |ontain \|'x\'..XP|
|00001200| 6f 73 69 74 69 6f 6e 61 | 6c 20 61 72 67 75 6d 65 |ositiona|l argume|
|00001210| 6e 74 73 20 28 74 68 6f | 73 65 20 77 69 74 68 6f |nts (tho|se witho|
|00001220| 75 74 20 61 20 60 60 5c | 2d 5c 66 49 78 5c 66 50 |ut a ``\|-\fIx\fP|
|00001230| 27 27 20 70 72 65 66 69 | 78 29 0a 58 61 72 65 20 |'' prefi|x).Xare |
|00001240| 69 6e 64 69 63 61 74 65 | 64 20 62 79 20 70 61 73 |indicate|d by pas|
|00001250| 73 69 6e 67 20 61 20 60 | 60 73 70 61 63 65 27 27 |sing a `|`space''|
|00001260| 20 63 68 61 72 61 63 74 | 65 72 2e 0a 58 2e 54 50 | charact|er..X.TP|
|00001270| 20 31 30 0a 58 5c 66 49 | 66 6c 61 67 73 5c 66 50 | 10.X\fI|flags\fP|
|00001280| 0a 58 46 6c 61 67 73 20 | 6d 6f 64 69 66 79 69 6e |.XFlags |modifyin|
|00001290| 67 20 74 68 65 20 73 65 | 6d 61 6e 74 69 63 73 20 |g the se|mantics |
|000012a0| 6f 66 20 74 68 69 73 20 | 65 6e 74 72 79 2e 0a 58 |of this |entry..X|
|000012b0| 54 68 65 73 65 20 73 68 | 6f 75 6c 64 20 68 61 76 |These sh|ould hav|
|000012c0| 65 20 6f 6e 65 20 6f 66 | 0a 58 5c 73 2d 31 41 52 |e one of|.X\s-1AR|
|000012d0| 47 52 45 51 5c 73 2b 31 | 0a 58 74 6f 20 69 6e 64 |GREQ\s+1|.Xto ind|
|000012e0| 69 63 61 74 65 20 61 20 | 72 65 71 75 69 72 65 64 |icate a |required|
|000012f0| 20 61 72 67 75 6d 65 6e | 74 20 6f 72 0a 58 5c 73 | argumen|t or.X\s|
|00001300| 2d 31 41 52 47 4f 50 54 | 5c 73 2b 31 0a 58 74 6f |-1ARGOPT|\s+1.Xto|
|00001310| 20 69 6e 64 69 63 61 74 | 65 20 61 6e 20 6f 70 74 | indicat|e an opt|
|00001320| 69 6f 6e 61 6c 20 61 72 | 67 75 6d 65 6e 74 0a 58 |ional ar|gument.X|
|00001330| 28 5c 73 2d 31 41 52 47 | 4f 50 54 5c 73 2b 31 20 |(\s-1ARG|OPT\s+1 |
|00001340| 69 73 20 74 68 65 20 64 | 65 66 61 75 6c 74 20 75 |is the d|efault u|
|00001350| 6e 6c 65 73 73 20 5c 73 | 2d 31 41 52 47 52 45 51 |nless \s|-1ARGREQ|
|00001360| 5c 73 2b 31 20 69 73 20 | 73 70 65 63 69 66 69 65 |\s+1 is |specifie|
|00001370| 64 29 2e 0a 58 5c 73 2d | 31 41 52 47 50 4f 53 5c |d)..X\s-|1ARGPOS\|
|00001380| 73 2b 31 0a 58 6d 61 79 | 20 62 65 20 60 60 6f 72 |s+1.Xmay| be ``or|
|00001390| 65 64 27 27 20 69 6e 20 | 74 6f 20 69 6e 64 69 63 |ed'' in |to indic|
|000013a0| 61 74 65 20 61 20 70 6f | 73 69 74 69 6f 6e 61 6c |ate a po|sitional|
|000013b0| 20 61 72 67 75 6d 65 6e | 74 20 74 68 61 74 20 6d | argumen|t that m|
|000013c0| 61 79 20 61 6c 73 6f 0a | 58 62 65 20 6b 65 79 77 |ay also.|Xbe keyw|
|000013d0| 6f 72 64 20 6d 61 74 63 | 68 65 64 2e 0a 58 5c 73 |ord matc|hed..X\s|
|000013e0| 2d 31 41 52 47 56 41 4c | 4f 50 54 5c 73 2b 31 0a |-1ARGVAL|OPT\s+1.|
|000013f0| 58 6d 61 79 20 62 65 20 | 60 60 6f 72 65 64 27 27 |Xmay be |``ored''|
|00001400| 20 69 6e 20 74 6f 20 69 | 6e 64 69 63 61 74 65 20 | in to i|ndicate |
|00001410| 74 68 61 74 20 61 6e 20 | 61 72 67 75 6d 65 6e 74 |that an |argument|
|00001420| 20 74 6f 20 74 68 65 20 | 6f 70 74 69 6f 6e 20 6d | to the |option m|
|00001430| 61 79 20 62 65 0a 58 6f | 70 74 69 6f 6e 61 6c 6c |ay be.Xo|ptionall|
|00001440| 79 20 73 75 70 70 6c 69 | 65 64 20 6f 6e 20 74 68 |y suppli|ed on th|
|00001450| 65 20 63 6f 6d 6d 61 6e | 64 2d 6c 69 6e 65 2c 20 |e comman|d-line, |
|00001460| 62 75 74 20 69 73 20 6e | 6f 74 20 72 65 71 75 69 |but is n|ot requi|
|00001470| 72 65 64 2e 0a 58 5c 73 | 2d 31 41 52 47 56 41 4c |red..X\s|-1ARGVAL|
|00001480| 52 45 51 5c 73 2b 31 0a | 58 6d 61 79 20 62 65 20 |REQ\s+1.|Xmay be |
|00001490| 60 60 6f 72 65 64 27 27 | 20 69 6e 20 74 6f 20 69 |``ored''| in to i|
|000014a0| 6e 64 69 63 61 74 65 20 | 74 68 61 74 20 61 6e 20 |ndicate |that an |
|000014b0| 61 72 67 75 6d 65 6e 74 | 20 74 6f 20 74 68 65 20 |argument| to the |
|000014c0| 6f 70 74 69 6f 6e 20 69 | 73 20 72 65 71 75 69 72 |option i|s requir|
|000014d0| 65 64 0a 58 28 74 68 69 | 73 20 69 73 20 74 68 65 |ed.X(thi|s is the|
|000014e0| 20 64 65 66 61 75 6c 74 | 20 62 65 68 61 76 69 6f | default| behavio|
|000014f0| 72 20 66 6f 72 20 6f 70 | 74 69 6f 6e 73 20 74 68 |r for op|tions th|
|00001500| 61 74 20 74 61 6b 65 20 | 61 72 67 75 6d 65 6e 74 |at take |argument|
|00001510| 73 29 2e 0a 58 5c 73 2d | 31 41 52 47 4c 49 53 54 |s)..X\s-|1ARGLIST|
|00001520| 5c 73 2b 31 0a 58 6d 61 | 79 20 62 65 20 60 60 6f |\s+1.Xma|y be ``o|
|00001530| 72 65 64 27 27 20 69 6e | 20 28 75 73 69 6e 67 20 |red'' in| (using |
|00001540| 74 68 65 20 60 5c 5e 7c | 5c 5e 27 20 63 68 61 72 |the `\^||\^' char|
|00001550| 61 63 74 65 72 29 20 74 | 6f 20 69 6e 64 69 63 61 |acter) t|o indica|
|00001560| 74 65 20 74 68 61 74 20 | 61 6e 20 61 72 67 75 6d |te that |an argum|
|00001570| 65 6e 74 0a 58 69 73 20 | 61 63 74 75 61 6c 6c 79 |ent.Xis |actually|
|00001580| 20 61 20 6c 69 73 74 20 | 6f 66 20 6f 6e 65 20 6f | a list |of one o|
|00001590| 72 20 6d 6f 72 65 20 61 | 72 67 75 6d 65 6e 74 73 |r more a|rguments|
|000015a0| 20 66 72 6f 6d 20 74 68 | 65 20 63 6f 6d 6d 61 6e | from th|e comman|
|000015b0| 64 20 6c 69 6e 65 2e 0a | 58 5c 73 2d 31 41 52 47 |d line..|X\s-1ARG|
|000015c0| 48 49 44 44 45 4e 5c 73 | 2b 31 0a 58 6d 61 79 20 |HIDDEN\s|+1.Xmay |
|000015d0| 62 65 20 60 60 6f 72 65 | 64 27 27 20 69 6e 20 74 |be ``ore|d'' in t|
|000015e0| 6f 20 69 6e 64 69 63 61 | 74 65 20 61 20 66 6c 61 |o indica|te a fla|
|000015f0| 67 20 74 68 61 74 20 73 | 68 6f 75 6c 64 20 6e 6f |g that s|hould no|
|00001600| 74 20 62 65 20 70 72 69 | 6e 74 65 64 0a 58 69 6e |t be pri|nted.Xin|
|00001610| 20 75 73 61 67 65 20 6d | 65 73 73 61 67 65 73 20 | usage m|essages |
|00001620| 5c 28 65 6d 0a 58 66 6f | 72 20 65 78 61 6d 70 6c |\(em.Xfo|r exampl|
|00001630| 65 2c 20 66 6c 61 67 73 | 20 69 6e 74 65 6e 64 65 |e, flags| intende|
|00001640| 64 20 66 6f 72 20 69 6e | 74 65 72 6e 61 6c 20 64 |d for in|ternal d|
|00001650| 65 62 75 67 67 69 6e 67 | 20 70 75 72 70 6f 73 65 |ebugging| purpose|
|00001660| 73 2e 0a 58 2e 54 50 20 | 31 30 0a 58 5c 66 49 74 |s..X.TP |10.X\fIt|
|00001670| 79 70 65 5c 66 50 0a 58 | 54 68 65 20 74 79 70 65 |ype\fP.X|The type|
|00001680| 20 6f 66 20 74 68 65 20 | 61 72 67 75 6d 65 6e 74 | of the |argument|
|00001690| 2e 0a 58 45 78 69 73 74 | 69 6e 67 20 74 79 70 65 |..XExist|ing type|
|000016a0| 73 20 69 6e 63 6c 75 64 | 65 0a 58 5c 66 49 61 72 |s includ|e.X\fIar|
|000016b0| 67 55 73 61 67 65 5c 66 | 50 20 28 70 72 69 6e 74 |gUsage\f|P (print|
|000016c0| 20 75 73 61 67 65 20 6d | 65 73 73 61 67 65 20 61 | usage m|essage a|
|000016d0| 6e 64 20 65 78 69 74 29 | 2c 0a 58 5c 66 49 61 72 |nd exit)|,.X\fIar|
|000016e0| 67 42 6f 6f 6c 5c 66 50 | 20 61 6e 64 20 5c 66 49 |gBool\fP| and \fI|
|000016f0| 61 72 67 53 42 6f 6f 6c | 5c 66 50 20 28 73 65 74 |argSBool|\fP (set|
|00001700| 20 42 6f 6f 6c 65 61 6e | 20 66 6c 61 67 73 29 2c | Boolean| flags),|
|00001710| 0a 58 5c 66 49 61 72 67 | 55 42 6f 6f 6c 5c 66 50 |.X\fIarg|UBool\fP|
|00001720| 20 28 75 6e 73 65 74 20 | 42 6f 6f 6c 65 61 6e 20 | (unset |Boolean |
|00001730| 66 6c 61 67 73 29 2c 0a | 58 5c 66 49 61 72 67 53 |flags),.|X\fIargS|
|00001740| 74 72 5c 66 50 20 28 73 | 74 72 69 6e 67 2d 76 61 |tr\fP (s|tring-va|
|00001750| 6c 75 65 64 20 61 72 67 | 75 6d 65 6e 74 73 29 2c |lued arg|uments),|
|00001760| 0a 58 5c 66 49 61 72 67 | 43 68 61 72 5c 66 50 20 |.X\fIarg|Char\fP |
|00001770| 28 63 68 61 72 2d 76 61 | 6c 75 65 64 20 61 72 67 |(char-va|lued arg|
|00001780| 75 6d 65 6e 74 73 29 2c | 0a 58 5c 66 49 61 72 67 |uments),|.X\fIarg|
|00001790| 49 6e 74 5c 66 50 20 28 | 6e 61 74 69 76 65 20 69 |Int\fP (|native i|
|000017a0| 6e 74 65 67 65 72 20 61 | 72 67 75 6d 65 6e 74 73 |nteger a|rguments|
|000017b0| 29 2c 0a 58 5c 66 49 61 | 72 67 53 68 6f 72 74 5c |),.X\fIa|rgShort\|
|000017c0| 66 50 20 28 73 68 6f 72 | 74 20 69 6e 74 65 67 65 |fP (shor|t intege|
|000017d0| 72 20 61 72 67 75 6d 65 | 6e 74 73 29 2c 0a 58 5c |r argume|nts),.X\|
|000017e0| 66 49 61 72 67 4c 6f 6e | 67 5c 66 50 20 28 6c 6f |fIargLon|g\fP (lo|
|000017f0| 6e 67 20 69 6e 74 65 67 | 65 72 20 61 72 67 75 6d |ng integ|er argum|
|00001800| 65 6e 74 73 29 2c 0a 58 | 5c 66 49 61 72 67 46 6c |ents),.X|\fIargFl|
|00001810| 6f 61 74 5c 66 50 20 28 | 73 68 6f 72 74 20 66 6c |oat\fP (|short fl|
|00001820| 6f 61 74 69 6e 67 20 70 | 6f 69 6e 74 20 61 72 67 |oating p|oint arg|
|00001830| 75 6d 65 6e 74 73 29 2c | 0a 58 5c 66 49 61 72 67 |uments),|.X\fIarg|
|00001840| 44 6f 75 62 6c 65 5c 66 | 50 20 28 6c 6f 6e 67 20 |Double\f|P (long |
|00001850| 66 6c 6f 61 74 69 6e 67 | 20 70 6f 69 6e 74 20 61 |floating| point a|
|00001860| 72 67 75 6d 65 6e 74 73 | 29 2c 20 61 6e 64 0a 58 |rguments|), and.X|
|00001870| 5c 66 49 61 72 67 44 75 | 6d 6d 79 5c 66 50 20 28 |\fIargDu|mmy\fP (|
|00001880| 6f 6e 6c 79 20 75 73 65 | 64 20 61 73 20 70 61 72 |only use|d as par|
|00001890| 74 20 6f 66 20 75 73 61 | 67 65 20 6d 65 73 73 61 |t of usa|ge messa|
|000018a0| 67 65 2c 0a 58 6e 6f 74 | 20 6d 61 74 63 68 65 64 |ge,.Xnot| matched|
|000018b0| 20 6f 6e 20 63 6f 6d 6d | 61 6e 64 2d 6c 69 6e 65 | on comm|and-line|
|000018c0| 29 2e 0a 58 2e 54 50 20 | 31 30 0a 58 5c 66 49 76 |)..X.TP |10.X\fIv|
|000018d0| 61 72 69 61 62 6c 65 5c | 66 50 0a 58 54 68 65 20 |ariable\|fP.XThe |
|000018e0| 6e 61 6d 65 20 6f 66 20 | 74 68 65 20 73 68 65 6c |name of |the shel|
|000018f0| 6c 20 76 61 72 69 61 62 | 6c 65 20 74 68 61 74 20 |l variab|le that |
|00001900| 73 68 6f 75 6c 64 20 72 | 65 63 65 69 76 65 20 74 |should r|eceive t|
|00001910| 68 65 20 63 6f 6e 76 65 | 72 74 65 64 20 76 61 6c |he conve|rted val|
|00001920| 75 65 2e 0a 58 2e 54 50 | 20 31 30 0a 58 5c 66 49 |ue..X.TP| 10.X\fI|
|00001930| 70 72 6f 6d 70 74 5c 66 | 50 0a 58 54 68 65 20 73 |prompt\f|P.XThe s|
|00001940| 74 72 69 6e 67 20 75 73 | 65 64 20 77 68 65 6e 20 |tring us|ed when |
|00001950| 70 72 6f 6d 70 74 69 6e | 67 20 69 6e 74 65 72 61 |promptin|g intera|
|00001960| 63 74 69 76 65 6c 79 20 | 66 6f 72 20 61 72 67 75 |ctively |for argu|
|00001970| 6d 65 6e 74 20 76 61 6c | 75 65 73 2c 0a 58 61 6e |ment val|ues,.Xan|
|00001980| 64 20 70 72 69 6e 74 65 | 64 20 69 6e 20 75 73 61 |d printe|d in usa|
|00001990| 67 65 20 6d 65 73 73 61 | 67 65 73 2e 20 54 68 69 |ge messa|ges. Thi|
|000019a0| 73 20 73 74 72 69 6e 67 | 20 6d 61 79 20 62 65 20 |s string| may be |
|000019b0| 66 6f 6c 6c 6f 77 65 64 | 20 62 79 20 61 0a 58 74 |followed| by a.Xt|
|000019c0| 65 78 74 75 61 6c 20 64 | 65 73 63 72 69 70 74 69 |extual d|escripti|
|000019d0| 6f 6e 20 74 68 61 74 20 | 69 73 20 65 6e 63 6c 6f |on that |is enclo|
|000019e0| 73 65 64 20 69 6e 20 70 | 61 72 65 6e 74 68 65 73 |sed in p|arenthes|
|000019f0| 65 73 2c 20 73 71 75 61 | 72 65 20 62 72 61 63 6b |es, squa|re brack|
|00001a00| 65 74 73 2c 0a 58 63 75 | 72 6c 79 20 62 72 61 63 |ets,.Xcu|rly brac|
|00001a10| 65 73 2c 20 6f 72 20 61 | 6e 67 6c 65 20 62 72 61 |es, or a|ngle bra|
|00001a20| 63 6b 65 74 73 2e 0a 58 | 0a 58 54 68 65 20 70 72 |ckets..X|.XThe pr|
|00001a30| 6f 6d 70 74 2d 73 74 72 | 69 6e 67 20 6d 61 79 20 |ompt-str|ing may |
|00001a40| 62 65 20 73 70 65 63 69 | 66 65 64 0a 58 69 6e 20 |be speci|fed.Xin |
|00001a50| 74 77 6f 20 70 61 72 74 | 73 3a 20 61 20 6b 65 79 |two part|s: a key|
|00001a60| 77 6f 72 64 20 6e 61 6d | 65 20 61 6e 64 20 61 6e |word nam|e and an|
|00001a70| 20 61 72 67 75 6d 65 6e | 74 20 6e 61 6d 65 2e 20 | argumen|t name. |
|00001a80| 54 68 65 20 61 72 67 75 | 6d 65 6e 74 0a 58 6e 61 |The argu|ment.Xna|
|00001a90| 6d 65 20 6d 61 79 20 62 | 65 20 73 65 70 61 72 61 |me may b|e separa|
|00001aa0| 74 65 64 20 66 72 6f 6d | 20 74 68 65 20 6b 65 79 |ted from| the key|
|00001ab0| 77 6f 72 64 20 6e 61 6d | 65 20 62 79 20 61 20 73 |word nam|e by a s|
|00001ac0| 69 6e 67 6c 65 20 65 71 | 75 61 6c 20 73 69 67 6e |ingle eq|ual sign|
|00001ad0| 0a 58 28 27 3d 27 29 2e | 20 4e 6f 20 77 68 69 74 |.X('=').| No whit|
|00001ae0| 65 73 70 61 63 65 20 69 | 73 20 61 6c 6c 6f 77 65 |espace i|s allowe|
|00001af0| 64 20 62 65 66 6f 72 65 | 20 6f 72 20 61 66 74 65 |d before| or afte|
|00001b00| 72 20 74 68 65 20 65 71 | 75 61 6c 20 73 69 67 6e |r the eq|ual sign|
|00001b10| 2e 0a 58 0a 58 41 6c 74 | 65 72 6e 61 74 61 74 69 |..X.XAlt|ernatati|
|00001b20| 76 65 6c 79 2c 20 74 68 | 65 20 6b 65 79 77 6f 72 |vely, th|e keywor|
|00001b30| 64 20 6e 61 6d 65 20 6d | 61 79 20 62 65 20 64 69 |d name m|ay be di|
|00001b40| 73 74 69 6e 67 75 69 73 | 68 65 64 20 66 72 6f 6d |stinguis|hed from|
|00001b50| 20 74 68 65 0a 58 61 72 | 67 75 6d 65 6e 74 20 6e | the.Xar|gument n|
|00001b60| 61 6d 65 20 62 79 20 63 | 68 61 72 61 63 74 65 72 |ame by c|haracter|
|00001b70| 20 63 61 73 65 3a 20 69 | 66 20 74 68 65 20 6c 6f | case: i|f the lo|
|00001b80| 6e 67 2d 6e 61 6d 65 20 | 63 6f 6e 74 61 69 6e 73 |ng-name |contains|
|00001b90| 20 61 6e 79 0a 58 75 70 | 70 65 72 63 61 73 65 20 | any.Xup|percase |
|00001ba0| 63 68 61 72 61 63 74 65 | 72 73 2c 20 74 68 65 6e |characte|rs, then|
|00001bb0| 20 74 68 65 20 73 75 62 | 73 74 72 69 6e 67 20 6f | the sub|string o|
|00001bc0| 66 20 6c 6f 6e 67 2d 6e | 61 6d 65 20 63 6f 6e 73 |f long-n|ame cons|
|00001bd0| 69 73 74 69 6e 67 20 6f | 66 0a 58 61 6c 6c 20 75 |isting o|f.Xall u|
|00001be0| 70 70 65 72 63 61 73 65 | 20 63 68 61 72 61 63 74 |ppercase| charact|
|00001bf0| 65 72 73 20 69 73 20 75 | 73 65 64 20 61 73 20 74 |ers is u|sed as t|
|00001c00| 68 65 20 61 72 67 75 6d | 65 6e 74 20 6b 65 79 77 |he argum|ent keyw|
|00001c10| 6f 72 64 20 61 6e 64 20 | 74 68 65 0a 58 65 6e 74 |ord and |the.Xent|
|00001c20| 69 72 65 20 6c 6f 6e 67 | 2d 6e 61 6d 65 20 69 73 |ire long|-name is|
|00001c30| 20 75 73 65 64 20 61 73 | 20 74 68 65 20 6e 61 6d | used as| the nam|
|00001c40| 65 20 6f 66 20 74 68 65 | 20 61 72 67 75 6d 65 6e |e of the| argumen|
|00001c50| 74 20 28 69 66 20 61 20 | 76 61 6c 75 65 20 6d 61 |t (if a |value ma|
|00001c60| 79 0a 58 62 65 20 73 75 | 70 70 6c 69 65 64 29 2e |y.Xbe su|pplied).|
|00001c70| 20 54 68 65 20 6c 6f 6e | 67 2d 6e 61 6d 65 20 6d | The lon|g-name m|
|00001c80| 61 79 20 62 65 20 6d 61 | 74 63 68 65 64 20 62 79 |ay be ma|tched by|
|00001c90| 20 73 75 70 70 6c 79 69 | 6e 67 20 61 20 75 6e 69 | supplyi|ng a uni|
|00001ca0| 71 75 65 0a 58 70 72 65 | 66 69 78 20 6f 66 20 65 |que.Xpre|fix of e|
|00001cb0| 69 74 68 65 72 20 74 68 | 65 20 61 72 67 75 6d 65 |ither th|e argume|
|00001cc0| 6e 74 20 6b 65 79 77 6f | 72 64 20 6f 72 20 74 68 |nt keywo|rd or th|
|00001cd0| 65 20 61 72 67 75 6d 65 | 6e 74 20 6e 61 6d 65 2e |e argume|nt name.|
|00001ce0| 0a 58 2e 50 50 0a 58 54 | 68 65 20 61 72 67 75 6d |.X.PP.XT|he argum|
|00001cf0| 65 6e 74 20 73 70 65 63 | 69 66 69 63 61 74 69 6f |ent spec|ificatio|
|00001d00| 6e 20 73 74 72 69 6e 67 | 20 6d 75 73 74 20 62 65 |n string| must be|
|00001d10| 20 74 65 72 6d 69 6e 61 | 74 65 64 20 62 79 20 74 | termina|ted by t|
|00001d20| 68 65 20 73 69 6e 67 6c | 65 20 73 74 72 69 6e 67 |he singl|e string|
|00001d30| 3a 0a 58 60 60 45 4e 44 | 4f 46 41 52 47 53 27 27 |:.X``END|OFARGS''|
|00001d40| 2e 0a 58 2e 50 50 0a 58 | 4e 6f 74 65 20 74 68 61 |..X.PP.X|Note tha|
|00001d50| 74 20 74 68 65 20 63 6f | 6d 6d 61 20 63 68 61 72 |t the co|mma char|
|00001d60| 61 63 74 65 72 20 28 27 | 2c 27 29 20 69 73 20 75 |acter ('|,') is u|
|00001d70| 73 65 64 20 74 6f 20 73 | 65 70 61 72 61 74 65 20 |sed to s|eparate |
|00001d80| 61 6c 6c 20 66 69 65 6c | 64 73 0a 58 77 69 74 68 |all fiel|ds.Xwith|
|00001d90| 69 6e 20 61 6e 20 65 6e | 74 72 79 2c 20 61 6e 64 |in an en|try, and|
|00001da0| 20 74 6f 20 73 65 70 61 | 72 61 74 65 20 74 68 65 | to sepa|rate the|
|00001db0| 20 65 6e 74 72 69 65 73 | 20 74 68 65 6d 73 65 6c | entries| themsel|
|00001dc0| 76 65 73 2e 0a 58 46 6f | 72 20 74 68 69 73 20 72 |ves..XFo|r this r|
|00001dd0| 65 61 73 6f 6e 2c 20 5c | 66 49 6e 6f 20 66 69 65 |eason, \|fIno fie|
|00001de0| 6c 64 20 69 6e 20 61 6e | 79 20 65 6e 74 72 79 20 |ld in an|y entry |
|00001df0| 6d 61 79 20 63 6f 6e 74 | 61 69 6e 20 61 20 63 6f |may cont|ain a co|
|00001e00| 6d 6d 61 20 75 6e 6c 65 | 73 73 0a 58 69 74 20 61 |mma unle|ss.Xit a|
|00001e10| 70 70 65 61 72 73 20 69 | 6e 73 69 64 65 20 6f 66 |ppears i|nside of|
|00001e20| 20 64 6f 75 62 6c 65 20 | 6f 72 20 73 69 6e 67 6c | double |or singl|
|00001e30| 65 20 71 75 6f 74 65 73 | 5c 66 50 2e 0a 58 2e 50 |e quotes|\fP..X.P|
|00001e40| 50 0a 58 2e 42 20 50 61 | 72 73 65 61 72 67 73 0a |P.X.B Pa|rseargs.|
|00001e50| 58 77 69 6c 6c 20 70 61 | 72 73 65 20 61 6c 6c 20 |Xwill pa|rse all |
|00001e60| 63 6f 6d 6d 61 6e 64 2d | 6c 69 6e 65 20 61 72 67 |command-|line arg|
|00001e70| 75 6d 65 6e 74 73 20 66 | 6f 72 20 74 68 65 20 63 |uments f|or the c|
|00001e80| 61 6c 6c 69 6e 67 20 73 | 63 72 69 70 74 20 61 6e |alling s|cript an|
|00001e90| 64 20 6d 61 74 63 68 0a | 58 74 68 65 6d 20 61 67 |d match.|Xthem ag|
|00001ea0| 61 69 6e 73 74 20 74 68 | 65 20 61 72 67 75 6d 65 |ainst th|e argume|
|00001eb0| 6e 74 20 73 70 65 63 69 | 66 69 63 61 74 69 6f 6e |nt speci|fication|
|00001ec0| 20 73 74 72 69 6e 67 20 | 70 72 6f 76 69 64 65 64 | string |provided|
|00001ed0| 2e 20 54 68 65 20 61 72 | 67 75 6d 65 6e 74 0a 58 |. The ar|gument.X|
|00001ee0| 73 70 65 63 69 66 69 63 | 61 74 69 6f 6e 20 73 74 |specific|ation st|
|00001ef0| 72 69 6e 67 20 69 73 20 | 72 65 61 64 20 66 72 6f |ring is |read fro|
|00001f00| 6d 20 73 74 61 6e 64 61 | 72 64 20 69 6e 70 75 74 |m standa|rd input|
|00001f10| 20 62 79 20 64 65 66 61 | 75 6c 74 20 62 75 74 20 | by defa|ult but |
|00001f20| 6d 61 79 20 6e 6f 74 0a | 58 63 6f 6d 65 20 66 72 |may not.|Xcome fr|
|00001f30| 6f 6d 20 61 20 74 65 72 | 6d 69 6e 61 6c 2e 20 54 |om a ter|minal. T|
|00001f40| 68 65 20 61 72 67 75 6d | 65 6e 74 20 73 70 65 63 |he argum|ent spec|
|00001f50| 69 66 69 63 61 74 69 6f | 6e 20 73 74 72 69 6e 67 |ificatio|n string|
|00001f60| 20 6d 61 79 20 62 65 20 | 73 75 70 70 6c 69 65 64 | may be |supplied|
|00001f70| 20 61 73 0a 58 61 20 73 | 69 6e 67 6c 65 20 73 74 | as.Xa s|ingle st|
|00001f80| 72 69 6e 67 20 61 72 67 | 75 6d 65 6e 74 20 62 79 |ring arg|ument by|
|00001f90| 20 75 73 69 6e 67 20 74 | 68 65 20 5c 66 42 5c 2d | using t|he \fB\-|
|00001fa0| 61 5c 66 50 20 60 60 5c | 66 49 73 74 72 69 6e 67 |a\fP ``\|fIstring|
|00001fb0| 5c 66 50 27 27 20 66 6c | 61 67 2e 0a 58 4c 6f 6e |\fP'' fl|ag..XLon|
|00001fc0| 67 20 61 72 67 75 6d 65 | 6e 74 20 73 70 65 63 69 |g argume|nt speci|
|00001fd0| 66 69 63 61 74 69 6f 6e | 20 73 74 72 69 6e 67 73 |fication| strings|
|00001fe0| 20 68 6f 77 65 76 65 72 | 2c 20 6d 61 79 20 6c 69 | however|, may li|
|00001ff0| 6d 69 74 20 74 68 65 20 | 6e 75 6d 62 65 72 20 6f |mit the |number o|
|00002000| 66 20 61 72 67 75 6d 65 | 6e 74 73 0a 58 74 6f 20 |f argume|nts.Xto |
|00002010| 74 68 65 20 73 63 72 69 | 70 74 20 69 66 20 74 68 |the scri|pt if th|
|00002020| 65 72 65 20 69 73 20 61 | 20 6c 69 6d 69 74 20 74 |ere is a| limit t|
|00002030| 6f 20 74 68 65 20 6e 75 | 6d 62 65 72 20 6f 66 20 |o the nu|mber of |
|00002040| 61 72 67 75 6d 65 6e 74 | 73 20 61 6e 64 2f 6f 72 |argument|s and/or|
|00002050| 20 63 68 61 72 61 63 74 | 65 72 73 0a 58 74 68 61 | charact|ers.Xtha|
|00002060| 74 20 6d 61 79 20 61 70 | 70 65 61 72 20 6f 6e 20 |t may ap|pear on |
|00002070| 74 68 65 20 63 6f 6d 6d | 61 6e 64 20 6c 69 6e 65 |the comm|and line|
|00002080| 2e 0a 58 46 6f 72 20 74 | 68 69 73 20 72 65 61 73 |..XFor t|his reas|
|00002090| 6f 6e 2c 20 74 68 65 20 | 61 72 67 75 6d 65 6e 74 |on, the |argument|
|000020a0| 20 73 70 65 63 69 66 69 | 63 61 74 69 6f 6e 20 73 | specifi|cation s|
|000020b0| 74 72 69 6e 67 20 6d 61 | 79 20 62 65 20 73 74 6f |tring ma|y be sto|
|000020c0| 72 65 64 3a 20 69 6e 20 | 61 6e 0a 58 65 6e 76 69 |red: in |an.Xenvi|
|000020d0| 72 6f 6e 6d 65 6e 74 20 | 76 61 72 69 61 62 6c 65 |ronment |variable|
|000020e0| 20 75 73 69 6e 67 20 74 | 68 65 20 5c 66 42 5c 2d | using t|he \fB\-|
|000020f0| 65 5c 66 50 20 5c 66 49 | 6e 61 6d 65 5c 66 50 20 |e\fP \fI|name\fP |
|00002100| 6f 70 74 69 6f 6e 3b 20 | 69 6e 20 61 20 66 69 6c |option; |in a fil|
|00002110| 65 0a 58 61 6e 64 20 72 | 65 61 64 20 75 73 69 6e |e.Xand r|ead usin|
|00002120| 67 20 74 68 65 20 5c 66 | 42 5c 2d 66 5c 66 50 20 |g the \f|B\-f\fP |
|00002130| 5c 66 49 66 69 6c 65 5c | 66 50 20 6f 70 74 69 6f |\fIfile\|fP optio|
|00002140| 6e 3b 20 6f 72 20 72 65 | 61 64 20 66 72 6f 6d 20 |n; or re|ad from |
|00002150| 73 74 61 6e 64 61 72 64 | 20 69 6e 70 75 74 2e 0a |standard| input..|
|00002160| 58 57 68 65 6e 20 75 73 | 69 6e 67 20 74 68 65 20 |XWhen us|ing the |
|00002170| 5c 66 42 5c 2d 65 5c 66 | 50 20 6f 70 74 69 6f 6e |\fB\-e\f|P option|
|00002180| 2c 20 74 68 65 20 75 73 | 65 72 20 6d 75 73 74 20 |, the us|er must |
|00002190| 72 65 6d 65 6d 62 65 72 | 20 74 6f 20 75 73 65 20 |remember| to use |
|000021a0| 74 68 65 20 6e 61 6d 65 | 0a 58 6f 66 20 61 6e 20 |the name|.Xof an |
|000021b0| 65 6e 76 69 72 6f 6e 6d | 65 6e 74 20 76 61 72 69 |environm|ent vari|
|000021c0| 61 62 6c 65 20 28 6e 6f | 74 20 61 20 6d 65 72 65 |able (no|t a mere|
|000021d0| 20 73 68 65 6c 6c 20 76 | 61 72 69 61 62 6c 65 29 | shell v|ariable)|
|000021e0| 21 0a 58 54 68 65 20 64 | 65 66 61 75 6c 74 20 62 |!.XThe d|efault b|
|000021f0| 65 68 61 76 69 6f 72 20 | 69 73 20 74 6f 20 72 65 |ehavior |is to re|
|00002200| 61 64 20 74 68 65 20 61 | 72 67 75 6d 65 6e 74 20 |ad the a|rgument |
|00002210| 73 70 65 63 69 66 69 63 | 61 74 69 6f 6e 20 66 72 |specific|ation fr|
|00002220| 6f 6d 20 73 74 61 6e 64 | 61 72 64 20 69 6e 70 75 |om stand|ard inpu|
|00002230| 74 2e 0a 58 2e 5c 22 2d | 2d 2d 2d 2d 2d 2d 2d 2d |t..X.\"-|--------|
|00002240| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00002250| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00002260| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00002270| 2d 2d 0a 58 2e 73 6f 20 | 73 68 65 6c 6c 73 2e 69 |--.X.so |shells.i|
|00002280| 6e 63 0a 58 2e 5c 22 2d | 2d 2d 2d 2d 2d 2d 2d 2d |nc.X.\"-|--------|
|00002290| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000022a0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000022b0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000022c0| 2d 2d 0a 58 2e 50 50 0a | 58 54 68 65 20 64 6f 75 |--.X.PP.|XThe dou|
|000022d0| 62 6c 65 2d 64 61 73 68 | 20 28 60 60 5c 66 42 5c |ble-dash| (``\fB\|
|000022e0| 2d 5c 5e 5c 2d 5c 66 50 | 27 27 29 20 77 68 69 63 |-\^\-\fP|'') whic|
|000022f0| 68 20 70 72 65 63 65 64 | 65 73 20 74 68 65 20 6e |h preced|es the n|
|00002300| 61 6d 65 20 61 6e 64 20 | 61 72 67 75 6d 65 6e 74 |ame and |argument|
|00002310| 73 20 6f 66 0a 58 74 68 | 65 20 63 61 6c 6c 69 6e |s of.Xth|e callin|
|00002320| 67 20 70 72 6f 67 72 61 | 6d 20 69 73 20 6e 65 65 |g progra|m is nee|
|00002330| 64 65 64 20 69 6e 20 6f | 72 64 65 72 20 66 6f 72 |ded in o|rder for|
|00002340| 20 5c 66 42 70 61 72 73 | 65 61 72 67 73 5c 66 50 | \fBpars|eargs\fP|
|00002350| 20 74 6f 20 62 65 20 61 | 62 6c 65 20 74 6f 0a 58 | to be a|ble to.X|
|00002360| 64 69 73 74 69 6e 67 75 | 69 73 68 20 6f 70 74 69 |distingu|ish opti|
|00002370| 6f 6e 73 20 74 6f 20 69 | 74 73 65 6c 66 20 66 72 |ons to i|tself fr|
|00002380| 6f 6d 20 6f 70 74 69 6f | 6e 73 20 66 6f 72 20 74 |om optio|ns for t|
|00002390| 68 65 20 63 61 6c 6c 69 | 6e 67 20 70 72 6f 67 72 |he calli|ng progr|
|000023a0| 61 6d 2e 0a 58 2e 50 50 | 0a 58 54 68 65 20 64 65 |am..X.PP|.XThe de|
|000023b0| 66 61 75 6c 74 20 62 65 | 68 61 76 69 6f 72 20 6f |fault be|havior o|
|000023c0| 66 20 70 61 72 73 65 61 | 72 67 73 20 69 73 20 74 |f parsea|rgs is t|
|000023d0| 6f 20 61 6c 6c 6f 77 20 | 62 6f 74 68 20 73 69 6e |o allow |both sin|
|000023e0| 67 6c 65 2d 63 68 61 72 | 61 63 74 65 72 20 6f 70 |gle-char|acter op|
|000023f0| 74 69 6f 6e 73 20 61 6e | 64 0a 58 6c 6f 6e 67 2d |tions an|d.Xlong-|
|00002400| 6f 70 74 69 6f 6e 73 20 | 28 6b 65 79 77 6f 72 64 |options |(keyword|
|00002410| 73 29 20 6f 6e 20 74 68 | 65 20 63 6f 6d 6d 61 6e |s) on th|e comman|
|00002420| 64 2d 6c 69 6e 65 2e 20 | 54 68 65 20 75 73 65 72 |d-line. |The user|
|00002430| 20 6d 61 79 20 73 70 65 | 63 69 66 79 20 74 68 61 | may spe|cify tha|
|00002440| 74 20 6f 6e 6c 79 0a 58 | 6f 70 74 69 6f 6e 73 20 |t only.X|options |
|00002450| 28 6c 6f 6e 67 2d 6f 70 | 74 69 6f 6e 73 29 20 61 |(long-op|tions) a|
|00002460| 72 65 20 74 6f 20 62 65 | 20 70 65 72 6d 69 74 74 |re to be| permitt|
|00002470| 65 64 20 62 79 20 73 70 | 65 63 69 66 79 69 6e 67 |ed by sp|ecifying|
|00002480| 20 74 68 65 20 5c 66 42 | 5c 2d 6f 5c 66 50 0a 58 | the \fB|\-o\fP.X|
|00002490| 28 5c 66 42 5c 2d 6c 5c | 66 50 29 20 6f 70 74 69 |(\fB\-l\|fP) opti|
|000024a0| 6f 6e 20 6f 6e 20 74 68 | 65 20 63 6f 6d 6d 61 6e |on on th|e comman|
|000024b0| 64 2d 6c 69 6e 65 2e 0a | 58 2e 5c 22 2d 2d 2d 2d |d-line..|X.\"----|
|000024c0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000024d0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000024e0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000024f0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 0a 58 2e 53 |--------|----.X.S|
|00002500| 48 20 22 53 50 45 43 49 | 46 59 49 4e 47 20 50 41 |H "SPECI|FYING PA|
|00002510| 52 53 45 2d 42 45 48 41 | 56 49 4f 52 22 0a 58 2e |RSE-BEHA|VIOR".X.|
|00002520| 50 50 0a 58 54 68 65 20 | 5c 66 42 5c 2d 43 5c 66 |PP.XThe |\fB\-C\f|
|00002530| 50 2c 20 5c 66 42 5c 2d | 70 5c 66 50 2c 20 5c 66 |P, \fB\-|p\fP, \f|
|00002540| 42 5c 2d 69 5c 66 50 2c | 20 61 6e 64 20 5c 66 42 |B\-i\fP,| and \fB|
|00002550| 5c 2d 31 5c 66 50 20 73 | 77 69 74 63 68 65 73 20 |\-1\fP s|witches |
|00002560| 6d 61 79 20 62 65 20 75 | 73 65 64 20 74 6f 0a 58 |may be u|sed to.X|
|00002570| 6d 6f 64 69 66 79 20 74 | 68 65 20 63 6f 6d 6d 61 |modify t|he comma|
|00002580| 6e 64 2d 6c 69 6e 65 20 | 70 61 72 73 69 6e 67 20 |nd-line |parsing |
|00002590| 62 65 68 61 76 69 6f 72 | 20 6f 66 20 74 68 65 20 |behavior| of the |
|000025a0| 69 6e 76 6f 6b 69 6e 67 | 20 73 63 72 69 70 74 2e |invoking| script.|
|000025b0| 20 53 70 65 63 69 66 79 | 69 6e 67 0a 58 5c 66 42 | Specify|ing.X\fB|
|000025c0| 5c 2d 43 5c 66 50 20 77 | 69 6c 6c 20 63 61 75 73 |\-C\fP w|ill caus|
|000025d0| 65 20 63 61 73 65 2d 64 | 69 66 66 65 72 65 6e 63 |e case-d|ifferenc|
|000025e0| 65 73 20 69 6e 20 73 69 | 6e 67 6c 65 2d 63 68 61 |es in si|ngle-cha|
|000025f0| 72 61 63 74 65 72 20 6f | 70 74 69 6f 6e 73 20 74 |racter o|ptions t|
|00002600| 6f 20 62 65 0a 58 69 67 | 6e 6f 72 65 64 2e 20 53 |o be.Xig|nored. S|
|00002610| 70 65 63 69 66 79 69 6e | 67 20 5c 66 42 5c 2d 70 |pecifyin|g \fB\-p|
|00002620| 5c 66 50 20 77 69 6c 6c | 20 63 61 75 73 65 20 74 |\fP will| cause t|
|00002630| 68 65 20 75 73 65 72 20 | 74 6f 20 62 65 20 69 6e |he user |to be in|
|00002640| 74 65 72 61 63 74 69 76 | 65 6c 79 20 70 72 6f 6d |teractiv|ely prom|
|00002650| 70 74 65 64 0a 58 66 6f | 72 20 61 6e 79 20 6d 69 |pted.Xfo|r any mi|
|00002660| 73 73 69 6e 67 20 72 65 | 71 75 69 72 65 64 20 61 |ssing re|quired a|
|00002670| 72 67 75 6d 65 6e 74 73 | 2e 20 53 70 65 63 69 66 |rguments|. Specif|
|00002680| 79 69 6e 67 20 5c 66 42 | 5c 2d 69 5c 66 50 20 77 |ying \fB|\-i\fP w|
|00002690| 69 6c 6c 20 63 61 75 73 | 65 0a 58 73 79 6e 74 61 |ill caus|e.Xsynta|
|000026a0| 63 74 69 63 61 6c 6c 79 | 20 69 6e 63 6f 72 72 65 |ctically| incorre|
|000026b0| 63 74 20 61 72 67 75 6d | 65 6e 74 73 20 74 6f 20 |ct argum|ents to |
|000026c0| 62 65 20 69 67 6e 6f 72 | 65 64 20 28 69 6e 73 74 |be ignor|ed (inst|
|000026d0| 65 61 64 20 6f 66 20 68 | 61 76 69 6e 67 20 61 20 |ead of h|aving a |
|000026e0| 75 73 61 67 65 0a 58 6d | 65 73 73 61 67 65 20 70 |usage.Xm|essage p|
|000026f0| 72 69 6e 74 65 64 20 61 | 6e 64 20 65 78 65 63 75 |rinted a|nd execu|
|00002700| 74 69 6f 6e 20 74 65 72 | 6d 69 6e 61 74 65 64 29 |tion ter|minated)|
|00002710| 2e 20 53 70 65 63 69 66 | 79 69 6e 67 20 5c 66 42 |. Specif|ying \fB|
|00002720| 5c 2d 31 5c 66 50 20 77 | 69 6c 6c 20 66 6f 72 63 |\-1\fP w|ill forc|
|00002730| 65 0a 58 61 6c 6c 20 6e | 6f 6e 2d 70 6f 73 69 74 |e.Xall n|on-posit|
|00002740| 69 6f 6e 61 6c 20 70 61 | 72 61 6d 65 74 65 72 73 |ional pa|rameters|
|00002750| 20 74 6f 20 70 72 65 63 | 65 64 65 20 61 6e 79 20 | to prec|ede any |
|00002760| 70 6f 73 69 74 69 6f 6e | 61 6c 20 70 61 72 61 6d |position|al param|
|00002770| 65 74 65 72 73 20 6f 6e | 20 74 68 65 0a 58 63 6f |eters on| the.Xco|
|00002780| 6d 6d 61 6e 64 2d 6c 69 | 6e 65 20 28 68 65 6e 63 |mmand-li|ne (henc|
|00002790| 65 20 61 6e 79 74 68 69 | 6e 67 20 6f 6e 20 74 68 |e anythi|ng on th|
|000027a0| 65 20 63 6f 6d 6d 61 6e | 64 2d 6c 69 6e 65 20 61 |e comman|d-line a|
|000027b0| 66 74 65 72 20 61 20 70 | 6f 73 69 74 69 6f 6e 61 |fter a p|ositiona|
|000027c0| 6c 20 70 61 72 61 6d 65 | 74 65 72 0a 58 74 68 61 |l parame|ter.Xtha|
|000027d0| 74 20 72 65 73 65 6d 62 | 6c 65 73 20 61 20 6b 65 |t resemb|les a ke|
|000027e0| 79 77 6f 72 64 20 70 61 | 72 61 6d 65 74 65 72 20 |yword pa|rameter |
|000027f0| 77 69 6c 6c 20 6e 65 76 | 65 72 74 68 65 6c 65 73 |will nev|ertheles|
|00002800| 73 20 62 65 20 69 6e 74 | 65 72 70 72 65 74 65 64 |s be int|erpreted|
|00002810| 20 61 73 20 61 0a 58 70 | 6f 73 69 74 69 6f 6e 61 | as a.Xp|ositiona|
|00002820| 6c 20 70 61 72 61 6d 65 | 74 65 72 29 2e 0a 58 2e |l parame|ter)..X.|
|00002830| 5c 22 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |\"------|--------|
|00002840| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00002850| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00002860| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00002870| 2d 2d 0a 58 2e 73 6f 20 | 61 72 67 76 61 6c 6f 70 |--.X.so |argvalop|
|00002880| 74 2e 69 6e 63 0a 58 2e | 5c 22 2d 2d 2d 2d 2d 2d |t.inc.X.|\"------|
|00002890| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000028a0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000028b0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000028c0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 0a 58 2e 73 6f 20 |--------|--.X.so |
|000028d0| 73 68 5f 61 72 72 61 79 | 73 2e 69 6e 63 0a 58 2e |sh_array|s.inc.X.|
|000028e0| 5c 22 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |\"------|--------|
|000028f0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00002900| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00002910| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00002920| 2d 2d 0a 58 2e 73 6f 20 | 65 6e 76 5f 61 72 67 73 |--.X.so |env_args|
|00002930| 2e 69 6e 63 0a 58 2e 5c | 22 2d 2d 2d 2d 2d 2d 2d |.inc.X.\|"-------|
|00002940| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00002950| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00002960| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00002970| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 0a 58 2e 73 6f 20 65 |--------|-.X.so e|
|00002980| 6e 76 5f 70 61 72 73 65 | 2e 69 6e 63 0a 58 2e 5c |nv_parse|.inc.X.\|
|00002990| 22 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |"-------|--------|
|000029a0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000029b0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000029c0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000029d0| 2d 0a 58 2e 73 6f 20 65 | 6e 76 5f 75 73 61 67 65 |-.X.so e|nv_usage|
|000029e0| 2e 69 6e 63 0a 58 2e 5c | 22 2d 2d 2d 2d 2d 2d 2d |.inc.X.\|"-------|
|000029f0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00002a00| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00002a10| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00002a20| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 0a 58 2e 53 48 20 45 |--------|-.X.SH E|
|00002a30| 58 41 4d 50 4c 45 53 0a | 58 2e 50 50 0a 58 41 73 |XAMPLES.|X.PP.XAs|
|00002a40| 20 61 20 66 69 72 73 74 | 20 65 78 61 6d 70 6c 65 | a first| example|
|00002a50| 2c 20 63 6f 6e 73 69 64 | 65 72 20 74 68 65 20 66 |, consid|er the f|
|00002a60| 6f 6c 6c 6f 77 69 6e 67 | 20 61 72 67 75 6d 65 6e |ollowing| argumen|
|00002a70| 74 20 73 70 65 63 69 66 | 69 63 61 74 69 6f 6e 20 |t specif|ication |
|00002a80| 66 6f 72 20 61 0a 58 42 | 6f 75 72 6e 65 20 73 68 |for a.XB|ourne sh|
|00002a90| 65 6c 6c 20 73 63 72 69 | 70 74 3a 0a 58 2e 50 50 |ell scri|pt:.X.PP|
|00002aa0| 0a 58 2e 6e 66 0a 58 2e | 5c 22 20 2a 2a 2a 20 66 |.X.nf.X.|\" *** f|
|00002ab0| 6f 6e 74 20 34 20 69 73 | 20 74 68 65 20 22 74 79 |ont 4 is| the "ty|
|00002ac0| 70 65 77 72 69 74 65 72 | 2d 73 74 79 6c 65 22 20 |pewriter|-style" |
|00002ad0| 6e 6f 6e 2d 70 72 6f 70 | 6f 72 74 69 6f 6e 61 6c |non-prop|ortional|
|00002ae0| 20 66 6f 6e 74 20 6f 6e | 20 6d 79 20 6d 61 63 68 | font on| my mach|
|00002af0| 69 6e 65 20 2a 2a 2a 0a | 58 2e 66 74 20 34 0a 58 |ine ***.|X.ft 4.X|
|00002b00| 2e 73 70 20 38 70 0a 58 | 23 21 2f 62 69 6e 2f 73 |.sp 8p.X|#!/bin/s|
|00002b10| 68 0a 58 2e 73 70 20 38 | 70 0a 58 52 65 70 43 6f |h.X.sp 8|p.XRepCo|
|00002b20| 75 6e 74 3d 32 3b 0a 58 | 56 65 72 62 6f 73 65 3d |unt=2;.X|Verbose=|
|00002b30| 22 22 3b 0a 58 2e 73 70 | 20 38 70 0a 58 41 52 47 |"";.X.sp| 8p.XARG|
|00002b40| 53 50 45 43 3d 22 0a 58 | 20 20 20 20 27 63 27 2c |SPEC=".X| 'c',|
|00002b50| 20 41 52 47 4f 50 54 2c | 20 20 20 20 20 20 20 20 | ARGOPT,| |
|00002b60| 20 61 72 67 49 6e 74 2c | 20 20 52 65 70 43 6f 75 | argInt,| RepCou|
|00002b70| 6e 74 2c 20 27 63 6f 75 | 6e 74 20 7b 23 20 74 69 |nt, 'cou|nt {# ti|
|00002b80| 6d 65 73 20 74 6f 20 72 | 65 70 65 61 74 7d 27 2c |mes to r|epeat}',|
|00002b90| 0a 58 20 20 20 20 27 76 | 27 2c 20 41 52 47 4f 50 |.X 'v|', ARGOP|
|00002ba0| 54 2c 20 20 20 20 20 20 | 20 20 20 61 72 67 42 6f |T, | argBo|
|00002bb0| 6f 6c 2c 20 56 65 72 62 | 6f 73 65 2c 20 20 27 76 |ol, Verb|ose, 'v|
|00002bc0| 65 72 62 6f 73 65 20 7b | 74 75 72 6e 20 6f 6e 20 |erbose {|turn on |
|00002bd0| 76 65 72 62 6f 73 65 20 | 6d 6f 64 65 7d 27 2c 0a |verbose |mode}',.|
|00002be0| 58 20 20 20 20 27 20 27 | 2c 20 41 52 47 52 45 51 |X ' '|, ARGREQ|
|00002bf0| 2c 20 20 20 20 20 20 20 | 20 20 61 72 67 53 74 72 |, | argStr|
|00002c00| 2c 20 20 49 6e 46 69 6c | 65 2c 20 20 20 27 69 6e |, InFil|e, 'in|
|00002c10| 70 75 74 20 7b 66 69 6c | 65 20 74 6f 20 72 65 61 |put {fil|e to rea|
|00002c20| 64 20 66 72 6f 6d 7d 27 | 2c 0a 58 20 20 20 20 27 |d from}'|,.X '|
|00002c30| 20 27 2c 20 41 52 47 4f | 50 54 2c 20 20 20 20 20 | ', ARGO|PT, |
|00002c40| 20 20 20 20 61 72 67 53 | 74 72 2c 20 20 4f 75 74 | argS|tr, Out|
|00002c50| 46 69 6c 65 2c 20 20 27 | 6f 75 74 70 75 74 20 7b |File, '|output {|
|00002c60| 66 69 6c 65 20 74 6f 20 | 77 72 69 74 65 20 74 6f |file to |write to|
|00002c70| 7d 27 2c 0a 58 20 20 20 | 20 27 58 27 2c 20 41 52 |}',.X | 'X', AR|
|00002c80| 47 48 49 44 44 45 4e 2c | 20 20 20 20 20 20 61 72 |GHIDDEN,| ar|
|00002c90| 67 42 6f 6f 6c 2c 20 58 | 52 61 74 65 64 2c 20 20 |gBool, X|Rated, |
|00002ca0| 20 27 78 72 61 74 65 64 | 20 7b 6e 61 75 67 68 74 | 'xrated| {naught|
|00002cb0| 79 21 20 6e 61 75 67 68 | 74 79 21 7d 27 2c 0a 58 |y! naugh|ty!}',.X|
|00002cc0| 20 20 20 20 27 20 27 2c | 20 41 52 47 4f 50 54 7c | ' ',| ARGOPT||
|00002cd0| 41 52 47 4c 49 53 54 2c | 20 6c 69 73 74 53 74 72 |ARGLIST,| listStr|
|00002ce0| 2c 20 46 69 6c 65 73 2c | 20 20 20 20 27 66 69 6c |, Files,| 'fil|
|00002cf0| 65 73 20 7b 66 69 6c 65 | 73 20 74 6f 20 70 72 6f |es {file|s to pro|
|00002d00| 63 65 73 73 7d 27 2c 0a | 58 45 4e 44 4f 46 41 52 |cess}',.|XENDOFAR|
|00002d10| 47 53 0a 58 22 0a 58 2e | 73 70 20 38 70 0a 58 65 |GS.X".X.|sp 8p.Xe|
|00002d20| 76 61 6c 20 60 65 63 68 | 6f 20 22 24 41 52 47 53 |val `ech|o "$ARGS|
|00002d30| 50 45 43 22 20 7c 20 70 | 61 72 73 65 61 72 67 73 |PEC" | p|arseargs|
|00002d40| 20 5c 2d 73 20 73 68 20 | 5c 2d 5c 7c 5c 2d 20 24 | \-s sh |\-\|\- $|
|00002d50| 30 20 22 24 40 22 60 0a | 58 2e 73 70 20 38 70 0a |0 "$@"`.|X.sp 8p.|
|00002d60| 58 2e 66 74 20 52 0a 58 | 2e 66 69 0a 58 2e 50 50 |X.ft R.X|.fi.X.PP|
|00002d70| 0a 58 54 68 69 73 20 64 | 65 73 63 72 69 62 65 73 |.XThis d|escribes|
|00002d80| 20 61 20 42 6f 75 72 6e | 65 20 73 68 65 6c 6c 20 | a Bourn|e shell |
|00002d90| 73 63 72 69 70 74 20 61 | 63 63 65 70 74 69 6e 67 |script a|ccepting|
|00002da0| 20 75 70 20 74 6f 20 74 | 68 72 65 65 20 66 6c 61 | up to t|hree fla|
|00002db0| 67 20 61 72 67 75 6d 65 | 6e 74 73 20 61 6e 64 0a |g argume|nts and.|
|00002dc0| 58 6f 6e 65 20 6f 72 20 | 74 77 6f 20 70 6f 73 69 |Xone or |two posi|
|00002dd0| 74 69 6f 6e 61 6c 20 61 | 72 67 75 6d 65 6e 74 73 |tional a|rguments|
|00002de0| 2c 20 70 6c 75 73 20 61 | 20 6c 69 73 74 20 6f 66 |, plus a| list of|
|00002df0| 20 61 64 64 69 74 69 6f | 6e 61 6c 20 66 69 6c 65 | additio|nal file|
|00002e00| 20 61 72 67 75 6d 65 6e | 74 73 2e 0a 58 4f 6e 6c | argumen|ts..XOnl|
|00002e10| 79 20 74 68 65 20 66 69 | 72 73 74 20 70 6f 73 69 |y the fi|rst posi|
|00002e20| 74 69 6f 6e 61 6c 20 61 | 72 67 75 6d 65 6e 74 20 |tional a|rgument |
|00002e30| 69 73 20 72 65 71 75 69 | 72 65 64 2e 0a 58 54 68 |is requi|red..XTh|
|00002e40| 65 20 70 6f 73 73 69 62 | 6c 65 20 66 6c 61 67 73 |e possib|le flags|
|00002e50| 20 28 69 6e 20 55 4e 49 | 58 29 20 61 72 65 3a 0a | (in UNI|X) are:.|
|00002e60| 58 2e 52 53 0a 58 2e 54 | 50 20 31 30 0a 58 5c 66 |X.RS.X.T|P 10.X\f|
|00002e70| 42 5c 2d 63 5c 66 50 20 | 5c 66 49 63 6f 75 6e 74 |B\-c\fP |\fIcount|
|00002e80| 5c 66 50 0a 58 41 6e 20 | 69 6e 74 65 67 65 72 20 |\fP.XAn |integer |
|00002e90| 72 65 70 65 74 69 74 69 | 6f 6e 20 63 6f 75 6e 74 |repetiti|on count|
|00002ea0| 2e 0a 58 54 68 69 73 20 | 64 65 66 61 75 6c 74 73 |..XThis |defaults|
|00002eb0| 20 74 6f 20 74 77 6f 2e | 0a 58 2e 54 50 20 31 30 | to two.|.X.TP 10|
|00002ec0| 0a 58 5c 66 42 5c 2d 76 | 5c 66 50 0a 58 41 20 42 |.X\fB\-v|\fP.XA B|
|00002ed0| 6f 6f 6c 65 61 6e 20 60 | 60 76 65 72 62 6f 73 65 |oolean `|`verbose|
|00002ee0| 27 27 20 66 6c 61 67 2e | 0a 58 49 74 20 64 65 66 |'' flag.|.XIt def|
|00002ef0| 61 75 6c 74 73 20 74 6f | 20 5c 73 2d 31 46 41 4c |aults to| \s-1FAL|
|00002f00| 53 45 5c 73 2b 31 20 28 | 61 6e 20 65 6d 70 74 79 |SE\s+1 (|an empty|
|00002f10| 20 73 74 72 69 6e 67 29 | 2e 0a 58 2e 54 50 20 31 | string)|..X.TP 1|
|00002f20| 30 0a 58 5c 66 42 5c 2d | 58 5c 66 50 0a 58 41 20 |0.X\fB\-|X\fP.XA |
|00002f30| 42 6f 6f 6c 65 61 6e 20 | 60 60 58 20 52 61 74 65 |Boolean |``X Rate|
|00002f40| 64 27 27 20 66 6c 61 67 | 2e 0a 58 54 68 69 73 20 |d'' flag|..XThis |
|00002f50| 69 73 20 6e 6f 74 20 70 | 72 69 6e 74 65 64 20 69 |is not p|rinted i|
|00002f60| 6e 20 74 68 65 20 75 73 | 61 67 65 20 6d 65 73 73 |n the us|age mess|
|00002f70| 61 67 65 2e 0a 58 2e 52 | 45 0a 58 2e 50 50 0a 58 |age..X.R|E.X.PP.X|
|00002f80| 54 68 65 20 74 77 6f 20 | 70 6f 73 69 74 69 6f 6e |The two |position|
|00002f90| 61 6c 20 61 72 67 75 6d | 65 6e 74 73 20 61 72 65 |al argum|ents are|
|00002fa0| 20 62 6f 74 68 20 73 74 | 72 69 6e 67 73 2c 20 61 | both st|rings, a|
|00002fb0| 73 20 69 73 20 74 68 65 | 20 66 69 6e 61 6c 20 6c |s is the| final l|
|00002fc0| 69 73 74 2e 0a 58 49 66 | 20 77 65 20 77 65 72 65 |ist..XIf| we were|
|00002fd0| 20 74 6f 20 69 6e 76 6f | 6b 65 20 74 68 65 20 61 | to invo|ke the a|
|00002fe0| 62 6f 76 65 20 73 63 72 | 69 70 74 20 77 69 74 68 |bove scr|ipt with|
|00002ff0| 20 74 68 65 20 66 6f 6c | 6c 6f 77 69 6e 67 20 63 | the fol|lowing c|
|00003000| 6f 6d 6d 61 6e 64 20 6c | 69 6e 65 3a 0a 58 2e 73 |ommand l|ine:.X.s|
|00003010| 70 20 38 70 0a 58 2e 52 | 53 0a 58 5c 66 34 63 6d |p 8p.X.R|S.X\f4cm|
|00003020| 64 6e 61 6d 65 20 20 5c | 2d 76 20 20 69 6e 70 75 |dname \|-v inpu|
|00003030| 74 5f 66 69 6c 65 20 20 | 6f 75 74 70 75 74 5f 66 |t_file |output_f|
|00003040| 69 6c 65 20 20 66 69 6c | 65 31 20 20 66 69 6c 65 |ile fil|e1 file|
|00003050| 32 5c 66 50 0a 58 2e 52 | 45 0a 58 2e 73 70 20 38 |2\fP.X.R|E.X.sp 8|
|00003060| 70 0a 58 54 68 65 6e 2c | 20 61 66 74 65 72 20 69 |p.XThen,| after i|
|00003070| 6e 76 6f 6b 69 6e 67 20 | 5c 66 42 70 61 72 73 65 |nvoking |\fBparse|
|00003080| 61 72 67 73 5c 66 50 2c | 20 74 68 65 20 66 6f 6c |args\fP,| the fol|
|00003090| 6c 6f 77 69 6e 67 20 73 | 68 65 6c 6c 20 76 61 72 |lowing s|hell var|
|000030a0| 69 61 62 6c 65 73 20 77 | 6f 75 6c 64 0a 58 63 6f |iables w|ould.Xco|
|000030b0| 6e 74 61 69 6e 20 74 68 | 65 20 66 6f 6c 6c 6f 77 |ntain th|e follow|
|000030c0| 69 6e 67 20 76 61 6c 75 | 65 73 3a 0a 58 2e 73 70 |ing valu|es:.X.sp|
|000030d0| 20 38 70 0a 58 2e 52 53 | 0a 58 5c 66 34 24 52 65 | 8p.X.RS|.X\f4$Re|
|000030e0| 70 43 6f 75 6e 74 5c 66 | 50 20 77 6f 75 6c 64 20 |pCount\f|P would |
|000030f0| 65 76 61 6c 75 61 74 65 | 20 74 6f 20 60 60 5c 66 |evaluate| to ``\f|
|00003100| 34 32 5c 66 50 5c 5e 27 | 27 0a 58 2e 73 70 20 34 |42\fP\^'|'.X.sp 4|
|00003110| 70 0a 58 5c 66 34 24 56 | 65 72 62 6f 73 65 5c 66 |p.X\f4$V|erbose\f|
|00003120| 50 20 77 6f 75 6c 64 20 | 65 76 61 6c 75 61 74 65 |P would |evaluate|
|00003130| 20 74 6f 20 60 60 5c 66 | 34 5c 73 2d 31 54 52 55 | to ``\f|4\s-1TRU|
|00003140| 45 5c 73 2b 31 5c 66 50 | 5c 5e 27 27 0a 58 2e 73 |E\s+1\fP|\^''.X.s|
|00003150| 70 20 34 70 0a 58 5c 66 | 34 24 49 6e 46 69 6c 65 |p 4p.X\f|4$InFile|
|00003160| 5c 66 50 20 77 6f 75 6c | 64 20 65 76 61 6c 75 61 |\fP woul|d evalua|
|00003170| 74 65 20 74 6f 20 60 60 | 5c 66 34 69 6e 70 75 74 |te to ``|\f4input|
|00003180| 5f 66 69 6c 65 5c 66 50 | 5c 5e 27 27 0a 58 2e 73 |_file\fP|\^''.X.s|
|00003190| 70 20 34 70 0a 58 5c 66 | 34 24 4f 75 74 46 69 6c |p 4p.X\f|4$OutFil|
|000031a0| 65 5c 66 50 20 77 6f 75 | 6c 64 20 65 76 61 6c 75 |e\fP wou|ld evalu|
|000031b0| 61 74 65 20 74 6f 20 60 | 60 5c 66 34 6f 75 74 70 |ate to `|`\f4outp|
|000031c0| 75 74 5f 66 69 6c 65 27 | 5c 66 50 5c 5e 27 0a 58 |ut_file'|\fP\^'.X|
|000031d0| 2e 73 70 20 34 70 0a 58 | 5c 66 34 24 46 69 6c 65 |.sp 4p.X|\f4$File|
|000031e0| 73 5c 66 50 20 77 6f 75 | 6c 64 20 65 76 61 6c 75 |s\fP wou|ld evalu|
|000031f0| 61 74 65 20 74 6f 20 60 | 60 5c 66 34 66 69 6c 65 |ate to `|`\f4file|
|00003200| 31 20 20 66 69 6c 65 32 | 5c 66 50 5c 5e 27 27 0a |1 file2|\fP\^''.|
|00003210| 58 2e 73 70 20 34 70 0a | 58 5c 66 34 24 58 52 61 |X.sp 4p.|X\f4$XRa|
|00003220| 74 65 64 5c 66 50 20 77 | 6f 75 6c 64 20 62 65 20 |ted\fP w|ould be |
|00003230| 75 6e 73 65 74 20 61 6e | 64 20 77 6f 75 6c 64 20 |unset an|d would |
|00003240| 65 76 61 6c 75 61 74 65 | 20 74 6f 20 61 6e 20 65 |evaluate| to an e|
|00003250| 6d 70 74 79 20 73 74 72 | 69 6e 67 20 28 60 60 5c |mpty str|ing (``\|
|00003260| 5e 27 27 29 2e 0a 58 2e | 52 45 0a 58 2e 73 70 0a |^'')..X.|RE.X.sp.|
|00003270| 58 2e 50 50 0a 58 4e 6f | 77 20 6c 65 74 27 73 20 |X.PP.XNo|w let's |
|00003280| 70 72 65 73 65 6e 74 20 | 61 20 6d 6f 72 65 20 63 |present |a more c|
|00003290| 6f 6d 70 6c 65 74 65 20 | 65 78 61 6d 70 6c 65 2e |omplete |example.|
|000032a0| 20 54 68 65 20 66 6f 6c | 6c 6f 77 69 6e 67 20 70 | The fol|lowing p|
|000032b0| 61 67 65 20 73 68 6f 77 | 73 20 61 0a 58 42 6f 75 |age show|s a.XBou|
|000032c0| 72 6e 65 20 73 68 65 6c | 6c 20 73 63 72 69 70 74 |rne shel|l script|
|000032d0| 20 77 68 69 63 68 20 75 | 73 65 73 20 5c 66 42 70 | which u|ses \fBp|
|000032e0| 61 72 73 65 61 72 67 73 | 5c 66 50 20 74 6f 20 70 |arseargs|\fP to p|
|000032f0| 61 72 73 65 20 69 74 73 | 20 63 6f 6d 6d 61 6e 64 |arse its| command|
|00003300| 20 6c 69 6e 65 2c 0a 58 | 65 63 68 6f 65 73 20 74 | line,.X|echoes t|
|00003310| 68 65 20 73 65 74 74 69 | 6e 67 73 20 6f 66 20 61 |he setti|ngs of a|
|00003320| 6c 6c 20 69 74 73 20 61 | 73 73 6f 63 69 61 74 65 |ll its a|ssociate|
|00003330| 64 20 63 6f 6d 6d 61 6e | 64 20 6c 69 6e 65 20 76 |d comman|d line v|
|00003340| 61 72 69 61 62 6c 65 73 | 2c 20 61 6e 64 0a 58 74 |ariables|, and.Xt|
|00003350| 68 65 6e 20 70 72 69 6e | 74 73 20 69 74 73 20 63 |hen prin|ts its c|
|00003360| 6f 6d 6d 61 6e 64 20 75 | 73 61 67 65 2e 0a 58 0a |ommand u|sage..X.|
|00003370| 58 2e 6e 66 0a 58 2e 5c | 22 20 2a 2a 2a 20 66 6f |X.nf.X.\|" *** fo|
|00003380| 6e 74 20 34 20 69 73 20 | 74 68 65 20 22 74 79 70 |nt 4 is |the "typ|
|00003390| 65 77 72 69 74 65 72 2d | 73 74 79 6c 65 22 20 6e |ewriter-|style" n|
|000033a0| 6f 6e 2d 70 72 6f 70 6f | 72 74 69 6f 6e 61 6c 20 |on-propo|rtional |
|000033b0| 66 6f 6e 74 20 6f 6e 20 | 6d 79 20 6d 61 63 68 69 |font on |my machi|
|000033c0| 6e 65 20 2a 2a 2a 0a 58 | 2e 66 74 20 34 0a 58 2e |ne ***.X|.ft 4.X.|
|000033d0| 73 6f 20 2e 2e 2f 74 65 | 73 74 2e 73 68 0a 58 2e |so ../te|st.sh.X.|
|000033e0| 66 74 20 52 0a 58 2e 66 | 69 0a 58 2e 5c 22 2d 2d |ft R.X.f|i.X.\"--|
|000033f0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003400| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003410| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003420| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 0a 58 2e 53 48 20 44 |--------|-.X.SH D|
|00003430| 49 41 47 4e 4f 53 54 49 | 43 53 0a 58 5c 66 42 50 |IAGNOSTI|CS.X\fBP|
|00003440| 61 72 73 65 61 72 67 73 | 5c 66 50 20 6d 61 79 20 |arseargs|\fP may |
|00003450| 65 78 69 74 20 77 69 74 | 68 20 6f 6e 65 20 6f 66 |exit wit|h one of|
|00003460| 20 74 68 65 20 66 6f 6c | 6c 6f 77 69 6e 67 20 73 | the fol|lowing s|
|00003470| 74 61 74 75 73 20 63 6f | 64 65 73 3a 0a 58 0a 58 |tatus co|des:.X.X|
|00003480| 2e 54 50 20 35 0a 58 2d | 31 0a 58 53 6f 6d 65 20 |.TP 5.X-|1.XSome |
|00003490| 74 79 70 65 20 6f 66 20 | 73 79 73 74 65 6d 20 65 |type of |system e|
|000034a0| 72 72 6f 72 20 6f 63 63 | 75 72 72 65 64 20 64 75 |rror occ|urred du|
|000034b0| 72 69 6e 67 20 65 78 65 | 63 75 74 69 6f 6e 2c 20 |ring exe|cution, |
|000034c0| 63 61 75 73 69 6e 67 20 | 74 68 65 20 70 72 6f 67 |causing |the prog|
|000034d0| 72 61 6d 0a 58 74 6f 20 | 65 78 69 74 20 70 72 65 |ram.Xto |exit pre|
|000034e0| 6d 61 74 75 72 65 6c 79 | 2e 0a 58 2e 54 50 20 35 |maturely|..X.TP 5|
|000034f0| 0a 58 5c 7c 5c 7c 30 0a | 58 4e 6f 72 6d 61 6c 20 |.X\|\|0.|XNormal |
|00003500| 65 78 69 74 20 73 74 61 | 74 75 73 20 28 6e 6f 20 |exit sta|tus (no |
|00003510| 70 72 6f 62 6c 65 6d 73 | 20 77 65 72 65 20 65 6e |problems| were en|
|00003520| 63 6f 75 6e 74 65 72 65 | 64 29 2e 0a 58 2e 54 50 |countere|d)..X.TP|
|00003530| 20 35 0a 58 5c 7c 5c 7c | 31 0a 58 54 68 65 20 63 | 5.X\|\||1.XThe c|
|00003540| 61 6c 6c 69 6e 67 20 70 | 72 6f 67 72 61 6d 20 73 |alling p|rogram s|
|00003550| 70 65 63 69 66 69 65 64 | 20 74 68 65 20 5c 66 42 |pecified| the \fB|
|00003560| 5c 2d 23 5c 66 50 2c 20 | 74 68 65 20 5c 66 42 5c |\-#\fP, |the \fB\|
|00003570| 2d 55 5c 66 50 20 6f 72 | 20 74 68 65 20 5c 66 42 |-U\fP or| the \fB|
|00003580| 5c 2d 4d 5c 66 50 0a 58 | 6f 70 74 69 6f 6e 20 74 |\-M\fP.X|option t|
|00003590| 6f 20 5c 66 42 70 61 72 | 73 65 61 72 67 73 5c 66 |o \fBpar|seargs\f|
|000035a0| 50 2c 20 6f 72 20 73 70 | 65 63 69 66 69 65 64 20 |P, or sp|ecified |
|000035b0| 61 6e 20 5c 66 49 61 72 | 67 55 73 61 67 65 5c 66 |an \fIar|gUsage\f|
|000035c0| 50 20 66 6c 61 67 20 6f | 6e 20 74 68 65 20 63 6f |P flag o|n the co|
|000035d0| 6d 6d 61 6e 64 0a 58 6c | 69 6e 65 2e 20 20 4f 6e |mmand.Xl|ine. On|
|000035e0| 6c 79 20 74 68 65 20 61 | 70 70 72 6f 70 72 69 61 |ly the a|ppropria|
|000035f0| 74 65 20 6d 65 73 73 61 | 67 65 20 69 73 20 64 69 |te messa|ge is di|
|00003600| 73 70 6c 61 79 65 64 2e | 0a 58 2e 54 50 20 35 0a |splayed.|.X.TP 5.|
|00003610| 58 5c 7c 5c 7c 32 0a 58 | 41 20 63 6f 6d 6d 61 6e |X\|\|2.X|A comman|
|00003620| 64 20 6c 69 6e 65 20 73 | 79 6e 74 61 78 20 65 72 |d line s|yntax er|
|00003630| 72 6f 72 20 77 61 73 20 | 65 6e 63 6f 75 6e 74 65 |ror was |encounte|
|00003640| 72 65 64 20 62 79 20 5c | 66 42 70 61 72 73 65 61 |red by \|fBparsea|
|00003650| 72 67 73 5c 66 50 2e 20 | 54 68 65 20 6f 66 66 65 |rgs\fP. |The offe|
|00003660| 6e 64 69 6e 67 0a 58 63 | 6f 6d 6d 61 6e 64 20 6c |nding.Xc|ommand l|
|00003670| 69 6e 65 20 61 72 67 75 | 6d 65 6e 74 20 6d 61 79 |ine argu|ment may|
|00003680| 20 68 61 76 65 20 62 65 | 65 6e 20 69 6e 74 65 6e | have be|en inten|
|00003690| 64 65 64 20 66 6f 72 20 | 65 69 74 68 65 72 20 5c |ded for |either \|
|000036a0| 66 42 70 61 72 73 65 61 | 72 67 73 5c 66 50 20 6f |fBparsea|rgs\fP o|
|000036b0| 72 0a 58 66 6f 72 20 74 | 68 65 20 63 61 6c 6c 69 |r.Xfor t|he calli|
|000036c0| 6e 67 20 70 72 6f 67 72 | 61 6d 2e 0a 58 2e 54 50 |ng progr|am..X.TP|
|000036d0| 20 35 0a 58 5c 7c 5c 7c | 33 0a 58 54 68 65 20 65 | 5.X\|\||3.XThe e|
|000036e0| 6e 76 69 72 6f 6e 6d 65 | 6e 74 20 76 61 72 69 61 |nvironme|nt varia|
|000036f0| 62 6c 65 20 74 68 61 74 | 20 77 61 73 20 73 70 65 |ble that| was spe|
|00003700| 63 69 66 69 65 64 20 77 | 69 74 68 20 74 68 65 20 |cified w|ith the |
|00003710| 5c 66 42 5c 2d 65 5c 66 | 50 20 6f 70 74 69 6f 6e |\fB\-e\f|P option|
|00003720| 0a 58 69 73 20 65 69 74 | 68 65 72 20 5c 73 2d 31 |.Xis eit|her \s-1|
|00003730| 4e 55 4c 4c 5c 73 2b 31 | 20 28 68 61 73 20 61 6e |NULL\s+1| (has an|
|00003740| 20 65 6d 70 74 79 20 76 | 61 6c 75 65 29 20 6f 72 | empty v|alue) or|
|00003750| 20 64 6f 65 73 20 6e 6f | 74 20 65 78 69 73 74 2e | does no|t exist.|
|00003760| 20 50 65 72 68 61 70 73 | 0a 58 74 68 65 20 75 73 | Perhaps|.Xthe us|
|00003770| 65 72 20 73 70 65 63 69 | 66 69 65 64 20 61 20 73 |er speci|fied a s|
|00003780| 68 65 6c 6c 20 76 61 72 | 69 61 62 6c 65 20 61 6e |hell var|iable an|
|00003790| 64 2f 6f 72 20 66 6f 72 | 67 6f 74 20 74 6f 20 65 |d/or for|got to e|
|000037a0| 78 70 6f 72 74 20 69 74 | 2e 0a 58 2e 54 50 20 35 |xport it|..X.TP 5|
|000037b0| 0a 58 5c 7c 5c 7c 34 0a | 58 41 20 73 79 6e 74 61 |.X\|\|4.|XA synta|
|000037c0| 78 20 65 72 72 6f 72 20 | 77 61 73 20 65 6e 63 6f |x error |was enco|
|000037d0| 75 6e 74 65 72 65 64 20 | 69 6e 20 74 68 65 20 61 |untered |in the a|
|000037e0| 72 67 75 6d 65 6e 74 20 | 73 70 65 63 69 66 69 63 |rgument |specific|
|000037f0| 61 74 69 6f 6e 20 73 74 | 72 69 6e 67 20 74 68 61 |ation st|ring tha|
|00003800| 74 20 77 61 73 0a 58 73 | 70 65 63 69 66 69 65 64 |t was.Xs|pecified|
|00003810| 20 74 6f 20 5c 66 42 70 | 61 72 73 65 61 72 67 73 | to \fBp|arseargs|
|00003820| 5c 66 50 2e 0a 58 2e 5c | 22 2d 2d 2d 2d 2d 2d 2d |\fP..X.\|"-------|
|00003830| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003840| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003850| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003860| 2d 2d 2d 2d 0a 58 2e 53 | 48 20 46 49 4c 45 53 0a |----.X.S|H FILES.|
|00003870| 58 2e 49 50 20 22 5c 66 | 49 2f 75 73 72 2f 6c 6f |X.IP "\f|I/usr/lo|
|00003880| 63 61 6c 2f 70 61 72 73 | 65 61 72 67 73 2e 70 6c |cal/pars|eargs.pl|
|00003890| 5c 66 50 22 0a 58 54 68 | 69 73 20 66 69 6c 65 20 |\fP".XTh|is file |
|000038a0| 64 65 66 69 6e 65 73 20 | 61 20 5c 66 49 70 65 72 |defines |a \fIper|
|000038b0| 6c 5c 66 50 20 66 75 6e | 63 74 69 6f 6e 20 6e 61 |l\fP fun|ction na|
|000038c0| 6d 65 64 20 5c 66 49 70 | 61 72 73 65 61 72 67 73 |med \fIp|arseargs|
|000038d0| 5c 66 50 20 74 6f 20 70 | 61 72 73 65 0a 58 61 72 |\fP to p|arse.Xar|
|000038e0| 67 75 6d 65 6e 74 73 20 | 6d 6f 72 65 20 63 6f 6e |guments |more con|
|000038f0| 76 65 6e 69 65 6e 74 6c | 79 20 66 6f 72 20 70 65 |venientl|y for pe|
|00003900| 72 6c 2d 73 63 72 69 70 | 74 73 2e 20 54 68 65 20 |rl-scrip|ts. The |
|00003910| 66 75 6e 63 74 69 6f 6e | 20 69 73 20 0a 58 62 6f |function| is .Xbo|
|00003920| 74 68 20 64 6f 63 75 6d | 65 6e 74 65 64 20 61 6e |th docum|ented an|
|00003930| 64 20 69 6d 70 6c 65 6d | 65 6e 74 65 64 20 69 6e |d implem|ented in|
|00003940| 20 74 68 69 73 20 66 69 | 6c 65 2e 20 54 68 65 20 | this fi|le. The |
|00003950| 75 73 65 72 20 73 68 6f | 75 6c 64 0a 58 60 60 72 |user sho|uld.X``r|
|00003960| 65 71 75 69 72 65 27 27 | 20 74 68 69 73 20 66 69 |equire''| this fi|
|00003970| 6c 65 20 69 6e 20 68 69 | 73 2f 68 65 72 20 70 65 |le in hi|s/her pe|
|00003980| 72 6c 2d 73 63 72 69 70 | 74 20 62 65 66 6f 72 65 |rl-scrip|t before|
|00003990| 20 69 6e 76 6f 6b 69 6e | 67 20 74 68 65 0a 58 66 | invokin|g the.Xf|
|000039a0| 75 6e 63 74 69 6f 6e 2e | 0a 58 2e 49 50 20 22 5c |unction.|.X.IP "\|
|000039b0| 66 49 2f 75 73 72 2f 6c | 6f 63 61 6c 2f 70 61 72 |fI/usr/l|ocal/par|
|000039c0| 73 65 61 72 67 73 2e 61 | 77 6b 5c 66 50 22 0a 58 |seargs.a|wk\fP".X|
|000039d0| 54 68 69 73 20 66 69 6c | 65 20 64 65 66 69 6e 65 |This fil|e define|
|000039e0| 73 20 61 6e 20 5c 66 49 | 61 77 6b 5c 66 50 20 66 |s an \fI|awk\fP f|
|000039f0| 75 6e 63 74 69 6f 6e 20 | 6e 61 6d 65 64 20 5c 66 |unction |named \f|
|00003a00| 49 70 61 72 73 65 61 72 | 67 73 5c 66 50 20 74 6f |Iparsear|gs\fP to|
|00003a10| 20 70 61 72 73 65 0a 58 | 61 72 67 75 6d 65 6e 74 | parse.X|argument|
|00003a20| 73 20 6d 6f 72 65 20 63 | 6f 6e 76 65 6e 69 65 6e |s more c|onvenien|
|00003a30| 74 6c 79 20 66 6f 72 20 | 61 77 6b 2d 73 63 72 69 |tly for |awk-scri|
|00003a40| 70 74 73 2e 20 54 68 65 | 20 66 75 6e 63 74 69 6f |pts. The| functio|
|00003a50| 6e 20 69 73 20 0a 58 62 | 6f 74 68 20 64 6f 63 75 |n is .Xb|oth docu|
|00003a60| 6d 65 6e 74 65 64 20 61 | 6e 64 20 69 6d 70 6c 65 |mented a|nd imple|
|00003a70| 6d 65 6e 74 65 64 20 69 | 6e 20 74 68 69 73 20 66 |mented i|n this f|
|00003a80| 69 6c 65 2e 20 54 68 65 | 20 75 73 65 72 20 73 68 |ile. The| user sh|
|00003a90| 6f 75 6c 64 0a 58 69 6e | 63 6c 75 64 65 20 74 68 |ould.Xin|clude th|
|00003aa0| 69 73 20 66 69 6c 65 20 | 69 6e 20 68 69 73 2f 68 |is file |in his/h|
|00003ab0| 65 72 20 61 77 6b 2d 73 | 63 72 69 70 74 20 62 65 |er awk-s|cript be|
|00003ac0| 66 6f 72 65 20 69 6e 76 | 6f 6b 69 6e 67 20 74 68 |fore inv|oking th|
|00003ad0| 65 0a 58 66 75 6e 63 74 | 69 6f 6e 2e 0a 58 2e 5c |e.Xfunct|ion..X.\|
|00003ae0| 22 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |"-------|--------|
|00003af0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003b00| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003b10| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 0a 58 2e 53 |--------|----.X.S|
|00003b20| 48 20 53 45 45 20 41 4c | 53 4f 0a 58 2e 49 52 20 |H SEE AL|SO.X.IR |
|00003b30| 61 72 67 74 79 70 65 20 | 28 33 29 2c 0a 58 2e 49 |argtype |(3),.X.I|
|00003b40| 52 20 70 61 72 73 65 61 | 72 67 73 20 28 33 29 2c |R parsea|rgs (3),|
|00003b50| 0a 58 2e 49 52 20 70 61 | 72 73 65 63 6e 74 6c 20 |.X.IR pa|rsecntl |
|00003b60| 28 33 29 0a 58 2e 5c 22 | 2d 2d 2d 2d 2d 2d 2d 2d |(3).X.\"|--------|
|00003b70| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003b80| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003b90| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003ba0| 2d 2d 2d 0a 58 2e 73 6f | 20 63 61 76 65 61 74 73 |---.X.so| caveats|
|00003bb0| 2e 69 6e 63 0a 58 2e 5c | 22 2d 2d 2d 2d 2d 2d 2d |.inc.X.\|"-------|
|00003bc0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003bd0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003be0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003bf0| 2d 2d 2d 2d 0a 58 2e 73 | 6f 20 62 75 67 73 2e 69 |----.X.s|o bugs.i|
|00003c00| 6e 63 0a 58 2e 5c 22 2d | 2d 2d 2d 2d 2d 2d 2d 2d |nc.X.\"-|--------|
|00003c10| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003c20| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003c30| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003c40| 2d 2d 0a 58 2e 53 48 20 | 41 55 54 48 4f 52 0a 58 |--.X.SH |AUTHOR.X|
|00003c50| 2e 6e 66 0a 58 42 72 61 | 64 20 41 70 70 6c 65 74 |.nf.XBra|d Applet|
|00003c60| 6f 6e 20 20 28 5c 66 49 | 62 72 61 64 40 73 73 64 |on (\fI|brad@ssd|
|00003c70| 2e 63 73 64 2e 68 61 72 | 72 69 73 2e 63 6f 6d 5c |.csd.har|ris.com\|
|00003c80| 66 50 29 0a 58 48 61 72 | 72 69 73 20 43 6f 6d 70 |fP).XHar|ris Comp|
|00003c90| 75 74 65 72 20 53 79 73 | 74 65 6d 73 2c 20 46 6f |uter Sys|tems, Fo|
|00003ca0| 72 74 20 4c 61 75 64 65 | 72 64 61 6c 65 2c 20 46 |rt Laude|rdale, F|
|00003cb0| 4c 20 55 53 41 0a 58 2e | 66 69 0a 45 4e 44 5f 4f |L USA.X.|fi.END_O|
|00003cc0| 46 5f 46 49 4c 45 0a 69 | 66 20 74 65 73 74 20 31 |F_FILE.i|f test 1|
|00003cd0| 33 37 37 38 20 2d 6e 65 | 20 60 77 63 20 2d 63 20 |3778 -ne| `wc -c |
|00003ce0| 3c 27 64 6f 63 2f 70 61 | 72 73 65 61 72 67 73 2e |<'doc/pa|rseargs.|
|00003cf0| 6d 61 6e 31 27 60 3b 20 | 74 68 65 6e 0a 20 20 20 |man1'`; |then. |
|00003d00| 20 65 63 68 6f 20 73 68 | 61 72 3a 20 5c 22 27 64 | echo sh|ar: \"'d|
|00003d10| 6f 63 2f 70 61 72 73 65 | 61 72 67 73 2e 6d 61 6e |oc/parse|args.man|
|00003d20| 31 27 5c 22 20 75 6e 70 | 61 63 6b 65 64 20 77 69 |1'\" unp|acked wi|
|00003d30| 74 68 20 77 72 6f 6e 67 | 20 73 69 7a 65 21 0a 66 |th wrong| size!.f|
|00003d40| 69 0a 23 20 65 6e 64 20 | 6f 66 20 27 64 6f 63 2f |i.# end |of 'doc/|
|00003d50| 70 61 72 73 65 61 72 67 | 73 2e 6d 61 6e 31 27 0a |parsearg|s.man1'.|
|00003d60| 66 69 0a 69 66 20 74 65 | 73 74 20 2d 66 20 27 64 |fi.if te|st -f 'd|
|00003d70| 6f 63 2f 70 61 72 73 65 | 61 72 67 73 2e 6d 61 6e |oc/parse|args.man|
|00003d80| 33 27 20 2d 61 20 22 24 | 7b 31 7d 22 20 21 3d 20 |3' -a "$|{1}" != |
|00003d90| 22 2d 63 22 20 3b 20 74 | 68 65 6e 20 0a 20 20 65 |"-c" ; t|hen . e|
|00003da0| 63 68 6f 20 73 68 61 72 | 3a 20 57 69 6c 6c 20 6e |cho shar|: Will n|
|00003db0| 6f 74 20 63 6c 6f 62 62 | 65 72 20 65 78 69 73 74 |ot clobb|er exist|
|00003dc0| 69 6e 67 20 66 69 6c 65 | 20 5c 22 27 64 6f 63 2f |ing file| \"'doc/|
|00003dd0| 70 61 72 73 65 61 72 67 | 73 2e 6d 61 6e 33 27 5c |parsearg|s.man3'\|
|00003de0| 22 0a 65 6c 73 65 0a 65 | 63 68 6f 20 73 68 61 72 |".else.e|cho shar|
|00003df0| 3a 20 45 78 74 72 61 63 | 74 69 6e 67 20 5c 22 27 |: Extrac|ting \"'|
|00003e00| 64 6f 63 2f 70 61 72 73 | 65 61 72 67 73 2e 6d 61 |doc/pars|eargs.ma|
|00003e10| 6e 33 27 5c 22 20 5c 28 | 31 31 36 38 34 20 63 68 |n3'\" \(|11684 ch|
|00003e20| 61 72 61 63 74 65 72 73 | 5c 29 0a 73 65 64 20 22 |aracters|\).sed "|
|00003e30| 73 2f 5e 58 2f 2f 22 20 | 3e 27 64 6f 63 2f 70 61 |s/^X//" |>'doc/pa|
|00003e40| 72 73 65 61 72 67 73 2e | 6d 61 6e 33 27 20 3c 3c |rseargs.|man3' <<|
|00003e50| 27 45 4e 44 5f 4f 46 5f | 46 49 4c 45 27 0a 58 2e |'END_OF_|FILE'.X.|
|00003e60| 5c 22 20 24 48 65 61 64 | 65 72 3a 20 70 61 72 73 |\" $Head|er: pars|
|00003e70| 65 61 72 67 73 2e 33 2c | 76 20 32 2e 30 20 38 39 |eargs.3,|v 2.0 89|
|00003e80| 2f 31 32 2f 32 34 20 30 | 30 3a 35 36 3a 32 36 20 |/12/24 0|0:56:26 |
|00003e90| 65 72 69 63 20 45 78 70 | 20 24 0a 58 2e 54 48 20 |eric Exp| $.X.TH |
|00003ea0| 50 41 52 53 45 41 52 47 | 53 20 33 0a 58 2e 5c 22 |PARSEARG|S 3.X.\"|
|00003eb0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003ec0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003ed0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003ee0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 0a 58 2e 53 48 |--------|---.X.SH|
|00003ef0| 20 4e 41 4d 45 0a 58 70 | 61 72 73 65 61 72 67 73 | NAME.Xp|arseargs|
|00003f00| 20 5c 2d 20 70 61 72 73 | 65 20 63 6f 6d 6d 61 6e | \- pars|e comman|
|00003f10| 64 20 6c 69 6e 65 20 61 | 72 67 75 6d 65 6e 74 20 |d line a|rgument |
|00003f20| 76 65 63 74 6f 72 73 0a | 58 2e 5c 22 2d 2d 2d 2d |vectors.|X.\"----|
|00003f30| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003f40| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003f50| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003f60| 2d 2d 2d 2d 2d 2d 2d 0a | 58 2e 53 48 20 53 59 4e |-------.|X.SH SYN|
|00003f70| 4f 50 53 49 53 0a 58 23 | 69 6e 63 6c 75 64 65 20 |OPSIS.X#|include |
|00003f80| 3c 70 61 72 73 65 61 72 | 67 73 2e 68 3e 0a 58 2e |<parsear|gs.h>.X.|
|00003f90| 50 50 0a 58 2e 6e 66 0a | 58 69 6e 74 20 20 70 61 |PP.X.nf.|Xint pa|
|00003fa0| 72 73 65 61 72 67 73 28 | 20 20 63 68 61 72 20 2a |rseargs(| char *|
|00003fb0| 61 72 67 76 5c 66 34 5b | 5d 5c 66 50 2c 20 20 41 |argv\f4[|]\fP, A|
|00003fc0| 52 47 44 45 53 43 20 2a | 61 72 67 64 20 20 29 3b |RGDESC *|argd );|
|00003fd0| 0a 58 69 6e 74 20 20 66 | 70 61 72 73 65 61 72 67 |.Xint f|parsearg|
|00003fe0| 73 28 20 20 46 49 4c 45 | 20 2a 66 70 2c 20 20 41 |s( FILE| *fp, A|
|00003ff0| 52 47 44 45 53 43 20 2a | 61 72 67 64 20 20 29 3b |RGDESC *|argd );|
|00004000| 0a 58 69 6e 74 20 20 6c | 70 61 72 73 65 61 72 67 |.Xint l|parsearg|
|00004010| 73 28 20 20 41 72 67 4c | 69 73 74 20 2a 61 72 67 |s( ArgL|ist *arg|
|00004020| 6c 73 2c 20 20 41 52 47 | 44 45 53 43 20 2a 61 72 |ls, ARG|DESC *ar|
|00004030| 67 64 20 20 29 3b 0a 58 | 69 6e 74 20 20 73 70 61 |gd );.X|int spa|
|00004040| 72 73 65 61 72 67 73 28 | 20 20 63 68 61 72 20 2a |rseargs(| char *|
|00004050| 73 74 72 2c 20 20 41 52 | 47 44 45 53 43 20 2a 61 |str, AR|GDESC *a|
|00004060| 72 67 64 20 20 29 3b 0a | 58 69 6e 74 20 20 76 70 |rgd );.|Xint vp|
|00004070| 61 72 73 65 61 72 67 73 | 28 20 20 41 52 47 44 45 |arseargs|( ARGDE|
|00004080| 53 43 20 2a 61 72 67 64 | 2c 20 69 6e 74 20 61 72 |SC *argd|, int ar|
|00004090| 67 63 2c 20 20 2e 2e 2e | 20 20 29 3b 0a 58 76 6f |gc, ...| );.Xvo|
|000040a0| 69 64 20 20 75 73 61 67 | 65 28 20 20 63 6f 6e 73 |id usag|e( cons|
|000040b0| 74 20 41 52 47 44 45 53 | 43 20 2a 61 72 67 64 20 |t ARGDES|C *argd |
|000040c0| 20 29 3b 0a 58 65 78 74 | 65 72 6e 20 20 63 6f 6e | );.Xext|ern con|
|000040d0| 73 74 20 63 68 61 72 20 | 2a 50 72 6f 67 4e 61 6d |st char |*ProgNam|
|000040e0| 65 3b 0a 58 2e 66 69 0a | 58 2e 5c 22 2d 2d 2d 2d |e;.X.fi.|X.\"----|
|000040f0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004100| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004110| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004120| 2d 2d 2d 2d 2d 2d 2d 0a | 58 2e 53 48 20 44 45 53 |-------.|X.SH DES|
|00004130| 43 52 49 50 54 49 4f 4e | 0a 58 2e 73 6f 20 70 61 |CRIPTION|.X.so pa|
|00004140| 72 73 65 61 72 67 73 33 | 2e 69 6e 63 0a 58 2e 73 |rseargs3|.inc.X.s|
|00004150| 6f 20 66 70 61 72 73 65 | 61 72 67 73 33 2e 69 6e |o fparse|args3.in|
|00004160| 63 0a 58 2e 73 6f 20 6c | 70 61 72 73 65 61 72 67 |c.X.so l|parsearg|
|00004170| 73 33 2e 69 6e 63 0a 58 | 2e 73 6f 20 73 70 61 72 |s3.inc.X|.so spar|
|00004180| 73 65 61 72 67 73 33 2e | 69 6e 63 0a 58 2e 73 6f |seargs3.|inc.X.so|
|00004190| 20 76 70 61 72 73 65 61 | 72 67 73 33 2e 69 6e 63 | vparsea|rgs3.inc|
|000041a0| 0a 58 2e 73 6f 20 75 73 | 61 67 65 33 2e 69 6e 63 |.X.so us|age3.inc|
|000041b0| 0a 58 2e 50 50 0a 58 41 | 66 74 65 72 20 72 65 74 |.X.PP.XA|fter ret|
|000041c0| 75 72 6e 69 6e 67 20 66 | 72 6f 6d 20 61 6e 79 20 |urning f|rom any |
|000041d0| 6f 66 20 74 68 65 20 61 | 66 6f 72 65 6d 65 6e 74 |of the a|forement|
|000041e0| 69 6f 6e 65 64 20 66 75 | 6e 63 74 69 6f 6e 73 2c |ioned fu|nctions,|
|000041f0| 20 74 68 65 20 67 6c 6f | 62 61 6c 0a 58 73 74 72 | the glo|bal.Xstr|
|00004200| 69 6e 67 20 5c 66 49 50 | 72 6f 67 4e 61 6d 65 5c |ing \fIP|rogName\|
|00004210| 66 50 20 77 69 6c 6c 20 | 63 6f 6e 74 61 69 6e 20 |fP will |contain |
|00004220| 74 68 65 20 6e 61 6d 65 | 20 6f 66 20 74 68 65 20 |the name| of the |
|00004230| 63 6f 6d 6d 61 6e 64 20 | 63 6f 72 72 65 73 70 6f |command |correspo|
|00004240| 6e 64 69 6e 67 0a 58 74 | 6f 20 74 68 65 20 61 72 |nding.Xt|o the ar|
|00004250| 67 75 6d 65 6e 74 2d 64 | 65 73 63 72 69 70 74 6f |gument-d|escripto|
|00004260| 72 20 61 72 72 61 79 20 | 74 68 61 74 20 77 61 73 |r array |that was|
|00004270| 20 6d 6f 73 74 20 72 65 | 63 65 6e 74 6c 79 20 6f | most re|cently o|
|00004280| 70 65 72 61 74 65 64 20 | 75 70 6f 6e 20 62 79 0a |perated |upon by.|
|00004290| 58 6f 6e 65 20 74 68 65 | 20 66 75 6e 63 74 69 6f |Xone the| functio|
|000042a0| 6e 73 20 69 6e 20 74 68 | 65 20 5c 66 49 70 61 72 |ns in th|e \fIpar|
|000042b0| 73 65 61 72 67 73 5c 66 | 50 28 33 29 20 66 75 6e |seargs\f|P(3) fun|
|000042c0| 63 74 69 6f 6e 20 6c 69 | 62 72 61 72 79 2e 0a 58 |ction li|brary..X|
|000042d0| 2e 5c 22 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |.\"-----|--------|
|000042e0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000042f0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004300| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 0a 58 |--------|------.X|
|00004310| 2e 73 6f 20 61 72 67 64 | 65 73 63 2e 69 6e 63 0a |.so argd|esc.inc.|
|00004320| 58 2e 5c 22 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |X.\"----|--------|
|00004330| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004340| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004350| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 0a |--------|-------.|
|00004360| 58 2e 53 48 20 44 45 46 | 49 4e 49 4e 47 20 41 52 |X.SH DEF|INING AR|
|00004370| 47 44 45 53 43 20 41 52 | 52 41 59 53 0a 58 57 68 |GDESC AR|RAYS.XWh|
|00004380| 65 6e 20 64 65 66 69 6e | 69 6e 67 20 61 6e 20 61 |en defin|ing an a|
|00004390| 72 67 64 65 73 63 20 61 | 72 72 61 79 2c 20 74 68 |rgdesc a|rray, th|
|000043a0| 65 20 66 69 72 73 74 20 | 69 74 65 6d 20 69 6e 20 |e first |item in |
|000043b0| 74 68 65 20 6c 69 73 74 | 20 73 68 6f 75 6c 64 0a |the list| should.|
|000043c0| 58 62 65 20 74 68 65 20 | 69 74 65 6d 20 53 54 41 |Xbe the |item STA|
|000043d0| 52 54 4f 46 41 52 47 53 | 2e 20 4e 6f 72 6d 61 6c |RTOFARGS|. Normal|
|000043e0| 20 61 72 67 75 6d 65 6e | 74 73 20 28 64 65 66 69 | argumen|ts (defi|
|000043f0| 6e 65 64 20 62 79 20 74 | 68 65 20 70 72 6f 67 72 |ned by t|he progr|
|00004400| 61 6d 6d 65 72 29 0a 58 | 6d 61 79 20 74 68 65 6e |ammer).X|may then|
|00004410| 20 62 65 20 73 70 65 63 | 69 66 69 65 64 20 61 73 | be spec|ified as|
|00004420| 20 64 6f 63 75 6d 65 6e | 74 65 64 20 69 6e 20 74 | documen|ted in t|
|00004430| 68 69 73 20 6d 61 6e 75 | 61 6c 2e 0a 58 54 68 65 |his manu|al..XThe|
|00004440| 20 6c 69 73 74 20 6f 66 | 20 61 72 67 75 6d 65 6e | list of| argumen|
|00004450| 74 73 20 69 73 20 74 65 | 72 6d 69 6e 61 74 65 64 |ts is te|rminated|
|00004460| 20 75 73 69 6e 67 20 45 | 4e 44 4f 46 41 52 47 53 | using E|NDOFARGS|
|00004470| 2e 0a 58 2e 50 50 0a 58 | 46 6f 72 20 65 78 61 6d |..X.PP.X|For exam|
|00004480| 70 6c 65 2c 20 63 6f 6e | 73 69 64 65 72 20 74 68 |ple, con|sider th|
|00004490| 65 20 64 65 73 63 72 69 | 70 74 69 6f 6e 3a 0a 58 |e descri|ption:.X|
|000044a0| 2e 73 70 20 34 70 0a 58 | 2e 69 6e 20 2b 32 0a 58 |.sp 4p.X|.in +2.X|
|000044b0| 2e 6e 66 0a 58 2e 66 74 | 20 34 0a 58 69 6e 74 09 |.nf.X.ft| 4.Xint.|
|000044c0| 52 65 70 43 6f 75 6e 74 | 20 3d 09 32 3b 0a 58 42 |RepCount| =.2;.XB|
|000044d0| 4f 4f 4c 09 56 65 72 62 | 6f 73 65 20 3d 09 46 41 |OOL.Verb|ose =.FA|
|000044e0| 4c 53 45 3b 0a 58 63 68 | 61 72 09 2a 49 6e 46 69 |LSE;.Xch|ar.*InFi|
|000044f0| 6c 65 3b 0a 58 63 68 61 | 72 09 2a 4f 75 74 46 69 |le;.Xcha|r.*OutFi|
|00004500| 6c 65 20 3d 09 43 48 41 | 52 4e 55 4c 4c 3b 0a 58 |le =.CHA|RNULL;.X|
|00004510| 42 4f 4f 4c 09 58 52 61 | 74 65 64 20 3d 09 46 41 |BOOL.XRa|ted =.FA|
|00004520| 4c 53 45 3b 0a 58 41 72 | 67 4c 69 73 74 20 2a 46 |LSE;.XAr|gList *F|
|00004530| 69 6c 65 73 20 3d 20 20 | 20 20 41 52 47 4c 49 53 |iles = | ARGLIS|
|00004540| 54 4e 55 4c 4c 3b 0a 58 | 0a 58 41 52 47 44 45 53 |TNULL;.X|.XARGDES|
|00004550| 43 20 41 72 67 73 5b 5d | 20 3d 0a 58 7b 0a 58 20 |C Args[]| =.X{.X |
|00004560| 20 53 54 41 52 54 4f 46 | 41 52 47 53 2c 0a 58 20 | STARTOF|ARGS,.X |
|00004570| 20 27 63 27 2c 20 41 52 | 47 4f 50 54 2c 20 20 20 | 'c', AR|GOPT, |
|00004580| 20 61 72 67 49 6e 74 2c | 20 20 5f 5c 7c 5f 20 26 | argInt,| _\|_ &|
|00004590| 52 65 70 43 6f 75 6e 74 | 2c 20 22 52 45 50 63 6f |RepCount|, "REPco|
|000045a0| 75 6e 74 20 7b 23 20 6f | 66 20 72 65 70 65 74 69 |unt {# o|f repeti|
|000045b0| 74 69 6f 6e 73 7d 22 2c | 0a 58 20 20 27 76 27 2c |tions}",|.X 'v',|
|000045c0| 20 41 52 47 4f 50 54 2c | 20 20 20 20 61 72 67 42 | ARGOPT,| argB|
|000045d0| 6f 6f 6c 2c 20 5f 5c 7c | 5f 20 26 56 65 72 62 6f |ool, _\||_ &Verbo|
|000045e0| 73 65 2c 20 20 22 56 65 | 72 62 6f 73 65 20 7b 73 |se, "Ve|rbose {s|
|000045f0| 65 74 20 76 65 72 62 6f | 73 65 20 6d 6f 64 65 7d |et verbo|se mode}|
|00004600| 22 2c 0a 58 20 20 27 20 | 27 2c 20 41 52 47 52 45 |",.X ' |', ARGRE|
|00004610| 51 2c 20 20 20 20 61 72 | 67 53 74 72 2c 20 20 5f |Q, ar|gStr, _|
|00004620| 5c 7c 5f 20 26 49 6e 46 | 69 6c 65 2c 20 20 20 22 |\|_ &InF|ile, "|
|00004630| 49 4e 50 55 54 66 69 6c | 65 20 7b 69 6e 70 75 74 |INPUTfil|e {input|
|00004640| 20 66 69 6c 65 7d 22 2c | 0a 58 20 20 27 20 27 2c | file}",|.X ' ',|
|00004650| 20 41 52 47 4f 50 54 2c | 20 20 20 20 61 72 67 53 | ARGOPT,| argS|
|00004660| 74 72 2c 20 20 5f 5c 7c | 5f 20 26 4f 75 74 46 69 |tr, _\||_ &OutFi|
|00004670| 6c 65 2c 20 20 22 4f 55 | 54 50 55 54 66 69 6c 65 |le, "OU|TPUTfile|
|00004680| 20 7b 6f 75 74 70 75 74 | 20 66 69 6c 65 7d 22 2c | {output| file}",|
|00004690| 0a 58 20 20 27 58 27 2c | 20 41 52 47 48 49 44 44 |.X 'X',| ARGHIDD|
|000046a0| 45 4e 2c 20 61 72 67 42 | 6f 6f 6c 2c 20 5f 5c 7c |EN, argB|ool, _\||
|000046b0| 5f 20 26 58 52 61 74 65 | 64 2c 20 20 20 22 58 72 |_ &XRate|d, "Xr|
|000046c0| 61 74 65 64 4d 4f 44 45 | 20 7b 6e 61 75 67 68 74 |atedMODE| {naught|
|000046d0| 79 20 73 74 75 66 66 21 | 7d 22 2c 0a 58 20 20 27 |y stuff!|}",.X '|
|000046e0| 20 27 2c 20 41 52 47 4c | 49 53 54 2c 20 20 20 6c | ', ARGL|IST, l|
|000046f0| 69 73 74 53 74 72 2c 20 | 5f 5c 7c 5f 20 26 46 69 |istStr, |_\|_ &Fi|
|00004700| 6c 65 73 2c 20 20 20 20 | 22 46 69 6c 65 20 7b 66 |les, |"File {f|
|00004710| 69 6c 65 73 20 74 6f 20 | 62 65 20 72 65 61 64 7d |iles to |be read}|
|00004720| 22 2c 0a 58 20 20 45 4e | 44 4f 46 41 52 47 53 0a |",.X EN|DOFARGS.|
|00004730| 58 7d 3b 0a 58 2e 66 74 | 20 52 0a 58 2e 66 69 0a |X};.X.ft| R.X.fi.|
|00004740| 58 2e 69 6e 20 2d 32 0a | 58 2e 50 50 0a 58 54 68 |X.in -2.|X.PP.XTh|
|00004750| 69 73 20 64 65 73 63 72 | 69 62 65 73 20 61 20 70 |is descr|ibes a p|
|00004760| 72 6f 67 72 61 6d 20 61 | 63 63 65 70 74 69 6e 67 |rogram a|ccepting|
|00004770| 20 75 70 20 74 6f 20 74 | 68 72 65 65 20 66 6c 61 | up to t|hree fla|
|00004780| 67 20 61 72 67 75 6d 65 | 6e 74 73 20 61 6e 64 0a |g argume|nts and.|
|00004790| 58 6f 6e 65 20 6f 72 20 | 74 77 6f 20 70 6f 73 69 |Xone or |two posi|
|000047a0| 74 69 6f 6e 61 6c 20 61 | 72 67 75 6d 65 6e 74 73 |tional a|rguments|
|000047b0| 2c 20 70 6c 75 73 20 61 | 20 6c 69 73 74 20 6f 66 |, plus a| list of|
|000047c0| 20 61 64 64 69 74 69 6f | 6e 61 6c 20 66 69 6c 65 | additio|nal file|
|000047d0| 20 61 72 67 75 6d 65 6e | 74 73 2e 0a 58 4f 6e 6c | argumen|ts..XOnl|
|000047e0| 79 20 74 68 65 20 66 69 | 72 73 74 20 70 6f 73 69 |y the fi|rst posi|
|000047f0| 74 69 6f 6e 61 6c 20 61 | 72 67 75 6d 65 6e 74 20 |tional a|rgument |
|00004800| 69 73 20 72 65 71 75 69 | 72 65 64 2e 0a 58 54 68 |is requi|red..XTh|
|00004810| 65 20 70 6f 73 73 69 62 | 6c 65 20 66 6c 61 67 73 |e possib|le flags|
|00004820| 20 28 69 6e 20 55 4e 49 | 58 29 20 61 72 65 3a 0a | (in UNI|X) are:.|
|00004830| 58 2e 54 50 20 31 30 0a | 58 5c 66 42 5c 2d 63 5c |X.TP 10.|X\fB\-c\|
|00004840| 66 50 20 5c 66 49 63 6f | 75 6e 74 5c 66 50 0a 58 |fP \fIco|unt\fP.X|
|00004850| 41 6e 20 69 6e 74 65 67 | 65 72 20 72 65 70 65 74 |An integ|er repet|
|00004860| 69 74 69 6f 6e 20 63 6f | 75 6e 74 2e 0a 58 54 68 |ition co|unt..XTh|
|00004870| 69 73 20 64 65 66 61 75 | 6c 74 73 20 74 6f 20 74 |is defau|lts to t|
|00004880| 77 6f 2e 0a 58 2e 54 50 | 20 31 30 0a 58 5c 66 42 |wo..X.TP| 10.X\fB|
|00004890| 5c 2d 76 5c 66 50 0a 58 | 41 20 42 6f 6f 6c 65 61 |\-v\fP.X|A Boolea|
|000048a0| 6e 20 60 60 76 65 72 62 | 6f 73 65 27 27 20 66 6c |n ``verb|ose'' fl|
|000048b0| 61 67 2e 0a 58 49 74 20 | 64 65 66 61 75 6c 74 73 |ag..XIt |defaults|
|000048c0| 20 74 6f 20 46 41 4c 53 | 45 2e 0a 58 2e 54 50 20 | to FALS|E..X.TP |
|000048d0| 31 30 0a 58 5c 66 42 5c | 2d 58 5c 66 50 0a 58 41 |10.X\fB\|-X\fP.XA|
|000048e0| 20 42 6f 6f 6c 65 61 6e | 20 60 60 58 20 52 61 74 | Boolean| ``X Rat|
|000048f0| 65 64 27 27 20 66 6c 61 | 67 2e 0a 58 54 68 69 73 |ed'' fla|g..XThis|
|00004900| 20 69 73 20 6e 6f 74 20 | 70 72 69 6e 74 65 64 20 | is not |printed |
|00004910| 69 6e 20 74 68 65 20 75 | 73 61 67 65 20 6d 65 73 |in the u|sage mes|
|00004920| 73 61 67 65 2e 0a 58 2e | 50 50 0a 58 54 68 65 20 |sage..X.|PP.XThe |
|00004930| 74 77 6f 20 70 6f 73 69 | 74 69 6f 6e 61 6c 20 61 |two posi|tional a|
|00004940| 72 67 75 6d 65 6e 74 73 | 20 61 72 65 20 62 6f 74 |rguments| are bot|
|00004950| 68 20 73 74 72 69 6e 67 | 73 2c 20 61 73 20 69 73 |h string|s, as is|
|00004960| 20 74 68 65 20 66 69 6e | 61 6c 20 6c 69 73 74 2e | the fin|al list.|
|00004970| 0a 58 49 6e 20 41 6d 69 | 67 61 44 4f 53 2c 20 74 |.XIn Ami|gaDOS, t|
|00004980| 68 65 20 6f 70 74 69 6f | 6e 73 20 77 6f 75 6c 64 |he optio|ns would|
|00004990| 20 62 65 0a 58 5c 66 42 | 52 45 50 5c 66 50 20 5c | be.X\fB|REP\fP \|
|000049a0| 66 42 63 6f 75 6e 74 5c | 66 50 2c 0a 58 5c 66 42 |fBcount\|fP,.X\fB|
|000049b0| 56 5c 66 50 2c 20 61 6e | 64 0a 58 5c 66 42 5c 73 |V\fP, an|d.X\fB\s|
|000049c0| 2d 31 58 4d 4f 44 45 5c | 73 2b 31 5c 66 50 2e 0a |-1XMODE\|s+1\fP..|
|000049d0| 58 49 6e 20 5c 73 2d 31 | 56 41 58 2f 56 4d 53 5c |XIn \s-1|VAX/VMS\|
|000049e0| 73 2b 31 2c 20 74 68 65 | 20 71 75 61 6c 69 66 69 |s+1, the| qualifi|
|000049f0| 65 72 73 20 77 6f 75 6c | 64 20 62 65 0a 58 5c 66 |ers woul|d be.X\f|
|00004a00| 42 5c 73 2d 31 2f 52 45 | 50 5c 73 2b 31 5c 66 50 |B\s-1/RE|P\s+1\fP|
|00004a10| 3d 5c 66 49 63 6f 75 6e | 74 5c 66 50 2c 0a 58 5c |=\fIcoun|t\fP,.X\|
|00004a20| 66 42 5c 73 2d 31 2f 56 | 5c 73 2b 31 5c 66 50 2c |fB\s-1/V|\s+1\fP,|
|00004a30| 20 61 6e 64 0a 58 5c 66 | 42 5c 73 2d 31 2f 58 4d | and.X\f|B\s-1/XM|
|00004a40| 4f 44 45 5c 73 2b 31 5c | 66 50 2e 0a 58 2e 5c 22 |ODE\s+1\|fP..X.\"|
|00004a50| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004a60| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004a70| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004a80| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 0a 58 2e 73 6f |--------|---.X.so|
|00004a90| 20 61 72 67 66 6c 61 67 | 73 2e 69 6e 63 0a 58 2e | argflag|s.inc.X.|
|00004aa0| 5c 22 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |\"------|--------|
|00004ab0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004ac0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004ad0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 0a 58 2e |--------|-----.X.|
|00004ae0| 73 6f 20 61 72 67 5f 6d | 61 63 72 6f 73 2e 69 6e |so arg_m|acros.in|
|00004af0| 63 0a 58 2e 5c 22 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |c.X.\"--|--------|
|00004b00| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004b10| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004b20| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004b30| 2d 0a 58 2e 73 6f 20 63 | 6d 64 5f 6d 61 63 72 6f |-.X.so c|md_macro|
|00004b40| 73 2e 69 6e 63 0a 58 2e | 5c 22 2d 2d 2d 2d 2d 2d |s.inc.X.|\"------|
|00004b50| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004b60| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004b70| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004b80| 2d 2d 2d 2d 2d 0a 58 2e | 73 6f 20 64 65 66 61 72 |-----.X.|so defar|
|00004b90| 67 73 2e 69 6e 63 0a 58 | 2e 5c 22 2d 2d 2d 2d 2d |gs.inc.X|.\"-----|
|00004ba0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004bb0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004bc0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004bd0| 2d 2d 2d 2d 2d 2d 0a 58 | 2e 73 6f 20 65 6e 76 5f |------.X|.so env_|
|00004be0| 61 72 67 73 2e 69 6e 63 | 0a 58 2e 5c 22 2d 2d 2d |args.inc|.X.\"---|
|00004bf0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004c00| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004c10| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004c20| 2d 2d 2d 2d 2d 2d 2d 2d | 0a 58 2e 73 6f 20 65 6e |--------|.X.so en|
|00004c30| 76 5f 70 61 72 73 65 2e | 69 6e 63 0a 58 2e 5c 22 |v_parse.|inc.X.\"|
|00004c40| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004c50| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004c60| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004c70| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 0a 58 2e 73 6f |--------|---.X.so|
|00004c80| 20 65 6e 76 5f 75 73 61 | 67 65 2e 69 6e 63 0a 58 | env_usa|ge.inc.X|
|00004c90| 2e 5c 22 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |.\"-----|--------|
|00004ca0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004cb0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004cc0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 0a 58 |--------|------.X|
|00004cd0| 2e 73 6f 20 6d 75 6c 74 | 69 76 61 6c 73 2e 69 6e |.so mult|ivals.in|
|00004ce0| 63 0a 58 2e 5c 22 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |c.X.\"--|--------|
|00004cf0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004d00| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004d10| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004d20| 2d 0a 58 2e 53 48 20 41 | 52 47 55 4d 45 4e 54 20 |-.X.SH A|RGUMENT |
|00004d30| 54 59 50 45 20 46 55 4e | 43 54 49 4f 4e 53 0a 58 |TYPE FUN|CTIONS.X|
|00004d40| 54 68 65 20 61 72 67 75 | 6d 65 6e 74 20 74 79 70 |The argu|ment typ|
|00004d50| 65 73 20 72 65 63 6f 67 | 6e 69 7a 65 64 20 62 79 |es recog|nized by|
|00004d60| 0a 58 2e 49 20 70 61 72 | 73 65 61 72 67 73 0a 58 |.X.I par|seargs.X|
|00004d70| 63 61 6e 20 62 65 20 65 | 78 74 65 6e 64 65 64 20 |can be e|xtended |
|00004d80| 62 79 20 61 64 64 69 6e | 67 20 6e 65 77 20 74 79 |by addin|g new ty|
|00004d90| 70 65 20 66 75 6e 63 74 | 69 6f 6e 73 2e 0a 58 41 |pe funct|ions..XA|
|00004da0| 72 67 75 6d 65 6e 74 20 | 74 79 70 65 20 66 75 6e |rgument |type fun|
|00004db0| 63 74 69 6f 6e 73 20 61 | 72 65 20 64 65 63 6c 61 |ctions a|re decla|
|00004dc0| 72 65 64 20 61 73 3a 0a | 58 2e 52 53 0a 58 2e 50 |red as:.|X.RS.X.P|
|00004dd0| 50 0a 58 2e 6e 66 0a 58 | 2e 66 74 20 34 0a 58 42 |P.X.nf.X|.ft 4.XB|
|00004de0| 4f 4f 4c 20 20 61 72 67 | 58 78 78 28 20 20 41 52 |OOL arg|Xxx( AR|
|00004df0| 47 44 45 53 43 20 2a 61 | 64 2c 20 20 63 68 61 72 |GDESC *a|d, char|
|00004e00| 20 2a 76 70 2c 20 20 42 | 4f 4f 4c 20 63 6f 70 79 | *vp, B|OOL copy|
|00004e10| 66 20 20 29 0a 58 2e 66 | 74 20 52 0a 58 2e 66 69 |f ).X.f|t R.X.fi|
|00004e20| 0a 58 2e 52 45 0a 58 2e | 50 50 0a 58 54 68 65 20 |.X.RE.X.|PP.XThe |
|00004e30| 5c 66 34 61 64 5c 66 50 | 20 61 72 67 75 6d 65 6e |\f4ad\fP| argumen|
|00004e40| 74 20 70 6f 69 6e 74 73 | 20 74 6f 20 74 68 65 20 |t points| to the |
|00004e50| 64 65 73 63 72 69 70 74 | 6f 72 20 66 6f 72 20 74 |descript|or for t|
|00004e60| 68 65 20 61 72 67 75 6d | 65 6e 74 20 62 65 69 6e |he argum|ent bein|
|00004e70| 67 0a 58 63 6f 6e 76 65 | 72 74 65 64 2e 20 49 74 |g.Xconve|rted. It|
|00004e80| 73 20 6d 61 69 6e 20 75 | 73 65 20 69 73 20 74 6f |s main u|se is to|
|00004e90| 20 66 69 6e 64 20 74 68 | 65 20 6c 6f 63 61 74 69 | find th|e locati|
|00004ea0| 6f 6e 20 69 6e 20 77 68 | 69 63 68 20 74 6f 20 73 |on in wh|ich to s|
|00004eb0| 74 6f 72 65 20 74 68 65 | 0a 58 63 6f 6e 76 65 72 |tore the|.Xconver|
|00004ec0| 74 65 64 20 76 61 6c 75 | 65 2c 20 6c 6f 63 61 74 |ted valu|e, locat|
|00004ed0| 65 64 20 69 6e 20 61 64 | 5c 28 2d 3e 61 64 5f 76 |ed in ad|\(->ad_v|
|00004ee0| 61 6c 70 2e 0a 58 54 68 | 65 20 73 74 72 69 6e 67 |alp..XTh|e string|
|00004ef0| 20 76 61 6c 75 65 20 74 | 6f 20 62 65 20 63 6f 6e | value t|o be con|
|00004f00| 76 65 72 74 65 64 20 69 | 73 20 70 61 73 73 65 64 |verted i|s passed|
|00004f10| 20 69 6e 20 5c 66 34 76 | 70 5c 66 50 0a 58 28 77 | in \f4v|p\fP.X(w|
|00004f20| 68 69 63 68 20 77 69 6c | 6c 20 62 65 20 5c 73 2d |hich wil|l be \s-|
|00004f30| 31 4e 55 4c 4c 5c 73 2b | 31 20 69 66 20 74 68 65 |1NULL\s+|1 if the|
|00004f40| 20 5c 73 2d 31 41 52 47 | 4e 4f 56 41 4c 5c 73 2b | \s-1ARG|NOVAL\s+|
|00004f50| 31 20 66 6c 61 67 20 77 | 61 73 20 73 65 74 20 66 |1 flag w|as set f|
|00004f60| 6f 72 20 74 68 65 0a 58 | 63 6f 72 72 65 73 70 6f |or the.X|correspo|
|00004f70| 6e 64 69 6e 67 20 65 6e | 74 72 79 20 69 6e 20 74 |nding en|try in t|
|00004f80| 68 65 20 61 72 67 2d 64 | 65 73 63 72 69 70 74 6f |he arg-d|escripto|
|00004f90| 72 20 74 61 62 6c 65 29 | 2e 0a 58 54 68 65 20 5c |r table)|..XThe \|
|00004fa0| 66 34 63 6f 70 79 66 5c | 66 50 20 66 6c 61 67 20 |f4copyf\|fP flag |
|00004fb0| 69 73 20 54 52 55 45 20 | 69 66 20 74 68 65 20 5c |is TRUE |if the \|
|00004fc0| 66 34 76 70 5c 66 50 20 | 73 74 72 69 6e 67 20 76 |f4vp\fP |string v|
|00004fd0| 61 6c 75 65 20 6d 75 73 | 74 20 62 65 20 63 6f 70 |alue mus|t be cop|
|00004fe0| 69 65 64 0a 58 77 68 65 | 6e 20 73 61 76 65 64 2e |ied.Xwhe|n saved.|
|00004ff0| 20 20 4d 6f 73 74 20 6e | 6f 6e 2d 73 74 72 69 6e | Most n|on-strin|
|00005000| 67 20 74 79 70 65 73 20 | 61 72 65 20 63 6f 70 69 |g types |are copi|
|00005010| 65 64 20 69 6d 70 6c 69 | 63 69 74 6c 79 20 28 66 |ed impli|citly (f|
|00005020| 6f 72 20 65 78 61 6d 70 | 6c 65 2c 0a 58 69 6e 74 |or examp|le,.Xint|
|00005030| 65 67 65 72 20 61 72 67 | 75 6d 65 6e 74 73 20 61 |eger arg|uments a|
|00005040| 72 65 20 73 74 6f 72 65 | 64 20 69 6e 20 62 69 6e |re store|d in bin|
|00005050| 61 72 79 20 66 6f 72 6d | 2c 20 73 6f 20 74 68 65 |ary form|, so the|
|00005060| 20 6f 72 69 67 69 6e 61 | 6c 20 73 74 72 69 6e 67 | origina|l string|
|00005070| 20 76 61 6c 75 65 0a 58 | 6e 65 65 64 20 6e 6f 74 | value.X|need not|
|00005080| 20 62 65 20 73 61 76 65 | 64 29 2c 20 73 6f 20 74 | be save|d), so t|
|00005090| 68 69 73 20 61 72 67 75 | 6d 65 6e 74 20 63 61 6e |his argu|ment can|
|000050a0| 20 75 73 75 61 6c 6c 79 | 20 62 65 20 69 67 6e 6f | usually| be igno|
|000050b0| 72 65 64 2e 20 20 50 75 | 74 20 73 69 6d 70 6c 79 |red. Pu|t simply|
|000050c0| 2c 0a 58 74 68 69 73 20 | 66 6c 61 67 20 69 73 20 |,.Xthis |flag is |
|000050d0| 54 52 55 45 20 77 68 65 | 6e 20 5c 66 34 76 70 5c |TRUE whe|n \f4vp\|
|000050e0| 66 50 20 70 6f 69 6e 74 | 73 20 74 6f 20 61 20 74 |fP point|s to a t|
|000050f0| 65 6d 70 6f 72 61 72 79 | 20 62 75 66 66 65 72 20 |emporary| buffer |
|00005100| 61 72 65 61 2e 0a 58 2e | 50 50 0a 58 49 66 20 74 |area..X.|PP.XIf t|
|00005110| 68 65 20 74 79 70 65 20 | 66 75 6e 63 74 69 6f 6e |he type |function|
|00005120| 20 73 75 63 63 65 73 73 | 66 75 6c 6c 79 20 63 6f | success|fully co|
|00005130| 6e 76 65 72 74 73 20 74 | 68 65 20 76 61 6c 75 65 |nverts t|he value|
|00005140| 2c 20 61 6e 64 20 75 73 | 65 73 20 74 68 65 20 65 |, and us|es the e|
|00005150| 6e 74 69 72 65 0a 58 76 | 61 6c 75 65 2c 20 69 74 |ntire.Xv|alue, it|
|00005160| 20 73 68 6f 75 6c 64 20 | 72 65 74 75 72 6e 20 54 | should |return T|
|00005170| 52 55 45 2e 20 20 49 66 | 20 74 68 65 20 74 79 70 |RUE. If| the typ|
|00005180| 65 20 66 75 6e 63 74 69 | 6f 6e 20 73 75 63 63 65 |e functi|on succe|
|00005190| 73 73 66 75 6c 6c 79 20 | 63 6f 6e 76 65 72 74 73 |ssfully |converts|
|000051a0| 0a 58 74 68 65 20 76 61 | 6c 75 65 2c 20 61 6e 64 |.Xthe va|lue, and|
|000051b0| 20 75 73 65 73 20 6f 6e | 6c 79 20 5c 66 49 4e 5c | uses on|ly \fIN\|
|000051c0| 66 50 20 63 68 61 72 61 | 63 74 65 72 73 20 6f 66 |fP chara|cters of|
|000051d0| 20 74 68 65 20 76 61 6c | 75 65 2c 20 69 74 20 73 | the val|ue, it s|
|000051e0| 68 6f 75 6c 64 20 72 65 | 74 75 72 6e 0a 58 2d 5c |hould re|turn.X-\|
|000051f0| 66 49 4e 5c 66 50 2e 20 | 20 4f 74 68 65 72 77 69 |fIN\fP. | Otherwi|
|00005200| 73 65 2c 20 69 74 20 73 | 68 6f 75 6c 64 20 70 72 |se, it s|hould pr|
|00005210| 69 6e 74 20 61 20 6d 65 | 73 73 61 67 65 20 75 73 |int a me|ssage us|
|00005220| 69 6e 67 0a 58 2e 49 52 | 20 75 73 72 65 72 72 20 |ing.X.IR| usrerr |
|00005230| 28 33 29 0a 58 61 6e 64 | 20 72 65 74 75 72 6e 20 |(3).Xand| return |
|00005240| 46 41 4c 53 45 2e 20 54 | 68 69 73 20 6d 65 73 73 |FALSE. T|his mess|
|00005250| 61 67 65 20 73 68 6f 75 | 6c 64 20 62 65 20 6f 66 |age shou|ld be of|
|00005260| 20 74 68 65 20 66 6f 72 | 6d 0a 58 5c 66 42 22 69 | the for|m.X\fB"i|
|00005270| 6e 76 61 6c 69 64 20 78 | 78 78 78 20 6f 70 74 69 |nvalid x|xxx opti|
|00005280| 6f 6e 20 27 79 79 79 79 | 27 20 66 6f 72 20 5a 7a |on 'yyyy|' for Zz|
|00005290| 7a 7a 22 5c 66 50 2c 20 | 77 68 65 72 65 20 78 78 |zz"\fP, |where xx|
|000052a0| 78 78 20 69 73 20 74 68 | 65 20 74 79 70 65 20 6f |xx is th|e type o|
|000052b0| 66 20 74 68 65 0a 58 6f | 70 74 69 6f 6e 2c 20 79 |f the.Xo|ption, y|
|000052c0| 79 79 79 20 69 73 20 74 | 68 65 20 73 74 72 69 6e |yyy is t|he strin|
|000052d0| 67 20 70 61 73 73 65 64 | 20 69 6e 20 5c 66 34 76 |g passed| in \f4v|
|000052e0| 70 5c 66 50 2c 20 61 6e | 64 20 7a 7a 7a 7a 20 69 |p\fP, an|d zzzz i|
|000052f0| 73 20 74 68 65 20 6e 61 | 6d 65 20 28 74 61 6b 65 |s the na|me (take|
|00005300| 6e 0a 58 66 72 6f 6d 20 | 5c 66 34 61 64 5c 28 2d |n.Xfrom |\f4ad\(-|
|00005310| 3e 61 64 5f 70 72 6f 6d | 70 74 5c 66 50 29 2e 0a |>ad_prom|pt\fP)..|
|00005320| 58 54 68 65 20 5c 66 49 | 61 72 67 58 78 78 78 5c |XThe \fI|argXxxx\|
|00005330| 66 50 20 66 75 6e 63 74 | 69 6f 6e 20 69 73 20 72 |fP funct|ion is r|
|00005340| 65 73 70 6f 6e 73 69 62 | 6c 65 20 66 6f 72 20 64 |esponsib|le for d|
|00005350| 65 74 65 63 74 69 6e 67 | 20 69 66 20 74 68 65 20 |etecting| if the |
|00005360| 67 69 76 65 6e 20 61 72 | 67 75 6d 65 6e 74 0a 58 |given ar|gument.X|
|00005370| 64 65 73 63 72 69 70 74 | 6f 72 20 69 73 20 61 6e |descript|or is an|
|00005380| 20 5c 73 2d 31 41 52 47 | 56 45 43 5c 73 2b 31 20 | \s-1ARG|VEC\s+1 |
|00005390| 61 72 67 75 6d 65 6e 74 | 20 61 6e 64 20 66 6f 72 |argument| and for|
|000053a0| 20 74 61 6b 69 6e 67 20 | 74 68 65 20 61 70 70 72 | taking |the appr|
|000053b0| 6f 70 72 69 61 74 65 20 | 61 63 74 69 6f 6e 2e 0a |opriate |action..|
|000053c0| 58 2e 50 50 0a 58 46 6f | 72 20 65 78 61 6d 70 6c |X.PP.XFo|r exampl|
|000053d0| 65 2c 20 61 20 74 79 70 | 65 20 66 75 6e 63 74 69 |e, a typ|e functi|
|000053e0| 6f 6e 20 74 68 61 74 20 | 74 6f 6f 6b 20 61 20 66 |on that |took a f|
|000053f0| 69 6c 65 6e 61 6d 65 0a | 58 61 6e 64 20 73 74 6f |ilename.|Xand sto|
|00005400| 72 65 64 20 61 6e 20 6f | 70 65 6e 20 66 69 6c 65 |red an o|pen file|
|00005410| 20 70 6f 69 6e 74 65 72 | 20 6d 69 67 68 74 20 62 | pointer| might b|
|00005420| 65 20 63 6f 64 65 64 20 | 61 73 3a 0a 58 2e 52 53 |e coded |as:.X.RS|
|00005430| 0a 58 2e 50 50 0a 58 2e | 6e 66 0a 58 2e 66 74 20 |.X.PP.X.|nf.X.ft |
|00005440| 34 0a 58 23 64 65 66 69 | 6e 65 20 52 45 41 4c 4c |4.X#defi|ne REALL|
|00005450| 4f 43 28 70 74 72 2c 73 | 69 7a 65 29 20 20 28 28 |OC(ptr,s|ize) ((|
|00005460| 21 20 70 74 72 29 20 3f | 20 6d 61 6c 6c 6f 63 28 |! ptr) ?| malloc(|
|00005470| 73 69 7a 65 29 20 3a 20 | 72 65 61 6c 6c 6f 63 28 |size) : |realloc(|
|00005480| 70 74 72 2c 20 73 69 7a | 65 29 29 0a 58 2e 73 70 |ptr, siz|e)).X.sp|
|00005490| 20 38 70 0a 58 74 79 70 | 65 64 65 66 20 41 52 47 | 8p.Xtyp|edef ARG|
|000054a0| 56 45 43 5f 54 28 46 49 | 4c 45 20 2a 29 20 20 46 |VEC_T(FI|LE *) F|
|000054b0| 49 4c 45 76 65 63 5f 74 | 3b 0a 58 2e 73 70 20 38 |ILEvec_t|;.X.sp 8|
|000054c0| 70 0a 58 42 4f 4f 4c 20 | 20 61 72 67 52 65 61 64 |p.XBOOL | argRead|
|000054d0| 46 69 6c 65 28 20 20 41 | 52 47 44 45 53 43 20 2a |File( A|RGDESC *|
|000054e0| 5c 7c 61 64 2c 20 20 63 | 68 61 72 20 2a 5c 7c 76 |\|ad, c|har *\|v|
|000054f0| 70 2c 20 20 42 4f 4f 4c | 20 63 6f 70 79 66 20 20 |p, BOOL| copyf |
|00005500| 29 0a 58 7b 0a 58 09 72 | 65 67 69 73 74 65 72 20 |).X{.X.r|egister |
|00005510| 46 49 4c 45 20 2a 66 70 | 3b 0a 58 2e 73 70 20 34 |FILE *fp|;.X.sp 4|
|00005520| 70 0a 58 09 66 70 20 3d | 20 66 6f 70 65 6e 28 76 |p.X.fp =| fopen(v|
|00005530| 70 2c 20 22 72 22 29 3b | 0a 58 2e 73 70 20 34 70 |p, "r");|.X.sp 4p|
|00005540| 0a 58 09 69 66 20 28 20 | 21 20 66 70 20 29 20 7b |.X.if ( |! fp ) {|
|00005550| 0a 58 09 09 75 73 72 65 | 72 72 28 22 63 61 6e 6e |.X..usre|rr("cann|
|00005560| 6f 74 20 6f 70 65 6e 20 | 27 25 73 27 20 66 6f 72 |ot open |'%s' for|
|00005570| 20 72 65 61 64 69 6e 67 | 22 2c 20 76 70 29 3b 0a | reading|", vp);.|
|00005580| 58 09 09 72 65 74 75 72 | 6e 20 28 46 41 4c 53 45 |X..retur|n (FALSE|
|00005590| 29 3b 0a 58 09 7d 0a 58 | 2e 73 70 20 34 70 0a 58 |);.X.}.X|.sp 4p.X|
|000055a0| 09 69 66 20 28 20 42 54 | 45 53 54 28 61 72 67 5f |.if ( BT|EST(arg_|
|000055b0| 66 6c 61 67 73 28 61 64 | 29 2c 20 41 52 47 56 45 |flags(ad|), ARGVE|
|000055c0| 43 29 20 29 20 7b 0a 58 | 09 09 46 49 4c 45 76 65 |C) ) {.X|..FILEve|
|000055d0| 63 5f 74 20 20 2a 76 65 | 63 20 3d 20 28 46 49 4c |c_t *ve|c = (FIL|
|000055e0| 45 76 65 63 5f 74 20 2a | 29 20 61 72 67 5f 76 61 |Evec_t *|) arg_va|
|000055f0| 6c 70 28 61 64 29 3b 0a | 58 09 09 73 69 7a 65 5f |lp(ad);.|X..size_|
|00005600| 74 20 20 73 69 7a 65 20 | 20 3d 20 28 31 20 2b 20 |t size | = (1 + |
|00005610| 76 65 63 2d 3e 63 6f 75 | 6e 74 29 20 2a 20 28 73 |vec->cou|nt) * (s|
|00005620| 69 7a 65 6f 66 20 28 46 | 49 4c 45 20 2a 29 29 3b |izeof (F|ILE *));|
|00005630| 0a 58 2e 73 70 20 34 70 | 0a 58 09 09 76 65 63 2d |.X.sp 4p|.X..vec-|
|00005640| 3e 61 72 72 61 79 20 3d | 20 28 46 49 4c 45 20 2a |>array =| (FILE *|
|00005650| 2a 29 20 52 45 41 4c 4c | 4f 43 28 76 65 63 2d 3e |*) REALL|OC(vec->|
|00005660| 61 72 72 61 79 2c 20 73 | 69 7a 65 29 3b 0a 58 09 |array, s|ize);.X.|
|00005670| 09 69 66 20 28 20 21 20 | 76 65 63 2d 3e 61 72 72 |.if ( ! |vec->arr|
|00005680| 61 79 20 29 0a 58 09 09 | 09 73 79 73 65 72 72 28 |ay ).X..|.syserr(|
|00005690| 20 22 28 6d 7c 72 65 29 | 61 6c 6c 6f 63 20 66 61 | "(m|re)|alloc fa|
|000056a0| 69 6c 65 64 20 69 6e 20 | 61 72 67 52 65 61 64 46 |iled in |argReadF|
|000056b0| 69 6c 65 22 20 29 3b 0a | 58 2e 73 70 20 34 70 0a |ile" );.|X.sp 4p.|
|000056c0| 58 09 09 76 65 63 2d 3e | 66 6c 61 67 73 20 3d 20 |X..vec->|flags = |
|000056d0| 28 46 49 4c 45 20 2a 2a | 29 20 52 45 41 4c 4c 4f |(FILE **|) REALLO|
|000056e0| 43 28 76 65 63 2d 3e 66 | 6c 61 67 73 2c 20 73 69 |C(vec->f|lags, si|
|000056f0| 7a 65 29 3b 0a 58 09 09 | 69 66 20 28 20 21 20 76 |ze);.X..|if ( ! v|
|00005700| 65 63 2d 3e 66 6c 61 67 | 73 20 29 0a 58 09 09 09 |ec->flag|s ).X...|
|00005710| 73 79 73 65 72 72 28 20 | 22 28 6d 7c 72 65 29 61 |syserr( |"(m|re)a|
|00005720| 6c 6c 6f 63 20 66 61 69 | 6c 65 64 20 69 6e 20 61 |lloc fai|led in a|
|00005730| 72 67 52 65 61 64 46 69 | 6c 65 22 20 29 3b 0a 58 |rgReadFi|le" );.X|
|00005740| 2e 73 70 20 34 70 0a 58 | 09 09 76 65 63 2d 3e 66 |.sp 4p.X|..vec->f|
|00005750| 6c 61 67 73 5b 20 76 65 | 63 2d 3e 63 6f 75 6e 74 |lags[ ve|c->count|
|00005760| 20 5d 20 3d 20 61 72 67 | 5f 66 6c 61 67 73 28 61 | ] = arg|_flags(a|
|00005770| 64 29 3b 0a 58 09 09 76 | 65 63 2d 3e 61 72 72 61 |d);.X..v|ec->arra|
|00005780| 79 5b 20 28 76 65 63 2d | 3e 63 6f 75 6e 74 29 2b |y[ (vec-|>count)+|
|00005790| 2b 20 5d 20 3d 20 66 70 | 3b 0a 58 09 7d 0a 58 09 |+ ] = fp|;.X.}.X.|
|000057a0| 65 6c 73 65 0a 58 09 09 | 2a 28 46 49 4c 45 20 2a |else.X..|*(FILE *|
|000057b0| 29 20 61 72 67 5f 76 61 | 6c 70 28 61 64 29 20 3d |) arg_va|lp(ad) =|
|000057c0| 20 66 70 3b 0a 58 2e 73 | 70 20 34 70 0a 58 09 72 | fp;.X.s|p 4p.X.r|
|000057d0| 65 74 75 72 6e 20 28 54 | 52 55 45 29 3b 0a 58 7d |eturn (T|RUE);.X}|
|000057e0| 0a 58 2e 66 74 20 52 0a | 58 2e 66 69 0a 58 2e 52 |.X.ft R.|X.fi.X.R|
|000057f0| 45 0a 58 2e 52 45 0a 58 | 2e 5c 22 2d 2d 2d 2d 2d |E.X.RE.X|.\"-----|
|00005800| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00005810| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00005820| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00005830| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 0a 58 2e |--------|-----.X.|
|00005840| 53 48 20 4c 4f 4e 47 20 | 4f 50 54 49 4f 4e 53 0a |SH LONG |OPTIONS.|
|00005850| 58 2e 50 50 0a 58 55 6e | 64 65 72 20 5c 73 2d 31 |X.PP.XUn|der \s-1|
|00005860| 55 4e 49 58 5c 73 2b 31 | 2c 20 5c 73 2d 31 4d 53 |UNIX\s+1|, \s-1MS|
|00005870| 2d 44 4f 53 5c 73 2b 31 | 2c 20 61 6e 64 20 5c 73 |-DOS\s+1|, and \s|
|00005880| 2d 31 4f 53 5c 73 2b 31 | 2f 32 2c 0a 58 5c 66 49 |-1OS\s+1|/2,.X\fI|
|00005890| 70 61 72 73 65 61 72 67 | 73 5c 66 50 20 61 6c 73 |parsearg|s\fP als|
|000058a0| 6f 20 61 6c 6c 6f 77 73 | 20 66 6f 72 20 6c 6f 6e |o allows| for lon|
|000058b0| 67 0a 58 6f 70 74 69 6f | 6e 73 20 69 6e 20 61 64 |g.Xoptio|ns in ad|
|000058c0| 64 69 74 69 6f 6e 20 74 | 6f 20 73 69 6e 67 6c 65 |dition t|o single|
|000058d0| 20 63 68 61 72 61 63 74 | 65 72 20 6f 70 74 69 6f | charact|er optio|
|000058e0| 6e 73 2e 0a 58 55 6e 64 | 65 72 20 5c 73 2d 31 55 |ns..XUnd|er \s-1U|
|000058f0| 4e 49 58 5c 73 2b 31 2c | 20 6c 6f 6e 67 20 6f 70 |NIX\s+1,| long op|
|00005900| 74 69 6f 6e 73 20 61 72 | 65 20 64 65 6e 6f 74 65 |tions ar|e denote|
|00005910| 64 20 62 79 20 61 20 60 | 5c 66 42 2b 5c 66 50 27 |d by a `|\fB+\fP'|
|00005920| 20 63 68 61 72 61 63 74 | 65 72 20 0a 58 28 75 6e | charact|er .X(un|
|00005930| 6c 65 73 73 20 5c 66 49 | 70 61 72 73 65 61 72 67 |less \fI|parsearg|
|00005940| 73 5c 66 50 20 77 61 73 | 20 63 6f 6d 70 69 6c 65 |s\fP was| compile|
|00005950| 64 20 66 6f 72 20 63 6f | 6e 66 6f 72 6d 61 6e 63 |d for co|nformanc|
|00005960| 65 20 77 69 74 68 20 50 | 4f 53 49 58 2c 20 69 6e |e with P|OSIX, in|
|00005970| 63 20 77 68 69 63 68 0a | 58 63 61 73 65 20 74 68 |c which.|Xcase th|
|00005980| 65 20 6c 6f 6e 67 20 6f | 70 74 69 6f 6e 20 70 72 |e long o|ption pr|
|00005990| 65 66 69 78 20 69 73 20 | 60 5c 66 42 5c 2d 5c 7c |efix is |`\fB\-\||
|000059a0| 5c 2d 5c 66 50 27 29 2e | 0a 58 55 6e 64 65 72 20 |\-\fP').|.XUnder |
|000059b0| 5c 73 2d 31 4d 53 2d 44 | 4f 53 5c 73 2b 31 2c 20 |\s-1MS-D|OS\s+1, |
|000059c0| 61 6e 64 20 5c 73 2d 31 | 4f 53 5c 73 2b 31 2f 32 |and \s-1|OS\s+1/2|
|000059d0| 2c 20 6c 6f 6e 67 20 6f | 70 74 69 6f 6e 73 20 61 |, long o|ptions a|
|000059e0| 72 65 20 64 65 6e 6f 74 | 65 64 20 62 79 20 74 68 |re denot|ed by th|
|000059f0| 65 20 73 65 63 6f 6e 64 | 0a 58 63 68 61 72 61 63 |e second|.Xcharac|
|00005a00| 74 65 72 20 69 6e 20 74 | 68 65 20 5c 73 2d 31 53 |ter in t|he \s-1S|
|00005a10| 57 49 54 43 48 41 52 5c | 73 2b 31 20 65 6e 76 69 |WITCHAR\|s+1 envi|
|00005a20| 72 6f 6e 6d 65 6e 74 20 | 76 61 72 69 61 62 6c 65 |ronment |variable|
|00005a30| 2e 20 49 66 20 74 68 65 | 72 65 20 69 73 20 6e 6f |. If the|re is no|
|00005a40| 20 73 65 63 6f 6e 64 0a | 58 63 68 61 72 61 63 74 | second.|Xcharact|
|00005a50| 65 72 2c 20 74 68 65 6e | 20 69 66 20 74 68 65 20 |er, then| if the |
|00005a60| 66 69 72 73 74 20 63 68 | 61 72 61 63 74 65 72 20 |first ch|aracter |
|00005a70| 69 73 20 60 5c 2d 27 2c | 20 74 68 65 6e 20 61 20 |is `\-',| then a |
|00005a80| 60 5c 66 42 2b 5c 66 50 | 27 20 69 73 20 75 73 65 |`\fB+\fP|' is use|
|00005a90| 64 2c 0a 58 6f 74 68 65 | 72 77 69 73 65 20 61 20 |d,.Xothe|rwise a |
|00005aa0| 60 5c 66 42 2f 5c 66 50 | 27 20 69 73 20 75 73 65 |`\fB/\fP|' is use|
|00005ab0| 64 2e 0a 58 54 68 65 20 | 6b 65 79 77 6f 72 64 20 |d..XThe |keyword |
|00005ac0| 74 68 61 74 20 69 73 20 | 75 73 65 64 20 69 73 20 |that is |used is |
|00005ad0| 74 68 65 20 66 69 72 73 | 74 20 77 6f 72 64 20 69 |the firs|t word i|
|00005ae0| 6e 20 74 68 65 20 70 72 | 6f 6d 70 74 20 66 69 65 |n the pr|ompt fie|
|00005af0| 6c 64 20 6f 66 20 61 6e | 0a 58 61 72 67 75 6d 65 |ld of an|.Xargume|
|00005b00| 6e 74 20 64 65 73 63 72 | 69 70 74 6f 72 20 65 6e |nt descr|iptor en|
|00005b10| 74 72 79 2e 20 4c 6f 6e | 67 20 6f 70 74 69 6f 6e |try. Lon|g option|
|00005b20| 73 20 61 72 65 20 63 61 | 73 65 20 69 6e 73 65 6e |s are ca|se insen|
|00005b30| 73 69 74 69 76 65 21 0a | 58 55 6e 64 65 72 20 5c |sitive!.|XUnder \|
|00005b40| 73 2d 31 55 4e 49 58 5c | 73 2b 31 2c 20 61 6e 20 |s-1UNIX\|s+1, an |
|00005b50| 61 72 67 75 6d 65 6e 74 | 20 74 6f 20 61 20 6c 6f |argument| to a lo|
|00005b60| 6e 67 20 6f 70 74 69 6f | 6e 20 6d 61 79 20 62 65 |ng optio|n may be|
|00005b70| 20 73 65 70 61 72 61 74 | 65 64 0a 58 66 72 6f 6d | separat|ed.Xfrom|
|00005b80| 20 74 68 65 20 6c 6f 6e | 67 20 6f 70 74 69 6f 6e | the lon|g option|
|00005b90| 20 62 79 20 61 6e 20 65 | 71 75 61 6c 20 73 69 67 | by an e|qual sig|
|00005ba0| 6e 20 28 60 3d 27 29 20 | 6f 72 20 62 79 20 6f 6e |n (`=') |or by on|
|00005bb0| 65 20 6f 72 20 6d 6f 72 | 65 0a 58 77 68 69 74 65 |e or mor|e.Xwhite|
|00005bc0| 73 70 61 63 65 20 63 68 | 61 72 61 63 74 65 72 73 |space ch|aracters|
|00005bd0| 2e 20 20 54 68 75 73 2c | 20 69 66 20 61 6e 20 65 |. Thus,| if an e|
|00005be0| 6e 74 72 79 20 6c 6f 6f | 6b 73 20 6c 69 6b 65 3a |ntry loo|ks like:|
|00005bf0| 0a 58 2e 52 53 0a 58 2e | 73 70 20 34 70 0a 58 2e |.X.RS.X.|sp 4p.X.|
|00005c00| 6e 66 0a 58 2e 66 74 20 | 34 0a 58 5c 5e 27 63 27 |nf.X.ft |4.X\^'c'|
|00005c10| 2c 20 41 52 47 4f 50 54 | 2c 20 61 72 67 49 6e 74 |, ARGOPT|, argInt|
|00005c20| 2c 20 5f 5c 7c 5f 20 26 | 63 6f 75 6e 74 2c 20 22 |, _\|_ &|count, "|
|00005c30| 72 65 70 43 4f 55 4e 54 | 20 28 23 20 6f 66 20 74 |repCOUNT| (# of t|
|00005c40| 69 6d 65 73 20 74 6f 20 | 72 65 70 65 61 74 29 22 |imes to |repeat)"|
|00005c50| 2c 0a 58 2e 66 74 20 52 | 0a 58 2e 66 69 0a 58 2e |,.X.ft R|.X.fi.X.|
|00005c60| 73 70 20 34 70 0a 58 2e | 52 45 0a 58 74 68 65 6e |sp 4p.X.|RE.Xthen|
|00005c70| 20 60 60 5c 66 42 5c 2d | 63 34 5c 66 50 27 27 2c | ``\fB\-|c4\fP'',|
|00005c80| 20 60 60 5c 66 42 2b 72 | 65 70 63 6f 75 6e 74 3d | ``\fB+r|epcount=|
|00005c90| 34 5c 66 50 27 27 2c 20 | 60 60 5c 66 42 2b 63 6f |4\fP'', |``\fB+co|
|00005ca0| 75 6e 74 3d 34 5c 66 50 | 27 27 2c 0a 58 60 60 5c |unt=4\fP|'',.X``\|
|00005cb0| 66 42 2b 72 65 70 63 6f | 75 6e 74 5c 30 34 5c 66 |fB+repco|unt\04\f|
|00005cc0| 50 27 27 2c 20 61 6e 64 | 20 60 60 5c 66 42 2b 63 |P'', and| ``\fB+c|
|00005cd0| 6f 75 6e 74 5c 30 34 5c | 66 50 27 27 20 77 69 6c |ount\04\|fP'' wil|
|00005ce0| 6c 20 61 6c 6c 20 68 61 | 76 65 20 74 68 65 20 73 |l all ha|ve the s|
|00005cf0| 61 6d 65 20 65 66 66 65 | 63 74 2e 0a 58 2e 50 50 |ame effe|ct..X.PP|
|00005d00| 0a 58 54 68 65 20 6c 6f | 6e 67 20 6f 70 74 69 6f |.XThe lo|ng optio|
|00005d10| 6e 20 6e 61 6d 65 73 20 | 66 6f 72 20 60 60 5c 66 |n names |for ``\f|
|00005d20| 42 5c 2d 3f 5c 66 50 27 | 27 20 69 6e 20 74 68 65 |B\-?\fP'|' in the|
|00005d30| 20 64 65 66 61 75 6c 74 | 20 61 72 67 75 6d 65 6e | default| argumen|
|00005d40| 74 20 64 65 73 63 72 69 | 70 74 6f 72 0a 58 61 72 |t descri|ptor.Xar|
|00005d50| 65 20 60 60 5c 66 42 2b | 68 65 6c 70 5c 66 50 27 |e ``\fB+|help\fP'|
|00005d60| 27 20 61 6e 64 20 60 60 | 5c 66 42 2b 3f 5c 66 50 |' and ``|\fB+?\fP|
|00005d70| 27 27 20 28 72 65 73 70 | 65 63 74 69 76 65 6c 79 |'' (resp|ectively|
|00005d80| 29 2e 20 49 6e 20 61 64 | 64 69 74 69 6f 6e 2c 20 |). In ad|dition, |
|00005d90| 60 60 5c 66 42 2b 2b 5c | 66 50 27 27 0a 58 6d 61 |``\fB++\|fP''.Xma|
|00005da0| 79 20 62 65 20 75 73 65 | 64 20 74 6f 20 69 6e 64 |y be use|d to ind|
|00005db0| 69 63 61 74 65 20 74 68 | 65 20 65 6e 64 20 6f 66 |icate th|e end of|
|00005dc0| 20 6f 70 74 69 6f 6e 73 | 20 73 6f 20 74 68 61 74 | options| so that|
|00005dd0| 0a 58 61 6c 6c 20 72 65 | 6d 61 69 6e 69 6e 67 20 |.Xall re|maining |
|00005de0| 61 72 67 75 6d 65 6e 74 | 73 20 77 69 6c 6c 20 62 |argument|s will b|
|00005df0| 65 20 69 6e 74 65 72 70 | 72 65 74 65 64 20 61 73 |e interp|reted as|
|00005e00| 20 70 6f 73 69 74 69 6f | 6e 61 6c 20 70 61 72 61 | positio|nal para|
|00005e10| 6d 65 74 65 72 73 0a 58 | 28 65 76 65 6e 20 69 66 |meters.X|(even if|
|00005e20| 20 6f 6e 65 20 62 65 67 | 69 6e 73 20 77 69 74 68 | one beg|ins with|
|00005e30| 20 61 20 60 5c 66 42 2b | 5c 66 50 27 20 6f 72 20 | a `\fB+|\fP' or |
|00005e40| 61 20 60 5c 66 42 5c 2d | 5c 66 50 27 29 2e 0a 58 |a `\fB\-|\fP')..X|
|00005e50| 2e 50 50 0a 58 55 6e 64 | 65 72 20 5c 73 2d 31 4d |.PP.XUnd|er \s-1M|
|00005e60| 53 2d 44 4f 53 5c 73 2b | 31 2c 20 61 6e 64 20 5c |S-DOS\s+|1, and \|
|00005e70| 73 2d 31 4f 53 5c 73 2b | 31 2f 32 2c 20 61 6e 20 |s-1OS\s+|1/2, an |
|00005e80| 61 72 67 75 6d 65 6e 74 | 20 74 6f 20 61 20 6c 6f |argument| to a lo|
|00005e90| 6e 67 2d 6f 70 74 69 6f | 6e 20 6d 75 73 74 20 62 |ng-optio|n must b|
|00005ea0| 65 0a 58 73 65 70 61 72 | 61 74 65 64 20 66 72 6f |e.Xsepar|ated fro|
|00005eb0| 6d 20 74 68 65 20 6c 6f | 6e 67 20 6f 70 74 69 6f |m the lo|ng optio|
|00005ec0| 6e 20 62 79 20 61 6e 20 | 65 71 75 61 6c 20 73 69 |n by an |equal si|
|00005ed0| 67 6e 20 28 60 3d 27 29 | 20 28 75 6e 6c 65 73 73 |gn (`=')| (unless|
|00005ee0| 20 74 68 65 20 66 69 72 | 73 74 0a 58 63 68 61 72 | the fir|st.Xchar|
|00005ef0| 61 63 74 65 72 20 6f 66 | 20 24 53 57 49 54 43 48 |acter of| $SWITCH|
|00005f00| 41 52 20 69 73 20 61 20 | 60 5c 2d 27 2c 20 69 6e |AR is a |`\-', in|
|00005f10| 20 77 68 69 63 68 20 63 | 61 73 65 20 5c 73 2d 31 | which c|ase \s-1|
|00005f20| 55 4e 49 58 5c 73 2b 31 | 20 73 79 6e 74 61 78 20 |UNIX\s+1| syntax |
|00005f30| 69 73 20 75 73 65 64 29 | 2e 0a 58 54 68 65 20 6c |is used)|..XThe l|
|00005f40| 6f 6e 67 20 6f 70 74 69 | 6f 6e 20 6e 61 6d 65 73 |ong opti|on names|
|00005f50| 20 66 6f 72 20 60 60 5c | 66 42 2f 3f 5c 66 50 27 | for ``\|fB/?\fP'|
|00005f60| 27 20 69 6e 20 74 68 65 | 20 64 65 66 61 75 6c 74 |' in the| default|
|00005f70| 20 61 72 67 75 6d 65 6e | 74 20 64 65 73 63 72 69 | argumen|t descri|
|00005f80| 70 74 6f 72 0a 58 61 72 | 65 20 60 60 5c 66 42 2f |ptor.Xar|e ``\fB/|
|00005f90| 68 65 6c 70 5c 66 50 27 | 27 20 61 6e 64 20 60 60 |help\fP'|' and ``|
|00005fa0| 5c 66 42 2f 3f 5c 66 50 | 27 27 20 28 72 65 73 70 |\fB/?\fP|'' (resp|
|00005fb0| 65 63 74 69 76 65 6c 79 | 29 2e 0a 58 2e 50 50 0a |ectively|)..X.PP.|
|00005fc0| 58 55 6e 64 65 72 20 56 | 41 58 2f 56 4d 53 20 61 |XUnder V|AX/VMS a|
|00005fd0| 6e 64 20 41 6d 69 67 61 | 44 4f 53 2c 20 73 69 6e |nd Amiga|DOS, sin|
|00005fe0| 67 6c 65 2d 63 68 61 72 | 61 63 74 65 72 20 6f 70 |gle-char|acter op|
|00005ff0| 74 69 6f 6e 73 20 61 72 | 65 20 6e 6f 74 20 75 73 |tions ar|e not us|
|00006000| 65 64 20 61 6e 64 20 74 | 68 65 0a 58 60 60 6c 6f |ed and t|he.X``lo|
|00006010| 6e 67 27 27 20 6e 61 6d | 65 20 28 69 6e 20 74 68 |ng'' nam|e (in th|
|00006020| 65 20 70 72 6f 6d 70 74 | 20 66 69 65 6c 64 20 6f |e prompt| field o|
|00006030| 66 20 61 6e 20 61 72 67 | 75 6d 65 6e 74 20 64 65 |f an arg|ument de|
|00006040| 73 63 72 69 70 74 6f 72 | 29 20 69 73 20 61 6c 77 |scriptor|) is alw|
|00006050| 61 79 73 20 75 73 65 64 | 0a 58 74 6f 20 6d 61 74 |ays used|.Xto mat|
|00006060| 63 68 20 66 6f 72 20 70 | 6f 73 73 69 62 6c 65 20 |ch for p|ossible |
|00006070| 61 72 67 75 6d 65 6e 74 | 73 20 28 6f 72 20 6b 65 |argument|s (or ke|
|00006080| 79 77 6f 72 64 73 2c 20 | 6f 72 20 71 75 61 6c 69 |ywords, |or quali|
|00006090| 66 69 65 72 73 29 2e 0a | 58 2e 50 50 0a 58 46 6f |fiers)..|X.PP.XFo|
|000060a0| 72 20 61 6c 6c 20 73 75 | 70 70 6f 72 74 65 64 20 |r all su|pported |
|000060b0| 6f 70 65 72 61 74 69 6e | 67 20 73 79 73 74 65 6d |operatin|g system|
|000060c0| 73 2c 20 61 20 6c 6f 6e | 67 20 6f 70 74 69 6f 6e |s, a lon|g option|
|000060d0| 20 6d 61 79 20 62 65 20 | 6d 61 74 63 68 65 64 20 | may be |matched |
|000060e0| 69 6e 20 6f 6e 65 20 6f | 66 0a 58 74 77 6f 20 77 |in one o|f.Xtwo w|
|000060f0| 61 79 73 3a 20 69 74 20 | 6d 61 79 20 6d 61 74 63 |ays: it |may matc|
|00006100| 68 20 61 6c 6c 20 75 70 | 70 65 72 63 61 73 65 20 |h all up|percase |
|00006110| 63 68 61 72 61 63 74 65 | 72 73 20 69 6e 20 74 68 |characte|rs in th|
|00006120| 65 20 70 72 6f 6d 70 74 | 20 66 69 65 6c 64 2c 20 |e prompt| field, |
|00006130| 6f 72 20 69 74 20 6d 61 | 79 0a 58 6d 61 74 63 68 |or it ma|y.Xmatch|
|00006140| 20 61 6c 6c 20 63 68 61 | 72 61 63 74 65 72 73 20 | all cha|racters |
|00006150| 69 6e 20 74 68 65 20 70 | 72 6f 6d 70 74 20 66 69 |in the p|rompt fi|
|00006160| 65 6c 64 20 28 61 73 20 | 69 6e 20 60 60 5c 66 42 |eld (as |in ``\fB|
|00006170| 2b 63 6f 75 6e 74 3d 34 | 5c 66 50 27 27 20 61 6e |+count=4|\fP'' an|
|00006180| 64 0a 58 60 60 5c 66 42 | 2b 72 65 70 63 6f 75 6e |d.X``\fB|+repcoun|
|00006190| 74 3d 34 5c 66 50 27 27 | 29 2e 0a 58 2e 50 50 0a |t=4\fP''|)..X.PP.|
|000061a0| 58 55 6e 64 65 72 20 61 | 6c 6c 20 73 79 73 74 65 |XUnder a|ll syste|
|000061b0| 6d 73 20 65 78 63 65 70 | 74 20 41 6d 69 67 61 44 |ms excep|t AmigaD|
|000061c0| 4f 53 2c 0a 58 6f 6e 6c | 79 20 74 68 65 20 6e 75 |OS,.Xonl|y the nu|
|000061d0| 6d 62 65 72 20 6f 66 20 | 63 68 61 72 61 63 74 65 |mber of |characte|
|000061e0| 72 73 20 72 65 71 75 69 | 72 65 64 20 74 6f 20 75 |rs requi|red to u|
|000061f0| 6e 69 71 75 65 6c 79 20 | 69 64 65 6e 74 69 66 79 |niquely |identify|
|00006200| 20 74 68 65 20 64 65 73 | 69 72 65 64 20 61 72 67 | the des|ired arg|
|00006210| 75 6d 65 6e 74 0a 58 61 | 72 65 20 6e 65 65 64 65 |ument.Xa|re neede|
|00006220| 64 2c 20 62 75 74 20 61 | 74 20 6c 65 61 73 74 20 |d, but a|t least |
|00006230| 74 77 6f 20 63 68 61 72 | 61 63 74 65 72 73 20 6d |two char|acters m|
|00006240| 75 73 74 20 62 65 20 67 | 69 76 65 6e 20 28 75 6e |ust be g|iven (un|
|00006250| 6c 65 73 73 20 74 68 65 | 20 70 72 6f 6d 70 74 20 |less the| prompt |
|00006260| 66 69 65 6c 64 0a 58 69 | 73 20 69 74 73 65 6c 66 |field.Xi|s itself|
|00006270| 20 6c 65 73 73 20 74 68 | 61 6e 20 74 77 6f 20 63 | less th|an two c|
|00006280| 68 61 72 61 63 74 65 72 | 73 20 6c 6f 6e 67 29 2e |haracter|s long).|
|00006290| 20 54 68 69 73 20 6d 65 | 61 6e 73 20 74 68 61 74 | This me|ans that|
|000062a0| 20 75 73 69 6e 67 20 74 | 68 65 20 61 62 6f 76 65 | using t|he above|
|000062b0| 0a 58 65 78 61 6d 70 6c | 65 2c 20 74 68 61 74 20 |.Xexampl|e, that |
|000062c0| 60 60 5c 66 42 2b 72 65 | 70 3d 34 5c 66 50 27 27 |``\fB+re|p=4\fP''|
|000062d0| 20 61 6e 64 0a 58 60 60 | 5c 66 42 2b 63 6f 75 3d | and.X``|\fB+cou=|
|000062e0| 34 5c 66 50 27 27 20 77 | 6f 75 6c 64 20 61 6c 73 |4\fP'' w|ould als|
|000062f0| 6f 20 77 6f 72 6b 20 62 | 75 74 20 60 60 5c 66 42 |o work b|ut ``\fB|
|00006300| 2b 63 3d 34 5c 66 50 27 | 27 20 77 6f 75 6c 64 20 |+c=4\fP'|' would |
|00006310| 5c 73 2d 31 4e 4f 54 5c | 73 2b 31 20 28 69 6e 20 |\s-1NOT\|s+1 (in |
|00006320| 6f 74 68 65 72 20 77 6f | 72 64 73 2c 20 69 66 0a |other wo|rds, if.|
|00006330| 58 79 6f 75 20 6f 6e 6c | 79 20 77 61 6e 74 20 74 |Xyou onl|y want t|
|00006340| 6f 20 75 73 65 20 6f 6e | 65 20 63 68 61 72 61 63 |o use on|e charac|
|00006350| 74 65 72 2c 20 75 73 65 | 20 60 60 5c 66 42 5c 2d |ter, use| ``\fB\-|
|00006360| 63 34 5c 66 50 27 27 20 | 69 6e 73 74 65 61 64 29 |c4\fP'' |instead)|
|00006370| 2e 0a 58 2e 50 50 0a 58 | 55 6e 64 65 72 20 56 41 |..X.PP.X|Under VA|
|00006380| 58 2f 56 4d 53 2c 20 74 | 68 65 20 70 6f 73 73 69 |X/VMS, t|he possi|
|00006390| 62 69 6c 69 74 69 65 73 | 20 75 73 69 6e 67 20 74 |bilities| using t|
|000063a0| 68 65 20 61 62 6f 76 65 | 20 65 78 61 6d 70 6c 65 |he above| example|
|000063b0| 20 77 6f 75 6c 64 20 62 | 65 3a 0a 58 60 60 5c 66 | would b|e:.X``\f|
|000063c0| 42 2f 52 45 50 43 4f 55 | 4e 54 3d 34 5c 66 50 27 |B/REPCOU|NT=4\fP'|
|000063d0| 27 2c 20 60 60 5c 66 42 | 2f 43 4f 55 4e 54 3d 34 |', ``\fB|/COUNT=4|
|000063e0| 5c 66 50 27 27 2c 20 60 | 60 5c 66 42 2f 52 45 50 |\fP'', `|`\fB/REP|
|000063f0| 3d 34 5c 66 50 27 27 2c | 20 61 6e 64 20 60 60 5c |=4\fP'',| and ``\|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.
