home *** CD-ROM | disk | FTP | other *** search
open in: 
MacOS 8.1
|
Win98
|
DOS
browse contents |
view JSON data
|
view as text
This file was processed as: SHell self-extracting ARchive
(archive/shar).
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 100%
| dexvert
| Newsgroup Content (archive/news)
| magic
| Supported |
| 100%
| dexvert
| SHell self-extracting ARchive (archive/shar)
| magic
| Supported |
| 100%
| dexvert
| Texinfo Document (document/texInfo)
| magic
| Supported |
| 100%
| dexvert
| Internet Message Format (text/imf)
| magic
| Supported |
| 1%
| dexvert
| Text File (text/txt)
| fallback
| Supported |
| 100%
| file
| news or mail text
| default
| |
| 99%
| file
| TeX document, ASCII text
| default
| |
| 100%
| checkBytes
| Printable ASCII
| default
| |
| 100%
| perlTextCheck
| Likely Text (Perl)
| default
| |
| 100%
| siegfried
| fmt/329 Shell Archive Format
| default
| |
| 100%
| detectItEasy
| Format: plain text[LF]
| default (weak)
| |
| 100%
| xdgMime
| message/rfc822
| default
|
|
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 53 75 62 6a 65 63 74 3a | 20 20 76 32 34 69 30 39 |Subject:| v24i09|
|00000010| 35 3a 20 20 50 72 6f 67 | 72 61 6d 20 69 64 65 6e |5: Prog|ram iden|
|00000020| 74 69 66 69 65 72 20 64 | 61 74 61 62 61 73 65 20 |tifier d|atabase |
|00000030| 74 6f 6f 6c 73 2c 20 50 | 61 72 74 30 37 2f 30 37 |tools, P|art07/07|
|00000040| 0a 4e 65 77 73 67 72 6f | 75 70 73 3a 20 63 6f 6d |.Newsgro|ups: com|
|00000050| 70 2e 73 6f 75 72 63 65 | 73 2e 75 6e 69 78 0a 41 |p.source|s.unix.A|
|00000060| 70 70 72 6f 76 65 64 3a | 20 72 73 61 6c 7a 40 75 |pproved:| rsalz@u|
|00000070| 75 6e 65 74 2e 55 55 2e | 4e 45 54 0a 58 2d 43 68 |unet.UU.|NET.X-Ch|
|00000080| 65 63 6b 73 75 6d 2d 53 | 6e 65 66 72 75 3a 20 38 |ecksum-S|nefru: 8|
|00000090| 35 38 35 34 65 62 64 20 | 38 32 66 37 39 37 36 30 |5854ebd |82f79760|
|000000a0| 20 62 34 34 64 36 31 35 | 63 20 35 31 66 62 32 31 | b44d615|c 51fb21|
|000000b0| 35 37 0a 0a 53 75 62 6d | 69 74 74 65 64 2d 62 79 |57..Subm|itted-by|
|000000c0| 3a 20 54 6f 6d 20 48 6f | 72 73 6c 65 79 20 3c 74 |: Tom Ho|rsley <t|
|000000d0| 6f 6d 40 68 63 78 32 2e | 73 73 64 2e 63 73 64 2e |om@hcx2.|ssd.csd.|
|000000e0| 68 61 72 72 69 73 2e 63 | 6f 6d 3e 0a 50 6f 73 74 |harris.c|om>.Post|
|000000f0| 69 6e 67 2d 6e 75 6d 62 | 65 72 3a 20 56 6f 6c 75 |ing-numb|er: Volu|
|00000100| 6d 65 20 32 34 2c 20 49 | 73 73 75 65 20 39 35 0a |me 24, I|ssue 95.|
|00000110| 41 72 63 68 69 76 65 2d | 6e 61 6d 65 3a 20 6d 6b |Archive-|name: mk|
|00000120| 69 64 32 2f 70 61 72 74 | 30 37 0a 0a 23 21 20 2f |id2/part|07..#! /|
|00000130| 62 69 6e 2f 73 68 0a 23 | 20 54 68 69 73 20 69 73 |bin/sh.#| This is|
|00000140| 20 61 20 73 68 65 6c 6c | 20 61 72 63 68 69 76 65 | a shell| archive|
|00000150| 2e 20 20 52 65 6d 6f 76 | 65 20 61 6e 79 74 68 69 |. Remov|e anythi|
|00000160| 6e 67 20 62 65 66 6f 72 | 65 20 74 68 69 73 20 6c |ng befor|e this l|
|00000170| 69 6e 65 2c 20 74 68 65 | 6e 20 75 6e 70 61 63 6b |ine, the|n unpack|
|00000180| 0a 23 20 69 74 20 62 79 | 20 73 61 76 69 6e 67 20 |.# it by| saving |
|00000190| 69 74 20 69 6e 74 6f 20 | 61 20 66 69 6c 65 20 61 |it into |a file a|
|000001a0| 6e 64 20 74 79 70 69 6e | 67 20 22 73 68 20 66 69 |nd typin|g "sh fi|
|000001b0| 6c 65 22 2e 20 20 54 6f | 20 6f 76 65 72 77 72 69 |le". To| overwri|
|000001c0| 74 65 20 65 78 69 73 74 | 69 6e 67 0a 23 20 66 69 |te exist|ing.# fi|
|000001d0| 6c 65 73 2c 20 74 79 70 | 65 20 22 73 68 20 66 69 |les, typ|e "sh fi|
|000001e0| 6c 65 20 2d 63 22 2e 20 | 20 59 6f 75 20 63 61 6e |le -c". | You can|
|000001f0| 20 61 6c 73 6f 20 66 65 | 65 64 20 74 68 69 73 20 | also fe|ed this |
|00000200| 61 73 20 73 74 61 6e 64 | 61 72 64 20 69 6e 70 75 |as stand|ard inpu|
|00000210| 74 20 76 69 61 0a 23 20 | 75 6e 73 68 61 72 2c 20 |t via.# |unshar, |
|00000220| 6f 72 20 62 79 20 74 79 | 70 69 6e 67 20 22 73 68 |or by ty|ping "sh|
|00000230| 20 3c 66 69 6c 65 22 2c | 20 65 2e 67 2e 2e 20 20 | <file",| e.g.. |
|00000240| 49 66 20 74 68 69 73 20 | 61 72 63 68 69 76 65 20 |If this |archive |
|00000250| 69 73 20 63 6f 6d 70 6c | 65 74 65 2c 20 79 6f 75 |is compl|ete, you|
|00000260| 0a 23 20 77 69 6c 6c 20 | 73 65 65 20 74 68 65 20 |.# will |see the |
|00000270| 66 6f 6c 6c 6f 77 69 6e | 67 20 6d 65 73 73 61 67 |followin|g messag|
|00000280| 65 20 61 74 20 74 68 65 | 20 65 6e 64 3a 0a 23 09 |e at the| end:.#.|
|00000290| 09 22 45 6e 64 20 6f 66 | 20 61 72 63 68 69 76 65 |."End of| archive|
|000002a0| 20 37 20 28 6f 66 20 37 | 29 2e 22 0a 23 20 43 6f | 7 (of 7|).".# Co|
|000002b0| 6e 74 65 6e 74 73 3a 20 | 20 69 64 2e 74 65 78 69 |ntents: | id.texi|
|000002c0| 6e 66 6f 0a 23 20 57 72 | 61 70 70 65 64 20 62 79 |nfo.# Wr|apped by|
|000002d0| 20 74 6f 6d 40 68 63 78 | 32 20 6f 6e 20 54 75 65 | tom@hcx|2 on Tue|
|000002e0| 20 46 65 62 20 32 36 20 | 31 30 3a 30 33 3a 30 39 | Feb 26 |10:03:09|
|000002f0| 20 31 39 39 31 0a 50 41 | 54 48 3d 2f 62 69 6e 3a | 1991.PA|TH=/bin:|
|00000300| 2f 75 73 72 2f 62 69 6e | 3a 2f 75 73 72 2f 75 63 |/usr/bin|:/usr/uc|
|00000310| 62 20 3b 20 65 78 70 6f | 72 74 20 50 41 54 48 0a |b ; expo|rt PATH.|
|00000320| 69 66 20 74 65 73 74 20 | 2d 66 20 27 69 64 2e 74 |if test |-f 'id.t|
|00000330| 65 78 69 6e 66 6f 27 20 | 2d 61 20 22 24 7b 31 7d |exinfo' |-a "${1}|
|00000340| 22 20 21 3d 20 22 2d 63 | 22 20 3b 20 74 68 65 6e |" != "-c|" ; then|
|00000350| 20 0a 20 20 65 63 68 6f | 20 73 68 61 72 3a 20 57 | . echo| shar: W|
|00000360| 69 6c 6c 20 6e 6f 74 20 | 63 6c 6f 62 62 65 72 20 |ill not |clobber |
|00000370| 65 78 69 73 74 69 6e 67 | 20 66 69 6c 65 20 5c 22 |existing| file \"|
|00000380| 27 69 64 2e 74 65 78 69 | 6e 66 6f 27 5c 22 0a 65 |'id.texi|nfo'\".e|
|00000390| 6c 73 65 0a 65 63 68 6f | 20 73 68 61 72 3a 20 45 |lse.echo| shar: E|
|000003a0| 78 74 72 61 63 74 69 6e | 67 20 5c 22 27 69 64 2e |xtractin|g \"'id.|
|000003b0| 74 65 78 69 6e 66 6f 27 | 5c 22 20 5c 28 33 38 31 |texinfo'|\" \(381|
|000003c0| 37 36 20 63 68 61 72 61 | 63 74 65 72 73 5c 29 0a |76 chara|cters\).|
|000003d0| 73 65 64 20 22 73 2f 5e | 58 2f 2f 22 20 3e 27 69 |sed "s/^|X//" >'i|
|000003e0| 64 2e 74 65 78 69 6e 66 | 6f 27 20 3c 3c 27 45 4e |d.texinf|o' <<'EN|
|000003f0| 44 5f 4f 46 5f 46 49 4c | 45 27 0a 58 5c 69 6e 70 |D_OF_FIL|E'.X\inp|
|00000400| 75 74 20 74 65 78 69 6e | 66 6f 20 20 20 40 63 20 |ut texin|fo @c |
|00000410| 2d 2a 2d 74 65 78 69 6e | 66 6f 2d 2a 2d 0a 58 40 |-*-texin|fo-*-.X@|
|00000420| 63 6f 6d 6d 65 6e 74 20 | 25 2a 2a 73 74 61 72 74 |comment |%**start|
|00000430| 20 6f 66 20 68 65 61 64 | 65 72 20 28 54 68 69 73 | of head|er (This|
|00000440| 20 69 73 20 66 6f 72 20 | 72 75 6e 6e 69 6e 67 20 | is for |running |
|00000450| 54 65 78 69 6e 66 6f 20 | 6f 6e 20 61 20 72 65 67 |Texinfo |on a reg|
|00000460| 69 6f 6e 2e 29 0a 58 40 | 73 65 74 66 69 6c 65 6e |ion.).X@|setfilen|
|00000470| 61 6d 65 20 69 64 2d 69 | 6e 66 6f 0a 58 40 73 65 |ame id-i|nfo.X@se|
|00000480| 74 74 69 74 6c 65 20 54 | 68 65 20 49 44 20 44 61 |ttitle T|he ID Da|
|00000490| 74 61 62 61 73 65 0a 58 | 40 73 65 74 63 68 61 70 |tabase.X|@setchap|
|000004a0| 74 65 72 6e 65 77 70 61 | 67 65 20 6f 64 64 0a 58 |ternewpa|ge odd.X|
|000004b0| 40 63 6f 6d 6d 65 6e 74 | 20 25 2a 2a 65 6e 64 20 |@comment| %**end |
|000004c0| 6f 66 20 68 65 61 64 65 | 72 20 28 54 68 69 73 20 |of heade|r (This |
|000004d0| 69 73 20 66 6f 72 20 72 | 75 6e 6e 69 6e 67 20 54 |is for r|unning T|
|000004e0| 65 78 69 6e 66 6f 20 6f | 6e 20 61 20 72 65 67 69 |exinfo o|n a regi|
|000004f0| 6f 6e 2e 29 0a 58 0a 58 | 40 69 66 69 6e 66 6f 0a |on.).X.X|@ifinfo.|
|00000500| 58 54 68 69 73 20 6d 61 | 6e 75 61 6c 20 69 73 20 |XThis ma|nual is |
|00000510| 6e 6f 74 20 63 6f 70 79 | 72 69 67 68 74 65 64 2c |not copy|righted,|
|00000520| 20 62 75 74 20 66 6f 72 | 20 79 6f 75 72 20 69 6e | but for| your in|
|00000530| 66 6f 72 6d 61 74 69 6f | 6e 20 69 74 20 77 61 73 |formatio|n it was|
|00000540| 20 77 72 69 74 74 65 6e | 0a 58 69 6e 20 31 39 39 | written|.Xin 199|
|00000550| 31 20 62 79 20 54 6f 6d | 20 48 6f 72 73 6c 65 79 |1 by Tom| Horsley|
|00000560| 2e 0a 58 0a 58 41 73 20 | 66 61 72 20 61 73 20 49 |..X.XAs |far as I|
|00000570| 20 61 6d 20 63 6f 6e 63 | 65 72 6e 65 64 2c 20 74 | am conc|erned, t|
|00000580| 68 69 73 20 6d 61 6e 75 | 61 6c 20 69 73 20 69 6e |his manu|al is in|
|00000590| 20 74 68 65 20 70 75 62 | 6c 69 63 20 64 6f 6d 61 | the pub|lic doma|
|000005a0| 69 6e 2e 20 4e 6f 74 20 | 65 76 65 6e 0a 58 63 6f |in. Not |even.Xco|
|000005b0| 70 79 6c 65 66 74 20 61 | 70 70 6c 69 65 73 2e 20 |pyleft a|pplies. |
|000005c0| 49 66 20 79 6f 75 20 74 | 68 69 6e 6b 20 79 6f 75 |If you t|hink you|
|000005d0| 20 63 61 6e 20 73 65 6c | 6c 20 69 74 20 66 6f 72 | can sel|l it for|
|000005e0| 20 61 20 70 72 6f 66 69 | 74 2c 20 67 6f 20 72 69 | a profi|t, go ri|
|000005f0| 67 68 74 0a 58 61 68 65 | 61 64 2e 2e 2e 0a 58 0a |ght.Xahe|ad....X.|
|00000600| 58 54 68 65 20 61 62 6f | 76 65 20 6e 6f 6e 2d 63 |XThe abo|ve non-c|
|00000610| 6f 70 79 72 69 67 68 74 | 20 6e 6f 74 69 63 65 20 |opyright| notice |
|00000620| 61 70 70 6c 69 65 73 20 | 6f 6e 6c 79 20 74 6f 20 |applies |only to |
|00000630| 74 68 69 73 20 6d 61 6e | 75 61 6c 2c 20 72 65 66 |this man|ual, ref|
|00000640| 65 72 20 74 6f 20 74 68 | 65 0a 58 73 6f 75 72 63 |er to th|e.Xsourc|
|00000650| 65 20 63 6f 64 65 20 66 | 6f 72 20 69 6e 66 6f 72 |e code f|or infor|
|00000660| 6d 61 74 69 6f 6e 20 6f | 6e 20 74 68 65 20 63 6f |mation o|n the co|
|00000670| 70 79 72 69 67 68 74 20 | 73 74 61 74 75 73 20 28 |pyright |status (|
|00000680| 69 66 20 61 6e 79 29 20 | 6f 66 20 74 68 65 20 66 |if any) |of the f|
|00000690| 69 6c 65 73 2e 0a 58 0a | 58 54 68 65 20 69 64 2d |iles..X.|XThe id-|
|000006a0| 69 6e 66 6f 20 66 69 6c | 65 20 66 6f 72 20 74 68 |info fil|e for th|
|000006b0| 69 73 20 64 6f 63 75 6d | 65 6e 74 20 6d 61 79 20 |is docum|ent may |
|000006c0| 62 65 20 63 72 65 61 74 | 65 64 20 75 73 69 6e 67 |be creat|ed using|
|000006d0| 20 74 68 65 20 6d 61 6b | 65 69 6e 66 6f 2e 63 0a | the mak|einfo.c.|
|000006e0| 58 70 72 6f 67 72 61 6d | 20 72 65 6c 65 61 73 65 |Xprogram| release|
|000006f0| 20 77 69 74 68 20 74 68 | 65 20 32 2e 33 32 20 76 | with th|e 2.32 v|
|00000700| 65 72 73 69 6f 6e 20 6f | 66 20 74 68 65 20 74 65 |ersion o|f the te|
|00000710| 78 69 6e 66 6f 2e 74 65 | 78 20 6d 61 63 72 6f 73 |xinfo.te|x macros|
|00000720| 2e 20 44 75 65 20 74 6f | 0a 58 74 68 65 20 65 78 |. Due to|.Xthe ex|
|00000730| 74 65 6e 73 69 76 65 20 | 75 73 65 20 6f 66 20 76 |tensive |use of v|
|00000740| 61 72 69 6f 75 73 20 64 | 65 66 69 6e 69 74 69 6f |arious d|efinitio|
|00000750| 6e 20 63 6f 6d 6d 61 6e | 64 73 20 61 6e 64 20 6e |n comman|ds and n|
|00000760| 65 73 74 65 64 20 63 6f | 6e 73 74 72 75 63 74 73 |ested co|nstructs|
|00000770| 0a 58 64 6f 6e 27 74 20 | 65 78 70 65 63 74 20 74 |.Xdon't |expect t|
|00000780| 6f 20 67 65 74 20 61 20 | 67 6f 6f 64 20 69 6e 66 |o get a |good inf|
|00000790| 6f 20 66 69 6c 65 20 77 | 69 74 68 20 74 65 78 69 |o file w|ith texi|
|000007a0| 6e 66 6f 2d 66 6f 72 6d | 61 74 2d 62 75 66 66 65 |nfo-form|at-buffe|
|000007b0| 72 20 6f 72 20 76 65 72 | 79 0a 58 65 61 72 6c 79 |r or ver|y.Xearly|
|000007c0| 20 76 65 72 73 69 6f 6e | 73 20 6f 66 20 6d 61 6b | version|s of mak|
|000007d0| 65 69 6e 66 6f 2e 63 2e | 0a 58 0a 58 49 20 6f 62 |einfo.c.|.X.XI ob|
|000007e0| 74 61 69 6e 65 64 20 74 | 68 65 20 74 65 78 69 6e |tained t|he texin|
|000007f0| 66 6f 2e 74 65 78 20 6d | 61 63 72 6f 73 20 61 6e |fo.tex m|acros an|
|00000800| 64 20 74 68 65 20 6d 61 | 6b 65 69 6e 66 6f 2e 63 |d the ma|keinfo.c|
|00000810| 20 66 69 6c 65 20 66 72 | 6f 6d 20 74 68 65 0a 58 | file fr|om the.X|
|00000820| 66 69 6c 65 20 70 75 62 | 2f 67 6e 75 2f 74 65 78 |file pub|/gnu/tex|
|00000830| 69 6e 66 6f 32 2e 74 61 | 72 2e 5a 20 6f 6e 20 70 |info2.ta|r.Z on p|
|00000840| 72 65 70 2e 61 69 2e 6d | 69 74 2e 65 64 75 2e 0a |rep.ai.m|it.edu..|
|00000850| 58 40 65 6e 64 20 69 66 | 69 6e 66 6f 0a 58 0a 58 |X@end if|info.X.X|
|00000860| 40 74 69 74 6c 65 70 61 | 67 65 0a 58 40 74 69 74 |@titlepa|ge.X@tit|
|00000870| 6c 65 20 54 68 65 20 49 | 44 20 44 61 74 61 62 61 |le The I|D Databa|
|00000880| 73 65 0a 58 40 73 75 62 | 74 69 74 6c 65 20 6d 6b |se.X@sub|title mk|
|00000890| 69 64 20 61 6e 64 20 66 | 72 69 65 6e 64 73 0a 58 |id and f|riends.X|
|000008a0| 40 73 75 62 74 69 74 6c | 65 20 6c 69 64 2c 20 67 |@subtitl|e lid, g|
|000008b0| 69 64 2c 20 61 69 64 2c | 20 65 69 64 2c 20 70 69 |id, aid,| eid, pi|
|000008c0| 64 2c 20 69 69 64 0a 58 | 40 61 75 74 68 6f 72 20 |d, iid.X|@author |
|000008d0| 54 6f 6d 20 48 6f 72 73 | 6c 65 79 0a 58 0a 58 40 |Tom Hors|ley.X.X@|
|000008e0| 70 61 67 65 0a 58 40 76 | 73 6b 69 70 20 30 70 74 |page.X@v|skip 0pt|
|000008f0| 20 70 6c 75 73 20 31 66 | 69 6c 6c 6c 0a 58 54 68 | plus 1f|illl.XTh|
|00000900| 69 73 20 6d 61 6e 75 61 | 6c 20 69 73 20 6e 6f 74 |is manua|l is not|
|00000910| 20 63 6f 70 79 72 69 67 | 68 74 65 64 2c 20 62 75 | copyrig|hted, bu|
|00000920| 74 20 66 6f 72 20 79 6f | 75 72 20 69 6e 66 6f 72 |t for yo|ur infor|
|00000930| 6d 61 74 69 6f 6e 20 69 | 74 20 77 61 73 20 77 72 |mation i|t was wr|
|00000940| 69 74 74 65 6e 0a 58 69 | 6e 20 31 39 39 31 20 62 |itten.Xi|n 1991 b|
|00000950| 79 20 54 6f 6d 20 48 6f | 72 73 6c 65 79 2e 0a 58 |y Tom Ho|rsley..X|
|00000960| 0a 58 41 73 20 66 61 72 | 20 61 73 20 49 20 61 6d |.XAs far| as I am|
|00000970| 20 63 6f 6e 63 65 72 6e | 65 64 2c 20 74 68 69 73 | concern|ed, this|
|00000980| 20 6d 61 6e 75 61 6c 20 | 69 73 20 69 6e 20 74 68 | manual |is in th|
|00000990| 65 20 70 75 62 6c 69 63 | 20 64 6f 6d 61 69 6e 2e |e public| domain.|
|000009a0| 20 4e 6f 74 20 65 76 65 | 6e 0a 58 63 6f 70 79 6c | Not eve|n.Xcopyl|
|000009b0| 65 66 74 20 61 70 70 6c | 69 65 73 2e 20 49 66 20 |eft appl|ies. If |
|000009c0| 79 6f 75 20 74 68 69 6e | 6b 20 79 6f 75 20 63 61 |you thin|k you ca|
|000009d0| 6e 20 73 65 6c 6c 20 69 | 74 20 66 6f 72 20 61 20 |n sell i|t for a |
|000009e0| 70 72 6f 66 69 74 2c 20 | 67 6f 20 72 69 67 68 74 |profit, |go right|
|000009f0| 0a 58 61 68 65 61 64 2e | 2e 2e 0a 58 0a 58 54 68 |.Xahead.|...X.XTh|
|00000a00| 65 20 61 62 6f 76 65 20 | 6e 6f 6e 2d 63 6f 70 79 |e above |non-copy|
|00000a10| 72 69 67 68 74 20 6e 6f | 74 69 63 65 20 61 70 70 |right no|tice app|
|00000a20| 6c 69 65 73 20 6f 6e 6c | 79 20 74 6f 20 74 68 69 |lies onl|y to thi|
|00000a30| 73 20 6d 61 6e 75 61 6c | 2c 20 72 65 66 65 72 20 |s manual|, refer |
|00000a40| 74 6f 20 74 68 65 20 73 | 6f 75 72 63 65 0a 58 63 |to the s|ource.Xc|
|00000a50| 6f 64 65 20 66 6f 72 20 | 69 6e 66 6f 72 6d 61 74 |ode for |informat|
|00000a60| 69 6f 6e 20 6f 6e 20 74 | 68 65 20 63 6f 70 79 72 |ion on t|he copyr|
|00000a70| 69 67 68 74 20 73 74 61 | 74 75 73 20 28 69 66 20 |ight sta|tus (if |
|00000a80| 61 6e 79 29 20 6f 66 20 | 74 68 65 20 66 69 6c 65 |any) of |the file|
|00000a90| 73 2e 0a 58 0a 58 54 68 | 69 73 20 64 6f 63 75 6d |s..X.XTh|is docum|
|00000aa0| 65 6e 74 20 77 61 73 20 | 70 72 65 70 61 72 65 64 |ent was |prepared|
|00000ab0| 20 75 73 69 6e 67 20 76 | 65 72 73 69 6f 6e 20 32 | using v|ersion 2|
|00000ac0| 2e 33 32 20 6f 66 20 74 | 68 65 20 40 66 69 6c 65 |.32 of t|he @file|
|00000ad0| 7b 74 65 78 69 6e 66 6f | 2e 74 65 78 7d 0a 58 6d |{texinfo|.tex}.Xm|
|00000ae0| 61 63 72 6f 20 70 61 63 | 6b 61 67 65 2c 20 62 75 |acro pac|kage, bu|
|00000af0| 74 20 49 20 73 75 73 70 | 65 63 74 20 61 6e 79 20 |t I susp|ect any |
|00000b00| 76 65 72 73 69 6f 6e 20 | 67 72 65 61 74 65 72 20 |version |greater |
|00000b10| 6f 72 20 65 71 75 61 6c | 20 74 6f 20 32 2e 30 20 |or equal| to 2.0 |
|00000b20| 77 69 6c 6c 20 77 6f 72 | 6b 2e 0a 58 40 65 6e 64 |will wor|k..X@end|
|00000b30| 20 74 69 74 6c 65 70 61 | 67 65 0a 58 0a 58 40 6e | titlepa|ge.X.X@n|
|00000b40| 6f 64 65 20 54 6f 70 2c | 20 4f 76 65 72 76 69 65 |ode Top,| Overvie|
|00000b50| 77 2c 20 28 64 69 72 29 | 2c 20 28 64 69 72 29 0a |w, (dir)|, (dir).|
|00000b60| 58 0a 58 40 6d 65 6e 75 | 0a 58 2a 20 4f 76 65 72 |X.X@menu|.X* Over|
|00000b70| 76 69 65 77 3a 3a 20 20 | 20 20 20 20 20 20 20 20 |view:: | |
|00000b80| 20 20 20 20 20 20 20 20 | 20 20 57 68 61 74 20 69 | | What i|
|00000b90| 73 20 61 6e 20 49 44 20 | 64 61 74 61 62 61 73 65 |s an ID |database|
|00000ba0| 20 61 6e 64 20 77 68 61 | 74 20 74 6f 6f 6c 73 20 | and wha|t tools |
|00000bb0| 6d 61 6e 69 70 75 6c 61 | 74 65 20 69 74 3f 0a 58 |manipula|te it?.X|
|00000bc0| 2a 20 4d 6b 69 64 3a 3a | 20 20 20 20 20 20 20 20 |* Mkid::| |
|00000bd0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00000be0| 4d 6b 69 64 0a 58 2a 20 | 44 61 74 61 62 61 73 65 |Mkid.X* |Database|
|00000bf0| 20 51 75 65 72 79 20 54 | 6f 6f 6c 73 3a 3a 20 20 | Query T|ools:: |
|00000c00| 20 20 20 20 20 20 44 61 | 74 61 62 61 73 65 20 51 | Da|tabase Q|
|00000c10| 75 65 72 79 20 54 6f 6f | 6c 73 0a 58 2a 20 49 69 |uery Too|ls.X* Ii|
|00000c20| 64 3a 3a 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |d:: | |
|00000c30| 20 20 20 20 20 20 20 20 | 20 20 20 20 49 69 64 0a | | Iid.|
|00000c40| 58 2a 20 4f 74 68 65 72 | 20 54 6f 6f 6c 73 3a 3a |X* Other| Tools::|
|00000c50| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00000c60| 20 4f 74 68 65 72 20 54 | 6f 6f 6c 73 0a 58 2a 20 | Other T|ools.X* |
|00000c70| 43 6f 6d 6d 61 6e 64 20 | 49 6e 64 65 78 3a 3a 20 |Command |Index:: |
|00000c80| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 43 6f | | Co|
|00000c90| 6d 6d 61 6e 64 20 49 6e | 64 65 78 0a 58 40 65 6e |mmand In|dex.X@en|
|00000ca0| 64 20 6d 65 6e 75 0a 58 | 0a 58 40 6e 6f 64 65 20 |d menu.X|.X@node |
|00000cb0| 4f 76 65 72 76 69 65 77 | 2c 20 4d 6b 69 64 2c 20 |Overview|, Mkid, |
|00000cc0| 54 6f 70 2c 20 54 6f 70 | 0a 58 40 63 68 61 70 74 |Top, Top|.X@chapt|
|00000cd0| 65 72 20 4f 76 65 72 76 | 69 65 77 0a 58 40 63 69 |er Overv|iew.X@ci|
|00000ce0| 6e 64 65 78 20 52 65 66 | 65 72 65 6e 63 65 20 74 |ndex Ref|erence t|
|00000cf0| 6f 20 46 69 72 73 74 20 | 43 68 61 70 74 65 72 0a |o First |Chapter.|
|00000d00| 58 41 6e 20 49 44 20 64 | 61 74 61 62 61 73 65 20 |XAn ID d|atabase |
|00000d10| 69 73 20 73 69 6d 70 6c | 79 20 61 20 66 69 6c 65 |is simpl|y a file|
|00000d20| 20 63 6f 6e 74 61 69 6e | 69 6e 67 20 61 20 6c 69 | contain|ing a li|
|00000d30| 73 74 20 6f 66 20 66 69 | 6c 65 20 6e 61 6d 65 73 |st of fi|le names|
|00000d40| 2c 20 61 20 6c 69 73 74 | 20 6f 66 0a 58 69 64 65 |, a list| of.Xide|
|00000d50| 6e 74 69 66 69 65 72 73 | 2c 20 61 6e 64 20 61 20 |ntifiers|, and a |
|00000d60| 62 69 6e 61 72 79 20 72 | 65 6c 61 74 69 6f 6e 20 |binary r|elation |
|00000d70| 28 73 74 6f 72 65 64 20 | 61 73 20 61 20 62 69 74 |(stored |as a bit|
|00000d80| 20 6d 61 74 72 69 78 29 | 20 69 6e 64 69 63 61 74 | matrix)| indicat|
|00000d90| 69 6e 67 20 77 68 69 63 | 68 0a 58 6f 66 20 74 68 |ing whic|h.Xof th|
|00000da0| 65 20 69 64 65 6e 74 69 | 66 69 65 72 73 20 61 70 |e identi|fiers ap|
|00000db0| 70 65 61 72 20 69 6e 20 | 65 61 63 68 20 66 69 6c |pear in |each fil|
|00000dc0| 65 2e 20 20 57 69 74 68 | 20 74 68 69 73 20 64 61 |e. With| this da|
|00000dd0| 74 61 62 61 73 65 20 61 | 6e 64 20 73 6f 6d 65 20 |tabase a|nd some |
|00000de0| 74 6f 6f 6c 73 0a 58 74 | 6f 20 6d 61 6e 69 70 75 |tools.Xt|o manipu|
|00000df0| 6c 61 74 65 20 74 68 65 | 20 64 61 74 61 2c 20 61 |late the| data, a|
|00000e00| 20 68 6f 73 74 20 6f 66 | 20 74 61 73 6b 73 20 62 | host of| tasks b|
|00000e10| 65 63 6f 6d 65 20 73 69 | 6d 70 6c 65 72 20 61 6e |ecome si|mpler an|
|00000e20| 64 20 66 61 73 74 65 72 | 2e 20 59 6f 75 20 63 61 |d faster|. You ca|
|00000e30| 6e 0a 58 40 63 6f 64 65 | 7b 67 72 65 70 7d 20 74 |n.X@code|{grep} t|
|00000e40| 68 72 6f 75 67 68 20 68 | 75 6e 64 72 65 64 73 20 |hrough h|undreds |
|00000e50| 6f 66 20 66 69 6c 65 73 | 20 66 6f 72 20 61 20 6e |of files| for a n|
|00000e60| 61 6d 65 2c 20 73 6b 69 | 70 70 69 6e 67 20 74 68 |ame, ski|pping th|
|00000e70| 65 20 66 69 6c 65 73 20 | 74 68 61 74 0a 58 64 6f |e files |that.Xdo|
|00000e80| 6e 27 74 20 63 6f 6e 74 | 61 69 6e 20 74 68 65 20 |n't cont|ain the |
|00000e90| 6e 61 6d 65 2e 20 20 59 | 6f 75 20 63 61 6e 20 73 |name. Y|ou can s|
|00000ea0| 65 61 72 63 68 20 66 6f | 72 20 61 6c 6c 20 74 68 |earch fo|r all th|
|00000eb0| 65 20 6d 65 6d 6f 73 20 | 63 6f 6e 74 61 69 6e 69 |e memos |containi|
|00000ec0| 6e 67 0a 58 72 65 66 65 | 72 65 6e 63 65 73 20 74 |ng.Xrefe|rences t|
|00000ed0| 6f 20 61 20 70 72 6f 6a | 65 63 74 2e 20 20 59 6f |o a proj|ect. Yo|
|00000ee0| 75 20 63 61 6e 20 65 64 | 69 74 20 65 76 65 72 79 |u can ed|it every|
|00000ef0| 20 66 69 6c 65 20 74 68 | 61 74 20 63 61 6c 6c 73 | file th|at calls|
|00000f00| 20 73 6f 6d 65 20 66 75 | 6e 63 74 69 6f 6e 2c 0a | some fu|nction,.|
|00000f10| 58 61 64 64 69 6e 67 20 | 61 20 6e 65 77 20 72 65 |Xadding |a new re|
|00000f20| 71 75 69 72 65 64 20 61 | 72 67 75 6d 65 6e 74 2e |quired a|rgument.|
|00000f30| 20 41 6e 79 6f 6e 65 20 | 77 69 74 68 20 61 20 6c | Anyone |with a l|
|00000f40| 61 72 67 65 20 73 6f 66 | 74 77 61 72 65 20 70 72 |arge sof|tware pr|
|00000f50| 6f 6a 65 63 74 20 74 6f | 0a 58 6d 61 69 6e 74 61 |oject to|.Xmainta|
|00000f60| 69 6e 2c 20 6f 72 20 61 | 20 6c 61 72 67 65 20 73 |in, or a| large s|
|00000f70| 65 74 20 6f 66 20 74 65 | 78 74 20 66 69 6c 65 73 |et of te|xt files|
|00000f80| 20 74 6f 20 6f 72 67 61 | 6e 69 7a 65 20 63 61 6e | to orga|nize can|
|00000f90| 20 62 65 6e 65 66 69 74 | 20 66 72 6f 6d 20 74 68 | benefit| from th|
|00000fa0| 65 20 49 44 0a 58 64 61 | 74 61 62 61 73 65 20 61 |e ID.Xda|tabase a|
|00000fb0| 6e 64 20 74 68 65 20 74 | 6f 6f 6c 73 20 74 68 61 |nd the t|ools tha|
|00000fc0| 74 20 6d 61 6e 69 70 75 | 6c 61 74 65 20 69 74 2e |t manipu|late it.|
|00000fd0| 0a 58 0a 58 54 68 65 72 | 65 20 61 72 65 20 73 65 |.X.XTher|e are se|
|00000fe0| 76 65 72 61 6c 20 70 72 | 6f 67 72 61 6d 73 20 69 |veral pr|ograms i|
|00000ff0| 6e 20 74 68 65 20 49 44 | 20 66 61 6d 69 6c 79 2e |n the ID| family.|
|00001000| 20 20 54 68 65 20 40 63 | 6f 64 65 7b 6d 6b 69 64 | The @c|ode{mkid|
|00001010| 7d 20 70 72 6f 67 72 61 | 6d 0a 58 73 63 61 6e 73 |} progra|m.Xscans|
|00001020| 20 74 68 65 20 66 69 6c | 65 73 2c 20 66 69 6e 64 | the fil|es, find|
|00001030| 73 20 74 68 65 20 69 64 | 65 6e 74 69 66 69 65 72 |s the id|entifier|
|00001040| 73 20 61 6e 64 20 62 75 | 69 6c 64 73 20 74 68 65 |s and bu|ilds the|
|00001050| 20 49 44 20 64 61 74 61 | 62 61 73 65 2e 20 20 54 | ID data|base. T|
|00001060| 68 65 0a 58 40 63 6f 64 | 65 7b 6c 69 64 7d 20 61 |he.X@cod|e{lid} a|
|00001070| 6e 64 20 40 63 6f 64 65 | 7b 61 69 64 7d 20 74 6f |nd @code|{aid} to|
|00001080| 6f 6c 73 20 61 72 65 20 | 75 73 65 64 20 74 6f 20 |ols are |used to |
|00001090| 67 65 6e 65 72 61 74 65 | 20 6c 69 73 74 73 20 6f |generate| lists o|
|000010a0| 66 20 66 69 6c 65 20 6e | 61 6d 65 73 0a 58 63 6f |f file n|ames.Xco|
|000010b0| 6e 74 61 69 6e 69 6e 67 | 20 61 6e 20 69 64 65 6e |ntaining| an iden|
|000010c0| 74 69 66 69 65 72 20 28 | 70 65 72 68 61 70 73 20 |tifier (|perhaps |
|000010d0| 74 6f 20 72 65 63 6f 6d | 70 69 6c 65 20 65 76 65 |to recom|pile eve|
|000010e0| 72 79 20 66 69 6c 65 20 | 74 68 61 74 0a 58 72 65 |ry file |that.Xre|
|000010f0| 66 65 72 65 6e 63 65 73 | 20 61 20 6d 61 63 72 6f |ferences| a macro|
|00001100| 20 77 68 69 63 68 20 6a | 75 73 74 20 63 68 61 6e | which j|ust chan|
|00001110| 67 65 64 29 2e 20 54 68 | 65 20 40 63 6f 64 65 7b |ged). Th|e @code{|
|00001120| 65 69 64 7d 20 70 72 6f | 67 72 61 6d 20 77 69 6c |eid} pro|gram wil|
|00001130| 6c 0a 58 69 6e 76 6f 6b | 65 20 61 6e 20 65 64 69 |l.Xinvok|e an edi|
|00001140| 74 6f 72 20 6f 6e 20 65 | 61 63 68 20 6f 66 20 74 |tor on e|ach of t|
|00001150| 68 65 20 66 69 6c 65 73 | 20 63 6f 6e 74 61 69 6e |he files| contain|
|00001160| 69 6e 67 20 61 6e 20 69 | 64 65 6e 74 69 66 69 65 |ing an i|dentifie|
|00001170| 72 20 61 6e 64 20 74 68 | 65 0a 58 40 63 6f 64 65 |r and th|e.X@code|
|00001180| 7b 67 69 64 7d 20 70 72 | 6f 67 72 61 6d 20 77 69 |{gid} pr|ogram wi|
|00001190| 6c 6c 20 40 63 6f 64 65 | 7b 67 72 65 70 7d 20 66 |ll @code|{grep} f|
|000011a0| 6f 72 20 61 6e 20 69 64 | 65 6e 74 69 66 69 65 72 |or an id|entifier|
|000011b0| 20 69 6e 20 74 68 65 20 | 73 75 62 73 65 74 20 6f | in the |subset o|
|000011c0| 66 0a 58 66 69 6c 65 73 | 20 6b 6e 6f 77 6e 20 74 |f.Xfiles| known t|
|000011d0| 6f 20 63 6f 6e 74 61 69 | 6e 20 69 74 2e 20 20 54 |o contai|n it. T|
|000011e0| 68 65 20 40 63 6f 64 65 | 7b 70 69 64 7d 20 74 6f |he @code|{pid} to|
|000011f0| 6f 6c 20 69 73 20 75 73 | 65 64 20 74 6f 20 71 75 |ol is us|ed to qu|
|00001200| 65 72 79 20 74 68 65 0a | 58 70 61 74 68 20 6e 61 |ery the.|Xpath na|
|00001210| 6d 65 73 20 6f 66 20 74 | 68 65 20 66 69 6c 65 73 |mes of t|he files|
|00001220| 20 69 6e 20 74 68 65 20 | 64 61 74 61 62 61 73 65 | in the |database|
|00001230| 20 28 72 61 74 68 65 72 | 20 74 68 61 6e 20 74 68 | (rather| than th|
|00001240| 65 20 63 6f 6e 74 65 6e | 74 73 29 2e 0a 58 46 69 |e conten|ts)..XFi|
|00001250| 6e 61 6c 6c 79 2c 20 74 | 68 65 20 40 63 6f 64 65 |nally, t|he @code|
|00001260| 7b 69 69 64 7d 20 74 6f | 6f 6c 20 69 73 20 61 6e |{iid} to|ol is an|
|00001270| 20 69 6e 74 65 72 61 63 | 74 69 76 65 20 70 72 6f | interac|tive pro|
|00001280| 67 72 61 6d 20 73 75 70 | 70 6f 72 74 69 6e 67 0a |gram sup|porting.|
|00001290| 58 63 6f 6d 70 6c 65 78 | 20 71 75 65 72 69 65 73 |Xcomplex| queries|
|000012a0| 20 74 6f 20 69 6e 74 65 | 72 73 65 63 74 20 61 6e | to inte|rsect an|
|000012b0| 64 20 6a 6f 69 6e 20 73 | 65 74 73 20 6f 66 20 66 |d join s|ets of f|
|000012c0| 69 6c 65 20 6e 61 6d 65 | 73 2e 0a 58 0a 58 40 6d |ile name|s..X.X@m|
|000012d0| 65 6e 75 0a 58 2a 20 48 | 69 73 74 6f 72 79 3a 3a |enu.X* H|istory::|
|000012e0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000012f0| 20 20 20 20 20 48 69 73 | 74 6f 72 79 0a 58 40 65 | His|tory.X@e|
|00001300| 6e 64 20 6d 65 6e 75 0a | 58 0a 58 40 6e 6f 64 65 |nd menu.|X.X@node|
|00001310| 20 48 69 73 74 6f 72 79 | 2c 20 20 2c 20 4f 76 65 | History|, , Ove|
|00001320| 72 76 69 65 77 2c 20 4f | 76 65 72 76 69 65 77 0a |rview, O|verview.|
|00001330| 58 40 73 65 63 74 69 6f | 6e 20 48 69 73 74 6f 72 |X@sectio|n Histor|
|00001340| 79 0a 58 4d 6f 73 74 20 | 6f 66 20 74 68 65 20 49 |y.XMost |of the I|
|00001350| 44 20 70 72 6f 67 72 61 | 6d 73 20 77 65 72 65 20 |D progra|ms were |
|00001360| 77 72 69 74 74 65 6e 20 | 62 79 20 47 72 65 67 20 |written |by Greg |
|00001370| 4d 63 47 61 72 79 20 61 | 6e 64 20 66 69 72 73 74 |McGary a|nd first|
|00001380| 20 70 6f 73 74 65 64 20 | 74 6f 0a 58 74 68 65 20 | posted |to.Xthe |
|00001390| 6e 65 74 20 69 6e 20 31 | 39 38 37 2e 20 53 69 6e |net in 1|987. Sin|
|000013a0| 63 65 20 74 68 65 6e 20 | 73 65 76 65 72 61 6c 20 |ce then |several |
|000013b0| 76 65 72 73 69 6f 6e 73 | 20 68 61 76 65 20 64 69 |versions| have di|
|000013c0| 76 65 72 67 65 64 20 66 | 72 6f 6d 20 74 68 65 0a |verged f|rom the.|
|000013d0| 58 6f 72 69 67 69 6e 61 | 6c 20 73 6f 75 72 63 65 |Xorigina|l source|
|000013e0| 2e 20 20 54 68 65 20 40 | 63 6f 64 65 7b 69 69 64 |. The @|code{iid|
|000013f0| 7d 20 70 72 6f 67 72 61 | 6d 20 77 61 73 20 77 72 |} progra|m was wr|
|00001400| 69 74 74 65 6e 20 62 79 | 20 54 6f 6d 20 48 6f 72 |itten by| Tom Hor|
|00001410| 73 6c 65 79 20 61 74 0a | 58 48 61 72 72 69 73 2e |sley at.|XHarris.|
|00001420| 20 54 68 69 73 20 76 65 | 72 73 69 6f 6e 20 28 74 | This ve|rsion (t|
|00001430| 68 65 20 6f 6e 65 20 79 | 6f 75 20 61 72 65 20 67 |he one y|ou are g|
|00001440| 65 74 74 69 6e 67 20 77 | 69 74 68 20 74 68 69 73 |etting w|ith this|
|00001450| 20 64 6f 63 75 6d 65 6e | 74 29 20 69 73 0a 58 62 | documen|t) is.Xb|
|00001460| 61 73 65 64 20 6f 6e 20 | 74 68 65 20 6c 61 74 65 |ased on |the late|
|00001470| 73 74 20 73 6f 75 72 63 | 65 20 69 6e 20 75 73 65 |st sourc|e in use|
|00001480| 20 61 74 20 48 61 72 72 | 69 73 20 43 6f 6d 70 75 | at Harr|is Compu|
|00001490| 74 65 72 20 53 79 73 74 | 65 6d 73 20 44 69 76 69 |ter Syst|ems Divi|
|000014a0| 73 69 6f 6e 2e 0a 58 49 | 74 20 63 6f 6e 74 61 69 |sion..XI|t contai|
|000014b0| 6e 73 20 61 20 66 65 77 | 20 70 61 74 63 68 65 73 |ns a few| patches|
|000014c0| 20 66 72 6f 6d 20 6f 74 | 68 65 72 20 73 6f 75 72 | from ot|her sour|
|000014d0| 63 65 73 2c 20 62 75 74 | 20 6e 6f 6e 65 20 6f 66 |ces, but| none of|
|000014e0| 20 74 68 65 20 6d 61 6a | 6f 72 0a 58 63 68 61 6e | the maj|or.Xchan|
|000014f0| 67 65 73 20 6d 61 64 65 | 20 61 74 20 6f 74 68 65 |ges made| at othe|
|00001500| 72 20 73 69 74 65 73 2e | 20 54 68 69 73 20 72 65 |r sites.| This re|
|00001510| 6c 65 61 73 65 20 69 73 | 20 74 68 65 20 66 69 72 |lease is| the fir|
|00001520| 73 74 20 61 74 74 65 6d | 70 74 20 74 6f 20 73 74 |st attem|pt to st|
|00001530| 61 72 74 0a 58 74 68 65 | 20 70 72 6f 63 65 73 73 |art.Xthe| process|
|00001540| 20 6f 66 20 6d 65 72 67 | 69 6e 67 20 74 68 65 20 | of merg|ing the |
|00001550| 73 65 70 61 72 61 74 65 | 20 76 65 72 73 69 6f 6e |separate| version|
|00001560| 73 2e 0a 58 0a 58 41 20 | 70 72 65 2d 72 65 6c 65 |s..X.XA |pre-rele|
|00001570| 61 73 65 20 76 65 72 73 | 69 6f 6e 20 6f 66 20 40 |ase vers|ion of @|
|00001580| 63 6f 64 65 7b 6d 6b 69 | 64 7d 20 77 61 73 20 70 |code{mki|d} was p|
|00001590| 6f 73 74 65 64 20 74 6f | 20 40 66 69 6c 65 7b 61 |osted to| @file{a|
|000015a0| 6c 74 2e 73 6f 75 72 63 | 65 73 7d 0a 58 6e 65 61 |lt.sourc|es}.Xnea|
|000015b0| 72 20 74 68 65 20 65 6e | 64 20 6f 66 20 31 39 39 |r the en|d of 199|
|000015c0| 30 2e 20 41 74 20 74 68 | 61 74 20 74 69 6d 65 20 |0. At th|at time |
|000015d0| 49 20 6d 65 6e 74 69 6f | 6e 65 64 20 74 68 61 74 |I mentio|ned that|
|000015e0| 20 49 20 77 61 73 20 74 | 68 69 6e 6b 69 6e 67 20 | I was t|hinking |
|000015f0| 61 62 6f 75 74 0a 58 77 | 72 69 74 69 6e 67 20 61 |about.Xw|riting a|
|00001600| 20 74 65 78 69 6e 66 6f | 20 6d 61 6e 75 61 6c 2e | texinfo| manual.|
|00001610| 20 49 20 67 6f 74 20 61 | 20 6c 6f 74 20 6f 66 20 | I got a| lot of |
|00001620| 65 6e 63 6f 75 72 61 67 | 65 6d 65 6e 74 20 66 72 |encourag|ement fr|
|00001630| 6f 6d 20 74 68 65 20 6e | 65 74 20 74 6f 0a 58 64 |om the n|et to.Xd|
|00001640| 6f 20 73 6f 2c 20 61 6e | 64 20 74 68 69 73 20 6d |o so, an|d this m|
|00001650| 61 6e 75 61 6c 20 69 73 | 20 74 68 65 20 72 65 73 |anual is| the res|
|00001660| 75 6c 74 2e 20 49 20 77 | 6f 75 6c 64 20 6c 69 6b |ult. I w|ould lik|
|00001670| 65 20 74 6f 20 74 68 61 | 6e 6b 20 44 6f 75 67 20 |e to tha|nk Doug |
|00001680| 53 63 6f 66 69 65 6c 64 | 0a 58 61 6e 64 20 42 69 |Scofield|.Xand Bi|
|00001690| 6c 6c 20 4c 65 6f 6e 61 | 72 64 20 77 68 6f 6d 20 |ll Leona|rd whom |
|000016a0| 49 20 64 72 61 67 6f 6f | 6e 65 64 20 69 6e 74 6f |I dragoo|ned into|
|000016b0| 20 68 65 6c 70 69 6e 67 | 20 6d 65 20 70 6f 6f 72 | helping| me poor|
|000016c0| 66 20 72 61 65 64 20 61 | 6e 64 0a 58 65 64 69 74 |f raed a|nd.Xedit|
|000016d0| 20 2d 2d 2d 20 74 68 65 | 79 20 66 6f 75 6e 64 20 | --- the|y found |
|000016e0| 73 65 76 65 72 61 6c 20 | 70 72 6f 62 6c 65 6d 73 |several |problems|
|000016f0| 20 69 6e 20 74 68 65 20 | 69 6e 69 74 69 61 6c 20 | in the |initial |
|00001700| 76 65 72 73 69 6f 6e 2e | 0a 58 0a 58 40 6e 6f 64 |version.|.X.X@nod|
|00001710| 65 20 4d 6b 69 64 2c 20 | 44 61 74 61 62 61 73 65 |e Mkid, |Database|
|00001720| 20 51 75 65 72 79 20 54 | 6f 6f 6c 73 2c 20 4f 76 | Query T|ools, Ov|
|00001730| 65 72 76 69 65 77 2c 20 | 54 6f 70 0a 58 40 63 68 |erview, |Top.X@ch|
|00001740| 61 70 74 65 72 20 4d 6b | 69 64 0a 58 54 68 65 20 |apter Mk|id.XThe |
|00001750| 40 63 6f 64 65 7b 6d 6b | 69 64 7d 20 70 72 6f 67 |@code{mk|id} prog|
|00001760| 72 61 6d 20 62 75 69 6c | 64 73 20 74 68 65 20 49 |ram buil|ds the I|
|00001770| 44 20 64 61 74 61 62 61 | 73 65 2e 20 54 6f 20 64 |D databa|se. To d|
|00001780| 6f 20 74 68 69 73 20 69 | 74 20 6d 75 73 74 20 73 |o this i|t must s|
|00001790| 63 61 6e 0a 58 65 61 63 | 68 20 6f 66 20 74 68 65 |can.Xeac|h of the|
|000017a0| 20 66 69 6c 65 73 20 69 | 6e 63 6c 75 64 65 64 20 | files i|ncluded |
|000017b0| 69 6e 20 74 68 65 20 64 | 61 74 61 62 61 73 65 2e |in the d|atabase.|
|000017c0| 20 54 68 69 73 20 6f 66 | 74 65 6e 20 74 61 6b 65 | This of|ten take|
|000017d0| 73 0a 58 71 75 69 74 65 | 20 61 20 77 68 69 6c 65 |s.Xquite| a while|
|000017e0| 2c 20 62 75 74 20 6f 6e | 63 65 20 74 68 65 20 77 |, but on|ce the w|
|000017f0| 6f 72 6b 20 69 73 20 64 | 6f 6e 65 20 74 68 65 20 |ork is d|one the |
|00001800| 71 75 65 72 79 20 70 72 | 6f 67 72 61 6d 73 20 72 |query pr|ograms r|
|00001810| 75 6e 20 76 65 72 79 0a | 58 72 61 70 69 64 6c 79 |un very.|Xrapidly|
|00001820| 2e 0a 58 0a 58 54 68 65 | 20 40 63 6f 64 65 7b 6d |..X.XThe| @code{m|
|00001830| 6b 69 64 7d 20 70 72 6f | 67 72 61 6d 20 6b 6e 6f |kid} pro|gram kno|
|00001840| 77 73 20 68 6f 77 20 74 | 6f 20 73 63 61 6e 20 61 |ws how t|o scan a|
|00001850| 20 76 61 72 69 65 74 79 | 20 6f 66 20 6f 66 20 66 | variety| of of f|
|00001860| 69 6c 65 73 2e 20 46 6f | 72 0a 58 65 78 61 6d 70 |iles. Fo|r.Xexamp|
|00001870| 6c 65 2c 20 69 74 20 6b | 6e 6f 77 73 20 68 6f 77 |le, it k|nows how|
|00001880| 20 74 6f 20 73 6b 69 70 | 20 6f 76 65 72 20 63 6f | to skip| over co|
|00001890| 6d 6d 65 6e 74 73 20 61 | 6e 64 20 73 74 72 69 6e |mments a|nd strin|
|000018a0| 67 73 20 69 6e 20 61 20 | 43 20 70 72 6f 67 72 61 |gs in a |C progra|
|000018b0| 6d 2c 0a 58 6f 6e 6c 79 | 20 70 69 63 6b 69 6e 67 |m,.Xonly| picking|
|000018c0| 20 6f 75 74 20 74 68 65 | 20 69 64 65 6e 74 69 66 | out the| identif|
|000018d0| 69 65 72 73 20 75 73 65 | 64 20 69 6e 20 74 68 65 |iers use|d in the|
|000018e0| 20 63 6f 64 65 2e 0a 58 | 0a 58 49 64 65 6e 74 69 | code..X|.XIdenti|
|000018f0| 66 69 65 72 73 20 61 72 | 65 20 6e 6f 74 20 74 68 |fiers ar|e not th|
|00001900| 65 20 6f 6e 6c 79 20 74 | 68 69 6e 67 20 69 6e 63 |e only t|hing inc|
|00001910| 6c 75 64 65 64 20 69 6e | 20 74 68 65 20 64 61 74 |luded in| the dat|
|00001920| 61 62 61 73 65 2e 0a 58 | 4e 75 6d 62 65 72 73 20 |abase..X|Numbers |
|00001930| 61 72 65 20 61 6c 73 6f | 20 73 63 61 6e 6e 65 64 |are also| scanned|
|00001940| 20 61 6e 64 20 69 6e 63 | 6c 75 64 65 64 20 69 6e | and inc|luded in|
|00001950| 20 74 68 65 20 64 61 74 | 61 62 61 73 65 20 69 6e | the dat|abase in|
|00001960| 64 65 78 65 64 20 62 79 | 0a 58 74 68 65 69 72 20 |dexed by|.Xtheir |
|00001970| 62 69 6e 61 72 79 20 76 | 61 6c 75 65 2e 20 53 69 |binary v|alue. Si|
|00001980| 6e 63 65 20 74 68 65 20 | 73 61 6d 65 20 6e 75 6d |nce the |same num|
|00001990| 62 65 72 20 63 61 6e 20 | 62 65 20 77 72 69 74 74 |ber can |be writt|
|000019a0| 65 6e 20 6d 61 6e 79 0a | 58 64 69 66 66 65 72 65 |en many.|Xdiffere|
|000019b0| 6e 74 20 77 61 79 73 20 | 28 34 37 2c 20 30 78 32 |nt ways |(47, 0x2|
|000019c0| 66 2c 20 30 35 37 20 69 | 6e 20 61 20 43 20 70 72 |f, 057 i|n a C pr|
|000019d0| 6f 67 72 61 6d 20 66 6f | 72 20 69 6e 73 74 61 6e |ogram fo|r instan|
|000019e0| 63 65 29 2c 20 74 68 69 | 73 0a 58 66 65 61 74 75 |ce), thi|s.Xfeatu|
|000019f0| 72 65 20 61 6c 6c 6f 77 | 73 20 79 6f 75 20 74 6f |re allow|s you to|
|00001a00| 20 66 69 6e 64 20 68 61 | 72 64 20 63 6f 64 65 64 | find ha|rd coded|
|00001a10| 20 75 73 65 73 20 6f 66 | 20 63 6f 6e 73 74 61 6e | uses of| constan|
|00001a20| 74 73 20 77 69 74 68 6f | 75 74 0a 58 72 65 67 61 |ts witho|ut.Xrega|
|00001a30| 72 64 20 74 6f 20 74 68 | 65 20 72 61 64 69 78 20 |rd to th|e radix |
|00001a40| 75 73 65 64 20 74 6f 20 | 73 70 65 63 69 66 79 20 |used to |specify |
|00001a50| 74 68 65 6d 2e 0a 58 0a | 58 41 6c 6c 20 74 68 65 |them..X.|XAll the|
|00001a60| 20 70 6c 61 63 65 73 20 | 69 6e 20 74 68 69 73 20 | places |in this |
|00001a70| 64 6f 63 75 6d 65 6e 74 | 20 77 68 65 72 65 20 69 |document| where i|
|00001a80| 64 65 6e 74 69 66 69 65 | 72 73 20 61 72 65 20 77 |dentifie|rs are w|
|00001a90| 72 69 74 74 65 6e 20 61 | 62 6f 75 74 0a 58 73 68 |ritten a|bout.Xsh|
|00001aa0| 6f 75 6c 64 20 72 65 61 | 6c 6c 79 20 6d 65 6e 74 |ould rea|lly ment|
|00001ab0| 69 6f 6e 20 69 64 65 6e | 74 69 66 69 65 72 73 20 |ion iden|tifiers |
|00001ac0| 61 6e 64 20 6e 75 6d 62 | 65 72 73 2c 20 62 75 74 |and numb|ers, but|
|00001ad0| 20 74 68 61 74 20 67 65 | 74 73 20 66 61 69 72 6c | that ge|ts fairl|
|00001ae0| 79 0a 58 63 6c 75 6d 73 | 79 20 61 66 74 65 72 20 |y.Xclums|y after |
|00001af0| 61 20 77 68 69 6c 65 2c | 20 73 6f 20 79 6f 75 20 |a while,| so you |
|00001b00| 73 68 6f 75 6c 64 20 61 | 6c 77 61 79 73 20 6b 65 |should a|lways ke|
|00001b10| 65 70 20 69 6e 20 6d 69 | 6e 64 20 74 68 61 74 20 |ep in mi|nd that |
|00001b20| 6e 75 6d 62 65 72 73 20 | 61 72 65 0a 58 69 6e 63 |numbers |are.Xinc|
|00001b30| 6c 75 64 65 64 20 69 6e | 20 74 68 65 20 64 61 74 |luded in| the dat|
|00001b40| 61 62 61 73 65 20 61 73 | 20 77 65 6c 6c 20 61 73 |abase as| well as|
|00001b50| 20 69 64 65 6e 74 69 66 | 69 65 72 73 2e 0a 58 0a | identif|iers..X.|
|00001b60| 58 40 6d 65 6e 75 0a 58 | 2a 20 4d 6b 69 64 20 43 |X@menu.X|* Mkid C|
|00001b70| 6f 6d 6d 61 6e 64 20 4c | 69 6e 65 20 4f 70 74 69 |ommand L|ine Opti|
|00001b80| 6f 6e 73 3a 3a 20 20 20 | 4d 6b 69 64 20 43 6f 6d |ons:: |Mkid Com|
|00001b90| 6d 61 6e 64 20 4c 69 6e | 65 20 4f 70 74 69 6f 6e |mand Lin|e Option|
|00001ba0| 73 0a 58 2a 20 42 75 69 | 6c 74 69 6e 20 53 63 61 |s.X* Bui|ltin Sca|
|00001bb0| 6e 6e 65 72 73 3a 3a 20 | 20 20 20 20 20 20 20 20 |nners:: | |
|00001bc0| 20 20 20 42 75 69 6c 74 | 69 6e 20 53 63 61 6e 6e | Built|in Scann|
|00001bd0| 65 72 73 0a 58 2a 20 41 | 64 64 69 6e 67 20 59 6f |ers.X* A|dding Yo|
|00001be0| 75 72 20 4f 77 6e 20 53 | 63 61 6e 6e 65 72 3a 3a |ur Own S|canner::|
|00001bf0| 20 20 20 20 20 41 64 64 | 69 6e 67 20 59 6f 75 72 | Add|ing Your|
|00001c00| 20 4f 77 6e 20 53 63 61 | 6e 6e 65 72 0a 58 2a 20 | Own Sca|nner.X* |
|00001c10| 4d 6b 69 64 20 45 78 61 | 6d 70 6c 65 73 3a 3a 20 |Mkid Exa|mples:: |
|00001c20| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 4d 6b | | Mk|
|00001c30| 69 64 20 45 78 61 6d 70 | 6c 65 73 0a 58 40 65 6e |id Examp|les.X@en|
|00001c40| 64 20 6d 65 6e 75 0a 58 | 0a 58 40 6e 6f 64 65 20 |d menu.X|.X@node |
|00001c50| 4d 6b 69 64 20 43 6f 6d | 6d 61 6e 64 20 4c 69 6e |Mkid Com|mand Lin|
|00001c60| 65 20 4f 70 74 69 6f 6e | 73 2c 20 42 75 69 6c 74 |e Option|s, Built|
|00001c70| 69 6e 20 53 63 61 6e 6e | 65 72 73 2c 20 4d 6b 69 |in Scann|ers, Mki|
|00001c80| 64 2c 20 4d 6b 69 64 0a | 58 40 73 65 63 74 69 6f |d, Mkid.|X@sectio|
|00001c90| 6e 20 4d 6b 69 64 20 43 | 6f 6d 6d 61 6e 64 20 4c |n Mkid C|ommand L|
|00001ca0| 69 6e 65 20 4f 70 74 69 | 6f 6e 73 0a 58 40 64 65 |ine Opti|ons.X@de|
|00001cb0| 66 66 6e 20 43 6f 6d 6d | 61 6e 64 20 6d 6b 69 64 |ffn Comm|and mkid|
|00001cc0| 20 5b 40 63 6f 64 65 7b | 2d 76 7d 5d 20 5b 40 63 | [@code{|-v}] [@c|
|00001cd0| 6f 64 65 7b 2d 53 40 76 | 61 72 7b 73 63 61 6e 61 |ode{-S@v|ar{scana|
|00001ce0| 72 67 7d 7d 5d 20 5b 40 | 63 6f 64 65 7b 2d 61 40 |rg}}] [@|code{-a@|
|00001cf0| 76 61 72 7b 61 72 67 2d | 66 69 6c 65 7d 7d 5d 20 |var{arg-|file}}] |
|00001d00| 5b 40 63 6f 64 65 7b 2d | 7d 5d 20 5b 40 63 6f 64 |[@code{-|}] [@cod|
|00001d10| 65 7b 2d 66 40 76 61 72 | 7b 6f 75 74 2d 66 69 6c |e{-f@var|{out-fil|
|00001d20| 65 7d 7d 5d 20 5b 40 63 | 6f 64 65 7b 2d 73 40 76 |e}}] [@c|ode{-s@v|
|00001d30| 61 72 7b 64 69 72 65 63 | 74 6f 72 79 7d 7d 5d 20 |ar{direc|tory}}] |
|00001d40| 5b 40 63 6f 64 65 7b 2d | 72 40 76 61 72 7b 64 69 |[@code{-|r@var{di|
|00001d50| 72 65 63 74 6f 72 79 7d | 7d 5d 20 5b 40 63 6f 64 |rectory}|}] [@cod|
|00001d60| 65 7b 2d 75 7d 5d 20 5b | 40 63 6f 64 65 7b 66 69 |e{-u}] [|@code{fi|
|00001d70| 6c 65 73 7d 40 64 6f 74 | 73 7b 7d 5d 0a 58 40 74 |les}@dot|s{}].X@t|
|00001d80| 61 62 6c 65 20 40 63 6f | 64 65 0a 58 40 69 74 65 |able @co|de.X@ite|
|00001d90| 6d 20 2d 76 0a 58 56 65 | 72 62 6f 73 65 2e 20 4d |m -v.XVe|rbose. M|
|00001da0| 6b 69 64 20 74 65 6c 6c | 73 20 79 6f 75 20 61 73 |kid tell|s you as|
|00001db0| 20 69 74 20 73 63 61 6e | 73 20 65 61 63 68 20 66 | it scan|s each f|
|00001dc0| 69 6c 65 20 61 6e 64 20 | 69 6e 64 69 63 61 74 65 |ile and |indicate|
|00001dd0| 73 20 77 68 69 63 68 20 | 73 63 61 6e 6e 65 72 0a |s which |scanner.|
|00001de0| 58 69 74 20 69 73 20 75 | 73 69 6e 67 2e 20 49 74 |Xit is u|sing. It|
|00001df0| 20 61 6c 73 6f 20 73 75 | 6d 6d 61 72 69 7a 65 73 | also su|mmarizes|
|00001e00| 20 73 6f 6d 65 20 73 74 | 61 74 69 73 74 69 63 73 | some st|atistics|
|00001e10| 20 61 62 6f 75 74 20 74 | 68 65 20 64 61 74 61 62 | about t|he datab|
|00001e20| 61 73 65 20 61 74 0a 58 | 74 68 65 20 65 6e 64 2e |ase at.X|the end.|
|00001e30| 0a 58 40 69 74 65 6d 20 | 2d 53 40 76 61 72 7b 73 |.X@item |-S@var{s|
|00001e40| 63 61 6e 61 72 67 7d 0a | 58 54 68 65 20 40 63 6f |canarg}.|XThe @co|
|00001e50| 64 65 7b 2d 53 7d 20 6f | 70 74 69 6f 6e 20 69 73 |de{-S} o|ption is|
|00001e60| 20 75 73 65 64 20 74 6f | 20 73 70 65 63 69 66 79 | used to| specify|
|00001e70| 20 61 72 67 75 6d 65 6e | 74 73 20 74 6f 20 74 68 | argumen|ts to th|
|00001e80| 65 20 76 61 72 69 6f 75 | 73 20 6c 61 6e 67 75 61 |e variou|s langua|
|00001e90| 67 65 0a 58 73 63 61 6e | 6e 65 72 73 2e 20 40 78 |ge.Xscan|ners. @x|
|00001ea0| 72 65 66 7b 53 63 61 6e | 6e 65 72 20 41 72 67 75 |ref{Scan|ner Argu|
|00001eb0| 6d 65 6e 74 73 7d 2c 20 | 66 6f 72 20 64 65 74 61 |ments}, |for deta|
|00001ec0| 69 6c 73 2e 0a 58 40 69 | 74 65 6d 20 2d 61 40 76 |ils..X@i|tem -a@v|
|00001ed0| 61 72 7b 61 72 67 2d 66 | 69 6c 65 7d 0a 58 4e 61 |ar{arg-f|ile}.XNa|
|00001ee0| 6d 65 20 61 20 66 69 6c | 65 20 63 6f 6e 74 61 69 |me a fil|e contai|
|00001ef0| 6e 69 6e 67 20 61 64 64 | 69 74 69 6f 6e 61 6c 20 |ning add|itional |
|00001f00| 63 6f 6d 6d 61 6e 64 20 | 6c 69 6e 65 20 61 72 67 |command |line arg|
|00001f10| 75 6d 65 6e 74 73 20 28 | 6f 6e 65 20 70 65 72 20 |uments (|one per |
|00001f20| 6c 69 6e 65 29 2e 20 54 | 68 69 73 0a 58 6d 61 79 |line). T|his.Xmay|
|00001f30| 20 62 65 20 75 73 65 64 | 20 74 6f 20 73 70 65 63 | be used| to spec|
|00001f40| 69 66 79 20 6c 69 73 74 | 73 20 6f 66 20 66 69 6c |ify list|s of fil|
|00001f50| 65 20 6e 61 6d 65 73 20 | 6c 6f 6e 67 65 72 20 74 |e names |longer t|
|00001f60| 68 61 6e 20 77 69 6c 6c | 20 66 69 74 20 6f 6e 20 |han will| fit on |
|00001f70| 61 20 63 6f 6d 6d 61 6e | 64 0a 58 6c 69 6e 65 2e |a comman|d.Xline.|
|00001f80| 0a 58 40 69 74 65 6d 20 | 2d 0a 58 41 20 73 69 6d |.X@item |-.XA sim|
|00001f90| 70 6c 65 20 40 63 6f 64 | 65 7b 2d 7d 20 62 79 20 |ple @cod|e{-} by |
|00001fa0| 69 74 73 65 6c 66 20 6d | 65 61 6e 73 20 72 65 61 |itself m|eans rea|
|00001fb0| 64 20 61 72 67 75 6d 65 | 6e 74 73 20 66 72 6f 6d |d argume|nts from|
|00001fc0| 20 73 74 64 69 6e 2e 0a | 58 40 69 74 65 6d 20 2d | stdin..|X@item -|
|00001fd0| 66 40 76 61 72 7b 6f 75 | 74 2d 66 69 6c 65 7d 0a |f@var{ou|t-file}.|
|00001fe0| 58 53 70 65 63 69 66 79 | 20 74 68 65 20 6e 61 6d |XSpecify| the nam|
|00001ff0| 65 20 6f 66 20 74 68 65 | 20 64 61 74 61 62 61 73 |e of the| databas|
|00002000| 65 20 66 69 6c 65 20 74 | 6f 20 63 72 65 61 74 65 |e file t|o create|
|00002010| 2e 20 54 68 65 20 64 65 | 66 61 75 6c 74 20 6e 61 |. The de|fault na|
|00002020| 6d 65 20 69 73 20 40 63 | 6f 64 65 7b 49 44 7d 0a |me is @c|ode{ID}.|
|00002030| 58 28 69 6e 20 74 68 65 | 20 63 75 72 72 65 6e 74 |X(in the| current|
|00002040| 20 64 69 72 65 63 74 6f | 72 79 29 2c 20 62 75 74 | directo|ry), but|
|00002050| 20 79 6f 75 20 6d 61 79 | 20 73 70 65 63 69 66 79 | you may| specify|
|00002060| 20 61 6e 79 20 6e 61 6d | 65 2e 20 54 68 65 20 66 | any nam|e. The f|
|00002070| 69 6c 65 20 6e 61 6d 65 | 73 0a 58 73 74 6f 72 65 |ile name|s.Xstore|
|00002080| 64 20 69 6e 20 74 68 65 | 20 64 61 74 61 62 61 73 |d in the| databas|
|00002090| 65 20 77 69 6c 6c 20 62 | 65 20 73 74 6f 72 65 64 |e will b|e stored|
|000020a0| 20 72 65 6c 61 74 69 76 | 65 20 74 6f 20 74 68 65 | relativ|e to the|
|000020b0| 20 64 69 72 65 63 74 6f | 72 79 20 63 6f 6e 74 61 | directo|ry conta|
|000020c0| 69 6e 69 6e 67 0a 58 74 | 68 65 20 64 61 74 61 62 |ining.Xt|he datab|
|000020d0| 61 73 65 2c 20 73 6f 20 | 69 66 20 79 6f 75 20 6d |ase, so |if you m|
|000020e0| 6f 76 65 20 74 68 65 20 | 64 61 74 61 62 61 73 65 |ove the |database|
|000020f0| 20 61 66 74 65 72 20 63 | 72 65 61 74 69 6e 67 20 | after c|reating |
|00002100| 69 74 2c 20 79 6f 75 20 | 6d 61 79 20 68 61 76 65 |it, you |may have|
|00002110| 0a 58 74 72 6f 75 62 6c | 65 20 66 69 6e 64 69 6e |.Xtroubl|e findin|
|00002120| 67 20 66 69 6c 65 73 20 | 75 6e 6c 65 73 73 20 74 |g files |unless t|
|00002130| 68 65 79 20 72 65 6d 61 | 69 6e 20 69 6e 20 74 68 |hey rema|in in th|
|00002140| 65 20 73 61 6d 65 20 72 | 65 6c 61 74 69 76 65 20 |e same r|elative |
|00002150| 70 6f 73 69 74 69 6f 6e | 2e 0a 58 40 69 74 65 6d |position|..X@item|
|00002160| 20 2d 73 40 76 61 72 7b | 64 69 72 65 63 74 6f 72 | -s@var{|director|
|00002170| 79 7d 0a 58 53 70 65 63 | 69 66 79 20 61 20 64 69 |y}.XSpec|ify a di|
|00002180| 72 65 63 74 6f 72 79 20 | 74 6f 20 73 65 61 72 63 |rectory |to searc|
|00002190| 68 20 66 6f 72 20 53 43 | 43 53 20 66 69 6c 65 73 |h for SC|CS files|
|000021a0| 20 69 6e 20 63 61 73 65 | 20 61 20 66 69 6c 65 20 | in case| a file |
|000021b0| 6e 61 6d 65 64 20 6f 6e | 20 74 68 65 0a 58 63 6f |named on| the.Xco|
|000021c0| 6d 6d 61 6e 64 20 6c 69 | 6e 65 20 64 6f 65 73 20 |mmand li|ne does |
|000021d0| 6e 6f 74 20 65 78 69 73 | 74 2e 0a 58 40 69 74 65 |not exis|t..X@ite|
|000021e0| 6d 20 2d 72 40 76 61 72 | 7b 64 69 72 65 63 74 6f |m -r@var|{directo|
|000021f0| 72 79 7d 0a 58 53 70 65 | 63 69 66 79 20 61 20 64 |ry}.XSpe|cify a d|
|00002200| 69 72 65 63 74 6f 72 79 | 20 74 6f 20 73 65 61 72 |irectory| to sear|
|00002210| 63 68 20 66 6f 72 20 52 | 43 53 20 66 69 6c 65 73 |ch for R|CS files|
|00002220| 20 69 6e 20 63 61 73 65 | 20 61 20 66 69 6c 65 20 | in case| a file |
|00002230| 6e 61 6d 65 64 20 6f 6e | 20 74 68 65 0a 58 63 6f |named on| the.Xco|
|00002240| 6d 6d 61 6e 64 20 6c 69 | 6e 65 20 64 6f 65 73 20 |mmand li|ne does |
|00002250| 6e 6f 74 20 65 78 69 73 | 74 2e 0a 58 40 69 74 65 |not exis|t..X@ite|
|00002260| 6d 20 2d 75 0a 58 54 68 | 65 20 40 63 6f 64 65 7b |m -u.XTh|e @code{|
|00002270| 2d 75 7d 20 6f 70 74 69 | 6f 6e 20 75 70 64 61 74 |-u} opti|on updat|
|00002280| 65 73 20 61 6e 20 65 78 | 69 73 74 69 6e 67 20 64 |es an ex|isting d|
|00002290| 61 74 61 62 61 73 65 20 | 62 79 20 72 65 73 63 61 |atabase |by resca|
|000022a0| 6e 6e 69 6e 67 20 61 6e | 79 20 66 69 6c 65 73 0a |nning an|y files.|
|000022b0| 58 74 68 61 74 20 68 61 | 76 65 20 63 68 61 6e 67 |Xthat ha|ve chang|
|000022c0| 65 64 20 73 69 6e 63 65 | 20 74 68 65 20 64 61 74 |ed since| the dat|
|000022d0| 61 62 61 73 65 20 77 61 | 73 20 77 72 69 74 74 65 |abase wa|s writte|
|000022e0| 6e 2e 20 55 6e 66 6f 72 | 74 75 6e 61 74 65 6c 79 |n. Unfor|tunately|
|000022f0| 20 79 6f 75 20 63 61 6e | 6e 6f 74 0a 58 69 6e 63 | you can|not.Xinc|
|00002300| 72 65 6d 65 6e 74 61 6c | 6c 79 20 61 64 64 20 6e |remental|ly add n|
|00002310| 65 77 20 66 69 6c 65 73 | 20 74 6f 20 61 20 64 61 |ew files| to a da|
|00002320| 74 61 62 61 73 65 2e 0a | 58 40 69 74 65 6d 20 66 |tabase..|X@item f|
|00002330| 69 6c 65 73 0a 58 52 65 | 6d 61 69 6e 69 6e 67 20 |iles.XRe|maining |
|00002340| 61 72 67 75 6d 65 6e 74 | 73 20 61 72 65 20 6e 61 |argument|s are na|
|00002350| 6d 65 73 20 6f 66 20 66 | 69 6c 65 73 20 74 6f 20 |mes of f|iles to |
|00002360| 62 65 20 73 63 61 6e 6e | 65 64 20 61 6e 64 20 69 |be scann|ed and i|
|00002370| 6e 63 6c 75 64 65 64 20 | 69 6e 20 74 68 65 0a 58 |ncluded |in the.X|
|00002380| 64 61 74 61 62 61 73 65 | 2e 0a 58 40 65 6e 64 20 |database|..X@end |
|00002390| 74 61 62 6c 65 0a 58 40 | 65 6e 64 20 64 65 66 66 |table.X@|end deff|
|000023a0| 6e 0a 58 0a 58 40 6d 65 | 6e 75 0a 58 2a 20 53 63 |n.X.X@me|nu.X* Sc|
|000023b0| 61 6e 6e 65 72 20 41 72 | 67 75 6d 65 6e 74 73 3a |anner Ar|guments:|
|000023c0| 3a 20 20 20 20 20 20 20 | 20 20 20 20 53 63 61 6e |: | Scan|
|000023d0| 6e 65 72 20 41 72 67 75 | 6d 65 6e 74 73 0a 58 40 |ner Argu|ments.X@|
|000023e0| 65 6e 64 20 6d 65 6e 75 | 0a 58 0a 58 40 6e 6f 64 |end menu|.X.X@nod|
|000023f0| 65 20 53 63 61 6e 6e 65 | 72 20 41 72 67 75 6d 65 |e Scanne|r Argume|
|00002400| 6e 74 73 2c 20 20 2c 20 | 4d 6b 69 64 20 43 6f 6d |nts, , |Mkid Com|
|00002410| 6d 61 6e 64 20 4c 69 6e | 65 20 4f 70 74 69 6f 6e |mand Lin|e Option|
|00002420| 73 2c 20 4d 6b 69 64 20 | 43 6f 6d 6d 61 6e 64 20 |s, Mkid |Command |
|00002430| 4c 69 6e 65 20 4f 70 74 | 69 6f 6e 73 0a 58 40 73 |Line Opt|ions.X@s|
|00002440| 75 62 73 65 63 74 69 6f | 6e 20 53 63 61 6e 6e 65 |ubsectio|n Scanne|
|00002450| 72 20 41 72 67 75 6d 65 | 6e 74 73 0a 58 53 63 61 |r Argume|nts.XSca|
|00002460| 6e 6e 65 72 20 61 72 67 | 75 6d 65 6e 74 73 20 61 |nner arg|uments a|
|00002470| 6c 6c 20 73 74 61 72 74 | 20 77 69 74 68 20 40 63 |ll start| with @c|
|00002480| 6f 64 65 7b 2d 53 7d 2e | 20 53 63 61 6e 6e 65 72 |ode{-S}.| Scanner|
|00002490| 20 61 72 67 75 6d 65 6e | 74 73 20 61 72 65 20 75 | argumen|ts are u|
|000024a0| 73 65 64 20 74 6f 20 74 | 65 6c 6c 0a 58 40 63 6f |sed to t|ell.X@co|
|000024b0| 64 65 7b 6d 6b 69 64 7d | 20 77 68 69 63 68 20 6c |de{mkid}| which l|
|000024c0| 61 6e 67 75 61 67 65 20 | 73 63 61 6e 6e 65 72 20 |anguage |scanner |
|000024d0| 74 6f 20 75 73 65 20 66 | 6f 72 20 77 68 69 63 68 |to use f|or which|
|000024e0| 20 66 69 6c 65 73 2c 20 | 74 6f 20 70 61 73 73 20 | files, |to pass |
|000024f0| 6c 61 6e 67 75 61 67 65 | 0a 58 73 70 65 63 69 66 |language|.Xspecif|
|00002500| 69 63 20 6f 70 74 69 6f | 6e 73 20 74 6f 20 74 68 |ic optio|ns to th|
|00002510| 65 20 69 6e 64 69 76 69 | 64 75 61 6c 20 73 63 61 |e indivi|dual sca|
|00002520| 6e 6e 65 72 73 2c 20 61 | 6e 64 20 74 6f 20 67 65 |nners, a|nd to ge|
|00002530| 74 20 73 6f 6d 65 20 6c | 69 6d 69 74 65 64 0a 58 |t some l|imited.X|
|00002540| 6f 6e 6c 69 6e 65 20 68 | 65 6c 70 20 61 62 6f 75 |online h|elp abou|
|00002550| 74 20 73 63 61 6e 6e 65 | 72 20 6f 70 74 69 6f 6e |t scanne|r option|
|00002560| 73 2e 0a 58 0a 58 40 63 | 6f 64 65 7b 4d 6b 69 64 |s..X.X@c|ode{Mkid|
|00002570| 7d 20 75 73 75 61 6c 6c | 79 20 64 65 74 65 72 6d |} usuall|y determ|
|00002580| 69 6e 65 73 20 77 68 69 | 63 68 20 6c 61 6e 67 75 |ines whi|ch langu|
|00002590| 61 67 65 20 73 63 61 6e | 6e 65 72 20 74 6f 20 75 |age scan|ner to u|
|000025a0| 73 65 20 6f 6e 20 61 20 | 66 69 6c 65 0a 58 62 79 |se on a |file.Xby|
|000025b0| 20 6c 6f 6f 6b 69 6e 67 | 20 61 74 20 74 68 65 20 | looking| at the |
|000025c0| 73 75 66 66 69 78 20 6f | 66 20 74 68 65 20 66 69 |suffix o|f the fi|
|000025d0| 6c 65 20 6e 61 6d 65 2e | 20 54 68 65 20 73 75 66 |le name.| The suf|
|000025e0| 66 69 78 20 73 74 61 72 | 74 73 20 61 74 20 74 68 |fix star|ts at th|
|000025f0| 65 20 6c 61 73 74 0a 58 | 40 73 61 6d 70 7b 2e 7d |e last.X|@samp{.}|
|00002600| 20 69 6e 20 61 20 66 69 | 6c 65 20 6e 61 6d 65 20 | in a fi|le name |
|00002610| 61 6e 64 20 69 6e 63 6c | 75 64 65 73 20 74 68 65 |and incl|udes the|
|00002620| 20 40 73 61 6d 70 7b 2e | 7d 20 61 6e 64 20 61 6c | @samp{.|} and al|
|00002630| 6c 20 72 65 6d 61 69 6e | 69 6e 67 0a 58 63 68 61 |l remain|ing.Xcha|
|00002640| 72 61 63 74 65 72 73 20 | 28 66 6f 72 20 65 78 61 |racters |(for exa|
|00002650| 6d 70 6c 65 20 74 68 65 | 20 73 75 66 66 69 78 20 |mple the| suffix |
|00002660| 6f 66 20 40 66 69 6c 65 | 7b 66 72 65 64 2e 63 7d |of @file|{fred.c}|
|00002670| 20 69 73 20 40 66 69 6c | 65 7b 2e 63 7d 29 2e 20 | is @fil|e{.c}). |
|00002680| 4e 6f 74 0a 58 61 6c 6c | 20 66 69 6c 65 73 20 68 |Not.Xall| files h|
|00002690| 61 76 65 20 61 20 73 75 | 66 66 69 78 2c 20 61 6e |ave a su|ffix, an|
|000026a0| 64 20 6e 6f 74 20 61 6c | 6c 20 73 75 66 66 69 78 |d not al|l suffix|
|000026b0| 65 73 20 61 72 65 20 62 | 6f 75 6e 64 20 74 6f 20 |es are b|ound to |
|000026c0| 61 20 73 70 65 63 69 66 | 69 63 0a 58 6c 61 6e 67 |a specif|ic.Xlang|
|000026d0| 75 61 67 65 20 62 79 20 | 6d 6b 69 64 2e 20 49 66 |uage by |mkid. If|
|000026e0| 20 40 63 6f 64 65 7b 6d | 6b 69 64 7d 20 63 61 6e | @code{m|kid} can|
|000026f0| 6e 6f 74 20 64 65 74 65 | 72 6d 69 6e 65 20 77 68 |not dete|rmine wh|
|00002700| 61 74 20 6c 61 6e 67 75 | 61 67 65 20 61 20 66 69 |at langu|age a fi|
|00002710| 6c 65 0a 58 69 73 2c 20 | 69 74 20 77 69 6c 6c 20 |le.Xis, |it will |
|00002720| 75 73 65 20 74 68 65 20 | 6c 61 6e 67 75 61 67 65 |use the |language|
|00002730| 20 62 6f 75 6e 64 20 74 | 6f 20 74 68 65 20 40 66 | bound t|o the @f|
|00002740| 69 6c 65 7b 2e 64 65 66 | 61 75 6c 74 7d 20 73 75 |ile{.def|ault} su|
|00002750| 66 66 69 78 2e 20 54 68 | 65 0a 58 70 6c 61 69 6e |ffix. Th|e.Xplain|
|00002760| 20 74 65 78 74 20 73 63 | 61 6e 6e 65 72 20 69 73 | text sc|anner is|
|00002770| 20 6e 6f 72 6d 61 6c 6c | 79 20 62 6f 75 6e 64 20 | normall|y bound |
|00002780| 74 6f 20 40 66 69 6c 65 | 7b 2e 64 65 66 61 75 6c |to @file|{.defaul|
|00002790| 74 7d 2c 20 62 75 74 20 | 74 68 65 0a 58 40 63 6f |t}, but |the.X@co|
|000027a0| 64 65 7b 2d 53 7d 20 6f | 70 74 69 6f 6e 20 63 61 |de{-S} o|ption ca|
|000027b0| 6e 20 62 65 20 75 73 65 | 64 20 74 6f 20 63 68 61 |n be use|d to cha|
|000027c0| 6e 67 65 20 61 6e 79 20 | 6c 61 6e 67 75 61 67 65 |nge any |language|
|000027d0| 20 62 69 6e 64 69 6e 67 | 73 2e 0a 58 0a 58 54 68 | binding|s..X.XTh|
|000027e0| 65 72 65 20 61 72 65 20 | 73 65 76 65 72 61 6c 20 |ere are |several |
|000027f0| 64 69 66 66 65 72 65 6e | 74 20 66 6f 72 6d 73 20 |differen|t forms |
|00002800| 66 6f 72 20 73 63 61 6e | 6e 65 72 20 6f 70 74 69 |for scan|ner opti|
|00002810| 6f 6e 73 3a 0a 58 40 74 | 61 62 6c 65 20 40 63 6f |ons:.X@t|able @co|
|00002820| 64 65 0a 58 40 69 74 65 | 6d 20 2d 53 2e 40 76 61 |de.X@ite|m -S.@va|
|00002830| 72 7b 3c 73 75 66 66 69 | 78 3e 7d 3d 40 76 61 72 |r{<suffi|x>}=@var|
|00002840| 7b 3c 6c 61 6e 67 75 61 | 67 65 3e 7d 0a 58 40 63 |{<langua|ge>}.X@c|
|00002850| 6f 64 65 7b 4d 6b 69 64 | 7d 20 64 65 74 65 72 6d |ode{Mkid|} determ|
|00002860| 69 6e 65 73 20 77 68 69 | 63 68 20 6c 61 6e 67 75 |ines whi|ch langu|
|00002870| 61 67 65 20 73 63 61 6e | 6e 65 72 20 74 6f 20 75 |age scan|ner to u|
|00002880| 73 65 20 6f 6e 20 61 20 | 66 69 6c 65 20 62 79 20 |se on a |file by |
|00002890| 65 78 61 6d 69 6e 69 6e | 67 20 74 68 65 0a 58 66 |examinin|g the.Xf|
|000028a0| 69 6c 65 20 6e 61 6d 65 | 20 73 75 66 66 69 78 2e |ile name| suffix.|
|000028b0| 20 54 68 65 20 40 73 61 | 6d 70 7b 2e 7d 20 69 73 | The @sa|mp{.} is|
|000028c0| 20 70 61 72 74 20 6f 66 | 20 74 68 65 20 73 75 66 | part of| the suf|
|000028d0| 66 69 78 20 61 6e 64 20 | 6d 75 73 74 20 62 65 20 |fix and |must be |
|000028e0| 73 70 65 63 69 66 69 65 | 64 0a 58 69 6e 20 74 68 |specifie|d.Xin th|
|000028f0| 69 73 20 66 6f 72 6d 20 | 6f 66 20 74 68 65 20 40 |is form |of the @|
|00002900| 63 6f 64 65 7b 2d 53 7d | 20 6f 70 74 69 6f 6e 2e |code{-S}| option.|
|00002910| 20 46 6f 72 20 65 78 61 | 6d 70 6c 65 20 40 73 61 | For exa|mple @sa|
|00002920| 6d 70 7b 2d 53 2e 79 3d | 63 7d 20 74 65 6c 6c 73 |mp{-S.y=|c} tells|
|00002930| 0a 58 40 63 6f 64 65 7b | 6d 6b 69 64 7d 20 74 6f |.X@code{|mkid} to|
|00002940| 20 75 73 65 20 74 68 65 | 20 40 73 61 6d 70 7b 63 | use the| @samp{c|
|00002950| 7d 20 6c 61 6e 67 75 61 | 67 65 20 73 63 61 6e 6e |} langua|ge scann|
|00002960| 65 72 20 66 6f 72 20 61 | 6c 6c 20 66 69 6c 65 73 |er for a|ll files|
|00002970| 20 65 6e 64 69 6e 67 20 | 69 6e 0a 58 74 68 65 20 | ending |in.Xthe |
|00002980| 40 73 61 6d 70 7b 2e 79 | 7d 20 73 75 66 66 69 78 |@samp{.y|} suffix|
|00002990| 2e 0a 58 40 69 74 65 6d | 20 2d 53 2e 40 76 61 72 |..X@item| -S.@var|
|000029a0| 7b 3c 73 75 66 66 69 78 | 3e 7d 3d 3f 0a 58 40 63 |{<suffix|>}=?.X@c|
|000029b0| 6f 64 65 7b 4d 6b 69 64 | 7d 20 68 61 73 20 73 65 |ode{Mkid|} has se|
|000029c0| 76 65 72 61 6c 20 62 75 | 69 6c 74 20 69 6e 20 73 |veral bu|ilt in s|
|000029d0| 75 66 66 69 78 65 73 20 | 69 74 20 61 6c 72 65 61 |uffixes |it alrea|
|000029e0| 64 79 20 72 65 63 6f 67 | 6e 69 7a 65 73 2e 20 50 |dy recog|nizes. P|
|000029f0| 61 73 73 69 6e 67 0a 58 | 61 20 40 73 61 6d 70 7b |assing.X|a @samp{|
|00002a00| 3f 7d 20 77 69 6c 6c 20 | 63 61 75 73 65 20 69 74 |?} will |cause it|
|00002a10| 20 74 6f 20 70 72 69 6e | 74 20 74 68 65 20 6c 61 | to prin|t the la|
|00002a20| 6e 67 75 61 67 65 20 69 | 74 20 77 69 6c 6c 20 75 |nguage i|t will u|
|00002a30| 73 65 20 74 6f 20 73 63 | 61 6e 20 66 69 6c 65 73 |se to sc|an files|
|00002a40| 0a 58 77 69 74 68 20 74 | 68 61 74 20 73 75 66 66 |.Xwith t|hat suff|
|00002a50| 69 78 2e 0a 58 40 69 74 | 65 6d 20 2d 53 3f 3d 40 |ix..X@it|em -S?=@|
|00002a60| 76 61 72 7b 3c 6c 61 6e | 67 75 61 67 65 3e 7d 0a |var{<lan|guage>}.|
|00002a70| 58 54 68 69 73 20 66 6f | 72 6d 20 77 69 6c 6c 20 |XThis fo|rm will |
|00002a80| 70 72 69 6e 74 20 77 68 | 69 63 68 20 73 75 66 66 |print wh|ich suff|
|00002a90| 69 78 65 73 20 61 72 65 | 20 73 63 61 6e 6e 65 64 |ixes are| scanned|
|00002aa0| 20 77 69 74 68 20 74 68 | 65 20 67 69 76 65 6e 20 | with th|e given |
|00002ab0| 6c 61 6e 67 75 61 67 65 | 2e 0a 58 40 69 74 65 6d |language|..X@item|
|00002ac0| 20 2d 53 3f 3d 3f 0a 58 | 54 68 69 73 20 70 72 69 | -S?=?.X|This pri|
|00002ad0| 6e 74 73 20 61 6c 6c 20 | 74 68 65 20 73 75 66 66 |nts all |the suff|
|00002ae0| 69 78 40 65 78 70 61 6e | 73 69 6f 6e 7b 7d 6c 61 |ix@expan|sion{}la|
|00002af0| 6e 67 75 61 67 65 20 62 | 69 6e 64 69 6e 67 73 20 |nguage b|indings |
|00002b00| 72 65 63 6f 67 6e 69 7a | 65 64 20 62 79 0a 58 40 |recogniz|ed by.X@|
|00002b10| 63 6f 64 65 7b 6d 6b 69 | 64 7d 2e 0a 58 40 69 74 |code{mki|d}..X@it|
|00002b20| 65 6d 20 2d 53 40 76 61 | 72 7b 3c 6c 61 6e 67 75 |em -S@va|r{<langu|
|00002b30| 61 67 65 3e 7d 2d 40 76 | 61 72 7b 3c 61 72 67 3e |age>}-@v|ar{<arg>|
|00002b40| 7d 0a 58 45 61 63 68 20 | 6c 61 6e 67 75 61 67 65 |}.XEach |language|
|00002b50| 20 73 63 61 6e 6e 65 72 | 20 61 63 63 65 70 74 73 | scanner| accepts|
|00002b60| 20 73 63 61 6e 6e 65 72 | 20 64 65 70 65 6e 64 65 | scanner| depende|
|00002b70| 6e 74 20 61 72 67 75 6d | 65 6e 74 73 2e 20 54 68 |nt argum|ents. Th|
|00002b80| 69 73 20 66 6f 72 6d 20 | 6f 66 20 74 68 65 0a 58 |is form |of the.X|
|00002b90| 40 63 6f 64 65 7b 2d 53 | 7d 20 6f 70 74 69 6f 6e |@code{-S|} option|
|00002ba0| 20 69 73 20 75 73 65 64 | 20 74 6f 20 70 61 73 73 | is used| to pass|
|00002bb0| 20 61 72 62 69 74 72 61 | 72 79 20 61 72 67 75 6d | arbitra|ry argum|
|00002bc0| 65 6e 74 73 20 74 6f 20 | 74 68 65 20 6c 61 6e 67 |ents to |the lang|
|00002bd0| 75 61 67 65 20 73 63 61 | 6e 6e 65 72 73 2e 0a 58 |uage sca|nners..X|
|00002be0| 40 69 74 65 6d 20 2d 53 | 40 76 61 72 7b 3c 6c 61 |@item -S|@var{<la|
|00002bf0| 6e 67 75 61 67 65 3e 7d | 3f 0a 58 50 61 73 73 69 |nguage>}|?.XPassi|
|00002c00| 6e 67 20 61 20 40 73 61 | 6d 70 7b 3f 7d 20 69 6e |ng a @sa|mp{?} in|
|00002c10| 73 74 65 61 64 20 6f 66 | 20 61 20 6c 61 6e 67 75 |stead of| a langu|
|00002c20| 61 67 65 20 6f 70 74 69 | 6f 6e 20 77 69 6c 6c 20 |age opti|on will |
|00002c30| 70 72 69 6e 74 20 61 20 | 62 72 69 65 66 20 73 75 |print a |brief su|
|00002c40| 6d 6d 61 72 79 0a 58 6f | 66 20 74 68 65 20 6f 70 |mmary.Xo|f the op|
|00002c50| 74 69 6f 6e 73 20 72 65 | 63 6f 67 6e 69 7a 65 64 |tions re|cognized|
|00002c60| 20 62 79 20 74 68 65 20 | 73 70 65 63 69 66 69 65 | by the |specifie|
|00002c70| 64 20 6c 61 6e 67 75 61 | 67 65 20 73 63 61 6e 6e |d langua|ge scann|
|00002c80| 65 72 2e 0a 58 40 69 74 | 65 6d 20 2d 53 40 76 61 |er..X@it|em -S@va|
|00002c90| 72 7b 3c 6e 65 77 20 6c | 61 6e 67 75 61 67 65 3e |r{<new l|anguage>|
|00002ca0| 7d 2f 40 76 61 72 7b 3c | 62 75 69 6c 74 69 6e 20 |}/@var{<|builtin |
|00002cb0| 6c 61 6e 67 75 61 67 65 | 3e 7d 2f 40 76 61 72 7b |language|>}/@var{|
|00002cc0| 3c 66 69 6c 74 65 72 20 | 63 6f 6d 6d 61 6e 64 3e |<filter |command>|
|00002cd0| 7d 0a 58 54 68 69 73 20 | 66 6f 72 6d 20 73 70 65 |}.XThis |form spe|
|00002ce0| 63 69 66 69 65 73 20 61 | 20 6e 65 77 20 6c 61 6e |cifies a| new lan|
|00002cf0| 67 75 61 67 65 20 64 65 | 66 69 6e 65 64 20 69 6e |guage de|fined in|
|00002d00| 20 74 65 72 6d 73 20 6f | 66 20 61 20 62 75 69 6c | terms o|f a buil|
|00002d10| 74 69 6e 20 6c 61 6e 67 | 75 61 67 65 0a 58 61 6e |tin lang|uage.Xan|
|00002d20| 64 20 61 20 73 68 65 6c | 6c 20 63 6f 6d 6d 61 6e |d a shel|l comman|
|00002d30| 64 20 74 68 61 74 20 77 | 69 6c 6c 20 62 65 20 75 |d that w|ill be u|
|00002d40| 73 65 64 20 74 6f 20 66 | 69 6c 74 65 72 20 74 68 |sed to f|ilter th|
|00002d50| 65 20 66 69 6c 65 20 70 | 72 69 6f 72 20 74 6f 20 |e file p|rior to |
|00002d60| 70 61 73 73 69 6e 67 0a | 58 6f 6e 20 74 6f 20 74 |passing.|Xon to t|
|00002d70| 68 65 20 62 75 69 6c 74 | 69 6e 20 6c 61 6e 67 75 |he built|in langu|
|00002d80| 61 67 65 20 73 63 61 6e | 6e 65 72 2e 0a 58 40 65 |age scan|ner..X@e|
|00002d90| 6e 64 20 74 61 62 6c 65 | 0a 58 0a 58 40 6e 6f 64 |nd table|.X.X@nod|
|00002da0| 65 20 42 75 69 6c 74 69 | 6e 20 53 63 61 6e 6e 65 |e Builti|n Scanne|
|00002db0| 72 73 2c 20 41 64 64 69 | 6e 67 20 59 6f 75 72 20 |rs, Addi|ng Your |
|00002dc0| 4f 77 6e 20 53 63 61 6e | 6e 65 72 2c 20 4d 6b 69 |Own Scan|ner, Mki|
|00002dd0| 64 20 43 6f 6d 6d 61 6e | 64 20 4c 69 6e 65 20 4f |d Comman|d Line O|
|00002de0| 70 74 69 6f 6e 73 2c 20 | 4d 6b 69 64 0a 58 40 73 |ptions, |Mkid.X@s|
|00002df0| 65 63 74 69 6f 6e 20 42 | 75 69 6c 74 69 6e 20 53 |ection B|uiltin S|
|00002e00| 63 61 6e 6e 65 72 73 0a | 58 49 66 20 79 6f 75 20 |canners.|XIf you |
|00002e10| 72 75 6e 20 40 63 6f 64 | 65 7b 6d 6b 69 64 20 2d |run @cod|e{mkid -|
|00002e20| 53 3f 3d 3f 7d 20 79 6f | 75 20 77 69 6c 6c 20 66 |S?=?} yo|u will f|
|00002e30| 69 6e 64 20 62 69 6e 64 | 69 6e 67 73 20 66 6f 72 |ind bind|ings for|
|00002e40| 20 61 20 6e 75 6d 62 65 | 72 20 6f 66 0a 58 6c 61 | a numbe|r of.Xla|
|00002e50| 6e 67 75 61 67 65 73 3b | 20 75 6e 66 6f 72 74 75 |nguages;| unfortu|
|00002e60| 6e 61 74 65 6c 79 20 70 | 61 73 63 61 6c 2c 20 74 |nately p|ascal, t|
|00002e70| 68 6f 75 67 68 20 6d 65 | 6e 74 69 6f 6e 65 64 20 |hough me|ntioned |
|00002e80| 69 6e 20 74 68 65 20 6c | 69 73 74 2c 20 69 73 20 |in the l|ist, is |
|00002e90| 6e 6f 74 0a 58 61 63 74 | 75 61 6c 6c 79 20 73 75 |not.Xact|ually su|
|00002ea0| 70 70 6f 72 74 65 64 2e | 20 20 54 68 65 20 73 75 |pported.| The su|
|00002eb0| 70 70 6f 72 74 65 64 20 | 6c 61 6e 67 75 61 67 65 |pported |language|
|00002ec0| 73 20 61 72 65 20 64 6f | 63 75 6d 65 6e 74 65 64 |s are do|cumented|
|00002ed0| 20 62 65 6c 6f 77 0a 58 | 40 66 6f 6f 74 6e 6f 74 | below.X|@footnot|
|00002ee0| 65 7b 54 68 69 73 20 69 | 73 20 6e 6f 74 20 73 74 |e{This i|s not st|
|00002ef0| 72 69 63 74 6c 79 20 74 | 72 75 65 20 2d 2d 2d 20 |rictly t|rue --- |
|00002f00| 76 68 69 6c 20 69 73 20 | 61 20 73 75 70 70 6f 72 |vhil is |a suppor|
|00002f10| 74 65 64 20 6c 61 6e 67 | 75 61 67 65 2c 20 62 75 |ted lang|uage, bu|
|00002f20| 74 0a 58 69 74 20 69 73 | 20 61 6e 20 6f 62 73 6f |t.Xit is| an obso|
|00002f30| 6c 65 74 65 20 61 6e 64 | 20 61 72 63 61 6e 65 20 |lete and| arcane |
|00002f40| 64 69 61 6c 65 63 74 20 | 6f 66 20 43 20 61 6e 64 |dialect |of C and|
|00002f50| 20 73 68 6f 75 6c 64 20 | 62 65 20 69 67 6e 6f 72 | should |be ignor|
|00002f60| 65 64 7d 2e 0a 58 0a 58 | 40 6d 65 6e 75 0a 58 2a |ed}..X.X|@menu.X*|
|00002f70| 20 43 3a 3a 20 20 20 20 | 20 20 20 20 20 20 20 20 | C:: | |
|00002f80| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 43 | | C|
|00002f90| 0a 58 2a 20 50 6c 61 69 | 6e 20 54 65 78 74 3a 3a |.X* Plai|n Text::|
|00002fa0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002fb0| 20 20 50 6c 61 69 6e 20 | 54 65 78 74 0a 58 2a 20 | Plain |Text.X* |
|00002fc0| 41 73 73 65 6d 62 6c 65 | 72 3a 3a 20 20 20 20 20 |Assemble|r:: |
|00002fd0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 41 73 | | As|
|00002fe0| 73 65 6d 62 6c 65 72 0a | 58 40 65 6e 64 20 6d 65 |sembler.|X@end me|
|00002ff0| 6e 75 0a 58 0a 58 40 6e | 6f 64 65 20 43 2c 20 50 |nu.X.X@n|ode C, P|
|00003000| 6c 61 69 6e 20 54 65 78 | 74 2c 20 42 75 69 6c 74 |lain Tex|t, Built|
|00003010| 69 6e 20 53 63 61 6e 6e | 65 72 73 2c 20 42 75 69 |in Scann|ers, Bui|
|00003020| 6c 74 69 6e 20 53 63 61 | 6e 6e 65 72 73 0a 58 40 |ltin Sca|nners.X@|
|00003030| 73 75 62 73 65 63 74 69 | 6f 6e 20 43 0a 58 0a 58 |subsecti|on C.X.X|
|00003040| 54 68 65 20 43 20 73 63 | 61 6e 6e 65 72 20 69 73 |The C sc|anner is|
|00003050| 20 70 72 6f 62 61 62 6c | 79 20 74 68 65 20 6d 6f | probabl|y the mo|
|00003060| 73 74 20 70 6f 70 75 6c | 61 72 2e 20 49 74 20 73 |st popul|ar. It s|
|00003070| 63 61 6e 73 20 69 64 65 | 6e 74 69 66 69 65 72 73 |cans ide|ntifiers|
|00003080| 20 6f 75 74 20 6f 66 0a | 58 43 20 70 72 6f 67 72 | out of.|XC progr|
|00003090| 61 6d 73 2c 20 73 6b 69 | 70 70 69 6e 67 20 6f 76 |ams, ski|pping ov|
|000030a0| 65 72 20 63 6f 6d 6d 65 | 6e 74 73 20 61 6e 64 20 |er comme|nts and |
|000030b0| 73 74 72 69 6e 67 73 20 | 69 6e 20 74 68 65 20 70 |strings |in the p|
|000030c0| 72 6f 63 65 73 73 2e 20 | 20 54 68 65 0a 58 6e 6f |rocess. | The.Xno|
|000030d0| 72 6d 61 6c 20 40 66 69 | 6c 65 7b 2e 63 7d 20 61 |rmal @fi|le{.c} a|
|000030e0| 6e 64 20 40 66 69 6c 65 | 7b 2e 68 7d 20 73 75 66 |nd @file|{.h} suf|
|000030f0| 66 69 78 65 73 20 61 72 | 65 20 61 75 74 6f 6d 61 |fixes ar|e automa|
|00003100| 74 69 63 61 6c 6c 79 20 | 72 65 63 6f 67 6e 69 7a |tically |recogniz|
|00003110| 65 64 20 61 73 0a 58 43 | 20 6c 61 6e 67 75 61 67 |ed as.XC| languag|
|00003120| 65 2c 20 61 73 20 77 65 | 6c 6c 20 61 73 20 74 68 |e, as we|ll as th|
|00003130| 65 20 6d 6f 72 65 20 6f | 62 73 63 75 72 65 20 40 |e more o|bscure @|
|00003140| 66 69 6c 65 7b 2e 79 7d | 20 28 79 61 63 63 29 20 |file{.y}| (yacc) |
|00003150| 61 6e 64 20 40 66 69 6c | 65 7b 2e 6c 7d 0a 58 28 |and @fil|e{.l}.X(|
|00003160| 6c 65 78 29 20 73 75 66 | 66 69 78 65 73 2e 0a 58 |lex) suf|fixes..X|
|00003170| 0a 58 54 68 65 20 40 63 | 6f 64 65 7b 2d 53 7d 20 |.XThe @c|ode{-S} |
|00003180| 6f 70 74 69 6f 6e 73 20 | 72 65 63 6f 67 6e 69 7a |options |recogniz|
|00003190| 65 64 20 62 79 20 74 68 | 65 20 43 20 73 63 61 6e |ed by th|e C scan|
|000031a0| 6e 65 72 20 61 72 65 3a | 0a 58 0a 58 40 74 61 62 |ner are:|.X.X@tab|
|000031b0| 6c 65 20 40 63 6f 64 65 | 0a 58 40 69 74 65 6d 20 |le @code|.X@item |
|000031c0| 2d 53 63 2d 73 40 76 61 | 72 7b 3c 63 68 61 72 61 |-Sc-s@va|r{<chara|
|000031d0| 63 74 65 72 3e 7d 0a 58 | 41 6c 6c 6f 77 20 74 68 |cter>}.X|Allow th|
|000031e0| 65 20 73 70 65 63 69 66 | 69 65 64 20 40 76 61 72 |e specif|ied @var|
|000031f0| 7b 3c 63 68 61 72 61 63 | 74 65 72 3e 7d 20 69 6e |{<charac|ter>} in|
|00003200| 20 69 64 65 6e 74 69 66 | 69 65 72 73 20 28 73 6f | identif|iers (so|
|00003210| 6d 65 20 64 69 61 6c 65 | 63 74 73 20 6f 66 0a 58 |me diale|cts of.X|
|00003220| 43 20 61 6c 6c 6f 77 20 | 40 63 6f 64 65 7b 24 7d |C allow |@code{$}|
|00003230| 20 69 6e 20 69 64 65 6e | 74 69 66 69 65 72 73 2c | in iden|tifiers,|
|00003240| 20 73 6f 20 79 6f 75 20 | 63 6f 75 6c 64 20 73 61 | so you |could sa|
|00003250| 79 20 40 63 6f 64 65 7b | 2d 53 63 2d 73 24 7d 20 |y @code{|-Sc-s$} |
|00003260| 74 6f 0a 58 61 63 63 65 | 70 74 20 74 68 61 74 20 |to.Xacce|pt that |
|00003270| 64 69 61 6c 65 63 74 29 | 2e 0a 58 40 69 74 65 6d |dialect)|..X@item|
|00003280| 20 2d 53 63 2d 75 0a 58 | 44 6f 6e 27 74 20 73 74 | -Sc-u.X|Don't st|
|00003290| 72 69 70 20 6c 65 61 64 | 69 6e 67 20 75 6e 64 65 |rip lead|ing unde|
|000032a0| 72 73 63 6f 72 65 73 20 | 66 72 6f 6d 20 69 64 65 |rscores |from ide|
|000032b0| 6e 74 69 66 69 65 72 20 | 6e 61 6d 65 73 20 28 74 |ntifier |names (t|
|000032c0| 68 69 73 20 69 73 20 74 | 68 65 20 64 65 66 61 75 |his is t|he defau|
|000032d0| 6c 74 0a 58 6d 6f 64 65 | 20 6f 66 20 6f 70 65 72 |lt.Xmode| of oper|
|000032e0| 61 74 69 6f 6e 29 2e 0a | 58 40 69 74 65 6d 20 2d |ation)..|X@item -|
|000032f0| 53 63 2b 75 0a 58 44 6f | 20 73 74 72 69 70 20 6c |Sc+u.XDo| strip l|
|00003300| 65 61 64 69 6e 67 20 75 | 6e 64 65 72 73 63 6f 72 |eading u|nderscor|
|00003310| 65 73 20 66 72 6f 6d 20 | 69 64 65 6e 74 69 66 69 |es from |identifi|
|00003320| 65 72 20 6e 61 6d 65 73 | 20 28 49 20 64 6f 6e 27 |er names| (I don'|
|00003330| 74 20 6b 6e 6f 77 20 77 | 68 79 20 79 6f 75 0a 58 |t know w|hy you.X|
|00003340| 77 6f 75 6c 64 20 77 61 | 6e 74 20 74 6f 20 64 6f |would wa|nt to do|
|00003350| 20 74 68 69 73 20 69 6e | 20 43 20 70 72 6f 67 72 | this in| C progr|
|00003360| 61 6d 73 2c 20 62 75 74 | 20 74 68 65 20 6f 70 74 |ams, but| the opt|
|00003370| 69 6f 6e 20 69 73 20 61 | 76 61 69 6c 61 62 6c 65 |ion is a|vailable|
|00003380| 29 2e 0a 58 40 65 6e 64 | 20 74 61 62 6c 65 0a 58 |)..X@end| table.X|
|00003390| 0a 58 40 6e 6f 64 65 20 | 50 6c 61 69 6e 20 54 65 |.X@node |Plain Te|
|000033a0| 78 74 2c 20 41 73 73 65 | 6d 62 6c 65 72 2c 20 43 |xt, Asse|mbler, C|
|000033b0| 2c 20 42 75 69 6c 74 69 | 6e 20 53 63 61 6e 6e 65 |, Builti|n Scanne|
|000033c0| 72 73 0a 58 40 73 75 62 | 73 65 63 74 69 6f 6e 20 |rs.X@sub|section |
|000033d0| 50 6c 61 69 6e 20 54 65 | 78 74 0a 58 54 68 65 20 |Plain Te|xt.XThe |
|000033e0| 70 6c 61 69 6e 20 74 65 | 78 74 20 73 63 61 6e 6e |plain te|xt scann|
|000033f0| 65 72 20 69 73 20 64 65 | 73 69 67 6e 65 64 20 66 |er is de|signed f|
|00003400| 6f 72 20 73 63 61 6e 6e | 69 6e 67 20 64 6f 63 75 |or scann|ing docu|
|00003410| 6d 65 6e 74 73 2e 20 54 | 68 69 73 20 69 73 0a 58 |ments. T|his is.X|
|00003420| 74 79 70 69 63 61 6c 6c | 79 20 74 68 65 20 73 63 |typicall|y the sc|
|00003430| 61 6e 6e 65 72 20 75 73 | 65 64 20 77 68 65 6e 20 |anner us|ed when |
|00003440| 61 64 64 69 6e 67 20 63 | 75 73 74 6f 6d 20 73 63 |adding c|ustom sc|
|00003450| 61 6e 6e 65 72 73 2c 20 | 61 6e 64 20 73 65 76 65 |anners, |and seve|
|00003460| 72 61 6c 0a 58 63 75 73 | 74 6f 6d 20 73 63 61 6e |ral.Xcus|tom scan|
|00003470| 6e 65 72 73 20 61 72 65 | 20 62 75 69 6c 74 20 69 |ners are| built i|
|00003480| 6e 20 74 6f 20 40 63 6f | 64 65 7b 6d 6b 69 64 7d |n to @co|de{mkid}|
|00003490| 20 61 6e 64 20 64 65 66 | 69 6e 65 64 20 69 6e 20 | and def|ined in |
|000034a0| 74 65 72 6d 73 20 6f 66 | 20 66 69 6c 74 65 72 73 |terms of| filters|
|000034b0| 0a 58 61 6e 64 20 74 68 | 65 20 74 65 78 74 20 73 |.Xand th|e text s|
|000034c0| 63 61 6e 6e 65 72 2e 20 | 41 20 74 72 6f 66 66 20 |canner. |A troff |
|000034d0| 73 63 61 6e 6e 65 72 20 | 72 75 6e 73 20 40 63 6f |scanner |runs @co|
|000034e0| 64 65 7b 64 65 72 6f 66 | 66 7d 20 6f 76 65 72 20 |de{derof|f} over |
|000034f0| 74 68 65 20 66 69 6c 65 | 0a 58 74 68 65 6e 20 66 |the file|.Xthen f|
|00003500| 65 65 64 73 20 74 68 65 | 20 72 65 73 75 6c 74 20 |eeds the| result |
|00003510| 74 6f 20 74 68 65 20 74 | 65 78 74 20 73 63 61 6e |to the t|ext scan|
|00003520| 6e 65 72 2e 20 41 20 63 | 6f 6d 70 72 65 73 73 65 |ner. A c|ompresse|
|00003530| 64 20 6d 61 6e 20 70 61 | 67 65 20 73 63 61 6e 6e |d man pa|ge scann|
|00003540| 65 72 0a 58 72 75 6e 73 | 20 40 63 6f 64 65 7b 70 |er.Xruns| @code{p|
|00003550| 63 61 74 7d 20 70 69 70 | 65 64 20 69 6e 74 6f 20 |cat} pip|ed into |
|00003560| 40 63 6f 64 65 7b 63 6f | 6c 20 2d 62 7d 2c 20 61 |@code{co|l -b}, a|
|00003570| 6e 64 20 61 20 40 54 65 | 58 7b 7d 20 73 63 61 6e |nd a @Te|X{} scan|
|00003580| 6e 65 72 20 72 75 6e 73 | 0a 58 40 63 6f 64 65 7b |ner runs|.X@code{|
|00003590| 64 65 74 65 78 7d 2e 0a | 58 0a 58 4f 70 74 69 6f |detex}..|X.XOptio|
|000035a0| 6e 73 3a 0a 58 0a 58 40 | 74 61 62 6c 65 20 40 63 |ns:.X.X@|table @c|
|000035b0| 6f 64 65 0a 58 40 69 74 | 65 6d 20 2d 53 74 65 78 |ode.X@it|em -Stex|
|000035c0| 74 2b 61 40 76 61 72 7b | 3c 63 68 61 72 61 63 74 |t+a@var{|<charact|
|000035d0| 65 72 3e 7d 0a 58 49 6e | 63 6c 75 64 65 20 74 68 |er>}.XIn|clude th|
|000035e0| 65 20 73 70 65 63 69 66 | 69 65 64 20 63 68 61 72 |e specif|ied char|
|000035f0| 61 63 74 65 72 20 69 6e | 20 69 64 65 6e 74 69 66 |acter in| identif|
|00003600| 69 65 72 73 2e 20 42 79 | 20 64 65 66 61 75 6c 74 |iers. By| default|
|00003610| 2c 20 73 74 61 6e 64 61 | 72 64 0a 58 43 20 69 64 |, standa|rd.XC id|
|00003620| 65 6e 74 69 66 69 65 72 | 73 20 61 72 65 20 72 65 |entifier|s are re|
|00003630| 63 6f 67 6e 69 7a 65 64 | 2e 0a 58 40 69 74 65 6d |cognized|..X@item|
|00003640| 20 2d 53 74 65 78 74 2d | 61 40 76 61 72 7b 3c 63 | -Stext-|a@var{<c|
|00003650| 68 61 72 61 63 74 65 72 | 3e 7d 0a 58 45 78 63 6c |haracter|>}.XExcl|
|00003660| 75 64 65 20 74 68 65 20 | 73 70 65 63 69 66 69 65 |ude the |specifie|
|00003670| 64 20 63 68 61 72 61 63 | 74 65 72 20 66 72 6f 6d |d charac|ter from|
|00003680| 20 69 64 65 6e 74 69 66 | 69 65 72 73 2e 0a 58 40 | identif|iers..X@|
|00003690| 69 74 65 6d 20 2d 53 74 | 65 78 74 2b 73 40 76 61 |item -St|ext+s@va|
|000036a0| 72 7b 3c 63 68 61 72 61 | 63 74 65 72 3e 7d 0a 58 |r{<chara|cter>}.X|
|000036b0| 53 71 75 65 65 7a 65 20 | 74 68 65 20 73 70 65 63 |Squeeze |the spec|
|000036c0| 69 66 69 65 64 20 63 68 | 61 72 61 63 74 65 72 20 |ified ch|aracter |
|000036d0| 6f 75 74 20 6f 66 20 69 | 64 65 6e 74 69 66 69 65 |out of i|dentifie|
|000036e0| 72 73 2e 20 42 79 20 64 | 65 66 61 75 6c 74 2c 20 |rs. By d|efault, |
|000036f0| 74 68 65 0a 58 63 68 61 | 72 61 63 74 65 72 73 20 |the.Xcha|racters |
|00003700| 40 73 61 6d 70 7b 27 7d | 2c 20 40 73 61 6d 70 7b |@samp{'}|, @samp{|
|00003710| 2d 7d 2c 20 61 6e 64 20 | 40 73 61 6d 70 7b 2e 7d |-}, and |@samp{.}|
|00003720| 20 61 72 65 20 73 71 75 | 65 65 7a 65 64 20 6f 75 | are squ|eezed ou|
|00003730| 74 20 6f 66 20 69 64 65 | 6e 74 69 66 69 65 72 73 |t of ide|ntifiers|
|00003740| 2e 0a 58 54 68 69 73 20 | 67 65 6e 65 72 61 74 65 |..XThis |generate|
|00003750| 73 20 74 72 61 6e 73 66 | 6f 72 6d 61 74 69 6f 6e |s transf|ormation|
|00003760| 73 20 6c 69 6b 65 20 40 | 76 61 72 7b 66 72 65 64 |s like @|var{fred|
|00003770| 27 73 7d 40 65 78 70 61 | 6e 73 69 6f 6e 7b 7d 40 |'s}@expa|nsion{}@|
|00003780| 76 61 72 7b 66 72 65 64 | 73 7d 20 6f 72 0a 58 40 |var{fred|s} or.X@|
|00003790| 76 61 72 7b 61 2e 73 2e | 70 2e 63 2e 61 2e 7d 40 |var{a.s.|p.c.a.}@|
|000037a0| 65 78 70 61 6e 73 69 6f | 6e 7b 7d 40 76 61 72 7b |expansio|n{}@var{|
|000037b0| 61 73 70 63 61 7d 2e 0a | 58 40 69 74 65 6d 20 2d |aspca}..|X@item -|
|000037c0| 53 74 65 78 74 2d 73 40 | 76 61 72 7b 3c 63 68 61 |Stext-s@|var{<cha|
|000037d0| 72 61 63 74 65 72 3e 7d | 0a 58 44 6f 20 6e 6f 74 |racter>}|.XDo not|
|000037e0| 20 73 71 75 65 65 7a 65 | 20 6f 75 74 20 74 68 65 | squeeze| out the|
|000037f0| 20 73 70 65 63 69 66 69 | 65 64 20 63 68 61 72 61 | specifi|ed chara|
|00003800| 63 74 65 72 2e 0a 58 40 | 65 6e 64 20 74 61 62 6c |cter..X@|end tabl|
|00003810| 65 0a 58 0a 58 40 6e 6f | 64 65 20 41 73 73 65 6d |e.X.X@no|de Assem|
|00003820| 62 6c 65 72 2c 20 20 2c | 20 50 6c 61 69 6e 20 54 |bler, ,| Plain T|
|00003830| 65 78 74 2c 20 42 75 69 | 6c 74 69 6e 20 53 63 61 |ext, Bui|ltin Sca|
|00003840| 6e 6e 65 72 73 0a 58 40 | 73 75 62 73 65 63 74 69 |nners.X@|subsecti|
|00003850| 6f 6e 20 41 73 73 65 6d | 62 6c 65 72 0a 58 41 73 |on Assem|bler.XAs|
|00003860| 73 65 6d 62 6c 65 72 73 | 20 63 6f 6d 65 20 69 6e |semblers| come in|
|00003870| 20 73 65 76 65 72 61 6c | 20 66 6c 61 76 6f 72 73 | several| flavors|
|00003880| 2c 20 73 6f 20 74 68 65 | 72 65 20 61 72 65 20 73 |, so the|re are s|
|00003890| 65 76 65 72 61 6c 20 6f | 70 74 69 6f 6e 73 20 74 |everal o|ptions t|
|000038a0| 6f 0a 58 63 6f 6e 74 72 | 6f 6c 20 73 63 61 6e 6e |o.Xcontr|ol scann|
|000038b0| 69 6e 67 20 6f 66 20 61 | 73 73 65 6d 62 6c 79 20 |ing of a|ssembly |
|000038c0| 63 6f 64 65 3a 0a 58 0a | 58 40 74 61 62 6c 65 20 |code:.X.|X@table |
|000038d0| 40 63 6f 64 65 0a 58 40 | 69 74 65 6d 20 2d 53 61 |@code.X@|item -Sa|
|000038e0| 73 6d 2d 63 40 76 61 72 | 7b 3c 63 68 61 72 61 63 |sm-c@var|{<charac|
|000038f0| 74 65 72 3e 7d 0a 58 54 | 68 65 20 73 70 65 63 69 |ter>}.XT|he speci|
|00003900| 66 69 65 64 20 63 68 61 | 72 61 63 74 65 72 20 73 |fied cha|racter s|
|00003910| 74 61 72 74 73 20 61 20 | 63 6f 6d 6d 65 6e 74 20 |tarts a |comment |
|00003920| 74 68 61 74 20 65 78 74 | 65 6e 64 73 20 74 6f 20 |that ext|ends to |
|00003930| 65 6e 64 20 6f 66 20 6c | 69 6e 65 0a 58 28 69 6e |end of l|ine.X(in|
|00003940| 20 6d 61 6e 79 20 61 73 | 73 65 6d 62 6c 65 72 73 | many as|semblers|
|00003950| 20 74 68 69 73 20 69 73 | 20 61 20 73 65 6d 69 63 | this is| a semic|
|00003960| 6f 6c 6f 6e 20 6f 72 20 | 6e 75 6d 62 65 72 20 73 |olon or |number s|
|00003970| 69 67 6e 20 2d 2d 2d 20 | 74 68 65 72 65 20 69 73 |ign --- |there is|
|00003980| 0a 58 6e 6f 20 64 65 66 | 61 75 6c 74 20 76 61 6c |.Xno def|ault val|
|00003990| 75 65 20 66 6f 72 20 74 | 68 69 73 29 2e 0a 58 40 |ue for t|his)..X@|
|000039a0| 69 74 65 6d 20 2d 53 61 | 73 6d 2b 75 0a 58 53 74 |item -Sa|sm+u.XSt|
|000039b0| 72 69 70 20 74 68 65 20 | 6c 65 61 64 69 6e 67 20 |rip the |leading |
|000039c0| 75 6e 64 65 72 73 63 6f | 72 65 73 20 6f 66 66 20 |undersco|res off |
|000039d0| 69 64 65 6e 74 69 66 69 | 65 72 73 20 28 74 68 65 |identifi|ers (the|
|000039e0| 20 64 65 66 61 75 6c 74 | 20 62 65 68 61 76 69 6f | default| behavio|
|000039f0| 72 29 2e 0a 58 40 69 74 | 65 6d 20 2d 53 61 73 6d |r)..X@it|em -Sasm|
|00003a00| 2d 75 0a 58 44 6f 20 6e | 6f 74 20 73 74 72 69 70 |-u.XDo n|ot strip|
|00003a10| 20 74 68 65 20 6c 65 61 | 64 69 6e 67 20 75 6e 64 | the lea|ding und|
|00003a20| 65 72 73 63 6f 72 65 73 | 2e 0a 58 40 69 74 65 6d |erscores|..X@item|
|00003a30| 20 2d 53 61 73 6d 2b 61 | 40 76 61 72 7b 3c 63 68 | -Sasm+a|@var{<ch|
|00003a40| 61 72 61 63 74 65 72 3e | 7d 0a 58 54 68 65 20 73 |aracter>|}.XThe s|
|00003a50| 70 65 63 69 66 69 65 64 | 20 63 68 61 72 61 63 74 |pecified| charact|
|00003a60| 65 72 20 69 73 20 61 6c | 6c 6f 77 65 64 20 69 6e |er is al|lowed in|
|00003a70| 20 69 64 65 6e 74 69 66 | 69 65 72 73 2e 0a 58 40 | identif|iers..X@|
|00003a80| 69 74 65 6d 20 2d 53 61 | 73 6d 2d 61 40 76 61 72 |item -Sa|sm-a@var|
|00003a90| 7b 3c 63 68 61 72 61 63 | 74 65 72 3e 7d 0a 58 54 |{<charac|ter>}.XT|
|00003aa0| 68 65 20 73 70 65 63 69 | 66 69 65 64 20 63 68 61 |he speci|fied cha|
|00003ab0| 72 61 63 74 65 72 20 69 | 73 20 61 6c 6c 6f 77 65 |racter i|s allowe|
|00003ac0| 64 20 69 6e 20 69 64 65 | 6e 74 69 66 69 65 72 73 |d in ide|ntifiers|
|00003ad0| 2c 20 62 75 74 20 61 6e | 79 20 69 64 65 6e 74 69 |, but an|y identi|
|00003ae0| 66 69 65 72 0a 58 63 6f | 6e 74 61 69 6e 69 6e 67 |fier.Xco|ntaining|
|00003af0| 20 74 68 61 74 20 63 68 | 61 72 61 63 74 65 72 20 | that ch|aracter |
|00003b00| 69 73 20 69 67 6e 6f 72 | 65 64 20 28 6f 66 74 65 |is ignor|ed (ofte|
|00003b10| 6e 20 61 20 40 73 61 6d | 70 7b 2e 7d 20 6f 72 20 |n a @sam|p{.} or |
|00003b20| 40 73 61 6d 70 7b 40 40 | 7d 0a 58 77 69 6c 6c 20 |@samp{@@|}.Xwill |
|00003b30| 62 65 20 75 73 65 64 20 | 74 6f 20 69 6e 64 69 63 |be used |to indic|
|00003b40| 61 74 65 20 61 6e 20 69 | 6e 74 65 72 6e 61 6c 20 |ate an i|nternal |
|00003b50| 74 65 6d 70 20 6c 61 62 | 65 6c 2c 20 79 6f 75 20 |temp lab|el, you |
|00003b60| 6d 61 79 20 77 61 6e 74 | 20 74 6f 0a 58 69 67 6e |may want| to.Xign|
|00003b70| 6f 72 65 20 74 68 65 73 | 65 29 2e 0a 58 40 69 74 |ore thes|e)..X@it|
|00003b80| 65 6d 20 2d 53 61 73 6d | 2b 70 0a 58 52 65 63 6f |em -Sasm|+p.XReco|
|00003b90| 67 6e 69 7a 65 20 43 20 | 70 72 65 70 72 6f 63 65 |gnize C |preproce|
|00003ba0| 73 73 6f 72 20 64 69 72 | 65 63 74 69 76 65 73 20 |ssor dir|ectives |
|00003bb0| 69 6e 20 61 73 73 65 6d | 62 6c 65 72 20 73 6f 75 |in assem|bler sou|
|00003bc0| 72 63 65 20 28 64 65 66 | 61 75 6c 74 29 2e 0a 58 |rce (def|ault)..X|
|00003bd0| 40 69 74 65 6d 20 2d 53 | 61 73 6d 2d 70 0a 58 44 |@item -S|asm-p.XD|
|00003be0| 6f 20 6e 6f 74 20 72 65 | 63 6f 67 6e 69 7a 65 20 |o not re|cognize |
|00003bf0| 43 20 70 72 65 70 72 6f | 63 65 73 73 6f 72 20 64 |C prepro|cessor d|
|00003c00| 69 72 65 63 74 69 76 65 | 73 20 69 6e 20 61 73 73 |irective|s in ass|
|00003c10| 65 6d 62 6c 65 72 20 73 | 6f 75 72 63 65 2e 0a 58 |embler s|ource..X|
|00003c20| 40 69 74 65 6d 20 2d 53 | 61 73 6d 2b 43 0a 58 53 |@item -S|asm+C.XS|
|00003c30| 6b 69 70 20 6f 76 65 72 | 20 43 20 73 74 79 6c 65 |kip over| C style|
|00003c40| 20 63 6f 6d 6d 65 6e 74 | 73 20 69 6e 20 61 73 73 | comment|s in ass|
|00003c50| 65 6d 62 6c 65 72 20 73 | 6f 75 72 63 65 20 28 64 |embler s|ource (d|
|00003c60| 65 66 61 75 6c 74 29 2e | 0a 58 40 69 74 65 6d 20 |efault).|.X@item |
|00003c70| 2d 53 61 73 6d 2d 43 0a | 58 44 6f 20 6e 6f 74 20 |-Sasm-C.|XDo not |
|00003c80| 73 6b 69 70 20 6f 76 65 | 72 20 43 20 73 74 79 6c |skip ove|r C styl|
|00003c90| 65 20 63 6f 6d 6d 65 6e | 74 73 20 69 6e 20 61 73 |e commen|ts in as|
|00003ca0| 73 65 6d 62 6c 65 72 20 | 73 6f 75 72 63 65 2e 0a |sembler |source..|
|00003cb0| 58 40 65 6e 64 20 74 61 | 62 6c 65 0a 58 0a 58 40 |X@end ta|ble.X.X@|
|00003cc0| 6e 6f 64 65 20 41 64 64 | 69 6e 67 20 59 6f 75 72 |node Add|ing Your|
|00003cd0| 20 4f 77 6e 20 53 63 61 | 6e 6e 65 72 2c 20 4d 6b | Own Sca|nner, Mk|
|00003ce0| 69 64 20 45 78 61 6d 70 | 6c 65 73 2c 20 42 75 69 |id Examp|les, Bui|
|00003cf0| 6c 74 69 6e 20 53 63 61 | 6e 6e 65 72 73 2c 20 4d |ltin Sca|nners, M|
|00003d00| 6b 69 64 0a 58 40 73 65 | 63 74 69 6f 6e 20 41 64 |kid.X@se|ction Ad|
|00003d10| 64 69 6e 67 20 59 6f 75 | 72 20 4f 77 6e 20 53 63 |ding You|r Own Sc|
|00003d20| 61 6e 6e 65 72 0a 58 0a | 58 54 68 65 72 65 20 61 |anner.X.|XThere a|
|00003d30| 72 65 20 74 77 6f 20 77 | 61 79 73 20 74 6f 20 61 |re two w|ays to a|
|00003d40| 64 64 20 6e 65 77 20 73 | 63 61 6e 6e 65 72 73 20 |dd new s|canners |
|00003d50| 74 6f 20 40 63 6f 64 65 | 7b 6d 6b 69 64 7d 2e 20 |to @code|{mkid}. |
|00003d60| 54 68 65 20 66 69 72 73 | 74 20 69 73 20 74 6f 0a |The firs|t is to.|
|00003d70| 58 6d 6f 64 69 66 79 20 | 74 68 65 20 63 6f 64 65 |Xmodify |the code|
|00003d80| 20 69 6e 20 40 66 69 6c | 65 7b 67 65 74 73 63 61 | in @fil|e{getsca|
|00003d90| 6e 2e 63 7d 20 61 6e 64 | 20 61 64 64 20 61 20 6e |n.c} and| add a n|
|00003da0| 65 77 20 40 66 69 6c 65 | 7b 73 63 61 6e 2d 2a 2e |ew @file|{scan-*.|
|00003db0| 63 7d 20 66 69 6c 65 0a | 58 77 69 74 68 20 74 68 |c} file.|Xwith th|
|00003dc0| 65 20 63 6f 64 65 20 66 | 6f 72 20 79 6f 75 72 20 |e code f|or your |
|00003dd0| 73 63 61 6e 6e 65 72 2e | 20 54 68 69 73 20 69 73 |scanner.| This is|
|00003de0| 20 6e 6f 74 20 74 6f 6f | 20 68 61 72 64 2c 20 62 | not too| hard, b|
|00003df0| 75 74 20 69 74 20 72 65 | 71 75 69 72 65 73 0a 58 |ut it re|quires.X|
|00003e00| 72 65 6c 69 6e 6b 69 6e | 67 20 61 6e 64 20 69 6e |relinkin|g and in|
|00003e10| 73 74 61 6c 6c 69 6e 67 | 20 61 20 6e 65 77 20 76 |stalling| a new v|
|00003e20| 65 72 73 69 6f 6e 20 6f | 66 20 40 63 6f 64 65 7b |ersion o|f @code{|
|00003e30| 6d 6b 69 64 7d 2c 20 77 | 68 69 63 68 20 6d 69 67 |mkid}, w|hich mig|
|00003e40| 68 74 20 62 65 0a 58 69 | 6e 63 6f 6e 76 65 6e 69 |ht be.Xi|nconveni|
|00003e50| 65 6e 74 2c 20 61 6e 64 | 20 77 6f 75 6c 64 20 6c |ent, and| would l|
|00003e60| 65 61 64 20 74 6f 20 74 | 68 65 20 70 72 6f 6c 69 |ead to t|he proli|
|00003e70| 66 65 72 61 74 69 6f 6e | 20 6f 66 20 40 63 6f 64 |feration| of @cod|
|00003e80| 65 7b 6d 6b 69 64 7d 0a | 58 76 65 72 73 69 6f 6e |e{mkid}.|Xversion|
|00003e90| 73 2e 0a 58 0a 58 54 68 | 65 20 73 65 63 6f 6e 64 |s..X.XTh|e second|
|00003ea0| 20 74 65 63 68 6e 69 71 | 75 65 20 75 73 65 73 20 | techniq|ue uses |
|00003eb0| 74 68 65 20 20 40 63 6f | 64 65 7b 2d 53 3c 6c 61 |the @co|de{-S<la|
|00003ec0| 6e 67 3e 2f 3c 6c 61 6e | 67 3e 2f 3c 66 69 6c 74 |ng>/<lan|g>/<filt|
|00003ed0| 65 72 3e 7d 20 66 6f 72 | 6d 0a 58 6f 66 20 74 68 |er>} for|m.Xof th|
|00003ee0| 65 20 40 63 6f 64 65 7b | 2d 53 7d 20 6f 70 74 69 |e @code{|-S} opti|
|00003ef0| 6f 6e 20 74 6f 20 73 70 | 65 63 69 66 79 20 61 20 |on to sp|ecify a |
|00003f00| 6e 65 77 20 6c 61 6e 67 | 75 61 67 65 20 73 63 61 |new lang|uage sca|
|00003f10| 6e 6e 65 72 2e 20 49 6e | 20 74 68 69 73 20 66 6f |nner. In| this fo|
|00003f20| 72 6d 0a 58 74 68 65 20 | 66 69 72 73 74 20 6c 61 |rm.Xthe |first la|
|00003f30| 6e 67 75 61 67 65 20 69 | 73 20 74 68 65 20 6e 61 |nguage i|s the na|
|00003f40| 6d 65 20 6f 66 20 74 68 | 65 20 6e 65 77 20 6c 61 |me of th|e new la|
|00003f50| 6e 67 75 61 67 65 20 74 | 6f 20 62 65 20 64 65 66 |nguage t|o be def|
|00003f60| 69 6e 65 64 2c 0a 58 74 | 68 65 20 73 65 63 6f 6e |ined,.Xt|he secon|
|00003f70| 64 20 6c 61 6e 67 75 61 | 67 65 20 69 73 20 74 68 |d langua|ge is th|
|00003f80| 65 20 6e 61 6d 65 20 6f | 66 20 61 6e 20 65 78 69 |e name o|f an exi|
|00003f90| 73 74 69 6e 67 20 6c 61 | 6e 67 75 61 67 65 20 73 |sting la|nguage s|
|00003fa0| 63 61 6e 6e 65 72 20 74 | 6f 0a 58 62 65 20 69 6e |canner t|o.Xbe in|
|00003fb0| 76 6f 6b 65 64 20 6f 6e | 20 74 68 65 20 6f 75 74 |voked on| the out|
|00003fc0| 70 75 74 20 6f 66 20 74 | 68 65 20 66 69 6c 74 65 |put of t|he filte|
|00003fd0| 72 20 63 6f 6d 6d 61 6e | 64 20 73 70 65 63 69 66 |r comman|d specif|
|00003fe0| 69 65 64 20 61 73 20 74 | 68 65 0a 58 74 68 69 72 |ied as t|he.Xthir|
|00003ff0| 64 20 63 6f 6d 70 6f 6e | 65 6e 74 20 6f 66 20 74 |d compon|ent of t|
|00004000| 68 65 20 40 63 6f 64 65 | 7b 2d 53 7d 20 6f 70 74 |he @code|{-S} opt|
|00004010| 69 6f 6e 2e 0a 58 0a 58 | 54 68 65 20 66 69 6c 74 |ion..X.X|The filt|
|00004020| 65 72 20 69 73 20 61 6e | 20 61 72 62 69 74 72 61 |er is an| arbitra|
|00004030| 72 79 20 73 68 65 6c 6c | 20 63 6f 6d 6d 61 6e 64 |ry shell| command|
|00004040| 2e 20 53 6f 6d 65 77 68 | 65 72 65 20 69 6e 20 74 |. Somewh|ere in t|
|00004050| 68 65 20 66 69 6c 74 65 | 72 20 73 74 72 69 6e 67 |he filte|r string|
|00004060| 2c 0a 58 61 20 40 63 6f | 64 65 7b 25 73 7d 20 73 |,.Xa @co|de{%s} s|
|00004070| 68 6f 75 6c 64 20 6f 63 | 63 75 72 2e 20 54 68 69 |hould oc|cur. Thi|
|00004080| 73 20 40 63 6f 64 65 7b | 25 73 7d 20 69 73 20 72 |s @code{|%s} is r|
|00004090| 65 70 6c 61 63 65 64 20 | 62 79 20 74 68 65 20 6e |eplaced |by the n|
|000040a0| 61 6d 65 20 6f 66 20 74 | 68 65 0a 58 73 6f 75 72 |ame of t|he.Xsour|
|000040b0| 63 65 20 66 69 6c 65 20 | 62 65 69 6e 67 20 73 63 |ce file |being sc|
|000040c0| 61 6e 6e 65 64 2c 20 74 | 68 65 20 73 68 65 6c 6c |anned, t|he shell|
|000040d0| 20 63 6f 6d 6d 61 6e 64 | 20 69 73 20 69 6e 76 6f | command| is invo|
|000040e0| 6b 65 64 2c 20 61 6e 64 | 20 77 68 61 74 65 76 65 |ked, and| whateve|
|000040f0| 72 0a 58 63 6f 6d 65 73 | 20 6f 75 74 20 6f 6e 20 |r.Xcomes| out on |
|00004100| 40 76 61 72 7b 73 74 64 | 6f 75 74 7d 20 69 73 20 |@var{std|out} is |
|00004110| 73 63 61 6e 6e 65 64 20 | 75 73 69 6e 67 20 74 68 |scanned |using th|
|00004120| 65 20 62 75 69 6c 74 69 | 6e 20 73 63 61 6e 6e 65 |e builti|n scanne|
|00004130| 72 2e 0a 58 0a 58 46 6f | 72 20 65 78 61 6d 70 6c |r..X.XFo|r exampl|
|00004140| 65 2c 20 6e 6f 20 73 63 | 61 6e 6e 65 72 20 69 73 |e, no sc|anner is|
|00004150| 20 70 72 6f 76 69 64 65 | 64 20 66 6f 72 20 74 65 | provide|d for te|
|00004160| 78 69 6e 66 6f 20 66 69 | 6c 65 73 20 28 6c 69 6b |xinfo fi|les (lik|
|00004170| 65 20 74 68 69 73 20 6f | 6e 65 29 2e 0a 58 49 66 |e this o|ne)..XIf|
|00004180| 20 49 20 77 69 73 68 65 | 64 20 74 6f 20 69 6e 64 | I wishe|d to ind|
|00004190| 65 78 20 74 68 65 20 63 | 6f 6e 74 65 6e 74 73 20 |ex the c|ontents |
|000041a0| 6f 66 20 74 68 69 73 20 | 66 69 6c 65 2c 20 62 75 |of this |file, bu|
|000041b0| 74 20 61 76 6f 69 64 20 | 69 6e 64 65 78 69 6e 67 |t avoid |indexing|
|000041c0| 20 74 68 65 0a 58 74 65 | 78 69 6e 66 6f 20 64 69 | the.Xte|xinfo di|
|000041d0| 72 65 63 74 69 76 65 73 | 2c 20 49 20 77 6f 75 6c |rectives|, I woul|
|000041e0| 64 20 6e 65 65 64 20 61 | 20 66 69 6c 74 65 72 20 |d need a| filter |
|000041f0| 74 68 61 74 20 73 74 72 | 69 70 70 65 64 20 6f 75 |that str|ipped ou|
|00004200| 74 20 74 68 65 20 74 65 | 78 69 6e 66 6f 0a 58 64 |t the te|xinfo.Xd|
|00004210| 69 72 65 63 74 69 76 65 | 73 2c 20 62 75 74 20 6c |irective|s, but l|
|00004220| 65 66 74 20 74 68 65 20 | 72 65 6d 61 69 6e 64 65 |eft the |remainde|
|00004230| 72 20 6f 66 20 74 68 65 | 20 66 69 6c 65 20 69 6e |r of the| file in|
|00004240| 74 61 63 74 2e 20 49 20 | 63 6f 75 6c 64 20 74 68 |tact. I |could th|
|00004250| 65 6e 20 75 73 65 0a 58 | 74 68 65 20 70 6c 61 69 |en use.X|the plai|
|00004260| 6e 20 74 65 78 74 20 73 | 63 61 6e 6e 65 72 20 6f |n text s|canner o|
|00004270| 6e 20 74 68 65 20 72 65 | 6d 61 69 6e 64 65 72 2e |n the re|mainder.|
|00004280| 20 41 20 71 75 69 63 6b | 20 77 61 79 20 74 6f 20 | A quick| way to |
|00004290| 73 70 65 63 69 66 79 20 | 74 68 69 73 0a 58 6d 69 |specify |this.Xmi|
|000042a0| 67 68 74 20 62 65 3a 0a | 58 0a 58 40 65 78 61 6d |ght be:.|X.X@exam|
|000042b0| 70 6c 65 0a 58 27 2d 53 | 2f 74 65 78 69 6e 66 6f |ple.X'-S|/texinfo|
|000042c0| 2f 74 65 78 74 2f 73 65 | 64 20 73 2c 40 40 5b 61 |/text/se|d s,@@[a|
|000042d0| 2d 7a 5d 2a 2c 2c 67 20 | 3c 20 25 73 27 0a 58 40 |-z]*,,g |< %s'.X@|
|000042e0| 65 6e 64 20 65 78 61 6d | 70 6c 65 0a 58 0a 58 54 |end exam|ple.X.XT|
|000042f0| 68 69 73 20 64 65 66 69 | 6e 65 73 20 61 20 6e 65 |his defi|nes a ne|
|00004300| 77 20 6c 61 6e 67 75 61 | 67 65 20 73 63 61 6e 6e |w langua|ge scann|
|00004310| 65 72 20 28 40 76 61 72 | 7b 74 65 78 69 6e 66 6f |er (@var|{texinfo|
|00004320| 7d 29 20 64 65 66 69 6e | 65 64 20 69 6e 20 74 65 |}) defin|ed in te|
|00004330| 72 6d 73 20 6f 66 0a 58 | 61 20 40 63 6f 64 65 7b |rms of.X|a @code{|
|00004340| 73 65 64 7d 20 63 6f 6d | 6d 61 6e 64 20 74 6f 20 |sed} com|mand to |
|00004350| 73 74 72 69 70 20 6f 75 | 74 20 74 65 78 69 6e 66 |strip ou|t texinf|
|00004360| 6f 20 64 69 72 65 63 74 | 69 76 65 73 20 28 61 74 |o direct|ives (at|
|00004370| 20 73 69 67 6e 73 20 66 | 6f 6c 6c 6f 77 65 64 0a | signs f|ollowed.|
|00004380| 58 62 79 20 6c 65 74 74 | 65 72 73 29 2e 20 4f 6e |Xby lett|ers). On|
|00004390| 63 65 20 74 68 65 20 64 | 69 72 65 63 74 69 76 65 |ce the d|irective|
|000043a0| 73 20 61 72 65 20 73 74 | 72 69 70 70 65 64 2c 20 |s are st|ripped, |
|000043b0| 74 68 65 20 72 65 6d 61 | 69 6e 69 6e 67 20 74 65 |the rema|ining te|
|000043c0| 78 74 20 69 73 20 72 75 | 6e 0a 58 74 68 72 6f 75 |xt is ru|n.Xthrou|
|000043d0| 67 68 20 74 68 65 20 70 | 6c 61 69 6e 20 74 65 78 |gh the p|lain tex|
|000043e0| 74 20 73 63 61 6e 6e 65 | 72 2e 0a 58 0a 58 54 68 |t scanne|r..X.XTh|
|000043f0| 69 73 20 69 73 20 6a 75 | 73 74 20 61 6e 20 65 78 |is is ju|st an ex|
|00004400| 61 6d 70 6c 65 2c 20 74 | 6f 20 64 6f 20 61 20 62 |ample, t|o do a b|
|00004410| 65 74 74 65 72 20 6a 6f | 62 20 49 20 77 6f 75 6c |etter jo|b I woul|
|00004420| 64 20 61 63 74 75 61 6c | 6c 79 20 6e 65 65 64 20 |d actual|ly need |
|00004430| 74 6f 0a 58 64 65 6c 65 | 74 65 20 73 6f 6d 65 20 |to.Xdele|te some |
|00004440| 6c 69 6e 65 73 20 28 73 | 75 63 68 20 61 73 20 74 |lines (s|uch as t|
|00004450| 68 6f 73 65 20 62 65 67 | 69 6e 6e 69 6e 67 20 77 |hose beg|inning w|
|00004460| 69 74 68 20 40 63 6f 64 | 65 7b 40 40 65 6e 64 7d |ith @cod|e{@@end}|
|00004470| 29 20 61 73 20 77 65 6c | 6c 0a 58 61 73 20 64 65 |) as wel|l.Xas de|
|00004480| 6c 65 74 69 6e 67 20 74 | 68 65 20 40 63 6f 64 65 |leting t|he @code|
|00004490| 7b 40 40 7d 20 64 69 72 | 65 63 74 69 76 65 73 20 |{@@} dir|ectives |
|000044a0| 65 6d 62 65 64 64 65 64 | 20 69 6e 20 74 68 65 20 |embedded| in the |
|000044b0| 74 65 78 74 2e 0a 58 0a | 58 40 6e 6f 64 65 20 4d |text..X.|X@node M|
|000044c0| 6b 69 64 20 45 78 61 6d | 70 6c 65 73 2c 20 20 2c |kid Exam|ples, ,|
|000044d0| 20 41 64 64 69 6e 67 20 | 59 6f 75 72 20 4f 77 6e | Adding |Your Own|
|000044e0| 20 53 63 61 6e 6e 65 72 | 2c 20 4d 6b 69 64 0a 58 | Scanner|, Mkid.X|
|000044f0| 40 73 65 63 74 69 6f 6e | 20 4d 6b 69 64 20 45 78 |@section| Mkid Ex|
|00004500| 61 6d 70 6c 65 73 0a 58 | 0a 58 54 68 65 20 73 69 |amples.X|.XThe si|
|00004510| 6d 70 6c 65 73 74 20 65 | 78 61 6d 70 6c 65 20 6f |mplest e|xample o|
|00004520| 66 20 40 63 6f 64 65 7b | 6d 6b 69 64 7d 20 69 73 |f @code{|mkid} is|
|00004530| 20 73 6f 6d 65 74 68 69 | 6e 67 20 6c 69 6b 65 3a | somethi|ng like:|
|00004540| 0a 58 0a 58 40 65 78 61 | 6d 70 6c 65 0a 58 6d 6b |.X.X@exa|mple.Xmk|
|00004550| 69 64 20 2a 2e 5b 63 68 | 79 5d 0a 58 40 65 6e 64 |id *.[ch|y].X@end|
|00004560| 20 65 78 61 6d 70 6c 65 | 0a 58 0a 58 54 68 69 73 | example|.X.XThis|
|00004570| 20 77 69 6c 6c 20 62 75 | 69 6c 64 20 61 6e 20 49 | will bu|ild an I|
|00004580| 44 20 64 61 74 61 62 61 | 73 65 20 69 6e 64 65 78 |D databa|se index|
|00004590| 69 6e 67 20 61 6c 6c 20 | 74 68 65 0a 58 69 64 65 |ing all |the.Xide|
|000045a0| 6e 74 69 66 69 65 72 73 | 20 61 6e 64 20 6e 75 6d |ntifiers| and num|
|000045b0| 62 65 72 73 20 69 6e 20 | 74 68 65 20 40 66 69 6c |bers in |the @fil|
|000045c0| 65 7b 2e 63 7d 2c 20 40 | 66 69 6c 65 7b 2e 68 7d |e{.c}, @|file{.h}|
|000045d0| 2c 20 61 6e 64 20 40 66 | 69 6c 65 7b 2e 79 7d 20 |, and @f|ile{.y} |
|000045e0| 66 69 6c 65 73 0a 58 69 | 6e 20 74 68 65 20 63 75 |files.Xi|n the cu|
|000045f0| 72 72 65 6e 74 20 64 69 | 72 65 63 74 6f 72 79 2e |rrent di|rectory.|
|00004600| 20 42 65 63 61 75 73 65 | 20 74 68 6f 73 65 20 73 | Because| those s|
|00004610| 75 66 66 69 78 65 73 20 | 61 72 65 20 61 6c 72 65 |uffixes |are alre|
|00004620| 61 64 79 20 6b 6e 6f 77 | 6e 20 74 6f 0a 58 40 63 |ady know|n to.X@c|
|00004630| 6f 64 65 7b 6d 6b 69 64 | 7d 20 61 73 20 43 20 6c |ode{mkid|} as C l|
|00004640| 61 6e 67 75 61 67 65 20 | 66 69 6c 65 73 2c 20 6e |anguage |files, n|
|00004650| 6f 20 6f 74 68 65 72 20 | 73 70 65 63 69 61 6c 20 |o other |special |
|00004660| 61 72 67 75 6d 65 6e 74 | 73 20 61 72 65 20 72 65 |argument|s are re|
|00004670| 71 75 69 72 65 64 2e 0a | 58 0a 58 46 72 6f 6d 20 |quired..|X.XFrom |
|00004680| 61 20 73 69 6d 70 6c 65 | 20 65 78 61 6d 70 6c 65 |a simple| example|
|00004690| 2c 20 6c 65 74 73 20 67 | 6f 20 74 6f 20 61 20 6d |, lets g|o to a m|
|000046a0| 6f 72 65 20 63 6f 6d 70 | 6c 65 78 20 6f 6e 65 2e |ore comp|lex one.|
|000046b0| 20 53 75 70 70 6f 73 65 | 20 79 6f 75 20 77 61 6e | Suppose| you wan|
|000046c0| 74 0a 58 74 6f 20 62 75 | 69 6c 64 20 61 20 64 61 |t.Xto bu|ild a da|
|000046d0| 74 61 62 61 73 65 20 69 | 6e 64 65 78 69 6e 67 20 |tabase i|ndexing |
|000046e0| 74 68 65 20 63 6f 6e 74 | 65 6e 74 73 20 6f 66 20 |the cont|ents of |
|000046f0| 61 6c 6c 20 74 68 65 20 | 40 76 61 72 7b 6d 61 6e |all the |@var{man|
|00004700| 7d 20 70 61 67 65 73 2e | 0a 58 53 69 6e 63 65 20 |} pages.|.XSince |
|00004710| 40 63 6f 64 65 7b 6d 6b | 69 64 7d 20 61 6c 72 65 |@code{mk|id} alre|
|00004720| 61 64 79 20 6b 6e 6f 77 | 73 20 68 6f 77 20 74 6f |ady know|s how to|
|00004730| 20 64 65 61 6c 20 77 69 | 74 68 20 40 66 69 6c 65 | deal wi|th @file|
|00004740| 7b 2e 7a 7d 20 66 69 6c | 65 73 2c 20 6c 65 74 27 |{.z} fil|es, let'|
|00004750| 73 0a 58 61 73 73 75 6d | 65 20 79 6f 75 72 20 73 |s.Xassum|e your s|
|00004760| 79 73 74 65 6d 20 69 73 | 20 75 73 69 6e 67 20 74 |ystem is| using t|
|00004770| 68 65 20 40 63 6f 64 65 | 7b 63 6f 6d 70 72 65 73 |he @code|{compres|
|00004780| 73 7d 20 70 72 6f 67 72 | 61 6d 20 74 6f 20 73 74 |s} progr|am to st|
|00004790| 6f 72 65 0a 58 63 6f 6d | 70 72 65 73 73 65 64 20 |ore.Xcom|pressed |
|000047a0| 63 61 74 74 61 62 6c 65 | 20 76 65 72 73 69 6f 6e |cattable| version|
|000047b0| 73 20 6f 66 20 74 68 65 | 20 40 76 61 72 7b 6d 61 |s of the| @var{ma|
|000047c0| 6e 7d 20 70 61 67 65 73 | 2e 20 20 54 68 65 0a 58 |n} pages|. The.X|
|000047d0| 40 63 6f 64 65 7b 63 6f | 6d 70 72 65 73 73 7d 20 |@code{co|mpress} |
|000047e0| 70 72 6f 67 72 61 6d 20 | 63 72 65 61 74 65 73 20 |program |creates |
|000047f0| 66 69 6c 65 73 20 77 69 | 74 68 20 61 20 40 63 6f |files wi|th a @co|
|00004800| 64 65 7b 2e 5a 7d 20 73 | 75 66 66 69 78 2c 20 73 |de{.Z} s|uffix, s|
|00004810| 6f 0a 58 40 63 6f 64 65 | 7b 6d 6b 69 64 7d 20 77 |o.X@code|{mkid} w|
|00004820| 69 6c 6c 20 68 61 76 65 | 20 74 6f 20 62 65 20 74 |ill have| to be t|
|00004830| 6f 6c 64 20 68 6f 77 20 | 74 6f 20 73 63 61 6e 20 |old how |to scan |
|00004840| 40 66 69 6c 65 7b 2e 5a | 7d 20 66 69 6c 65 73 2e |@file{.Z|} files.|
|00004850| 20 54 68 65 0a 58 66 6f | 6c 6c 6f 77 69 6e 67 20 | The.Xfo|llowing |
|00004860| 63 6f 64 65 20 73 68 6f | 77 73 20 68 6f 77 20 74 |code sho|ws how t|
|00004870| 6f 20 63 6f 6d 62 69 6e | 65 20 74 68 65 20 40 63 |o combin|e the @c|
|00004880| 6f 64 65 7b 66 69 6e 64 | 7d 20 63 6f 6d 6d 61 6e |ode{find|} comman|
|00004890| 64 20 77 69 74 68 20 74 | 68 65 0a 58 73 70 65 63 |d with t|he.Xspec|
|000048a0| 69 61 6c 20 73 63 61 6e | 6e 65 72 20 61 72 67 75 |ial scan|ner argu|
|000048b0| 6d 65 6e 74 73 20 74 6f | 20 40 63 6f 64 65 7b 6d |ments to| @code{m|
|000048c0| 6b 69 64 7d 20 74 6f 20 | 67 65 6e 65 72 61 74 65 |kid} to |generate|
|000048d0| 20 74 68 65 20 72 65 71 | 75 69 72 65 64 20 49 44 | the req|uired ID|
|000048e0| 0a 58 64 61 74 61 62 61 | 73 65 3a 0a 58 0a 58 40 |.Xdataba|se:.X.X@|
|000048f0| 65 78 61 6d 70 6c 65 0a | 58 63 64 20 2f 75 73 72 |example.|Xcd /usr|
|00004900| 2f 63 61 74 6d 61 6e 0a | 58 66 69 6e 64 20 2e 20 |/catman.|Xfind . |
|00004910| 2d 6e 61 6d 65 20 27 2a | 2e 5a 27 20 2d 70 72 69 |-name '*|.Z' -pri|
|00004920| 6e 74 20 7c 20 6d 6b 69 | 64 20 27 2d 53 6d 61 6e |nt | mki|d '-Sman|
|00004930| 2f 74 65 78 74 2f 75 6e | 63 6f 6d 70 72 65 73 73 |/text/un|compress|
|00004940| 20 2d 63 20 3c 20 25 73 | 27 20 2d 53 2e 5a 3d 6d | -c < %s|' -S.Z=m|
|00004950| 61 6e 20 2d 0a 58 40 65 | 6e 64 20 65 78 61 6d 70 |an -.X@e|nd examp|
|00004960| 6c 65 0a 58 0a 58 54 68 | 69 73 20 65 78 61 6d 70 |le.X.XTh|is examp|
|00004970| 6c 65 20 66 69 72 73 74 | 20 73 77 69 74 63 68 65 |le first| switche|
|00004980| 73 20 74 6f 20 74 68 65 | 20 40 66 69 6c 65 7b 2f |s to the| @file{/|
|00004990| 75 73 72 2f 63 61 74 6d | 61 6e 7d 20 64 69 72 65 |usr/catm|an} dire|
|000049a0| 63 74 6f 72 79 20 77 68 | 65 72 65 0a 58 74 68 65 |ctory wh|ere.Xthe|
|000049b0| 20 63 6f 6d 70 72 65 73 | 73 65 64 20 40 76 61 72 | compres|sed @var|
|000049c0| 7b 6d 61 6e 7d 20 70 61 | 67 65 73 20 61 72 65 20 |{man} pa|ges are |
|000049d0| 73 74 6f 72 65 64 2e 20 | 54 68 65 20 40 63 6f 64 |stored. |The @cod|
|000049e0| 65 7b 66 69 6e 64 7d 20 | 63 6f 6d 6d 61 6e 64 20 |e{find} |command |
|000049f0| 74 68 65 6e 0a 58 66 69 | 6e 64 73 20 61 6c 6c 20 |then.Xfi|nds all |
|00004a00| 74 68 65 20 40 66 69 6c | 65 7b 2e 5a 7d 20 66 69 |the @fil|e{.Z} fi|
|00004a10| 6c 65 73 20 75 6e 64 65 | 72 20 74 68 61 74 20 64 |les unde|r that d|
|00004a20| 69 72 65 63 74 6f 72 79 | 20 61 6e 64 20 70 72 69 |irectory| and pri|
|00004a30| 6e 74 73 20 74 68 65 69 | 72 0a 58 6e 61 6d 65 73 |nts thei|r.Xnames|
|00004a40| 2e 20 20 54 68 69 73 20 | 6c 69 73 74 20 69 73 20 |. This |list is |
|00004a50| 70 69 70 65 64 20 69 6e | 74 6f 20 74 68 65 20 40 |piped in|to the @|
|00004a60| 63 6f 64 65 7b 6d 6b 69 | 64 7d 20 70 72 6f 67 72 |code{mki|d} progr|
|00004a70| 61 6d 2e 20 54 68 65 20 | 40 63 6f 64 65 7b 2d 7d |am. The |@code{-}|
|00004a80| 0a 58 61 72 67 75 6d 65 | 6e 74 20 62 79 20 69 74 |.Xargume|nt by it|
|00004a90| 73 65 6c 66 20 28 61 74 | 20 74 68 65 20 65 6e 64 |self (at| the end|
|00004aa0| 20 6f 66 20 74 68 65 20 | 6c 69 6e 65 29 20 74 65 | of the |line) te|
|00004ab0| 6c 6c 73 20 40 63 6f 64 | 65 7b 6d 6b 69 64 7d 20 |lls @cod|e{mkid} |
|00004ac0| 74 6f 20 72 65 61 64 0a | 58 61 72 67 75 6d 65 6e |to read.|Xargumen|
|00004ad0| 74 73 20 28 69 6e 20 74 | 68 69 73 20 63 61 73 65 |ts (in t|his case|
|00004ae0| 20 74 68 65 20 6c 69 73 | 74 20 6f 66 20 66 69 6c | the lis|t of fil|
|00004af0| 65 20 6e 61 6d 65 73 29 | 20 66 72 6f 6d 20 40 76 |e names)| from @v|
|00004b00| 61 72 7b 73 74 64 69 6e | 7d 2e 20 54 68 65 0a 58 |ar{stdin|}. The.X|
|00004b10| 66 69 72 73 74 20 40 63 | 6f 64 65 7b 2d 53 7d 20 |first @c|ode{-S} |
|00004b20| 61 72 67 75 6d 65 6e 74 | 20 64 65 66 69 6e 65 73 |argument| defines|
|00004b30| 20 61 20 6e 65 77 20 6c | 61 6e 67 75 61 67 65 20 | a new l|anguage |
|00004b40| 28 40 76 61 72 7b 6d 61 | 6e 7d 29 20 69 6e 20 74 |(@var{ma|n}) in t|
|00004b50| 65 72 6d 73 20 6f 66 0a | 58 74 68 65 20 40 63 6f |erms of.|Xthe @co|
|00004b60| 64 65 7b 75 6e 63 6f 6d | 70 72 65 73 73 7d 20 75 |de{uncom|press} u|
|00004b70| 74 69 6c 69 74 79 20 61 | 6e 64 20 74 68 65 20 65 |tility a|nd the e|
|00004b80| 78 69 73 74 69 6e 67 20 | 74 65 78 74 20 73 63 61 |xisting |text sca|
|00004b90| 6e 6e 65 72 2e 20 54 68 | 65 20 73 65 63 6f 6e 64 |nner. Th|e second|
|00004ba0| 0a 58 40 63 6f 64 65 7b | 2d 53 7d 20 61 72 67 75 |.X@code{|-S} argu|
|00004bb0| 6d 65 6e 74 20 74 65 6c | 6c 73 20 40 63 6f 64 65 |ment tel|ls @code|
|00004bc0| 7b 6d 6b 69 64 7d 20 74 | 6f 20 74 72 65 61 74 20 |{mkid} t|o treat |
|00004bd0| 61 6c 6c 20 40 66 69 6c | 65 7b 2e 5a 7d 20 66 69 |all @fil|e{.Z} fi|
|00004be0| 6c 65 73 20 61 73 0a 58 | 6c 61 6e 67 75 61 67 65 |les as.X|language|
|00004bf0| 20 40 76 61 72 7b 6d 61 | 6e 7d 2e 20 49 6e 20 70 | @var{ma|n}. In p|
|00004c00| 72 61 63 74 69 63 65 2c | 20 79 6f 75 20 6d 69 67 |ractice,| you mig|
|00004c10| 68 74 20 66 69 6e 64 20 | 74 68 65 20 40 63 6f 64 |ht find |the @cod|
|00004c20| 65 7b 6d 6b 69 64 7d 0a | 58 61 72 67 75 6d 65 6e |e{mkid}.|Xargumen|
|00004c30| 74 73 20 6e 65 65 64 20 | 74 6f 20 62 65 20 65 76 |ts need |to be ev|
|00004c40| 65 6e 20 6d 6f 72 65 20 | 63 6f 6d 70 6c 65 78 2c |en more |complex,|
|00004c50| 20 73 6f 6d 65 74 68 69 | 6e 67 20 6c 69 6b 65 3a | somethi|ng like:|
|00004c60| 0a 58 0a 58 40 65 78 61 | 6d 70 6c 65 0a 58 6d 6b |.X.X@exa|mple.Xmk|
|00004c70| 69 64 20 27 2d 53 6d 61 | 6e 2f 74 65 78 74 2f 75 |id '-Sma|n/text/u|
|00004c80| 6e 63 6f 6d 70 72 65 73 | 73 20 2d 63 20 3c 20 25 |ncompres|s -c < %|
|00004c90| 73 20 7c 20 63 6f 6c 20 | 2d 62 27 20 2d 53 2e 5a |s | col |-b' -S.Z|
|00004ca0| 3d 6d 61 6e 20 2d 0a 58 | 40 65 6e 64 20 65 78 61 |=man -.X|@end exa|
|00004cb0| 6d 70 6c 65 0a 58 0a 58 | 54 68 69 73 20 77 69 6c |mple.X.X|This wil|
|00004cc0| 6c 20 74 61 6b 65 20 74 | 68 65 20 61 64 64 69 74 |l take t|he addit|
|00004cd0| 69 6f 6e 61 6c 20 73 74 | 65 70 20 6f 66 20 67 65 |ional st|ep of ge|
|00004ce0| 74 74 69 6e 67 20 72 69 | 64 20 6f 66 20 61 6e 79 |tting ri|d of any|
|00004cf0| 20 75 6e 64 65 72 6c 69 | 6e 69 6e 67 20 61 6e 64 | underli|ning and|
|00004d00| 0a 58 62 61 63 6b 73 70 | 61 63 69 6e 67 20 77 68 |.Xbacksp|acing wh|
|00004d10| 69 63 68 20 6d 69 67 68 | 74 20 62 65 20 70 72 65 |ich migh|t be pre|
|00004d20| 73 65 6e 74 20 69 6e 20 | 74 68 65 20 63 6f 6d 70 |sent in |the comp|
|00004d30| 72 65 73 73 65 64 20 40 | 76 61 72 7b 6d 61 6e 7d |ressed @|var{man}|
|00004d40| 20 70 61 67 65 73 2e 0a | 58 0a 58 40 6e 6f 64 65 | pages..|X.X@node|
|00004d50| 20 44 61 74 61 62 61 73 | 65 20 51 75 65 72 79 20 | Databas|e Query |
|00004d60| 54 6f 6f 6c 73 2c 20 49 | 69 64 2c 20 4d 6b 69 64 |Tools, I|id, Mkid|
|00004d70| 2c 20 54 6f 70 0a 58 40 | 63 68 61 70 74 65 72 20 |, Top.X@|chapter |
|00004d80| 44 61 74 61 62 61 73 65 | 20 51 75 65 72 79 20 54 |Database| Query T|
|00004d90| 6f 6f 6c 73 0a 58 0a 58 | 54 68 65 20 49 44 20 64 |ools.X.X|The ID d|
|00004da0| 61 74 61 62 61 73 65 20 | 69 73 20 75 73 65 6c 65 |atabase |is usele|
|00004db0| 73 73 20 77 69 74 68 6f | 75 74 20 64 61 74 61 62 |ss witho|ut datab|
|00004dc0| 61 73 65 20 71 75 65 72 | 79 20 74 6f 6f 6c 73 2e |ase quer|y tools.|
|00004dd0| 20 54 68 65 20 72 65 6d | 61 69 6e 64 65 72 0a 58 | The rem|ainder.X|
|00004de0| 6f 66 20 74 68 69 73 20 | 64 6f 63 75 6d 65 6e 74 |of this |document|
|00004df0| 20 64 65 73 63 72 69 62 | 65 73 20 74 68 6f 73 65 | describ|es those|
|00004e00| 20 74 6f 6f 6c 73 2e 0a | 58 0a 58 54 68 65 20 40 | tools..|X.XThe @|
|00004e10| 63 6f 64 65 7b 6c 69 64 | 7d 2c 20 40 63 6f 64 65 |code{lid|}, @code|
|00004e20| 7b 67 69 64 7d 2c 0a 58 | 40 63 6f 64 65 7b 61 69 |{gid},.X|@code{ai|
|00004e30| 64 7d 2c 20 40 63 6f 64 | 65 7b 65 69 64 7d 2c 20 |d}, @cod|e{eid}, |
|00004e40| 61 6e 64 20 40 63 6f 64 | 65 7b 70 69 64 7d 20 70 |and @cod|e{pid} p|
|00004e50| 72 6f 67 72 61 6d 73 20 | 61 72 65 20 61 6c 6c 20 |rograms |are all |
|00004e60| 74 68 65 20 73 61 6d 65 | 20 70 72 6f 67 72 61 6d |the same| program|
|00004e70| 0a 58 69 6e 73 74 61 6c | 6c 65 64 20 77 69 74 68 |.Xinstal|led with|
|00004e80| 20 6c 69 6e 6b 73 20 74 | 6f 20 64 69 66 66 65 72 | links t|o differ|
|00004e90| 65 6e 74 20 6e 61 6d 65 | 73 2e 20 54 68 65 20 6e |ent name|s. The n|
|00004ea0| 61 6d 65 20 75 73 65 64 | 20 74 6f 20 69 6e 76 6f |ame used| to invo|
|00004eb0| 6b 65 20 74 68 65 0a 58 | 70 72 6f 67 72 61 6d 20 |ke the.X|program |
|00004ec0| 64 65 74 65 72 6d 69 6e | 65 73 20 68 6f 77 20 69 |determin|es how i|
|00004ed0| 74 20 77 69 6c 6c 20 61 | 63 74 2e 0a 58 0a 58 54 |t will a|ct..X.XT|
|00004ee0| 68 65 20 40 63 6f 64 65 | 7b 69 69 64 7d 20 70 72 |he @code|{iid} pr|
|00004ef0| 6f 67 72 61 6d 20 69 73 | 20 61 6e 20 69 6e 74 65 |ogram is| an inte|
|00004f00| 72 61 63 74 69 76 65 20 | 71 75 65 72 79 20 73 68 |ractive |query sh|
|00004f10| 65 6c 6c 20 74 68 61 74 | 20 73 69 74 73 20 6f 6e |ell that| sits on|
|00004f20| 20 74 6f 70 0a 58 6f 66 | 20 74 68 65 20 6f 74 68 | top.Xof| the oth|
|00004f30| 65 72 20 71 75 65 72 79 | 20 74 6f 6f 6c 73 2e 0a |er query| tools..|
|00004f40| 58 0a 58 40 6d 65 6e 75 | 0a 58 2a 20 43 6f 6d 6d |X.X@menu|.X* Comm|
|00004f50| 6f 6e 20 4f 70 74 69 6f | 6e 73 3a 3a 20 20 20 20 |on Optio|ns:: |
|00004f60| 20 20 20 20 20 20 20 20 | 20 20 43 6f 6d 6d 6f 6e | | Common|
|00004f70| 20 63 6f 6d 6d 61 6e 64 | 20 6c 69 6e 65 20 6f 70 | command| line op|
|00004f80| 74 69 6f 6e 73 0a 58 2a | 20 50 61 74 74 65 72 6e |tions.X*| Pattern|
|00004f90| 73 3a 3a 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |s:: | |
|00004fa0| 20 20 20 20 20 20 20 49 | 64 65 6e 74 69 66 69 65 | I|dentifie|
|00004fb0| 72 20 70 61 74 74 65 72 | 6e 20 6d 61 74 63 68 69 |r patter|n matchi|
|00004fc0| 6e 67 0a 58 2a 20 4c 69 | 64 3a 3a 20 20 20 20 20 |ng.X* Li|d:: |
|00004fd0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00004fe0| 20 20 20 20 4c 6f 6f 6b | 20 75 70 20 69 64 65 6e | Look| up iden|
|00004ff0| 74 69 66 69 65 72 73 0a | 58 2a 20 41 69 64 3a 3a |tifiers.|X* Aid::|
|00005000| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00005010| 20 20 20 20 20 20 20 20 | 20 43 61 73 65 20 69 6e | | Case in|
|00005020| 73 65 6e 73 69 74 69 76 | 65 20 6c 69 64 0a 58 2a |sensitiv|e lid.X*|
|00005030| 20 47 69 64 3a 3a 20 20 | 20 20 20 20 20 20 20 20 | Gid:: | |
|00005040| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 47 | | G|
|00005050| 72 65 70 20 66 6f 72 20 | 69 64 65 6e 74 69 66 69 |rep for |identifi|
|00005060| 65 72 73 0a 58 2a 20 45 | 69 64 3a 3a 20 20 20 20 |ers.X* E|id:: |
|00005070| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00005080| 20 20 20 20 20 45 64 69 | 74 20 66 69 6c 65 73 20 | Edi|t files |
|00005090| 77 69 74 68 20 6d 61 74 | 63 68 69 6e 67 20 69 64 |with mat|ching id|
|000050a0| 65 6e 74 69 66 69 65 72 | 73 0a 58 2a 20 50 69 64 |entifier|s.X* Pid|
|000050b0| 3a 3a 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |:: | |
|000050c0| 20 20 20 20 20 20 20 20 | 20 20 20 4c 6f 6f 6b 20 | | Look |
|000050d0| 75 70 20 70 61 74 68 20 | 6e 61 6d 65 73 20 69 6e |up path |names in|
|000050e0| 20 64 61 74 61 62 61 73 | 65 0a 58 40 65 6e 64 20 | databas|e.X@end |
|000050f0| 6d 65 6e 75 0a 58 0a 58 | 40 6e 6f 64 65 20 43 6f |menu.X.X|@node Co|
|00005100| 6d 6d 6f 6e 20 4f 70 74 | 69 6f 6e 73 2c 20 50 61 |mmon Opt|ions, Pa|
|00005110| 74 74 65 72 6e 73 2c 20 | 44 61 74 61 62 61 73 65 |tterns, |Database|
|00005120| 20 51 75 65 72 79 20 54 | 6f 6f 6c 73 2c 20 44 61 | Query T|ools, Da|
|00005130| 74 61 62 61 73 65 20 51 | 75 65 72 79 20 54 6f 6f |tabase Q|uery Too|
|00005140| 6c 73 0a 58 40 73 65 63 | 74 69 6f 6e 20 43 6f 6d |ls.X@sec|tion Com|
|00005150| 6d 6f 6e 20 4f 70 74 69 | 6f 6e 73 0a 58 0a 58 53 |mon Opti|ons.X.XS|
|00005160| 69 6e 63 65 20 6d 61 6e | 79 20 6f 66 20 74 68 65 |ince man|y of the|
|00005170| 20 70 72 6f 67 72 61 6d | 73 20 61 72 65 20 72 65 | program|s are re|
|00005180| 61 6c 6c 79 20 6c 69 6e | 6b 73 20 74 6f 20 6f 6e |ally lin|ks to on|
|00005190| 65 20 63 6f 6d 6d 6f 6e | 20 70 72 6f 67 72 61 6d |e common| program|
|000051a0| 2c 20 69 74 0a 58 69 73 | 20 6f 6e 6c 79 20 72 65 |, it.Xis| only re|
|000051b0| 61 73 6f 6e 61 62 6c 65 | 20 74 6f 20 65 78 70 65 |asonable| to expe|
|000051c0| 63 74 20 74 68 61 74 20 | 6d 6f 73 74 20 6f 66 20 |ct that |most of |
|000051d0| 74 68 65 20 71 75 65 72 | 79 20 74 6f 6f 6c 73 20 |the quer|y tools |
|000051e0| 77 6f 75 6c 64 20 73 68 | 61 72 65 0a 58 63 6f 6d |would sh|are.Xcom|
|000051f0| 6d 6f 6e 20 63 6f 6d 6d | 61 6e 64 20 6c 69 6e 65 |mon comm|and line|
|00005200| 20 6f 70 74 69 6f 6e 73 | 2e 20 4e 6f 74 20 61 6c | options|. Not al|
|00005210| 6c 20 6f 70 74 69 6f 6e | 73 20 6d 61 6b 65 20 73 |l option|s make s|
|00005220| 65 6e 73 65 20 66 6f 72 | 20 61 6c 6c 20 70 72 6f |ense for| all pro|
|00005230| 67 72 61 6d 73 2c 0a 58 | 62 75 74 20 74 68 65 79 |grams,.X|but they|
|00005240| 20 61 72 65 20 61 6c 6c | 20 64 65 73 63 72 69 62 | are all| describ|
|00005250| 65 64 20 68 65 72 65 2e | 20 54 68 65 20 64 65 73 |ed here.| The des|
|00005260| 63 72 69 70 74 69 6f 6e | 20 6f 66 20 65 61 63 68 |cription| of each|
|00005270| 20 70 72 6f 67 72 61 6d | 0a 58 67 69 76 65 73 20 | program|.Xgives |
|00005280| 74 68 65 20 6f 70 74 69 | 6f 6e 73 20 74 68 61 74 |the opti|ons that|
|00005290| 20 70 72 6f 67 72 61 6d | 20 75 73 65 73 2e 0a 58 | program| uses..X|
|000052a0| 0a 58 40 74 61 62 6c 65 | 20 40 63 6f 64 65 0a 58 |.X@table| @code.X|
|000052b0| 40 69 74 65 6d 20 2d 66 | 40 76 61 72 7b 3c 66 69 |@item -f|@var{<fi|
|000052c0| 6c 65 3e 7d 0a 58 52 65 | 61 64 20 74 68 65 20 64 |le>}.XRe|ad the d|
|000052d0| 61 74 61 62 61 73 65 20 | 73 70 65 63 69 66 69 65 |atabase |specifie|
|000052e0| 64 20 62 79 20 40 76 61 | 72 7b 3c 66 69 6c 65 3e |d by @va|r{<file>|
|000052f0| 7d 2e 20 4e 6f 72 6d 61 | 6c 6c 79 20 74 68 65 20 |}. Norma|lly the |
|00005300| 74 6f 6f 6c 73 20 6c 6f | 6f 6b 0a 58 66 6f 72 20 |tools lo|ok.Xfor |
|00005310| 61 20 66 69 6c 65 20 6e | 61 6d 65 64 20 40 66 69 |a file n|amed @fi|
|00005320| 6c 65 7b 49 44 7d 20 69 | 6e 20 65 69 74 68 65 72 |le{ID} i|n either|
|00005330| 20 74 68 65 20 63 75 72 | 72 65 6e 74 20 64 69 72 | the cur|rent dir|
|00005340| 65 63 74 6f 72 79 20 6f | 72 20 69 6e 20 61 6e 79 |ectory o|r in any|
|00005350| 0a 58 6f 66 20 74 68 65 | 20 64 69 72 65 63 74 6f |.Xof the| directo|
|00005360| 72 69 65 73 20 61 62 6f | 76 65 20 74 68 65 20 63 |ries abo|ve the c|
|00005370| 75 72 72 65 6e 74 20 64 | 69 72 65 63 74 6f 72 79 |urrent d|irectory|
|00005380| 2e 20 54 68 69 73 20 6d | 65 61 6e 73 20 79 6f 75 |. This m|eans you|
|00005390| 20 63 61 6e 20 6b 65 65 | 70 0a 58 61 20 67 6c 6f | can kee|p.Xa glo|
|000053a0| 62 61 6c 20 40 66 69 6c | 65 7b 49 44 7d 20 64 61 |bal @fil|e{ID} da|
|000053b0| 74 61 62 61 73 65 20 69 | 6e 20 74 68 65 20 72 6f |tabase i|n the ro|
|000053c0| 6f 74 20 6f 66 20 61 20 | 6c 61 72 67 65 20 73 6f |ot of a |large so|
|000053d0| 75 72 63 65 20 74 72 65 | 65 20 61 6e 64 20 75 73 |urce tre|e and us|
|000053e0| 65 0a 58 74 68 65 20 71 | 75 65 72 79 20 74 6f 6f |e.Xthe q|uery too|
|000053f0| 6c 73 20 66 72 6f 6d 20 | 61 6e 79 77 68 65 72 65 |ls from |anywhere|
|00005400| 20 77 69 74 68 69 6e 20 | 74 68 61 74 20 74 72 65 | within |that tre|
|00005410| 65 2e 0a 58 40 69 74 65 | 6d 20 2d 72 40 76 61 72 |e..X@ite|m -r@var|
|00005420| 7b 3c 64 69 72 65 63 74 | 6f 72 79 3e 7d 0a 58 54 |{<direct|ory>}.XT|
|00005430| 68 65 20 71 75 65 72 79 | 20 74 6f 6f 6c 73 20 75 |he query| tools u|
|00005440| 73 75 61 6c 6c 79 20 61 | 73 73 75 6d 65 20 74 68 |sually a|ssume th|
|00005450| 65 20 66 69 6c 65 20 6e | 61 6d 65 73 20 69 6e 20 |e file n|ames in |
|00005460| 74 68 65 20 64 61 74 61 | 62 61 73 65 20 61 72 65 |the data|base are|
|00005470| 20 72 65 6c 61 74 69 76 | 65 0a 58 74 6f 20 74 68 | relativ|e.Xto th|
|00005480| 65 20 64 69 72 65 63 74 | 6f 72 79 20 68 6f 6c 64 |e direct|ory hold|
|00005490| 69 6e 67 20 74 68 65 20 | 64 61 74 61 62 61 73 65 |ing the |database|
|000054a0| 2e 20 54 68 65 20 40 63 | 6f 64 65 7b 2d 72 7d 20 |. The @c|ode{-r} |
|000054b0| 6f 70 74 69 6f 6e 20 74 | 65 6c 6c 73 20 74 68 65 |option t|ells the|
|000054c0| 0a 58 74 6f 6f 6c 73 20 | 74 6f 20 6c 6f 6f 6b 20 |.Xtools |to look |
|000054d0| 66 6f 72 20 74 68 65 20 | 66 69 6c 65 73 20 72 65 |for the |files re|
|000054e0| 6c 61 74 69 76 65 20 74 | 6f 20 40 76 61 72 7b 3c |lative t|o @var{<|
|000054f0| 64 69 72 65 63 74 6f 72 | 79 3e 7d 20 72 65 67 61 |director|y>} rega|
|00005500| 72 64 6c 65 73 73 0a 58 | 6f 66 20 74 68 65 20 6c |rdless.X|of the l|
|00005510| 6f 63 61 74 69 6f 6e 20 | 6f 66 20 74 68 65 20 64 |ocation |of the d|
|00005520| 61 74 61 62 61 73 65 2e | 0a 58 40 69 74 65 6d 20 |atabase.|.X@item |
|00005530| 2d 63 0a 58 54 68 69 73 | 20 69 73 20 73 68 6f 72 |-c.XThis| is shor|
|00005540| 74 68 61 6e 64 20 66 6f | 72 20 40 63 6f 64 65 7b |thand fo|r @code{|
|00005550| 2d 72 60 70 77 64 60 7d | 2e 20 49 74 20 74 65 6c |-r`pwd`}|. It tel|
|00005560| 6c 73 20 74 68 65 20 71 | 75 65 72 79 20 74 6f 6f |ls the q|uery too|
|00005570| 6c 73 20 74 6f 20 61 73 | 73 75 6d 65 0a 58 74 68 |ls to as|sume.Xth|
|00005580| 65 20 66 69 6c 65 20 6e | 61 6d 65 73 20 61 72 65 |e file n|ames are|
|00005590| 20 73 74 6f 72 65 64 20 | 72 65 6c 61 74 69 76 65 | stored |relative|
|000055a0| 20 74 6f 20 74 68 65 20 | 63 75 72 72 65 6e 74 20 | to the |current |
|000055b0| 77 6f 72 6b 69 6e 67 20 | 64 69 72 65 63 74 6f 72 |working |director|
|000055c0| 79 2e 0a 58 40 69 74 65 | 6d 20 2d 65 0a 58 46 6f |y..X@ite|m -e.XFo|
|000055d0| 72 63 65 20 74 68 65 20 | 70 61 74 74 65 72 6e 20 |rce the |pattern |
|000055e0| 61 72 67 75 6d 65 6e 74 | 73 20 74 6f 20 62 65 20 |argument|s to be |
|000055f0| 74 72 65 61 74 65 64 20 | 61 73 20 72 65 67 75 6c |treated |as regul|
|00005600| 61 72 20 65 78 70 72 65 | 73 73 69 6f 6e 73 2e 0a |ar expre|ssions..|
|00005610| 58 4e 6f 72 6d 61 6c 6c | 79 20 74 68 65 20 71 75 |XNormall|y the qu|
|00005620| 65 72 79 20 74 6f 6f 6c | 73 20 61 74 74 65 6d 70 |ery tool|s attemp|
|00005630| 74 20 74 6f 20 67 75 65 | 73 73 20 69 66 20 74 68 |t to gue|ss if th|
|00005640| 65 20 70 61 74 74 65 72 | 6e 73 20 61 72 65 20 72 |e patter|ns are r|
|00005650| 65 67 75 6c 61 72 0a 58 | 65 78 70 72 65 73 73 69 |egular.X|expressi|
|00005660| 6f 6e 73 20 6f 72 20 73 | 69 6d 70 6c 65 20 69 64 |ons or s|imple id|
|00005670| 65 6e 74 69 66 69 65 72 | 73 20 62 79 20 6c 6f 6f |entifier|s by loo|
|00005680| 6b 69 6e 67 20 66 6f 72 | 20 73 70 65 63 69 61 6c |king for| special|
|00005690| 20 63 68 61 72 61 63 74 | 65 72 73 0a 58 69 6e 20 | charact|ers.Xin |
|000056a0| 74 68 65 20 70 61 74 74 | 65 72 6e 2e 0a 58 40 69 |the patt|ern..X@i|
|000056b0| 74 65 6d 20 2d 77 0a 58 | 46 6f 72 63 65 20 74 68 |tem -w.X|Force th|
|000056c0| 65 20 70 61 74 74 65 72 | 6e 20 61 72 67 75 6d 65 |e patter|n argume|
|000056d0| 6e 74 73 20 74 6f 20 62 | 65 20 74 72 65 61 74 65 |nts to b|e treate|
|000056e0| 64 20 61 73 20 73 69 6d | 70 6c 65 20 77 6f 72 64 |d as sim|ple word|
|000056f0| 73 20 65 76 65 6e 20 69 | 66 0a 58 74 68 65 79 20 |s even i|f.Xthey |
|00005700| 63 6f 6e 74 61 69 6e 20 | 73 70 65 63 69 61 6c 20 |contain |special |
|00005710| 72 65 67 75 6c 61 72 20 | 65 78 70 72 65 73 73 69 |regular |expressi|
|00005720| 6f 6e 20 63 68 61 72 61 | 63 74 65 72 73 2e 0a 58 |on chara|cters..X|
|00005730| 40 69 74 65 6d 20 2d 6b | 0a 58 4e 6f 72 6d 61 6c |@item -k|.XNormal|
|00005740| 6c 79 20 74 68 65 20 71 | 75 65 72 79 20 74 6f 6f |ly the q|uery too|
|00005750| 6c 73 20 74 68 61 74 20 | 67 65 6e 65 72 61 74 65 |ls that |generate|
|00005760| 20 6c 69 73 74 73 20 6f | 66 20 66 69 6c 65 20 6e | lists o|f file n|
|00005770| 61 6d 65 73 20 61 74 74 | 65 6d 70 74 20 74 6f 0a |ames att|empt to.|
|00005780| 58 63 6f 6d 70 72 65 73 | 73 20 74 68 65 20 6c 69 |Xcompres|s the li|
|00005790| 73 74 73 20 75 73 69 6e | 67 20 74 68 65 20 40 63 |sts usin|g the @c|
|000057a0| 6f 64 65 7b 63 73 68 7d | 20 62 72 61 63 65 20 6e |ode{csh}| brace n|
|000057b0| 6f 74 61 74 69 6f 6e 2e | 20 54 68 69 73 20 6f 70 |otation.| This op|
|000057c0| 74 69 6f 6e 0a 58 73 75 | 70 70 72 65 73 73 65 73 |tion.Xsu|ppresses|
|000057d0| 20 74 68 65 20 66 69 6c | 65 20 6e 61 6d 65 20 63 | the fil|e name c|
|000057e0| 6f 6d 70 72 65 73 73 69 | 6f 6e 20 61 6e 64 20 6f |ompressi|on and o|
|000057f0| 75 74 70 75 74 73 20 65 | 61 63 68 20 6e 61 6d 65 |utputs e|ach name|
|00005800| 20 69 6e 20 66 75 6c 6c | 2e 0a 58 28 54 68 69 73 | in full|..X(This|
|00005810| 20 69 73 20 70 61 72 74 | 69 63 75 6c 61 72 6c 79 | is part|icularly|
|00005820| 20 75 73 65 66 75 6c 20 | 69 66 20 79 6f 75 20 61 | useful |if you a|
|00005830| 72 65 20 61 20 40 63 6f | 64 65 7b 6b 73 68 7d 20 |re a @co|de{ksh} |
|00005840| 75 73 65 72 20 61 6e 64 | 20 77 61 6e 74 20 74 6f |user and| want to|
|00005850| 0a 58 66 65 65 64 20 74 | 68 65 20 6c 69 73 74 20 |.Xfeed t|he list |
|00005860| 6f 66 20 6e 61 6d 65 73 | 20 74 6f 20 61 6e 6f 74 |of names| to anot|
|00005870| 68 65 72 20 63 6f 6d 6d | 61 6e 64 20 2d 2d 2d 20 |her comm|and --- |
|00005880| 74 68 65 20 40 63 6f 64 | 65 7b 2d 6b 7d 20 6f 70 |the @cod|e{-k} op|
|00005890| 74 69 6f 6e 0a 58 63 6f | 6d 65 73 20 66 72 6f 6d |tion.Xco|mes from|
|000058a0| 20 74 68 65 20 40 63 6f | 64 65 7b 6b 7d 20 69 6e | the @co|de{k} in|
|000058b0| 20 40 63 6f 64 65 7b 6b | 73 68 7d 29 2e 0a 58 40 | @code{k|sh})..X@|
|000058c0| 69 74 65 6d 20 2d 67 0a | 58 49 74 20 69 73 20 70 |item -g.|XIt is p|
|000058d0| 6f 73 73 69 62 6c 65 20 | 74 6f 20 62 75 69 6c 64 |ossible |to build|
|000058e0| 20 74 68 65 20 71 75 65 | 72 79 20 74 6f 6f 6c 73 | the que|ry tools|
|000058f0| 20 73 6f 20 74 68 65 20 | 40 63 6f 64 65 7b 2d 6b | so the |@code{-k|
|00005900| 7d 20 6f 70 74 69 6f 6e | 20 69 73 20 74 68 65 0a |} option| is the.|
|00005910| 58 64 65 66 61 75 6c 74 | 20 62 65 68 61 76 69 6f |Xdefault| behavio|
|00005920| 72 2e 20 49 66 20 74 68 | 69 73 20 69 73 20 74 68 |r. If th|is is th|
|00005930| 65 20 63 61 73 65 20 66 | 6f 72 20 79 6f 75 72 20 |e case f|or your |
|00005940| 73 79 73 74 65 6d 2c 20 | 74 68 65 20 40 63 6f 64 |system, |the @cod|
|00005950| 65 7b 2d 67 7d 0a 58 6f | 70 74 69 6f 6e 20 74 75 |e{-g}.Xo|ption tu|
|00005960| 72 6e 73 20 6f 6e 20 74 | 68 65 20 67 6c 6f 62 62 |rns on t|he globb|
|00005970| 69 6e 67 20 6f 66 20 66 | 69 6c 65 20 6e 61 6d 65 |ing of f|ile name|
|00005980| 73 20 75 73 69 6e 67 20 | 74 68 65 20 40 63 6f 64 |s using |the @cod|
|00005990| 65 7b 63 73 68 7d 20 62 | 72 61 63 65 0a 58 6e 6f |e{csh} b|race.Xno|
|000059a0| 74 61 74 69 6f 6e 2e 0a | 58 40 69 74 65 6d 20 2d |tation..|X@item -|
|000059b0| 6e 0a 58 4e 6f 72 6d 61 | 6c 6c 79 20 74 68 65 20 |n.XNorma|lly the |
|000059c0| 71 75 65 72 79 20 74 6f | 6f 6c 73 20 74 68 61 74 |query to|ols that|
|000059d0| 20 67 65 6e 65 72 61 74 | 65 20 6c 69 73 74 73 20 | generat|e lists |
|000059e0| 6f 66 20 66 69 6c 65 20 | 6e 61 6d 65 73 20 61 6c |of file |names al|
|000059f0| 73 6f 20 6c 69 73 74 0a | 58 74 68 65 20 6d 61 74 |so list.|Xthe mat|
|00005a00| 63 68 69 6e 67 20 69 64 | 65 6e 74 69 66 69 65 72 |ching id|entifier|
|00005a10| 20 61 74 20 74 68 65 20 | 68 65 61 64 20 6f 66 20 | at the |head of |
|00005a20| 74 68 65 20 6c 69 73 74 | 20 6f 66 20 6e 61 6d 65 |the list| of name|
|00005a30| 73 2e 20 54 68 69 73 20 | 69 73 0a 58 69 72 72 69 |s. This |is.Xirri|
|00005a40| 74 61 74 69 6e 67 20 69 | 66 20 79 6f 75 20 77 61 |tating i|f you wa|
|00005a50| 6e 74 20 6a 75 73 74 20 | 61 20 6c 69 73 74 20 6f |nt just |a list o|
|00005a60| 66 20 6e 61 6d 65 73 20 | 74 6f 20 66 65 65 64 20 |f names |to feed |
|00005a70| 74 6f 20 61 6e 6f 74 68 | 65 72 20 63 6f 6d 6d 61 |to anoth|er comma|
|00005a80| 6e 64 2c 0a 58 73 6f 20 | 74 68 65 20 40 63 6f 64 |nd,.Xso |the @cod|
|00005a90| 65 7b 2d 6e 7d 20 6f 70 | 74 69 6f 6e 20 73 75 70 |e{-n} op|tion sup|
|00005aa0| 70 72 65 73 73 65 73 20 | 74 68 65 20 69 64 65 6e |presses |the iden|
|00005ab0| 74 69 66 69 65 72 20 61 | 6e 64 20 6c 69 73 74 73 |tifier a|nd lists|
|00005ac0| 20 6f 6e 6c 79 0a 58 66 | 69 6c 65 20 6e 61 6d 65 | only.Xf|ile name|
|00005ad0| 73 2e 0a 58 40 69 74 65 | 6d 20 2d 62 0a 58 54 68 |s..X@ite|m -b.XTh|
|00005ae0| 69 73 20 6f 70 74 69 6f | 6e 20 69 73 20 6f 6e 6c |is optio|n is onl|
|00005af0| 79 20 75 73 65 64 20 62 | 79 20 74 68 65 20 40 63 |y used b|y the @c|
|00005b00| 6f 64 65 7b 70 69 64 7d | 20 74 6f 6f 6c 2e 20 49 |ode{pid}| tool. I|
|00005b10| 74 20 72 65 73 74 72 69 | 63 74 73 20 40 63 6f 64 |t restri|cts @cod|
|00005b20| 65 7b 70 69 64 7d 0a 58 | 74 6f 20 70 61 74 74 65 |e{pid}.X|to patte|
|00005b30| 72 6e 20 6d 61 74 63 68 | 20 6f 6e 6c 79 20 74 68 |rn match| only th|
|00005b40| 65 20 62 61 73 65 6e 61 | 6d 65 20 70 61 72 74 20 |e basena|me part |
|00005b50| 6f 66 20 61 20 66 69 6c | 65 20 6e 61 6d 65 2e 20 |of a fil|e name. |
|00005b60| 4e 6f 72 6d 61 6c 6c 79 | 20 74 68 65 0a 58 61 62 |Normally| the.Xab|
|00005b70| 73 6f 6c 75 74 65 20 66 | 69 6c 65 20 6e 61 6d 65 |solute f|ile name|
|00005b80| 20 69 73 20 6d 61 74 63 | 68 65 64 20 61 67 61 69 | is matc|hed agai|
|00005b90| 6e 73 74 20 74 68 65 20 | 70 61 74 74 65 72 6e 2e |nst the |pattern.|
|00005ba0| 0a 58 40 69 74 65 6d 20 | 2d 64 20 2d 6f 20 2d 78 |.X@item |-d -o -x|
|00005bb0| 20 2d 61 0a 58 54 68 65 | 73 65 20 6f 70 74 69 6f | -a.XThe|se optio|
|00005bc0| 6e 73 20 6d 61 79 20 62 | 65 20 75 73 65 64 20 69 |ns may b|e used i|
|00005bd0| 6e 20 61 6e 79 20 63 6f | 6d 62 69 6e 61 74 69 6f |n any co|mbinatio|
|00005be0| 6e 20 74 6f 20 6c 69 6d | 69 74 20 74 68 65 20 72 |n to lim|it the r|
|00005bf0| 61 64 69 78 20 6f 66 0a | 58 6e 75 6d 65 72 69 63 |adix of.|Xnumeric|
|00005c00| 20 6d 61 74 63 68 65 73 | 2e 20 54 68 65 20 40 63 | matches|. The @c|
|00005c10| 6f 64 65 7b 2d 64 7d 20 | 6f 70 74 69 6f 6e 20 77 |ode{-d} |option w|
|00005c20| 69 6c 6c 20 61 6c 6c 6f | 77 20 6d 61 74 63 68 65 |ill allo|w matche|
|00005c30| 73 20 6f 6e 20 64 65 63 | 69 6d 61 6c 0a 58 6e 75 |s on dec|imal.Xnu|
|00005c40| 6d 62 65 72 73 2c 20 40 | 63 6f 64 65 7b 2d 6f 7d |mbers, @|code{-o}|
|00005c50| 20 6f 6e 20 6f 63 74 61 | 6c 2c 20 61 6e 64 20 40 | on octa|l, and @|
|00005c60| 63 6f 64 65 7b 2d 78 7d | 20 6f 6e 20 68 65 78 61 |code{-x}| on hexa|
|00005c70| 64 65 63 69 6d 61 6c 20 | 6e 75 6d 62 65 72 73 2e |decimal |numbers.|
|00005c80| 0a 58 54 68 65 20 40 63 | 6f 64 65 7b 2d 61 7d 20 |.XThe @c|ode{-a} |
|00005c90| 6f 70 74 69 6f 6e 20 69 | 73 20 73 68 6f 72 74 68 |option i|s shorth|
|00005ca0| 61 6e 64 20 66 6f 72 20 | 73 70 65 63 69 66 79 69 |and for |specifyi|
|00005cb0| 6e 67 20 61 6c 6c 20 74 | 68 72 65 65 2e 20 41 6e |ng all t|hree. An|
|00005cc0| 79 0a 58 63 6f 6d 62 69 | 6e 61 74 69 6f 6e 20 6f |y.Xcombi|nation o|
|00005cd0| 66 20 74 68 65 73 65 20 | 6f 70 74 69 6f 6e 73 20 |f these |options |
|00005ce0| 6d 61 79 20 62 65 20 75 | 73 65 64 2e 0a 58 40 69 |may be u|sed..X@i|
|00005cf0| 74 65 6d 20 2d 6d 0a 58 | 4d 65 72 67 65 20 6d 75 |tem -m.X|Merge mu|
|00005d00| 6c 74 69 70 6c 65 20 6c | 69 6e 65 73 20 6f 66 20 |ltiple l|ines of |
|00005d10| 6f 75 74 70 75 74 20 69 | 6e 74 6f 20 61 20 73 69 |output i|nto a si|
|00005d20| 6e 67 6c 65 20 6c 69 6e | 65 2e 20 28 49 66 20 79 |ngle lin|e. (If y|
|00005d30| 6f 75 72 20 71 75 65 72 | 79 0a 58 6d 61 74 63 68 |our quer|y.Xmatch|
|00005d40| 65 73 20 6d 6f 72 65 20 | 74 68 61 6e 20 6f 6e 65 |es more |than one|
|00005d50| 20 69 64 65 6e 74 69 66 | 69 65 72 20 74 68 65 20 | identif|ier the |
|00005d60| 64 65 66 61 75 6c 74 20 | 61 63 74 69 6f 6e 20 69 |default |action i|
|00005d70| 73 20 74 6f 20 67 65 6e | 65 72 61 74 65 0a 58 61 |s to gen|erate.Xa|
|00005d80| 20 73 65 70 61 72 61 74 | 65 20 6c 69 6e 65 20 6f | separat|e line o|
|00005d90| 66 20 6f 75 74 70 75 74 | 20 66 6f 72 20 65 61 63 |f output| for eac|
|00005da0| 68 20 6d 61 74 63 68 69 | 6e 67 20 69 64 65 6e 74 |h matchi|ng ident|
|00005db0| 69 66 69 65 72 29 2e 0a | 58 40 69 74 65 6d 20 2d |ifier)..|X@item -|
|00005dc0| 73 0a 58 53 65 61 72 63 | 68 20 66 6f 72 20 69 64 |s.XSearc|h for id|
|00005dd0| 65 6e 74 69 66 69 65 72 | 73 20 74 68 61 74 20 61 |entifier|s that a|
|00005de0| 70 70 65 61 72 20 6f 6e | 6c 79 20 6f 6e 63 65 20 |ppear on|ly once |
|00005df0| 69 6e 20 74 68 65 20 64 | 61 74 61 62 61 73 65 2e |in the d|atabase.|
|00005e00| 20 54 68 69 73 0a 58 68 | 65 6c 70 73 20 74 6f 20 | This.Xh|elps to |
|00005e10| 6c 6f 63 61 74 65 20 69 | 64 65 6e 74 69 66 69 65 |locate i|dentifie|
|00005e20| 72 73 20 74 68 61 74 20 | 61 72 65 20 64 65 66 69 |rs that |are defi|
|00005e30| 6e 65 64 20 62 75 74 20 | 6e 65 76 65 72 20 75 73 |ned but |never us|
|00005e40| 65 64 2e 0a 58 40 69 74 | 65 6d 20 2d 75 40 76 61 |ed..X@it|em -u@va|
|00005e50| 72 7b 3c 6e 75 6d 62 65 | 72 3e 7d 0a 58 4c 69 73 |r{<numbe|r>}.XLis|
|00005e60| 74 20 69 64 65 6e 74 69 | 66 69 65 72 73 20 74 68 |t identi|fiers th|
|00005e70| 61 74 20 63 6f 6e 66 6c | 69 63 74 20 69 6e 20 74 |at confl|ict in t|
|00005e80| 68 65 20 66 69 72 73 74 | 20 40 76 61 72 7b 3c 6e |he first| @var{<n|
|00005e90| 75 6d 62 65 72 3e 7d 20 | 63 68 61 72 61 63 74 65 |umber>} |characte|
|00005ea0| 72 73 2e 0a 58 54 68 69 | 73 20 63 6f 75 6c 64 20 |rs..XThi|s could |
|00005eb0| 62 65 20 75 73 65 66 75 | 6c 20 70 6f 72 74 69 6e |be usefu|l portin|
|00005ec0| 67 20 70 72 6f 67 72 61 | 6d 73 20 74 6f 20 62 72 |g progra|ms to br|
|00005ed0| 61 69 6e 2d 64 65 61 64 | 20 63 6f 6d 70 75 74 65 |ain-dead| compute|
|00005ee0| 72 73 20 74 68 61 74 0a | 58 72 65 66 75 73 65 20 |rs that.|Xrefuse |
|00005ef0| 74 6f 20 73 75 70 70 6f | 72 74 20 6c 6f 6e 67 20 |to suppo|rt long |
|00005f00| 69 64 65 6e 74 69 66 69 | 65 72 73 2c 20 62 75 74 |identifi|ers, but|
|00005f10| 20 79 6f 75 72 20 62 65 | 73 74 20 6c 6f 6e 67 20 | your be|st long |
|00005f20| 74 65 72 6d 20 6f 70 74 | 69 6f 6e 0a 58 69 73 20 |term opt|ion.Xis |
|00005f30| 74 6f 20 73 65 74 20 73 | 75 63 68 20 63 6f 6d 70 |to set s|uch comp|
|00005f40| 75 74 65 72 73 20 6f 6e | 20 66 69 72 65 2e 0a 58 |uters on| fire..X|
|00005f50| 40 65 6e 64 20 74 61 62 | 6c 65 0a 58 0a 58 40 6e |@end tab|le.X.X@n|
|00005f60| 6f 64 65 20 50 61 74 74 | 65 72 6e 73 2c 20 4c 69 |ode Patt|erns, Li|
|00005f70| 64 2c 20 43 6f 6d 6d 6f | 6e 20 4f 70 74 69 6f 6e |d, Commo|n Option|
|00005f80| 73 2c 20 44 61 74 61 62 | 61 73 65 20 51 75 65 72 |s, Datab|ase Quer|
|00005f90| 79 20 54 6f 6f 6c 73 0a | 58 40 73 65 63 74 69 6f |y Tools.|X@sectio|
|00005fa0| 6e 20 50 61 74 74 65 72 | 6e 73 0a 58 0a 58 59 6f |n Patter|ns.X.XYo|
|00005fb0| 75 20 63 61 6e 20 61 74 | 74 65 6d 70 74 20 74 6f |u can at|tempt to|
|00005fc0| 20 6d 61 74 63 68 20 65 | 69 74 68 65 72 20 73 69 | match e|ither si|
|00005fd0| 6d 70 6c 65 20 69 64 65 | 6e 74 69 66 69 65 72 73 |mple ide|ntifiers|
|00005fe0| 20 6f 72 20 6e 75 6d 62 | 65 72 73 20 69 6e 20 61 | or numb|ers in a|
|00005ff0| 0a 58 71 75 65 72 79 2c | 20 6f 72 20 79 6f 75 20 |.Xquery,| or you |
|00006000| 63 61 6e 20 73 70 65 63 | 69 66 79 20 61 20 72 65 |can spec|ify a re|
|00006010| 67 75 6c 61 72 20 65 78 | 70 72 65 73 73 69 6f 6e |gular ex|pression|
|00006020| 20 70 61 74 74 65 72 6e | 20 77 68 69 63 68 20 6d | pattern| which m|
|00006030| 61 79 0a 58 6d 61 74 63 | 68 20 6d 61 6e 79 20 64 |ay.Xmatc|h many d|
|00006040| 69 66 66 65 72 65 6e 74 | 20 69 64 65 6e 74 69 66 |ifferent| identif|
|00006050| 69 65 72 73 20 69 6e 20 | 74 68 65 20 64 61 74 61 |iers in |the data|
|00006060| 62 61 73 65 2e 20 54 68 | 65 20 71 75 65 72 79 0a |base. Th|e query.|
|00006070| 58 70 72 6f 67 72 61 6d | 73 20 75 73 65 20 65 69 |Xprogram|s use ei|
|00006080| 74 68 65 72 20 40 76 61 | 72 7b 72 65 67 65 78 7d |ther @va|r{regex}|
|00006090| 20 61 6e 64 20 40 76 61 | 72 7b 72 65 67 63 6d 70 | and @va|r{regcmp|
|000060a0| 7d 20 6f 72 20 40 76 61 | 72 7b 72 65 5f 63 6f 6d |} or @va|r{re_com|
|000060b0| 70 7d 0a 58 61 6e 64 20 | 40 76 61 72 7b 72 65 5f |p}.Xand |@var{re_|
|000060c0| 65 78 65 63 7d 2c 20 64 | 65 70 65 6e 64 69 6e 67 |exec}, d|epending|
|000060d0| 20 6f 6e 20 77 68 69 63 | 68 20 6f 6e 65 20 69 73 | on whic|h one is|
|000060e0| 20 61 76 61 69 6c 61 62 | 6c 65 20 69 6e 20 74 68 | availab|le in th|
|000060f0| 65 20 6c 69 62 72 61 72 | 79 0a 58 6f 6e 20 79 6f |e librar|y.Xon yo|
|00006100| 75 72 20 73 79 73 74 65 | 6d 2e 20 54 68 65 73 65 |ur syste|m. These|
|00006110| 20 6d 69 67 68 74 20 6e | 6f 74 20 61 6c 77 61 79 | might n|ot alway|
|00006120| 73 20 73 75 70 70 6f 72 | 74 20 74 68 65 20 65 78 |s suppor|t the ex|
|00006130| 61 63 74 20 73 61 6d 65 | 0a 58 72 65 67 75 6c 61 |act same|.Xregula|
|00006140| 72 20 65 78 70 72 65 73 | 73 69 6f 6e 20 73 79 6e |r expres|sion syn|
|00006150| 74 61 78 2c 20 73 6f 20 | 63 6f 6e 73 75 6c 74 20 |tax, so |consult |
|00006160| 79 6f 75 72 20 6c 6f 63 | 61 6c 20 40 76 61 72 7b |your loc|al @var{|
|00006170| 6d 61 6e 7d 20 70 61 67 | 65 73 0a 58 74 6f 20 66 |man} pag|es.Xto f|
|00006180| 69 6e 64 20 6f 75 74 2e | 20 41 6e 79 20 72 65 67 |ind out.| Any reg|
|00006190| 75 6c 61 72 20 65 78 70 | 72 65 73 73 69 6f 6e 20 |ular exp|ression |
|000061a0| 72 6f 75 74 69 6e 65 73 | 20 73 68 6f 75 6c 64 20 |routines| should |
|000061b0| 73 75 70 70 6f 72 74 20 | 74 68 65 20 66 6f 6c 6c |support |the foll|
|000061c0| 6f 77 69 6e 67 0a 58 73 | 79 6e 74 61 78 3a 0a 58 |owing.Xs|yntax:.X|
|000061d0| 0a 58 40 74 61 62 6c 65 | 20 40 63 6f 64 65 0a 58 |.X@table| @code.X|
|000061e0| 40 69 74 65 6d 20 2e 0a | 58 41 20 64 6f 74 20 6d |@item ..|XA dot m|
|000061f0| 61 74 63 68 65 73 20 61 | 6e 79 20 63 68 61 72 61 |atches a|ny chara|
|00006200| 63 74 65 72 2e 0a 58 40 | 69 74 65 6d 20 5b 20 5d |cter..X@|item [ ]|
|00006210| 0a 58 42 72 61 63 6b 65 | 74 73 20 6d 61 74 63 68 |.XBracke|ts match|
|00006220| 20 61 6e 79 20 6f 66 20 | 74 68 65 20 63 68 61 72 | any of |the char|
|00006230| 61 63 74 65 72 73 20 73 | 70 65 63 69 66 69 65 64 |acters s|pecified|
|00006240| 20 77 69 74 68 69 6e 20 | 74 68 65 20 62 72 61 63 | within |the brac|
|00006250| 6b 65 74 73 2e 20 20 59 | 6f 75 0a 58 63 61 6e 20 |kets. Y|ou.Xcan |
|00006260| 6d 61 74 63 68 20 61 6e | 79 20 63 68 61 72 61 63 |match an|y charac|
|00006270| 74 65 72 73 20 40 65 6d | 70 68 7b 65 78 63 65 70 |ters @em|ph{excep|
|00006280| 74 7d 20 74 68 65 20 6f | 6e 65 73 20 69 6e 20 62 |t} the o|nes in b|
|00006290| 72 61 63 6b 65 74 73 20 | 62 79 20 74 79 70 69 6e |rackets |by typin|
|000062a0| 67 0a 58 40 63 6f 64 65 | 7b 5e 7d 20 61 73 20 74 |g.X@code|{^} as t|
|000062b0| 68 65 20 66 69 72 73 74 | 20 63 68 61 72 61 63 74 |he first| charact|
|000062c0| 65 72 2e 20 41 20 72 61 | 6e 67 65 20 6f 66 20 63 |er. A ra|nge of c|
|000062d0| 68 61 72 61 63 74 65 72 | 73 20 63 61 6e 20 62 65 |haracter|s can be|
|000062e0| 20 73 70 65 63 69 66 69 | 65 64 0a 58 75 73 69 6e | specifi|ed.Xusin|
|000062f0| 67 20 40 63 6f 64 65 7b | 2d 7d 2e 0a 58 40 69 74 |g @code{|-}..X@it|
|00006300| 65 6d 20 2a 0a 58 41 6e | 20 61 73 74 65 72 69 73 |em *.XAn| asteris|
|00006310| 6b 20 6d 65 61 6e 73 20 | 72 65 70 65 61 74 20 74 |k means |repeat t|
|00006320| 68 65 20 70 72 65 76 69 | 6f 75 73 20 70 61 74 74 |he previ|ous patt|
|00006330| 65 72 6e 20 7a 65 72 6f | 20 6f 72 20 6d 6f 72 65 |ern zero| or more|
|00006340| 20 74 69 6d 65 73 2e 0a | 58 40 69 74 65 6d 20 5e | times..|X@item ^|
|00006350| 0a 58 41 6e 20 40 63 6f | 64 65 7b 5e 7d 20 61 74 |.XAn @co|de{^} at|
|00006360| 20 74 68 65 20 62 65 67 | 69 6e 6e 69 6e 67 20 6f | the beg|inning o|
|00006370| 66 20 61 20 70 61 74 74 | 65 72 6e 20 6d 65 61 6e |f a patt|ern mean|
|00006380| 73 20 74 68 65 20 70 61 | 74 74 65 72 6e 20 6d 75 |s the pa|ttern mu|
|00006390| 73 74 20 6d 61 74 63 68 | 0a 58 73 74 61 72 74 69 |st match|.Xstarti|
|000063a0| 6e 67 20 61 74 20 74 68 | 65 20 66 69 72 73 74 20 |ng at th|e first |
|000063b0| 63 68 61 72 61 63 74 65 | 72 20 6f 66 20 74 68 65 |characte|r of the|
|000063c0| 20 69 64 65 6e 74 69 66 | 69 65 72 2e 0a 58 40 69 | identif|ier..X@i|
|000063d0| 74 65 6d 20 24 0a 58 41 | 20 40 63 6f 64 65 7b 24 |tem $.XA| @code{$|
|000063e0| 7d 20 61 74 20 74 68 65 | 20 65 6e 64 20 6f 66 20 |} at the| end of |
|000063f0| 74 68 65 20 70 61 74 74 | 65 72 6e 20 6d 65 61 6e |the patt|ern mean|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.
