home *** CD-ROM | disk | FTP | other *** search
open in: 
MacOS 8.1
|
Win98
|
DOS
browse contents |
view JSON data
|
view as text
This file was processed as: SHell self-extracting ARchive
(archive/shar).
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 100%
| dexvert
| Newsgroup Content (archive/news)
| magic
| Supported |
| 100%
| dexvert
| SHell self-extracting ARchive (archive/shar)
| magic
| Supported |
| 100%
| dexvert
| Internet Message Format (text/imf)
| magic
| Supported |
| 1%
| dexvert
| Text File (text/txt)
| fallback
| Supported |
| 100%
| file
| news, ASCII text
| default
| |
| 100%
| checkBytes
| Printable ASCII
| default
| |
| 100%
| dexmagic
| PrintFox/Pagefox WEAK
| 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/news
| default
|
|
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 50 61 74 68 3a 20 75 75 | 6e 65 74 21 72 73 0a 46 |Path: uu|net!rs.F|
|00000010| 72 6f 6d 3a 20 72 73 40 | 75 75 6e 65 74 2e 55 55 |rom: rs@|uunet.UU|
|00000020| 2e 4e 45 54 20 28 52 69 | 63 68 20 53 61 6c 7a 29 |.NET (Ri|ch Salz)|
|00000030| 0a 4e 65 77 73 67 72 6f | 75 70 73 3a 20 63 6f 6d |.Newsgro|ups: com|
|00000040| 70 2e 73 6f 75 72 63 65 | 73 2e 75 6e 69 78 0a 53 |p.source|s.unix.S|
|00000050| 75 62 6a 65 63 74 3a 20 | 76 31 31 69 30 33 38 3a |ubject: |v11i038:|
|00000060| 20 20 54 65 73 74 20 73 | 79 73 74 65 6d 20 66 6f | Test s|ystem fo|
|00000070| 72 20 47 4e 55 20 45 6d | 61 63 73 2c 20 50 61 72 |r GNU Em|acs, Par|
|00000080| 74 30 33 2f 30 33 0a 4d | 65 73 73 61 67 65 2d 49 |t03/03.M|essage-I|
|00000090| 44 3a 20 3c 31 35 30 33 | 40 75 75 6e 65 74 2e 55 |D: <1503|@uunet.U|
|000000a0| 55 2e 4e 45 54 3e 0a 44 | 61 74 65 3a 20 31 30 20 |U.NET>.D|ate: 10 |
|000000b0| 53 65 70 20 38 37 20 30 | 33 3a 35 34 3a 35 32 20 |Sep 87 0|3:54:52 |
|000000c0| 47 4d 54 0a 4f 72 67 61 | 6e 69 7a 61 74 69 6f 6e |GMT.Orga|nization|
|000000d0| 3a 20 55 55 4e 45 54 20 | 43 6f 6d 6d 75 6e 69 63 |: UUNET |Communic|
|000000e0| 61 74 69 6f 6e 73 20 53 | 65 72 76 69 63 65 73 2c |ations S|ervices,|
|000000f0| 20 41 72 6c 69 6e 67 74 | 6f 6e 2c 20 56 41 0a 4c | Arlingt|on, VA.L|
|00000100| 69 6e 65 73 3a 20 31 37 | 32 32 0a 41 70 70 72 6f |ines: 17|22.Appro|
|00000110| 76 65 64 3a 20 72 73 40 | 75 75 6e 65 74 2e 55 55 |ved: rs@|uunet.UU|
|00000120| 2e 4e 45 54 0a 0a 53 75 | 62 6d 69 74 74 65 64 2d |.NET..Su|bmitted-|
|00000130| 62 79 3a 20 22 4d 61 72 | 6b 20 41 2e 20 41 72 64 |by: "Mar|k A. Ard|
|00000140| 69 73 22 20 3c 6d 61 61 | 40 73 65 69 2e 63 6d 75 |is" <maa|@sei.cmu|
|00000150| 2e 65 64 75 3e 0a 50 6f | 73 74 69 6e 67 2d 6e 75 |.edu>.Po|sting-nu|
|00000160| 6d 62 65 72 3a 20 56 6f | 6c 75 6d 65 20 31 31 2c |mber: Vo|lume 11,|
|00000170| 20 49 73 73 75 65 20 33 | 38 0a 41 72 63 68 69 76 | Issue 3|8.Archiv|
|00000180| 65 2d 6e 61 6d 65 3a 20 | 74 65 73 74 2e 65 6c 2f |e-name: |test.el/|
|00000190| 50 61 72 74 30 33 0a 0a | 0a 23 21 20 2f 62 69 6e |Part03..|.#! /bin|
|000001a0| 2f 73 68 0a 23 20 54 68 | 69 73 20 69 73 20 61 20 |/sh.# Th|is is a |
|000001b0| 73 68 65 6c 6c 20 61 72 | 63 68 69 76 65 2c 20 6d |shell ar|chive, m|
|000001c0| 65 61 6e 69 6e 67 3a 0a | 23 20 31 2e 20 52 65 6d |eaning:.|# 1. Rem|
|000001d0| 6f 76 65 20 65 76 65 72 | 79 74 68 69 6e 67 20 61 |ove ever|ything a|
|000001e0| 62 6f 76 65 20 74 68 65 | 20 23 21 20 2f 62 69 6e |bove the| #! /bin|
|000001f0| 2f 73 68 20 6c 69 6e 65 | 2e 0a 23 20 32 2e 20 53 |/sh line|..# 2. S|
|00000200| 61 76 65 20 74 68 65 20 | 72 65 73 75 6c 74 69 6e |ave the |resultin|
|00000210| 67 20 74 65 78 74 20 69 | 6e 20 61 20 66 69 6c 65 |g text i|n a file|
|00000220| 2e 0a 23 20 33 2e 20 45 | 78 65 63 75 74 65 20 74 |..# 3. E|xecute t|
|00000230| 68 65 20 66 69 6c 65 20 | 77 69 74 68 20 2f 62 69 |he file |with /bi|
|00000240| 6e 2f 73 68 20 28 6e 6f | 74 20 63 73 68 29 20 74 |n/sh (no|t csh) t|
|00000250| 6f 20 63 72 65 61 74 65 | 3a 0a 23 09 4d 41 4e 49 |o create|:.#.MANI|
|00000260| 46 45 53 54 0a 23 09 74 | 65 73 74 2e 74 65 78 69 |FEST.#.t|est.texi|
|00000270| 6e 66 6f 0a 65 78 70 6f | 72 74 20 50 41 54 48 3b |nfo.expo|rt PATH;|
|00000280| 20 50 41 54 48 3d 2f 62 | 69 6e 3a 2f 75 73 72 2f | PATH=/b|in:/usr/|
|00000290| 62 69 6e 3a 24 50 41 54 | 48 0a 65 63 68 6f 20 73 |bin:$PAT|H.echo s|
|000002a0| 68 61 72 3a 20 22 65 78 | 74 72 61 63 74 69 6e 67 |har: "ex|tracting|
|000002b0| 20 27 4d 41 4e 49 46 45 | 53 54 27 22 20 27 28 31 | 'MANIFE|ST'" '(1|
|000002c0| 31 34 39 20 63 68 61 72 | 61 63 74 65 72 73 29 27 |149 char|acters)'|
|000002d0| 0a 69 66 20 74 65 73 74 | 20 2d 66 20 27 4d 41 4e |.if test| -f 'MAN|
|000002e0| 49 46 45 53 54 27 0a 74 | 68 65 6e 0a 09 65 63 68 |IFEST'.t|hen..ech|
|000002f0| 6f 20 73 68 61 72 3a 20 | 22 77 69 6c 6c 20 6e 6f |o shar: |"will no|
|00000300| 74 20 6f 76 65 72 2d 77 | 72 69 74 65 20 65 78 69 |t over-w|rite exi|
|00000310| 73 74 69 6e 67 20 66 69 | 6c 65 20 27 4d 41 4e 49 |sting fi|le 'MANI|
|00000320| 46 45 53 54 27 22 0a 65 | 6c 73 65 0a 73 65 64 20 |FEST'".e|lse.sed |
|00000330| 27 73 2f 5e 58 2f 2f 27 | 20 3c 3c 20 5c 53 48 41 |'s/^X//'| << \SHA|
|00000340| 52 5f 45 4f 46 20 3e 20 | 27 4d 41 4e 49 46 45 53 |R_EOF > |'MANIFES|
|00000350| 54 27 0a 58 46 69 6c 65 | 20 20 20 20 20 20 20 20 |T'.XFile| |
|00000360| 20 20 20 20 20 20 20 20 | 20 20 20 20 41 72 63 68 | | Arch|
|00000370| 69 76 65 20 20 20 20 20 | 20 20 20 20 44 65 73 63 |ive | Desc|
|00000380| 72 69 70 74 69 6f 6e 0a | 58 2d 2d 2d 2d 20 20 20 |ription.|X---- |
|00000390| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000003a0| 20 2d 2d 2d 2d 2d 2d 2d | 20 20 20 20 20 20 20 20 | -------| |
|000003b0| 20 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 0a 58 4d 41 | -------|----.XMA|
|000003c0| 4e 49 46 45 53 54 20 20 | 20 20 20 20 20 20 20 20 |NIFEST | |
|000003d0| 20 20 20 20 20 20 20 20 | 20 31 20 20 20 20 20 20 | | 1 |
|000003e0| 20 20 20 20 20 20 54 68 | 69 73 20 66 69 6c 65 0a | Th|is file.|
|000003f0| 58 62 6f 78 2e 73 63 72 | 69 70 74 20 20 20 20 20 |Xbox.scr|ipt |
|00000400| 20 20 20 20 20 20 20 20 | 20 20 20 20 32 20 20 20 | | 2 |
|00000410| 20 20 20 20 20 20 20 20 | 20 45 78 61 6d 70 6c 65 | | Example|
|00000420| 20 74 65 73 74 20 73 63 | 72 69 70 74 0a 58 65 78 | test sc|ript.Xex|
|00000430| 61 6d 70 6c 65 2e 74 65 | 78 69 6e 66 6f 20 20 20 |ample.te|xinfo |
|00000440| 20 20 20 20 20 20 20 20 | 20 32 20 20 20 20 20 20 | | 2 |
|00000450| 20 20 20 20 20 20 41 70 | 70 65 6e 64 69 78 20 70 | Ap|pendix p|
|00000460| 61 72 74 20 6f 66 20 75 | 73 65 72 20 6d 61 6e 75 |art of u|ser manu|
|00000470| 61 6c 0a 58 68 6f 6f 6b | 73 2e 65 6c 20 20 20 20 |al.Xhook|s.el |
|00000480| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 32 | | 2|
|00000490| 20 20 20 20 20 20 20 20 | 20 20 20 20 45 78 61 6d | | Exam|
|000004a0| 70 6c 65 20 68 6f 6f 6b | 73 20 66 6f 72 20 63 75 |ple hook|s for cu|
|000004b0| 73 74 6f 6d 69 7a 61 74 | 69 6f 6e 0a 58 74 65 73 |stomizat|ion.Xtes|
|000004c0| 74 2e 65 6c 20 20 20 20 | 20 20 20 20 20 20 20 20 |t.el | |
|000004d0| 20 20 20 20 20 20 20 20 | 32 20 20 20 20 20 20 20 | |2 |
|000004e0| 20 20 20 20 20 52 6f 6f | 74 20 6f 66 20 74 65 73 | Roo|t of tes|
|000004f0| 74 20 70 61 63 6b 61 67 | 65 0a 58 74 65 73 74 2e |t packag|e.Xtest.|
|00000500| 74 65 78 69 6e 66 6f 20 | 20 20 20 20 20 20 20 20 |texinfo | |
|00000510| 20 20 20 20 20 20 31 20 | 20 20 20 20 20 20 20 20 | 1 | |
|00000520| 20 20 20 4d 61 69 6e 20 | 70 61 72 74 20 6f 66 20 | Main |part of |
|00000530| 75 73 65 72 20 6d 61 6e | 75 61 6c 0a 58 74 73 74 |user man|ual.Xtst|
|00000540| 2d 61 63 68 69 65 76 65 | 2e 65 6c 20 20 20 20 20 |-achieve|.el |
|00000550| 20 20 20 20 20 20 20 20 | 32 20 20 20 20 20 20 20 | |2 |
|00000560| 20 20 20 20 20 41 63 68 | 69 65 76 65 2d 73 74 61 | Ach|ieve-sta|
|00000570| 74 65 20 72 6f 75 74 69 | 6e 65 73 0a 58 74 73 74 |te routi|nes.Xtst|
|00000580| 2d 61 6e 61 6c 79 7a 65 | 2e 65 6c 20 20 20 20 20 |-analyze|.el |
|00000590| 20 20 20 20 20 20 20 20 | 32 20 20 20 20 20 20 20 | |2 |
|000005a0| 20 20 20 20 20 41 6e 61 | 6c 79 7a 65 20 74 65 73 | Ana|lyze tes|
|000005b0| 74 20 72 65 73 75 6c 74 | 73 0a 58 74 73 74 2d 61 |t result|s.Xtst-a|
|000005c0| 6e 6e 6f 74 61 74 65 2e | 65 6c 20 20 20 20 20 20 |nnotate.|el |
|000005d0| 20 20 20 20 20 20 32 20 | 20 20 20 20 20 20 20 20 | 2 | |
|000005e0| 20 20 20 41 6e 6e 6f 74 | 61 74 65 20 70 61 63 6b | Annot|ate pack|
|000005f0| 61 67 65 20 77 69 74 68 | 20 72 65 73 75 6c 74 73 |age with| results|
|00000600| 0a 58 74 73 74 2d 63 61 | 70 74 75 72 65 2e 65 6c |.Xtst-ca|pture.el|
|00000610| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 32 20 20 | | 2 |
|00000620| 20 20 20 20 20 20 20 20 | 20 20 43 61 70 74 75 72 | | Captur|
|00000630| 65 2d 73 74 61 74 65 20 | 72 6f 75 74 69 6e 65 73 |e-state |routines|
|00000640| 0a 58 74 73 74 2d 64 69 | 73 70 6c 61 79 2e 65 6c |.Xtst-di|splay.el|
|00000650| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 33 20 20 | | 3 |
|00000660| 20 20 20 20 20 20 20 20 | 20 20 44 69 73 70 6c 61 | | Displa|
|00000670| 79 20 74 65 73 74 20 72 | 65 73 75 6c 74 73 0a 58 |y test r|esults.X|
|00000680| 74 73 74 2d 65 71 75 61 | 6c 2e 65 6c 20 20 20 20 |tst-equa|l.el |
|00000690| 20 20 20 20 20 20 20 20 | 20 20 20 33 20 20 20 20 | | 3 |
|000006a0| 20 20 20 20 20 20 20 20 | 54 65 73 74 20 73 74 61 | |Test sta|
|000006b0| 74 65 73 20 66 6f 72 20 | 65 71 75 61 6c 69 74 79 |tes for |equality|
|000006c0| 0a 58 74 73 74 2d 69 6e | 65 71 75 61 6c 2e 65 6c |.Xtst-in|equal.el|
|000006d0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 33 20 20 | | 3 |
|000006e0| 20 20 20 20 20 20 20 20 | 20 20 4d 6f 64 69 66 69 | | Modifi|
|000006f0| 63 61 74 69 6f 6e 73 20 | 74 6f 20 6e 6f 74 69 6f |cations |to notio|
|00000700| 6e 20 6f 66 20 65 71 75 | 61 6c 69 74 79 0a 58 74 |n of equ|ality.Xt|
|00000710| 73 74 2d 69 6e 73 74 72 | 75 6d 65 6e 74 2e 65 6c |st-instr|ument.el|
|00000720| 20 20 20 20 20 20 20 20 | 20 20 33 20 20 20 20 20 | | 3 |
|00000730| 20 20 20 20 20 20 20 49 | 6e 73 74 72 75 6d 65 6e | I|nstrumen|
|00000740| 74 20 70 61 63 6b 61 67 | 65 20 66 6f 72 20 74 65 |t packag|e for te|
|00000750| 73 74 69 6e 67 0a 58 74 | 73 74 2d 75 74 69 6c 69 |sting.Xt|st-utili|
|00000760| 74 69 65 73 2e 65 6c 20 | 20 20 20 20 20 20 20 20 |ties.el | |
|00000770| 20 20 32 20 20 20 20 20 | 20 20 20 20 20 20 20 4d | 2 | M|
|00000780| 69 73 63 65 6c 6c 61 6e | 65 6f 75 73 20 75 74 69 |iscellan|eous uti|
|00000790| 6c 69 74 69 65 73 0a 58 | 75 73 65 72 2e 74 65 78 |lities.X|user.tex|
|000007a0| 69 6e 66 6f 2e 65 6c 20 | 20 20 20 20 20 20 20 20 |info.el | |
|000007b0| 20 20 20 32 20 20 20 20 | 20 20 20 20 20 20 20 20 | 2 | |
|000007c0| 57 72 61 70 70 65 72 20 | 66 6f 72 20 68 61 72 64 |Wrapper |for hard|
|000007d0| 2d 63 6f 70 79 20 75 73 | 65 72 20 6d 61 6e 75 61 |-copy us|er manua|
|000007e0| 6c 0a 53 48 41 52 5f 45 | 4f 46 0a 69 66 20 74 65 |l.SHAR_E|OF.if te|
|000007f0| 73 74 20 31 31 34 39 20 | 2d 6e 65 20 22 60 77 63 |st 1149 |-ne "`wc|
|00000800| 20 2d 63 20 3c 20 27 4d | 41 4e 49 46 45 53 54 27 | -c < 'M|ANIFEST'|
|00000810| 60 22 0a 74 68 65 6e 0a | 09 65 63 68 6f 20 73 68 |`".then.|.echo sh|
|00000820| 61 72 3a 20 22 65 72 72 | 6f 72 20 74 72 61 6e 73 |ar: "err|or trans|
|00000830| 6d 69 74 74 69 6e 67 20 | 27 4d 41 4e 49 46 45 53 |mitting |'MANIFES|
|00000840| 54 27 22 20 27 28 73 68 | 6f 75 6c 64 20 68 61 76 |T'" '(sh|ould hav|
|00000850| 65 20 62 65 65 6e 20 31 | 31 34 39 20 63 68 61 72 |e been 1|149 char|
|00000860| 61 63 74 65 72 73 29 27 | 0a 66 69 0a 66 69 0a 65 |acters)'|.fi.fi.e|
|00000870| 63 68 6f 20 73 68 61 72 | 3a 20 22 65 78 74 72 61 |cho shar|: "extra|
|00000880| 63 74 69 6e 67 20 27 74 | 65 73 74 2e 74 65 78 69 |cting 't|est.texi|
|00000890| 6e 66 6f 27 22 20 27 28 | 36 30 38 38 37 20 63 68 |nfo'" '(|60887 ch|
|000008a0| 61 72 61 63 74 65 72 73 | 29 27 0a 69 66 20 74 65 |aracters|)'.if te|
|000008b0| 73 74 20 2d 66 20 27 74 | 65 73 74 2e 74 65 78 69 |st -f 't|est.texi|
|000008c0| 6e 66 6f 27 0a 74 68 65 | 6e 0a 09 65 63 68 6f 20 |nfo'.the|n..echo |
|000008d0| 73 68 61 72 3a 20 22 77 | 69 6c 6c 20 6e 6f 74 20 |shar: "w|ill not |
|000008e0| 6f 76 65 72 2d 77 72 69 | 74 65 20 65 78 69 73 74 |over-wri|te exist|
|000008f0| 69 6e 67 20 66 69 6c 65 | 20 27 74 65 73 74 2e 74 |ing file| 'test.t|
|00000900| 65 78 69 6e 66 6f 27 22 | 0a 65 6c 73 65 0a 73 65 |exinfo'"|.else.se|
|00000910| 64 20 27 73 2f 5e 58 2f | 2f 27 20 3c 3c 20 5c 53 |d 's/^X/|/' << \S|
|00000920| 48 41 52 5f 45 4f 46 20 | 3e 20 27 74 65 73 74 2e |HAR_EOF |> 'test.|
|00000930| 74 65 78 69 6e 66 6f 27 | 0a 58 40 73 65 74 66 69 |texinfo'|.X@setfi|
|00000940| 6c 65 6e 61 6d 65 20 74 | 65 73 74 0a 58 40 6e 6f |lename t|est.X@no|
|00000950| 64 65 20 74 6f 70 2c 20 | 69 6e 74 72 6f 64 75 63 |de top, |introduc|
|00000960| 74 69 6f 6e 2c 20 2c 20 | 28 64 69 72 29 0a 58 40 |tion, , |(dir).X@|
|00000970| 69 66 69 6e 66 6f 0a 58 | 54 68 65 72 65 20 73 68 |ifinfo.X|There sh|
|00000980| 6f 75 6c 64 20 62 65 20 | 6d 6f 72 65 20 6e 6f 64 |ould be |more nod|
|00000990| 65 73 20 74 68 61 6e 20 | 6c 69 73 74 65 64 20 62 |es than |listed b|
|000009a0| 65 6c 6f 77 2c 20 62 75 | 74 20 61 74 20 6c 65 61 |elow, bu|t at lea|
|000009b0| 73 74 20 74 68 65 20 63 | 68 61 70 74 65 72 73 20 |st the c|hapters |
|000009c0| 61 72 65 0a 58 69 73 6f | 6c 61 74 65 64 2e 0a 58 |are.Xiso|lated..X|
|000009d0| 40 6d 65 6e 75 0a 58 2a | 20 69 6e 74 72 6f 64 75 |@menu.X*| introdu|
|000009e0| 63 74 69 6f 6e 3a 3a 09 | 50 75 72 70 6f 73 65 20 |ction::.|Purpose |
|000009f0| 6f 66 20 74 68 65 20 70 | 61 63 6b 61 67 65 2e 0a |of the p|ackage..|
|00000a00| 58 2a 20 73 74 61 72 74 | 69 6e 67 3a 3a 09 09 48 |X* start|ing::..H|
|00000a10| 6f 77 20 74 6f 20 67 65 | 74 20 73 74 61 72 74 65 |ow to ge|t starte|
|00000a20| 64 2e 0a 58 2a 20 74 65 | 73 74 69 6e 67 3a 3a 09 |d..X* te|sting::.|
|00000a30| 09 54 65 73 74 69 6e 67 | 20 61 20 70 61 63 6b 61 |.Testing| a packa|
|00000a40| 67 65 2e 0a 58 2a 20 69 | 6e 73 74 72 75 6d 65 6e |ge..X* i|nstrumen|
|00000a50| 74 69 6e 67 3a 3a 09 49 | 6e 73 74 72 75 6d 65 6e |ting::.I|nstrumen|
|00000a60| 74 69 6e 67 20 74 6f 20 | 6d 65 61 73 75 72 65 20 |ting to |measure |
|00000a70| 74 65 73 74 69 6e 67 20 | 65 66 66 65 63 74 69 76 |testing |effectiv|
|00000a80| 65 6e 65 73 73 2e 0a 58 | 2a 20 61 6e 61 6c 79 7a |eness..X|* analyz|
|00000a90| 69 6e 67 3a 3a 09 09 41 | 6e 61 6c 79 7a 69 6e 67 |ing::..A|nalyzing|
|00000aa0| 20 74 68 65 20 72 65 73 | 75 6c 74 73 20 6f 66 20 | the res|ults of |
|00000ab0| 74 65 73 74 69 6e 67 2e | 0a 58 2a 20 64 69 73 70 |testing.|.X* disp|
|00000ac0| 6c 61 79 69 6e 67 3a 3a | 09 09 44 69 73 70 6c 61 |laying::|..Displa|
|00000ad0| 79 69 6e 67 20 74 68 65 | 20 72 65 73 75 6c 74 73 |ying the| results|
|00000ae0| 20 6f 66 20 61 6e 61 6c | 79 73 69 73 2e 0a 58 2a | of anal|ysis..X*|
|00000af0| 20 72 75 6e 6e 69 6e 67 | 3a 3a 09 09 52 75 6e 6e | running|::..Runn|
|00000b00| 69 6e 67 20 61 20 74 65 | 73 74 73 63 72 69 70 74 |ing a te|stscript|
|00000b10| 20 69 6e 20 62 61 74 63 | 68 2e 0a 58 2a 20 65 70 | in batc|h..X* ep|
|00000b20| 69 6c 6f 67 75 65 3a 3a | 09 09 46 69 6e 61 6c 20 |ilogue::|..Final |
|00000b30| 77 6f 72 64 73 2e 0a 58 | 2a 20 65 78 61 6d 70 6c |words..X|* exampl|
|00000b40| 65 3a 3a 09 09 41 6e 20 | 65 78 61 6d 70 6c 65 20 |e::..An |example |
|00000b50| 70 61 63 6b 61 67 65 20 | 74 6f 20 74 65 73 74 2e |package |to test.|
|00000b60| 0a 58 40 65 6e 64 20 6d | 65 6e 75 0a 58 40 65 6e |.X@end m|enu.X@en|
|00000b70| 64 20 69 66 69 6e 66 6f | 0a 58 40 6e 6f 64 65 20 |d ifinfo|.X@node |
|00000b80| 69 6e 74 72 6f 64 75 63 | 74 69 6f 6e 2c 20 73 74 |introduc|tion, st|
|00000b90| 61 72 74 69 6e 67 2c 20 | 2c 20 74 6f 70 0a 58 0a |arting, |, top.X.|
|00000ba0| 58 40 63 68 61 70 74 65 | 72 20 49 6e 74 72 6f 64 |X@chapte|r Introd|
|00000bb0| 75 63 74 69 6f 6e 0a 58 | 0a 58 54 68 69 73 20 64 |uction.X|.XThis d|
|00000bc0| 6f 63 75 6d 65 6e 74 20 | 65 78 70 6c 61 69 6e 73 |ocument |explains|
|00000bd0| 20 68 6f 77 20 74 6f 20 | 75 73 65 20 74 68 65 20 | how to |use the |
|00000be0| 54 65 73 74 20 70 61 63 | 6b 61 67 65 20 74 6f 20 |Test pac|kage to |
|00000bf0| 74 65 73 74 20 47 4e 55 | 20 45 6d 61 63 73 0a 58 |test GNU| Emacs.X|
|00000c00| 70 61 63 6b 61 67 65 73 | 2e 20 20 49 74 20 69 73 |packages|. It is|
|00000c10| 20 61 6e 20 65 78 74 65 | 6e 73 69 6f 6e 20 6f 66 | an exte|nsion of|
|00000c20| 20 43 68 61 70 74 65 72 | 20 32 32 20 5b 43 6f 6d | Chapter| 22 [Com|
|00000c30| 70 69 6c 69 6e 67 20 61 | 6e 64 20 54 65 73 74 69 |piling a|nd Testi|
|00000c40| 6e 67 0a 58 50 72 6f 67 | 72 61 6d 73 5d 20 6f 66 |ng.XProg|rams] of|
|00000c50| 20 74 68 65 20 47 4e 55 | 20 45 6d 61 63 73 20 52 | the GNU| Emacs R|
|00000c60| 65 66 65 72 65 6e 63 65 | 20 4d 61 6e 75 61 6c 2e |eference| Manual.|
|00000c70| 0a 58 0a 58 40 73 65 63 | 74 69 6f 6e 20 50 75 72 |.X.X@sec|tion Pur|
|00000c80| 70 6f 73 65 20 6f 66 20 | 74 68 65 20 50 61 63 6b |pose of |the Pack|
|00000c90| 61 67 65 0a 58 0a 58 54 | 68 69 73 20 70 61 63 6b |age.X.XT|his pack|
|00000ca0| 61 67 65 20 70 72 6f 76 | 69 64 65 73 20 74 6f 6f |age prov|ides too|
|00000cb0| 6c 73 20 74 6f 20 61 69 | 64 20 69 6e 20 64 65 76 |ls to ai|d in dev|
|00000cc0| 65 6c 6f 70 69 6e 67 20 | 72 65 67 72 65 73 73 69 |eloping |regressi|
|00000cd0| 6f 6e 20 74 65 73 74 73 | 20 66 6f 72 20 45 6d 61 |on tests| for Ema|
|00000ce0| 63 73 0a 58 70 61 63 6b | 61 67 65 73 20 61 6e 64 |cs.Xpack|ages and|
|00000cf0| 20 74 6f 20 61 73 73 65 | 73 73 20 74 68 65 20 65 | to asse|ss the e|
|00000d00| 66 66 69 63 61 63 79 20 | 6f 66 20 74 68 6f 73 65 |fficacy |of those|
|00000d10| 20 74 65 73 74 73 2e 20 | 20 47 4e 55 20 45 6d 61 | tests. | GNU Ema|
|00000d20| 63 73 20 70 61 63 6b 61 | 67 65 73 2c 0a 58 77 72 |cs packa|ges,.Xwr|
|00000d30| 69 74 74 65 6e 20 69 6e | 20 61 20 64 69 61 6c 65 |itten in| a diale|
|00000d40| 63 74 20 6f 66 20 4c 69 | 73 70 2c 20 70 72 6f 76 |ct of Li|sp, prov|
|00000d50| 69 64 65 20 65 78 74 65 | 6e 73 69 6f 6e 73 20 74 |ide exte|nsions t|
|00000d60| 6f 20 74 68 65 20 62 61 | 73 69 63 20 74 65 78 74 |o the ba|sic text|
|00000d70| 20 65 64 69 74 69 6e 67 | 0a 58 66 65 61 74 75 72 | editing|.Xfeatur|
|00000d80| 65 73 20 6f 66 20 45 6d | 61 63 73 2e 20 20 4d 6f |es of Em|acs. Mo|
|00000d90| 73 74 20 6f 66 20 74 68 | 65 73 65 20 70 61 63 6b |st of th|ese pack|
|00000da0| 61 67 65 73 20 70 65 72 | 66 6f 72 6d 20 73 74 61 |ages per|form sta|
|00000db0| 74 65 2d 63 68 61 6e 67 | 69 6e 67 0a 58 6f 70 65 |te-chang|ing.Xope|
|00000dc0| 72 61 74 69 6f 6e 73 2e | 20 20 46 6f 72 20 65 78 |rations.| For ex|
|00000dd0| 61 6d 70 6c 65 2c 20 61 | 20 70 61 63 6b 61 67 65 |ample, a| package|
|00000de0| 20 6d 61 79 20 63 72 65 | 61 74 65 20 6e 65 77 20 | may cre|ate new |
|00000df0| 62 75 66 66 65 72 73 2c | 20 6d 6f 64 69 66 79 20 |buffers,| modify |
|00000e00| 74 65 78 74 2c 0a 58 63 | 68 61 6e 67 65 20 74 68 |text,.Xc|hange th|
|00000e10| 65 20 6c 6f 63 61 74 69 | 6f 6e 73 20 6f 66 20 74 |e locati|ons of t|
|00000e20| 68 65 20 63 75 72 73 6f | 72 20 61 6e 64 20 76 61 |he curso|r and va|
|00000e30| 72 69 6f 75 73 20 6d 61 | 72 6b 73 2c 20 77 72 69 |rious ma|rks, wri|
|00000e40| 74 65 20 66 69 6c 65 73 | 20 6f 72 20 6d 6f 64 69 |te files| or modi|
|00000e50| 66 79 0a 58 61 6e 79 74 | 68 69 6e 67 20 65 6c 73 |fy.Xanyt|hing els|
|00000e60| 65 20 61 63 63 65 73 73 | 69 62 6c 65 20 74 6f 20 |e access|ible to |
|00000e70| 45 6d 61 63 73 20 28 77 | 68 69 63 68 20 69 73 20 |Emacs (w|hich is |
|00000e80| 6a 75 73 74 20 61 62 6f | 75 74 20 65 76 65 72 79 |just abo|ut every|
|00000e90| 74 68 69 6e 67 20 69 6e | 20 55 6e 69 78 29 2e 0a |thing in| Unix)..|
|00000ea0| 58 54 72 61 64 69 74 69 | 6f 6e 61 6c 20 4c 69 73 |XTraditi|onal Lis|
|00000eb0| 70 20 64 65 62 75 67 67 | 69 6e 67 20 73 74 72 61 |p debugg|ing stra|
|00000ec0| 74 65 67 69 65 73 20 61 | 72 65 20 6e 6f 74 20 73 |tegies a|re not s|
|00000ed0| 75 66 66 69 63 69 65 6e | 74 20 74 6f 20 61 64 65 |ufficien|t to ade|
|00000ee0| 71 75 61 74 65 6c 79 20 | 74 65 73 74 0a 58 61 20 |quately |test.Xa |
|00000ef0| 70 61 63 6b 61 67 65 20 | 74 68 61 74 20 70 65 72 |package |that per|
|00000f00| 66 6f 72 6d 73 20 65 78 | 74 65 6e 73 69 76 65 20 |forms ex|tensive |
|00000f10| 73 74 61 74 65 2d 6d 61 | 6e 69 70 75 6c 61 74 69 |state-ma|nipulati|
|00000f20| 6f 6e 2e 20 20 54 68 65 | 20 54 65 73 74 20 70 61 |on. The| Test pa|
|00000f30| 63 6b 61 67 65 0a 58 70 | 72 6f 76 69 64 65 73 20 |ckage.Xp|rovides |
|00000f40| 61 20 73 74 72 61 74 65 | 67 79 20 74 68 61 74 20 |a strate|gy that |
|00000f50| 69 73 2e 0a 58 0a 58 40 | 73 65 63 74 69 6f 6e 20 |is..X.X@|section |
|00000f60| 54 65 73 74 20 41 70 70 | 72 6f 61 63 68 0a 58 0a |Test App|roach.X.|
|00000f70| 58 54 68 65 20 54 65 73 | 74 20 73 79 73 74 65 6d |XThe Tes|t system|
|00000f80| 20 69 73 20 64 65 73 69 | 67 6e 65 64 20 74 6f 20 | is desi|gned to |
|00000f90| 73 75 70 70 6f 72 74 20 | 73 74 72 75 63 74 75 72 |support |structur|
|00000fa0| 61 6c 20 28 6f 72 20 60 | 60 77 68 69 74 65 2d 62 |al (or `|`white-b|
|00000fb0| 6f 78 27 27 29 0a 58 74 | 65 73 74 69 6e 67 2e 20 |ox'').Xt|esting. |
|00000fc0| 20 28 41 6e 6f 74 68 65 | 72 20 63 6f 6d 6d 6f 6e | (Anothe|r common|
|00000fd0| 6c 79 20 75 73 65 64 20 | 74 65 73 74 20 61 70 70 |ly used |test app|
|00000fe0| 72 6f 61 63 68 20 69 73 | 20 66 75 6e 63 74 69 6f |roach is| functio|
|00000ff0| 6e 61 6c 2c 20 6f 72 0a | 58 60 60 62 6c 61 63 6b |nal, or.|X``black|
|00001000| 2d 62 6f 78 27 27 20 74 | 65 73 74 69 6e 67 2e 29 |-box'' t|esting.)|
|00001010| 20 20 49 74 20 61 75 74 | 6f 6d 61 74 65 73 20 74 | It aut|omates t|
|00001020| 68 65 20 70 72 6f 63 65 | 73 73 20 6f 66 20 72 75 |he proce|ss of ru|
|00001030| 6e 6e 69 6e 67 20 61 20 | 6e 75 6d 62 65 72 20 6f |nning a |number o|
|00001040| 66 0a 58 74 65 73 74 73 | 20 63 61 73 65 73 20 64 |f.Xtests| cases d|
|00001050| 65 73 69 67 6e 65 64 20 | 74 6f 20 61 6e 61 6c 79 |esigned |to analy|
|00001060| 7a 65 20 60 60 63 6f 76 | 65 72 61 67 65 27 27 20 |ze ``cov|erage'' |
|00001070| 6f 66 20 74 68 65 20 70 | 61 63 6b 61 67 65 20 28 |of the p|ackage (|
|00001080| 74 68 61 74 20 69 73 2c | 20 66 69 6e 64 0a 58 70 |that is,| find.Xp|
|00001090| 61 72 74 73 20 6f 66 20 | 74 68 65 20 63 6f 64 65 |arts of |the code|
|000010a0| 20 74 68 61 74 20 61 72 | 65 20 6e 6f 74 20 65 78 | that ar|e not ex|
|000010b0| 65 72 63 69 73 65 64 29 | 20 61 6e 64 20 60 60 65 |ercised)| and ``e|
|000010c0| 78 70 72 65 73 73 69 6f | 6e 27 27 20 28 74 68 61 |xpressio|n'' (tha|
|000010d0| 74 20 69 73 2c 20 77 68 | 61 74 0a 58 76 61 6c 75 |t is, wh|at.Xvalu|
|000010e0| 65 73 20 61 72 65 20 72 | 65 74 75 72 6e 65 64 20 |es are r|eturned |
|000010f0| 62 79 20 65 61 63 68 20 | 65 78 70 72 65 73 73 69 |by each |expressi|
|00001100| 6f 6e 2c 20 61 6e 64 20 | 77 68 69 63 68 20 65 78 |on, and |which ex|
|00001110| 70 72 65 73 73 69 6f 6e | 73 20 61 6c 77 61 79 73 |pression|s always|
|00001120| 0a 58 72 65 74 75 72 6e | 65 64 20 74 68 65 20 73 |.Xreturn|ed the s|
|00001130| 61 6d 65 20 76 61 6c 75 | 65 73 29 2e 0a 58 0a 58 |ame valu|es)..X.X|
|00001140| 40 73 65 63 74 69 6f 6e | 20 54 65 73 74 69 6e 67 |@section| Testing|
|00001150| 20 4d 65 74 68 6f 64 0a | 58 0a 58 54 65 73 74 20 | Method.|X.XTest |
|00001160| 70 72 6f 76 69 64 65 73 | 20 6d 65 63 68 61 6e 69 |provides| mechani|
|00001170| 73 6d 73 20 74 6f 20 65 | 61 73 65 20 74 68 65 20 |sms to e|ase the |
|00001180| 63 72 65 61 74 69 6f 6e | 20 61 6e 64 20 65 78 65 |creation| and exe|
|00001190| 63 75 74 69 6f 6e 20 6f | 66 20 73 65 74 73 20 6f |cution o|f sets o|
|000011a0| 66 0a 58 74 65 73 74 73 | 2e 20 20 53 6f 6d 65 20 |f.Xtests|. Some |
|000011b0| 6f 66 20 74 68 65 20 66 | 65 61 74 75 72 65 73 20 |of the f|eatures |
|000011c0| 61 72 65 20 64 65 73 69 | 67 6e 65 64 20 74 6f 20 |are desi|gned to |
|000011d0| 73 69 6d 70 6c 69 66 79 | 20 74 65 73 74 69 6e 67 |simplify| testing|
|000011e0| 20 61 63 74 69 76 69 74 | 79 2c 0a 58 77 68 69 6c | activit|y,.Xwhil|
|000011f0| 65 20 6f 74 68 65 72 73 | 20 61 72 65 20 64 65 73 |e others| are des|
|00001200| 69 67 6e 65 64 20 74 6f | 20 61 69 64 20 74 68 65 |igned to| aid the|
|00001210| 20 61 6e 61 6c 79 73 69 | 73 20 6f 66 20 74 65 73 | analysi|s of tes|
|00001220| 74 69 6e 67 2e 0a 58 0a | 58 54 65 73 74 20 73 75 |ting..X.|XTest su|
|00001230| 70 70 6f 72 74 73 20 63 | 6f 76 65 72 61 67 65 20 |pports c|overage |
|00001240| 74 65 73 74 69 6e 67 2e | 20 20 54 68 61 74 20 69 |testing.| That i|
|00001250| 73 2c 20 69 74 20 70 72 | 6f 76 69 64 65 73 20 69 |s, it pr|ovides i|
|00001260| 6e 73 74 72 75 6d 65 6e | 74 61 74 69 6f 6e 0a 58 |nstrumen|tation.X|
|00001270| 6d 65 63 68 61 6e 69 73 | 6d 73 20 64 65 73 69 67 |mechanis|ms desig|
|00001280| 6e 65 64 20 74 6f 20 63 | 68 65 63 6b 20 66 6f 72 |ned to c|heck for|
|00001290| 20 69 6e 61 64 65 71 75 | 61 63 69 65 73 20 6f 66 | inadequ|acies of|
|000012a0| 20 74 65 73 74 69 6e 67 | 20 6f 66 20 74 68 65 20 | testing| of the |
|000012b0| 66 6f 6c 6c 6f 77 69 6e | 67 0a 58 74 77 6f 20 66 |followin|g.Xtwo f|
|000012c0| 6f 72 6d 73 3a 0a 58 40 | 69 74 65 6d 69 7a 65 20 |orms:.X@|itemize |
|000012d0| 40 62 75 6c 6c 65 74 0a | 58 40 69 74 65 6d 0a 58 |@bullet.|X@item.X|
|000012e0| 46 61 69 6c 75 72 65 20 | 74 6f 20 65 78 65 63 75 |Failure |to execu|
|000012f0| 74 65 20 61 6e 20 65 78 | 70 72 65 73 73 69 6f 6e |te an ex|pression|
|00001300| 2e 0a 58 40 69 74 65 6d | 0a 58 46 61 69 6c 75 72 |..X@item|.XFailur|
|00001310| 65 20 74 6f 20 70 72 6f | 64 75 63 65 20 6d 6f 72 |e to pro|duce mor|
|00001320| 65 20 74 68 61 6e 20 6f | 6e 65 20 76 61 6c 75 65 |e than o|ne value|
|00001330| 20 66 6f 72 20 61 6e 20 | 65 78 70 72 65 73 73 69 | for an |expressi|
|00001340| 6f 6e 2e 0a 58 40 65 6e | 64 20 69 74 65 6d 69 7a |on..X@en|d itemiz|
|00001350| 65 0a 58 49 6e 20 65 61 | 63 68 20 63 61 73 65 2c |e.XIn ea|ch case,|
|00001360| 20 74 68 65 20 66 61 75 | 6c 74 20 6d 61 79 20 62 | the fau|lt may b|
|00001370| 65 20 69 6e 20 74 68 65 | 20 74 65 73 74 73 20 28 |e in the| tests (|
|00001380| 69 2e 65 2e 2c 20 6e 6f | 74 20 65 6e 6f 75 67 68 |i.e., no|t enough|
|00001390| 20 74 65 73 74 69 6e 67 | 20 77 61 73 0a 58 70 65 | testing| was.Xpe|
|000013a0| 72 66 6f 72 6d 65 64 29 | 2c 20 6f 72 20 74 68 65 |rformed)|, or the|
|000013b0| 20 66 61 75 6c 74 20 6d | 61 79 20 62 65 20 69 6e | fault m|ay be in|
|000013c0| 20 74 68 65 20 70 72 6f | 67 72 61 6d 20 28 69 2e | the pro|gram (i.|
|000013d0| 65 2e 2c 20 61 6e 20 60 | 60 75 6e 6e 65 63 65 73 |e., an `|`unneces|
|000013e0| 73 61 72 69 6c 79 0a 58 | 63 6f 6d 70 6c 65 78 27 |sarily.X|complex'|
|000013f0| 27 20 70 72 6f 67 72 61 | 6d 20 68 61 73 20 62 65 |' progra|m has be|
|00001400| 65 6e 20 77 72 69 74 74 | 65 6e 29 2e 20 20 28 54 |en writt|en). (T|
|00001410| 68 65 72 65 20 69 73 20 | 61 6c 73 6f 20 74 68 65 |here is |also the|
|00001420| 20 70 6f 73 73 69 62 69 | 6c 69 74 79 20 74 68 61 | possibi|lity tha|
|00001430| 74 0a 58 6e 6f 20 66 61 | 75 6c 74 20 65 78 69 73 |t.Xno fa|ult exis|
|00001440| 74 73 2c 20 73 75 63 68 | 20 61 73 20 74 68 65 20 |ts, such| as the |
|00001450| 75 73 65 20 6f 66 20 60 | 60 63 6f 6e 73 74 61 6e |use of `|`constan|
|00001460| 74 27 27 20 66 75 6e 63 | 74 69 6f 6e 73 20 66 6f |t'' func|tions fo|
|00001470| 72 20 72 65 61 64 61 62 | 69 6c 69 74 79 0a 58 6f |r readab|ility.Xo|
|00001480| 72 20 73 74 79 6c 65 2e | 20 20 49 6e 20 70 72 61 |r style.| In pra|
|00001490| 63 74 69 63 65 20 74 68 | 65 73 65 20 63 61 73 65 |ctice th|ese case|
|000014a0| 73 20 61 72 65 20 65 61 | 73 79 20 74 6f 20 69 64 |s are ea|sy to id|
|000014b0| 65 6e 74 69 66 79 20 61 | 6e 64 20 69 67 6e 6f 72 |entify a|nd ignor|
|000014c0| 65 2e 29 0a 58 0a 58 59 | 6f 75 20 73 68 6f 75 6c |e.).X.XY|ou shoul|
|000014d0| 64 20 75 73 65 20 74 68 | 65 20 66 6f 6c 6c 6f 77 |d use th|e follow|
|000014e0| 69 6e 67 20 73 74 72 61 | 74 65 67 79 20 69 6e 20 |ing stra|tegy in |
|000014f0| 63 72 65 61 74 69 6e 67 | 20 74 65 73 74 73 20 77 |creating| tests w|
|00001500| 69 74 68 20 74 68 69 73 | 0a 58 73 79 73 74 65 6d |ith this|.Xsystem|
|00001510| 3a 0a 58 40 65 6e 75 6d | 65 72 61 74 65 0a 58 40 |:.X@enum|erate.X@|
|00001520| 69 74 65 6d 0a 58 43 72 | 65 61 74 65 20 61 20 73 |item.XCr|eate a s|
|00001530| 69 6d 70 6c 65 20 73 65 | 74 20 6f 66 20 74 65 73 |imple se|t of tes|
|00001540| 74 73 20 74 68 61 74 20 | 61 70 70 65 61 72 20 74 |ts that |appear t|
|00001550| 6f 20 62 65 20 6e 65 63 | 65 73 73 61 72 79 20 74 |o be nec|essary t|
|00001560| 6f 20 74 65 73 74 20 74 | 68 65 20 62 61 73 69 63 |o test t|he basic|
|00001570| 0a 58 66 75 6e 63 74 69 | 6f 6e 61 6c 69 74 79 20 |.Xfuncti|onality |
|00001580| 6f 66 20 74 68 65 20 70 | 61 63 6b 61 67 65 2e 0a |of the p|ackage..|
|00001590| 58 40 69 74 65 6d 0a 58 | 41 64 64 20 61 64 64 69 |X@item.X|Add addi|
|000015a0| 74 69 6f 6e 61 6c 20 74 | 65 73 74 73 20 74 6f 20 |tional t|ests to |
|000015b0| 65 6e 73 75 72 65 20 74 | 68 61 74 20 65 76 65 72 |ensure t|hat ever|
|000015c0| 79 20 65 78 70 72 65 73 | 73 69 6f 6e 20 69 73 20 |y expres|sion is |
|000015d0| 65 78 65 63 75 74 65 64 | 2c 20 61 6e 64 20 74 68 |executed|, and th|
|000015e0| 61 74 0a 58 65 61 63 68 | 20 65 78 70 72 65 73 73 |at.Xeach| express|
|000015f0| 69 6f 6e 20 70 72 6f 64 | 75 63 65 73 20 61 74 20 |ion prod|uces at |
|00001600| 6c 65 61 73 74 20 74 77 | 6f 20 76 61 6c 75 65 73 |least tw|o values|
|00001610| 20 6f 76 65 72 20 74 68 | 65 20 65 6e 74 69 72 65 | over th|e entire|
|00001620| 20 73 65 74 20 6f 66 20 | 74 65 73 74 73 2e 0a 58 | set of |tests..X|
|00001630| 40 69 74 65 6d 0a 58 52 | 75 6e 20 74 68 65 20 73 |@item.XR|un the s|
|00001640| 65 74 20 6f 66 20 74 65 | 73 74 73 20 77 69 74 68 |et of te|sts with|
|00001650| 20 69 6e 73 74 72 75 6d | 65 6e 74 61 74 69 6f 6e | instrum|entation|
|00001660| 20 74 6f 20 63 68 65 63 | 6b 20 66 6f 72 20 69 6e | to chec|k for in|
|00001670| 61 64 65 71 75 61 63 69 | 65 73 2e 0a 58 40 69 74 |adequaci|es..X@it|
|00001680| 65 6d 0a 58 49 66 20 74 | 68 65 72 65 20 61 72 65 |em.XIf t|here are|
|00001690| 20 72 65 70 6f 72 74 65 | 64 20 69 6e 61 64 65 71 | reporte|d inadeq|
|000016a0| 75 61 63 69 65 73 2c 20 | 74 68 65 6e 20 63 6f 72 |uacies, |then cor|
|000016b0| 72 65 63 74 20 74 68 65 | 20 63 6f 64 65 20 6f 72 |rect the| code or|
|000016c0| 20 69 6d 70 72 6f 76 65 | 20 74 68 65 0a 58 74 65 | improve| the.Xte|
|000016d0| 73 74 69 6e 67 2c 20 61 | 6e 64 20 67 6f 20 62 61 |sting, a|nd go ba|
|000016e0| 63 6b 20 74 6f 20 74 68 | 65 20 70 72 65 76 69 6f |ck to th|e previo|
|000016f0| 75 73 20 73 74 65 70 2e | 0a 58 40 65 6e 64 20 65 |us step.|.X@end e|
|00001700| 6e 75 6d 65 72 61 74 65 | 0a 58 54 68 65 72 65 20 |numerate|.XThere |
|00001710| 69 73 20 6e 6f 20 67 75 | 61 72 61 6e 74 65 65 20 |is no gu|arantee |
|00001720| 74 68 61 74 20 61 20 73 | 65 74 20 6f 66 20 74 65 |that a s|et of te|
|00001730| 73 74 73 20 74 68 61 74 | 20 70 61 73 73 65 73 20 |sts that| passes |
|00001740| 74 68 65 73 65 20 63 6f | 76 65 72 61 67 65 20 63 |these co|verage c|
|00001750| 68 65 63 6b 73 0a 58 77 | 69 6c 6c 20 66 69 6e 64 |hecks.Xw|ill find|
|00001760| 20 61 6c 6c 20 65 72 72 | 6f 72 73 2e 20 20 42 75 | all err|ors. Bu|
|00001770| 74 2c 20 73 75 63 68 20 | 61 20 73 65 74 20 6f 66 |t, such |a set of|
|00001780| 20 74 65 73 74 73 20 68 | 61 73 20 74 68 65 20 70 | tests h|as the p|
|00001790| 72 6f 70 65 72 74 79 20 | 74 68 61 74 20 65 76 65 |roperty |that eve|
|000017a0| 72 79 0a 58 65 78 70 72 | 65 73 73 69 6f 6e 20 69 |ry.Xexpr|ession i|
|000017b0| 6e 20 74 68 65 20 63 6f | 64 65 20 68 61 73 20 62 |n the co|de has b|
|000017c0| 65 65 6e 20 65 78 65 72 | 63 69 73 65 64 20 69 6e |een exer|cised in|
|000017d0| 20 61 20 6d 69 6e 69 6d | 61 6c 6c 79 20 73 69 67 | a minim|ally sig|
|000017e0| 6e 69 66 69 63 61 6e 74 | 20 77 61 79 0a 58 28 69 |nificant| way.X(i|
|000017f0| 2e 65 2e 2c 20 65 76 65 | 72 79 20 65 78 70 72 65 |.e., eve|ry expre|
|00001800| 73 73 69 6f 6e 20 68 61 | 73 20 70 72 6f 64 75 63 |ssion ha|s produc|
|00001810| 65 64 20 61 74 20 6c 65 | 61 73 74 20 74 77 6f 20 |ed at le|ast two |
|00001820| 64 69 66 66 65 72 65 6e | 74 20 76 61 6c 75 65 73 |differen|t values|
|00001830| 29 2e 20 20 49 6e 0a 58 | 70 72 61 63 74 69 63 65 |). In.X|practice|
|00001840| 2c 20 61 20 67 72 65 61 | 74 20 6e 75 6d 62 65 72 |, a grea|t number|
|00001850| 20 6f 66 20 65 72 72 6f | 72 73 20 63 61 6e 20 62 | of erro|rs can b|
|00001860| 65 20 64 65 74 65 63 74 | 65 64 20 77 69 74 68 20 |e detect|ed with |
|00001870| 74 68 69 73 20 6d 65 74 | 68 6f 64 2e 0a 58 0a 58 |this met|hod..X.X|
|00001880| 54 68 65 20 69 6d 70 6f | 72 74 61 6e 63 65 20 6f |The impo|rtance o|
|00001890| 66 20 63 6f 76 65 72 61 | 67 65 20 74 65 73 74 69 |f covera|ge testi|
|000018a0| 6e 67 20 69 6e 63 72 65 | 61 73 65 73 20 61 73 20 |ng incre|ases as |
|000018b0| 61 20 70 61 63 6b 61 67 | 65 20 69 73 20 6d 6f 64 |a packag|e is mod|
|000018c0| 69 66 69 65 64 2e 0a 58 | 43 68 61 6e 67 65 73 20 |ified..X|Changes |
|000018d0| 74 6f 20 6f 6e 65 20 70 | 61 72 74 20 6f 66 20 61 |to one p|art of a|
|000018e0| 20 70 61 63 6b 61 67 65 | 20 6d 61 79 20 68 61 76 | package| may hav|
|000018f0| 65 20 75 6e 65 78 70 65 | 63 74 65 64 20 65 66 66 |e unexpe|cted eff|
|00001900| 65 63 74 73 20 6f 6e 20 | 6f 74 68 65 72 0a 58 28 |ects on |other.X(|
|00001910| 75 6e 63 6f 6e 73 69 64 | 65 72 65 64 29 20 70 61 |unconsid|ered) pa|
|00001920| 72 74 73 2e 20 20 43 6f | 76 65 72 61 67 65 20 74 |rts. Co|verage t|
|00001930| 65 73 74 69 6e 67 20 65 | 6e 73 75 72 65 73 20 74 |esting e|nsures t|
|00001940| 68 61 74 20 61 6c 6c 20 | 70 61 72 74 73 20 6f 66 |hat all |parts of|
|00001950| 20 61 20 70 61 63 6b 61 | 67 65 0a 58 61 72 65 20 | a packa|ge.Xare |
|00001960| 74 65 73 74 65 64 2c 20 | 61 74 20 6c 65 61 73 74 |tested, |at least|
|00001970| 20 6d 69 6e 69 6d 61 6c | 6c 79 2e 20 20 43 6f 76 | minimal|ly. Cov|
|00001980| 65 72 61 67 65 20 74 65 | 73 74 73 20 61 6c 73 6f |erage te|sts also|
|00001990| 20 73 65 72 76 65 20 61 | 73 20 61 0a 58 73 70 65 | serve a|s a.Xspe|
|000019a0| 63 69 66 69 63 61 74 69 | 6f 6e 20 6f 66 20 74 68 |cificati|on of th|
|000019b0| 65 20 66 75 6e 63 74 69 | 6f 6e 61 6c 69 74 79 20 |e functi|onality |
|000019c0| 6f 66 20 61 20 70 61 63 | 6b 61 67 65 2e 0a 58 0a |of a pac|kage..X.|
|000019d0| 58 46 69 67 75 72 65 20 | 31 20 69 6c 6c 75 73 74 |XFigure |1 illust|
|000019e0| 72 61 74 65 73 20 74 68 | 65 20 6f 76 65 72 61 6c |rates th|e overal|
|000019f0| 6c 20 66 6c 6f 77 20 6f | 66 20 65 76 65 6e 74 73 |l flow o|f events|
|00001a00| 20 75 73 69 6e 67 20 74 | 68 69 73 20 74 65 73 74 | using t|his test|
|00001a10| 0a 58 61 70 70 72 6f 61 | 63 68 2e 0a 58 0a 58 40 |.Xapproa|ch..X.X@|
|00001a20| 67 72 6f 75 70 0a 58 40 | 65 78 61 6d 70 6c 65 0a |group.X@|example.|
|00001a30| 58 20 20 20 20 20 20 20 | 20 2b 2d 2d 2d 2d 2d 2d |X | +------|
|00001a40| 2d 2d 2d 2d 2d 2d 2b 20 | 20 20 20 20 20 20 20 20 |------+ | |
|00001a50| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001a60| 2b 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2b |+-------|-------+|
|00001a70| 0a 58 20 20 20 20 20 20 | 20 20 7c 20 49 6e 73 74 |.X | | Inst|
|00001a80| 72 75 6d 65 6e 74 20 7c | 20 20 20 20 20 20 20 20 |rument || |
|00001a90| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001aa0| 20 7c 20 47 65 6e 65 72 | 61 74 65 20 20 20 20 20 | | Gener|ate |
|00001ab0| 7c 0a 58 20 20 20 20 20 | 20 20 20 7c 20 6f 20 43 ||.X | | o C|
|00001ac0| 6f 6e 74 72 6f 6c 20 20 | 7c 20 20 20 20 20 20 20 |ontrol || |
|00001ad0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001ae0| 20 20 7c 20 6f 20 54 65 | 73 74 20 43 61 73 65 73 | | o Te|st Cases|
|00001af0| 20 7c 0a 58 20 20 20 20 | 20 20 20 20 7c 20 6f 20 | |.X | | o |
|00001b00| 44 61 74 61 20 20 20 20 | 20 7c 20 20 20 20 20 20 |Data | | |
|00001b10| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001b20| 20 20 20 7c 20 6f 20 53 | 63 72 69 70 74 28 73 29 | | o S|cript(s)|
|00001b30| 20 20 7c 0a 58 20 20 20 | 20 20 20 20 20 2b 2d 2d | |.X | +--|
|00001b40| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2b 20 20 20 20 20 |--------|--+ |
|00001b50| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001b60| 20 20 20 20 2b 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d | +---|--------|
|00001b70| 2d 2d 2d 2b 0a 58 20 20 | 20 20 20 20 20 20 20 20 |---+.X | |
|00001b80| 20 20 20 20 20 20 20 20 | 20 20 20 20 5c 20 20 20 | | \ |
|00001b90| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001ba0| 20 20 20 20 2f 20 20 20 | 20 20 5e 0a 58 20 20 20 | / | ^.X |
|00001bb0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001bc0| 20 20 20 20 5c 20 20 20 | 20 20 20 20 20 20 20 20 | \ | |
|00001bd0| 20 20 20 20 20 20 20 20 | 20 20 2f 20 20 20 20 20 | | / |
|00001be0| 20 7c 0a 58 20 20 20 20 | 20 20 20 20 20 20 20 20 | |.X | |
|00001bf0| 20 20 20 20 20 20 20 20 | 20 20 20 20 5c 20 20 20 | | \ |
|00001c00| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001c10| 2f 20 20 20 20 20 20 20 | 7c 0a 58 20 20 20 20 20 |/ ||.X |
|00001c20| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001c30| 20 20 20 20 5c 20 20 20 | 20 20 20 20 20 20 20 20 | \ | |
|00001c40| 20 20 20 20 20 20 2f 20 | 20 20 20 20 20 20 20 7c | / | ||
|00001c50| 0a 58 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |.X | |
|00001c60| 20 20 20 20 20 20 20 20 | 20 20 20 20 5c 20 20 20 | | \ |
|00001c70| 20 20 20 20 20 20 20 20 | 20 20 20 20 2f 20 20 20 | | / |
|00001c80| 20 20 20 20 20 20 7c 0a | 58 20 20 20 20 20 20 20 | |.|X |
|00001c90| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001ca0| 20 20 20 20 5c 20 20 20 | 20 20 20 20 20 20 20 20 | \ | |
|00001cb0| 20 20 2f 20 20 20 20 20 | 20 20 20 20 20 7c 0a 58 | / | |.X|
|00001cc0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001cd0| 20 20 20 20 20 20 20 20 | 20 20 20 2b 2d 2d 2d 2d | | +----|
|00001ce0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2b 20 20 20 20 20 20 |--------|-+ |
|00001cf0| 20 20 20 20 7c 0a 58 20 | 20 20 20 20 20 20 20 20 | |.X | |
|00001d00| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001d10| 20 20 7c 20 20 20 45 78 | 65 63 75 74 65 20 20 20 | | Ex|ecute |
|00001d20| 7c 20 20 20 20 20 20 20 | 20 20 20 7c 0a 58 20 20 || | |.X |
|00001d30| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001d40| 20 20 20 20 20 20 20 20 | 20 7c 20 20 20 20 20 74 | | | t|
|00001d50| 68 65 20 20 20 20 20 7c | 20 20 20 20 20 20 20 20 |he || |
|00001d60| 20 20 7c 0a 58 20 20 20 | 20 20 20 20 20 20 20 20 | |.X | |
|00001d70| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001d80| 7c 20 20 20 54 65 73 74 | 28 73 29 20 20 20 7c 20 || Test|(s) | |
|00001d90| 20 20 20 20 20 20 20 20 | 20 7c 0a 58 20 20 20 20 | | |.X |
|00001da0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001db0| 20 20 20 20 20 20 20 2b | 2d 2d 2d 2d 2d 2d 2d 2d | +|--------|
|00001dc0| 2d 2d 2d 2d 2d 2b 20 20 | 20 20 20 20 20 20 20 20 |-----+ | |
|00001dd0| 7c 0a 58 20 20 20 20 20 | 20 20 20 20 20 20 20 20 ||.X | |
|00001de0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001df0| 20 20 20 20 20 7c 20 20 | 20 20 20 20 20 20 20 20 | | | |
|00001e00| 20 20 20 20 20 20 20 7c | 0a 58 20 20 20 20 20 20 | ||.X |
|00001e10| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001e20| 20 20 20 20 20 20 20 20 | 20 20 20 20 7c 20 20 20 | | | |
|00001e30| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 7c 0a | | |.|
|00001e40| 58 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |X | |
|00001e50| 20 20 20 20 20 20 20 20 | 20 20 20 20 2b 2d 2d 2d | | +---|
|00001e60| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2b 20 20 20 20 20 |--------|--+ |
|00001e70| 20 20 20 20 20 7c 0a 58 | 20 20 20 20 20 20 20 20 | |.X| |
|00001e80| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001e90| 20 20 20 7c 20 20 20 41 | 6e 61 6c 79 7a 65 2c 20 | | A|nalyze, |
|00001ea0| 20 7c 20 20 20 20 20 20 | 20 20 20 20 7c 0a 58 20 | | | |.X |
|00001eb0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001ec0| 20 20 20 20 20 20 20 20 | 20 20 7c 20 20 20 44 69 | | | Di|
|00001ed0| 73 70 6c 61 79 20 20 20 | 7c 20 20 20 20 20 20 20 |splay || |
|00001ee0| 20 20 20 7c 0a 58 20 20 | 20 20 20 20 20 20 20 20 | |.X | |
|00001ef0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001f00| 20 7c 20 20 20 52 65 73 | 75 6c 74 73 20 20 20 7c | | Res|ults ||
|00001f10| 20 20 20 20 20 20 20 20 | 20 20 7c 0a 58 20 20 20 | | |.X |
|00001f20| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001f30| 20 20 20 20 20 20 20 20 | 2b 2d 2d 2d 2d 2d 2d 2d | |+-------|
|00001f40| 2d 2d 2d 2d 2d 2d 2b 20 | 20 20 20 20 20 20 20 20 |------+ | |
|00001f50| 20 7c 0a 58 20 20 20 20 | 20 20 20 20 20 20 20 20 | |.X | |
|00001f60| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001f70| 20 20 20 20 20 20 7c 20 | 20 20 20 20 20 20 20 20 | | | |
|00001f80| 20 20 20 20 20 20 20 20 | 7c 0a 58 20 20 20 20 20 | ||.X |
|00001f90| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001fa0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 7c 20 20 | | | |
|00001fb0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 7c | | ||
|00001fc0| 0a 58 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |.X | |
|00001fd0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00001fe0| 20 20 20 20 5e 20 20 20 | 20 20 20 20 20 20 20 20 | ^ | |
|00001ff0| 20 20 20 20 20 20 7c 0a | 58 20 20 20 20 20 20 20 | |.|X |
|00002000| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002010| 20 20 20 20 20 20 20 20 | 20 2f 20 20 20 5c 20 20 | | / \ |
|00002020| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 7c 0a 58 | | |.X|
|00002030| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002040| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 2f | | /|
|00002050| 20 20 20 20 20 5c 20 20 | 4e 6f 20 20 20 20 20 20 | \ |No |
|00002060| 20 20 20 20 7c 0a 58 20 | 20 20 20 20 20 20 20 20 | |.X | |
|00002070| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002080| 20 20 20 20 20 3c 20 44 | 6f 6e 65 3f 20 3e 2d 2d | < D|one? >--|
|00002090| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2b 0a 58 20 20 |--------|---+.X |
|000020a0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000020b0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 5c 20 20 | | \ |
|000020c0| 20 20 20 2f 0a 58 20 20 | 20 20 20 20 20 20 20 20 | /.X | |
|000020d0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000020e0| 20 20 20 20 20 20 5c 20 | 20 20 2f 0a 58 20 20 20 | \ | /.X |
|000020f0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002100| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 5c 20 | | \ |
|00002110| 2f 0a 58 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |/.X | |
|00002120| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002130| 20 20 20 20 20 76 0a 58 | 20 20 20 20 20 20 20 20 | v.X| |
|00002140| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002150| 20 20 20 20 20 20 20 20 | 20 20 7c 20 59 65 73 0a | | | Yes.|
|00002160| 58 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |X | |
|00002170| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002180| 20 20 20 7c 28 54 65 73 | 74 20 47 6f 61 6c 73 20 | |(Tes|t Goals |
|00002190| 41 63 68 69 65 76 65 64 | 29 0a 58 20 20 20 20 20 |Achieved|).X |
|000021a0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000021b0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 56 0a 58 | | V.X|
|000021c0| 0a 58 0a 58 0a 58 40 65 | 6e 64 20 65 78 61 6d 70 |.X.X.X@e|nd examp|
|000021d0| 6c 65 0a 58 40 63 65 6e | 74 65 72 20 46 69 67 75 |le.X@cen|ter Figu|
|000021e0| 72 65 20 31 2e 20 20 47 | 65 6e 65 72 61 6c 20 54 |re 1. G|eneral T|
|000021f0| 65 73 74 20 41 6c 67 6f | 72 69 74 68 6d 0a 58 40 |est Algo|rithm.X@|
|00002200| 65 6e 64 20 67 72 6f 75 | 70 0a 58 0a 58 40 73 65 |end grou|p.X.X@se|
|00002210| 63 74 69 6f 6e 20 4f 76 | 65 72 76 69 65 77 0a 58 |ction Ov|erview.X|
|00002220| 0a 58 54 68 65 20 54 65 | 73 74 20 70 72 6f 64 75 |.XThe Te|st produ|
|00002230| 63 74 20 63 6f 6e 73 69 | 73 74 73 20 6f 66 20 66 |ct consi|sts of f|
|00002240| 6f 75 72 20 6d 61 6a 6f | 72 20 73 75 62 73 79 73 |our majo|r subsys|
|00002250| 74 65 6d 73 3a 0a 58 40 | 69 74 65 6d 69 7a 65 20 |tems:.X@|itemize |
|00002260| 40 62 75 6c 6c 65 74 0a | 58 40 69 74 65 6d 0a 58 |@bullet.|X@item.X|
|00002270| 52 65 67 72 65 73 73 69 | 6f 6e 20 53 75 62 73 79 |Regressi|on Subsy|
|00002280| 73 74 65 6d 20 2d 2d 20 | 61 20 73 65 74 20 6f 66 |stem -- |a set of|
|00002290| 20 66 75 6e 63 74 69 6f | 6e 73 20 74 6f 20 73 75 | functio|ns to su|
|000022a0| 70 70 6f 72 74 20 72 65 | 67 72 65 73 73 69 6f 6e |pport re|gression|
|000022b0| 20 74 65 73 74 69 6e 67 | 20 6f 66 0a 58 45 6d 61 | testing| of.XEma|
|000022c0| 63 73 20 70 61 63 6b 61 | 67 65 73 2e 0a 58 40 69 |cs packa|ges..X@i|
|000022d0| 74 65 6d 0a 58 43 6f 76 | 65 72 61 67 65 20 53 75 |tem.XCov|erage Su|
|000022e0| 62 73 79 73 74 65 6d 20 | 2d 2d 20 61 20 73 65 74 |bsystem |-- a set|
|000022f0| 20 6f 66 20 66 75 6e 63 | 74 69 6f 6e 73 20 74 6f | of func|tions to|
|00002300| 20 73 75 70 70 6f 72 74 | 20 63 6f 76 65 72 61 67 | support| coverag|
|00002310| 65 20 74 65 73 74 69 6e | 67 20 6f 66 0a 58 45 6d |e testin|g of.XEm|
|00002320| 61 63 73 20 70 61 63 6b | 61 67 65 73 2e 0a 58 40 |acs pack|ages..X@|
|00002330| 69 74 65 6d 0a 58 41 6e | 6e 6f 74 61 74 69 6f 6e |item.XAn|notation|
|00002340| 20 53 75 62 73 79 73 74 | 65 6d 20 2d 2d 20 61 20 | Subsyst|em -- a |
|00002350| 73 65 74 20 6f 66 20 66 | 75 6e 63 74 69 6f 6e 73 |set of f|unctions|
|00002360| 20 74 6f 20 70 72 6f 76 | 69 64 65 20 73 75 70 70 | to prov|ide supp|
|00002370| 6f 72 74 20 66 6f 72 20 | 63 72 65 61 74 69 6e 67 |ort for |creating|
|00002380| 2c 0a 58 75 73 69 6e 67 | 20 61 6e 64 20 64 69 73 |,.Xusing| and dis|
|00002390| 70 6c 61 79 69 6e 67 20 | 69 6e 66 6f 72 6d 61 74 |playing |informat|
|000023a0| 69 6f 6e 20 61 62 6f 75 | 74 20 45 6d 61 63 73 20 |ion abou|t Emacs |
|000023b0| 4c 69 73 70 20 63 6f 64 | 65 2e 0a 58 40 69 74 65 |Lisp cod|e..X@ite|
|000023c0| 6d 0a 58 45 71 75 61 6c | 69 74 79 20 53 75 62 73 |m.XEqual|ity Subs|
|000023d0| 79 73 74 65 6d 20 2d 2d | 20 61 20 73 65 74 20 6f |ystem --| a set o|
|000023e0| 66 20 66 75 6e 63 74 69 | 6f 6e 73 20 75 73 65 64 |f functi|ons used|
|000023f0| 20 62 79 20 74 68 65 20 | 74 65 73 74 69 6e 67 0a | by the |testing.|
|00002400| 58 73 75 62 73 79 73 74 | 65 6d 73 20 74 68 61 74 |Xsubsyst|ems that|
|00002410| 20 70 72 6f 76 69 64 65 | 20 64 69 66 66 65 72 65 | provide| differe|
|00002420| 6e 74 20 69 6e 74 65 72 | 70 72 65 74 61 74 69 6f |nt inter|pretatio|
|00002430| 6e 73 20 6f 66 20 65 71 | 75 61 6c 69 74 79 2e 0a |ns of eq|uality..|
|00002440| 58 40 65 6e 64 20 69 74 | 65 6d 69 7a 65 0a 58 0a |X@end it|emize.X.|
|00002450| 58 54 68 65 20 66 6f 6c | 6c 6f 77 69 6e 67 20 73 |XThe fol|lowing s|
|00002460| 65 63 74 69 6f 6e 73 20 | 65 78 70 6c 61 69 6e 20 |ections |explain |
|00002470| 74 68 65 20 75 73 65 20 | 6f 66 20 74 68 65 73 65 |the use |of these|
|00002480| 20 66 75 6e 63 74 69 6f | 6e 73 20 74 6f 20 73 75 | functio|ns to su|
|00002490| 70 70 6f 72 74 0a 58 74 | 68 65 20 73 74 65 70 73 |pport.Xt|he steps|
|000024a0| 20 69 6e 20 74 68 65 20 | 74 65 73 74 69 6e 67 20 | in the |testing |
|000024b0| 70 72 6f 63 65 73 73 3a | 0a 58 40 69 74 65 6d 69 |process:|.X@itemi|
|000024c0| 7a 65 20 40 62 75 6c 6c | 65 74 0a 58 40 69 74 65 |ze @bull|et.X@ite|
|000024d0| 6d 0a 58 47 65 74 74 69 | 6e 67 20 53 74 61 72 74 |m.XGetti|ng Start|
|000024e0| 65 64 0a 58 40 69 74 65 | 6d 0a 58 49 6e 73 74 72 |ed.X@ite|m.XInstr|
|000024f0| 75 6d 65 6e 74 69 6e 67 | 20 61 20 70 61 63 6b 61 |umenting| a packa|
|00002500| 67 65 0a 58 40 69 74 65 | 6d 0a 58 54 65 73 74 69 |ge.X@ite|m.XTesti|
|00002510| 6e 67 20 61 20 50 61 63 | 6b 61 67 65 0a 58 40 69 |ng a Pac|kage.X@i|
|00002520| 74 65 6d 0a 58 41 6e 61 | 6c 79 7a 69 6e 67 20 54 |tem.XAna|lyzing T|
|00002530| 65 73 74 20 52 65 73 75 | 6c 74 73 0a 58 40 69 74 |est Resu|lts.X@it|
|00002540| 65 6d 0a 58 44 69 73 70 | 6c 61 79 69 6e 67 20 54 |em.XDisp|laying T|
|00002550| 65 73 74 20 52 65 73 75 | 6c 74 73 0a 58 40 65 6e |est Resu|lts.X@en|
|00002560| 64 20 69 74 65 6d 69 7a | 65 0a 58 0a 58 54 68 65 |d itemiz|e.X.XThe|
|00002570| 20 73 79 73 74 65 6d 20 | 69 73 20 64 65 73 69 67 | system |is desig|
|00002580| 6e 65 64 20 74 6f 20 74 | 65 73 74 20 45 6d 61 63 |ned to t|est Emac|
|00002590| 73 2d 4c 69 73 70 20 70 | 72 6f 67 72 61 6d 73 2c |s-Lisp p|rograms,|
|000025a0| 20 61 6e 64 20 69 73 20 | 69 6d 70 6c 65 6d 65 6e | and is |implemen|
|000025b0| 74 65 64 20 61 73 20 61 | 0a 58 6d 69 6e 6f 72 20 |ted as a|.Xminor |
|000025c0| 6d 6f 64 65 20 6f 66 20 | 45 6d 61 63 73 2d 4c 69 |mode of |Emacs-Li|
|000025d0| 73 70 20 6d 6f 64 65 20 | 28 53 65 65 20 53 65 63 |sp mode |(See Sec|
|000025e0| 74 69 6f 6e 20 32 38 2e | 31 20 5b 4d 69 6e 6f 72 |tion 28.|1 [Minor|
|000025f0| 20 4d 6f 64 65 73 5d 20 | 6f 66 20 74 68 65 20 47 | Modes] |of the G|
|00002600| 4e 55 0a 58 45 6d 61 63 | 73 20 52 65 66 65 72 65 |NU.XEmac|s Refere|
|00002610| 6e 63 65 20 4d 61 6e 75 | 61 6c 29 2e 0a 58 0a 58 |nce Manu|al)..X.X|
|00002620| 40 6e 6f 64 65 20 73 74 | 61 72 74 69 6e 67 2c 20 |@node st|arting, |
|00002630| 74 65 73 74 69 6e 67 2c | 20 69 6e 74 72 6f 64 75 |testing,| introdu|
|00002640| 63 74 69 6f 6e 2c 20 74 | 6f 70 0a 58 40 63 68 61 |ction, t|op.X@cha|
|00002650| 70 74 65 72 20 47 65 74 | 74 69 6e 67 20 53 74 61 |pter Get|ting Sta|
|00002660| 72 74 65 64 0a 58 0a 58 | 54 68 69 73 20 73 65 63 |rted.X.X|This sec|
|00002670| 74 69 6f 6e 20 64 65 73 | 63 72 69 62 65 73 20 68 |tion des|cribes h|
|00002680| 6f 77 20 74 6f 20 62 65 | 67 69 6e 20 75 73 69 6e |ow to be|gin usin|
|00002690| 67 20 74 68 65 20 54 65 | 73 74 20 70 61 63 6b 61 |g the Te|st packa|
|000026a0| 67 65 20 74 6f 20 74 65 | 73 74 0a 58 45 6d 61 63 |ge to te|st.XEmac|
|000026b0| 73 20 70 61 63 6b 61 67 | 65 73 2e 0a 58 0a 58 40 |s packag|es..X.X@|
|000026c0| 73 65 63 74 69 6f 6e 20 | 4c 6f 61 64 69 6e 67 20 |section |Loading |
|000026d0| 61 6e 64 20 49 6e 69 74 | 69 61 6c 69 7a 61 74 69 |and Init|ializati|
|000026e0| 6f 6e 0a 58 0a 58 54 6f | 20 73 74 61 72 74 20 74 |on.X.XTo| start t|
|000026f0| 65 73 74 69 6e 67 20 79 | 6f 75 20 70 72 6f 62 61 |esting y|ou proba|
|00002700| 62 6c 79 20 77 61 6e 74 | 20 61 20 66 72 65 73 68 |bly want| a fresh|
|00002710| 20 45 6d 61 63 73 20 73 | 65 73 73 69 6f 6e 20 77 | Emacs s|ession w|
|00002720| 69 74 68 20 6e 6f 20 65 | 78 74 72 61 6e 65 6f 75 |ith no e|xtraneou|
|00002730| 73 0a 58 62 75 66 66 65 | 72 73 20 6f 72 20 70 72 |s.Xbuffe|rs or pr|
|00002740| 6f 63 65 73 73 65 73 20 | 68 61 6e 67 69 6e 67 20 |ocesses |hanging |
|00002750| 61 72 6f 75 6e 64 2e 20 | 20 4e 6f 6e 2d 65 73 73 |around. | Non-ess|
|00002760| 65 6e 74 69 61 6c 20 65 | 78 74 72 61 73 20 77 69 |ential e|xtras wi|
|00002770| 6c 6c 20 6a 75 73 74 20 | 73 6c 6f 77 0a 58 64 6f |ll just |slow.Xdo|
|00002780| 77 6e 20 74 68 65 20 73 | 74 61 74 65 20 63 61 70 |wn the s|tate cap|
|00002790| 74 75 72 65 20 61 6e 64 | 20 61 63 68 69 65 76 65 |ture and| achieve|
|000027a0| 20 66 75 6e 63 74 69 6f | 6e 73 2e 20 20 49 66 20 | functio|ns. If |
|000027b0| 79 6f 75 20 68 61 76 65 | 20 61 20 62 75 73 79 0a |you have| a busy.|
|000027c0| 58 40 66 69 6c 65 7b 2e | 65 6d 61 63 73 7d 20 66 |X@file{.|emacs} f|
|000027d0| 69 6c 65 20 79 6f 75 20 | 6d 61 79 20 77 61 6e 74 |ile you |may want|
|000027e0| 20 74 6f 20 6b 65 65 70 | 20 61 20 74 72 69 6d 6d | to keep| a trimm|
|000027f0| 65 64 20 62 61 63 6b 20 | 63 6f 70 79 20 6a 75 73 |ed back |copy jus|
|00002800| 74 20 66 6f 72 20 74 65 | 73 74 0a 58 73 65 73 73 |t for te|st.Xsess|
|00002810| 69 6f 6e 73 2e 0a 58 0a | 58 4f 6e 63 65 20 69 6e |ions..X.|XOnce in|
|00002820| 20 45 6d 61 63 73 20 76 | 69 73 69 74 20 74 68 65 | Emacs v|isit the|
|00002830| 20 66 69 6c 65 20 63 6f | 6e 74 61 69 6e 69 6e 67 | file co|ntaining|
|00002840| 20 45 6d 61 63 73 2d 6c | 69 73 70 20 63 6f 64 65 | Emacs-l|isp code|
|00002850| 20 74 6f 20 62 65 20 74 | 65 73 74 65 64 2c 0a 58 | to be t|ested,.X|
|00002860| 74 68 65 6e 20 65 6e 74 | 65 72 3a 0a 58 40 65 78 |then ent|er:.X@ex|
|00002870| 61 6d 70 6c 65 0a 58 4d | 2d 78 20 6c 6f 61 64 2d |ample.XM|-x load-|
|00002880| 66 69 6c 65 0a 58 74 65 | 73 74 2e 65 6c 0a 58 4d |file.Xte|st.el.XM|
|00002890| 2d 78 20 74 65 73 74 2d | 6d 6f 64 65 0a 58 40 65 |-x test-|mode.X@e|
|000028a0| 6e 64 20 65 78 61 6d 70 | 6c 65 0a 58 54 68 65 20 |nd examp|le.XThe |
|000028b0| 6d 6f 64 65 20 6c 69 6e | 65 20 61 74 20 74 68 65 |mode lin|e at the|
|000028c0| 20 62 6f 74 74 6f 6d 20 | 6f 66 20 79 6f 75 72 20 | bottom |of your |
|000028d0| 77 69 6e 64 6f 77 20 73 | 68 6f 75 6c 64 20 73 68 |window s|hould sh|
|000028e0| 6f 77 20 60 60 28 45 6d | 61 63 73 2d 6c 69 73 70 |ow ``(Em|acs-lisp|
|000028f0| 0a 58 54 65 73 74 29 27 | 27 20 69 6e 20 74 68 65 |.XTest)'|' in the|
|00002900| 20 6d 6f 64 65 20 66 69 | 65 6c 64 2e 20 20 59 6f | mode fi|eld. Yo|
|00002910| 75 20 61 72 65 20 6e 6f | 77 20 69 6e 20 54 65 73 |u are no|w in Tes|
|00002920| 74 20 6d 6f 64 65 2e 0a | 58 0a 58 50 72 6f 62 61 |t mode..|X.XProba|
|00002930| 62 6c 79 20 74 68 65 20 | 66 69 72 73 74 20 74 68 |bly the |first th|
|00002940| 69 6e 67 20 74 6f 20 64 | 6f 20 61 74 20 74 68 69 |ing to d|o at thi|
|00002950| 73 20 70 6f 69 6e 74 20 | 69 73 20 74 6f 20 75 73 |s point |is to us|
|00002960| 65 20 40 73 61 6d 70 7b | 43 2d 63 20 6e 7d 20 74 |e @samp{|C-c n} t|
|00002970| 6f 0a 58 67 65 6e 65 72 | 61 74 65 20 61 20 6e 65 |o.Xgener|ate a ne|
|00002980| 77 20 62 75 66 66 65 72 | 20 63 6f 6e 74 61 69 6e |w buffer| contain|
|00002990| 69 6e 67 20 61 20 74 65 | 73 74 20 73 63 72 69 70 |ing a te|st scrip|
|000029a0| 74 20 74 65 6d 70 6c 61 | 74 65 2e 20 20 54 68 69 |t templa|te. Thi|
|000029b0| 73 20 69 73 20 61 20 67 | 6f 6f 64 0a 58 73 74 61 |s is a g|ood.Xsta|
|000029c0| 72 74 69 6e 67 20 70 6f | 69 6e 74 20 66 6f 72 20 |rting po|int for |
|000029d0| 63 72 65 61 74 69 6e 67 | 20 61 20 6e 65 77 20 74 |creating| a new t|
|000029e0| 65 73 74 20 73 63 72 69 | 70 74 3b 20 74 68 65 20 |est scri|pt; the |
|000029f0| 74 65 6d 70 6c 61 74 65 | 20 69 73 20 73 68 6f 77 |template| is show|
|00002a00| 6e 20 69 6e 0a 58 73 65 | 63 74 69 6f 6e 20 32 2e |n in.Xse|ction 2.|
|00002a10| 33 20 6f 66 20 74 68 69 | 73 20 64 6f 63 75 6d 65 |3 of thi|s docume|
|00002a20| 6e 74 2e 20 20 54 68 65 | 20 74 61 73 6b 20 6e 6f |nt. The| task no|
|00002a30| 77 20 63 6f 6e 66 72 6f | 6e 74 69 6e 67 20 79 6f |w confro|nting yo|
|00002a40| 75 20 69 73 20 74 6f 20 | 64 65 76 65 6c 6f 70 20 |u is to |develop |
|00002a50| 61 0a 58 74 65 73 74 20 | 73 75 69 74 65 20 74 68 |a.Xtest |suite th|
|00002a60| 61 74 20 77 69 6c 6c 20 | 65 78 65 72 63 69 73 65 |at will |exercise|
|00002a70| 20 79 6f 75 72 20 70 61 | 63 6b 61 67 65 20 74 68 | your pa|ckage th|
|00002a80| 72 6f 75 67 68 6c 79 2c | 20 6e 6f 74 20 6f 6e 6c |roughly,| not onl|
|00002a90| 79 20 74 6f 20 74 65 73 | 74 20 69 74 0a 58 6e 6f |y to tes|t it.Xno|
|00002aa0| 77 20 62 75 74 20 61 6c | 73 6f 20 74 6f 20 68 61 |w but al|so to ha|
|00002ab0| 76 65 20 61 6e 20 61 75 | 74 6f 6d 61 74 65 64 20 |ve an au|tomated |
|00002ac0| 72 65 67 72 65 73 73 69 | 6f 6e 20 74 65 73 74 2e |regressi|on test.|
|00002ad0| 20 20 54 68 65 20 72 65 | 6d 61 69 6e 64 65 72 20 | The re|mainder |
|00002ae0| 6f 66 20 74 68 69 73 0a | 58 64 6f 63 75 6d 65 6e |of this.|Xdocumen|
|00002af0| 74 20 77 69 6c 6c 20 67 | 75 69 64 65 20 79 6f 75 |t will g|uide you|
|00002b00| 20 74 68 72 6f 75 67 68 | 20 74 68 69 73 20 74 61 | through| this ta|
|00002b10| 73 6b 2e 0a 58 0a 58 46 | 69 67 75 72 65 20 32 20 |sk..X.XF|igure 2 |
|00002b20| 69 6c 6c 75 73 74 72 61 | 74 65 73 20 74 68 65 20 |illustra|tes the |
|00002b30| 6f 76 65 72 61 6c 6c 20 | 66 6c 6f 77 20 6f 66 20 |overall |flow of |
|00002b40| 64 61 74 61 20 69 6e 20 | 74 68 65 20 54 65 73 74 |data in |the Test|
|00002b50| 20 73 79 73 74 65 6d 2e | 0a 58 0a 58 40 67 72 6f | system.|.X.X@gro|
|00002b60| 75 70 0a 58 40 65 78 61 | 6d 70 6c 65 0a 58 20 20 |up.X@exa|mple.X |
|00002b70| 20 20 20 20 20 20 2b 2d | 2d 2d 2d 2d 2d 2d 2d 2d | +-|--------|
|00002b80| 2d 2d 2d 2d 2b 0a 58 20 | 20 20 20 20 20 20 20 7c |----+.X | ||
|00002b90| 53 6f 75 72 63 65 20 54 | 65 78 74 20 20 7c 0a 58 |Source T|ext |.X|
|00002ba0| 20 20 20 20 20 20 20 20 | 2b 2d 2d 2d 2d 2d 2d 2d | |+-------|
|00002bb0| 2d 2d 2d 2d 2d 2d 2b 0a | 58 20 20 20 20 20 20 20 |------+.|X |
|00002bc0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002bd0| 5c 0a 58 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |\.X | |
|00002be0| 20 20 20 20 20 20 20 20 | 20 20 20 5c 0a 58 20 20 | | \.X |
|00002bf0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002c00| 20 20 20 20 20 20 20 5c | 0a 58 20 20 20 20 20 20 | \|.X |
|00002c10| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002c20| 20 20 20 20 49 6e 73 74 | 72 75 6d 65 6e 74 0a 58 | Inst|rument.X|
|00002c30| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002c40| 20 20 20 20 20 20 20 20 | 20 2f 0a 58 20 20 20 20 | | /.X |
|00002c50| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002c60| 20 20 20 20 2f 0a 58 20 | 20 20 20 20 20 20 20 20 | /.X | |
|00002c70| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 2f 0a | | /.|
|00002c80| 58 20 20 20 20 20 20 20 | 20 2b 2d 2d 2d 2d 2d 2d |X | +------|
|00002c90| 2d 2d 2d 2d 2d 2d 2d 2b | 20 20 20 20 20 20 20 20 |-------+| |
|00002ca0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 2b 2d 2d | | +--|
|00002cb0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2b 0a 58 20 20 |--------|---+.X |
|00002cc0| 20 20 20 20 20 20 7c 49 | 6e 73 74 72 75 6d 65 6e | |I|nstrumen|
|00002cd0| 74 65 64 20 7c 20 20 20 | 20 20 20 20 20 20 20 20 |ted | | |
|00002ce0| 20 20 20 20 20 20 20 20 | 20 20 7c 20 54 65 73 74 | | | Test|
|00002cf0| 20 43 61 73 65 73 20 20 | 7c 0a 58 20 20 20 20 20 | Cases ||.X |
|00002d00| 20 20 20 7c 20 20 20 20 | 54 65 78 74 20 20 20 20 | | |Text |
|00002d10| 20 7c 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | | |
|00002d20| 20 20 20 20 20 20 20 2b | 2d 2d 2d 2d 2d 2d 2d 2d | +|--------|
|00002d30| 2d 2d 2d 2d 2d 2b 0a 58 | 20 20 20 20 20 20 20 20 |-----+.X| |
|00002d40| 2b 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2b 20 |+-------|------+ |
|00002d50| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002d60| 20 20 20 2f 0a 58 20 20 | 20 20 20 20 20 20 20 20 | /.X | |
|00002d70| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 5c 20 20 | | \ |
|00002d80| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002d90| 2f 0a 58 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |/.X | |
|00002da0| 20 20 20 20 20 20 20 20 | 20 20 20 5c 20 20 20 20 | | \ |
|00002db0| 20 20 20 20 20 20 20 20 | 20 20 20 20 2f 0a 58 20 | | /.X |
|00002dc0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002dd0| 20 20 20 20 20 20 20 20 | 5c 20 20 20 20 20 20 20 | |\ |
|00002de0| 20 20 20 20 20 20 20 2f | 0a 58 20 20 20 20 20 20 | /|.X |
|00002df0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002e00| 20 20 20 20 5c 20 20 20 | 20 20 20 20 20 20 20 20 | \ | |
|00002e10| 20 2f 0a 58 20 20 20 20 | 20 20 20 20 20 20 20 20 | /.X | |
|00002e20| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002e30| 20 20 45 78 65 63 75 74 | 65 0a 58 20 20 20 20 20 | Execut|e.X |
|00002e40| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002e50| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002e60| 20 20 5c 0a 58 20 20 20 | 20 20 20 20 20 20 20 20 | \.X | |
|00002e70| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002e80| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 5c 0a 58 | | \.X|
|00002e90| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002ea0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002eb0| 20 20 20 20 20 20 20 20 | 20 5c 0a 58 20 20 20 20 | | \.X |
|00002ec0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002ed0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002ee0| 20 20 20 20 20 20 5c 0a | 58 20 20 20 20 20 20 20 | \.|X |
|00002ef0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002f00| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002f10| 20 20 20 20 20 2b 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d | +--|--------|
|00002f20| 2d 2d 2d 2b 0a 58 20 20 | 20 20 20 20 20 20 20 20 |---+.X | |
|00002f30| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002f40| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002f50| 20 20 7c 54 65 73 74 20 | 52 65 73 75 6c 74 73 20 | |Test |Results |
|00002f60| 7c 0a 58 20 20 20 20 20 | 20 20 20 20 20 20 20 20 ||.X | |
|00002f70| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002f80| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 2b | | +|
|00002f90| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2b 0a 58 |--------|-----+.X|
|00002fa0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002fb0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002fc0| 20 20 20 20 20 20 20 20 | 20 20 20 2f 20 20 20 20 | | / |
|00002fd0| 20 20 20 20 5e 0a 58 20 | 20 20 20 20 20 20 20 20 | ^.X | |
|00002fe0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00002ff0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00003000| 20 2f 20 20 20 20 20 20 | 20 20 20 7c 0a 58 20 20 | / | |.X |
|00003010| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00003020| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00003030| 20 20 20 20 20 20 20 2f | 20 20 20 20 20 20 20 20 | /| |
|00003040| 20 20 7c 0a 58 20 20 20 | 20 20 20 20 20 20 20 20 | |.X | |
|00003050| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00003060| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 2f 20 20 | | / |
|00003070| 20 20 20 20 20 20 20 20 | 20 76 0a 58 20 20 20 20 | | v.X |
|00003080| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00003090| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 44 69 73 | | Dis|
|000030a0| 70 6c 61 79 20 20 20 20 | 20 20 20 20 20 41 6e 61 |play | Ana|
|000030b0| 6c 79 7a 65 0a 58 0a 58 | 0a 58 0a 58 40 65 6e 64 |lyze.X.X|.X.X@end|
|000030c0| 20 65 78 61 6d 70 6c 65 | 0a 58 40 63 65 6e 74 65 | example|.X@cente|
|000030d0| 72 20 46 69 67 75 72 65 | 20 32 2e 20 20 54 65 73 |r Figure| 2. Tes|
|000030e0| 74 20 44 61 74 61 20 46 | 6c 6f 77 0a 58 40 65 6e |t Data F|low.X@en|
|000030f0| 64 20 67 72 6f 75 70 0a | 58 0a 58 40 73 65 63 74 |d group.|X.X@sect|
|00003100| 69 6f 6e 20 54 65 73 74 | 20 4d 6f 64 65 0a 58 0a |ion Test| Mode.X.|
|00003110| 58 54 68 65 20 70 61 63 | 6b 61 67 65 20 60 40 73 |XThe pac|kage `@s|
|00003120| 61 6d 70 7b 74 65 73 74 | 2e 65 6c 7d 27 20 70 72 |amp{test|.el}' pr|
|00003130| 6f 76 69 64 65 73 20 73 | 65 76 65 72 61 6c 20 66 |ovides s|everal f|
|00003140| 75 6e 63 74 69 6f 6e 73 | 20 74 6f 20 74 68 65 20 |unctions| to the |
|00003150| 75 73 65 72 3a 0a 58 40 | 74 61 62 6c 65 20 40 73 |user:.X@|table @s|
|00003160| 61 6d 70 0a 58 40 69 74 | 65 6d 20 43 2d 63 20 6e |amp.X@it|em C-c n|
|00003170| 0a 58 53 74 61 72 74 20 | 61 20 6e 65 77 20 74 65 |.XStart |a new te|
|00003180| 73 74 20 73 63 72 69 70 | 74 0a 58 40 63 6f 64 65 |st scrip|t.X@code|
|00003190| 7b 20 28 74 73 74 2d 6e | 65 77 2d 73 63 72 69 70 |{ (tst-n|ew-scrip|
|000031a0| 74 2d 62 75 66 66 65 72 | 29 7d 0a 58 40 69 74 65 |t-buffer|)}.X@ite|
|000031b0| 6d 20 43 2d 63 20 69 0a | 58 28 52 65 2d 29 69 6e |m C-c i.|X(Re-)in|
|000031c0| 73 74 72 75 6d 65 6e 74 | 20 61 20 74 65 73 74 20 |strument| a test |
|000031d0| 70 72 6f 67 72 61 6d 20 | 62 75 66 66 65 72 20 40 |program |buffer @|
|000031e0| 63 6f 64 65 7b 20 28 74 | 73 74 2d 69 6e 73 74 72 |code{ (t|st-instr|
|000031f0| 75 6d 65 6e 74 29 7d 2e | 0a 58 40 69 74 65 6d 20 |ument)}.|.X@item |
|00003200| 43 2d 63 20 78 0a 58 54 | 65 73 74 20 74 68 65 20 |C-c x.XT|est the |
|00003210| 70 72 6f 67 72 61 6d 2c | 20 75 73 69 6e 67 20 74 |program,| using t|
|00003220| 68 65 20 74 65 73 74 20 | 73 63 72 69 70 74 20 40 |he test |script @|
|00003230| 63 6f 64 65 7b 20 28 74 | 73 74 2d 65 78 65 63 75 |code{ (t|st-execu|
|00003240| 74 65 29 7d 2e 0a 58 40 | 69 74 65 6d 20 43 2d 63 |te)}..X@|item C-c|
|00003250| 20 63 0a 58 52 65 63 6f | 72 64 20 61 20 47 4e 55 | c.XReco|rd a GNU|
|00003260| 20 45 6d 61 63 73 20 73 | 74 61 74 65 20 66 6f 72 | Emacs s|tate for|
|00003270| 20 6c 61 74 65 72 20 75 | 73 65 0a 58 40 63 6f 64 | later u|se.X@cod|
|00003280| 65 7b 20 28 74 73 74 2d | 63 61 70 74 75 72 65 2d |e{ (tst-|capture-|
|00003290| 73 74 61 74 65 29 7d 2e | 0a 58 40 69 74 65 6d 20 |state)}.|.X@item |
|000032a0| 43 2d 63 20 61 0a 58 41 | 63 68 69 65 76 65 20 61 |C-c a.XA|chieve a|
|000032b0| 20 70 72 65 76 69 6f 75 | 73 6c 79 20 73 61 76 65 | previou|sly save|
|000032c0| 64 20 47 4e 55 20 45 6d | 61 63 73 20 73 74 61 74 |d GNU Em|acs stat|
|000032d0| 65 0a 58 40 63 6f 64 65 | 7b 20 28 74 73 74 2d 61 |e.X@code|{ (tst-a|
|000032e0| 63 68 69 65 76 65 2d 73 | 74 61 74 65 29 7d 2e 0a |chieve-s|tate)}..|
|000032f0| 58 40 69 74 65 6d 20 43 | 2d 63 20 43 2d 61 0a 58 |X@item C|-c C-a.X|
|00003300| 41 63 68 69 65 76 65 20 | 61 20 73 74 61 74 65 20 |Achieve |a state |
|00003310| 70 72 65 76 69 6f 75 73 | 6c 79 20 73 61 76 65 64 |previous|ly saved|
|00003320| 2d 74 6f 2d 66 69 6c 65 | 0a 58 40 63 6f 64 65 7b |-to-file|.X@code{|
|00003330| 20 28 74 73 74 2d 61 63 | 68 69 65 76 65 2d 73 74 | (tst-ac|hieve-st|
|00003340| 61 74 65 2d 66 72 6f 6d | 2d 66 69 6c 65 29 7d 2e |ate-from|-file)}.|
|00003350| 0a 58 40 69 74 65 6d 20 | 43 2d 63 20 43 2d 63 0a |.X@item |C-c C-c.|
|00003360| 58 43 61 70 74 75 72 65 | 20 63 75 72 72 65 6e 74 |XCapture| current|
|00003370| 20 65 6d 61 63 73 20 73 | 74 61 74 65 20 74 6f 20 | emacs s|tate to |
|00003380| 66 69 6c 65 0a 58 40 63 | 6f 64 65 7b 20 28 74 73 |file.X@c|ode{ (ts|
|00003390| 74 2d 63 61 70 74 75 72 | 65 2d 73 74 61 74 65 2d |t-captur|e-state-|
|000033a0| 74 6f 2d 66 69 6c 65 29 | 7d 2e 0a 58 40 69 74 65 |to-file)|}..X@ite|
|000033b0| 6d 20 43 2d 63 20 43 2d | 72 0a 58 52 65 61 64 20 |m C-c C-|r.XRead |
|000033c0| 61 20 70 72 65 76 69 6f | 75 73 6c 79 20 73 61 76 |a previo|usly sav|
|000033d0| 65 64 2d 74 6f 2d 66 69 | 6c 65 20 73 74 61 74 65 |ed-to-fi|le state|
|000033e0| 20 69 6e 74 6f 20 61 20 | 76 61 72 69 61 62 6c 65 | into a |variable|
|000033f0| 0a 58 40 63 6f 64 65 7b | 20 28 74 73 74 2d 72 65 |.X@code{| (tst-re|
|00003400| 61 64 2d 73 74 61 74 65 | 2d 66 72 6f 6d 2d 66 69 |ad-state|-from-fi|
|00003410| 6c 65 29 7d 2e 0a 58 40 | 69 74 65 6d 20 43 2d 63 |le)}..X@|item C-c|
|00003420| 20 43 2d 77 0a 58 57 72 | 69 74 65 20 61 20 73 74 | C-w.XWr|ite a st|
|00003430| 61 74 65 20 70 72 65 76 | 69 6f 75 73 6c 79 20 63 |ate prev|iously c|
|00003440| 61 70 74 75 72 65 64 20 | 69 6e 20 61 20 76 61 72 |aptured |in a var|
|00003450| 69 61 62 6c 65 20 74 6f | 20 61 20 66 69 6c 65 0a |iable to| a file.|
|00003460| 58 40 63 6f 64 65 7b 20 | 28 74 73 74 2d 77 72 69 |X@code{ |(tst-wri|
|00003470| 74 65 2d 73 74 61 74 65 | 2d 74 6f 2d 66 69 6c 65 |te-state|-to-file|
|00003480| 29 7d 2e 0a 58 40 69 74 | 65 6d 20 43 2d 63 20 66 |)}..X@it|em C-c f|
|00003490| 0a 58 41 6e 61 6c 79 7a | 65 20 28 66 69 6c 74 65 |.XAnalyz|e (filte|
|000034a0| 72 29 20 74 68 65 20 72 | 65 73 75 6c 74 73 20 6f |r) the r|esults o|
|000034b0| 66 20 72 75 6e 6e 69 6e | 67 20 74 68 65 20 74 65 |f runnin|g the te|
|000034c0| 73 74 28 73 29 20 40 63 | 6f 64 65 7b 20 28 74 73 |st(s) @c|ode{ (ts|
|000034d0| 74 2d 61 6e 61 6c 79 7a | 65 29 7d 2e 0a 58 40 69 |t-analyz|e)}..X@i|
|000034e0| 74 65 6d 20 43 2d 63 20 | 64 0a 58 44 69 73 70 6c |tem C-c |d.XDispl|
|000034f0| 61 79 20 74 68 65 20 61 | 6e 6e 6f 74 61 74 69 6f |ay the a|nnotatio|
|00003500| 6e 73 20 61 62 6f 75 74 | 20 74 68 65 20 74 65 73 |ns about| the tes|
|00003510| 74 20 40 63 6f 64 65 7b | 20 28 74 73 74 2d 64 69 |t @code{| (tst-di|
|00003520| 73 70 6c 61 79 2d 6d 6f | 64 65 29 7d 2e 0a 58 40 |splay-mo|de)}..X@|
|00003530| 69 74 65 6d 20 43 2d 63 | 20 71 0a 58 45 78 69 74 |item C-c| q.XExit|
|00003540| 20 74 65 73 74 20 6d 6f | 64 65 20 40 63 6f 64 65 | test mo|de @code|
|00003550| 7b 20 28 74 65 73 74 2d | 6d 6f 64 65 29 7d 2e 0a |{ (test-|mode)}..|
|00003560| 58 40 65 6e 64 20 74 61 | 62 6c 65 0a 58 0a 58 40 |X@end ta|ble.X.X@|
|00003570| 73 65 63 74 69 6f 6e 20 | 43 6f 6e 74 65 6e 74 73 |section |Contents|
|00003580| 20 6f 66 20 74 68 65 20 | 2a 74 65 73 74 20 73 63 | of the |*test sc|
|00003590| 72 69 70 74 2a 20 42 75 | 66 66 65 72 0a 58 0a 58 |ript* Bu|ffer.X.X|
|000035a0| 0a 58 40 65 78 61 6d 70 | 6c 65 0a 58 28 64 65 66 |.X@examp|le.X(def|
|000035b0| 75 6e 20 74 65 73 74 2d | 73 63 72 69 70 74 20 28 |un test-|script (|
|000035c0| 29 0a 58 20 20 28 69 6e | 74 65 72 61 63 74 69 76 |).X (in|teractiv|
|000035d0| 65 29 0a 58 09 09 09 09 | 09 3b 20 4c 6f 63 61 6c |e).X....|.; Local|
|000035e0| 20 56 61 72 69 61 62 6c | 65 73 0a 58 20 20 28 6c | Variabl|es.X (l|
|000035f0| 65 74 20 28 70 72 65 20 | 70 6f 73 74 20 61 63 74 |et (pre |post act|
|00003600| 75 61 6c 29 0a 58 09 09 | 09 09 09 3b 20 42 6f 64 |ual).X..|...; Bod|
|00003610| 79 0a 58 20 20 20 20 28 | 73 77 69 74 63 68 2d 74 |y.X (|switch-t|
|00003620| 6f 2d 62 75 66 66 65 72 | 20 66 6f 6f 29 0a 58 20 |o-buffer| foo).X |
|00003630| 20 20 20 28 65 72 61 73 | 65 2d 62 75 66 66 65 72 | (eras|e-buffer|
|00003640| 29 0a 58 20 20 20 20 28 | 69 6e 73 65 72 74 2d 66 |).X (|insert-f|
|00003650| 69 6c 65 20 66 6f 6f 29 | 0a 58 20 20 20 20 28 67 |ile foo)|.X (g|
|00003660| 6f 74 6f 2d 63 68 61 72 | 20 28 70 6f 69 6e 74 2d |oto-char| (point-|
|00003670| 6d 69 6e 29 29 0a 58 20 | 20 20 20 28 65 6d 61 63 |min)).X | (emac|
|00003680| 73 2d 6c 69 73 70 2d 6d | 6f 64 65 29 0a 58 20 20 |s-lisp-m|ode).X |
|00003690| 20 20 28 74 65 73 74 2d | 6d 6f 64 65 29 0a 58 20 | (test-|mode).X |
|000036a0| 20 20 20 28 74 73 74 2d | 69 6e 73 74 72 75 6d 65 | (tst-|instrume|
|000036b0| 6e 74 29 0a 58 09 09 09 | 09 09 3b 20 31 73 74 20 |nt).X...|..; 1st |
|000036c0| 74 65 73 74 20 72 75 6e | 0a 58 20 20 20 20 28 74 |test run|.X (t|
|000036d0| 73 74 2d 72 65 61 64 2d | 73 74 61 74 65 2d 66 72 |st-read-|state-fr|
|000036e0| 6f 6d 2d 66 69 6c 65 20 | 27 70 6f 73 74 20 65 78 |om-file |'post ex|
|000036f0| 70 65 63 74 65 64 2d 73 | 74 61 74 65 2d 66 69 6c |pected-s|tate-fil|
|00003700| 65 31 29 0a 58 20 20 20 | 20 28 74 73 74 2d 61 63 |e1).X | (tst-ac|
|00003710| 68 69 65 76 65 2d 73 74 | 61 74 65 2d 66 72 6f 6d |hieve-st|ate-from|
|00003720| 2d 66 69 6c 65 20 27 70 | 72 65 20 69 6e 69 74 69 |-file 'p|re initi|
|00003730| 61 6c 2d 73 74 61 74 65 | 2d 66 69 6c 65 31 29 0a |al-state|-file1).|
|00003740| 58 20 20 20 20 28 66 6f | 6f 20 61 72 67 73 29 0a |X (fo|o args).|
|00003750| 58 20 20 20 20 28 74 73 | 74 2d 63 61 70 74 75 72 |X (ts|t-captur|
|00003760| 65 2d 73 74 61 74 65 20 | 27 61 63 74 75 61 6c 20 |e-state |'actual |
|00003770| 6e 69 6c 20 6e 69 6c 29 | 0a 58 3b 3b 3b 20 49 66 |nil nil)|.X;;; If|
|00003780| 20 79 6f 75 20 68 61 76 | 65 20 61 20 6c 6f 74 20 | you hav|e a lot |
|00003790| 6f 66 20 74 65 73 74 73 | 2c 20 63 6f 6e 73 69 64 |of tests|, consid|
|000037a0| 65 72 20 61 20 77 68 69 | 6c 65 20 6c 6f 6f 70 0a |er a whi|le loop.|
|000037b0| 58 20 20 29 20 3b 20 6c | 65 74 0a 58 29 20 3b 20 |X ) ; l|et.X) ; |
|000037c0| 64 65 66 75 6e 0a 58 40 | 65 6e 64 20 65 78 61 6d |defun.X@|end exam|
|000037d0| 70 6c 65 0a 58 0a 58 40 | 73 65 63 74 69 6f 6e 20 |ple.X.X@|section |
|000037e0| 54 68 65 20 45 78 61 6d | 70 6c 65 20 2d 2d 20 62 |The Exam|ple -- b|
|000037f0| 6f 78 2e 65 6c 0a 58 0a | 58 54 68 65 20 70 61 63 |ox.el.X.|XThe pac|
|00003800| 6b 61 67 65 20 60 40 73 | 61 6d 70 7b 62 6f 78 2e |kage `@s|amp{box.|
|00003810| 65 6c 7d 27 20 70 72 6f | 76 69 64 65 73 20 74 77 |el}' pro|vides tw|
|00003820| 6f 20 66 75 6e 63 74 69 | 6f 6e 73 20 74 6f 20 74 |o functi|ons to t|
|00003830| 68 65 20 75 73 65 72 3a | 0a 58 40 63 6f 64 65 7b |he user:|.X@code{|
|00003840| 62 6f 78 2d 72 65 67 69 | 6f 6e 7d 20 61 6e 64 20 |box-regi|on} and |
|00003850| 40 63 6f 64 65 7b 75 6e | 62 6f 78 7d 2e 0a 58 54 |@code{un|box}..XT|
|00003860| 68 65 20 66 69 72 73 74 | 20 66 75 6e 63 74 69 6f |he first| functio|
|00003870| 6e 20 65 6e 63 6c 6f 73 | 65 73 20 74 68 65 20 63 |n enclos|es the c|
|00003880| 75 72 72 65 6e 74 20 72 | 65 67 69 6f 6e 20 77 69 |urrent r|egion wi|
|00003890| 74 68 20 61 20 62 6f 78 | 3a 0a 58 0a 58 40 67 72 |th a box|:.X.X@gr|
|000038a0| 6f 75 70 0a 58 40 65 78 | 61 6d 70 6c 65 0a 58 2f |oup.X@ex|ample.X/|
|000038b0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000038c0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000038d0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 5c 0a 58 2a |********|****\.X*|
|000038e0| 20 41 20 62 6f 78 65 64 | 20 72 65 67 69 6f 6e 20 | A boxed| region |
|000038f0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00003900| 20 20 20 20 20 20 20 20 | 20 20 20 20 2a 0a 58 2a | | *.X*|
|00003910| 20 6d 61 79 20 68 61 76 | 65 20 6c 69 6e 65 73 20 | may hav|e lines |
|00003920| 6f 66 20 74 65 78 74 20 | 6f 66 20 76 61 72 79 69 |of text |of varyi|
|00003930| 6e 67 20 6c 65 6e 67 74 | 68 73 2e 20 2a 0a 58 2a |ng lengt|hs. *.X*|
|00003940| 20 41 20 73 69 64 65 20 | 65 66 66 65 63 74 20 6f | A side |effect o|
|00003950| 66 20 62 6f 78 69 6e 67 | 20 69 73 20 74 6f 20 6e |f boxing| is to n|
|00003960| 6f 72 6d 61 6c 69 7a 65 | 20 20 20 20 2a 0a 58 2a |ormalize| *.X*|
|00003970| 20 74 68 65 20 6c 65 6e | 67 74 68 20 6f 66 20 6c | the len|gth of l|
|00003980| 69 6e 65 73 2e 20 20 20 | 20 20 20 20 20 20 20 20 |ines. | |
|00003990| 20 20 20 20 20 20 20 20 | 20 20 20 20 2a 0a 58 5c | | *.X\|
|000039a0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000039b0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000039c0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2f 0a 58 40 |********|****/.X@|
|000039d0| 65 6e 64 20 65 78 61 6d | 70 6c 65 0a 58 40 65 6e |end exam|ple.X@en|
|000039e0| 64 20 67 72 6f 75 70 0a | 58 0a 58 54 68 65 20 73 |d group.|X.XThe s|
|000039f0| 65 63 6f 6e 64 20 66 75 | 6e 63 74 69 6f 6e 20 75 |econd fu|nction u|
|00003a00| 6e 64 6f 65 73 20 74 68 | 65 20 65 66 66 65 63 74 |ndoes th|e effect|
|00003a10| 20 6f 66 20 74 68 65 20 | 66 69 72 73 74 20 62 79 | of the |first by|
|00003a20| 20 72 65 6d 6f 76 69 6e | 67 20 61 6e 79 20 62 6f | removin|g any bo|
|00003a30| 78 65 73 0a 58 77 69 74 | 68 69 6e 20 74 68 65 20 |xes.Xwit|hin the |
|00003a40| 72 65 67 69 6f 6e 2e 20 | 20 54 68 69 73 20 73 69 |region. | This si|
|00003a50| 6d 70 6c 65 20 70 61 63 | 6b 61 67 65 20 77 69 6c |mple pac|kage wil|
|00003a60| 6c 20 62 65 20 75 73 65 | 64 20 69 6e 20 74 68 69 |l be use|d in thi|
|00003a70| 73 20 64 6f 63 75 6d 65 | 6e 74 20 61 73 20 61 6e |s docume|nt as an|
|00003a80| 0a 58 65 78 61 6d 70 6c | 65 20 6f 66 20 61 20 70 |.Xexampl|e of a p|
|00003a90| 61 63 6b 61 67 65 20 74 | 6f 20 62 65 20 74 65 73 |ackage t|o be tes|
|00003aa0| 74 65 64 20 75 73 69 6e | 67 20 74 68 65 20 54 65 |ted usin|g the Te|
|00003ab0| 73 74 20 70 61 63 6b 61 | 67 65 2e 0a 58 0a 58 40 |st packa|ge..X.X@|
|00003ac0| 6e 6f 64 65 20 74 65 73 | 74 69 6e 67 2c 20 69 6e |node tes|ting, in|
|00003ad0| 73 74 72 75 6d 65 6e 74 | 69 6e 67 2c 20 73 74 61 |strument|ing, sta|
|00003ae0| 72 74 69 6e 67 2c 20 74 | 6f 70 0a 58 40 63 68 61 |rting, t|op.X@cha|
|00003af0| 70 74 65 72 20 54 65 73 | 74 69 6e 67 20 59 6f 75 |pter Tes|ting You|
|00003b00| 72 20 50 61 63 6b 61 67 | 65 0a 58 0a 58 41 73 20 |r Packag|e.X.XAs |
|00003b10| 6d 65 6e 74 69 6f 6e 65 | 64 20 61 74 20 74 68 65 |mentione|d at the|
|00003b20| 20 62 65 67 69 6e 6e 69 | 6e 67 20 6f 66 20 74 68 | beginni|ng of th|
|00003b30| 69 73 20 64 6f 63 75 6d | 65 6e 74 2c 20 45 6d 61 |is docum|ent, Ema|
|00003b40| 63 73 20 70 61 63 6b 61 | 67 65 73 20 61 72 65 0a |cs packa|ges are.|
|00003b50| 58 67 65 6e 65 72 61 6c | 6c 79 20 73 74 61 74 65 |Xgeneral|ly state|
|00003b60| 20 63 68 61 6e 67 69 6e | 67 20 6f 70 65 72 61 74 | changin|g operat|
|00003b70| 69 6f 6e 73 2e 20 20 59 | 6f 75 20 69 6e 76 6f 6b |ions. Y|ou invok|
|00003b80| 65 20 74 68 65 20 70 61 | 63 6b 61 67 65 20 77 69 |e the pa|ckage wi|
|00003b90| 74 68 20 61 20 73 65 73 | 73 69 6f 6e 0a 58 74 68 |th a ses|sion.Xth|
|00003ba0| 61 74 20 69 73 20 69 6e | 20 73 6f 6d 65 20 61 72 |at is in| some ar|
|00003bb0| 62 69 74 72 61 72 79 20 | 40 69 7b 69 6e 69 74 69 |bitrary |@i{initi|
|00003bc0| 61 6c 20 73 74 61 74 65 | 7d 2e 20 20 54 68 65 20 |al state|}. The |
|00003bd0| 70 61 63 6b 61 67 65 20 | 6d 6f 64 69 66 69 65 73 |package |modifies|
|00003be0| 0a 58 73 65 6c 65 63 74 | 65 64 20 61 73 70 65 63 |.Xselect|ed aspec|
|00003bf0| 74 73 20 6f 66 20 74 68 | 69 73 20 40 69 7b 69 6e |ts of th|is @i{in|
|00003c00| 69 74 69 61 6c 20 73 74 | 61 74 65 7d 20 69 6e 20 |itial st|ate} in |
|00003c10| 61 20 64 65 66 69 6e 65 | 64 20 6d 61 6e 6e 65 72 |a define|d manner|
|00003c20| 20 61 6e 64 20 6c 65 61 | 76 65 73 0a 58 74 68 65 | and lea|ves.Xthe|
|00003c30| 20 73 65 73 73 69 6f 6e | 20 69 6e 20 73 6f 6d 65 | session| in some|
|00003c40| 20 40 69 7b 66 69 6e 61 | 6c 20 73 74 61 74 65 7d | @i{fina|l state}|
|00003c50| 2e 20 20 54 68 65 20 40 | 64 66 6e 7b 73 74 61 74 |. The @|dfn{stat|
|00003c60| 65 7d 20 6f 66 20 61 20 | 47 4e 55 20 45 6d 61 63 |e} of a |GNU Emac|
|00003c70| 73 0a 58 73 65 73 73 69 | 6f 6e 20 63 6f 6e 73 69 |s.Xsessi|on consi|
|00003c80| 73 74 73 20 6f 66 20 69 | 6e 66 6f 72 6d 61 74 69 |sts of i|nformati|
|00003c90| 6f 6e 20 6f 6e 20 62 75 | 66 66 65 72 73 2c 20 77 |on on bu|ffers, w|
|00003ca0| 69 6e 64 6f 77 73 2c 20 | 70 72 6f 63 65 73 73 65 |indows, |processe|
|00003cb0| 73 2c 20 61 6e 64 20 6f | 74 68 65 72 0a 58 67 6c |s, and o|ther.Xgl|
|00003cc0| 6f 62 61 6c 20 69 6e 66 | 6f 72 6d 61 74 69 6f 6e |obal inf|ormation|
|00003cd0| 2e 20 20 54 68 65 20 63 | 6f 6d 70 6f 6e 65 6e 74 |. The c|omponent|
|00003ce0| 73 20 6f 66 20 74 68 65 | 20 73 74 61 74 65 20 74 |s of the| state t|
|00003cf0| 68 61 74 20 61 72 65 20 | 75 73 65 64 20 69 6e 20 |hat are |used in |
|00003d00| 74 68 65 20 54 65 73 74 | 0a 58 70 61 63 6b 61 67 |the Test|.Xpackag|
|00003d10| 65 20 61 72 65 20 6c 69 | 73 74 65 64 20 6c 61 74 |e are li|sted lat|
|00003d20| 65 72 20 69 6e 20 74 68 | 69 73 20 73 65 63 74 69 |er in th|is secti|
|00003d30| 6f 6e 2e 0a 58 0a 58 40 | 64 66 6e 7b 52 65 67 72 |on..X.X@|dfn{Regr|
|00003d40| 65 73 73 69 6f 6e 20 54 | 65 73 74 69 6e 67 7d 20 |ession T|esting} |
|00003d50| 69 73 20 61 20 74 65 63 | 68 6e 69 71 75 65 20 66 |is a tec|hnique f|
|00003d60| 6f 72 20 76 65 72 69 66 | 79 69 6e 67 20 74 68 61 |or verif|ying tha|
|00003d70| 74 20 63 68 61 6e 67 65 | 73 20 69 6e 20 61 0a 58 |t change|s in a.X|
|00003d80| 70 61 63 6b 61 67 65 20 | 64 6f 20 6e 6f 74 20 75 |package |do not u|
|00003d90| 6e 69 6e 74 65 6e 74 69 | 6f 6e 61 6c 6c 79 20 64 |nintenti|onally d|
|00003da0| 65 67 72 61 64 65 20 74 | 68 65 20 71 75 61 6c 69 |egrade t|he quali|
|00003db0| 74 79 20 6f 66 20 74 68 | 65 20 63 6f 64 65 2e 20 |ty of th|e code. |
|00003dc0| 20 41 6e 79 0a 58 63 68 | 61 6e 67 65 73 20 69 6e | Any.Xch|anges in|
|00003dd0| 20 6f 6e 65 20 70 61 72 | 74 20 6f 66 20 74 68 65 | one par|t of the|
|00003de0| 20 70 61 63 6b 61 67 65 | 20 73 68 6f 75 6c 64 20 | package| should |
|00003df0| 6e 6f 74 20 61 6c 74 65 | 72 20 74 68 65 20 66 75 |not alte|r the fu|
|00003e00| 6e 63 74 69 6f 6e 61 6c | 69 74 79 20 6f 66 0a 58 |nctional|ity of.X|
|00003e10| 6f 74 68 65 72 20 70 61 | 72 74 73 20 6f 66 20 74 |other pa|rts of t|
|00003e20| 68 65 20 70 61 63 6b 61 | 67 65 2e 20 20 53 74 61 |he packa|ge. Sta|
|00003e30| 74 65 20 69 6e 66 6f 72 | 6d 61 74 69 6f 6e 20 70 |te infor|mation p|
|00003e40| 6c 61 79 73 20 74 77 6f | 20 72 6f 6c 65 73 20 69 |lays two| roles i|
|00003e50| 6e 0a 58 72 65 67 72 65 | 73 73 69 6f 6e 20 74 65 |n.Xregre|ssion te|
|00003e60| 73 74 69 6e 67 20 6f 66 | 20 45 6d 61 63 73 20 70 |sting of| Emacs p|
|00003e70| 61 63 6b 61 67 65 73 2e | 20 20 54 68 65 73 65 20 |ackages.| These |
|00003e80| 61 72 65 3a 0a 58 40 65 | 6e 75 6d 65 72 61 74 65 |are:.X@e|numerate|
|00003e90| 0a 58 40 69 74 65 6d 0a | 58 69 6e 69 74 69 61 74 |.X@item.|Xinitiat|
|00003ea0| 69 6e 67 20 74 68 65 20 | 72 75 6e 20 6f 66 20 61 |ing the |run of a|
|00003eb0| 20 70 61 63 6b 61 67 65 | 20 69 6e 20 61 20 63 6f | package| in a co|
|00003ec0| 6e 73 69 73 74 65 6e 74 | 20 61 6e 64 0a 58 70 72 |nsistent| and.Xpr|
|00003ed0| 65 2d 64 65 74 65 72 6d | 69 6e 65 64 20 40 64 66 |e-determ|ined @df|
|00003ee0| 6e 7b 69 6e 69 74 69 61 | 6c 20 73 74 61 74 65 7d |n{initia|l state}|
|00003ef0| 2c 20 61 6e 64 0a 58 40 | 69 74 65 6d 0a 58 63 6f |, and.X@|item.Xco|
|00003f00| 6d 70 61 72 69 6e 67 20 | 74 68 65 20 40 64 66 6e |mparing |the @dfn|
|00003f10| 7b 61 63 74 75 61 6c 20 | 66 69 6e 61 6c 20 73 74 |{actual |final st|
|00003f20| 61 74 65 7d 20 61 66 74 | 65 72 20 74 68 65 20 63 |ate} aft|er the c|
|00003f30| 6f 6d 70 6c 65 74 69 6f | 6e 20 6f 66 20 61 0a 58 |ompletio|n of a.X|
|00003f40| 70 61 63 6b 61 67 65 20 | 74 6f 20 61 20 40 64 66 |package |to a @df|
|00003f50| 6e 7b 64 65 73 69 72 65 | 64 20 66 69 6e 61 6c 20 |n{desire|d final |
|00003f60| 73 74 61 74 65 7d 2e 0a | 58 40 65 6e 64 20 65 6e |state}..|X@end en|
|00003f70| 75 6d 65 72 61 74 65 0a | 58 54 68 65 20 72 65 67 |umerate.|XThe reg|
|00003f80| 72 65 73 73 69 6f 6e 20 | 74 65 73 74 69 6e 67 20 |ression |testing |
|00003f90| 63 6f 6d 70 6f 6e 65 6e | 74 73 20 6f 66 20 40 73 |componen|ts of @s|
|00003fa0| 61 6d 70 7b 74 65 73 74 | 2e 65 6c 7d 20 61 6c 6c |amp{test|.el} all|
|00003fb0| 6f 77 20 79 6f 75 20 74 | 6f 0a 58 40 64 66 6e 7b |ow you t|o.X@dfn{|
|00003fc0| 63 61 70 74 75 72 65 7d | 20 73 65 73 73 69 6f 6e |capture}| session|
|00003fd0| 20 73 74 61 74 65 73 20 | 66 6f 72 20 6c 61 74 65 | states |for late|
|00003fe0| 72 20 75 73 65 2c 20 40 | 64 66 6e 7b 61 63 68 69 |r use, @|dfn{achi|
|00003ff0| 65 76 65 7d 20 74 68 65 | 73 65 20 73 74 61 74 65 |eve} the|se state|
|00004000| 73 20 74 6f 0a 58 73 65 | 74 20 75 70 20 61 20 74 |s to.Xse|t up a t|
|00004010| 65 73 74 20 72 75 6e 2c | 20 61 6e 64 20 74 65 73 |est run,| and tes|
|00004020| 74 20 74 68 65 20 40 64 | 66 6e 7b 65 71 75 61 6c |t the @d|fn{equal|
|00004030| 69 74 79 7d 20 6f 66 20 | 73 74 61 74 65 73 20 66 |ity} of |states f|
|00004040| 6f 72 20 70 61 63 6b 61 | 67 65 0a 58 76 65 72 69 |or packa|ge.Xveri|
|00004050| 66 69 63 61 74 69 6f 6e | 2e 0a 58 0a 58 54 68 65 |fication|..X.XThe|
|00004060| 20 66 6f 6c 6c 6f 77 69 | 6e 67 20 65 78 61 6d 70 | followi|ng examp|
|00004070| 6c 65 20 64 65 6d 6f 6e | 73 74 72 61 74 65 73 20 |le demon|strates |
|00004080| 74 68 65 73 65 20 73 74 | 65 70 73 20 66 6f 72 20 |these st|eps for |
|00004090| 72 65 67 72 65 73 73 69 | 6f 6e 73 20 74 65 73 74 |regressi|ons test|
|000040a0| 69 6e 67 20 61 6e 0a 58 | 61 72 62 69 74 72 61 72 |ing an.X|arbitrar|
|000040b0| 79 20 70 61 63 6b 61 67 | 65 2e 20 20 41 73 73 75 |y packag|e. Assu|
|000040c0| 6d 65 20 74 68 61 74 20 | 61 20 77 6f 72 6b 69 6e |me that |a workin|
|000040d0| 67 20 76 65 72 73 69 6f | 6e 20 6f 66 20 73 6f 6d |g versio|n of som|
|000040e0| 65 20 70 61 63 6b 61 67 | 65 20 65 78 69 73 74 73 |e packag|e exists|
|000040f0| 2e 0a 58 4e 6f 77 20 73 | 75 70 70 6f 73 65 20 79 |..XNow s|uppose y|
|00004100| 6f 75 20 77 69 73 68 20 | 74 6f 20 61 64 64 20 73 |ou wish |to add s|
|00004110| 6f 6d 65 20 6e 65 77 20 | 66 75 6e 63 74 69 6f 6e |ome new |function|
|00004120| 20 74 68 61 74 20 72 65 | 71 75 69 72 65 73 20 73 | that re|quires s|
|00004130| 6f 6d 65 0a 58 6d 6f 64 | 69 66 69 63 61 74 69 6f |ome.Xmod|ificatio|
|00004140| 6e 73 20 69 6e 20 74 68 | 65 20 6f 72 69 67 69 6e |ns in th|e origin|
|00004150| 61 6c 20 63 6f 64 65 2e | 20 41 66 74 65 72 20 61 |al code.| After a|
|00004160| 64 64 69 6e 67 20 74 68 | 65 20 6e 65 77 20 66 75 |dding th|e new fu|
|00004170| 6e 63 74 69 6f 6e 20 79 | 6f 75 20 6e 65 65 64 0a |nction y|ou need.|
|00004180| 58 74 6f 20 76 65 72 69 | 66 79 20 74 68 61 74 20 |Xto veri|fy that |
|00004190| 74 68 65 20 6f 72 69 67 | 69 6e 61 6c 20 66 75 6e |the orig|inal fun|
|000041a0| 63 74 69 6f 6e 61 6c 69 | 74 79 20 6f 66 20 74 68 |ctionali|ty of th|
|000041b0| 65 20 70 61 63 6b 61 67 | 65 20 68 61 73 20 6e 6f |e packag|e has no|
|000041c0| 74 20 63 68 61 6e 67 65 | 64 2e 0a 58 49 6e 20 6f |t change|d..XIn o|
|000041d0| 74 68 65 72 20 77 6f 72 | 64 73 2c 20 79 6f 75 20 |ther wor|ds, you |
|000041e0| 6e 65 65 64 20 74 6f 20 | 76 65 72 69 66 79 20 74 |need to |verify t|
|000041f0| 68 61 74 20 74 68 65 20 | 63 6f 64 65 20 68 61 73 |hat the |code has|
|00004200| 20 6e 6f 74 20 40 64 66 | 6e 7b 72 65 67 72 65 73 | not @df|n{regres|
|00004210| 73 65 64 7d 0a 58 66 72 | 6f 6d 20 69 74 73 20 6f |sed}.Xfr|om its o|
|00004220| 72 69 67 69 6e 61 6c 20 | 66 75 6e 63 74 69 6f 6e |riginal |function|
|00004230| 61 6c 69 74 79 2e 20 20 | 54 6f 20 70 65 72 66 6f |ality. |To perfo|
|00004240| 72 6d 20 74 68 69 73 20 | 74 65 73 74 69 6e 67 2c |rm this |testing,|
|00004250| 20 79 6f 75 0a 58 40 64 | 66 6e 7b 63 61 70 74 75 | you.X@d|fn{captu|
|00004260| 72 65 7d 20 74 68 65 20 | 69 6e 69 74 69 61 6c 20 |re} the |initial |
|00004270| 73 74 61 74 65 20 6f 66 | 20 61 20 73 65 73 73 69 |state of| a sessi|
|00004280| 6f 6e 2c 20 72 75 6e 20 | 74 68 65 20 6f 72 69 67 |on, run |the orig|
|00004290| 69 6e 61 6c 20 70 61 63 | 6b 61 67 65 2c 20 61 6e |inal pac|kage, an|
|000042a0| 64 0a 58 40 64 66 6e 7b | 63 61 70 74 75 72 65 7d |d.X@dfn{|capture}|
|000042b0| 20 74 68 65 20 66 69 6e | 61 6c 20 73 74 61 74 65 | the fin|al state|
|000042c0| 2e 20 20 46 6f 6c 6c 6f | 77 69 6e 67 20 74 68 69 |. Follo|wing thi|
|000042d0| 73 2c 20 79 6f 75 20 40 | 64 66 6e 7b 61 63 68 69 |s, you @|dfn{achi|
|000042e0| 65 76 65 7d 20 74 68 65 | 0a 58 69 6e 69 74 69 61 |eve} the|.Xinitia|
|000042f0| 6c 20 73 74 61 74 65 20 | 74 68 61 74 20 79 6f 75 |l state |that you|
|00004300| 20 70 72 65 76 69 6f 75 | 73 6c 79 20 63 61 70 74 | previou|sly capt|
|00004310| 75 72 65 64 2c 20 72 75 | 6e 20 74 68 65 20 6e 65 |ured, ru|n the ne|
|00004320| 77 20 76 65 72 73 69 6f | 6e 20 6f 66 20 74 68 65 |w versio|n of the|
|00004330| 0a 58 70 61 63 6b 61 67 | 65 2c 20 61 6e 64 20 70 |.Xpackag|e, and p|
|00004340| 65 72 66 6f 72 6d 20 61 | 6e 20 40 64 66 6e 7b 65 |erform a|n @dfn{e|
|00004350| 71 75 61 6c 69 74 79 7d | 20 74 65 73 74 20 74 6f |quality}| test to|
|00004360| 20 63 6f 6d 70 61 72 65 | 20 74 68 65 20 6e 65 77 | compare| the new|
|00004370| 20 66 69 6e 61 6c 20 73 | 74 61 74 65 0a 58 74 6f | final s|tate.Xto|
|00004380| 20 74 68 65 20 6f 6e 65 | 20 74 68 61 74 20 77 61 | the one| that wa|
|00004390| 73 20 63 61 70 74 75 72 | 65 64 20 61 66 74 65 72 |s captur|ed after|
|000043a0| 20 74 68 65 20 72 75 6e | 20 6f 66 20 74 68 65 20 | the run| of the |
|000043b0| 6f 72 69 67 69 6e 61 6c | 20 70 61 63 6b 61 67 65 |original| package|
|000043c0| 2e 20 20 54 68 65 0a 58 | 73 74 61 74 65 73 20 73 |. The.X|states s|
|000043d0| 68 6f 75 6c 64 20 62 65 | 20 65 71 75 69 76 61 6c |hould be| equival|
|000043e0| 65 6e 74 20 69 66 20 74 | 68 65 20 74 65 73 74 20 |ent if t|he test |
|000043f0| 69 73 20 73 75 63 63 65 | 73 73 66 75 6c 2e 0a 58 |is succe|ssful..X|
|00004400| 0a 58 54 77 6f 20 65 78 | 74 65 6e 73 69 6f 6e 73 |.XTwo ex|tensions|
|00004410| 20 74 6f 20 74 68 69 73 | 20 73 74 61 74 65 20 63 | to this| state c|
|00004420| 6f 6d 70 61 72 69 73 6f | 6e 20 70 61 72 61 64 69 |ompariso|n paradi|
|00004430| 67 6d 20 61 72 65 3a 0a | 58 40 65 6e 75 6d 65 72 |gm are:.|X@enumer|
|00004440| 61 74 65 0a 58 40 69 74 | 65 6d 0a 58 54 65 73 74 |ate.X@it|em.XTest|
|00004450| 69 6e 67 20 66 6f 72 20 | 70 61 72 74 69 61 6c 20 |ing for |partial |
|00004460| 65 71 75 69 76 61 6c 65 | 6e 63 65 20 2d 20 45 61 |equivale|nce - Ea|
|00004470| 63 68 20 45 6d 61 63 73 | 20 70 61 63 6b 61 67 65 |ch Emacs| package|
|00004480| 20 69 73 20 73 75 70 70 | 6f 73 65 64 20 74 6f 20 | is supp|osed to |
|00004490| 63 68 61 6e 67 65 0a 58 | 63 65 72 74 61 69 6e 20 |change.X|certain |
|000044a0| 61 73 70 65 63 74 73 20 | 6f 66 20 61 20 73 65 73 |aspects |of a ses|
|000044b0| 73 69 6f 6e 20 73 74 61 | 74 65 2c 20 62 75 74 20 |sion sta|te, but |
|000044c0| 6c 65 61 76 65 20 6f 74 | 68 65 72 73 20 75 6e 63 |leave ot|hers unc|
|000044d0| 68 61 6e 67 65 64 2e 20 | 20 46 6f 72 0a 58 65 78 |hanged. | For.Xex|
|000044e0| 61 6d 70 6c 65 2c 20 61 | 20 70 61 63 6b 61 67 65 |ample, a| package|
|000044f0| 20 6d 61 79 20 63 68 61 | 6e 67 65 20 74 68 65 20 | may cha|nge the |
|00004500| 74 65 78 74 20 6f 66 20 | 74 68 65 20 63 75 72 72 |text of |the curr|
|00004510| 65 6e 74 20 62 75 66 66 | 65 72 20 62 75 74 20 73 |ent buff|er but s|
|00004520| 68 6f 75 6c 64 0a 58 6c | 65 61 76 65 20 74 68 65 |hould.Xl|eave the|
|00004530| 20 77 69 6e 64 6f 77 20 | 63 6f 6e 66 69 67 75 72 | window |configur|
|00004540| 61 74 69 6f 6e 20 6f 66 | 20 74 68 65 20 73 65 73 |ation of| the ses|
|00004550| 73 69 6f 6e 20 69 6e 74 | 61 63 74 2e 20 20 50 61 |sion int|act. Pa|
|00004560| 72 74 69 61 6c 20 65 71 | 75 69 76 61 6c 65 6e 63 |rtial eq|uivalenc|
|00004570| 65 0a 58 74 65 73 74 69 | 6e 67 20 63 6f 6e 73 69 |e.Xtesti|ng consi|
|00004580| 73 74 73 20 6f 66 20 74 | 68 65 20 66 6f 6c 6c 6f |sts of t|he follo|
|00004590| 77 69 6e 67 20 73 74 65 | 70 73 3a 0a 58 40 65 6e |wing ste|ps:.X@en|
|000045a0| 75 6d 65 72 61 74 65 0a | 58 40 69 74 65 6d 0a 58 |umerate.|X@item.X|
|000045b0| 43 61 70 74 75 72 65 20 | 74 68 65 20 69 6e 69 74 |Capture |the init|
|000045c0| 69 61 6c 20 73 74 61 74 | 65 2e 0a 58 40 69 74 65 |ial stat|e..X@ite|
|000045d0| 6d 0a 58 52 75 6e 20 74 | 68 65 20 66 75 6e 63 74 |m.XRun t|he funct|
|000045e0| 69 6f 6e 20 74 6f 20 62 | 65 20 74 65 73 74 65 64 |ion to b|e tested|
|000045f0| 2e 0a 58 40 69 74 65 6d | 0a 58 43 6f 6d 70 61 72 |..X@item|.XCompar|
|00004600| 65 20 74 68 65 20 66 69 | 6e 61 6c 20 73 74 61 74 |e the fi|nal stat|
|00004610| 65 20 74 6f 20 74 68 65 | 20 69 6e 69 74 69 61 6c |e to the| initial|
|00004620| 20 73 74 61 74 65 2e 20 | 20 54 68 65 20 73 74 61 | state. | The sta|
|00004630| 74 65 73 20 73 68 6f 75 | 6c 64 20 62 65 0a 58 65 |tes shou|ld be.Xe|
|00004640| 71 75 69 76 61 6c 65 6e | 74 20 69 6e 20 61 6c 6c |quivalen|t in all|
|00004650| 20 61 72 65 61 73 20 65 | 78 63 65 70 74 20 74 68 | areas e|xcept th|
|00004660| 6f 73 65 20 74 68 61 74 | 20 74 68 65 20 74 65 73 |ose that| the tes|
|00004670| 74 20 66 75 6e 63 74 69 | 6f 6e 20 69 73 20 73 75 |t functi|on is su|
|00004680| 70 70 6f 73 65 64 20 74 | 6f 0a 58 63 68 61 6e 67 |pposed t|o.Xchang|
|00004690| 65 2e 0a 58 40 65 6e 64 | 20 65 6e 75 6d 65 72 61 |e..X@end| enumera|
|000046a0| 74 65 0a 58 40 69 74 65 | 6d 0a 58 54 65 73 74 69 |te.X@ite|m.XTesti|
|000046b0| 6e 67 20 66 75 6e 63 74 | 69 6f 6e 73 20 74 68 61 |ng funct|ions tha|
|000046c0| 74 20 75 6e 64 6f 20 74 | 68 65 20 65 66 66 65 63 |t undo t|he effec|
|000046d0| 74 73 20 6f 66 20 6f 74 | 68 65 72 20 66 75 6e 63 |ts of ot|her func|
|000046e0| 74 69 6f 6e 73 20 2d 20 | 53 6f 6d 65 20 65 6d 61 |tions - |Some ema|
|000046f0| 63 73 0a 58 70 61 63 6b | 61 67 65 73 20 68 61 76 |cs.Xpack|ages hav|
|00004700| 65 20 61 20 66 75 6e 63 | 74 69 6f 6e 20 74 68 61 |e a func|tion tha|
|00004710| 74 20 70 65 72 66 6f 72 | 6d 20 73 6f 6d 65 20 73 |t perfor|m some s|
|00004720| 74 61 74 65 20 63 68 61 | 6e 67 65 20 61 6e 64 20 |tate cha|nge and |
|00004730| 61 20 63 6f 72 72 65 73 | 70 6f 6e 64 69 6e 67 0a |a corres|ponding.|
|00004740| 58 66 75 6e 63 74 69 6f | 6e 20 74 68 61 74 20 75 |Xfunctio|n that u|
|00004750| 6e 64 6f 65 73 20 74 68 | 61 74 20 63 68 61 6e 67 |ndoes th|at chang|
|00004760| 65 2e 20 20 54 65 73 74 | 69 6e 67 20 74 68 65 73 |e. Test|ing thes|
|00004770| 65 20 74 79 70 65 73 20 | 6f 66 20 70 61 63 6b 61 |e types |of packa|
|00004780| 67 65 73 20 63 6f 6e 73 | 69 73 74 73 0a 58 6f 66 |ges cons|ists.Xof|
|00004790| 20 74 68 65 20 66 6f 6c | 6c 6f 77 69 6e 67 20 73 | the fol|lowing s|
|000047a0| 74 65 70 73 3a 0a 58 40 | 65 6e 75 6d 65 72 61 74 |teps:.X@|enumerat|
|000047b0| 65 0a 58 40 69 74 65 6d | 0a 58 43 61 70 74 75 72 |e.X@item|.XCaptur|
|000047c0| 65 20 74 68 65 20 69 6e | 69 74 69 61 6c 20 73 74 |e the in|itial st|
|000047d0| 61 74 65 2e 0a 58 40 69 | 74 65 6d 0a 58 52 75 6e |ate..X@i|tem.XRun|
|000047e0| 20 74 68 65 20 66 75 6e | 63 74 69 6f 6e 20 74 68 | the fun|ction th|
|000047f0| 61 74 20 70 65 72 66 6f | 72 6d 73 20 74 68 65 20 |at perfo|rms the |
|00004800| 73 74 61 74 65 20 63 68 | 61 6e 67 65 2e 0a 58 40 |state ch|ange..X@|
|00004810| 69 74 65 6d 0a 58 52 75 | 6e 20 74 68 65 20 66 75 |item.XRu|n the fu|
|00004820| 6e 63 74 69 6f 6e 20 74 | 68 61 74 20 75 6e 64 6f |nction t|hat undo|
|00004830| 65 73 20 74 68 65 20 73 | 74 61 74 65 20 63 68 61 |es the s|tate cha|
|00004840| 6e 67 65 2e 0a 58 40 69 | 74 65 6d 0a 58 43 6f 6d |nge..X@i|tem.XCom|
|00004850| 70 61 72 65 20 74 68 65 | 20 66 69 6e 61 6c 20 73 |pare the| final s|
|00004860| 74 61 74 65 20 74 6f 20 | 74 68 65 20 69 6e 69 74 |tate to |the init|
|00004870| 69 61 6c 20 73 74 61 74 | 65 2e 20 20 54 68 65 79 |ial stat|e. They|
|00004880| 20 73 68 6f 75 6c 64 20 | 62 65 20 65 71 75 69 76 | should |be equiv|
|00004890| 61 6c 65 6e 74 2e 0a 58 | 40 65 6e 64 20 65 6e 75 |alent..X|@end enu|
|000048a0| 6d 65 72 61 74 65 0a 58 | 40 65 6e 64 20 65 6e 75 |merate.X|@end enu|
|000048b0| 6d 65 72 61 74 65 0a 58 | 54 68 65 20 72 65 6d 61 |merate.X|The rema|
|000048c0| 69 6e 64 65 72 20 6f 66 | 20 74 68 69 73 20 73 65 |inder of| this se|
|000048d0| 63 74 69 6f 6e 20 64 65 | 73 63 72 69 62 65 73 20 |ction de|scribes |
|000048e0| 74 68 65 20 65 6c 65 6d | 65 6e 74 73 20 6f 66 20 |the elem|ents of |
|000048f0| 74 68 65 20 54 65 73 74 | 0a 58 70 61 63 6b 61 67 |the Test|.Xpackag|
|00004900| 65 20 74 68 61 74 20 69 | 6d 70 6c 65 6d 65 6e 74 |e that i|mplement|
|00004910| 20 74 68 65 73 65 20 61 | 73 70 65 63 74 73 20 6f | these a|spects o|
|00004920| 66 20 72 65 67 72 65 73 | 73 69 6f 6e 20 74 65 73 |f regres|sion tes|
|00004930| 74 69 6e 67 2e 0a 58 49 | 6e 20 73 75 6d 6d 61 72 |ting..XI|n summar|
|00004940| 79 2c 20 74 68 65 73 65 | 20 61 72 65 3a 0a 58 40 |y, these| are:.X@|
|00004950| 69 74 65 6d 69 7a 65 20 | 40 62 75 6c 6c 65 74 0a |itemize |@bullet.|
|00004960| 58 40 69 74 65 6d 0a 58 | 40 63 6f 64 65 7b 63 61 |X@item.X|@code{ca|
|00004970| 70 74 75 72 65 7d 20 2d | 20 73 61 76 65 73 20 74 |pture} -| saves t|
|00004980| 68 65 20 63 75 72 72 65 | 6e 74 20 73 74 61 74 65 |he curre|nt state|
|00004990| 20 6f 66 20 74 68 65 20 | 45 6d 61 63 73 20 73 65 | of the |Emacs se|
|000049a0| 73 73 69 6f 6e 0a 58 69 | 6e 20 65 69 74 68 65 72 |ssion.Xi|n either|
|000049b0| 20 61 20 62 6f 75 6e 64 | 20 76 61 72 69 61 62 6c | a bound| variabl|
|000049c0| 65 20 6f 72 20 55 4e 49 | 58 20 66 69 6c 65 2e 0a |e or UNI|X file..|
|000049d0| 58 40 69 74 65 6d 0a 58 | 40 63 6f 64 65 7b 70 61 |X@item.X|@code{pa|
|000049e0| 72 74 69 61 6c 20 63 61 | 70 74 75 72 65 7d 20 2d |rtial ca|pture} -|
|000049f0| 20 73 61 76 65 20 70 61 | 72 74 20 6f 66 20 74 68 | save pa|rt of th|
|00004a00| 65 20 63 75 72 72 65 6e | 74 20 73 74 61 74 65 20 |e curren|t state |
|00004a10| 6f 66 20 74 68 65 0a 58 | 45 6d 61 63 73 20 73 65 |of the.X|Emacs se|
|00004a20| 73 73 69 6f 6e 2e 20 20 | 53 6f 6d 65 20 6f 72 20 |ssion. |Some or |
|00004a30| 61 6c 6c 20 67 6c 6f 62 | 61 6c 20 76 61 72 69 61 |all glob|al varia|
|00004a40| 62 6c 65 73 20 6d 61 79 | 20 62 65 20 65 78 63 6c |bles may| be excl|
|00004a50| 75 64 65 64 2c 20 61 6e | 64 20 61 20 73 75 62 73 |uded, an|d a subs|
|00004a60| 65 74 0a 58 6f 66 20 62 | 75 66 66 65 72 73 20 6d |et.Xof b|uffers m|
|00004a70| 61 79 20 62 65 20 73 65 | 6c 65 63 74 65 64 2e 0a |ay be se|lected..|
|00004a80| 58 40 69 74 65 6d 0a 58 | 40 63 6f 64 65 7b 61 63 |X@item.X|@code{ac|
|00004a90| 68 69 65 76 65 7d 20 2d | 20 73 65 74 73 20 74 68 |hieve} -| sets th|
|00004aa0| 65 20 73 74 61 74 65 20 | 6f 66 20 74 68 65 20 63 |e state |of the c|
|00004ab0| 75 72 72 65 6e 74 20 73 | 65 73 73 69 6f 6e 20 74 |urrent s|ession t|
|00004ac0| 6f 20 6f 6e 65 0a 58 74 | 68 61 74 20 69 73 20 65 |o one.Xt|hat is e|
|00004ad0| 69 74 68 65 72 20 69 6e | 20 61 20 62 6f 75 6e 64 |ither in| a bound|
|00004ae0| 20 76 61 72 69 61 62 6c | 65 20 6f 72 20 61 20 55 | variabl|e or a U|
|00004af0| 4e 49 58 20 66 69 6c 65 | 2e 0a 58 40 69 74 65 6d |NIX file|..X@item|
|00004b00| 0a 58 40 63 6f 64 65 7b | 65 71 75 61 6c 69 74 79 |.X@code{|equality|
|00004b10| 7d 20 2d 20 63 6f 6d 70 | 61 72 65 73 20 74 77 6f |} - comp|ares two|
|00004b20| 20 65 6d 61 63 73 20 73 | 65 73 73 69 6f 6e 73 20 | emacs s|essions |
|00004b30| 73 74 61 74 65 73 20 66 | 6f 72 0a 58 65 71 75 69 |states f|or.Xequi|
|00004b40| 76 61 6c 65 6e 63 65 2e | 0a 58 40 69 74 65 6d 0a |valence.|.X@item.|
|00004b50| 58 40 63 6f 64 65 7b 70 | 61 72 74 69 61 6c 20 65 |X@code{p|artial e|
|00004b60| 71 75 61 6c 69 74 79 7d | 20 2d 20 63 6f 6d 70 61 |quality}| - compa|
|00004b70| 72 65 73 20 73 65 6c 65 | 63 74 65 64 20 61 73 70 |res sele|cted asp|
|00004b80| 65 63 74 73 20 6f 66 20 | 74 77 6f 20 65 6d 61 63 |ects of |two emac|
|00004b90| 73 0a 58 73 65 73 73 69 | 6f 6e 20 73 74 61 74 65 |s.Xsessi|on state|
|00004ba0| 73 20 66 6f 72 20 65 71 | 75 69 76 61 6c 65 6e 63 |s for eq|uivalenc|
|00004bb0| 65 2e 0a 58 40 69 74 65 | 6d 0a 58 40 63 6f 64 65 |e..X@ite|m.X@code|
|00004bc0| 7b 69 6e 65 71 75 61 6c | 69 74 79 7d 20 2d 20 75 |{inequal|ity} - u|
|00004bd0| 73 69 6e 67 20 75 73 65 | 72 20 64 65 66 69 6e 65 |sing use|r define|
|00004be0| 64 20 68 6f 6f 6b 73 2c | 20 63 6f 6d 70 61 72 65 |d hooks,| compare|
|00004bf0| 73 20 74 77 6f 0a 58 73 | 65 73 73 69 6f 6e 20 73 |s two.Xs|ession s|
|00004c00| 74 61 74 65 73 20 77 69 | 74 68 69 6e 20 63 65 72 |tates wi|thin cer|
|00004c10| 74 61 69 6e 20 64 65 67 | 72 65 65 73 20 6f 66 20 |tain deg|rees of |
|00004c20| 69 6e 65 71 75 61 6c 69 | 74 79 20 28 65 2e 67 2e |inequali|ty (e.g.|
|00004c30| 20 63 6f 6d 70 61 72 65 | 73 20 62 75 66 66 65 72 | compare|s buffer|
|00004c40| 0a 58 63 6f 6e 74 65 6e | 74 73 20 69 67 6e 6f 72 |.Xconten|ts ignor|
|00004c50| 69 6e 67 20 77 68 69 74 | 65 73 70 61 63 65 29 2e |ing whit|espace).|
|00004c60| 0a 58 40 65 6e 64 20 69 | 74 65 6d 69 7a 65 0a 58 |.X@end i|temize.X|
|00004c70| 0a 58 40 73 65 63 74 69 | 6f 6e 20 43 61 70 74 75 |.X@secti|on Captu|
|00004c80| 72 69 6e 67 20 61 6e 64 | 20 41 63 68 69 65 76 69 |ring and| Achievi|
|00004c90| 6e 67 20 45 6d 61 63 73 | 20 53 74 61 74 65 73 0a |ng Emacs| States.|
|00004ca0| 58 0a 58 40 73 75 62 73 | 65 63 74 69 6f 6e 20 47 |X.X@subs|ection G|
|00004cb0| 4e 55 20 45 6d 61 63 73 | 20 53 74 61 74 65 20 44 |NU Emacs| State D|
|00004cc0| 65 66 69 6e 69 74 69 6f | 6e 0a 58 0a 58 54 68 65 |efinitio|n.X.XThe|
|00004cd0| 20 40 64 66 6e 7b 63 61 | 70 74 75 72 65 7d 20 61 | @dfn{ca|pture} a|
|00004ce0| 6e 64 20 40 64 66 6e 7b | 61 63 68 69 65 76 65 7d |nd @dfn{|achieve}|
|00004cf0| 20 66 75 6e 63 74 69 6f | 6e 73 20 6f 66 20 40 73 | functio|ns of @s|
|00004d00| 61 6d 70 7b 74 65 73 74 | 2e 65 6c 7d 20 72 65 70 |amp{test|.el} rep|
|00004d10| 72 65 73 65 6e 74 0a 58 | 61 6e 20 45 6d 61 63 73 |resent.X|an Emacs|
|00004d20| 20 73 74 61 74 65 20 61 | 73 20 74 68 65 20 68 69 | state a|s the hi|
|00004d30| 65 72 61 72 63 68 79 20 | 6f 66 20 64 61 74 61 20 |erarchy |of data |
|00004d40| 73 68 6f 77 6e 20 62 65 | 6c 6f 77 2e 0a 58 40 69 |shown be|low..X@i|
|00004d50| 74 65 6d 69 7a 65 20 40 | 62 75 6c 6c 65 74 0a 58 |temize @|bullet.X|
|00004d60| 40 69 74 65 6d 0a 58 40 | 63 6f 64 65 7b 47 6c 6f |@item.X@|code{Glo|
|00004d70| 62 61 6c 20 42 6f 75 6e | 64 20 53 79 6d 62 6f 6c |bal Boun|d Symbol|
|00004d80| 73 7d 20 2d 20 4d 6f 73 | 74 20 6f 66 20 74 68 65 |s} - Mos|t of the|
|00004d90| 20 69 6e 66 6f 72 6d 61 | 74 69 6f 6e 20 61 62 6f | informa|tion abo|
|00004da0| 75 74 20 61 6e 0a 58 45 | 6d 61 63 73 20 73 65 73 |ut an.XE|macs ses|
|00004db0| 73 69 6f 6e 20 69 73 20 | 63 6f 6e 74 61 69 6e 65 |sion is |containe|
|00004dc0| 64 20 69 6e 20 74 68 65 | 20 76 61 6c 75 65 73 20 |d in the| values |
|00004dd0| 6f 66 20 73 79 6d 62 6f | 6c 73 20 67 6c 6f 62 61 |of symbo|ls globa|
|00004de0| 6c 20 74 6f 20 74 68 65 | 20 73 65 73 73 69 6f 6e |l to the| session|
|00004df0| 2e 0a 58 49 6e 20 63 6f | 6e 76 65 6e 74 69 6f 6e |..XIn co|nvention|
|00004e00| 61 6c 20 70 72 6f 67 72 | 61 6d 6d 69 6e 67 20 6c |al progr|amming l|
|00004e10| 61 6e 67 75 61 67 65 20 | 74 65 72 6d 73 2c 20 74 |anguage |terms, t|
|00004e20| 68 69 73 20 73 65 73 73 | 69 6f 6e 20 69 6e 66 6f |his sess|ion info|
|00004e30| 72 6d 61 74 69 6f 6e 20 | 63 61 6e 20 62 65 0a 58 |rmation |can be.X|
|00004e40| 76 69 65 77 65 64 20 61 | 73 20 74 68 65 20 76 61 |viewed a|s the va|
|00004e50| 6c 75 65 73 20 6f 66 20 | 67 6c 6f 62 61 6c 20 76 |lues of |global v|
|00004e60| 61 72 69 61 62 6c 65 73 | 2e 20 20 53 6f 6d 65 20 |ariables|. Some |
|00004e70| 65 78 61 6d 70 6c 65 73 | 20 6f 66 20 63 6f 6d 6d |examples| of comm|
|00004e80| 6f 6e 20 67 6c 6f 62 61 | 6c 0a 58 62 6f 75 6e 64 |on globa|l.Xbound|
|00004e90| 20 73 79 6d 62 6f 6c 73 | 20 61 72 65 3a 0a 58 40 | symbols| are:.X@|
|00004ea0| 69 74 65 6d 69 7a 65 20 | 40 62 75 6c 6c 65 74 0a |itemize |@bullet.|
|00004eb0| 58 40 69 74 65 6d 0a 58 | 40 73 61 6d 70 7b 67 6c |X@item.X|@samp{gl|
|00004ec0| 6f 62 61 6c 2d 61 62 62 | 72 65 76 2d 74 61 62 6c |obal-abb|rev-tabl|
|00004ed0| 65 7d 20 2d 20 74 68 65 | 20 6c 69 73 74 20 6f 66 |e} - the| list of|
|00004ee0| 20 61 62 62 72 65 76 69 | 61 74 69 6f 6e 73 20 67 | abbrevi|ations g|
|00004ef0| 6c 6f 62 61 6c 20 74 6f | 0a 58 74 68 65 20 73 65 |lobal to|.Xthe se|
|00004f00| 73 73 69 6f 6e 20 61 6e | 64 20 74 68 65 69 72 20 |ssion an|d their |
|00004f10| 6d 65 61 6e 69 6e 67 73 | 2e 0a 58 40 69 74 65 6d |meanings|..X@item|
|00004f20| 0a 58 40 73 61 6d 70 7b | 67 6c 6f 62 61 6c 2d 6d |.X@samp{|global-m|
|00004f30| 61 70 7d 20 2d 20 61 20 | 76 65 63 74 6f 72 20 64 |ap} - a |vector d|
|00004f40| 65 73 63 72 69 62 69 6e | 67 20 74 68 65 20 6d 61 |escribin|g the ma|
|00004f50| 70 70 69 6e 67 73 20 6f | 66 20 61 6c 6c 20 6b 65 |ppings o|f all ke|
|00004f60| 79 73 0a 58 74 6f 20 45 | 6d 61 63 73 20 63 6f 6d |ys.Xto E|macs com|
|00004f70| 6d 61 6e 64 73 2e 0a 58 | 40 69 74 65 6d 0a 58 40 |mands..X|@item.X@|
|00004f80| 73 61 6d 70 7b 64 65 62 | 75 67 2d 6f 6e 2d 65 72 |samp{deb|ug-on-er|
|00004f90| 72 6f 72 7d 20 2d 20 61 | 20 66 6c 61 67 20 74 68 |ror} - a| flag th|
|00004fa0| 61 74 20 69 6e 64 69 63 | 61 74 65 73 20 74 68 61 |at indic|ates tha|
|00004fb0| 74 20 74 68 65 20 45 6d | 61 63 73 0a 58 64 65 62 |t the Em|acs.Xdeb|
|00004fc0| 75 67 67 65 72 20 73 68 | 6f 75 6c 64 20 62 65 20 |ugger sh|ould be |
|00004fd0| 63 61 6c 6c 65 64 20 6f | 6e 20 61 6e 20 65 72 72 |called o|n an err|
|00004fe0| 6f 72 20 28 69 66 20 6e | 6f 6e 2d 6e 69 6c 29 2e |or (if n|on-nil).|
|00004ff0| 0a 58 40 65 6e 64 20 69 | 74 65 6d 69 7a 65 0a 58 |.X@end i|temize.X|
|00005000| 40 69 74 65 6d 0a 58 40 | 63 6f 64 65 7b 42 75 66 |@item.X@|code{Buf|
|00005010| 66 65 72 20 49 6e 66 6f | 72 6d 61 74 69 6f 6e 7d |fer Info|rmation}|
|00005020| 20 2d 20 45 61 63 68 20 | 45 6d 61 63 73 20 73 65 | - Each |Emacs se|
|00005030| 73 73 69 6f 6e 20 63 6f | 6e 74 61 69 6e 73 20 6f |ssion co|ntains o|
|00005040| 6e 65 20 6f 72 0a 58 6d | 6f 72 65 20 62 75 66 66 |ne or.Xm|ore buff|
|00005050| 65 72 73 2e 20 20 54 68 | 65 20 63 61 70 74 75 72 |ers. Th|e captur|
|00005060| 65 20 66 75 6e 63 74 69 | 6f 6e 73 20 73 74 6f 72 |e functi|ons stor|
|00005070| 65 20 74 68 65 20 66 6f | 6c 6c 6f 77 69 6e 67 20 |e the fo|llowing |
|00005080| 69 6e 66 6f 72 6d 61 74 | 69 6f 6e 20 66 6f 72 0a |informat|ion for.|
|00005090| 58 65 61 63 68 20 61 63 | 74 69 76 65 20 62 75 66 |Xeach ac|tive buf|
|000050a0| 66 65 72 3a 0a 58 40 69 | 74 65 6d 69 7a 65 20 40 |fer:.X@i|temize @|
|000050b0| 62 75 6c 6c 65 74 0a 58 | 40 69 74 65 6d 0a 58 62 |bullet.X|@item.Xb|
|000050c0| 75 66 66 65 72 20 6e 61 | 6d 65 20 2d 20 61 20 75 |uffer na|me - a u|
|000050d0| 6e 69 71 75 65 20 6e 61 | 6d 65 20 74 68 61 74 20 |nique na|me that |
|000050e0| 69 64 65 6e 74 69 66 69 | 65 73 20 74 68 65 20 62 |identifi|es the b|
|000050f0| 75 66 66 65 72 2e 0a 58 | 40 69 74 65 6d 0a 58 66 |uffer..X|@item.Xf|
|00005100| 69 6c 65 20 6e 61 6d 65 | 20 2d 20 69 66 20 74 68 |ile name| - if th|
|00005110| 65 20 62 75 66 66 65 72 | 20 69 73 20 61 73 73 6f |e buffer| is asso|
|00005120| 63 69 61 74 65 64 20 77 | 69 74 68 20 61 20 55 4e |ciated w|ith a UN|
|00005130| 49 58 20 66 69 6c 65 2c | 20 74 68 65 0a 58 6e 61 |IX file,| the.Xna|
|00005140| 6d 65 20 6f 66 20 74 68 | 61 74 20 66 69 6c 65 2e |me of th|at file.|
|00005150| 0a 58 40 69 74 65 6d 0a | 58 70 6f 69 6e 74 20 2d |.X@item.|Xpoint -|
|00005160| 20 74 68 65 20 76 61 6c | 75 65 20 6f 66 20 74 68 | the val|ue of th|
|00005170| 65 20 63 75 72 73 6f 72 | 20 70 6f 69 6e 74 20 69 |e cursor| point i|
|00005180| 6e 20 74 68 65 20 62 75 | 66 66 65 72 2e 0a 58 40 |n the bu|ffer..X@|
|00005190| 69 74 65 6d 0a 58 6d 61 | 72 6b 20 2d 20 74 68 65 |item.Xma|rk - the|
|000051a0| 20 20 76 61 6c 75 65 20 | 6f 66 20 74 68 65 20 62 | value |of the b|
|000051b0| 75 66 66 65 72 27 73 20 | 6d 61 72 6b 2e 0a 58 40 |uffer's |mark..X@|
|000051c0| 69 74 65 6d 0a 58 63 6f | 6e 74 65 6e 74 73 20 2d |item.Xco|ntents -|
|000051d0| 20 74 68 65 20 63 6f 6e | 74 65 6e 74 73 20 6f 66 | the con|tents of|
|000051e0| 20 74 68 65 20 62 75 66 | 66 65 72 20 72 65 70 72 | the buf|fer repr|
|000051f0| 65 73 65 6e 74 65 64 20 | 61 73 20 61 20 74 65 78 |esented |as a tex|
|00005200| 74 20 73 74 72 69 6e 67 | 2e 0a 58 40 69 74 65 6d |t string|..X@item|
|00005210| 0a 58 6d 6f 64 69 66 69 | 65 64 20 2d 20 61 20 66 |.Xmodifi|ed - a f|
|00005220| 6c 61 67 20 69 6e 64 69 | 63 61 74 69 6e 67 20 69 |lag indi|cating i|
|00005230| 66 20 74 68 65 20 62 75 | 66 66 65 72 20 68 61 73 |f the bu|ffer has|
|00005240| 20 62 65 65 6e 20 6d 6f | 64 69 66 69 65 64 0a 58 | been mo|dified.X|
|00005250| 73 69 6e 63 65 20 6c 61 | 73 74 20 73 61 76 65 64 |since la|st saved|
|00005260| 2e 0a 58 40 69 74 65 6d | 0a 58 6c 6f 63 61 6c 20 |..X@item|.Xlocal |
|00005270| 6d 61 70 20 2d 20 74 68 | 65 20 6c 6f 63 61 6c 20 |map - th|e local |
|00005280| 6b 65 79 20 6d 61 70 20 | 66 6f 72 20 74 68 69 73 |key map |for this|
|00005290| 20 62 75 66 66 65 72 2e | 0a 58 40 69 74 65 6d 0a | buffer.|.X@item.|
|000052a0| 58 6c 6f 63 61 6c 20 62 | 6f 75 6e 64 20 73 79 6d |Xlocal b|ound sym|
|000052b0| 62 6f 6c 73 20 2d 20 73 | 79 6d 62 6f 6c 73 20 28 |bols - s|ymbols (|
|000052c0| 76 61 72 69 61 62 6c 65 | 73 29 20 74 68 61 74 20 |variable|s) that |
|000052d0| 61 72 65 20 6c 6f 63 61 | 6c 20 74 6f 20 74 68 69 |are loca|l to thi|
|000052e0| 73 0a 58 62 75 66 66 65 | 72 20 28 65 2e 67 2e 2c |s.Xbuffe|r (e.g.,|
|000052f0| 20 74 68 65 20 40 73 61 | 6d 70 7b 63 75 72 72 65 | the @sa|mp{curre|
|00005300| 6e 74 2d 6d 6f 64 65 7d | 20 6f 66 20 74 68 65 20 |nt-mode}| of the |
|00005310| 62 75 66 66 65 72 29 2e | 0a 58 40 65 6e 64 20 69 |buffer).|.X@end i|
|00005320| 74 65 6d 69 7a 65 0a 58 | 40 69 74 65 6d 0a 58 40 |temize.X|@item.X@|
|00005330| 63 6f 64 65 7b 57 69 6e | 64 6f 77 20 49 6e 66 6f |code{Win|dow Info|
|00005340| 72 6d 61 74 69 6f 6e 7d | 20 2d 20 41 74 20 61 6e |rmation}| - At an|
|00005350| 79 20 74 69 6d 65 20 61 | 6e 20 45 6d 61 63 73 20 |y time a|n Emacs |
|00005360| 73 65 73 73 69 6f 6e 20 | 68 61 73 0a 58 6f 6e 65 |session |has.Xone|
|00005370| 20 6f 72 20 6d 6f 72 65 | 20 77 69 6e 64 6f 77 73 | or more| windows|
|00005380| 20 76 69 73 69 62 6c 65 | 2e 20 20 54 68 65 20 63 | visible|. The c|
|00005390| 61 70 74 75 72 65 20 66 | 75 6e 63 74 69 6f 6e 73 |apture f|unctions|
|000053a0| 20 73 74 6f 72 65 20 74 | 68 65 20 66 6f 6c 6c 6f | store t|he follo|
|000053b0| 77 69 6e 67 0a 58 69 6e | 66 6f 72 6d 61 74 69 6f |wing.Xin|formatio|
|000053c0| 6e 20 66 6f 72 20 65 61 | 63 68 20 77 69 6e 64 6f |n for ea|ch windo|
|000053d0| 77 3a 0a 58 40 69 74 65 | 6d 69 7a 65 20 40 62 75 |w:.X@ite|mize @bu|
|000053e0| 6c 6c 65 74 0a 58 40 69 | 74 65 6d 0a 58 65 64 67 |llet.X@i|tem.Xedg|
|000053f0| 65 73 20 2d 20 74 68 65 | 20 75 70 70 65 72 20 6c |es - the| upper l|
|00005400| 65 66 74 20 61 6e 64 20 | 6c 6f 77 65 72 20 72 69 |eft and |lower ri|
|00005410| 67 68 74 20 63 6f 72 6e | 65 72 20 6f 66 20 74 68 |ght corn|er of th|
|00005420| 65 20 77 69 6e 64 6f 77 | 20 69 6e 0a 58 73 63 72 |e window| in.Xscr|
|00005430| 65 65 6e 20 63 6f 6f 72 | 64 69 6e 61 74 65 73 2e |een coor|dinates.|
|00005440| 0a 58 40 69 74 65 6d 0a | 58 62 75 66 66 65 72 20 |.X@item.|Xbuffer |
|00005450| 2d 20 74 68 65 20 62 75 | 66 66 65 72 20 6f 63 63 |- the bu|ffer occ|
|00005460| 75 70 79 69 6e 67 20 74 | 68 69 73 20 77 69 6e 64 |upying t|his wind|
|00005470| 6f 77 2e 0a 58 40 69 74 | 65 6d 0a 58 73 74 61 72 |ow..X@it|em.Xstar|
|00005480| 74 20 2d 20 74 68 65 20 | 69 6e 74 65 67 65 72 20 |t - the |integer |
|00005490| 70 6f 73 69 74 69 6f 6e | 20 69 6e 20 74 68 65 20 |position| in the |
|000054a0| 62 75 66 66 65 72 20 77 | 68 65 72 65 20 64 69 73 |buffer w|here dis|
|000054b0| 70 6c 61 79 20 73 74 61 | 72 74 73 0a 58 69 6e 20 |play sta|rts.Xin |
|000054c0| 74 68 65 20 72 65 73 70 | 65 63 74 69 76 65 20 77 |the resp|ective w|
|000054d0| 69 6e 64 6f 77 2e 0a 58 | 40 69 74 65 6d 0a 58 70 |indow..X|@item.Xp|
|000054e0| 6f 69 6e 74 20 2d 20 74 | 68 65 20 69 6e 74 65 67 |oint - t|he integ|
|000054f0| 65 72 20 70 6f 73 69 74 | 69 6f 6e 20 69 6e 20 74 |er posit|ion in t|
|00005500| 68 65 20 62 75 66 66 65 | 72 20 77 68 65 72 65 20 |he buffe|r where |
|00005510| 74 68 65 20 70 6f 69 6e | 74 20 66 6f 72 0a 58 74 |the poin|t for.Xt|
|00005520| 68 69 73 20 77 69 6e 64 | 6f 77 20 73 69 74 73 2e |his wind|ow sits.|
|00005530| 0a 58 40 69 74 65 6d 0a | 58 63 75 72 72 65 6e 74 |.X@item.|Xcurrent|
|00005540| 20 66 6c 61 67 20 2d 20 | 61 20 66 6c 61 67 20 74 | flag - |a flag t|
|00005550| 68 61 74 20 69 73 20 6e | 6f 6e 2d 6e 69 6c 20 69 |hat is n|on-nil i|
|00005560| 66 20 74 68 69 73 20 69 | 73 20 74 68 65 20 77 69 |f this i|s the wi|
|00005570| 6e 64 6f 77 20 69 6e 0a | 58 77 68 69 63 68 20 74 |ndow in.|Xwhich t|
|00005580| 68 65 20 73 63 72 65 65 | 6e 20 63 75 72 73 6f 72 |he scree|n cursor|
|00005590| 20 63 75 72 72 65 6e 74 | 6c 79 20 69 73 20 6c 6f | current|ly is lo|
|000055a0| 63 61 74 65 64 2e 0a 58 | 40 65 6e 64 20 69 74 65 |cated..X|@end ite|
|000055b0| 6d 69 7a 65 0a 58 40 69 | 74 65 6d 0a 58 40 63 6f |mize.X@i|tem.X@co|
|000055c0| 64 65 7b 50 72 6f 63 65 | 73 73 20 49 6e 66 6f 72 |de{Proce|ss Infor|
|000055d0| 6d 61 74 69 6f 6e 7d 20 | 2d 20 41 6e 20 45 6d 61 |mation} |- An Ema|
|000055e0| 63 73 20 73 65 73 73 69 | 6f 6e 20 6d 61 79 20 68 |cs sessi|on may h|
|000055f0| 61 76 65 20 69 6e 76 6f | 6b 65 64 0a 58 73 65 76 |ave invo|ked.Xsev|
|00005600| 65 72 61 6c 20 55 4e 49 | 58 20 70 72 6f 63 65 73 |eral UNI|X proces|
|00005610| 73 65 73 20 64 75 72 69 | 6e 67 20 69 74 73 20 6c |ses duri|ng its l|
|00005620| 69 66 65 74 69 6d 65 2e | 20 20 54 68 65 73 65 20 |ifetime.| These |
|00005630| 70 72 6f 63 65 73 73 65 | 73 20 6d 61 79 20 68 61 |processe|s may ha|
|00005640| 76 65 0a 58 63 6f 6d 70 | 6c 65 74 65 64 20 6f 72 |ve.Xcomp|leted or|
|00005650| 20 6d 61 79 20 73 74 69 | 6c 6c 20 62 65 20 72 75 | may sti|ll be ru|
|00005660| 6e 6e 69 6e 67 2e 20 20 | 54 77 6f 20 63 6f 6d 6d |nning. |Two comm|
|00005670| 6f 6e 20 70 72 6f 63 65 | 73 73 65 73 20 74 68 61 |on proce|sses tha|
|00005680| 74 20 72 75 6e 20 64 75 | 72 69 6e 67 20 61 6e 0a |t run du|ring an.|
|00005690| 58 45 6d 61 63 73 20 73 | 65 73 73 69 6f 6e 73 20 |XEmacs s|essions |
|000056a0| 61 72 65 20 74 68 65 20 | 40 73 61 6d 70 7b 73 68 |are the |@samp{sh|
|000056b0| 65 6c 6c 7d 20 61 6e 64 | 20 74 68 65 20 70 72 6f |ell} and| the pro|
|000056c0| 63 65 73 73 20 74 68 61 | 74 20 64 69 73 70 6c 61 |cess tha|t displa|
|000056d0| 79 73 20 74 68 65 20 74 | 69 6d 65 2c 0a 58 64 61 |ys the t|ime,.Xda|
|000056e0| 74 65 20 61 6e 64 20 73 | 79 73 74 65 6d 20 6c 6f |te and s|ystem lo|
|000056f0| 61 64 20 6f 6e 20 74 68 | 65 20 40 64 66 6e 7b 6d |ad on th|e @dfn{m|
|00005700| 6f 64 65 20 6c 69 6e 65 | 7d 2e 20 20 54 68 65 20 |ode line|}. The |
|00005710| 40 73 61 6d 70 7b 54 65 | 73 74 7d 20 63 61 70 74 |@samp{Te|st} capt|
|00005720| 75 72 65 0a 58 66 75 6e | 63 74 69 6f 6e 73 20 73 |ure.Xfun|ctions s|
|00005730| 74 6f 72 65 20 74 68 65 | 20 66 6f 6c 6c 6f 77 20 |tore the| follow |
|00005740| 69 6e 66 6f 72 6d 61 74 | 69 6f 6e 20 66 6f 72 20 |informat|ion for |
|00005750| 65 61 63 68 20 70 72 6f | 63 65 73 73 3a 0a 58 40 |each pro|cess:.X@|
|00005760| 69 74 65 6d 69 7a 65 20 | 40 62 75 6c 6c 65 74 0a |itemize |@bullet.|
|00005770| 58 40 69 74 65 6d 0a 58 | 62 75 66 66 65 72 20 2d |X@item.X|buffer -|
|00005780| 20 74 68 65 20 6e 61 6d | 65 20 6f 66 20 74 68 65 | the nam|e of the|
|00005790| 20 62 75 66 66 65 72 20 | 74 6f 20 77 68 69 63 68 | buffer |to which|
|000057a0| 20 74 68 65 20 70 72 6f | 63 65 73 73 20 69 73 20 | the pro|cess is |
|000057b0| 61 74 74 61 63 68 65 64 | 0a 58 28 6e 69 6c 20 69 |attached|.X(nil i|
|000057c0| 66 20 74 68 65 20 70 72 | 6f 63 65 73 73 20 69 73 |f the pr|ocess is|
|000057d0| 20 6e 6f 74 20 72 65 6c | 61 74 65 64 20 74 6f 20 | not rel|ated to |
|000057e0| 61 20 62 75 66 66 65 72 | 2c 20 65 2e 67 2e 2c 20 |a buffer|, e.g., |
|000057f0| 74 68 65 20 64 69 73 70 | 6c 61 79 20 74 69 6d 65 |the disp|lay time|
|00005800| 0a 58 70 72 6f 63 65 73 | 73 29 2e 20 0a 58 40 69 |.Xproces|s). .X@i|
|00005810| 74 65 6d 0a 58 70 72 6f | 63 65 73 73 20 6d 61 72 |tem.Xpro|cess mar|
|00005820| 6b 20 2d 20 74 68 65 20 | 6d 61 72 6b 65 72 20 66 |k - the |marker f|
|00005830| 6f 72 20 74 68 65 20 65 | 6e 64 20 6f 66 20 74 68 |or the e|nd of th|
|00005840| 65 20 6c 61 73 74 20 6f | 75 74 70 75 74 20 66 72 |e last o|utput fr|
|00005850| 6f 6d 0a 58 74 68 65 20 | 70 72 6f 63 65 73 73 2e |om.Xthe |process.|
|00005860| 0a 58 40 69 74 65 6d 0a | 58 63 6f 6d 6d 61 6e 64 |.X@item.|Xcommand|
|00005870| 20 2d 20 74 68 65 20 55 | 4e 49 58 20 63 6f 6d 6d | - the U|NIX comm|
|00005880| 61 6e 64 20 74 68 61 74 | 20 69 6e 76 6f 6b 65 64 |and that| invoked|
|00005890| 20 74 68 65 20 70 72 6f | 63 65 73 73 2e 0a 58 40 | the pro|cess..X@|
|000058a0| 69 74 65 6d 0a 58 65 78 | 69 74 20 73 74 61 74 75 |item.Xex|it statu|
|000058b0| 73 20 2d 20 69 66 20 74 | 68 65 20 70 72 6f 63 65 |s - if t|he proce|
|000058c0| 73 73 20 68 61 73 20 63 | 6f 6d 70 6c 65 74 65 64 |ss has c|ompleted|
|000058d0| 2c 20 74 68 65 20 55 4e | 49 58 20 72 65 74 75 72 |, the UN|IX retur|
|000058e0| 6e 20 63 6f 64 65 0a 58 | 66 72 6f 6d 20 74 68 61 |n code.X|from tha|
|000058f0| 74 20 70 72 6f 63 65 73 | 73 2e 0a 58 40 69 74 65 |t proces|s..X@ite|
|00005900| 6d 0a 58 66 69 6c 74 65 | 72 20 2d 20 74 68 65 20 |m.Xfilte|r - the |
|00005910| 6e 61 6d 65 20 6f 66 20 | 61 6e 20 45 6d 61 63 73 |name of |an Emacs|
|00005920| 20 6c 69 73 70 20 66 75 | 6e 63 74 69 6f 6e 20 74 | lisp fu|nction t|
|00005930| 68 61 74 20 72 65 63 65 | 69 76 65 73 20 61 6c 6c |hat rece|ives all|
|00005940| 0a 58 6f 75 74 70 75 74 | 20 6f 66 20 74 68 65 20 |.Xoutput| of the |
|00005950| 70 72 6f 63 65 73 73 2e | 0a 58 40 69 74 65 6d 0a |process.|.X@item.|
|00005960| 58 6e 61 6d 65 20 2d 20 | 61 20 75 6e 69 71 75 65 |Xname - |a unique|
|00005970| 20 6e 61 6d 65 20 6f 66 | 20 74 68 65 20 70 72 6f | name of| the pro|
|00005980| 67 72 61 6d 20 69 6e 76 | 6f 6b 65 64 20 69 6e 20 |gram inv|oked in |
|00005990| 74 68 65 20 70 72 6f 63 | 65 73 73 2e 0a 58 40 69 |the proc|ess..X@i|
|000059a0| 74 65 6d 0a 58 73 65 6e | 74 69 6e 65 6c 20 2d 20 |tem.Xsen|tinel - |
|000059b0| 74 68 65 20 6e 61 6d 65 | 20 6f 66 20 61 6e 20 45 |the name| of an E|
|000059c0| 6d 61 63 73 20 6c 69 73 | 70 20 66 75 6e 63 74 69 |macs lis|p functi|
|000059d0| 6f 6e 20 74 68 61 74 20 | 69 73 20 63 61 6c 6c 65 |on that |is calle|
|000059e0| 64 0a 58 77 68 65 6e 20 | 74 68 65 20 70 72 6f 63 |d.Xwhen |the proc|
|000059f0| 65 73 73 20 63 68 61 6e | 67 65 73 20 73 74 61 74 |ess chan|ges stat|
|00005a00| 65 20 28 65 2e 67 2e 20 | 63 6f 6d 70 6c 65 74 65 |e (e.g. |complete|
|00005a10| 73 29 2e 0a 58 40 69 74 | 65 6d 0a 58 73 74 61 74 |s)..X@it|em.Xstat|
|00005a20| 75 73 20 2d 20 69 6e 64 | 69 63 61 74 65 73 20 77 |us - ind|icates w|
|00005a30| 68 65 74 68 65 72 20 74 | 68 65 20 70 72 6f 63 65 |hether t|he proce|
|00005a40| 73 73 20 69 73 20 72 75 | 6e 6e 69 6e 67 2c 20 63 |ss is ru|nning, c|
|00005a50| 6f 6d 70 6c 65 74 65 2c | 0a 58 65 74 63 2e 0a 58 |omplete,|.Xetc..X|
|00005a60| 40 65 6e 64 20 69 74 65 | 6d 69 7a 65 0a 58 40 65 |@end ite|mize.X@e|
|00005a70| 6e 64 20 69 74 65 6d 69 | 7a 65 0a 58 0a 58 41 20 |nd itemi|ze.X.XA |
|00005a80| 73 69 67 6e 69 66 69 63 | 61 6e 74 20 69 74 65 6d |signific|ant item|
|00005a90| 20 74 68 61 74 20 69 73 | 20 65 78 63 6c 75 64 65 | that is| exclude|
|00005aa0| 64 20 66 72 6f 6d 20 74 | 68 69 73 20 73 74 61 74 |d from t|his stat|
|00005ab0| 65 20 69 6e 66 6f 72 6d | 61 74 69 6f 6e 20 69 73 |e inform|ation is|
|00005ac0| 20 74 68 65 0a 58 63 75 | 72 72 65 6e 74 20 64 65 | the.Xcu|rrent de|
|00005ad0| 66 69 6e 69 74 69 6f 6e | 20 6f 66 20 62 6f 75 6e |finition| of boun|
|00005ae0| 64 20 66 75 6e 63 74 69 | 6f 6e 73 2e 20 20 52 65 |d functi|ons. Re|
|00005af0| 63 61 6c 6c 20 74 68 61 | 74 20 61 6e 20 45 6d 61 |call tha|t an Ema|
|00005b00| 63 73 20 75 73 65 72 20 | 63 61 6e 0a 58 64 65 66 |cs user |can.Xdef|
|00005b10| 69 6e 65 20 61 6e 79 20 | 6e 65 77 20 66 75 6e 63 |ine any |new func|
|00005b20| 74 69 6f 6e 20 77 69 74 | 68 20 61 20 40 73 61 6d |tion wit|h a @sam|
|00005b30| 70 7b 64 65 66 75 6e 7d | 20 61 6e 64 20 6c 6f 61 |p{defun}| and loa|
|00005b40| 64 20 74 68 61 74 20 66 | 75 6e 63 74 69 6f 6e 2e |d that f|unction.|
|00005b50| 0a 58 46 75 72 74 68 65 | 72 6d 6f 72 65 2c 20 74 |.XFurthe|rmore, t|
|00005b60| 68 65 20 75 73 65 72 20 | 63 61 6e 20 72 65 64 65 |he user |can rede|
|00005b70| 66 69 6e 65 20 61 6e 79 | 20 65 78 69 73 74 69 6e |fine any| existin|
|00005b80| 67 20 66 75 6e 63 74 69 | 6f 6e 20 28 65 2e 67 2e |g functi|on (e.g.|
|00005b90| 0a 58 40 63 6f 64 65 7b | 66 6f 72 77 61 72 64 2d |.X@code{|forward-|
|00005ba0| 63 68 61 72 7d 20 21 29 | 20 69 6e 20 74 68 69 73 |char} !)| in this|
|00005bb0| 20 6d 61 6e 6e 65 72 2e | 20 20 53 61 76 69 6e 67 | manner.| Saving|
|00005bc0| 20 74 68 65 20 63 75 72 | 72 65 6e 74 20 64 65 66 | the cur|rent def|
|00005bd0| 69 6e 69 74 69 6f 6e 20 | 6f 66 0a 58 61 6c 6c 20 |inition |of.Xall |
|00005be0| 62 6f 75 6e 64 20 66 75 | 6e 63 74 69 6f 6e 73 20 |bound fu|nctions |
|00005bf0| 77 6f 75 6c 64 20 72 65 | 73 75 6c 74 20 69 6e 20 |would re|sult in |
|00005c00| 61 20 68 75 67 65 20 73 | 74 61 74 65 20 76 65 63 |a huge s|tate vec|
|00005c10| 74 6f 72 2c 20 61 6e 64 | 20 69 73 20 74 68 65 72 |tor, and| is ther|
|00005c20| 65 66 6f 72 65 0a 58 6e | 6f 74 20 64 6f 6e 65 2e |efore.Xn|ot done.|
|00005c30| 0a 58 0a 58 40 73 75 62 | 73 65 63 74 69 6f 6e 20 |.X.X@sub|section |
|00005c40| 43 61 70 74 75 72 69 6e | 67 20 61 6e 20 45 6d 61 |Capturin|g an Ema|
|00005c50| 63 73 20 53 65 73 73 69 | 6f 6e 20 53 74 61 74 65 |cs Sessi|on State|
|00005c60| 0a 58 57 68 65 6e 20 72 | 65 67 72 65 73 73 69 6f |.XWhen r|egressio|
|00005c70| 6e 20 74 65 73 74 69 6e | 67 20 61 6e 20 45 6d 61 |n testin|g an Ema|
|00005c80| 63 73 20 70 61 63 6b 61 | 67 65 2c 20 79 6f 75 20 |cs packa|ge, you |
|00005c90| 77 69 6c 6c 20 6d 61 69 | 6e 6c 79 20 75 73 65 20 |will mai|nly use |
|00005ca0| 74 68 65 20 73 74 61 74 | 65 0a 58 63 61 70 74 75 |the stat|e.Xcaptu|
|00005cb0| 72 65 20 66 75 6e 63 74 | 69 6f 6e 73 20 6f 66 20 |re funct|ions of |
|00005cc0| 54 65 73 74 20 69 6e 20 | 74 77 6f 20 77 61 79 73 |Test in |two ways|
|00005cd0| 3a 0a 58 40 65 6e 75 6d | 65 72 61 74 65 0a 58 40 |:.X@enum|erate.X@|
|00005ce0| 69 74 65 6d 0a 58 74 6f | 20 73 61 76 65 20 61 20 |item.Xto| save a |
|00005cf0| 6b 6e 6f 77 6e 20 40 64 | 66 6e 7b 69 6e 69 74 69 |known @d|fn{initi|
|00005d00| 61 6c 20 73 74 61 74 65 | 7d 20 74 6f 20 75 73 65 |al state|} to use|
|00005d10| 20 61 73 20 74 68 65 20 | 62 61 73 65 20 73 74 61 | as the |base sta|
|00005d20| 74 65 20 66 6f 72 0a 58 | 61 20 72 75 6e 20 6f 66 |te for.X|a run of|
|00005d30| 20 61 6e 20 45 6d 61 63 | 73 20 70 61 63 6b 61 67 | an Emac|s packag|
|00005d40| 65 2c 20 61 6e 64 0a 58 | 40 69 74 65 6d 0a 58 74 |e, and.X|@item.Xt|
|00005d50| 6f 20 73 61 76 65 20 61 | 20 40 64 66 6e 7b 66 69 |o save a| @dfn{fi|
|00005d60| 6e 61 6c 20 73 74 61 74 | 65 7d 20 74 6f 20 6c 61 |nal stat|e} to la|
|00005d70| 74 65 72 20 63 6f 6d 70 | 61 72 65 20 74 6f 20 74 |ter comp|are to t|
|00005d80| 68 65 20 73 74 61 74 65 | 20 6f 66 20 74 68 65 0a |he state| of the.|
|00005d90| 58 73 65 73 73 69 6f 6e | 20 61 66 74 65 72 20 74 |Xsession| after t|
|00005da0| 68 65 20 72 75 6e 20 6f | 66 20 61 20 6d 6f 64 69 |he run o|f a modi|
|00005db0| 66 69 65 64 20 70 61 63 | 6b 61 67 65 2e 0a 58 40 |fied pac|kage..X@|
|00005dc0| 65 6e 64 20 65 6e 75 6d | 65 72 61 74 65 0a 58 0a |end enum|erate.X.|
|00005dd0| 58 40 73 75 62 73 75 62 | 73 65 63 74 69 6f 6e 20 |X@subsub|section |
|00005de0| 43 6f 6d 6d 61 6e 64 73 | 20 66 6f 72 20 43 61 70 |Commands| for Cap|
|00005df0| 74 75 72 69 6e 67 20 53 | 74 61 74 65 0a 58 0a 58 |turing S|tate.X.X|
|00005e00| 40 74 61 62 6c 65 20 40 | 73 61 6d 70 0a 58 40 69 |@table @|samp.X@i|
|00005e10| 74 65 6d 20 74 73 74 2d | 63 61 70 74 75 72 65 2d |tem tst-|capture-|
|00005e20| 73 74 61 74 65 2d 74 6f | 2d 66 69 6c 65 0a 58 57 |state-to|-file.XW|
|00005e30| 72 69 74 65 73 20 74 68 | 65 20 63 75 72 72 65 6e |rites th|e curren|
|00005e40| 74 20 73 74 61 74 65 20 | 6f 66 20 74 68 65 20 45 |t state |of the E|
|00005e50| 6d 61 63 73 20 73 65 73 | 73 69 6f 6e 20 74 6f 20 |macs ses|sion to |
|00005e60| 61 20 66 69 6c 65 2e 20 | 20 59 6f 75 20 61 72 65 |a file. | You are|
|00005e70| 20 70 72 6f 6d 70 74 65 | 64 0a 58 66 6f 72 20 74 | prompte|d.Xfor t|
|00005e80| 68 65 20 6e 61 6d 65 20 | 6f 66 20 74 68 65 20 66 |he name |of the f|
|00005e90| 69 6c 65 2c 20 74 68 65 | 20 40 64 66 6e 7b 65 78 |ile, the| @dfn{ex|
|00005ea0| 63 6c 75 64 65 2d 76 61 | 72 69 61 62 6c 65 73 7d |clude-va|riables}|
|00005eb0| 20 61 6e 64 20 74 68 65 | 0a 58 40 64 66 6e 7b 62 | and the|.X@dfn{b|
|00005ec0| 75 66 66 65 72 2d 6c 69 | 73 74 7d 2e 20 20 52 65 |uffer-li|st}. Re|
|00005ed0| 66 65 72 20 74 6f 20 74 | 68 65 20 40 63 6f 64 65 |fer to t|he @code|
|00005ee0| 7b 55 73 61 67 65 20 4e | 6f 74 65 73 7d 20 62 65 |{Usage N|otes} be|
|00005ef0| 6c 6f 77 20 66 6f 72 20 | 64 65 74 61 69 6c 73 20 |low for |details |
|00005f00| 6f 6e 0a 58 74 68 65 73 | 65 20 6c 61 73 74 20 74 |on.Xthes|e last t|
|00005f10| 77 6f 20 69 74 65 6d 73 | 2e 20 20 49 66 20 74 68 |wo items|. If th|
|00005f20| 65 20 66 69 6c 65 20 79 | 6f 75 20 73 70 65 63 69 |e file y|ou speci|
|00005f30| 66 79 20 61 6c 72 65 61 | 64 79 20 65 78 69 73 74 |fy alrea|dy exist|
|00005f40| 73 20 69 74 20 69 73 0a | 58 6f 76 65 72 77 72 69 |s it is.|Xoverwri|
|00005f50| 74 74 65 6e 2e 0a 58 40 | 69 74 65 6d 20 74 73 74 |tten..X@|item tst|
|00005f60| 2d 77 72 69 74 65 2d 73 | 74 61 74 65 2d 74 6f 2d |-write-s|tate-to-|
|00005f70| 66 69 6c 65 0a 58 57 72 | 69 74 65 73 20 61 20 73 |file.XWr|ites a s|
|00005f80| 74 61 74 65 20 74 68 61 | 74 20 69 73 20 73 61 76 |tate tha|t is sav|
|00005f90| 65 64 20 69 6e 20 61 20 | 62 6f 75 6e 64 20 76 61 |ed in a |bound va|
|00005fa0| 72 69 61 62 6c 65 20 74 | 6f 20 61 20 66 69 6c 65 |riable t|o a file|
|00005fb0| 2e 20 20 59 6f 75 20 61 | 72 65 0a 58 70 72 6f 6d |. You a|re.Xprom|
|00005fc0| 70 74 65 64 20 66 6f 72 | 20 74 68 65 20 73 74 61 |pted for| the sta|
|00005fd0| 74 65 20 76 61 72 69 61 | 62 6c 65 20 6e 61 6d 65 |te varia|ble name|
|00005fe0| 20 28 77 68 69 63 68 20 | 77 61 73 20 63 72 65 61 | (which |was crea|
|00005ff0| 74 65 64 20 77 69 74 68 | 0a 58 40 73 61 6d 70 7b |ted with|.X@samp{|
|00006000| 74 73 74 2d 63 61 70 74 | 75 72 65 2d 73 74 61 74 |tst-capt|ure-stat|
|00006010| 65 7d 29 20 61 6e 64 20 | 74 68 65 20 6e 61 6d 65 |e}) and |the name|
|00006020| 20 6f 66 20 74 68 65 20 | 66 69 6c 65 2e 20 20 49 | of the |file. I|
|00006030| 66 20 74 68 65 20 66 69 | 6c 65 20 61 6c 72 65 61 |f the fi|le alrea|
|00006040| 64 79 0a 58 65 78 69 73 | 74 73 20 69 74 20 69 73 |dy.Xexis|ts it is|
|00006050| 20 6f 76 65 72 77 72 69 | 74 74 65 6e 2e 0a 58 40 | overwri|tten..X@|
|00006060| 69 74 65 6d 20 74 73 74 | 2d 63 61 70 74 75 72 65 |item tst|-capture|
|00006070| 2d 73 74 61 74 65 0a 58 | 53 61 76 65 73 20 74 68 |-state.X|Saves th|
|00006080| 65 20 73 74 61 74 65 20 | 6f 66 20 74 68 65 20 45 |e state |of the E|
|00006090| 6d 61 63 73 20 73 65 73 | 73 69 6f 6e 20 69 6e 20 |macs ses|sion in |
|000060a0| 61 20 73 74 61 74 65 20 | 76 61 72 69 61 62 6c 65 |a state |variable|
|000060b0| 2e 20 20 59 6f 75 20 61 | 72 65 20 70 72 6f 6d 70 |. You a|re promp|
|000060c0| 74 65 64 0a 58 66 6f 72 | 20 74 68 65 20 6e 61 6d |ted.Xfor| the nam|
|000060d0| 65 20 6f 66 20 74 68 65 | 20 66 69 6c 65 2c 20 74 |e of the| file, t|
|000060e0| 68 65 20 40 64 66 6e 7b | 65 78 63 6c 75 64 65 2d |he @dfn{|exclude-|
|000060f0| 76 61 72 69 61 62 6c 65 | 73 7d 20 61 6e 64 20 74 |variable|s} and t|
|00006100| 68 65 0a 58 40 64 66 6e | 7b 62 75 66 66 65 72 2d |he.X@dfn|{buffer-|
|00006110| 6c 69 73 74 7d 2e 20 20 | 52 65 66 65 72 20 74 6f |list}. |Refer to|
|00006120| 20 74 68 65 20 40 63 6f | 64 65 7b 55 73 61 67 65 | the @co|de{Usage|
|00006130| 20 4e 6f 74 65 73 7d 20 | 62 65 6c 6f 77 20 66 6f | Notes} |below fo|
|00006140| 72 20 6d 6f 72 65 20 64 | 65 74 61 69 6c 73 0a 58 |r more d|etails.X|
|00006150| 6f 6e 20 74 68 65 73 65 | 20 6c 61 73 74 20 74 77 |on these| last tw|
|00006160| 6f 20 69 74 65 6d 73 2e | 20 20 49 66 20 74 68 65 |o items.| If the|
|00006170| 20 62 6f 75 6e 64 20 76 | 61 72 69 61 62 6c 65 20 | bound v|ariable |
|00006180| 79 6f 75 20 73 70 65 63 | 69 66 79 20 61 6c 72 65 |you spec|ify alre|
|00006190| 61 64 79 20 65 78 69 73 | 74 73 2c 0a 58 69 74 20 |ady exis|ts,.Xit |
|000061a0| 69 73 20 6f 76 65 72 77 | 72 69 74 74 65 6e 2e 0a |is overw|ritten..|
|000061b0| 58 40 65 6e 64 20 74 61 | 62 6c 65 0a 58 0a 58 40 |X@end ta|ble.X.X@|
|000061c0| 73 75 62 73 75 62 73 65 | 63 74 69 6f 6e 20 55 73 |subsubse|ction Us|
|000061d0| 61 67 65 20 4e 6f 74 65 | 73 0a 58 0a 58 54 68 65 |age Note|s.X.XThe|
|000061e0| 20 61 6d 6f 75 6e 74 20 | 6f 66 20 69 6e 66 6f 72 | amount |of infor|
|000061f0| 6d 61 74 69 6f 6e 20 73 | 61 76 65 64 20 62 79 20 |mation s|aved by |
|00006200| 40 73 61 6d 70 7b 74 73 | 74 2d 63 61 70 74 75 72 |@samp{ts|t-captur|
|00006210| 65 2d 73 74 61 74 65 2d | 74 6f 2d 66 69 6c 65 7d |e-state-|to-file}|
|00006220| 20 61 6e 64 0a 58 40 73 | 61 6d 70 7b 74 73 74 2d | and.X@s|amp{tst-|
|00006230| 63 61 70 74 75 72 65 2d | 73 74 61 74 65 7d 20 69 |capture-|state} i|
|00006240| 73 20 63 6f 6e 74 72 6f | 6c 6c 65 64 20 62 79 20 |s contro|lled by |
|00006250| 79 6f 75 72 20 72 65 73 | 70 6f 6e 73 65 73 20 74 |your res|ponses t|
|00006260| 6f 20 74 68 65 20 63 6f | 6d 6d 61 6e 64 0a 58 70 |o the co|mmand.Xp|
|00006270| 72 6f 6d 70 74 73 2e 20 | 20 54 68 65 73 65 20 61 |rompts. | These a|
|00006280| 72 65 3a 0a 58 40 74 61 | 62 6c 65 20 40 73 61 6d |re:.X@ta|ble @sam|
|00006290| 70 0a 58 40 69 74 65 6d | 20 4c 69 73 74 20 6f 66 |p.X@item| List of|
|000062a0| 20 62 75 66 66 65 72 73 | 20 74 6f 20 63 61 70 74 | buffers| to capt|
|000062b0| 75 72 65 3a 0a 58 54 68 | 65 72 65 20 61 72 65 20 |ure:.XTh|ere are |
|000062c0| 74 68 72 65 65 20 70 6f | 73 73 69 62 6c 65 20 72 |three po|ssible r|
|000062d0| 65 73 70 6f 6e 73 65 73 | 20 74 6f 20 74 68 69 73 |esponses| to this|
|000062e0| 20 70 72 6f 6d 70 74 3a | 0a 58 40 65 6e 75 6d 65 | prompt:|.X@enume|
|000062f0| 72 61 74 65 0a 58 40 69 | 74 65 6d 20 0a 58 40 73 |rate.X@i|tem .X@s|
|00006300| 61 6d 70 7b 6e 69 6c 7d | 20 74 6f 20 69 6e 64 69 |amp{nil}| to indi|
|00006310| 63 61 74 65 20 74 68 61 | 74 20 73 74 61 74 65 20 |cate tha|t state |
|00006320| 69 6e 66 6f 72 6d 61 74 | 69 6f 6e 20 6f 6e 20 61 |informat|ion on a|
|00006330| 6c 6c 20 62 75 66 66 65 | 72 73 20 73 68 6f 75 6c |ll buffe|rs shoul|
|00006340| 64 20 62 65 0a 58 73 61 | 76 65 64 20 28 74 68 65 |d be.Xsa|ved (the|
|00006350| 20 64 65 66 61 75 6c 74 | 29 2e 0a 58 40 69 74 65 | default|)..X@ite|
|00006360| 6d 0a 58 41 20 6c 69 73 | 74 20 6f 66 20 6f 66 20 |m.XA lis|t of of |
|00006370| 62 75 66 66 65 72 20 6e | 61 6d 65 73 20 69 6e 64 |buffer n|ames ind|
|00006380| 69 63 61 74 69 6e 67 20 | 66 6f 72 20 77 68 69 63 |icating |for whic|
|00006390| 68 20 62 75 66 66 65 72 | 73 20 73 74 61 74 65 20 |h buffer|s state |
|000063a0| 69 6e 66 6f 72 6d 61 74 | 69 6f 6e 0a 58 73 68 6f |informat|ion.Xsho|
|000063b0| 75 6c 64 20 62 65 20 73 | 61 76 65 64 2e 20 20 46 |uld be s|aved. F|
|000063c0| 6f 72 20 65 78 61 6d 70 | 6c 65 2c 20 74 6f 20 73 |or examp|le, to s|
|000063d0| 61 76 65 20 6f 6e 6c 79 | 20 74 68 65 20 73 74 61 |ave only| the sta|
|000063e0| 74 65 73 20 6f 66 20 62 | 75 66 66 65 72 73 0a 58 |tes of b|uffers.X|
|000063f0| 40 73 61 6d 70 7b 62 61 | 72 7d 20 61 6e 64 20 40 |@samp{ba|r} and @|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.
