home *** CD-ROM | disk | FTP | other *** search
open in: 
MacOS 8.1
|
Win98
|
DOS
view JSON data
|
view as text
This file was processed as: SHell self-extracting ARchive
(archive/shar).
You can browse this item here: 2277
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 100%
| dexvert
| Newsgroup Content (archive/news)
| magic
| Supported |
| 100%
| dexvert
| SHell self-extracting ARchive (archive/shar)
| magic
| Supported |
| 100%
| dexvert
| Internet Message Format (text/imf)
| magic
| Supported |
| 1%
| dexvert
| Text File (text/txt)
| fallback
| Supported |
| 100%
| file
| news or mail, ASCII text
| default
| |
| 100%
| TrID
| E-Mail message (Var. 2)
| default
| |
| 100%
| checkBytes
| Printable ASCII
| default
| |
| 100%
| perlTextCheck
| Likely Text (Perl)
| default
| |
| 100%
| siegfried
| fmt/329 Shell Archive Format
| default
| |
| 100%
| detectItEasy
| Format: plain text[LF]
| default (weak)
| |
| 100%
| xdgMime
| message/rfc822
| default
|
|
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 46 72 6f 6d 3a 20 74 6f | 6d 40 73 73 64 2e 63 73 |From: to|m@ssd.cs|
|00000010| 64 2e 68 61 72 72 69 73 | 2e 63 6f 6d 20 28 54 6f |d.harris|.com (To|
|00000020| 6d 20 48 6f 72 73 6c 65 | 79 29 0a 4e 65 77 73 67 |m Horsle|y).Newsg|
|00000030| 72 6f 75 70 73 3a 20 61 | 6c 74 2e 73 6f 75 72 63 |roups: a|lt.sourc|
|00000040| 65 73 0a 53 75 62 6a 65 | 63 74 3a 20 6d 6b 69 64 |es.Subje|ct: mkid|
|00000050| 20 30 34 2f 31 31 20 28 | 69 64 65 6e 74 69 66 69 | 04/11 (|identifi|
|00000060| 65 72 20 63 72 6f 73 73 | 20 72 65 66 65 72 65 6e |er cross| referen|
|00000070| 63 65 20 74 6f 6f 6c 29 | 0a 4d 65 73 73 61 67 65 |ce tool)|.Message|
|00000080| 2d 49 44 3a 20 3c 54 4f | 4d 2e 39 30 44 65 63 31 |-ID: <TO|M.90Dec1|
|00000090| 32 30 39 34 32 31 32 40 | 68 63 78 32 2e 73 73 64 |2094212@|hcx2.ssd|
|000000a0| 2e 63 73 64 2e 68 61 72 | 72 69 73 2e 63 6f 6d 3e |.csd.har|ris.com>|
|000000b0| 0a 44 61 74 65 3a 20 31 | 32 20 44 65 63 20 39 30 |.Date: 1|2 Dec 90|
|000000c0| 20 31 34 3a 34 32 3a 31 | 32 20 47 4d 54 0a 0a 23 | 14:42:1|2 GMT..#|
|000000d0| 21 20 2f 62 69 6e 2f 73 | 68 0a 23 20 54 68 69 73 |! /bin/s|h.# This|
|000000e0| 20 69 73 20 61 20 73 68 | 65 6c 6c 20 61 72 63 68 | is a sh|ell arch|
|000000f0| 69 76 65 2e 20 20 52 65 | 6d 6f 76 65 20 61 6e 79 |ive. Re|move any|
|00000100| 74 68 69 6e 67 20 62 65 | 66 6f 72 65 20 74 68 69 |thing be|fore thi|
|00000110| 73 20 6c 69 6e 65 2c 20 | 74 68 65 6e 20 75 6e 70 |s line, |then unp|
|00000120| 61 63 6b 0a 23 20 69 74 | 20 62 79 20 73 61 76 69 |ack.# it| by savi|
|00000130| 6e 67 20 69 74 20 69 6e | 74 6f 20 61 20 66 69 6c |ng it in|to a fil|
|00000140| 65 20 61 6e 64 20 74 79 | 70 69 6e 67 20 22 73 68 |e and ty|ping "sh|
|00000150| 20 66 69 6c 65 22 2e 20 | 20 54 6f 20 6f 76 65 72 | file". | To over|
|00000160| 77 72 69 74 65 20 65 78 | 69 73 74 69 6e 67 0a 23 |write ex|isting.#|
|00000170| 20 66 69 6c 65 73 2c 20 | 74 79 70 65 20 22 73 68 | files, |type "sh|
|00000180| 20 66 69 6c 65 20 2d 63 | 22 2e 20 20 59 6f 75 20 | file -c|". You |
|00000190| 63 61 6e 20 61 6c 73 6f | 20 66 65 65 64 20 74 68 |can also| feed th|
|000001a0| 69 73 20 61 73 20 73 74 | 61 6e 64 61 72 64 20 69 |is as st|andard i|
|000001b0| 6e 70 75 74 20 76 69 61 | 0a 23 20 75 6e 73 68 61 |nput via|.# unsha|
|000001c0| 72 2c 20 6f 72 20 62 79 | 20 74 79 70 69 6e 67 20 |r, or by| typing |
|000001d0| 22 73 68 20 3c 66 69 6c | 65 22 2c 20 65 2e 67 2e |"sh <fil|e", e.g.|
|000001e0| 2e 20 20 49 66 20 74 68 | 69 73 20 61 72 63 68 69 |. If th|is archi|
|000001f0| 76 65 20 69 73 20 63 6f | 6d 70 6c 65 74 65 2c 20 |ve is co|mplete, |
|00000200| 79 6f 75 0a 23 20 77 69 | 6c 6c 20 73 65 65 20 74 |you.# wi|ll see t|
|00000210| 68 65 20 66 6f 6c 6c 6f | 77 69 6e 67 20 6d 65 73 |he follo|wing mes|
|00000220| 73 61 67 65 20 61 74 20 | 74 68 65 20 65 6e 64 3a |sage at |the end:|
|00000230| 0a 23 09 09 22 45 6e 64 | 20 6f 66 20 61 72 63 68 |.#.."End| of arch|
|00000240| 69 76 65 20 34 20 28 6f | 66 20 31 31 29 2e 22 0a |ive 4 (o|f 11).".|
|00000250| 23 20 43 6f 6e 74 65 6e | 74 73 3a 20 20 69 69 64 |# Conten|ts: iid|
|00000260| 2e 31 20 6c 69 64 2e 31 | 20 6d 6b 69 64 2e 31 0a |.1 lid.1| mkid.1.|
|00000270| 23 20 57 72 61 70 70 65 | 64 20 62 79 20 74 6f 6d |# Wrappe|d by tom|
|00000280| 40 68 63 78 32 20 6f 6e | 20 57 65 64 20 44 65 63 |@hcx2 on| Wed Dec|
|00000290| 20 31 32 20 30 37 3a 32 | 31 3a 35 36 20 31 39 39 | 12 07:2|1:56 199|
|000002a0| 30 0a 50 41 54 48 3d 2f | 62 69 6e 3a 2f 75 73 72 |0.PATH=/|bin:/usr|
|000002b0| 2f 62 69 6e 3a 2f 75 73 | 72 2f 75 63 62 20 3b 20 |/bin:/us|r/ucb ; |
|000002c0| 65 78 70 6f 72 74 20 50 | 41 54 48 0a 69 66 20 74 |export P|ATH.if t|
|000002d0| 65 73 74 20 2d 66 20 27 | 69 69 64 2e 31 27 20 2d |est -f '|iid.1' -|
|000002e0| 61 20 22 24 7b 31 7d 22 | 20 21 3d 20 22 2d 63 22 |a "${1}"| != "-c"|
|000002f0| 20 3b 20 74 68 65 6e 20 | 0a 20 20 65 63 68 6f 20 | ; then |. echo |
|00000300| 73 68 61 72 3a 20 57 69 | 6c 6c 20 6e 6f 74 20 63 |shar: Wi|ll not c|
|00000310| 6c 6f 62 62 65 72 20 65 | 78 69 73 74 69 6e 67 20 |lobber e|xisting |
|00000320| 66 69 6c 65 20 5c 22 27 | 69 69 64 2e 31 27 5c 22 |file \"'|iid.1'\"|
|00000330| 0a 65 6c 73 65 0a 65 63 | 68 6f 20 73 68 61 72 3a |.else.ec|ho shar:|
|00000340| 20 45 78 74 72 61 63 74 | 69 6e 67 20 5c 22 27 69 | Extract|ing \"'i|
|00000350| 69 64 2e 31 27 5c 22 20 | 5c 28 35 33 30 36 20 63 |id.1'\" |\(5306 c|
|00000360| 68 61 72 61 63 74 65 72 | 73 5c 29 0a 73 65 64 20 |haracter|s\).sed |
|00000370| 22 73 2f 5e 58 2f 2f 22 | 20 3e 27 69 69 64 2e 31 |"s/^X//"| >'iid.1|
|00000380| 27 20 3c 3c 27 45 4e 44 | 5f 4f 46 5f 46 49 4c 45 |' <<'END|_OF_FILE|
|00000390| 27 0a 58 2e 54 48 20 49 | 49 44 20 31 0a 58 2e 53 |'.X.TH I|ID 1.X.S|
|000003a0| 48 20 4e 41 4d 45 0a 58 | 69 69 64 20 5c 2d 20 69 |H NAME.X|iid \- i|
|000003b0| 6e 74 65 72 61 63 74 69 | 76 65 20 71 75 65 72 79 |nteracti|ve query|
|000003c0| 20 66 6f 72 20 49 44 20 | 64 61 74 61 62 61 73 65 | for ID |database|
|000003d0| 0a 58 2e 53 48 20 53 59 | 4e 4f 50 53 49 53 0a 58 |.X.SH SY|NOPSIS.X|
|000003e0| 2e 50 50 0a 58 2e 42 20 | 69 69 64 0a 58 2e 52 42 |.PP.X.B |iid.X.RB|
|000003f0| 20 5b 20 5c 2d 61 5d 0a | 58 2e 52 42 20 5b 20 5c | [ \-a].|X.RB [ \|
|00000400| 2d 63 20 5c 5e 63 6f 6d | 6d 61 6e 64 5d 0a 58 2e |-c \^com|mand].X.|
|00000410| 52 42 20 5b 20 5c 2d 48 | 5d 0a 58 2e 53 48 20 44 |RB [ \-H|].X.SH D|
|00000420| 45 53 43 52 49 50 54 49 | 4f 4e 0a 58 54 68 69 73 |ESCRIPTI|ON.XThis|
|00000430| 20 63 6f 6d 6d 61 6e 64 | 20 70 72 6f 76 69 64 65 | command| provide|
|00000440| 73 20 61 6e 20 69 6e 74 | 65 72 61 63 74 69 76 65 |s an int|eractive|
|00000450| 20 71 75 65 72 79 20 69 | 6e 74 65 72 66 61 63 65 | query i|nterface|
|00000460| 20 74 6f 20 74 68 65 0a | 58 2e 49 20 49 44 0a 58 | to the.|X.I ID.X|
|00000470| 64 61 74 61 62 61 73 65 | 2e 0a 58 2e 49 20 49 69 |database|..X.I Ii|
|00000480| 64 5c 5e 0a 58 61 6c 6c | 6f 77 73 20 79 6f 75 20 |d\^.Xall|ows you |
|00000490| 74 6f 20 71 75 65 72 79 | 20 61 6e 0a 58 2e 49 20 |to query| an.X.I |
|000004a0| 49 44 0a 58 64 61 74 61 | 62 61 73 65 20 69 6e 20 |ID.Xdata|base in |
|000004b0| 61 20 66 61 73 68 69 6f | 6e 20 73 69 6d 69 6c 61 |a fashio|n simila|
|000004c0| 72 20 74 6f 20 75 73 69 | 6e 67 20 5c 66 49 44 49 |r to usi|ng \fIDI|
|000004d0| 41 4c 4f 47 5c 66 50 2e | 20 41 6e 79 20 69 6e 64 |ALOG\fP.| Any ind|
|000004e0| 69 76 69 64 75 61 6c 0a | 58 71 75 65 72 79 20 63 |ividual.|Xquery c|
|000004f0| 6f 6d 6d 61 6e 64 20 72 | 65 73 75 6c 74 73 20 69 |ommand r|esults i|
|00000500| 6e 20 61 20 6c 69 73 74 | 20 6f 66 20 66 69 6c 65 |n a list| of file|
|00000510| 73 20 74 68 61 74 20 73 | 61 74 69 73 66 79 20 74 |s that s|atisfy t|
|00000520| 68 61 74 20 71 75 65 72 | 79 2c 0a 58 65 61 63 68 |hat quer|y,.Xeach|
|00000530| 20 73 65 74 20 6f 66 20 | 66 69 6c 65 73 20 69 73 | set of |files is|
|00000540| 20 72 65 74 61 69 6e 65 | 64 20 62 79 0a 58 2e 49 | retaine|d by.X.I|
|00000550| 20 69 69 64 0a 58 61 6e | 64 20 61 73 73 69 67 6e | iid.Xan|d assign|
|00000560| 65 64 20 61 20 73 65 74 | 20 6e 75 6d 62 65 72 2e |ed a set| number.|
|00000570| 20 54 68 65 20 73 65 74 | 73 20 6d 61 79 20 62 65 | The set|s may be|
|00000580| 20 63 6f 6d 62 69 6e 65 | 64 20 77 69 74 68 0a 58 | combine|d with.X|
|00000590| 2e 49 52 20 41 4e 44 20 | 2c 0a 58 2e 49 20 4f 52 |.IR AND |,.X.I OR|
|000005a0| 0a 58 61 6e 64 0a 58 2e | 49 20 4e 4f 54 0a 58 6f |.Xand.X.|I NOT.Xo|
|000005b0| 70 65 72 61 74 6f 72 73 | 20 74 6f 20 70 72 6f 64 |perators| to prod|
|000005c0| 75 63 65 20 61 64 64 69 | 74 69 6f 6e 61 6c 20 73 |uce addi|tional s|
|000005d0| 65 74 73 2e 20 54 68 65 | 20 70 72 69 6d 69 74 69 |ets. The| primiti|
|000005e0| 76 65 20 6f 70 65 72 61 | 74 6f 72 73 20 74 68 61 |ve opera|tors tha|
|000005f0| 74 0a 58 70 72 6f 64 75 | 63 65 20 73 65 74 73 20 |t.Xprodu|ce sets |
|00000600| 61 72 65 20 69 6e 76 6f | 63 61 74 69 6f 6e 73 20 |are invo|cations |
|00000610| 6f 66 20 74 68 65 0a 58 | 2e 49 20 6c 69 64 0a 58 |of the.X|.I lid.X|
|00000620| 6f 72 0a 58 2e 49 20 61 | 69 64 0a 58 70 72 6f 67 |or.X.I a|id.Xprog|
|00000630| 72 61 6d 73 2e 0a 58 2e | 53 48 20 4f 50 54 49 4f |rams..X.|SH OPTIO|
|00000640| 4e 53 0a 58 4e 6f 72 6d | 61 6c 6c 79 0a 58 2e 49 |NS.XNorm|ally.X.I|
|00000650| 20 69 69 64 0a 58 72 75 | 6e 73 20 69 6e 74 65 72 | iid.Xru|ns inter|
|00000660| 61 63 74 69 76 65 6c 79 | 2e 20 4f 70 74 69 6f 6e |actively|. Option|
|00000670| 73 20 6d 61 79 20 62 65 | 20 75 73 65 64 20 74 6f |s may be| used to|
|00000680| 20 72 75 6e 20 69 74 20 | 69 6e 20 62 61 74 63 68 | run it |in batch|
|00000690| 20 6d 6f 64 65 2e 0a 58 | 2e 54 50 20 38 0a 58 2e | mode..X|.TP 8.X.|
|000006a0| 42 20 5c 2d 61 0a 58 55 | 73 65 20 74 68 65 0a 58 |B \-a.XU|se the.X|
|000006b0| 2e 49 20 61 69 64 0a 58 | 70 72 6f 67 72 61 6d 20 |.I aid.X|program |
|000006c0| 61 73 20 74 68 65 20 64 | 65 66 61 75 6c 74 20 71 |as the d|efault q|
|000006d0| 75 65 72 79 20 70 72 6f | 67 72 61 6d 2c 20 6e 6f |uery pro|gram, no|
|000006e0| 72 6d 61 6c 6c 79 0a 58 | 2e 49 20 6c 69 64 0a 58 |rmally.X|.I lid.X|
|000006f0| 69 73 20 75 73 65 64 2e | 0a 58 2e 54 50 20 38 0a |is used.|.X.TP 8.|
|00000700| 58 2e 42 20 5c 2d 63 0a | 58 41 63 63 65 70 74 20 |X.B \-c.|XAccept |
|00000710| 61 20 73 69 6e 67 6c 65 | 20 63 6f 6d 6d 61 6e 64 |a single| command|
|00000720| 20 61 73 20 61 6e 20 61 | 72 67 75 6d 65 6e 74 2c | as an a|rgument,|
|00000730| 20 72 75 6e 20 74 68 61 | 74 20 63 6f 6d 6d 61 6e | run tha|t comman|
|00000740| 64 2c 20 61 6e 64 20 65 | 78 69 74 0a 58 2e 49 52 |d, and e|xit.X.IR|
|00000750| 20 49 69 64 20 2e 0a 58 | 2e 54 50 0a 58 2e 42 20 | Iid ..X|.TP.X.B |
|00000760| 5c 2d 48 0a 58 50 72 69 | 6e 74 20 61 20 62 72 69 |\-H.XPri|nt a bri|
|00000770| 65 66 20 68 65 6c 70 20 | 6d 65 73 73 61 67 65 20 |ef help |message |
|00000780| 61 6e 64 20 65 78 69 74 | 2e 0a 58 2e 53 48 20 53 |and exit|..X.SH S|
|00000790| 55 42 43 4f 4d 4d 41 4e | 44 53 0a 58 54 68 65 20 |UBCOMMAN|DS.XThe |
|000007a0| 73 75 62 63 6f 6d 6d 61 | 6e 64 73 20 61 72 65 20 |subcomma|nds are |
|000007b0| 75 73 65 64 20 74 6f 20 | 63 61 72 72 79 20 6f 6e |used to |carry on|
|000007c0| 20 61 20 64 69 61 6c 6f | 67 20 77 69 74 68 0a 58 | a dialo|g with.X|
|000007d0| 2e 49 20 69 69 64 0a 58 | 61 66 74 65 72 20 69 6e |.I iid.X|after in|
|000007e0| 76 6f 6b 69 6e 67 20 74 | 68 65 20 70 72 6f 67 72 |voking t|he progr|
|000007f0| 61 6d 2e 0a 58 2e 50 50 | 0a 58 54 77 6f 20 62 61 |am..X.PP|.XTwo ba|
|00000800| 73 69 63 20 71 75 65 72 | 79 20 63 6f 6d 6d 61 6e |sic quer|y comman|
|00000810| 64 73 20 61 72 65 20 61 | 76 61 69 6c 61 62 6c 65 |ds are a|vailable|
|00000820| 3a 0a 58 2e 42 20 53 53 | 0a 58 61 6e 64 0a 58 2e |:.X.B SS|.Xand.X.|
|00000830| 42 52 20 46 49 4c 45 53 | 20 2e 0a 58 54 68 65 0a |BR FILES| ..XThe.|
|00000840| 58 2e 42 20 53 53 0a 58 | 63 6f 6d 6d 61 6e 64 20 |X.B SS.X|command |
|00000850| 73 68 6f 77 73 20 74 68 | 65 20 73 65 74 73 20 67 |shows th|e sets g|
|00000860| 65 6e 65 72 61 74 65 64 | 20 62 79 20 61 20 71 75 |enerated| by a qu|
|00000870| 65 72 79 2c 20 62 75 74 | 20 64 6f 65 73 20 6e 6f |ery, but| does no|
|00000880| 74 20 64 69 73 70 6c 61 | 79 0a 58 74 68 65 20 61 |t displa|y.Xthe a|
|00000890| 63 74 75 61 6c 20 66 69 | 6c 65 20 6e 61 6d 65 73 |ctual fi|le names|
|000008a0| 20 74 68 61 74 20 73 61 | 74 69 73 66 79 20 74 68 | that sa|tisfy th|
|000008b0| 65 20 71 75 65 72 79 2e | 0a 58 54 68 65 0a 58 2e |e query.|.XThe.X.|
|000008c0| 42 20 46 49 4c 45 53 0a | 58 63 6f 6d 6d 61 6e 64 |B FILES.|Xcommand|
|000008d0| 20 6f 6e 6c 79 20 64 69 | 73 70 6c 61 79 73 20 74 | only di|splays t|
|000008e0| 68 65 20 6c 69 73 74 20 | 6f 66 20 66 69 6c 65 73 |he list |of files|
|000008f0| 2c 20 69 74 20 64 6f 65 | 73 20 6e 6f 74 20 73 68 |, it doe|s not sh|
|00000900| 6f 77 20 61 6e 79 0a 58 | 6f 66 20 74 68 65 20 73 |ow any.X|of the s|
|00000910| 65 74 73 20 63 72 65 61 | 74 65 64 20 64 75 72 69 |ets crea|ted duri|
|00000920| 6e 67 20 74 68 65 20 71 | 75 65 72 79 2e 0a 58 2e |ng the q|uery..X.|
|00000930| 50 50 0a 58 51 75 65 72 | 69 65 73 20 63 6f 6e 73 |PP.XQuer|ies cons|
|00000940| 69 73 74 20 6f 66 20 6b | 65 79 77 6f 72 64 73 20 |ist of k|eywords |
|00000950| 61 6e 64 20 69 64 65 6e | 74 69 66 69 65 72 20 73 |and iden|tifier s|
|00000960| 74 72 69 6e 67 73 2e 20 | 54 68 65 20 6b 65 79 77 |trings. |The keyw|
|00000970| 6f 72 64 73 20 61 72 65 | 3a 0a 58 2e 42 20 61 6e |ords are|:.X.B an|
|00000980| 64 20 6f 72 20 6e 6f 74 | 20 6c 69 64 20 61 69 64 |d or not| lid aid|
|00000990| 20 6d 61 74 63 68 0a 58 | 61 6e 64 0a 58 2e 42 20 | match.X|and.X.B |
|000009a0| 73 3c 6e 75 6d 62 65 72 | 3e 0a 58 77 68 65 72 65 |s<number|>.Xwhere|
|000009b0| 0a 58 2e 42 20 73 3c 6e | 75 6d 62 65 72 3e 0a 58 |.X.B s<n|umber>.X|
|000009c0| 69 73 20 61 20 73 65 74 | 20 6e 75 6d 62 65 72 20 |is a set| number |
|000009d0| 63 6f 6e 73 69 73 74 69 | 6e 67 20 6f 66 20 74 68 |consisti|ng of th|
|000009e0| 65 20 6c 65 74 74 65 72 | 0a 58 2e 42 20 73 0a 58 |e letter|.X.B s.X|
|000009f0| 66 6f 6c 6c 6f 77 65 64 | 20 28 77 69 74 68 20 6e |followed| (with n|
|00000a00| 6f 20 73 70 61 63 65 29 | 20 62 79 20 61 20 64 65 |o space)| by a de|
|00000a10| 63 69 6d 61 6c 20 73 65 | 74 20 6e 75 6d 62 65 72 |cimal se|t number|
|00000a20| 2e 0a 58 41 20 63 6c 61 | 75 73 65 20 6f 66 20 74 |..XA cla|use of t|
|00000a30| 68 65 20 66 6f 72 6d 0a | 58 2e 42 20 6c 69 64 20 |he form.|X.B lid |
|00000a40| 3c 69 64 65 6e 74 69 66 | 69 65 72 20 6c 69 73 74 |<identif|ier list|
|00000a50| 3e 0a 58 69 6e 76 6f 6b | 65 73 0a 58 2e 49 20 6c |>.Xinvok|es.X.I l|
|00000a60| 69 64 0a 58 77 69 74 68 | 20 74 68 65 0a 58 2e 42 |id.Xwith| the.X.B|
|00000a70| 20 3c 69 64 65 6e 74 69 | 66 69 65 72 20 6c 69 73 | <identi|fier lis|
|00000a80| 74 3e 0a 58 61 73 20 61 | 72 67 75 6d 65 6e 74 73 |t>.Xas a|rguments|
|00000a90| 20 61 6e 64 20 70 72 6f | 64 75 63 65 73 20 61 20 | and pro|duces a |
|00000aa0| 73 65 74 20 6f 66 20 66 | 69 6c 65 73 20 61 73 20 |set of f|iles as |
|00000ab0| 61 20 72 65 73 75 6c 74 | 2e 0a 58 53 75 62 73 74 |a result|..XSubst|
|00000ac0| 69 74 75 74 69 6e 67 0a | 58 2e 42 20 61 69 64 0a |ituting.|X.B aid.|
|00000ad0| 58 66 6f 72 0a 58 2e 42 | 20 6c 69 64 0a 58 72 75 |Xfor.X.B| lid.Xru|
|00000ae0| 6e 73 20 74 68 65 0a 58 | 2e 49 20 61 69 64 0a 58 |ns the.X|.I aid.X|
|00000af0| 70 72 6f 67 72 61 6d 20 | 74 6f 20 67 65 6e 65 72 |program |to gener|
|00000b00| 61 74 65 20 74 68 65 20 | 6c 69 73 74 20 6f 66 20 |ate the |list of |
|00000b10| 66 69 6c 65 73 2e 0a 58 | 41 73 20 61 20 73 68 6f |files..X|As a sho|
|00000b20| 72 74 68 61 6e 64 20 6e | 6f 74 61 74 69 6f 6e 20 |rthand n|otation |
|00000b30| 66 6f 72 0a 58 2e 42 20 | 6c 69 64 20 3c 69 64 65 |for.X.B |lid <ide|
|00000b40| 6e 74 69 66 69 65 72 3e | 0a 58 79 6f 75 20 6d 61 |ntifier>|.Xyou ma|
|00000b50| 79 20 73 69 6d 70 6c 79 | 20 75 73 65 0a 58 2e 42 |y simply| use.X.B|
|00000b60| 20 3c 69 64 65 6e 74 69 | 66 69 65 72 3e 2e 0a 58 | <identi|fier>..X|
|00000b70| 54 68 65 0a 58 2e 42 20 | 6d 61 74 63 68 0a 58 6f |The.X.B |match.Xo|
|00000b80| 70 65 72 61 74 6f 72 20 | 72 75 6e 73 20 74 68 65 |perator |runs the|
|00000b90| 20 73 74 61 6e 64 61 72 | 64 20 73 79 73 74 65 6d | standar|d system|
|00000ba0| 0a 58 2e 49 20 6c 73 0a | 58 75 74 69 6c 69 74 79 |.X.I ls.|Xutility|
|00000bb0| 20 74 6f 20 70 72 6f 64 | 75 63 65 20 61 20 73 65 | to prod|uce a se|
|00000bc0| 74 20 6f 66 20 66 69 6c | 65 73 2e 20 54 68 69 73 |t of fil|es. This|
|00000bd0| 20 61 6c 6c 6f 77 73 20 | 73 65 74 73 20 74 6f 20 | allows |sets to |
|00000be0| 62 65 0a 58 63 6f 6e 73 | 74 72 75 63 74 65 64 20 |be.Xcons|tructed |
|00000bf0| 62 61 73 65 64 20 6f 6e | 20 74 68 65 20 6e 61 6d |based on| the nam|
|00000c00| 65 73 20 6f 66 20 66 69 | 6c 65 73 20 28 75 73 69 |es of fi|les (usi|
|00000c10| 6e 67 20 77 69 6c 64 20 | 63 61 72 64 73 29 0a 58 |ng wild |cards).X|
|00000c20| 72 61 74 68 65 72 20 74 | 68 61 6e 20 63 6f 6e 74 |rather t|han cont|
|00000c30| 65 6e 74 73 2e 0a 58 54 | 68 65 0a 58 2e 42 20 61 |ents..XT|he.X.B a|
|00000c40| 6e 64 20 6f 72 0a 58 61 | 6e 64 0a 58 2e 42 20 6e |nd or.Xa|nd.X.B n|
|00000c50| 6f 74 0a 58 6f 70 65 72 | 61 74 6f 72 73 20 63 61 |ot.Xoper|ators ca|
|00000c60| 6e 20 62 65 20 75 73 65 | 64 20 74 6f 20 63 6f 6d |n be use|d to com|
|00000c70| 62 69 6e 65 20 73 65 74 | 73 20 69 6e 20 74 68 65 |bine set|s in the|
|00000c80| 20 6f 62 76 69 6f 75 73 | 20 66 61 73 68 69 6f 6e | obvious| fashion|
|00000c90| 2e 0a 58 49 66 20 79 6f | 75 20 6e 65 65 64 20 74 |..XIf yo|u need t|
|00000ca0| 6f 20 70 61 73 73 20 61 | 6e 79 20 6f 66 20 74 68 |o pass a|ny of th|
|00000cb0| 65 20 6b 65 79 77 6f 72 | 64 73 20 61 73 20 61 63 |e keywor|ds as ac|
|00000cc0| 74 75 61 6c 20 61 72 67 | 75 6d 65 6e 74 73 20 74 |tual arg|uments t|
|00000cd0| 6f 0a 58 70 72 6f 67 72 | 61 6d 73 2c 20 6f 72 20 |o.Xprogr|ams, or |
|00000ce0| 69 66 20 74 68 65 20 73 | 65 61 72 63 68 20 73 74 |if the s|earch st|
|00000cf0| 72 69 6e 67 73 20 63 6f | 6e 74 61 69 6e 20 61 6e |rings co|ntain an|
|00000d00| 79 20 73 68 65 6c 6c 20 | 65 73 63 61 70 65 0a 58 |y shell |escape.X|
|00000d10| 63 68 61 72 61 63 74 65 | 72 73 20 70 6c 61 63 65 |characte|rs place|
|00000d20| 20 74 68 65 20 61 72 67 | 75 6d 65 6e 74 20 69 6e | the arg|ument in|
|00000d30| 20 71 75 6f 74 65 73 2e | 0a 58 2e 50 50 0a 58 54 | quotes.|.X.PP.XT|
|00000d40| 68 65 0a 58 2e 42 20 4e | 4f 54 0a 58 6f 70 65 72 |he.X.B N|OT.Xoper|
|00000d50| 61 74 6f 72 20 68 61 73 | 20 68 69 67 68 65 73 74 |ator has| highest|
|00000d60| 20 70 72 65 63 65 64 65 | 6e 63 65 2c 20 66 6f 6c | precede|nce, fol|
|00000d70| 6c 6f 77 65 64 20 62 79 | 0a 58 2e 42 20 41 4e 44 |lowed by|.X.B AND|
|00000d80| 0a 58 61 6e 64 0a 58 2e | 42 20 4f 52 0a 58 69 6e |.Xand.X.|B OR.Xin|
|00000d90| 20 74 68 61 74 20 6f 72 | 64 65 72 2e 20 50 61 72 | that or|der. Par|
|00000da0| 65 6e 74 68 65 73 69 73 | 20 6d 61 79 20 62 65 20 |enthesis| may be |
|00000db0| 75 73 65 64 20 66 6f 72 | 20 67 72 6f 75 70 69 6e |used for| groupin|
|00000dc0| 67 2e 0a 58 2e 50 50 0a | 58 54 68 65 20 72 65 6d |g..X.PP.|XThe rem|
|00000dd0| 61 69 6e 69 6e 67 20 63 | 6f 6d 6d 61 6e 64 73 20 |aining c|ommands |
|00000de0| 61 72 65 3a 0a 58 2e 50 | 50 0a 58 2e 42 20 42 45 |are:.X.P|P.X.B BE|
|00000df0| 47 49 4e 20 3c 64 69 72 | 65 63 74 6f 72 79 3e 0a |GIN <dir|ectory>.|
|00000e00| 58 61 63 63 65 70 74 73 | 20 61 20 64 69 72 65 63 |Xaccepts| a direc|
|00000e10| 74 6f 72 79 20 6e 61 6d | 65 20 61 6e 64 20 73 77 |tory nam|e and sw|
|00000e20| 69 74 63 68 65 73 20 74 | 6f 20 74 68 61 74 20 64 |itches t|o that d|
|00000e30| 69 72 65 63 74 6f 72 79 | 2e 20 42 79 20 63 68 61 |irectory|. By cha|
|00000e40| 6e 67 69 6e 67 0a 58 64 | 69 72 65 63 74 6f 72 69 |nging.Xd|irectori|
|00000e50| 65 73 20 79 6f 75 20 63 | 6f 6e 74 72 6f 6c 20 77 |es you c|ontrol w|
|00000e60| 68 69 63 68 0a 58 2e 49 | 20 49 44 0a 58 64 61 74 |hich.X.I| ID.Xdat|
|00000e70| 61 62 61 73 65 20 69 73 | 20 73 65 61 72 63 68 65 |abase is| searche|
|00000e80| 64 2e 20 43 68 61 6e 67 | 69 6e 67 20 64 69 72 65 |d. Chang|ing dire|
|00000e90| 63 74 6f 72 69 65 73 20 | 61 75 74 6f 6d 61 74 69 |ctories |automati|
|00000ea0| 63 61 6c 6c 79 20 64 65 | 6c 65 74 65 73 0a 58 61 |cally de|letes.Xa|
|00000eb0| 6c 6c 20 74 68 65 20 73 | 65 74 73 20 63 6f 6e 73 |ll the s|ets cons|
|00000ec0| 74 72 75 63 74 65 64 20 | 73 6f 20 66 61 72 2e 20 |tructed |so far. |
|00000ed0| 54 68 65 0a 58 2e 42 20 | 42 45 47 49 4e 0a 58 63 |The.X.B |BEGIN.Xc|
|00000ee0| 6f 6d 6d 61 6e 64 20 6d | 61 79 20 62 65 20 61 62 |ommand m|ay be ab|
|00000ef0| 62 72 65 76 69 61 74 65 | 64 20 61 73 0a 58 2e 42 |breviate|d as.X.B|
|00000f00| 52 20 42 20 2e 0a 58 2e | 50 50 0a 58 2e 42 20 53 |R B ..X.|PP.X.B S|
|00000f10| 45 54 53 0a 58 73 68 6f | 77 73 20 74 68 65 20 64 |ETS.Xsho|ws the d|
|00000f20| 65 73 63 72 69 70 74 69 | 6f 6e 20 6f 66 20 61 6c |escripti|on of al|
|00000f30| 6c 20 74 68 65 20 73 65 | 74 73 20 63 72 65 61 74 |l the se|ts creat|
|00000f40| 65 64 20 73 6f 20 66 61 | 72 2e 20 45 61 63 68 20 |ed so fa|r. Each |
|00000f50| 73 65 74 0a 58 64 65 73 | 63 72 69 70 74 69 6f 6e |set.Xdes|cription|
|00000f60| 20 68 61 73 20 74 68 65 | 20 73 65 74 20 6e 75 6d | has the| set num|
|00000f70| 62 65 72 2c 20 74 68 65 | 20 6e 75 6d 62 65 72 20 |ber, the| number |
|00000f80| 6f 66 20 66 69 6c 65 73 | 20 69 6e 20 74 68 65 20 |of files| in the |
|00000f90| 73 65 74 2c 0a 58 61 6e | 64 20 61 20 73 79 6d 62 |set,.Xan|d a symb|
|00000fa0| 6f 6c 69 63 20 64 65 73 | 63 72 69 70 74 69 6f 6e |olic des|cription|
|00000fb0| 20 6f 66 20 74 68 65 20 | 71 75 65 72 79 20 74 68 | of the |query th|
|00000fc0| 61 74 20 63 72 65 61 74 | 65 64 20 74 68 65 20 73 |at creat|ed the s|
|00000fd0| 65 74 2e 0a 58 2e 50 50 | 0a 58 2e 42 20 53 48 4f |et..X.PP|.X.B SHO|
|00000fe0| 57 20 3c 73 65 74 20 6e | 75 6d 62 65 72 3e 0a 58 |W <set n|umber>.X|
|00000ff0| 72 75 6e 73 20 61 20 70 | 61 67 65 72 20 70 72 6f |runs a p|ager pro|
|00001000| 67 72 61 6d 2c 20 70 61 | 73 73 69 6e 67 20 61 73 |gram, pa|ssing as|
|00001010| 20 61 72 67 75 6d 65 6e | 74 73 20 61 6c 6c 20 74 | argumen|ts all t|
|00001020| 68 65 20 66 69 6c 65 73 | 20 69 6e 0a 58 74 68 65 |he files| in.Xthe|
|00001030| 20 73 70 65 63 69 66 69 | 65 64 20 73 65 74 2e 20 | specifi|ed set. |
|00001040| 54 68 65 20 70 61 67 65 | 72 20 70 72 6f 67 72 61 |The page|r progra|
|00001050| 6d 20 63 6f 6d 65 73 20 | 66 72 6f 6d 20 74 68 65 |m comes |from the|
|00001060| 0a 58 2e 42 20 24 50 41 | 47 45 52 0a 58 65 6e 76 |.X.B $PA|GER.Xenv|
|00001070| 69 72 6f 6e 6d 65 6e 74 | 20 76 61 72 69 61 62 6c |ironment| variabl|
|00001080| 65 2e 20 54 68 69 73 20 | 63 6f 6d 6d 61 6e 64 20 |e. This |command |
|00001090| 6d 61 79 20 62 65 20 61 | 62 62 72 65 76 69 61 74 |may be a|bbreviat|
|000010a0| 65 64 0a 58 2e 42 52 20 | 50 20 2e 0a 58 2e 50 50 |ed.X.BR |P ..X.PP|
|000010b0| 0a 58 2e 42 20 48 45 4c | 50 0a 58 72 75 6e 73 20 |.X.B HEL|P.Xruns |
|000010c0| 74 68 65 20 70 61 67 65 | 72 20 6f 6e 20 74 68 65 |the page|r on the|
|000010d0| 20 68 65 6c 70 20 66 69 | 6c 65 2e 20 54 68 65 20 | help fi|le. The |
|000010e0| 63 6f 6d 6d 61 6e 64 73 | 0a 58 2e 42 20 48 0a 58 |commands|.X.B H.X|
|000010f0| 61 6e 64 0a 58 2e 42 20 | 3f 0a 58 61 6c 73 6f 20 |and.X.B |?.Xalso |
|00001100| 61 63 74 20 61 73 20 68 | 65 6c 70 20 63 6f 6d 6d |act as h|elp comm|
|00001110| 61 6e 64 73 2e 0a 58 2e | 50 50 0a 58 2e 42 20 4f |ands..X.|PP.X.B O|
|00001120| 46 46 0a 58 65 78 69 74 | 73 20 74 68 65 20 70 72 |FF.Xexit|s the pr|
|00001130| 6f 67 72 61 6d 2e 0a 58 | 2e 42 20 51 0a 58 69 73 |ogram..X|.B Q.Xis|
|00001140| 20 73 68 6f 72 74 20 66 | 6f 72 0a 58 2e 42 52 20 | short f|or.X.BR |
|00001150| 4f 46 46 20 2e 0a 58 2e | 50 50 0a 58 41 6c 6c 20 |OFF ..X.|PP.XAll |
|00001160| 63 6f 6d 6d 61 6e 64 73 | 20 61 6e 64 20 6b 65 79 |commands| and key|
|00001170| 77 6f 72 64 73 20 61 72 | 65 20 63 61 73 65 20 69 |words ar|e case i|
|00001180| 6e 73 65 6e 73 69 74 69 | 76 65 2c 20 73 6f 20 74 |nsensiti|ve, so t|
|00001190| 68 61 74 0a 58 2e 42 20 | 53 48 4f 57 20 53 68 4f |hat.X.B |SHOW ShO|
|000011a0| 57 0a 58 61 6e 64 0a 58 | 2e 42 20 73 68 6f 77 0a |W.Xand.X|.B show.|
|000011b0| 58 61 6c 6c 20 77 6f 72 | 6b 20 65 71 75 61 6c 6c |Xall wor|k equall|
|000011c0| 79 20 77 65 6c 6c 2e 0a | 58 2e 53 48 20 49 4e 54 |y well..|X.SH INT|
|000011d0| 45 52 46 41 43 45 0a 58 | 54 77 6f 20 66 6f 72 6d |ERFACE.X|Two form|
|000011e0| 73 20 6f 66 20 63 6f 6d | 6d 61 6e 64 73 20 61 72 |s of com|mands ar|
|000011f0| 65 20 70 72 6f 76 69 64 | 65 64 20 66 6f 72 20 69 |e provid|ed for i|
|00001200| 6e 74 65 72 66 61 63 65 | 20 77 69 74 68 20 61 72 |nterface| with ar|
|00001210| 62 69 74 72 61 72 79 0a | 58 70 72 6f 67 72 61 6d |bitrary.|Xprogram|
|00001220| 73 2e 20 41 6e 79 20 63 | 6f 6d 6d 61 6e 64 20 74 |s. Any c|ommand t|
|00001230| 68 61 74 20 69 73 20 6e | 6f 74 20 72 65 63 6f 67 |hat is n|ot recog|
|00001240| 6e 69 7a 65 64 20 61 73 | 20 6f 6e 65 0a 58 6f 66 |nized as| one.Xof|
|00001250| 20 74 68 65 20 61 62 6f | 76 65 20 62 75 69 6c 74 | the abo|ve built|
|00001260| 20 69 6e 0a 58 2e 49 20 | 69 69 64 0a 58 63 6f 6d | in.X.I |iid.Xcom|
|00001270| 6d 61 6e 64 73 2c 20 69 | 73 20 61 73 73 75 6d 65 |mands, i|s assume|
|00001280| 64 20 74 6f 20 62 65 20 | 61 20 70 72 6f 67 72 61 |d to be |a progra|
|00001290| 6d 20 77 68 69 63 68 2c | 20 77 68 65 6e 20 72 75 |m which,| when ru|
|000012a0| 6e 2c 20 77 69 6c 6c 20 | 70 72 69 6e 74 0a 58 61 |n, will |print.Xa|
|000012b0| 20 6c 69 73 74 20 6f 66 | 20 66 69 6c 65 20 6e 61 | list of| file na|
|000012c0| 6d 65 73 2e 0a 58 2e 49 | 20 49 69 64 0a 58 72 75 |mes..X.I| Iid.Xru|
|000012d0| 6e 73 20 74 68 65 20 63 | 6f 6d 6d 61 6e 64 20 61 |ns the c|ommand a|
|000012e0| 73 20 74 79 70 65 64 2c | 20 61 6e 64 20 72 65 63 |s typed,| and rec|
|000012f0| 6f 72 64 73 20 74 68 65 | 20 6f 75 74 70 75 74 20 |ords the| output |
|00001300| 61 73 20 61 20 6e 65 77 | 20 73 65 74 0a 58 77 68 |as a new| set.Xwh|
|00001310| 69 63 68 20 6d 61 79 20 | 62 65 20 63 6f 6d 62 69 |ich may |be combi|
|00001320| 6e 65 64 20 77 69 74 68 | 20 6f 74 68 65 72 20 73 |ned with| other s|
|00001330| 65 74 73 20 69 6e 20 73 | 75 62 73 65 71 75 65 6e |ets in s|ubsequen|
|00001340| 74 20 71 75 65 72 69 65 | 73 2e 0a 58 2e 50 50 0a |t querie|s..X.PP.|
|00001350| 58 49 66 20 74 68 65 20 | 63 6f 6d 6d 61 6e 64 20 |XIf the |command |
|00001360| 73 74 61 72 74 73 20 77 | 69 74 68 20 61 0a 58 2e |starts w|ith a.X.|
|00001370| 42 52 20 21 2c 0a 58 2e | 49 20 69 69 64 0a 58 73 |BR !,.X.|I iid.Xs|
|00001380| 74 72 69 70 73 20 6f 66 | 66 20 74 68 65 20 6c 65 |trips of|f the le|
|00001390| 61 64 69 6e 67 0a 58 2e | 42 20 21 0a 58 61 6e 64 |ading.X.|B !.Xand|
|000013a0| 20 73 69 6d 70 6c 79 20 | 72 75 6e 73 20 74 68 65 | simply |runs the|
|000013b0| 20 63 6f 6d 6d 61 6e 64 | 2e 20 41 6e 79 20 6f 75 | command|. Any ou|
|000013c0| 74 70 75 74 20 67 6f 65 | 73 20 74 6f 20 73 74 64 |tput goe|s to std|
|000013d0| 6f 75 74 20 61 6e 64 0a | 58 69 73 20 6e 6f 74 20 |out and.|Xis not |
|000013e0| 72 65 63 6f 72 64 65 64 | 20 61 73 20 61 20 73 65 |recorded| as a se|
|000013f0| 74 2e 0a 58 2e 50 50 0a | 58 49 6e 20 62 6f 74 68 |t..X.PP.|XIn both|
|00001400| 20 74 79 70 65 73 20 6f | 66 20 73 68 65 6c 6c 20 | types o|f shell |
|00001410| 63 6f 6d 6d 61 6e 64 73 | 2c 20 61 6e 79 20 73 65 |commands|, any se|
|00001420| 74 20 6e 75 6d 62 65 72 | 73 20 73 70 65 63 69 66 |t number|s specif|
|00001430| 69 65 64 20 61 73 0a 58 | 61 72 67 75 6d 65 6e 74 |ied as.X|argument|
|00001440| 73 20 61 72 65 20 65 78 | 70 61 6e 64 65 64 20 69 |s are ex|panded i|
|00001450| 6e 74 6f 20 61 20 6c 69 | 73 74 20 6f 66 20 66 69 |nto a li|st of fi|
|00001460| 6c 65 20 6e 61 6d 65 73 | 20 62 65 66 6f 72 65 20 |le names| before |
|00001470| 72 75 6e 6e 69 6e 67 0a | 58 74 68 65 20 63 6f 6d |running.|Xthe com|
|00001480| 6d 61 6e 64 2e 0a 58 2e | 53 48 20 45 58 41 4d 50 |mand..X.|SH EXAMP|
|00001490| 4c 45 0a 58 2e 6e 66 0a | 58 2e 66 74 20 4c 0a 58 |LE.X.nf.|X.ft L.X|
|000014a0| 3d 3d 3d 3e 20 69 69 64 | 0a 58 69 69 64 3e 20 73 |===> iid|.Xiid> s|
|000014b0| 73 20 6c 69 64 20 22 5e | 67 65 74 22 20 6f 72 20 |s lid "^|get" or |
|000014c0| 6c 69 64 20 22 41 72 67 | 24 22 0a 58 20 20 20 53 |lid "Arg|$".X S|
|000014d0| 30 20 20 20 20 20 31 34 | 20 20 6c 69 64 20 2d 6b |0 14| lid -k|
|000014e0| 6d 6e 20 22 5e 67 65 74 | 22 0a 58 20 20 20 53 31 |mn "^get|".X S1|
|000014f0| 20 20 20 20 20 20 33 20 | 20 6c 69 64 20 2d 6b 6d | 3 | lid -km|
|00001500| 6e 20 22 41 72 67 24 22 | 0a 58 20 20 20 53 32 20 |n "Arg$"|.X S2 |
|00001510| 20 20 20 20 31 35 20 20 | 28 6c 69 64 20 2d 6b 6d | 15 |(lid -km|
|00001520| 6e 20 22 5e 67 65 74 22 | 29 20 4f 52 20 28 6c 69 |n "^get"|) OR (li|
|00001530| 64 20 2d 6b 6d 6e 20 22 | 41 72 67 24 22 29 0a 58 |d -kmn "|Arg$").X|
|00001540| 69 69 64 3e 20 66 20 73 | 31 0a 58 6c 69 64 2e 63 |iid> f s|1.Xlid.c|
|00001550| 0a 58 70 61 74 68 73 2e | 63 0a 58 69 6e 69 74 2e |.Xpaths.|c.Xinit.|
|00001560| 63 0a 58 69 69 64 3e 20 | 6f 66 66 0a 58 2e 46 54 |c.Xiid> |off.X.FT|
|00001570| 20 50 0a 58 2e 66 69 0a | 58 2e 45 58 20 6f 66 66 | P.X.fi.|X.EX off|
|00001580| 0a 58 2e 50 50 0a 58 49 | 6e 20 74 68 69 73 20 65 |.X.PP.XI|n this e|
|00001590| 78 61 6d 70 6c 65 20 74 | 68 65 0a 58 2e 42 20 73 |xample t|he.X.B s|
|000015a0| 73 0a 58 63 6f 6d 6d 61 | 6e 64 20 64 69 73 70 6c |s.Xcomma|nd displ|
|000015b0| 61 79 73 20 74 68 65 20 | 73 65 74 73 20 69 74 20 |ays the |sets it |
|000015c0| 63 72 65 61 74 65 73 20 | 61 73 20 69 74 0a 58 64 |creates |as it.Xd|
|000015d0| 6f 65 73 20 74 68 65 20 | 70 61 72 74 73 20 6f 66 |oes the |parts of|
|000015e0| 20 74 68 65 20 71 75 65 | 72 79 2e 20 49 6e 20 74 | the que|ry. In t|
|000015f0| 68 69 73 20 63 61 73 65 | 20 33 20 73 65 74 73 20 |his case| 3 sets |
|00001600| 61 72 65 20 63 72 65 61 | 74 65 64 2c 20 73 65 74 |are crea|ted, set|
|00001610| 20 53 30 0a 58 68 61 73 | 20 31 34 20 66 69 6c 65 | S0.Xhas| 14 file|
|00001620| 73 20 69 6e 20 69 74 2c | 20 73 65 74 20 53 31 20 |s in it,| set S1 |
|00001630| 68 61 73 20 33 20 66 69 | 6c 65 73 20 61 6e 64 20 |has 3 fi|les and |
|00001640| 74 68 65 20 75 6e 69 6f | 6e 20 6f 66 20 74 68 65 |the unio|n of the|
|00001650| 20 74 77 6f 20 73 65 74 | 73 2c 0a 58 53 32 2c 20 | two set|s,.XS2, |
|00001660| 68 61 73 20 31 35 20 66 | 69 6c 65 73 2e 20 41 20 |has 15 f|iles. A |
|00001670| 64 65 73 63 72 69 70 74 | 69 6f 6e 20 6f 66 20 74 |descript|ion of t|
|00001680| 68 65 20 71 75 65 72 79 | 20 74 68 61 74 20 63 72 |he query| that cr|
|00001690| 65 61 74 65 64 20 61 6e | 79 20 67 69 76 65 6e 0a |eated an|y given.|
|000016a0| 58 73 65 74 20 69 73 20 | 6b 65 70 74 20 61 6c 6f |Xset is |kept alo|
|000016b0| 6e 67 20 77 69 74 68 20 | 74 68 65 20 73 65 74 20 |ng with |the set |
|000016c0| 61 6e 64 20 64 69 73 70 | 6c 61 79 65 64 20 77 68 |and disp|layed wh|
|000016d0| 65 6e 20 73 65 74 73 20 | 61 72 65 20 70 72 69 6e |en sets |are prin|
|000016e0| 74 65 64 2e 0a 58 2e 50 | 50 0a 58 54 68 65 0a 58 |ted..X.P|P.XThe.X|
|000016f0| 2e 42 20 66 20 73 31 0a | 58 63 6f 6d 6d 61 6e 64 |.B f s1.|Xcommand|
|00001700| 20 6c 69 73 74 73 20 74 | 68 65 20 74 68 72 65 65 | lists t|he three|
|00001710| 20 66 69 6c 65 73 20 69 | 6e 20 73 65 74 20 53 31 | files i|n set S1|
|00001720| 2e 0a 58 2e 50 50 0a 58 | 54 68 65 20 0a 58 2e 42 |..X.PP.X|The .X.B|
|00001730| 20 6f 66 66 0a 58 63 6f | 6d 6d 61 6e 64 20 74 65 | off.Xco|mmand te|
|00001740| 72 6d 69 6e 61 74 65 73 | 20 74 68 65 20 65 78 61 |rminates| the exa|
|00001750| 6d 70 6c 65 20 73 65 73 | 73 69 6f 6e 2e 0a 58 2e |mple ses|sion..X.|
|00001760| 53 48 20 48 49 4e 54 53 | 0a 58 54 68 65 20 73 68 |SH HINTS|.XThe sh|
|00001770| 65 6c 6c 20 69 6e 74 65 | 72 66 61 63 65 20 63 6f |ell inte|rface co|
|00001780| 6d 6d 61 6e 64 73 20 63 | 61 6e 20 62 65 20 75 73 |mmands c|an be us|
|00001790| 65 64 20 74 6f 20 67 65 | 6e 65 72 61 74 65 20 66 |ed to ge|nerate f|
|000017a0| 69 6c 65 20 73 65 74 73 | 20 62 79 0a 58 72 75 6e |ile sets| by.Xrun|
|000017b0| 6e 69 6e 67 20 74 68 65 | 0a 58 2e 49 20 66 69 6e |ning the|.X.I fin|
|000017c0| 64 0a 58 6f 72 0a 58 2e | 49 20 6c 73 0a 58 75 74 |d.Xor.X.|I ls.Xut|
|000017d0| 69 6c 69 74 69 65 73 2c | 20 6f 72 20 63 6f 6d 70 |ilities,| or comp|
|000017e0| 69 6c 65 73 20 6f 66 20 | 61 20 73 65 6c 65 63 74 |iles of |a select|
|000017f0| 65 64 20 67 72 6f 75 70 | 20 6f 66 20 66 69 6c 65 |ed group| of file|
|00001800| 73 20 63 61 6e 20 62 65 | 20 64 6f 6e 65 0a 58 75 |s can be| done.Xu|
|00001810| 73 69 6e 67 20 74 68 65 | 0a 58 2e 42 52 20 21 20 |sing the|.X.BR ! |
|00001820| 63 63 0a 58 63 6f 6d 6d | 61 6e 64 20 77 69 74 68 |cc.Xcomm|and with|
|00001830| 20 61 20 73 65 74 20 6e | 75 6d 62 65 72 20 61 73 | a set n|umber as|
|00001840| 20 74 68 65 20 61 72 67 | 75 6d 65 6e 74 2e 0a 58 | the arg|ument..X|
|00001850| 2e 42 52 20 21 20 6c 70 | 0a 58 63 61 6e 20 62 65 |.BR ! lp|.Xcan be|
|00001860| 20 75 73 65 64 20 74 6f | 20 70 72 69 6e 74 20 61 | used to| print a|
|00001870| 20 73 65 6c 65 63 74 65 | 64 20 67 72 6f 75 70 20 | selecte|d group |
|00001880| 6f 66 20 66 69 6c 65 73 | 2e 0a 58 2e 50 50 0a 58 |of files|..X.PP.X|
|00001890| 54 68 69 73 20 70 72 6f | 67 72 61 6d 20 69 6e 74 |This pro|gram int|
|000018a0| 65 72 66 61 63 65 73 20 | 6e 69 63 65 6c 79 20 77 |erfaces |nicely w|
|000018b0| 69 74 68 0a 58 2e 49 20 | 65 6d 61 63 73 0a 58 69 |ith.X.I |emacs.Xi|
|000018c0| 66 20 79 6f 75 20 72 75 | 6e 20 74 68 65 20 73 65 |f you ru|n the se|
|000018d0| 72 76 65 72 20 70 72 6f | 67 72 61 6d 20 61 6e 64 |rver pro|gram and|
|000018e0| 20 73 70 65 63 69 66 79 | 20 74 68 65 20 63 6c 69 | specify| the cli|
|000018f0| 65 6e 74 20 70 72 6f 67 | 72 61 6d 0a 58 61 73 20 |ent prog|ram.Xas |
|00001900| 79 6f 75 72 20 24 50 41 | 47 45 52 2e 0a 58 2e 53 |your $PA|GER..X.S|
|00001910| 48 20 53 45 45 20 41 4c | 53 4f 0a 58 6d 6b 69 64 |H SEE AL|SO.Xmkid|
|00001920| 28 31 29 2c 0a 58 6c 69 | 64 28 31 29 2c 0a 58 61 |(1),.Xli|d(1),.Xa|
|00001930| 69 64 28 31 29 2e 0a 45 | 4e 44 5f 4f 46 5f 46 49 |id(1)..E|ND_OF_FI|
|00001940| 4c 45 0a 69 66 20 74 65 | 73 74 20 35 33 30 36 20 |LE.if te|st 5306 |
|00001950| 2d 6e 65 20 60 77 63 20 | 2d 63 20 3c 27 69 69 64 |-ne `wc |-c <'iid|
|00001960| 2e 31 27 60 3b 20 74 68 | 65 6e 0a 20 20 20 20 65 |.1'`; th|en. e|
|00001970| 63 68 6f 20 73 68 61 72 | 3a 20 5c 22 27 69 69 64 |cho shar|: \"'iid|
|00001980| 2e 31 27 5c 22 20 75 6e | 70 61 63 6b 65 64 20 77 |.1'\" un|packed w|
|00001990| 69 74 68 20 77 72 6f 6e | 67 20 73 69 7a 65 21 0a |ith wron|g size!.|
|000019a0| 66 69 0a 23 20 65 6e 64 | 20 6f 66 20 27 69 69 64 |fi.# end| of 'iid|
|000019b0| 2e 31 27 0a 66 69 0a 69 | 66 20 74 65 73 74 20 2d |.1'.fi.i|f test -|
|000019c0| 66 20 27 6c 69 64 2e 31 | 27 20 2d 61 20 22 24 7b |f 'lid.1|' -a "${|
|000019d0| 31 7d 22 20 21 3d 20 22 | 2d 63 22 20 3b 20 74 68 |1}" != "|-c" ; th|
|000019e0| 65 6e 20 0a 20 20 65 63 | 68 6f 20 73 68 61 72 3a |en . ec|ho shar:|
|000019f0| 20 57 69 6c 6c 20 6e 6f | 74 20 63 6c 6f 62 62 65 | Will no|t clobbe|
|00001a00| 72 20 65 78 69 73 74 69 | 6e 67 20 66 69 6c 65 20 |r existi|ng file |
|00001a10| 5c 22 27 6c 69 64 2e 31 | 27 5c 22 0a 65 6c 73 65 |\"'lid.1|'\".else|
|00001a20| 0a 65 63 68 6f 20 73 68 | 61 72 3a 20 45 78 74 72 |.echo sh|ar: Extr|
|00001a30| 61 63 74 69 6e 67 20 5c | 22 27 6c 69 64 2e 31 27 |acting \|"'lid.1'|
|00001a40| 5c 22 20 5c 28 35 36 37 | 38 20 63 68 61 72 61 63 |\" \(567|8 charac|
|00001a50| 74 65 72 73 5c 29 0a 73 | 65 64 20 22 73 2f 5e 58 |ters\).s|ed "s/^X|
|00001a60| 2f 2f 22 20 3e 27 6c 69 | 64 2e 31 27 20 3c 3c 27 |//" >'li|d.1' <<'|
|00001a70| 45 4e 44 5f 4f 46 5f 46 | 49 4c 45 27 0a 58 2e 54 |END_OF_F|ILE'.X.T|
|00001a80| 48 20 4c 49 44 20 31 0a | 58 2e 53 48 20 4e 41 4d |H LID 1.|X.SH NAM|
|00001a90| 45 0a 58 6c 69 64 2c 20 | 67 69 64 2c 20 65 69 64 |E.Xlid, |gid, eid|
|00001aa0| 2c 20 61 69 64 2c 20 70 | 69 64 20 5c 2d 20 71 75 |, aid, p|id \- qu|
|00001ab0| 65 72 79 20 69 64 20 64 | 61 74 61 62 61 73 65 0a |ery id d|atabase.|
|00001ac0| 58 2e 53 48 20 53 59 4e | 4f 50 53 49 53 0a 58 2e |X.SH SYN|OPSIS.X.|
|00001ad0| 42 20 6c 69 64 0a 58 2e | 52 42 20 5b 20 5c 2d 66 |B lid.X.|RB [ \-f|
|00001ae0| 20 5c 5e 66 69 6c 65 5d | 0a 58 2e 52 42 20 5b 20 | \^file]|.X.RB [ |
|00001af0| 5c 2d 75 20 5c 5e 6e 5d | 0a 58 2e 52 42 20 5b 20 |\-u \^n]|.X.RB [ |
|00001b00| 5c 2d 72 20 5c 5e 64 69 | 72 5d 0a 58 2e 52 42 20 |\-r \^di|r].X.RB |
|00001b10| 5b 20 5c 2d 65 64 6f 78 | 61 6d 73 65 6b 6e 63 5d |[ \-edox|amseknc]|
|00001b20| 0a 58 70 61 74 74 65 72 | 6e 73 2e 2e 2e 0a 58 2e |.Xpatter|ns....X.|
|00001b30| 50 50 0a 58 2e 42 20 67 | 69 64 0a 58 2e 52 42 20 |PP.X.B g|id.X.RB |
|00001b40| 5b 20 5c 2d 66 20 5c 5e | 66 69 6c 65 5d 0a 58 2e |[ \-f \^|file].X.|
|00001b50| 52 42 20 5b 20 5c 2d 72 | 20 5c 5e 64 69 72 5d 0a |RB [ \-r| \^dir].|
|00001b60| 58 2e 52 42 20 5b 20 5c | 2d 65 64 6f 78 61 6d 73 |X.RB [ \|-edoxams|
|00001b70| 65 63 5d 0a 58 70 61 74 | 74 65 72 6e 73 2e 2e 2e |ec].Xpat|terns...|
|00001b80| 0a 58 2e 50 50 0a 58 2e | 42 20 65 69 64 0a 58 2e |.X.PP.X.|B eid.X.|
|00001b90| 52 42 20 5b 20 5c 2d 66 | 20 5c 5e 66 69 6c 65 5d |RB [ \-f| \^file]|
|00001ba0| 0a 58 2e 52 42 20 5b 20 | 5c 2d 72 20 5c 5e 64 69 |.X.RB [ |\-r \^di|
|00001bb0| 72 5d 0a 58 2e 52 42 20 | 5b 20 5c 2d 64 6f 78 61 |r].X.RB |[ \-doxa|
|00001bc0| 6d 73 65 63 5d 0a 58 70 | 61 74 74 65 72 6e 73 2e |msec].Xp|atterns.|
|00001bd0| 2e 2e 0a 58 2e 50 50 0a | 58 2e 42 20 61 69 64 0a |...X.PP.|X.B aid.|
|00001be0| 58 2e 52 42 20 5b 20 5c | 2d 66 20 5c 5e 66 69 6c |X.RB [ \|-f \^fil|
|00001bf0| 65 5d 0a 58 2e 52 42 20 | 5b 20 5c 2d 72 20 5c 5e |e].X.RB |[ \-r \^|
|00001c00| 64 69 72 5d 0a 58 2e 52 | 42 20 5b 20 5c 2d 64 6f |dir].X.R|B [ \-do|
|00001c10| 78 61 6d 73 63 5d 0a 58 | 70 61 74 74 65 72 6e 73 |xamsc].X|patterns|
|00001c20| 2e 2e 2e 0a 58 2e 50 50 | 0a 58 2e 42 20 70 69 64 |....X.PP|.X.B pid|
|00001c30| 0a 58 2e 52 42 20 5b 20 | 5c 2d 66 20 5c 5e 66 69 |.X.RB [ |\-f \^fi|
|00001c40| 6c 65 5d 0a 58 2e 52 42 | 20 5b 20 5c 2d 72 20 5c |le].X.RB| [ \-r \|
|00001c50| 5e 64 69 72 5d 0a 58 2e | 52 42 20 5b 20 5c 2d 65 |^dir].X.|RB [ \-e|
|00001c60| 6b 6e 63 62 5d 0a 58 70 | 61 74 74 65 72 6e 73 2e |kncb].Xp|atterns.|
|00001c70| 2e 2e 0a 58 2e 53 48 20 | 44 45 53 43 52 49 50 54 |...X.SH |DESCRIPT|
|00001c80| 49 4f 4e 0a 58 54 68 65 | 73 65 20 63 6f 6d 6d 61 |ION.XThe|se comma|
|00001c90| 6e 64 73 20 70 72 6f 76 | 69 64 65 20 61 20 66 6c |nds prov|ide a fl|
|00001ca0| 65 78 69 62 6c 65 20 71 | 75 65 72 79 20 69 6e 74 |exible q|uery int|
|00001cb0| 65 72 66 61 63 65 20 74 | 6f 20 74 68 65 0a 58 2e |erface t|o the.X.|
|00001cc0| 49 20 69 64 0a 58 64 61 | 74 61 62 61 73 65 2e 0a |I id.Xda|tabase..|
|00001cd0| 58 2e 49 20 4c 69 64 5c | 5e 0a 58 64 6f 65 73 20 |X.I Lid\|^.Xdoes |
|00001ce0| 61 20 6c 6f 6f 6b 75 70 | 20 6f 6e 0a 58 2e 49 52 |a lookup| on.X.IR|
|00001cf0| 20 70 61 74 74 65 72 73 | 0a 58 61 6e 64 20 70 72 | patters|.Xand pr|
|00001d00| 69 6e 74 73 20 6f 75 74 | 20 6c 69 6e 65 73 20 69 |ints out| lines i|
|00001d10| 6e 20 74 68 69 73 20 77 | 61 79 3a 0a 58 2e 50 50 |n this w|ay:.X.PP|
|00001d20| 0a 58 2e 6e 66 0a 58 69 | 64 6e 61 6d 65 20 20 20 |.X.nf.Xi|dname |
|00001d30| 20 20 20 20 20 2e 2e 2f | 68 64 69 72 2f 68 66 69 | ../|hdir/hfi|
|00001d40| 6c 65 2e 68 20 2e 2e 2f | 63 64 69 72 2f 7b 63 66 |le.h ../|cdir/{cf|
|00001d50| 69 6c 65 31 2c 63 66 69 | 6c 65 32 7d 2e 63 0a 58 |ile1,cfi|le2}.c.X|
|00001d60| 2e 66 69 0a 58 2e 50 50 | 0a 58 4e 6f 74 69 63 65 |.fi.X.PP|.XNotice|
|00001d70| 20 74 68 61 74 20 6d 75 | 6c 74 69 70 6c 65 20 66 | that mu|ltiple f|
|00001d80| 69 6c 65 73 20 77 69 74 | 68 20 74 68 65 20 73 61 |iles wit|h the sa|
|00001d90| 6d 65 20 64 69 72 65 63 | 74 6f 72 79 20 70 72 65 |me direc|tory pre|
|00001da0| 66 69 78 0a 58 61 6e 64 | 20 73 75 66 66 69 78 20 |fix.Xand| suffix |
|00001db0| 61 72 65 20 63 6f 6e 63 | 61 74 65 6e 61 74 65 64 |are conc|atenated|
|00001dc0| 20 69 6e 20 74 68 65 20 | 67 6c 6f 62 62 69 6e 67 | in the |globbing|
|00001dd0| 2d 73 65 74 2d 6e 6f 74 | 61 74 69 6f 6e 20 6f 66 |-set-not|ation of|
|00001de0| 0a 58 2e 49 52 20 63 73 | 68 20 28 31 29 2e 0a 58 |.X.IR cs|h (1)..X|
|00001df0| 41 6c 73 6f 20 6e 6f 74 | 69 63 65 20 74 68 61 74 |Also not|ice that|
|00001e00| 20 61 6c 6c 20 6f 66 20 | 74 68 65 0a 58 2e 49 20 | all of |the.X.I |
|00001e10| 69 64 0a 58 64 61 74 61 | 62 61 73 65 20 71 75 65 |id.Xdata|base que|
|00001e20| 72 79 20 63 6f 6d 6d 61 | 6e 64 73 20 61 64 6a 75 |ry comma|nds adju|
|00001e30| 73 74 20 74 68 65 20 6c | 69 73 74 20 6f 66 20 70 |st the l|ist of p|
|00001e40| 61 74 68 6e 61 6d 65 73 | 20 74 6f 20 62 65 20 72 |athnames| to be r|
|00001e50| 65 6c 61 74 69 76 65 0a | 58 74 6f 20 79 6f 75 72 |elative.|Xto your|
|00001e60| 20 63 75 72 72 65 6e 74 | 20 77 6f 72 6b 69 6e 67 | current| working|
|00001e70| 20 64 69 72 65 63 74 6f | 72 79 2c 20 70 72 6f 76 | directo|ry, prov|
|00001e80| 69 64 65 64 20 74 68 61 | 74 0a 58 2e 49 52 20 6d |ided tha|t.X.IR m|
|00001e90| 6b 69 64 20 28 31 29 0a | 58 77 61 73 20 75 73 65 |kid (1).|Xwas use|
|00001ea0| 64 20 74 6f 20 62 75 69 | 6c 64 20 74 68 65 20 64 |d to bui|ld the d|
|00001eb0| 61 74 61 62 61 73 65 2c | 20 61 6e 64 20 79 6f 75 |atabase,| and you|
|00001ec0| 72 20 77 6f 72 6b 69 6e | 67 20 64 69 72 65 63 74 |r workin|g direct|
|00001ed0| 6f 72 79 0a 58 69 73 20 | 6c 6f 63 61 74 65 64 20 |ory.Xis |located |
|00001ee0| 77 69 74 68 69 6e 20 74 | 68 65 20 73 75 62 2d 74 |within t|he sub-t|
|00001ef0| 72 65 65 20 63 6f 76 65 | 72 65 64 20 62 79 20 74 |ree cove|red by t|
|00001f00| 68 65 0a 58 2e 49 20 69 | 64 0a 58 64 61 74 61 62 |he.X.I i|d.Xdatab|
|00001f10| 61 73 65 2e 0a 58 2e 50 | 50 0a 58 49 66 20 6d 75 |ase..X.P|P.XIf mu|
|00001f20| 6c 74 69 70 6c 65 20 6e | 61 6d 65 73 20 6d 61 74 |ltiple n|ames mat|
|00001f30| 63 68 20 6f 6e 20 70 61 | 74 74 65 72 6e 2c 20 74 |ch on pa|ttern, t|
|00001f40| 68 65 6e 20 74 68 65 72 | 65 20 77 69 6c 6c 20 62 |hen ther|e will b|
|00001f50| 65 20 6f 6e 65 20 6c 69 | 6e 65 0a 58 6f 66 20 6f |e one li|ne.Xof o|
|00001f60| 75 74 70 75 74 20 70 65 | 72 20 6e 61 6d 65 2e 20 |utput pe|r name. |
|00001f70| 20 54 68 65 20 6d 6e 65 | 6d 6f 6e 69 63 20 73 69 | The mne|monic si|
|00001f80| 67 6e 69 66 69 63 61 6e | 63 65 20 6f 66 20 74 68 |gnifican|ce of th|
|00001f90| 65 20 6e 61 6d 65 20 69 | 73 0a 58 5c 66 49 5c 7c |e name i|s.X\fI\||
|00001fa0| 6c 28 6f 6f 6b 75 70 29 | 20 69 64 5c 66 50 2e 0a |l(ookup)| id\fP..|
|00001fb0| 58 2e 50 50 0a 58 2e 49 | 20 47 69 64 0a 58 64 6f |X.PP.X.I| Gid.Xdo|
|00001fc0| 65 73 20 61 20 6c 6f 6f | 6b 75 70 20 61 6e 64 20 |es a loo|kup and |
|00001fd0| 74 68 65 6e 20 73 65 61 | 72 63 68 65 73 20 66 6f |then sea|rches fo|
|00001fe0| 72 20 74 68 65 20 6e 61 | 6d 65 73 20 69 74 20 6d |r the na|mes it m|
|00001ff0| 61 74 63 68 65 73 20 69 | 6e 20 74 68 65 0a 58 66 |atches i|n the.Xf|
|00002000| 69 6c 65 73 20 77 68 65 | 72 65 20 74 68 65 79 20 |iles whe|re they |
|00002010| 6f 63 63 75 72 2e 20 20 | 54 68 65 20 6d 6e 65 6d |occur. |The mnem|
|00002020| 6f 6e 69 63 20 66 6f 72 | 20 74 68 69 73 20 6e 61 |onic for| this na|
|00002030| 6d 65 20 69 73 0a 58 5c | 66 49 5c 7c 67 28 72 65 |me is.X\|fI\|g(re|
|00002040| 70 29 69 64 5c 66 50 2e | 20 0a 58 2e 50 50 0a 58 |p)id\fP.| .X.PP.X|
|00002050| 2e 49 20 45 69 64 0a 58 | 64 6f 65 73 20 61 20 6c |.I Eid.X|does a l|
|00002060| 6f 6f 6b 75 70 2c 20 61 | 6e 64 20 74 68 65 6e 20 |ookup, a|nd then |
|00002070| 69 6e 76 6f 6b 65 73 20 | 61 6e 20 65 64 69 74 6f |invokes |an edito|
|00002080| 72 20 6f 6e 20 61 6c 6c | 20 66 69 6c 65 73 20 77 |r on all| files w|
|00002090| 69 74 68 0a 58 74 68 65 | 20 6d 61 74 63 68 65 64 |ith.Xthe| matched|
|000020a0| 20 6e 61 6d 65 20 61 73 | 20 61 6e 20 69 6e 69 74 | name as| an init|
|000020b0| 69 61 6c 20 73 65 61 72 | 63 68 20 73 74 72 69 6e |ial sear|ch strin|
|000020c0| 67 2e 20 20 4f 66 20 63 | 6f 75 72 73 65 2c 20 74 |g. Of c|ourse, t|
|000020d0| 68 69 73 0a 58 6e 61 6d | 65 20 73 74 61 6e 64 73 |his.Xnam|e stands|
|000020e0| 20 66 6f 72 0a 58 5c 66 | 49 5c 7c 65 28 64 69 74 | for.X\f|I\|e(dit|
|000020f0| 29 20 69 64 5c 66 50 2e | 0a 58 2e 50 50 0a 58 2e |) id\fP.|.X.PP.X.|
|00002100| 49 20 45 69 64 0a 58 75 | 73 65 73 20 66 6f 75 72 |I Eid.Xu|ses four|
|00002110| 20 65 6e 76 69 72 6f 6e | 6d 65 6e 74 20 76 61 72 | environ|ment var|
|00002120| 69 61 62 6c 65 73 20 74 | 6f 20 63 6f 6e 74 72 6f |iables t|o contro|
|00002130| 6c 20 69 74 73 20 69 6e | 76 6f 63 61 74 69 6f 6e |l its in|vocation|
|00002140| 20 6f 66 20 74 68 65 0a | 58 65 64 69 74 6f 72 2e | of the.|Xeditor.|
|00002150| 0a 58 4e 61 74 75 72 61 | 6c 6c 79 2c 0a 58 2e 42 |.XNatura|lly,.X.B|
|00002160| 20 45 44 49 54 4f 52 0a | 58 69 73 20 75 73 65 64 | EDITOR.|Xis used|
|00002170| 20 74 6f 20 6c 6f 63 61 | 74 65 20 74 68 65 20 65 | to loca|te the e|
|00002180| 64 69 74 69 6e 67 20 70 | 72 6f 67 72 61 6d 2e 0a |diting p|rogram..|
|00002190| 58 2e 42 20 45 49 44 41 | 52 47 0a 58 69 73 20 61 |X.B EIDA|RG.Xis a|
|000021a0| 0a 58 2e 49 52 20 70 72 | 69 6e 74 66 20 28 33 53 |.X.IR pr|intf (3S|
|000021b0| 29 0a 58 73 74 72 69 6e | 67 20 75 73 65 64 20 74 |).Xstrin|g used t|
|000021c0| 6f 20 73 70 65 63 69 66 | 79 20 74 68 65 20 66 6f |o specif|y the fo|
|000021d0| 72 6d 20 6f 66 20 74 68 | 65 20 69 6e 69 74 69 61 |rm of th|e initia|
|000021e0| 6c 2d 73 65 61 72 63 68 | 2d 73 74 72 69 6e 67 0a |l-search|-string.|
|000021f0| 58 61 72 67 75 6d 65 6e | 74 2e 20 20 49 66 20 74 |Xargumen|t. If t|
|00002200| 68 65 20 65 64 69 74 6f | 72 20 64 6f 65 73 20 6e |he edito|r does n|
|00002210| 6f 74 20 73 75 70 70 6f | 72 74 20 73 75 63 68 20 |ot suppo|rt such |
|00002220| 61 6e 20 61 72 67 75 6d | 65 6e 74 2c 0a 58 74 68 |an argum|ent,.Xth|
|00002230| 69 73 20 76 61 72 69 61 | 62 6c 65 20 6d 61 79 20 |is varia|ble may |
|00002240| 62 65 20 6c 65 66 74 20 | 75 6e 73 65 74 2e 0a 58 |be left |unset..X|
|00002250| 2e 42 20 45 49 44 4c 44 | 45 4c 0a 58 61 6e 64 0a |.B EIDLD|EL.Xand.|
|00002260| 58 2e 42 20 45 49 44 52 | 44 45 4c 0a 58 73 70 65 |X.B EIDR|DEL.Xspe|
|00002270| 63 69 66 79 20 74 68 65 | 20 66 6f 72 6d 20 6f 66 |cify the| form of|
|00002280| 20 74 68 65 20 6c 65 66 | 74 20 61 6e 64 20 72 69 | the lef|t and ri|
|00002290| 67 68 74 20 77 6f 72 64 | 2d 64 65 6c 69 6d 69 74 |ght word|-delimit|
|000022a0| 65 72 73 20 72 65 73 70 | 65 63 74 69 76 65 6c 79 |ers resp|ectively|
|000022b0| 2e 0a 58 54 68 65 20 62 | 65 73 74 20 77 61 79 20 |..XThe b|est way |
|000022c0| 74 6f 20 65 78 70 6c 61 | 69 6e 20 74 68 65 20 75 |to expla|in the u|
|000022d0| 73 65 20 6f 66 20 74 68 | 65 73 65 20 6c 61 73 74 |se of th|ese last|
|000022e0| 20 74 68 72 65 65 20 76 | 61 72 69 61 62 6c 65 73 | three v|ariables|
|000022f0| 20 69 73 0a 58 77 69 74 | 68 20 61 6e 20 65 78 61 | is.Xwit|h an exa|
|00002300| 6d 70 6c 65 2e 20 20 48 | 65 72 65 20 61 72 65 20 |mple. H|ere are |
|00002310| 74 68 65 20 70 72 6f 70 | 65 72 20 73 65 74 74 69 |the prop|er setti|
|00002320| 6e 67 73 20 66 6f 72 20 | 76 69 28 31 29 3a 0a 58 |ngs for |vi(1):.X|
|00002330| 2e 6e 66 0a 58 45 49 44 | 41 52 47 3d 27 2b 2f 25 |.nf.XEID|ARG='+/%|
|00002340| 73 2f 27 09 23 20 69 6e | 69 74 69 61 6c 20 73 65 |s/'.# in|itial se|
|00002350| 61 72 63 68 20 61 72 67 | 75 6d 65 6e 74 20 74 65 |arch arg|ument te|
|00002360| 6d 70 6c 61 74 65 0a 58 | 45 49 44 4c 44 45 4c 3d |mplate.X|EIDLDEL=|
|00002370| 27 5c 5c 3c 27 09 23 20 | 6c 65 66 74 20 77 6f 72 |'\\<'.# |left wor|
|00002380| 64 2d 64 65 6c 69 6d 69 | 74 65 72 0a 58 45 49 44 |d-delimi|ter.XEID|
|00002390| 52 44 45 4c 3d 27 5c 5c | 3e 27 09 23 20 72 69 67 |RDEL='\\|>'.# rig|
|000023a0| 68 74 20 77 6f 72 64 2d | 64 65 6c 69 6d 69 74 65 |ht word-|delimite|
|000023b0| 72 0a 58 2e 66 69 0a 58 | 2e 50 50 0a 58 2e 49 20 |r.X.fi.X|.PP.X.I |
|000023c0| 50 61 74 74 65 72 6e 73 | 0a 58 6d 61 79 20 62 65 |Patterns|.Xmay be|
|000023d0| 20 73 69 6d 70 6c 65 20 | 61 6c 70 68 61 2d 6e 75 | simple |alpha-nu|
|000023e0| 6d 65 72 69 63 20 73 74 | 72 69 6e 67 73 2c 20 6f |meric st|rings, o|
|000023f0| 72 20 72 65 67 75 6c 61 | 72 20 65 78 70 72 65 73 |r regula|r expres|
|00002400| 73 69 6f 6e 73 20 69 6e | 20 74 68 65 0a 58 73 74 |sions in| the.Xst|
|00002410| 79 6c 65 20 6f 66 0a 58 | 2e 49 52 20 72 65 67 63 |yle of.X|.IR regc|
|00002420| 6d 70 20 28 33 29 2e 0a | 58 49 66 20 74 68 65 20 |mp (3)..|XIf the |
|00002430| 73 74 72 69 6e 67 20 63 | 6f 6e 74 61 69 6e 73 20 |string c|ontains |
|00002440| 6e 6f 20 72 65 67 75 6c | 61 72 2d 65 78 70 72 65 |no regul|ar-expre|
|00002450| 73 73 69 6f 6e 20 6d 65 | 74 61 2d 63 68 61 72 61 |ssion me|ta-chara|
|00002460| 63 74 65 72 73 2c 20 69 | 74 20 69 73 0a 58 73 65 |cters, i|t is.Xse|
|00002470| 61 72 63 68 65 64 20 66 | 6f 72 20 61 73 20 61 0a |arched f|or as a.|
|00002480| 58 2e 49 52 20 77 6f 72 | 64 20 2e 0a 58 49 66 20 |X.IR wor|d ..XIf |
|00002490| 74 68 65 20 73 74 72 69 | 6e 67 20 63 6f 6e 74 61 |the stri|ng conta|
|000024a0| 69 6e 73 20 6d 65 74 61 | 2d 63 68 61 72 61 63 74 |ins meta|-charact|
|000024b0| 65 72 73 2c 20 6f 72 20 | 69 66 20 74 68 65 20 5c |ers, or |if the \|
|000024c0| 2d 65 20 61 72 67 75 6d | 65 6e 74 20 69 73 0a 58 |-e argum|ent is.X|
|000024d0| 73 75 70 70 6c 69 65 64 | 2c 20 69 74 20 69 73 20 |supplied|, it is |
|000024e0| 73 65 61 72 63 68 65 64 | 20 66 6f 72 20 61 73 20 |searched| for as |
|000024f0| 72 65 67 75 6c 61 72 2d | 65 78 70 72 65 73 73 69 |regular-|expressi|
|00002500| 6f 6e 2e 0a 58 2e 50 50 | 0a 58 2e 49 20 41 69 64 |on..X.PP|.X.I Aid|
|00002510| 5c 5e 0a 58 70 72 6f 64 | 75 63 65 73 20 6f 75 74 |\^.Xprod|uces out|
|00002520| 70 75 74 20 69 6e 20 74 | 68 65 20 73 74 79 6c 65 |put in t|he style|
|00002530| 20 6f 66 0a 58 2e 49 20 | 6c 69 64 5c 5e 0a 58 62 | of.X.I |lid\^.Xb|
|00002540| 75 74 20 69 74 73 20 70 | 61 74 74 65 72 6e 20 61 |ut its p|attern a|
|00002550| 72 67 75 6d 65 6e 74 73 | 20 61 72 65 20 73 65 61 |rguments| are sea|
|00002560| 72 63 68 65 64 20 66 6f | 72 20 61 73 20 73 75 62 |rched fo|r as sub|
|00002570| 73 74 72 69 6e 67 73 20 | 77 69 74 68 69 6e 0a 58 |strings |within.X|
|00002580| 74 68 65 20 69 64 65 6e | 74 69 66 69 65 72 73 20 |the iden|tifiers |
|00002590| 69 6e 20 74 68 65 20 64 | 61 74 61 62 61 73 65 2e |in the d|atabase.|
|000025a0| 20 20 4e 6f 20 72 65 67 | 75 6c 61 72 2d 65 78 70 | No reg|ular-exp|
|000025b0| 72 65 73 73 69 6f 6e 20 | 73 65 61 72 63 68 0a 58 |ression |search.X|
|000025c0| 69 73 20 70 65 72 66 6f | 72 6d 65 64 2c 20 65 76 |is perfo|rmed, ev|
|000025d0| 65 6e 20 69 66 20 74 68 | 65 20 70 61 74 74 65 72 |en if th|e patter|
|000025e0| 6e 20 63 6f 6e 74 61 69 | 6e 73 20 6d 65 74 61 2d |n contai|ns meta-|
|000025f0| 63 68 61 72 61 63 74 65 | 72 73 2e 0a 58 54 68 65 |characte|rs..XThe|
|00002600| 20 73 65 61 72 63 68 20 | 69 73 20 63 6f 6e 64 75 | search |is condu|
|00002610| 63 74 65 64 20 69 6e 20 | 61 6e 20 61 6c 70 68 61 |cted in |an alpha|
|00002620| 62 65 74 69 63 20 63 61 | 73 65 20 69 6e 73 65 6e |betic ca|se insen|
|00002630| 73 69 74 69 76 65 20 6d | 61 6e 6e 65 72 2e 0a 58 |sitive m|anner..X|
|00002640| 54 68 65 20 6d 6e 65 6d | 6f 6e 69 63 20 66 6f 72 |The mnem|onic for|
|00002650| 20 74 68 69 73 20 6e 61 | 6d 65 20 69 73 0a 58 5c | this na|me is.X\|
|00002660| 66 49 5c 7c 61 28 70 72 | 6f 70 6f 73 29 20 69 64 |fI\|a(pr|opos) id|
|00002670| 5c 66 50 2e 20 0a 58 2e | 50 50 0a 58 2e 49 20 50 |\fP. .X.|PP.X.I P|
|00002680| 69 64 5c 5e 0a 58 69 73 | 20 75 73 65 64 20 74 6f |id\^.Xis| used to|
|00002690| 20 6d 61 74 63 68 20 74 | 68 65 20 69 6e 70 75 74 | match t|he input|
|000026a0| 20 70 61 74 74 65 72 6e | 73 20 61 67 61 69 6e 73 | pattern|s agains|
|000026b0| 74 20 74 68 65 20 6e 61 | 6d 65 73 20 6f 66 20 74 |t the na|mes of t|
|000026c0| 68 65 20 66 69 6c 65 73 | 0a 58 69 6e 20 74 68 65 |he files|.Xin the|
|000026d0| 20 64 61 74 61 62 61 73 | 65 20 72 61 74 68 65 72 | databas|e rather|
|000026e0| 20 74 68 61 6e 20 74 68 | 65 20 63 6f 6e 74 65 6e | than th|e conten|
|000026f0| 74 73 20 6f 66 20 74 68 | 65 20 66 69 6c 65 73 2e |ts of th|e files.|
|00002700| 20 54 68 65 20 70 61 74 | 74 65 72 6e 0a 58 69 73 | The pat|tern.Xis|
|00002710| 20 61 73 73 75 6d 65 64 | 20 74 6f 20 62 65 20 61 | assumed| to be a|
|00002720| 20 73 69 6d 70 6c 65 20 | 73 68 65 6c 6c 20 77 69 | simple |shell wi|
|00002730| 6c 64 20 63 61 72 64 20 | 70 61 74 74 65 72 6e 20 |ld card |pattern |
|00002740| 75 6e 6c 65 73 73 20 74 | 68 65 0a 58 2e 42 20 5c |unless t|he.X.B \|
|00002750| 2d 65 0a 58 6f 70 74 69 | 6f 6e 20 69 73 20 67 69 |-e.Xopti|on is gi|
|00002760| 76 65 6e 2c 20 69 6e 20 | 77 68 69 63 68 20 63 61 |ven, in |which ca|
|00002770| 73 65 20 66 75 6c 6c 20 | 72 65 67 75 6c 61 72 20 |se full |regular |
|00002780| 65 78 70 72 65 73 73 69 | 6f 6e 20 6d 61 74 63 68 |expressi|on match|
|00002790| 69 6e 67 0a 58 69 73 20 | 75 73 65 64 2e 0a 58 54 |ing.Xis |used..XT|
|000027a0| 68 65 0a 58 2e 42 20 5c | 2d 62 0a 58 6f 70 74 69 |he.X.B \|-b.Xopti|
|000027b0| 6f 6e 20 63 61 6e 20 62 | 65 20 75 73 65 64 20 74 |on can b|e used t|
|000027c0| 6f 20 72 65 73 74 72 69 | 63 74 20 74 68 65 20 6d |o restri|ct the m|
|000027d0| 61 74 63 68 20 74 6f 20 | 6a 75 73 74 20 74 68 65 |atch to |just the|
|000027e0| 20 62 61 73 65 6e 61 6d | 65 20 70 6f 72 74 69 6f | basenam|e portio|
|000027f0| 6e 0a 58 6f 66 20 74 68 | 65 20 66 75 6c 6c 20 61 |n.Xof th|e full a|
|00002800| 62 73 6f 6c 75 74 65 20 | 70 61 74 68 20 6e 61 6d |bsolute |path nam|
|00002810| 65 20 6f 66 20 74 68 65 | 20 66 69 6c 65 2e 0a 58 |e of the| file..X|
|00002820| 54 68 65 20 6d 6e 65 6d | 6f 6e 69 63 20 66 6f 72 |The mnem|onic for|
|00002830| 20 74 68 69 73 20 6e 61 | 6d 65 20 69 73 0a 58 5c | this na|me is.X\|
|00002840| 66 49 5c 7c 70 28 61 74 | 68 29 20 69 64 5c 66 50 |fI\|p(at|h) id\fP|
|00002850| 2e 20 0a 58 2e 50 50 0a | 58 54 68 65 20 66 6f 6c |. .X.PP.|XThe fol|
|00002860| 6c 6f 77 69 6e 67 20 6f | 70 74 69 6f 6e 73 20 61 |lowing o|ptions a|
|00002870| 72 65 20 72 65 63 6f 67 | 6e 69 7a 65 64 3a 0a 58 |re recog|nized:.X|
|00002880| 2e 54 50 20 31 30 0a 58 | 2e 42 52 20 5c 2d 66 20 |.TP 10.X|.BR \-f |
|00002890| 66 69 6c 65 5c 5e 0a 58 | 55 73 65 0a 58 2e 49 20 |file\^.X|Use.X.I |
|000028a0| 66 69 6c 65 5c 5e 0a 58 | 61 73 20 74 68 65 20 64 |file\^.X|as the d|
|000028b0| 61 74 61 62 61 73 65 20 | 69 6e 73 74 65 61 64 20 |atabase |instead |
|000028c0| 6f 66 20 74 68 65 20 64 | 65 66 61 75 6c 74 0a 58 |of the d|efault.X|
|000028d0| 2e 42 52 20 49 44 20 2e | 0a 58 2e 54 50 20 31 30 |.BR ID .|.X.TP 10|
|000028e0| 0a 58 2e 42 52 20 5c 2d | 75 20 6e 0a 58 4c 69 73 |.X.BR \-|u n.XLis|
|000028f0| 74 73 20 61 6c 6c 20 69 | 64 65 6e 74 69 66 69 65 |ts all i|dentifie|
|00002900| 72 73 20 69 6e 20 74 68 | 65 20 64 61 74 61 62 61 |rs in th|e databa|
|00002910| 73 65 20 74 68 61 74 20 | 61 72 65 20 6e 6f 6e 2d |se that |are non-|
|00002920| 75 6e 69 71 75 65 20 77 | 69 74 68 69 6e 20 74 68 |unique w|ithin th|
|00002930| 65 20 66 69 72 73 74 0a | 58 2e 49 20 6e 0a 58 63 |e first.|X.I n.Xc|
|00002940| 68 61 72 61 63 74 65 72 | 73 2e 20 20 54 68 69 73 |haracter|s. This|
|00002950| 20 66 61 63 69 6c 69 74 | 79 20 69 73 20 70 61 72 | facilit|y is par|
|00002960| 74 69 63 75 6c 61 72 6c | 79 20 68 65 6c 70 66 75 |ticularl|y helpfu|
|00002970| 6c 20 77 68 65 6e 20 70 | 6f 72 74 69 6e 67 20 61 |l when p|orting a|
|00002980| 20 70 72 6f 67 72 61 6d | 0a 58 74 6f 20 61 20 73 | program|.Xto a s|
|00002990| 79 73 74 65 6d 20 77 68 | 6f 73 65 20 63 6f 6d 70 |ystem wh|ose comp|
|000029a0| 69 6c 65 72 20 6f 72 20 | 6c 69 6e 6b 65 72 20 68 |iler or |linker h|
|000029b0| 61 73 20 66 65 77 65 72 | 20 73 69 67 6e 69 66 69 |as fewer| signifi|
|000029c0| 63 61 6e 74 20 63 68 61 | 72 61 63 74 65 72 73 0a |cant cha|racters.|
|000029d0| 58 66 6f 72 20 69 64 65 | 6e 74 69 66 69 65 72 73 |Xfor ide|ntifiers|
|000029e0| 2e 0a 58 2e 54 50 20 31 | 30 0a 58 2e 42 52 20 5c |..X.TP 1|0.X.BR \|
|000029f0| 2d 72 20 64 69 72 5c 5e | 0a 58 41 73 73 75 6d 65 |-r dir\^|.XAssume|
|00002a00| 20 74 68 65 20 6e 61 6d | 65 73 20 73 74 6f 72 65 | the nam|es store|
|00002a10| 64 20 69 6e 20 74 68 65 | 20 64 61 74 61 62 61 73 |d in the| databas|
|00002a20| 65 20 61 72 65 20 72 65 | 6c 61 74 69 76 65 20 74 |e are re|lative t|
|00002a30| 6f 20 74 68 69 73 20 64 | 69 72 65 63 74 6f 72 79 |o this d|irectory|
|00002a40| 2e 0a 58 54 68 69 73 20 | 6f 70 74 69 6f 6e 20 69 |..XThis |option i|
|00002a50| 73 20 75 73 65 66 75 6c | 20 69 66 20 79 6f 75 20 |s useful| if you |
|00002a60| 63 72 65 61 74 65 20 74 | 68 65 20 64 61 74 61 62 |create t|he datab|
|00002a70| 61 73 65 20 69 6e 20 6f | 6e 65 20 70 6c 61 63 65 |ase in o|ne place|
|00002a80| 2c 20 74 68 65 6e 20 6d | 6f 76 65 0a 58 69 74 20 |, then m|ove.Xit |
|00002a90| 73 6f 6d 65 77 68 65 72 | 65 20 65 6c 73 65 2e 20 |somewher|e else. |
|00002aa0| 4e 6f 72 6d 61 6c 6c 79 | 20 61 6c 6c 20 74 68 65 |Normally| all the|
|00002ab0| 20 71 75 65 72 79 20 74 | 6f 6f 6c 73 20 61 73 73 | query t|ools ass|
|00002ac0| 75 6d 65 20 74 68 65 20 | 6e 61 6d 65 73 20 69 6e |ume the |names in|
|00002ad0| 0a 58 74 68 65 20 64 61 | 74 61 62 61 73 65 20 61 |.Xthe da|tabase a|
|00002ae0| 72 65 20 72 65 6c 61 74 | 69 76 65 20 74 6f 20 74 |re relat|ive to t|
|00002af0| 68 65 20 6c 6f 63 61 74 | 69 6f 6e 20 6f 66 20 74 |he locat|ion of t|
|00002b00| 68 65 20 64 61 74 61 62 | 61 73 65 2e 0a 58 2e 54 |he datab|ase..X.T|
|00002b10| 50 20 31 30 0a 58 2e 42 | 20 5c 2d 63 0a 58 54 68 |P 10.X.B| \-c.XTh|
|00002b20| 69 73 20 6f 70 74 69 6f | 6e 20 69 73 20 73 69 6d |is optio|n is sim|
|00002b30| 69 6c 61 72 20 74 6f 0a | 58 2e 42 52 20 5c 2d 72 |ilar to.|X.BR \-r|
|00002b40| 20 2c 0a 58 62 75 74 20 | 69 74 20 74 65 6c 6c 73 | ,.Xbut |it tells|
|00002b50| 20 74 68 65 20 69 64 20 | 71 75 65 72 79 20 74 6f | the id |query to|
|00002b60| 6f 6c 20 74 6f 20 61 73 | 73 75 6d 65 20 74 68 65 |ol to as|sume the|
|00002b70| 20 6e 61 6d 65 73 20 69 | 6e 20 74 68 65 20 49 44 | names i|n the ID|
|00002b80| 20 64 61 74 61 62 61 73 | 65 0a 58 61 72 65 20 73 | databas|e.Xare s|
|00002b90| 74 6f 72 65 64 20 72 65 | 6c 61 74 69 76 65 20 74 |tored re|lative t|
|00002ba0| 6f 20 74 68 65 20 63 75 | 72 72 65 6e 74 20 77 6f |o the cu|rrent wo|
|00002bb0| 72 6b 69 6e 67 20 64 69 | 72 65 63 74 6f 72 79 2e |rking di|rectory.|
|00002bc0| 0a 58 2e 54 50 20 31 30 | 0a 58 2e 42 20 5c 2d 6b |.X.TP 10|.X.B \-k|
|00002bd0| 0a 58 53 75 70 70 72 65 | 73 73 65 73 20 74 68 65 |.XSuppre|sses the|
|00002be0| 20 75 73 65 20 6f 66 20 | 5c 66 4c 7b 5c 66 50 20 | use of |\fL{\fP |
|00002bf0| 61 6e 64 20 5c 66 4c 7d | 5c 66 50 20 61 73 20 61 |and \fL}|\fP as a|
|00002c00| 20 73 68 6f 72 74 68 61 | 6e 64 20 69 6e 20 74 68 | shortha|nd in th|
|00002c10| 65 0a 58 67 65 6e 65 72 | 61 74 65 64 20 6c 69 73 |e.Xgener|ated lis|
|00002c20| 74 20 6f 66 20 66 69 6c | 65 20 6e 61 6d 65 73 2e |t of fil|e names.|
|00002c30| 20 45 61 63 68 20 6e 61 | 6d 65 20 69 73 20 6f 75 | Each na|me is ou|
|00002c40| 74 70 75 74 20 69 6e 20 | 66 75 6c 6c 2e 0a 58 2e |tput in |full..X.|
|00002c50| 54 50 20 31 30 0a 58 2e | 42 20 5c 2d 6e 0a 58 53 |TP 10.X.|B \-n.XS|
|00002c60| 75 70 70 72 65 73 73 65 | 73 20 70 72 69 6e 74 69 |uppresse|s printi|
|00002c70| 6e 67 20 74 68 65 20 6e | 61 6d 65 20 6f 66 20 74 |ng the n|ame of t|
|00002c80| 68 65 20 73 65 61 72 63 | 68 20 73 74 72 69 6e 67 |he searc|h string|
|00002c90| 2c 20 6f 6e 6c 79 20 74 | 68 65 20 6e 61 6d 65 73 |, only t|he names|
|00002ca0| 20 6f 66 0a 58 74 68 65 | 20 66 69 6c 65 73 20 63 | of.Xthe| files c|
|00002cb0| 6f 6e 74 61 69 6e 69 6e | 67 20 74 68 65 20 73 74 |ontainin|g the st|
|00002cc0| 72 69 6e 67 20 61 72 65 | 20 70 72 69 6e 74 65 64 |ring are| printed|
|00002cd0| 2e 20 54 6f 67 65 74 68 | 65 72 20 77 69 74 68 20 |. Togeth|er with |
|00002ce0| 74 68 65 20 5c 66 42 5c | 2d 6b 5c 66 50 0a 58 6f |the \fB\|-k\fP.Xo|
|00002cf0| 70 74 69 6f 6e 20 74 68 | 69 73 20 63 61 6e 20 62 |ption th|is can b|
|00002d00| 65 20 75 73 65 64 20 74 | 6f 20 67 65 6e 65 72 61 |e used t|o genera|
|00002d10| 74 65 20 6c 69 73 74 73 | 20 6f 66 20 66 69 6c 65 |te lists| of file|
|00002d20| 73 20 74 6f 20 70 61 73 | 73 20 74 6f 20 6f 74 68 |s to pas|s to oth|
|00002d30| 65 72 0a 58 70 72 6f 67 | 72 61 6d 73 2e 0a 58 2e |er.Xprog|rams..X.|
|00002d40| 50 50 0a 58 2e 54 50 20 | 31 30 0a 58 2e 42 20 5c |PP.X.TP |10.X.B \|
|00002d50| 2d 62 0a 58 49 6e 20 74 | 68 65 0a 58 2e 49 20 70 |-b.XIn t|he.X.I p|
|00002d60| 69 64 0a 58 70 72 6f 67 | 72 61 6d 2c 20 74 68 65 |id.Xprog|ram, the|
|00002d70| 0a 58 2e 42 20 5c 2d 62 | 0a 58 6f 70 74 69 6f 6e |.X.B \-b|.Xoption|
|00002d80| 20 69 73 20 75 73 65 64 | 20 74 6f 20 66 6f 72 63 | is used| to forc|
|00002d90| 65 20 70 61 74 74 65 72 | 6e 20 6d 61 74 63 68 69 |e patter|n matchi|
|00002da0| 6e 67 20 6f 6e 20 6a 75 | 73 74 20 74 68 65 20 62 |ng on ju|st the b|
|00002db0| 61 73 65 20 6e 61 6d 65 | 73 20 6f 66 20 74 68 65 |ase name|s of the|
|00002dc0| 0a 58 66 69 6c 65 2c 20 | 6f 74 68 65 72 77 69 73 |.Xfile, |otherwis|
|00002dd0| 65 20 74 68 65 20 70 61 | 74 74 65 72 6e 20 6d 61 |e the pa|ttern ma|
|00002de0| 74 63 68 69 6e 67 20 69 | 73 20 64 6f 6e 65 20 6f |tching i|s done o|
|00002df0| 6e 20 74 68 65 20 66 75 | 6c 6c 20 61 62 73 6f 6c |n the fu|ll absol|
|00002e00| 75 74 65 20 66 69 6c 65 | 0a 58 6e 61 6d 65 2e 0a |ute file|.Xname..|
|00002e10| 58 2e 50 50 0a 58 54 68 | 65 20 72 65 6d 61 69 6e |X.PP.XTh|e remain|
|00002e20| 69 6e 67 20 6f 70 74 69 | 6f 6e 73 20 61 72 65 20 |ing opti|ons are |
|00002e30| 66 6f 72 20 75 73 65 20 | 69 6e 20 63 6f 6e 6a 75 |for use |in conju|
|00002e40| 6e 63 74 69 6f 6e 20 77 | 69 74 68 20 6e 75 6d 65 |nction w|ith nume|
|00002e50| 72 69 63 20 70 61 74 74 | 65 72 6e 73 3a 0a 58 2e |ric patt|erns:.X.|
|00002e60| 54 50 20 31 30 0a 58 2e | 42 20 5c 2d 64 6f 78 61 |TP 10.X.|B \-doxa|
|00002e70| 0a 58 54 68 65 73 65 20 | 6f 70 74 69 6f 6e 73 20 |.XThese |options |
|00002e80| 6d 61 79 20 62 65 20 73 | 70 65 63 69 66 69 65 64 |may be s|pecified|
|00002e90| 20 69 6e 20 61 6e 79 20 | 63 6f 6d 62 69 6e 61 74 | in any |combinat|
|00002ea0| 69 6f 6e 2e 0a 58 54 68 | 65 79 20 6c 69 6d 69 74 |ion..XTh|ey limit|
|00002eb0| 20 6e 75 6d 65 72 69 63 | 20 6d 61 74 63 68 65 73 | numeric| matches|
|00002ec0| 20 74 6f 20 73 70 65 63 | 69 66 69 63 20 72 61 64 | to spec|ific rad|
|00002ed0| 69 78 65 73 2e 0a 58 54 | 68 65 0a 58 2e 42 52 20 |ixes..XT|he.X.BR |
|00002ee0| 5c 2d 64 20 2c 0a 58 2e | 42 52 20 5c 2d 6f 20 2c |\-d ,.X.|BR \-o ,|
|00002ef0| 0a 58 61 6e 64 0a 58 2e | 42 20 5c 2d 78 0a 58 6f |.Xand.X.|B \-x.Xo|
|00002f00| 70 74 69 6f 6e 73 20 6c | 69 6d 69 74 20 6d 61 74 |ptions l|imit mat|
|00002f10| 63 68 65 73 20 74 6f 20 | 64 65 63 69 6d 61 6c 2c |ches to |decimal,|
|00002f20| 20 6f 63 74 61 6c 2c 20 | 61 6e 64 20 68 65 78 61 | octal, |and hexa|
|00002f30| 64 65 63 69 6d 61 6c 20 | 72 65 73 70 65 63 74 69 |decimal |respecti|
|00002f40| 76 65 6c 79 2e 0a 58 54 | 68 65 0a 58 2e 42 52 20 |vely..XT|he.X.BR |
|00002f50| 5c 2d 61 0a 58 6f 70 74 | 69 6f 6e 20 69 73 20 61 |\-a.Xopt|ion is a|
|00002f60| 20 73 68 6f 72 74 68 61 | 6e 64 20 66 6f 72 20 73 | shortha|nd for s|
|00002f70| 70 65 63 69 66 79 69 6e | 67 20 61 6c 6c 20 74 68 |pecifyin|g all th|
|00002f80| 72 65 65 20 72 61 64 69 | 78 65 73 2e 0a 58 2e 50 |ree radi|xes..X.P|
|00002f90| 50 0a 58 53 65 61 72 63 | 68 65 73 20 66 6f 72 20 |P.XSearc|hes for |
|00002fa0| 6e 75 6d 62 65 72 73 20 | 0a 58 61 72 65 20 63 6f |numbers |.Xare co|
|00002fb0| 6e 64 75 63 74 65 64 20 | 6e 75 6d 65 72 69 63 61 |nducted |numerica|
|00002fc0| 6c 6c 79 20 72 61 74 68 | 65 72 20 74 68 61 6e 20 |lly rath|er than |
|00002fd0| 6c 65 78 69 63 61 6c 6c | 79 2c 20 73 6f 20 74 68 |lexicall|y, so th|
|00002fe0| 61 74 20 61 6c 6c 0a 58 | 72 65 70 72 65 73 65 6e |at all.X|represen|
|00002ff0| 74 61 74 69 6f 6e 73 20 | 66 6f 72 20 61 20 67 69 |tations |for a gi|
|00003000| 76 65 6e 20 6e 75 6d 62 | 65 72 20 61 72 65 20 70 |ven numb|er are p|
|00003010| 6f 74 65 6e 74 69 61 6c | 6c 79 20 61 76 61 69 6c |otential|ly avail|
|00003020| 61 62 6c 65 0a 58 66 72 | 6f 6d 20 61 20 73 69 6e |able.Xfr|om a sin|
|00003030| 67 6c 65 20 73 65 61 72 | 63 68 2e 0a 58 2e 54 50 |gle sear|ch..X.TP|
|00003040| 20 31 30 0a 58 2e 42 20 | 5c 2d 6d 0a 58 4d 65 72 | 10.X.B |\-m.XMer|
|00003050| 67 65 20 6d 75 6c 74 69 | 70 6c 65 20 6c 69 6e 65 |ge multi|ple line|
|00003060| 73 20 6f 66 20 6f 75 74 | 70 75 74 20 69 6e 74 6f |s of out|put into|
|00003070| 20 61 20 73 69 6e 67 6c | 65 20 6c 69 6e 65 2e 0a | a singl|e line..|
|00003080| 58 2e 54 50 20 31 30 0a | 58 2e 42 20 5c 2d 73 0a |X.TP 10.|X.B \-s.|
|00003090| 58 4c 69 6d 69 74 20 74 | 68 65 20 72 65 73 75 6c |XLimit t|he resul|
|000030a0| 74 73 20 6f 66 20 74 68 | 65 20 73 65 61 72 63 68 |ts of th|e search|
|000030b0| 20 74 6f 20 69 64 65 6e | 74 69 66 69 65 72 73 20 | to iden|tifiers |
|000030c0| 74 68 61 74 20 6f 63 63 | 75 72 20 6f 6e 6c 79 0a |that occ|ur only.|
|000030d0| 58 6f 6e 63 65 20 69 6e | 20 74 68 65 20 65 6e 74 |Xonce in| the ent|
|000030e0| 69 72 65 20 73 65 74 20 | 6f 66 20 73 6f 75 72 63 |ire set |of sourc|
|000030f0| 65 73 20 63 6f 76 65 72 | 65 64 20 62 79 20 74 68 |es cover|ed by th|
|00003100| 65 20 64 61 74 61 62 61 | 73 65 2e 0a 58 54 68 69 |e databa|se..XThi|
|00003110| 73 20 6f 70 74 69 6f 6e | 20 69 73 20 75 73 65 66 |s option| is usef|
|00003120| 75 6c 20 66 6f 72 20 66 | 69 6e 64 69 6e 67 20 69 |ul for f|inding i|
|00003130| 64 65 6e 74 69 66 69 65 | 72 73 20 74 68 61 74 20 |dentifie|rs that |
|00003140| 61 72 65 20 64 65 66 69 | 6e 65 64 0a 58 62 75 74 |are defi|ned.Xbut|
|00003150| 20 6e 65 76 65 72 20 75 | 73 65 64 2e 0a 58 2e 53 | never u|sed..X.S|
|00003160| 48 20 53 45 45 20 41 4c | 53 4f 0a 58 6d 6b 69 64 |H SEE AL|SO.Xmkid|
|00003170| 28 31 29 2c 0a 58 66 69 | 64 28 31 29 2e 0a 45 4e |(1),.Xfi|d(1)..EN|
|00003180| 44 5f 4f 46 5f 46 49 4c | 45 0a 69 66 20 74 65 73 |D_OF_FIL|E.if tes|
|00003190| 74 20 35 36 37 38 20 2d | 6e 65 20 60 77 63 20 2d |t 5678 -|ne `wc -|
|000031a0| 63 20 3c 27 6c 69 64 2e | 31 27 60 3b 20 74 68 65 |c <'lid.|1'`; the|
|000031b0| 6e 0a 20 20 20 20 65 63 | 68 6f 20 73 68 61 72 3a |n. ec|ho shar:|
|000031c0| 20 5c 22 27 6c 69 64 2e | 31 27 5c 22 20 75 6e 70 | \"'lid.|1'\" unp|
|000031d0| 61 63 6b 65 64 20 77 69 | 74 68 20 77 72 6f 6e 67 |acked wi|th wrong|
|000031e0| 20 73 69 7a 65 21 0a 66 | 69 0a 23 20 65 6e 64 20 | size!.f|i.# end |
|000031f0| 6f 66 20 27 6c 69 64 2e | 31 27 0a 66 69 0a 69 66 |of 'lid.|1'.fi.if|
|00003200| 20 74 65 73 74 20 2d 66 | 20 27 6d 6b 69 64 2e 31 | test -f| 'mkid.1|
|00003210| 27 20 2d 61 20 22 24 7b | 31 7d 22 20 21 3d 20 22 |' -a "${|1}" != "|
|00003220| 2d 63 22 20 3b 20 74 68 | 65 6e 20 0a 20 20 65 63 |-c" ; th|en . ec|
|00003230| 68 6f 20 73 68 61 72 3a | 20 57 69 6c 6c 20 6e 6f |ho shar:| Will no|
|00003240| 74 20 63 6c 6f 62 62 65 | 72 20 65 78 69 73 74 69 |t clobbe|r existi|
|00003250| 6e 67 20 66 69 6c 65 20 | 5c 22 27 6d 6b 69 64 2e |ng file |\"'mkid.|
|00003260| 31 27 5c 22 0a 65 6c 73 | 65 0a 65 63 68 6f 20 73 |1'\".els|e.echo s|
|00003270| 68 61 72 3a 20 45 78 74 | 72 61 63 74 69 6e 67 20 |har: Ext|racting |
|00003280| 5c 22 27 6d 6b 69 64 2e | 31 27 5c 22 20 5c 28 35 |\"'mkid.|1'\" \(5|
|00003290| 35 36 34 20 63 68 61 72 | 61 63 74 65 72 73 5c 29 |564 char|acters\)|
|000032a0| 0a 73 65 64 20 22 73 2f | 5e 58 2f 2f 22 20 3e 27 |.sed "s/|^X//" >'|
|000032b0| 6d 6b 69 64 2e 31 27 20 | 3c 3c 27 45 4e 44 5f 4f |mkid.1' |<<'END_O|
|000032c0| 46 5f 46 49 4c 45 27 0a | 58 2e 54 48 20 4d 4b 49 |F_FILE'.|X.TH MKI|
|000032d0| 44 20 31 0a 58 2e 53 48 | 20 4e 41 4d 45 0a 58 6d |D 1.X.SH| NAME.Xm|
|000032e0| 6b 69 64 20 5c 2d 20 6d | 61 6b 65 20 61 6e 20 69 |kid \- m|ake an i|
|000032f0| 64 20 64 61 74 61 62 61 | 73 65 0a 58 2e 53 48 20 |d databa|se.X.SH |
|00003300| 53 59 4e 4f 50 53 49 53 | 0a 58 2e 42 20 6d 6b 69 |SYNOPSIS|.X.B mki|
|00003310| 64 0a 58 2e 52 42 20 5b | 20 5c 2d 76 20 5d 0a 58 |d.X.RB [| \-v ].X|
|00003320| 2e 52 42 20 5b 20 5c 2d | 66 20 5c 5e 6f 75 74 2d |.RB [ \-|f \^out-|
|00003330| 66 69 6c 65 5d 0a 58 2e | 52 42 20 5b 20 5c 2d 73 |file].X.|RB [ \-s|
|00003340| 20 5c 5e 64 69 72 65 63 | 74 6f 72 79 5d 0a 58 2e | \^direc|tory].X.|
|00003350| 52 42 20 5b 20 5c 2d 72 | 20 5c 5e 64 69 72 65 63 |RB [ \-r| \^direc|
|00003360| 74 6f 72 79 5d 0a 58 2e | 52 42 20 5b 20 5c 2d 53 |tory].X.|RB [ \-S|
|00003370| 20 5c 5e 73 63 61 6e 61 | 72 67 5d 0a 58 2e 52 42 | \^scana|rg].X.RB|
|00003380| 20 5b 20 5c 2d 61 20 5c | 5e 61 72 67 2d 66 69 6c | [ \-a \|^arg-fil|
|00003390| 65 5d 0a 58 2e 52 42 20 | 5b 20 5c 2d 20 5d 0a 58 |e].X.RB |[ \- ].X|
|000033a0| 2e 52 42 20 5b 20 5c 2d | 75 20 5d 0a 58 2e 52 42 |.RB [ \-|u ].X.RB|
|000033b0| 20 5b 20 66 69 6c 65 73 | 2e 2e 2e 20 5d 0a 58 2e | [ files|... ].X.|
|000033c0| 53 48 20 44 45 53 43 52 | 49 50 54 49 4f 4e 0a 58 |SH DESCR|IPTION.X|
|000033d0| 2e 49 20 4d 6b 69 64 5c | 5e 0a 58 62 75 69 6c 64 |.I Mkid\|^.Xbuild|
|000033e0| 73 20 61 20 64 61 74 61 | 62 61 73 65 20 74 68 61 |s a data|base tha|
|000033f0| 74 20 73 74 6f 72 65 73 | 20 6e 75 6d 62 65 72 73 |t stores| numbers|
|00003400| 20 61 6e 64 20 69 64 65 | 6e 74 69 66 69 65 72 20 | and ide|ntifier |
|00003410| 6e 61 6d 65 73 2c 20 61 | 73 20 77 65 6c 6c 0a 58 |names, a|s well.X|
|00003420| 61 73 20 74 68 65 20 6e | 61 6d 65 73 20 6f 66 20 |as the n|ames of |
|00003430| 74 68 65 20 66 69 6c 65 | 73 20 69 6e 20 77 68 69 |the file|s in whi|
|00003440| 63 68 20 74 68 65 79 20 | 6f 63 63 75 72 2e 0a 58 |ch they |occur..X|
|00003450| 2e 49 20 4d 6b 69 64 5c | 5e 0a 58 69 73 20 70 61 |.I Mkid\|^.Xis pa|
|00003460| 72 74 69 63 75 6c 61 72 | 6c 79 20 75 73 65 66 75 |rticular|ly usefu|
|00003470| 6c 20 77 69 74 68 20 6c | 61 72 67 65 20 70 72 6f |l with l|arge pro|
|00003480| 67 72 61 6d 73 20 73 70 | 72 65 61 64 20 6f 75 74 |grams sp|read out|
|00003490| 20 61 63 72 6f 73 73 20 | 6d 75 6c 74 69 70 6c 65 | across |multiple|
|000034a0| 0a 58 73 6f 75 72 63 65 | 20 66 69 6c 65 73 2e 20 |.Xsource| files. |
|000034b0| 20 49 74 20 73 65 72 76 | 65 73 20 61 73 20 61 6e | It serv|es as an|
|000034c0| 20 61 69 64 20 66 6f 72 | 20 70 72 6f 67 72 61 6d | aid for| program|
|000034d0| 20 6d 61 69 6e 74 65 6e | 61 6e 63 65 20 61 6e 64 | mainten|ance and|
|000034e0| 20 61 73 20 61 0a 58 2e | 49 20 67 75 69 64 65 5c | as a.X.|I guide\|
|000034f0| 5e 0a 58 66 6f 72 20 70 | 65 72 75 73 69 6e 67 20 |^.Xfor p|erusing |
|00003500| 61 20 70 72 6f 67 72 61 | 6d 2e 0a 58 2e 50 50 0a |a progra|m..X.PP.|
|00003510| 58 54 68 65 20 66 6f 6c | 6c 6f 77 69 6e 67 20 6f |XThe fol|lowing o|
|00003520| 70 74 69 6f 6e 73 20 61 | 72 65 20 72 65 63 6f 67 |ptions a|re recog|
|00003530| 6e 69 7a 65 64 3a 0a 58 | 2e 54 50 20 31 30 0a 58 |nized:.X|.TP 10.X|
|00003540| 2e 42 20 5c 2d 76 0a 58 | 56 65 72 62 6f 73 65 2e |.B \-v.X|Verbose.|
|00003550| 0a 58 52 65 70 6f 72 74 | 0a 58 2e 49 52 20 6d 6b |.XReport|.X.IR mk|
|00003560| 69 64 20 27 73 0a 58 70 | 72 6f 67 72 65 73 73 20 |id 's.Xp|rogress |
|00003570| 69 6e 20 62 75 69 6c 64 | 69 6e 67 20 74 68 65 20 |in build|ing the |
|00003580| 64 61 74 61 62 61 73 65 | 2e 20 20 54 68 65 20 6f |database|. The o|
|00003590| 75 74 70 75 74 20 63 6f | 6d 65 73 20 6f 6e 20 73 |utput co|mes on s|
|000035a0| 74 61 6e 64 61 72 64 20 | 65 72 72 6f 72 2e 0a 58 |tandard |error..X|
|000035b0| 2e 54 50 20 31 30 0a 58 | 2e 42 49 20 5c 2d 66 20 |.TP 10.X|.BI \-f |
|000035c0| 6f 75 74 2d 66 69 6c 65 | 5c 5e 0a 58 57 72 69 74 |out-file|\^.XWrit|
|000035d0| 65 20 74 68 65 20 66 69 | 6e 69 73 68 65 64 20 64 |e the fi|nished d|
|000035e0| 61 74 61 62 61 73 65 20 | 69 6e 74 6f 0a 58 2e 49 |atabase |into.X.I|
|000035f0| 52 20 6f 75 74 2d 66 69 | 6c 65 20 2e 0a 58 2e 42 |R out-fi|le ..X.B|
|00003600| 20 49 44 5c 5e 0a 58 69 | 73 20 74 68 65 20 64 65 | ID\^.Xi|s the de|
|00003610| 66 61 75 6c 74 2e 0a 58 | 4e 6f 72 6d 61 6c 6c 79 |fault..X|Normally|
|00003620| 20 74 68 65 20 6e 61 6d | 65 73 20 6f 66 20 74 68 | the nam|es of th|
|00003630| 65 20 66 69 6c 65 73 20 | 73 63 61 6e 6e 65 64 20 |e files |scanned |
|00003640| 61 72 65 20 77 72 69 74 | 74 65 6e 20 74 6f 20 74 |are writ|ten to t|
|00003650| 68 65 20 64 61 74 61 62 | 61 73 65 0a 58 61 73 20 |he datab|ase.Xas |
|00003660| 73 70 65 63 69 66 69 65 | 64 20 69 6e 20 74 68 65 |specifie|d in the|
|00003670| 20 61 72 67 75 6d 65 6e | 74 20 6c 69 73 74 2e 20 | argumen|t list. |
|00003680| 49 66 20 74 68 65 20 64 | 61 74 61 62 61 73 65 20 |If the d|atabase |
|00003690| 73 65 70 63 69 66 69 65 | 64 20 77 69 74 68 0a 58 |sepcifie|d with.X|
|000036a0| 2e 42 20 5c 2d 66 0a 58 | 69 73 20 6e 6f 74 20 6c |.B \-f.X|is not l|
|000036b0| 6f 63 61 74 65 64 20 69 | 6e 20 74 68 65 20 63 75 |ocated i|n the cu|
|000036c0| 72 72 65 6e 74 20 64 69 | 72 65 63 74 6f 72 79 2c |rrent di|rectory,|
|000036d0| 20 74 68 65 6e 20 74 68 | 65 20 66 69 6c 65 20 6e | then th|e file n|
|000036e0| 61 6d 65 73 20 61 72 65 | 0a 58 61 64 6a 75 73 74 |ames are|.Xadjust|
|000036f0| 65 64 20 73 6f 20 74 68 | 61 74 20 74 68 65 79 20 |ed so th|at they |
|00003700| 61 72 65 20 72 65 6c 61 | 74 69 76 65 20 74 6f 20 |are rela|tive to |
|00003710| 74 68 65 20 64 69 72 65 | 63 74 6f 72 79 20 74 68 |the dire|ctory th|
|00003720| 61 74 20 74 68 65 0a 58 | 64 61 74 61 62 61 73 65 |at the.X|database|
|00003730| 20 69 73 20 6c 6f 63 61 | 74 65 64 20 69 6e 2e 0a | is loca|ted in..|
|00003740| 58 2e 54 50 20 31 30 0a | 58 2e 42 49 20 5c 2d 73 |X.TP 10.|X.BI \-s|
|00003750| 20 64 69 72 65 63 74 6f | 72 79 5c 5e 0a 58 2e 54 | directo|ry\^.X.T|
|00003760| 50 20 31 30 0a 58 2e 42 | 49 20 5c 2d 72 20 64 69 |P 10.X.B|I \-r di|
|00003770| 72 65 63 74 6f 72 79 5c | 5e 0a 58 49 66 0a 58 2e |rectory\|^.XIf.X.|
|00003780| 49 52 20 6d 6b 69 64 20 | 27 73 0a 58 61 74 74 65 |IR mkid |'s.Xatte|
|00003790| 6d 70 74 20 74 6f 20 6f | 70 65 6e 20 61 20 73 6f |mpt to o|pen a so|
|000037a0| 75 72 63 65 2d 66 69 6c | 65 20 66 61 69 6c 73 2c |urce-fil|e fails,|
|000037b0| 20 69 74 20 77 69 6c 6c | 20 74 72 79 20 74 6f 20 | it will| try to |
|000037c0| 63 68 65 63 6b 6f 75 74 | 20 74 68 65 0a 58 63 6f |checkout| the.Xco|
|000037d0| 72 72 65 73 70 6f 6e 64 | 69 6e 67 20 53 43 43 53 |rrespond|ing SCCS|
|000037e0| 20 6f 72 20 52 43 53 20 | 66 69 6c 65 20 69 66 20 | or RCS |file if |
|000037f0| 70 72 65 73 65 6e 74 2e | 20 20 54 68 65 0a 58 2e |present.| The.X.|
|00003800| 42 20 5c 2d 73 0a 58 6f | 70 74 69 6f 6e 20 74 65 |B \-s.Xo|ption te|
|00003810| 6c 6c 73 0a 58 2e 49 20 | 6d 6b 69 64 5c 5e 0a 58 |lls.X.I |mkid\^.X|
|00003820| 77 68 69 63 68 20 64 69 | 72 65 63 74 6f 72 79 20 |which di|rectory |
|00003830| 68 6f 6c 64 73 20 74 68 | 65 20 53 43 43 53 20 66 |holds th|e SCCS f|
|00003840| 69 6c 65 2e 0a 58 53 69 | 6d 69 6c 61 72 6c 79 2c |ile..XSi|milarly,|
|00003850| 20 74 68 65 0a 58 2e 42 | 20 5c 2d 72 0a 58 6f 70 | the.X.B| \-r.Xop|
|00003860| 74 69 6f 6e 20 74 65 6c | 6c 73 0a 58 2e 49 20 6d |tion tel|ls.X.I m|
|00003870| 6b 69 64 5c 5e 0a 58 77 | 68 69 63 68 20 64 69 72 |kid\^.Xw|hich dir|
|00003880| 65 63 74 6f 72 79 20 68 | 6f 6c 64 73 20 74 68 65 |ectory h|olds the|
|00003890| 20 52 43 53 20 66 69 6c | 65 2e 0a 58 49 66 20 6e | RCS fil|e..XIf n|
|000038a0| 65 69 74 68 65 72 20 74 | 68 65 20 52 43 53 20 6f |either t|he RCS o|
|000038b0| 72 20 53 43 43 53 20 64 | 69 72 65 63 74 6f 72 69 |r SCCS d|irectori|
|000038c0| 65 73 20 61 72 65 20 73 | 70 65 63 69 66 69 65 64 |es are s|pecified|
|000038d0| 2c 0a 58 2e 49 20 6d 6b | 69 64 5c 5e 0a 58 77 69 |,.X.I mk|id\^.Xwi|
|000038e0| 6c 6c 20 66 69 72 73 74 | 20 6c 6f 6f 6b 20 66 6f |ll first| look fo|
|000038f0| 72 20 61 6e 20 53 43 43 | 53 20 66 69 6c 65 20 69 |r an SCC|S file i|
|00003900| 6e 20 74 68 65 20 63 75 | 72 72 65 6e 74 20 64 69 |n the cu|rrent di|
|00003910| 72 65 63 74 6f 72 79 2c | 20 74 68 65 6e 20 69 6e |rectory,| then in|
|00003920| 0a 58 2e 42 49 20 73 63 | 63 73 20 2c 0a 58 61 6e |.X.BI sc|cs ,.Xan|
|00003930| 64 20 66 69 6e 61 6c 6c | 79 20 69 6e 0a 58 2e 42 |d finall|y in.X.B|
|00003940| 49 20 53 43 43 53 20 2e | 0a 58 49 74 20 77 69 6c |I SCCS .|.XIt wil|
|00003950| 6c 20 74 68 65 6e 20 6c | 6f 6f 6b 20 66 6f 72 20 |l then l|ook for |
|00003960| 61 6e 20 52 43 53 20 66 | 69 6c 65 20 69 6e 20 74 |an RCS f|ile in t|
|00003970| 68 65 20 63 75 72 72 65 | 6e 74 20 64 69 72 65 63 |he curre|nt direc|
|00003980| 74 6f 72 79 2c 20 61 6e | 64 20 66 69 6e 61 6c 6c |tory, an|d finall|
|00003990| 79 20 69 6e 0a 58 2e 42 | 49 20 52 43 53 20 2e 0a |y in.X.B|I RCS ..|
|000039a0| 58 2e 54 50 20 31 30 0a | 58 2e 42 49 20 5c 2d 61 |X.TP 10.|X.BI \-a|
|000039b0| 20 61 72 67 2d 66 69 6c | 65 5c 5e 0a 58 4f 70 65 | arg-fil|e\^.XOpe|
|000039c0| 6e 20 61 6e 64 20 72 65 | 61 64 0a 58 2e 49 20 61 |n and re|ad.X.I a|
|000039d0| 72 67 2d 66 69 6c 65 5c | 5e 0a 58 69 6e 20 6f 72 |rg-file\|^.Xin or|
|000039e0| 64 65 72 20 74 6f 20 6f | 62 74 61 69 6e 20 61 20 |der to o|btain a |
|000039f0| 6c 69 73 74 20 6f 66 20 | 73 6f 75 72 63 65 20 66 |list of |source f|
|00003a00| 69 6c 65 20 61 72 67 75 | 6d 65 6e 74 73 2e 20 20 |ile argu|ments. |
|00003a10| 53 6f 75 72 63 65 20 66 | 69 6c 65 20 6e 61 6d 65 |Source f|ile name|
|00003a20| 73 0a 58 6d 75 73 74 20 | 61 70 70 65 61 72 20 6f |s.Xmust |appear o|
|00003a30| 6e 65 20 74 6f 20 61 20 | 6c 69 6e 65 2e 0a 58 2e |ne to a |line..X.|
|00003a40| 42 49 20 5c 2d 53 20 2c | 0a 58 2e 42 49 20 5c 2d |BI \-S ,|.X.BI \-|
|00003a50| 72 20 2c 0a 58 61 6e 64 | 0a 58 2e 42 49 20 5c 2d |r ,.Xand|.X.BI \-|
|00003a60| 73 0a 58 61 72 67 75 6d | 65 6e 74 73 20 6d 61 79 |s.Xargum|ents may|
|00003a70| 20 61 6c 73 6f 20 62 65 | 20 70 6c 61 63 65 64 20 | also be| placed |
|00003a80| 6f 6e 65 20 70 65 72 20 | 6c 69 6e 65 20 69 6e 0a |one per |line in.|
|00003a90| 58 2e 49 52 20 66 69 6c | 65 20 2e 0a 58 54 68 65 |X.IR fil|e ..XThe|
|00003aa0| 79 20 61 72 65 20 64 69 | 73 74 69 6e 67 75 69 73 |y are di|stinguis|
|00003ab0| 68 65 64 20 66 72 6f 6d | 20 73 6f 75 72 63 65 20 |hed from| source |
|00003ac0| 66 69 6c 65 20 6e 61 6d | 65 73 20 62 79 20 74 68 |file nam|es by th|
|00003ad0| 65 69 72 20 6c 65 61 64 | 69 6e 67 20 60 2d 27 2e |eir lead|ing `-'.|
|00003ae0| 20 20 49 66 20 61 20 66 | 69 6c 65 20 6e 61 6d 65 | If a f|ile name|
|00003af0| 20 62 65 67 69 6e 73 0a | 58 77 69 74 68 20 60 2d | begins.|Xwith `-|
|00003b00| 27 2c 20 69 74 20 63 61 | 6e 20 62 65 20 64 69 73 |', it ca|n be dis|
|00003b10| 74 69 6e 67 75 69 73 68 | 65 64 20 66 72 6f 6d 20 |tinguish|ed from |
|00003b20| 61 6e 20 61 72 67 75 6d | 65 6e 74 20 62 79 20 65 |an argum|ent by e|
|00003b30| 78 70 6c 69 63 69 74 6c | 79 20 70 72 65 70 65 6e |xplicitl|y prepen|
|00003b40| 64 69 6e 67 20 74 68 65 | 20 63 75 72 72 65 6e 74 |ding the| current|
|00003b50| 0a 58 64 69 72 65 63 74 | 6f 72 79 20 73 74 72 69 |.Xdirect|ory stri|
|00003b60| 6e 67 3a 20 60 2e 2f 27 | 2e 0a 58 2e 54 50 20 31 |ng: `./'|..X.TP 1|
|00003b70| 30 0a 58 2e 42 20 5c 2d | 0a 58 54 68 69 73 20 6f |0.X.B \-|.XThis o|
|00003b80| 70 65 72 61 74 65 73 20 | 69 6e 20 74 68 65 20 73 |perates |in the s|
|00003b90| 61 6d 65 20 6d 61 6e 6e | 65 72 20 61 73 20 74 68 |ame mann|er as th|
|00003ba0| 65 0a 58 2e 42 20 5c 2d | 61 0a 58 6f 70 74 69 6f |e.X.B \-|a.Xoptio|
|00003bb0| 6e 20 64 65 73 63 72 69 | 62 65 64 20 61 62 6f 76 |n descri|bed abov|
|00003bc0| 65 2c 20 62 75 74 20 72 | 65 61 64 73 20 66 72 6f |e, but r|eads fro|
|00003bd0| 6d 20 74 68 65 20 73 74 | 61 6e 64 61 72 64 20 69 |m the st|andard i|
|00003be0| 6e 70 75 74 20 69 6e 73 | 74 65 61 64 20 6f 66 20 |nput ins|tead of |
|00003bf0| 61 20 66 69 6c 65 2e 0a | 58 2e 54 50 20 31 30 0a |a file..|X.TP 10.|
|00003c00| 58 2e 42 20 5c 2d 75 0a | 58 55 70 64 61 74 65 20 |X.B \-u.|XUpdate |
|00003c10| 61 6e 20 65 78 69 73 74 | 69 6e 67 20 64 61 74 61 |an exist|ing data|
|00003c20| 62 61 73 65 2e 20 20 4f | 6e 6c 79 20 74 68 6f 73 |base. O|nly thos|
|00003c30| 65 20 66 69 6c 65 73 20 | 74 68 61 74 20 68 61 76 |e files |that hav|
|00003c40| 65 20 62 65 65 6e 20 6d | 6f 64 69 66 69 65 64 0a |e been m|odified.|
|00003c50| 58 73 69 6e 63 65 20 74 | 68 65 20 64 61 74 61 62 |Xsince t|he datab|
|00003c60| 61 73 65 20 77 61 73 20 | 62 75 69 6c 74 20 77 69 |ase was |built wi|
|00003c70| 6c 6c 20 62 65 20 72 65 | 73 63 61 6e 6e 65 64 2e |ll be re|scanned.|
|00003c80| 20 20 54 68 69 73 20 69 | 73 20 61 20 73 69 67 6e | This i|s a sign|
|00003c90| 69 66 69 63 61 6e 74 0a | 58 74 69 6d 65 2d 73 61 |ificant.|Xtime-sa|
|00003ca0| 76 65 72 20 66 6f 72 20 | 75 70 64 61 74 69 6e 67 |ver for |updating|
|00003cb0| 20 6c 61 72 67 65 20 64 | 61 74 61 62 61 73 65 73 | large d|atabases|
|00003cc0| 20 77 68 65 72 65 20 66 | 65 77 20 73 6f 75 72 63 | where f|ew sourc|
|00003cd0| 65 73 20 68 61 76 65 20 | 63 68 61 6e 67 65 64 2e |es have |changed.|
|00003ce0| 0a 58 2e 54 50 20 31 30 | 0a 58 2e 42 20 66 69 6c |.X.TP 10|.X.B fil|
|00003cf0| 65 73 2e 2e 2e 0a 58 49 | 66 20 6e 65 69 74 68 65 |es....XI|f neithe|
|00003d00| 72 20 74 68 65 0a 58 2e | 42 49 20 5c 2d 61 20 2c |r the.X.|BI \-a ,|
|00003d10| 0a 58 2e 42 49 20 5c 2d | 20 2c 0a 58 6e 6f 72 0a |.X.BI \-| ,.Xnor.|
|00003d20| 58 2e 42 49 20 5c 2d 75 | 20 2c 0a 58 61 72 67 75 |X.BI \-u| ,.Xargu|
|00003d30| 6d 65 6e 74 73 20 68 61 | 76 65 20 62 65 65 6e 20 |ments ha|ve been |
|00003d40| 73 70 65 63 69 66 69 65 | 64 2c 20 74 61 6b 65 20 |specifie|d, take |
|00003d50| 66 69 6c 65 20 6e 61 6d | 65 73 20 66 72 6f 6d 20 |file nam|es from |
|00003d60| 74 68 65 20 63 6f 6d 6d | 61 6e 64 20 6c 69 6e 65 |the comm|and line|
|00003d70| 2e 0a 58 2e 54 50 20 31 | 30 0a 58 2e 42 49 20 5c |..X.TP 1|0.X.BI \|
|00003d80| 2d 53 20 73 63 61 6e 61 | 72 67 5c 5e 0a 58 2e 49 |-S scana|rg\^.X.I|
|00003d90| 20 4d 6b 69 64 5c 5e 0a | 58 73 63 61 6e 73 20 73 | Mkid\^.|Xscans s|
|00003da0| 6f 75 72 63 65 20 66 69 | 6c 65 73 20 69 6e 20 6f |ource fi|les in o|
|00003db0| 72 64 65 72 20 74 6f 20 | 6f 62 74 61 69 6e 20 6e |rder to |obtain n|
|00003dc0| 75 6d 62 65 72 73 20 61 | 6e 64 20 69 64 65 6e 74 |umbers a|nd ident|
|00003dd0| 69 66 69 65 72 20 6e 61 | 6d 65 73 2e 0a 58 53 69 |ifier na|mes..XSi|
|00003de0| 6e 63 65 20 74 68 65 20 | 6c 65 78 69 63 61 6c 20 |nce the |lexical |
|00003df0| 72 75 6c 65 73 20 6f 66 | 20 6c 61 6e 67 75 61 67 |rules of| languag|
|00003e00| 65 73 20 64 69 66 66 65 | 72 2c 0a 58 2e 49 20 6d |es diffe|r,.X.I m|
|00003e10| 6b 69 64 5c 5e 0a 58 61 | 70 70 6c 69 65 73 20 61 |kid\^.Xa|pplies a|
|00003e20| 20 64 69 66 66 65 72 65 | 6e 74 20 73 63 61 6e 6e | differe|nt scann|
|00003e30| 69 6e 67 20 66 75 6e 63 | 74 69 6f 6e 20 74 6f 20 |ing func|tion to |
|00003e40| 65 61 63 68 20 6c 61 6e | 67 75 61 67 65 20 69 6e |each lan|guage in|
|00003e50| 20 6f 72 64 65 72 0a 58 | 74 6f 20 63 6f 6e 66 6f | order.X|to confo|
|00003e60| 72 6d 20 74 6f 20 74 68 | 61 74 20 6c 61 6e 67 75 |rm to th|at langu|
|00003e70| 61 67 65 27 73 20 6c 65 | 78 69 63 61 6c 20 72 75 |age's le|xical ru|
|00003e80| 6c 65 73 2e 0a 58 2e 49 | 20 4d 6b 69 64 5c 5e 0a |les..X.I| Mkid\^.|
|00003e90| 58 64 65 74 65 72 6d 69 | 6e 65 73 20 74 68 65 20 |Xdetermi|nes the |
|00003ea0| 73 6f 75 72 63 65 20 66 | 69 6c 65 27 73 20 6c 61 |source f|ile's la|
|00003eb0| 6e 67 75 61 67 65 20 62 | 79 20 65 78 61 6d 69 6e |nguage b|y examin|
|00003ec0| 69 6e 67 20 69 74 73 20 | 66 69 6c 65 6e 61 6d 65 |ing its |filename|
|00003ed0| 0a 58 73 75 66 66 69 78 | 20 77 68 69 63 68 20 63 |.Xsuffix| which c|
|00003ee0| 6f 6d 6d 6f 6e 6c 79 20 | 6f 63 63 75 72 73 20 61 |ommonly |occurs a|
|00003ef0| 66 74 65 72 20 61 20 64 | 6f 74 20 28 60 2e 27 29 |fter a d|ot (`.')|
|00003f00| 2e 0a 58 54 68 65 0a 58 | 2e 42 20 5c 2d 53 0a 58 |..XThe.X|.B \-S.X|
|00003f10| 61 72 67 75 6d 65 6e 74 | 20 69 73 20 61 20 77 61 |argument| is a wa|
|00003f20| 79 20 6f 66 20 70 61 73 | 73 69 6e 67 20 6c 61 6e |y of pas|sing lan|
|00003f30| 67 75 61 67 65 20 73 70 | 65 63 69 66 69 63 20 61 |guage sp|ecific a|
|00003f40| 72 67 75 6d 65 6e 74 73 | 20 74 6f 20 74 68 65 0a |rguments| to the.|
|00003f50| 58 73 63 61 6e 6e 65 72 | 20 66 6f 72 20 74 68 61 |Xscanner| for tha|
|00003f60| 74 20 6c 61 6e 67 75 61 | 67 65 2e 20 20 54 68 69 |t langua|ge. Thi|
|00003f70| 73 20 61 72 67 75 6d 65 | 6e 74 20 74 61 6b 65 73 |s argume|nt takes|
|00003f80| 20 61 20 6e 75 6d 62 65 | 72 20 6f 66 20 66 6f 72 | a numbe|r of for|
|00003f90| 6d 73 3a 0a 58 2e 62 72 | 0a 58 2d 53 3c 73 75 66 |ms:.X.br|.X-S<suf|
|00003fa0| 66 69 78 3e 3d 3c 6c 61 | 6e 67 75 61 67 65 3e 0a |fix>=<la|nguage>.|
|00003fb0| 58 2e 62 72 0a 58 2d 53 | 3c 6c 61 6e 67 75 61 67 |X.br.X-S|<languag|
|00003fc0| 65 3e 2d 3c 61 72 67 3e | 0a 58 2e 62 72 0a 58 2b |e>-<arg>|.X.br.X+|
|00003fd0| 53 2d 3c 61 72 67 3e 0a | 58 2e 62 72 0a 58 2d 53 |S-<arg>.|X.br.X-S|
|00003fe0| 3c 6c 61 6e 67 3e 2f 3c | 6c 61 6e 67 3e 2f 3c 66 |<lang>/<|lang>/<f|
|00003ff0| 69 6c 74 65 72 3e 0a 58 | 2e 62 72 0a 58 54 68 65 |ilter>.X|.br.XThe|
|00004000| 20 66 69 72 73 74 20 66 | 6f 72 6d 20 61 73 73 6f | first f|orm asso|
|00004010| 63 69 61 74 65 73 20 61 | 20 73 75 66 66 69 78 20 |ciates a| suffix |
|00004020| 77 69 74 68 20 61 20 6c | 61 6e 67 75 61 67 65 2e |with a l|anguage.|
|00004030| 0a 58 46 6f 72 20 65 78 | 61 6d 70 6c 65 20 2d 53 |.XFor ex|ample -S|
|00004040| 2e 63 3d 76 68 69 6c 20 | 77 6f 75 6c 64 20 63 61 |.c=vhil |would ca|
|00004050| 75 73 65 20 61 6c 6c 20 | 2e 63 20 66 69 6c 65 73 |use all |.c files|
|00004060| 20 74 6f 20 62 65 20 73 | 63 61 6e 6e 65 64 0a 58 | to be s|canned.X|
|00004070| 61 73 20 74 68 6f 75 67 | 68 20 74 68 65 79 20 77 |as thoug|h they w|
|00004080| 65 72 65 20 6c 61 6e 67 | 75 61 67 65 20 76 68 69 |ere lang|uage vhi|
|00004090| 6c 20 72 61 74 68 65 72 | 20 74 68 61 6e 20 63 2e |l rather| than c.|
|000040a0| 0a 58 59 6f 75 20 6d 61 | 79 20 66 69 6e 64 0a 58 |.XYou ma|y find.X|
|000040b0| 6f 75 74 20 77 68 69 63 | 68 20 73 75 66 66 69 78 |out whic|h suffix|
|000040c0| 65 73 20 61 72 65 20 64 | 65 66 69 6e 65 64 20 66 |es are d|efined f|
|000040d0| 6f 72 20 77 68 69 63 68 | 20 6c 61 6e 67 75 61 67 |or which| languag|
|000040e0| 65 73 20 77 69 74 68 20 | 74 68 65 20 66 6f 6c 6c |es with |the foll|
|000040f0| 6f 77 69 6e 67 0a 58 6f | 70 74 69 6f 6e 73 3a 20 |owing.Xo|ptions: |
|00004100| 60 2d 53 3c 73 75 66 66 | 69 78 3e 3d 3f 27 20 74 |`-S<suff|ix>=?' t|
|00004110| 65 6c 6c 73 20 77 68 69 | 63 68 20 6c 61 6e 67 75 |ells whi|ch langu|
|00004120| 61 67 65 20 69 73 20 62 | 6f 75 6e 64 20 74 6f 0a |age is b|ound to.|
|00004130| 58 2e 49 52 20 3c 73 75 | 66 66 69 78 3e 20 2c 0a |X.IR <su|ffix> ,.|
|00004140| 58 60 2d 53 3f 3d 3c 6c | 61 6e 67 75 61 67 65 3e |X`-S?=<l|anguage>|
|00004150| 27 20 74 65 6c 6c 73 20 | 77 68 69 63 68 20 73 75 |' tells |which su|
|00004160| 66 66 69 78 65 73 20 61 | 72 65 20 62 6f 75 6e 64 |ffixes a|re bound|
|00004170| 20 74 6f 20 0a 58 2e 49 | 52 20 3c 6c 61 6e 67 75 | to .X.I|R <langu|
|00004180| 61 67 65 3e 20 2c 0a 58 | 61 6e 64 20 60 2d 53 3f |age> ,.X|and `-S?|
|00004190| 3d 3f 27 20 72 65 70 6f | 72 74 73 20 61 6c 6c 20 |=?' repo|rts all |
|000041a0| 62 69 6e 64 69 6e 67 73 | 20 62 65 74 77 65 65 6e |bindings| between|
|000041b0| 20 73 75 66 66 69 78 65 | 73 20 61 6e 64 20 6c 61 | suffixe|s and la|
|000041c0| 6e 67 75 61 67 65 73 2e | 0a 58 2e 50 50 0a 58 54 |nguages.|.X.PP.XT|
|000041d0| 68 65 20 73 65 63 6f 6e | 64 20 66 6f 72 6d 20 70 |he secon|d form p|
|000041e0| 61 73 73 65 73 20 61 6e | 20 61 72 67 75 6d 65 6e |asses an| argumen|
|000041f0| 74 20 66 6f 72 20 70 72 | 6f 63 65 73 73 69 6e 67 |t for pr|ocessing|
|00004200| 20 62 79 20 74 68 65 20 | 73 63 61 6e 6e 65 72 0a | by the |scanner.|
|00004210| 58 66 6f 72 20 61 20 73 | 70 65 63 69 66 69 63 20 |Xfor a s|pecific |
|00004220| 6c 61 6e 67 75 61 67 65 | 2e 20 20 54 68 65 20 74 |language|. The t|
|00004230| 68 69 72 64 20 66 6f 72 | 6d 20 70 61 73 73 65 73 |hird for|m passes|
|00004240| 20 61 6e 20 61 72 67 75 | 6d 65 6e 74 20 74 6f 0a | an argu|ment to.|
|00004250| 58 61 6c 6c 20 73 63 61 | 6e 6e 65 72 73 2e 0a 58 |Xall sca|nners..X|
|00004260| 2e 50 50 0a 58 46 69 6e | 61 6c 6c 79 2c 20 74 68 |.PP.XFin|ally, th|
|00004270| 65 20 3c 6c 61 6e 67 3e | 2f 3c 6c 61 6e 67 3e 2f |e <lang>|/<lang>/|
|00004280| 3c 66 69 6c 74 65 72 3e | 20 66 6f 72 6d 20 64 65 |<filter>| form de|
|00004290| 66 69 6e 65 73 20 61 20 | 73 68 65 6c 6c 20 63 6f |fines a |shell co|
|000042a0| 6d 6d 61 6e 64 0a 58 74 | 6f 20 66 69 6c 74 65 72 |mmand.Xt|o filter|
|000042b0| 20 74 68 65 20 66 69 6c | 65 20 77 69 74 68 2e 20 | the fil|e with. |
|000042c0| 54 68 69 73 20 63 61 6e | 20 62 65 20 75 73 65 64 |This can| be used|
|000042d0| 20 74 6f 20 72 75 6e 20 | 61 6e 20 61 72 62 69 74 | to run |an arbit|
|000042e0| 72 61 72 79 0a 58 70 72 | 6f 67 72 61 6d 20 74 6f |rary.Xpr|ogram to|
|000042f0| 20 66 69 6c 74 65 72 20 | 74 68 65 20 63 6f 6e 74 | filter |the cont|
|00004300| 65 6e 74 73 20 6f 66 20 | 61 20 66 69 6c 65 20 62 |ents of |a file b|
|00004310| 65 66 6f 72 65 20 69 74 | 20 69 73 20 70 61 73 73 |efore it| is pass|
|00004320| 65 64 0a 58 74 6f 20 6f | 6e 65 20 6f 66 20 74 68 |ed.Xto o|ne of th|
|00004330| 65 20 65 78 69 73 74 69 | 6e 67 20 6c 61 6e 67 75 |e existi|ng langu|
|00004340| 61 67 65 20 73 63 61 6e | 6e 65 72 73 2e 20 49 74 |age scan|ners. It|
|00004350| 20 69 73 20 74 79 70 69 | 63 61 6c 6c 79 0a 58 75 | is typi|cally.Xu|
|00004360| 73 65 64 20 69 6e 20 63 | 6f 6e 6a 75 6e 63 74 69 |sed in c|onjuncti|
|00004370| 6f 6e 20 77 69 74 68 20 | 74 68 65 20 70 6c 61 69 |on with |the plai|
|00004380| 6e 20 74 65 78 74 20 73 | 63 61 6e 6e 65 72 2e 0a |n text s|canner..|
|00004390| 58 54 68 65 20 66 69 72 | 73 74 20 3c 6c 61 6e 67 |XThe fir|st <lang|
|000043a0| 3e 20 64 65 66 69 6e 65 | 73 20 61 20 6e 65 77 20 |> define|s a new |
|000043b0| 6c 61 6e 67 75 61 67 65 | 2c 20 74 68 65 20 73 65 |language|, the se|
|000043c0| 63 6f 6e 64 20 3c 6c 61 | 6e 67 3e 0a 58 73 70 65 |cond <la|ng>.Xspe|
|000043d0| 63 69 66 69 65 73 20 61 | 6e 20 65 78 69 73 74 69 |cifies a|n existi|
|000043e0| 6e 67 20 6c 61 6e 67 75 | 61 67 65 20 77 68 6f 73 |ng langu|age whos|
|000043f0| 65 20 73 63 61 6e 6e 65 | 72 20 77 69 6c 6c 20 62 |e scanne|r will b|
|00004400| 65 20 75 73 65 64 2c 0a | 58 61 6e 64 20 74 68 65 |e used,.|Xand the|
|00004410| 20 72 65 6d 61 69 6e 69 | 6e 67 20 3c 66 69 6c 74 | remaini|ng <filt|
|00004420| 65 72 3e 20 69 73 20 61 | 6e 20 61 72 62 69 74 72 |er> is a|n arbitr|
|00004430| 61 72 79 20 73 68 65 6c | 6c 20 63 6f 6d 6d 61 6e |ary shel|l comman|
|00004440| 64 2e 0a 58 2e 50 50 0a | 58 59 6f 75 20 6d 61 79 |d..X.PP.|XYou may|
|00004450| 20 67 65 74 20 61 20 62 | 72 69 65 66 20 73 75 6d | get a b|rief sum|
|00004460| 6d 61 72 79 20 6f 66 20 | 74 68 65 20 73 63 61 6e |mary of |the scan|
|00004470| 6e 65 72 2d 73 70 65 63 | 69 66 69 63 20 6f 70 74 |ner-spec|ific opt|
|00004480| 69 6f 6e 73 20 66 6f 72 | 20 61 0a 58 6c 61 6e 67 |ions for| a.Xlang|
|00004490| 75 61 67 65 20 62 79 20 | 73 75 70 70 6c 79 69 6e |uage by |supplyin|
|000044a0| 67 20 74 68 65 20 66 6f | 6c 6c 6f 77 69 6e 67 20 |g the fo|llowing |
|000044b0| 6f 70 74 69 6f 6e 3a 20 | 60 2d 53 3c 6c 61 6e 67 |option: |`-S<lang|
|000044c0| 75 61 67 65 3e 3f 27 2e | 0a 58 2e 50 50 0a 58 48 |uage>?'.|.X.PP.XH|
|000044d0| 65 72 65 20 69 73 20 61 | 20 62 72 69 65 66 20 73 |ere is a| brief s|
|000044e0| 75 6d 6d 61 72 79 20 6f | 66 20 74 68 65 20 6f 70 |ummary o|f the op|
|000044f0| 74 69 6f 6e 73 20 66 6f | 72 20 74 68 65 0a 58 2e |tions fo|r the.X.|
|00004500| 49 20 60 61 73 6d 27 5c | 5e 0a 58 28 61 73 73 65 |I `asm'\|^.X(asse|
|00004510| 6d 62 6c 65 72 29 20 6c | 61 6e 67 75 61 67 65 2e |mbler) l|anguage.|
|00004520| 0a 58 2e 50 50 0a 58 54 | 68 65 0a 58 2e 42 20 5c |.X.PP.XT|he.X.B \|
|00004530| 2d 75 5c 5e 0a 58 6f 70 | 74 69 6f 6e 20 63 6f 6e |-u\^.Xop|tion con|
|00004540| 74 72 6f 6c 73 20 77 68 | 65 74 68 65 72 20 6f 72 |trols wh|ether or|
|00004550| 20 6e 6f 74 20 74 68 65 | 20 61 73 73 65 6d 62 6c | not the| assembl|
|00004560| 65 72 20 73 63 61 6e 6e | 65 72 20 73 68 6f 75 6c |er scann|er shoul|
|00004570| 64 20 73 74 72 69 70 0a | 58 6f 66 66 20 61 20 6c |d strip.|Xoff a l|
|00004580| 65 61 64 69 6e 67 0a 58 | 2e 49 20 75 6e 64 65 72 |eading.X|.I under|
|00004590| 73 63 6f 72 65 5c 5e 0a | 58 28 60 5f 27 29 20 63 |score\^.|X(`_') c|
|000045a0| 68 61 72 61 63 74 65 72 | 2e 20 20 49 66 20 79 6f |haracter|. If yo|
|000045b0| 75 72 20 61 73 73 65 6d | 62 6c 65 72 20 70 72 65 |ur assem|bler pre|
|000045c0| 70 65 6e 64 73 20 61 6e | 0a 58 2e 49 20 75 6e 64 |pends an|.X.I und|
|000045d0| 65 72 73 63 6f 72 65 5c | 5e 0a 58 74 6f 20 65 78 |erscore\|^.Xto ex|
|000045e0| 74 65 72 6e 61 6c 20 73 | 79 6d 62 6f 6c 73 2c 20 |ternal s|ymbols, |
|000045f0| 74 68 65 6e 20 79 6f 75 | 20 73 68 6f 75 6c 64 20 |then you| should |
|00004600| 74 65 6c 6c 20 74 68 65 | 20 73 63 61 6e 6e 65 72 |tell the| scanner|
|00004610| 20 74 6f 20 73 74 72 69 | 70 20 69 74 0a 58 6f 66 | to stri|p it.Xof|
|00004620| 66 2c 20 73 6f 20 74 68 | 61 74 20 72 65 66 65 72 |f, so th|at refer|
|00004630| 65 6e 63 65 73 20 74 6f | 20 74 68 65 20 73 61 6d |ences to| the sam|
|00004640| 65 20 73 79 6d 62 6f 6c | 20 66 72 6f 6d 20 61 73 |e symbol| from as|
|00004650| 73 65 6d 62 6c 79 20 61 | 6e 64 20 66 72 6f 6d 0a |sembly a|nd from.|
|00004660| 58 61 20 68 69 67 68 2d | 6c 65 76 65 6c 20 6c 61 |Xa high-|level la|
|00004670| 6e 67 75 61 67 65 20 77 | 69 6c 6c 20 6c 6f 6f 6b |nguage w|ill look|
|00004680| 20 74 68 65 20 73 61 6d | 65 2e 0a 58 2e 50 50 0a | the sam|e..X.PP.|
|00004690| 58 54 68 65 0a 58 2e 42 | 20 5c 2d 63 3c 63 63 3e |XThe.X.B| \-c<cc>|
|000046a0| 5c 5e 0a 58 6f 70 74 69 | 6f 6e 20 73 75 70 70 6c |\^.Xopti|on suppl|
|000046b0| 69 65 73 20 74 68 65 20 | 63 68 61 72 61 63 74 65 |ies the |characte|
|000046c0| 72 28 73 29 20 75 73 65 | 64 20 74 6f 20 62 65 67 |r(s) use|d to beg|
|000046d0| 69 6e 20 61 20 63 6f 6d | 6d 65 6e 74 20 74 68 61 |in a com|ment tha|
|000046e0| 74 20 65 78 74 65 6e 64 | 73 0a 58 74 6f 20 74 68 |t extend|s.Xto th|
|000046f0| 65 20 65 6e 64 20 6f 66 | 20 74 68 65 20 6c 69 6e |e end of| the lin|
|00004700| 65 2e 0a 58 2e 50 50 0a | 58 54 68 65 0a 58 2e 42 |e..X.PP.|XThe.X.B|
|00004710| 20 5c 2d 61 3c 63 63 3e | 5c 5e 0a 58 6f 70 74 69 | \-a<cc>|\^.Xopti|
|00004720| 6f 6e 20 69 6e 64 69 63 | 61 74 65 73 20 63 68 61 |on indic|ates cha|
|00004730| 72 61 63 74 65 72 28 73 | 29 20 74 68 61 74 20 61 |racter(s|) that a|
|00004740| 72 65 20 6c 65 67 61 6c | 20 69 6e 20 6e 61 6d 65 |re legal| in name|
|00004750| 73 2c 20 69 6e 20 61 64 | 64 69 74 69 6f 6e 20 74 |s, in ad|dition t|
|00004760| 6f 0a 58 74 68 65 20 61 | 6c 70 68 61 2d 6e 75 6d |o.Xthe a|lpha-num|
|00004770| 65 72 69 63 20 63 68 61 | 72 61 63 74 65 72 73 2e |eric cha|racters.|
|00004780| 20 20 49 66 20 74 68 65 | 20 6f 70 74 69 6f 6e 20 | If the| option |
|00004790| 61 70 70 65 61 72 73 20 | 61 73 20 60 2d 61 27 2c |appears |as `-a',|
|000047a0| 20 6e 61 6d 65 73 0a 58 | 74 68 61 74 20 63 6f 6e | names.X|that con|
|000047b0| 74 61 69 6e 20 74 68 65 | 73 65 20 63 68 61 72 61 |tain the|se chara|
|000047c0| 63 74 65 72 73 20 61 72 | 65 20 69 67 6e 6f 72 65 |cters ar|e ignore|
|000047d0| 64 2e 20 20 49 66 20 69 | 74 20 61 70 70 65 61 72 |d. If i|t appear|
|000047e0| 73 20 61 73 20 60 2b 61 | 27 2c 20 74 68 65 73 65 |s as `+a|', these|
|000047f0| 0a 58 6e 61 6d 65 73 20 | 61 72 65 20 61 64 64 65 |.Xnames |are adde|
|00004800| 64 20 74 6f 20 74 68 65 | 20 64 61 74 61 62 61 73 |d to the| databas|
|00004810| 65 2e 0a 58 2e 53 48 20 | 42 55 47 53 0a 58 54 68 |e..X.SH |BUGS.XTh|
|00004820| 69 73 20 6d 61 6e 75 61 | 6c 20 70 61 67 65 20 6e |is manua|l page n|
|00004830| 65 65 64 73 20 74 6f 20 | 62 65 20 6d 6f 72 65 20 |eeds to |be more |
|00004840| 63 6f 6d 70 6c 65 74 65 | 20 61 62 6f 75 74 20 74 |complete| about t|
|00004850| 68 65 20 73 63 61 6e 6e | 65 72 2d 73 70 65 63 69 |he scann|er-speci|
|00004860| 66 69 63 0a 58 61 72 67 | 75 6d 65 6e 74 73 2e 0a |fic.Xarg|uments..|
|00004870| 58 2e 50 50 0a 58 41 74 | 20 74 68 65 20 6d 6f 6d |X.PP.XAt| the mom|
|00004880| 65 6e 74 2c 20 74 68 65 | 20 6f 6e 6c 79 20 73 63 |ent, the| only sc|
|00004890| 61 6e 6e 65 72 73 20 69 | 6d 70 6c 65 6d 65 6e 74 |anners i|mplement|
|000048a0| 65 64 20 61 72 65 20 66 | 6f 72 20 43 2c 20 61 73 |ed are f|or C, as|
|000048b0| 73 65 6d 62 6c 79 0a 58 | 6c 61 6e 67 75 61 67 65 |sembly.X|language|
|000048c0| 2c 20 61 6e 64 20 70 6c | 61 69 6e 20 74 65 78 74 |, and pl|ain text|
|000048d0| 2e 20 20 54 68 65 72 65 | 20 6f 75 67 68 74 20 74 |. There| ought t|
|000048e0| 6f 20 62 65 20 73 63 61 | 6e 6e 65 72 73 20 66 6f |o be sca|nners fo|
|000048f0| 72 20 41 64 61 2c 20 50 | 61 73 63 61 6c 2c 0a 58 |r Ada, P|ascal,.X|
|00004900| 46 6f 72 74 72 61 6e 2c | 20 61 6e 64 20 4c 69 73 |Fortran,| and Lis|
|00004910| 70 2e 0a 58 2e 53 48 20 | 53 45 45 20 41 4c 53 4f |p..X.SH |SEE ALSO|
|00004920| 0a 58 6c 69 64 28 31 29 | 2c 20 64 65 72 6f 66 66 |.Xlid(1)|, deroff|
|00004930| 28 31 29 2c 20 64 65 74 | 65 78 28 31 29 2e 0a 45 |(1), det|ex(1)..E|
|00004940| 4e 44 5f 4f 46 5f 46 49 | 4c 45 0a 69 66 20 74 65 |ND_OF_FI|LE.if te|
|00004950| 73 74 20 35 35 36 34 20 | 2d 6e 65 20 60 77 63 20 |st 5564 |-ne `wc |
|00004960| 2d 63 20 3c 27 6d 6b 69 | 64 2e 31 27 60 3b 20 74 |-c <'mki|d.1'`; t|
|00004970| 68 65 6e 0a 20 20 20 20 | 65 63 68 6f 20 73 68 61 |hen. |echo sha|
|00004980| 72 3a 20 5c 22 27 6d 6b | 69 64 2e 31 27 5c 22 20 |r: \"'mk|id.1'\" |
|00004990| 75 6e 70 61 63 6b 65 64 | 20 77 69 74 68 20 77 72 |unpacked| with wr|
|000049a0| 6f 6e 67 20 73 69 7a 65 | 21 0a 66 69 0a 23 20 65 |ong size|!.fi.# e|
|000049b0| 6e 64 20 6f 66 20 27 6d | 6b 69 64 2e 31 27 0a 66 |nd of 'm|kid.1'.f|
|000049c0| 69 0a 65 63 68 6f 20 73 | 68 61 72 3a 20 45 6e 64 |i.echo s|har: End|
|000049d0| 20 6f 66 20 61 72 63 68 | 69 76 65 20 34 20 5c 28 | of arch|ive 4 \(|
|000049e0| 6f 66 20 31 31 5c 29 2e | 0a 63 70 20 2f 64 65 76 |of 11\).|.cp /dev|
|000049f0| 2f 6e 75 6c 6c 20 61 72 | 6b 34 69 73 64 6f 6e 65 |/null ar|k4isdone|
|00004a00| 0a 4d 49 53 53 49 4e 47 | 3d 22 22 0a 66 6f 72 20 |.MISSING|="".for |
|00004a10| 49 20 69 6e 20 31 20 32 | 20 33 20 34 20 35 20 36 |I in 1 2| 3 4 5 6|
|00004a20| 20 37 20 38 20 39 20 31 | 30 20 31 31 20 3b 20 64 | 7 8 9 1|0 11 ; d|
|00004a30| 6f 0a 20 20 20 20 69 66 | 20 74 65 73 74 20 21 20 |o. if| test ! |
|00004a40| 2d 66 20 61 72 6b 24 7b | 49 7d 69 73 64 6f 6e 65 |-f ark${|I}isdone|
|00004a50| 20 3b 20 74 68 65 6e 0a | 09 4d 49 53 53 49 4e 47 | ; then.|.MISSING|
|00004a60| 3d 22 24 7b 4d 49 53 53 | 49 4e 47 7d 20 24 7b 49 |="${MISS|ING} ${I|
|00004a70| 7d 22 0a 20 20 20 20 66 | 69 0a 64 6f 6e 65 0a 69 |}". f|i.done.i|
|00004a80| 66 20 74 65 73 74 20 22 | 24 7b 4d 49 53 53 49 4e |f test "|${MISSIN|
|00004a90| 47 7d 22 20 3d 20 22 22 | 20 3b 20 74 68 65 6e 0a |G}" = ""| ; then.|
|00004aa0| 20 20 20 20 65 63 68 6f | 20 59 6f 75 20 68 61 76 | echo| You hav|
|00004ab0| 65 20 75 6e 70 61 63 6b | 65 64 20 61 6c 6c 20 31 |e unpack|ed all 1|
|00004ac0| 31 20 61 72 63 68 69 76 | 65 73 2e 0a 20 20 20 20 |1 archiv|es.. |
|00004ad0| 72 6d 20 2d 66 20 61 72 | 6b 5b 31 2d 39 5d 69 73 |rm -f ar|k[1-9]is|
|00004ae0| 64 6f 6e 65 20 61 72 6b | 5b 31 2d 39 5d 5b 30 2d |done ark|[1-9][0-|
|00004af0| 39 5d 69 73 64 6f 6e 65 | 0a 65 6c 73 65 0a 20 20 |9]isdone|.else. |
|00004b00| 20 20 65 63 68 6f 20 59 | 6f 75 20 73 74 69 6c 6c | echo Y|ou still|
|00004b10| 20 6e 65 65 64 20 74 6f | 20 75 6e 70 61 63 6b 20 | need to| unpack |
|00004b20| 74 68 65 20 66 6f 6c 6c | 6f 77 69 6e 67 20 61 72 |the foll|owing ar|
|00004b30| 63 68 69 76 65 73 3a 0a | 20 20 20 20 65 63 68 6f |chives:.| echo|
|00004b40| 20 22 20 20 20 20 20 20 | 20 20 22 20 24 7b 4d 49 | " | " ${MI|
|00004b50| 53 53 49 4e 47 7d 0a 66 | 69 0a 23 23 20 20 45 6e |SSING}.f|i.## En|
|00004b60| 64 20 6f 66 20 73 68 65 | 6c 6c 20 61 72 63 68 69 |d of she|ll archi|
|00004b70| 76 65 2e 0a 65 78 69 74 | 20 30 0a 2d 2d 0a 3d 3d |ve..exit| 0.--.==|
|00004b80| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00004b90| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00004ba0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00004bb0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00004bc0| 3d 3d 3d 3d 0a 64 6f 6d | 61 69 6e 3a 20 74 61 68 |====.dom|ain: tah|
|00004bd0| 6f 72 73 6c 65 79 40 63 | 73 64 2e 68 61 72 72 69 |orsley@c|sd.harri|
|00004be0| 73 2e 63 6f 6d 20 20 20 | 20 20 20 20 55 53 4d 61 |s.com | USMa|
|00004bf0| 69 6c 3a 20 54 6f 6d 20 | 48 6f 72 73 6c 65 79 0a |il: Tom |Horsley.|
|00004c00| 20 20 75 75 63 70 3a 20 | 2e 2e 2e 21 75 75 6e 65 | uucp: |...!uune|
|00004c10| 74 21 68 63 78 31 21 74 | 61 68 6f 72 73 6c 65 79 |t!hcx1!t|ahorsley|
|00004c20| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 35 | | 5|
|00004c30| 31 31 20 4b 69 6e 67 62 | 69 72 64 20 43 69 72 63 |11 Kingb|ird Circ|
|00004c40| 6c 65 0a 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |le. | |
|00004c50| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00004c60| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00004c70| 20 20 44 65 6c 72 61 79 | 20 42 65 61 63 68 2c 20 | Delray| Beach, |
|00004c80| 46 4c 20 20 33 33 34 34 | 34 0a 2b 3d 3d 3d 3d 20 |FL 3344|4.+==== |
|00004c90| 43 65 6e 73 6f 72 73 68 | 69 70 20 69 73 20 74 68 |Censorsh|ip is th|
|00004ca0| 65 20 6f 6e 6c 79 20 66 | 6f 72 6d 20 6f 66 20 4f |e only f|orm of O|
|00004cb0| 62 73 63 65 6e 69 74 79 | 20 3d 3d 3d 3d 3d 3d 3d |bscenity| =======|
|00004cc0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 2b |========|=======+|
|00004cd0| 0a 7c 20 20 20 20 20 28 | 57 61 69 74 2c 20 49 20 |.| (|Wait, I |
|00004ce0| 66 6f 72 67 6f 74 20 67 | 6f 76 65 72 6e 6d 65 6e |forgot g|overnmen|
|00004cf0| 74 20 74 6f 62 61 63 63 | 6f 20 73 75 62 73 69 64 |t tobacc|o subsid|
|00004d00| 69 65 73 2e 2e 2e 29 20 | 20 20 20 20 20 20 20 20 |ies...) | |
|00004d10| 20 20 20 20 20 20 7c 0a | 2b 3d 3d 3d 3d 3d 3d 3d | |.|+=======|
|00004d20| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00004d30| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00004d40| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|00004d50| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 2b 0a |========|=====+. |
+--------+-------------------------+-------------------------+--------+--------+
