/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume24 / rcs / part02

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 53 75 62 6a 65 63 74 3a | 20 20 76 32 34 69 30 30 |Subject:|  v24i00|
|00000010| 32 3a 20 20 52 43 53 20 | 73 6f 75 72 63 65 20 63 |2:  RCS |source c|
|00000020| 6f 6e 74 72 6f 6c 20 73 | 79 73 74 65 6d 2c 20 50 |ontrol s|ystem, P|
|00000030| 61 72 74 30 32 2f 31 32 | 0a 4e 65 77 73 67 72 6f |art02/12|.Newsgro|
|00000040| 75 70 73 3a 20 63 6f 6d | 70 2e 73 6f 75 72 63 65 |ups: com|p.source|
|00000050| 73 2e 75 6e 69 78 0a 41 | 70 70 72 6f 76 65 64 3a |s.unix.A|pproved:|
|00000060| 20 72 73 61 6c 7a 40 75 | 75 6e 65 74 2e 55 55 2e | rsalz@u|unet.UU.|
|00000070| 4e 45 54 0a 58 2d 43 68 | 65 63 6b 73 75 6d 2d 53 |NET.X-Ch|ecksum-S|
|00000080| 6e 65 66 72 75 3a 20 36 | 36 65 38 35 34 33 63 20 |nefru: 6|6e8543c |
|00000090| 65 63 33 65 39 38 64 66 | 20 36 37 38 66 62 64 36 |ec3e98df| 678fbd6|
|000000a0| 65 20 62 63 34 39 31 39 | 35 30 0a 0a 53 75 62 6d |e bc4919|50..Subm|
|000000b0| 69 74 74 65 64 2d 62 79 | 3a 20 41 64 61 6d 20 48 |itted-by|: Adam H|
|000000c0| 61 6d 6d 65 72 20 3c 68 | 61 6d 6d 65 72 40 63 73 |ammer <h|ammer@cs|
|000000d0| 2e 70 75 72 64 75 65 2e | 65 64 75 3e 0a 50 6f 73 |.purdue.|edu>.Pos|
|000000e0| 74 69 6e 67 2d 6e 75 6d | 62 65 72 3a 20 56 6f 6c |ting-num|ber: Vol|
|000000f0| 75 6d 65 20 32 34 2c 20 | 49 73 73 75 65 20 32 0a |ume 24, |Issue 2.|
|00000100| 41 72 63 68 69 76 65 2d | 6e 61 6d 65 3a 20 72 63 |Archive-|name: rc|
|00000110| 73 2f 70 61 72 74 30 32 | 0a 0a 23 21 20 2f 62 69 |s/part02|..#! /bi|
|00000120| 6e 2f 73 68 0a 23 20 54 | 68 69 73 20 69 73 20 61 |n/sh.# T|his is a|
|00000130| 20 73 68 65 6c 6c 20 61 | 72 63 68 69 76 65 2e 20 | shell a|rchive. |
|00000140| 20 52 65 6d 6f 76 65 20 | 61 6e 79 74 68 69 6e 67 | Remove |anything|
|00000150| 20 62 65 66 6f 72 65 20 | 74 68 69 73 20 6c 69 6e | before |this lin|
|00000160| 65 2c 20 74 68 65 6e 20 | 66 65 65 64 20 69 74 0a |e, then |feed it.|
|00000170| 23 20 69 6e 74 6f 20 61 | 20 73 68 65 6c 6c 20 76 |# into a| shell v|
|00000180| 69 61 20 22 73 68 20 66 | 69 6c 65 22 20 6f 72 20 |ia "sh f|ile" or |
|00000190| 73 69 6d 69 6c 61 72 2e | 20 20 54 6f 20 6f 76 65 |similar.|  To ove|
|000001a0| 72 77 72 69 74 65 20 65 | 78 69 73 74 69 6e 67 20 |rwrite e|xisting |
|000001b0| 66 69 6c 65 73 2c 0a 23 | 20 74 79 70 65 20 22 73 |files,.#| type "s|
|000001c0| 68 20 66 69 6c 65 20 2d | 63 22 2e 0a 23 20 54 68 |h file -|c"..# Th|
|000001d0| 65 20 74 6f 6f 6c 20 74 | 68 61 74 20 67 65 6e 65 |e tool t|hat gene|
|000001e0| 72 61 74 65 64 20 74 68 | 69 73 20 61 70 70 65 61 |rated th|is appea|
|000001f0| 72 65 64 20 69 6e 20 74 | 68 65 20 63 6f 6d 70 2e |red in t|he comp.|
|00000200| 73 6f 75 72 63 65 73 2e | 75 6e 69 78 20 6e 65 77 |sources.|unix new|
|00000210| 73 67 72 6f 75 70 3b 0a | 23 20 73 65 6e 64 20 6d |sgroup;.|# send m|
|00000220| 61 69 6c 20 74 6f 20 63 | 6f 6d 70 2d 73 6f 75 72 |ail to c|omp-sour|
|00000230| 63 65 73 2d 75 6e 69 78 | 40 75 75 6e 65 74 2e 75 |ces-unix|@uunet.u|
|00000240| 75 2e 6e 65 74 20 69 66 | 20 79 6f 75 20 77 61 6e |u.net if| you wan|
|00000250| 74 20 74 68 61 74 20 74 | 6f 6f 6c 2e 0a 23 20 43 |t that t|ool..# C|
|00000260| 6f 6e 74 65 6e 74 73 3a | 20 20 72 63 73 2e 6d 73 |ontents:|  rcs.ms|
|00000270| 2e 30 31 20 73 72 63 2f | 72 63 73 6b 65 79 73 2e |.01 src/|rcskeys.|
|00000280| 63 0a 23 20 57 72 61 70 | 70 65 64 20 62 79 20 72 |c.# Wrap|ped by r|
|00000290| 73 61 6c 7a 40 6c 69 74 | 63 68 69 2e 62 62 6e 2e |salz@lit|chi.bbn.|
|000002a0| 63 6f 6d 20 6f 6e 20 54 | 68 75 20 46 65 62 20 32 |com on T|hu Feb 2|
|000002b0| 31 20 31 34 3a 33 36 3a | 35 34 20 31 39 39 31 0a |1 14:36:|54 1991.|
|000002c0| 50 41 54 48 3d 2f 62 69 | 6e 3a 2f 75 73 72 2f 62 |PATH=/bi|n:/usr/b|
|000002d0| 69 6e 3a 2f 75 73 72 2f | 75 63 62 20 3b 20 65 78 |in:/usr/|ucb ; ex|
|000002e0| 70 6f 72 74 20 50 41 54 | 48 0a 65 63 68 6f 20 49 |port PAT|H.echo I|
|000002f0| 66 20 74 68 69 73 20 61 | 72 63 68 69 76 65 20 69 |f this a|rchive i|
|00000300| 73 20 63 6f 6d 70 6c 65 | 74 65 2c 20 79 6f 75 20 |s comple|te, you |
|00000310| 77 69 6c 6c 20 73 65 65 | 20 74 68 65 20 66 6f 6c |will see| the fol|
|00000320| 6c 6f 77 69 6e 67 20 6d | 65 73 73 61 67 65 3a 0a |lowing m|essage:.|
|00000330| 65 63 68 6f 20 27 20 20 | 20 20 20 20 20 20 20 20 |echo '  |        |
|00000340| 22 73 68 61 72 3a 20 45 | 6e 64 20 6f 66 20 61 72 |"shar: E|nd of ar|
|00000350| 63 68 69 76 65 20 32 20 | 28 6f 66 20 31 32 29 2e |chive 2 |(of 12).|
|00000360| 22 27 0a 69 66 20 74 65 | 73 74 20 2d 66 20 27 72 |"'.if te|st -f 'r|
|00000370| 63 73 2e 6d 73 2e 30 31 | 27 20 2d 61 20 22 24 7b |cs.ms.01|' -a "${|
|00000380| 31 7d 22 20 21 3d 20 22 | 2d 63 22 20 3b 20 74 68 |1}" != "|-c" ; th|
|00000390| 65 6e 20 0a 20 20 65 63 | 68 6f 20 73 68 61 72 3a |en .  ec|ho shar:|
|000003a0| 20 57 69 6c 6c 20 6e 6f | 74 20 63 6c 6f 62 62 65 | Will no|t clobbe|
|000003b0| 72 20 65 78 69 73 74 69 | 6e 67 20 66 69 6c 65 20 |r existi|ng file |
|000003c0| 5c 22 27 72 63 73 2e 6d | 73 2e 30 31 27 5c 22 0a |\"'rcs.m|s.01'\".|
|000003d0| 65 6c 73 65 0a 20 20 65 | 63 68 6f 20 73 68 61 72 |else.  e|cho shar|
|000003e0| 3a 20 45 78 74 72 61 63 | 74 69 6e 67 20 5c 22 27 |: Extrac|ting \"'|
|000003f0| 72 63 73 2e 6d 73 2e 30 | 31 27 5c 22 20 5c 28 34 |rcs.ms.0|1'\" \(4|
|00000400| 39 38 30 33 20 63 68 61 | 72 61 63 74 65 72 73 5c |9803 cha|racters\|
|00000410| 29 0a 20 20 73 65 64 20 | 22 73 2f 5e 58 2f 2f 22 |).  sed |"s/^X//"|
|00000420| 20 3e 27 72 63 73 2e 6d | 73 2e 30 31 27 20 3c 3c | >'rcs.m|s.01' <<|
|00000430| 27 45 4e 44 5f 4f 46 5f | 46 49 4c 45 27 0a 58 2e |'END_OF_|FILE'.X.|
|00000440| 5c 22 20 46 6f 72 6d 61 | 74 20 74 68 69 73 20 66 |\" Forma|t this f|
|00000450| 69 6c 65 20 77 69 74 68 | 3a 0a 58 2e 5c 22 20 70 |ile with|:.X.\" p|
|00000460| 69 63 20 66 69 6c 65 20 | 7c 20 74 62 6c 20 7c 20 |ic file || tbl | |
|00000470| 74 72 6f 66 66 20 2d 6d | 73 0a 58 2e 5c 22 0a 58 |troff -m|s.X.\".X|
|00000480| 2e 5c 22 20 5c 2a 73 20 | 73 74 61 6e 64 73 20 66 |.\" \*s |stands f|
|00000490| 6f 72 20 24 2c 20 61 6e | 64 20 61 76 6f 69 64 73 |or $, an|d avoids|
|000004a0| 20 70 72 6f 62 6c 65 6d | 73 20 77 68 65 6e 20 74 | problem|s when t|
|000004b0| 68 69 73 20 66 69 6c 65 | 20 69 73 20 63 68 65 63 |his file| is chec|
|000004c0| 6b 65 64 20 69 6e 2e 0a | 58 2e 64 73 20 73 20 24 |ked in..|X.ds s $|
|000004d0| 0a 58 2e 5c 22 20 50 53 | 20 61 6e 64 20 50 45 20 |.X.\" PS| and PE |
|000004e0| 63 65 6e 74 65 72 20 70 | 69 63 20 64 69 61 67 72 |center p|ic diagr|
|000004f0| 61 6d 73 2e 20 28 54 68 | 65 20 63 6f 72 72 65 73 |ams. (Th|e corres|
|00000500| 70 6f 6e 64 69 6e 67 20 | 6d 73 2d 6d 61 63 72 6f |ponding |ms-macro|
|00000510| 73 20 6d 61 79 20 6e 6f | 74 2e 29 0a 58 2e 64 65 |s may no|t.).X.de|
|00000520| 20 50 53 0a 58 2e 6e 72 | 20 70 45 20 28 5c 5c 6e | PS.X.nr| pE (\\n|
|00000530| 28 2e 6c 75 2d 5c 5c 24 | 32 75 29 2f 32 75 0a 58 |(.lu-\\$|2u)/2u.X|
|00000540| 2e 69 6e 20 2b 5c 5c 6e | 28 70 45 75 0a 58 2e 6e |.in +\\n|(pEu.X.n|
|00000550| 65 20 5c 5c 24 31 75 0a | 58 2e 2e 0a 58 2e 64 65 |e \\$1u.|X...X.de|
|00000560| 20 50 45 0a 58 2e 69 6e | 20 2d 5c 5c 6e 28 70 45 | PE.X.in| -\\n(pE|
|00000570| 75 0a 58 2e 2e 0a 58 2e | 64 65 20 44 28 0a 58 2e |u.X...X.|de D(.X.|
|00000580| 44 53 0a 58 2e 6e 72 20 | 56 53 20 31 32 70 0a 58 |DS.X.nr |VS 12p.X|
|00000590| 2e 76 73 20 31 32 70 0a | 58 2e 49 0a 58 2e 2e 0a |.vs 12p.|X.I.X...|
|000005a0| 58 2e 64 65 20 44 29 0a | 58 2e 44 45 0a 58 2e 6e |X.de D).|X.DE.X.n|
|000005b0| 72 20 56 53 20 31 38 70 | 0a 58 2e 76 73 20 31 38 |r VS 18p|.X.vs 18|
|000005c0| 70 0a 58 2e 52 0a 58 2e | 2e 0a 58 2e 64 65 20 49 |p.X.R.X.|..X.de I|
|000005d0| 64 0a 58 2e 4e 44 20 5c | 5c 24 34 0a 58 2e 2e 0a |d.X.ND \|\$4.X...|
|000005e0| 58 2e 49 64 20 24 49 64 | 3a 20 72 63 73 2e 6d 73 |X.Id $Id|: rcs.ms|
|000005f0| 2c 76 20 35 2e 32 20 31 | 39 39 31 2f 30 31 2f 30 |,v 5.2 1|991/01/0|
|00000600| 33 20 31 30 3a 35 37 3a | 32 38 20 65 67 67 65 72 |3 10:57:|28 egger|
|00000610| 74 20 45 78 70 20 24 0a | 58 2e 52 50 0a 58 2e 54 |t Exp $.|X.RP.X.T|
|00000620| 4c 0a 58 52 43 53 5c 2a | 2d 41 20 53 79 73 74 65 |L.XRCS\*|-A Syste|
|00000630| 6d 20 66 6f 72 20 56 65 | 72 73 69 6f 6e 20 43 6f |m for Ve|rsion Co|
|00000640| 6e 74 72 6f 6c 0a 58 2e | 73 70 0a 58 2e 41 55 0a |ntrol.X.|sp.X.AU.|
|00000650| 58 57 61 6c 74 65 72 20 | 46 2e 20 54 69 63 68 79 |XWalter |F. Tichy|
|00000660| 0a 58 2e 41 49 0a 58 44 | 65 70 61 72 74 6d 65 6e |.X.AI.XD|epartmen|
|00000670| 74 20 6f 66 20 43 6f 6d | 70 75 74 65 72 20 53 63 |t of Com|puter Sc|
|00000680| 69 65 6e 63 65 73 0a 58 | 50 75 72 64 75 65 20 55 |iences.X|Purdue U|
|00000690| 6e 69 76 65 72 73 69 74 | 79 0a 58 57 65 73 74 20 |niversit|y.XWest |
|000006a0| 4c 61 66 61 79 65 74 74 | 65 2c 20 49 6e 64 69 61 |Lafayett|e, India|
|000006b0| 6e 61 20 34 37 39 30 37 | 0a 58 2e 73 70 0a 58 2e |na 47907|.X.sp.X.|
|000006c0| 41 42 0a 58 41 6e 20 69 | 6d 70 6f 72 74 61 6e 74 |AB.XAn i|mportant|
|000006d0| 20 70 72 6f 62 6c 65 6d | 20 69 6e 20 70 72 6f 67 | problem| in prog|
|000006e0| 72 61 6d 20 64 65 76 65 | 6c 6f 70 6d 65 6e 74 20 |ram deve|lopment |
|000006f0| 61 6e 64 20 6d 61 69 6e | 74 65 6e 61 6e 63 65 20 |and main|tenance |
|00000700| 69 73 20 76 65 72 73 69 | 6f 6e 20 63 6f 6e 74 72 |is versi|on contr|
|00000710| 6f 6c 2c 0a 58 69 2e 65 | 2e 2c 20 74 68 65 20 74 |ol,.Xi.e|., the t|
|00000720| 61 73 6b 20 6f 66 20 6b | 65 65 70 69 6e 67 20 61 |ask of k|eeping a|
|00000730| 20 73 6f 66 74 77 61 72 | 65 20 73 79 73 74 65 6d | softwar|e system|
|00000740| 20 63 6f 6e 73 69 73 74 | 69 6e 67 20 6f 66 20 6d | consist|ing of m|
|00000750| 61 6e 79 20 76 65 72 73 | 69 6f 6e 73 20 61 6e 64 |any vers|ions and|
|00000760| 0a 58 63 6f 6e 66 69 67 | 75 72 61 74 69 6f 6e 73 |.Xconfig|urations|
|00000770| 20 77 65 6c 6c 20 6f 72 | 67 61 6e 69 7a 65 64 2e | well or|ganized.|
|00000780| 0a 58 54 68 65 20 52 65 | 76 69 73 69 6f 6e 20 43 |.XThe Re|vision C|
|00000790| 6f 6e 74 72 6f 6c 20 53 | 79 73 74 65 6d 20 28 52 |ontrol S|ystem (R|
|000007a0| 43 53 29 0a 58 69 73 20 | 61 20 73 6f 66 74 77 61 |CS).Xis |a softwa|
|000007b0| 72 65 20 74 6f 6f 6c 20 | 74 68 61 74 20 61 73 73 |re tool |that ass|
|000007c0| 69 73 74 73 20 77 69 74 | 68 20 74 68 61 74 20 74 |ists wit|h that t|
|000007d0| 61 73 6b 2e 0a 58 52 43 | 53 20 6d 61 6e 61 67 65 |ask..XRC|S manage|
|000007e0| 73 20 72 65 76 69 73 69 | 6f 6e 73 20 6f 66 20 74 |s revisi|ons of t|
|000007f0| 65 78 74 20 64 6f 63 75 | 6d 65 6e 74 73 2c 20 69 |ext docu|ments, i|
|00000800| 6e 20 70 61 72 74 69 63 | 75 6c 61 72 20 73 6f 75 |n partic|ular sou|
|00000810| 72 63 65 20 70 72 6f 67 | 72 61 6d 73 2c 0a 58 64 |rce prog|rams,.Xd|
|00000820| 6f 63 75 6d 65 6e 74 61 | 74 69 6f 6e 2c 20 61 6e |ocumenta|tion, an|
|00000830| 64 20 74 65 73 74 20 64 | 61 74 61 2e 0a 58 49 74 |d test d|ata..XIt|
|00000840| 20 61 75 74 6f 6d 61 74 | 65 73 20 74 68 65 20 73 | automat|es the s|
|00000850| 74 6f 72 69 6e 67 2c 20 | 72 65 74 72 69 65 76 61 |toring, |retrieva|
|00000860| 6c 2c 20 6c 6f 67 67 69 | 6e 67 20 61 6e 64 20 69 |l, loggi|ng and i|
|00000870| 64 65 6e 74 69 66 69 63 | 61 74 69 6f 6e 20 6f 66 |dentific|ation of|
|00000880| 20 72 65 76 69 73 69 6f | 6e 73 2c 0a 58 61 6e 64 | revisio|ns,.Xand|
|00000890| 20 69 74 20 70 72 6f 76 | 69 64 65 73 20 73 65 6c | it prov|ides sel|
|000008a0| 65 63 74 69 6f 6e 20 6d | 65 63 68 61 6e 69 73 6d |ection m|echanism|
|000008b0| 73 20 66 6f 72 20 63 6f | 6d 70 6f 73 69 6e 67 20 |s for co|mposing |
|000008c0| 63 6f 6e 66 69 67 75 72 | 61 74 69 6f 6e 73 2e 0a |configur|ations..|
|000008d0| 58 54 68 69 73 20 70 61 | 70 65 72 20 69 6e 74 72 |XThis pa|per intr|
|000008e0| 6f 64 75 63 65 73 20 62 | 61 73 69 63 20 76 65 72 |oduces b|asic ver|
|000008f0| 73 69 6f 6e 20 63 6f 6e | 74 72 6f 6c 20 63 6f 6e |sion con|trol con|
|00000900| 63 65 70 74 73 20 61 6e | 64 0a 58 64 69 73 63 75 |cepts an|d.Xdiscu|
|00000910| 73 73 65 73 20 74 68 65 | 20 70 72 61 63 74 69 63 |sses the| practic|
|00000920| 65 20 6f 66 20 76 65 72 | 73 69 6f 6e 20 63 6f 6e |e of ver|sion con|
|00000930| 74 72 6f 6c 0a 58 75 73 | 69 6e 67 20 52 43 53 2e |trol.Xus|ing RCS.|
|00000940| 0a 58 46 6f 72 20 63 6f | 6e 73 65 72 76 69 6e 67 |.XFor co|nserving|
|00000950| 20 73 70 61 63 65 2c 20 | 52 43 53 20 73 74 6f 72 | space, |RCS stor|
|00000960| 65 73 20 64 65 6c 74 61 | 73 2c 20 69 2e 65 2e 2c |es delta|s, i.e.,|
|00000970| 20 64 69 66 66 65 72 65 | 6e 63 65 73 20 62 65 74 | differe|nces bet|
|00000980| 77 65 65 6e 0a 58 73 75 | 63 63 65 73 73 69 76 65 |ween.Xsu|ccessive|
|00000990| 20 72 65 76 69 73 69 6f | 6e 73 2e 20 20 53 65 76 | revisio|ns.  Sev|
|000009a0| 65 72 61 6c 20 64 65 6c | 74 61 20 73 74 6f 72 61 |eral del|ta stora|
|000009b0| 67 65 20 6d 65 74 68 6f | 64 73 20 61 72 65 20 64 |ge metho|ds are d|
|000009c0| 69 73 63 75 73 73 65 64 | 2e 0a 58 55 73 61 67 65 |iscussed|..XUsage|
|000009d0| 20 73 74 61 74 69 73 74 | 69 63 73 20 73 68 6f 77 | statist|ics show|
|000009e0| 20 74 68 61 74 20 52 43 | 53 27 73 20 64 65 6c 74 | that RC|S's delt|
|000009f0| 61 20 73 74 6f 72 61 67 | 65 20 6d 65 74 68 6f 64 |a storag|e method|
|00000a00| 20 69 73 0a 58 73 70 61 | 63 65 20 61 6e 64 20 74 | is.Xspa|ce and t|
|00000a10| 69 6d 65 20 65 66 66 69 | 63 69 65 6e 74 2e 0a 58 |ime effi|cient..X|
|00000a20| 54 68 65 20 70 61 70 65 | 72 20 63 6f 6e 63 6c 75 |The pape|r conclu|
|00000a30| 64 65 73 20 77 69 74 68 | 20 61 20 64 65 74 61 69 |des with| a detai|
|00000a40| 6c 65 64 20 73 75 72 76 | 65 79 20 6f 66 20 76 65 |led surv|ey of ve|
|00000a50| 72 73 69 6f 6e 20 63 6f | 6e 74 72 6f 6c 20 74 6f |rsion co|ntrol to|
|00000a60| 6f 6c 73 2e 0a 58 2e 73 | 70 0a 58 5c 66 42 4b 65 |ols..X.s|p.X\fBKe|
|00000a70| 79 77 6f 72 64 73 5c 66 | 52 3a 20 63 6f 6e 66 69 |ywords\f|R: confi|
|00000a80| 67 75 72 61 74 69 6f 6e | 20 6d 61 6e 61 67 65 6d |guration| managem|
|00000a90| 65 6e 74 2c 20 68 69 73 | 74 6f 72 79 20 6d 61 6e |ent, his|tory man|
|00000aa0| 61 67 65 6d 65 6e 74 2c | 0a 58 76 65 72 73 69 6f |agement,|.Xversio|
|00000ab0| 6e 20 63 6f 6e 74 72 6f | 6c 2c 20 72 65 76 69 73 |n contro|l, revis|
|00000ac0| 69 6f 6e 73 2c 20 64 65 | 6c 74 61 73 2e 0a 58 2e |ions, de|ltas..X.|
|00000ad0| 41 45 0a 58 2e 46 53 0a | 58 41 6e 20 65 61 72 6c |AE.X.FS.|XAn earl|
|00000ae0| 69 65 72 20 76 65 72 73 | 69 6f 6e 20 6f 66 20 74 |ier vers|ion of t|
|00000af0| 68 69 73 20 70 61 70 65 | 72 20 77 61 73 20 70 75 |his pape|r was pu|
|00000b00| 62 6c 69 73 68 65 64 20 | 69 6e 0a 58 2e 49 20 22 |blished |in.X.I "|
|00000b10| 53 6f 66 74 77 61 72 65 | 5c 2a 2d 50 72 61 63 74 |Software|\*-Pract|
|00000b20| 69 63 65 20 26 20 45 78 | 70 65 72 69 65 6e 63 65 |ice & Ex|perience|
|00000b30| 22 0a 58 2e 42 20 31 35 | 20 2c 0a 58 37 20 28 4a |".X.B 15| ,.X7 (J|
|00000b40| 75 6c 79 20 31 39 38 35 | 29 2c 20 36 33 37 2d 36 |uly 1985|), 637-6|
|00000b50| 35 34 2e 0a 58 2e 46 45 | 0a 58 2e 6e 72 20 56 53 |54..X.FE|.X.nr VS|
|00000b60| 20 31 38 70 0a 58 2e 4c | 50 0a 58 2e 4e 48 0a 58 | 18p.X.L|P.X.NH.X|
|00000b70| 49 6e 74 72 6f 64 75 63 | 74 69 6f 6e 0a 58 2e 50 |Introduc|tion.X.P|
|00000b80| 50 0a 58 56 65 72 73 69 | 6f 6e 20 63 6f 6e 74 72 |P.XVersi|on contr|
|00000b90| 6f 6c 20 69 73 20 74 68 | 65 20 74 61 73 6b 20 6f |ol is th|e task o|
|00000ba0| 66 20 6b 65 65 70 69 6e | 67 20 73 6f 66 74 77 61 |f keepin|g softwa|
|00000bb0| 72 65 0a 58 73 79 73 74 | 65 6d 73 20 63 6f 6e 73 |re.Xsyst|ems cons|
|00000bc0| 69 73 74 69 6e 67 20 6f | 66 20 6d 61 6e 79 20 76 |isting o|f many v|
|00000bd0| 65 72 73 69 6f 6e 73 20 | 61 6e 64 20 63 6f 6e 66 |ersions |and conf|
|00000be0| 69 67 75 72 61 74 69 6f | 6e 73 20 77 65 6c 6c 20 |iguratio|ns well |
|00000bf0| 6f 72 67 61 6e 69 7a 65 | 64 2e 0a 58 54 68 65 20 |organize|d..XThe |
|00000c00| 52 65 76 69 73 69 6f 6e | 20 43 6f 6e 74 72 6f 6c |Revision| Control|
|00000c10| 20 53 79 73 74 65 6d 20 | 28 52 43 53 29 20 69 73 | System |(RCS) is|
|00000c20| 20 61 20 73 65 74 20 6f | 66 20 55 4e 49 58 0a 58 | a set o|f UNIX.X|
|00000c30| 63 6f 6d 6d 61 6e 64 73 | 20 74 68 61 74 20 61 73 |commands| that as|
|00000c40| 73 69 73 74 20 77 69 74 | 68 20 74 68 61 74 20 74 |sist wit|h that t|
|00000c50| 61 73 6b 2e 0a 58 2e 50 | 50 0a 58 52 43 53 27 20 |ask..X.P|P.XRCS' |
|00000c60| 70 72 69 6d 61 72 79 20 | 66 75 6e 63 74 69 6f 6e |primary |function|
|00000c70| 20 69 73 20 74 6f 20 6d | 61 6e 61 67 65 20 5c 66 | is to m|anage \f|
|00000c80| 49 72 65 76 69 73 69 6f | 6e 20 67 72 6f 75 70 73 |Irevisio|n groups|
|00000c90| 5c 66 52 2e 0a 58 41 20 | 72 65 76 69 73 69 6f 6e |\fR..XA |revision|
|00000ca0| 20 67 72 6f 75 70 20 69 | 73 20 61 20 73 65 74 20 | group i|s a set |
|00000cb0| 6f 66 20 74 65 78 74 20 | 64 6f 63 75 6d 65 6e 74 |of text |document|
|00000cc0| 73 2c 20 63 61 6c 6c 65 | 64 20 5c 66 49 72 65 76 |s, calle|d \fIrev|
|00000cd0| 69 73 69 6f 6e 73 5c 66 | 52 2c 0a 58 74 68 61 74 |isions\f|R,.Xthat|
|00000ce0| 20 65 76 6f 6c 76 65 64 | 20 66 72 6f 6d 20 65 61 | evolved| from ea|
|00000cf0| 63 68 20 6f 74 68 65 72 | 2e 20 20 41 20 6e 65 77 |ch other|.  A new|
|00000d00| 20 72 65 76 69 73 69 6f | 6e 20 69 73 0a 58 63 72 | revisio|n is.Xcr|
|00000d10| 65 61 74 65 64 20 62 79 | 20 6d 61 6e 75 61 6c 6c |eated by| manuall|
|00000d20| 79 20 65 64 69 74 69 6e | 67 20 61 6e 20 65 78 69 |y editin|g an exi|
|00000d30| 73 74 69 6e 67 20 6f 6e | 65 2e 0a 58 52 43 53 20 |sting on|e..XRCS |
|00000d40| 6f 72 67 61 6e 69 7a 65 | 73 20 74 68 65 20 72 65 |organize|s the re|
|00000d50| 76 69 73 69 6f 6e 73 20 | 69 6e 74 6f 20 61 6e 20 |visions |into an |
|00000d60| 61 6e 63 65 73 74 72 61 | 6c 20 74 72 65 65 2e 20 |ancestra|l tree. |
|00000d70| 20 54 68 65 20 69 6e 69 | 74 69 61 6c 20 72 65 76 | The ini|tial rev|
|00000d80| 69 73 69 6f 6e 0a 58 69 | 73 20 74 68 65 20 72 6f |ision.Xi|s the ro|
|00000d90| 6f 74 20 6f 66 20 74 68 | 65 20 74 72 65 65 2c 20 |ot of th|e tree, |
|00000da0| 61 6e 64 20 74 68 65 20 | 74 72 65 65 20 65 64 67 |and the |tree edg|
|00000db0| 65 73 20 69 6e 64 69 63 | 61 74 65 0a 58 66 72 6f |es indic|ate.Xfro|
|00000dc0| 6d 20 77 68 69 63 68 20 | 72 65 76 69 73 69 6f 6e |m which |revision|
|00000dd0| 20 61 20 67 69 76 65 6e | 20 6f 6e 65 20 65 76 6f | a given| one evo|
|00000de0| 6c 76 65 64 2e 0a 58 42 | 65 73 69 64 65 73 20 6d |lved..XB|esides m|
|00000df0| 61 6e 61 67 69 6e 67 20 | 69 6e 64 69 76 69 64 75 |anaging |individu|
|00000e00| 61 6c 20 72 65 76 69 73 | 69 6f 6e 20 67 72 6f 75 |al revis|ion grou|
|00000e10| 70 73 2c 20 52 43 53 20 | 70 72 6f 76 69 64 65 73 |ps, RCS |provides|
|00000e20| 0a 58 66 6c 65 78 69 62 | 6c 65 20 73 65 6c 65 63 |.Xflexib|le selec|
|00000e30| 74 69 6f 6e 20 66 75 6e | 63 74 69 6f 6e 73 20 66 |tion fun|ctions f|
|00000e40| 6f 72 20 63 6f 6d 70 6f | 73 69 6e 67 20 63 6f 6e |or compo|sing con|
|00000e50| 66 69 67 75 72 61 74 69 | 6f 6e 73 2e 0a 58 52 43 |figurati|ons..XRC|
|00000e60| 53 20 6d 61 79 20 62 65 | 20 63 6f 6d 62 69 6e 65 |S may be| combine|
|00000e70| 64 20 77 69 74 68 20 4d | 41 4b 45 5c 75 31 5c 64 |d with M|AKE\u1\d|
|00000e80| 2c 0a 58 72 65 73 75 6c | 74 69 6e 67 20 69 6e 20 |,.Xresul|ting in |
|00000e90| 61 20 70 6f 77 65 72 66 | 75 6c 20 70 61 63 6b 61 |a powerf|ul packa|
|00000ea0| 67 65 20 66 6f 72 20 76 | 65 72 73 69 6f 6e 20 63 |ge for v|ersion c|
|00000eb0| 6f 6e 74 72 6f 6c 2e 0a | 58 2e 50 50 0a 58 52 43 |ontrol..|X.PP.XRC|
|00000ec0| 53 20 61 6c 73 6f 20 6f | 66 66 65 72 73 20 66 61 |S also o|ffers fa|
|00000ed0| 63 69 6c 69 74 69 65 73 | 20 66 6f 72 0a 58 6d 65 |cilities| for.Xme|
|00000ee0| 72 67 69 6e 67 20 75 70 | 64 61 74 65 73 20 77 69 |rging up|dates wi|
|00000ef0| 74 68 20 63 75 73 74 6f | 6d 65 72 20 6d 6f 64 69 |th custo|mer modi|
|00000f00| 66 69 63 61 74 69 6f 6e | 73 2c 0a 58 66 6f 72 20 |fication|s,.Xfor |
|00000f10| 64 69 73 74 72 69 62 75 | 74 65 64 20 73 6f 66 74 |distribu|ted soft|
|00000f20| 77 61 72 65 20 64 65 76 | 65 6c 6f 70 6d 65 6e 74 |ware dev|elopment|
|00000f30| 2c 20 61 6e 64 0a 58 66 | 6f 72 20 61 75 74 6f 6d |, and.Xf|or autom|
|00000f40| 61 74 69 63 20 69 64 65 | 6e 74 69 66 69 63 61 74 |atic ide|ntificat|
|00000f50| 69 6f 6e 2e 0a 58 49 64 | 65 6e 74 69 66 69 63 61 |ion..XId|entifica|
|00000f60| 74 69 6f 6e 20 69 73 20 | 74 68 65 20 60 73 74 61 |tion is |the `sta|
|00000f70| 6d 70 69 6e 67 27 0a 58 | 6f 66 20 72 65 76 69 73 |mping'.X|of revis|
|00000f80| 69 6f 6e 73 20 61 6e 64 | 20 63 6f 6e 66 69 67 75 |ions and| configu|
|00000f90| 72 61 74 69 6f 6e 73 20 | 77 69 74 68 20 75 6e 69 |rations |with uni|
|00000fa0| 71 75 65 20 6d 61 72 6b | 65 72 73 2e 0a 58 54 68 |que mark|ers..XTh|
|00000fb0| 65 73 65 20 6d 61 72 6b | 65 72 73 20 61 72 65 20 |ese mark|ers are |
|00000fc0| 61 6b 69 6e 20 74 6f 20 | 73 65 72 69 61 6c 20 6e |akin to |serial n|
|00000fd0| 75 6d 62 65 72 73 2c 0a | 58 74 65 6c 6c 69 6e 67 |umbers,.|Xtelling|
|00000fe0| 20 73 6f 66 74 77 61 72 | 65 20 6d 61 69 6e 74 61 | softwar|e mainta|
|00000ff0| 69 6e 65 72 73 20 75 6e | 61 6d 62 69 67 75 6f 75 |iners un|ambiguou|
|00001000| 73 6c 79 20 77 68 69 63 | 68 20 63 6f 6e 66 69 67 |sly whic|h config|
|00001010| 75 72 61 74 69 6f 6e 0a | 58 69 73 20 62 65 66 6f |uration.|Xis befo|
|00001020| 72 65 20 74 68 65 6d 2e | 0a 58 2e 50 50 0a 58 52 |re them.|.X.PP.XR|
|00001030| 43 53 20 69 73 20 64 65 | 73 69 67 6e 65 64 20 66 |CS is de|signed f|
|00001040| 6f 72 20 62 6f 74 68 20 | 70 72 6f 64 75 63 74 69 |or both |producti|
|00001050| 6f 6e 20 61 6e 64 20 65 | 78 70 65 72 69 6d 65 6e |on and e|xperimen|
|00001060| 74 61 6c 0a 58 65 6e 76 | 69 72 6f 6e 6d 65 6e 74 |tal.Xenv|ironment|
|00001070| 73 2e 0a 58 49 6e 20 70 | 72 6f 64 75 63 74 69 6f |s..XIn p|roductio|
|00001080| 6e 20 65 6e 76 69 72 6f | 6e 6d 65 6e 74 73 2c 0a |n enviro|nments,.|
|00001090| 58 61 63 63 65 73 73 20 | 63 6f 6e 74 72 6f 6c 73 |Xaccess |controls|
|000010a0| 20 64 65 74 65 63 74 20 | 75 70 64 61 74 65 20 63 | detect |update c|
|000010b0| 6f 6e 66 6c 69 63 74 73 | 20 61 6e 64 20 70 72 65 |onflicts| and pre|
|000010c0| 76 65 6e 74 20 6f 76 65 | 72 6c 61 70 70 69 6e 67 |vent ove|rlapping|
|000010d0| 20 63 68 61 6e 67 65 73 | 2e 0a 58 49 6e 20 65 78 | changes|..XIn ex|
|000010e0| 70 65 72 69 6d 65 6e 74 | 61 6c 20 65 6e 76 69 72 |periment|al envir|
|000010f0| 6f 6e 6d 65 6e 74 73 2c | 20 77 68 65 72 65 20 73 |onments,| where s|
|00001100| 74 72 6f 6e 67 20 63 6f | 6e 74 72 6f 6c 73 20 61 |trong co|ntrols a|
|00001110| 72 65 0a 58 63 6f 75 6e | 74 65 72 70 72 6f 64 75 |re.Xcoun|terprodu|
|00001120| 63 74 69 76 65 2c 20 69 | 74 20 69 73 20 70 6f 73 |ctive, i|t is pos|
|00001130| 73 69 62 6c 65 20 74 6f | 20 6c 6f 6f 73 65 6e 20 |sible to| loosen |
|00001140| 74 68 65 20 63 6f 6e 74 | 72 6f 6c 73 2e 0a 58 2e |the cont|rols..X.|
|00001150| 50 50 0a 58 41 6c 74 68 | 6f 75 67 68 20 52 43 53 |PP.XAlth|ough RCS|
|00001160| 20 77 61 73 20 6f 72 69 | 67 69 6e 61 6c 6c 79 20 | was ori|ginally |
|00001170| 69 6e 74 65 6e 64 65 64 | 20 66 6f 72 20 70 72 6f |intended| for pro|
|00001180| 67 72 61 6d 73 2c 20 69 | 74 20 69 73 20 75 73 65 |grams, i|t is use|
|00001190| 66 75 6c 20 66 6f 72 20 | 61 6e 79 0a 58 74 65 78 |ful for |any.Xtex|
|000011a0| 74 20 74 68 61 74 20 69 | 73 20 72 65 76 69 73 65 |t that i|s revise|
|000011b0| 64 20 66 72 65 71 75 65 | 6e 74 6c 79 20 61 6e 64 |d freque|ntly and|
|000011c0| 20 77 68 6f 73 65 20 70 | 72 65 76 69 6f 75 73 20 | whose p|revious |
|000011d0| 72 65 76 69 73 69 6f 6e | 73 20 6d 75 73 74 20 62 |revision|s must b|
|000011e0| 65 0a 58 70 72 65 73 65 | 72 76 65 64 2e 20 20 52 |e.Xprese|rved.  R|
|000011f0| 43 53 20 68 61 73 20 62 | 65 65 6e 20 61 70 70 6c |CS has b|een appl|
|00001200| 69 65 64 20 73 75 63 63 | 65 73 73 66 75 6c 6c 79 |ied succ|essfully|
|00001210| 20 74 6f 20 73 74 6f 72 | 65 20 74 68 65 20 73 6f | to stor|e the so|
|00001220| 75 72 63 65 0a 58 74 65 | 78 74 20 66 6f 72 20 64 |urce.Xte|xt for d|
|00001230| 72 61 77 69 6e 67 73 2c | 20 56 4c 53 49 20 6c 61 |rawings,| VLSI la|
|00001240| 79 6f 75 74 73 2c 20 64 | 6f 63 75 6d 65 6e 74 61 |youts, d|ocumenta|
|00001250| 74 69 6f 6e 2c 20 73 70 | 65 63 69 66 69 63 61 74 |tion, sp|ecificat|
|00001260| 69 6f 6e 73 2c 0a 58 74 | 65 73 74 20 64 61 74 61 |ions,.Xt|est data|
|00001270| 2c 20 66 6f 72 6d 20 6c | 65 74 74 65 72 73 20 61 |, form l|etters a|
|00001280| 6e 64 20 61 72 74 69 63 | 6c 65 73 2e 0a 58 2e 50 |nd artic|les..X.P|
|00001290| 50 0a 58 54 68 69 73 20 | 70 61 70 65 72 20 64 69 |P.XThis |paper di|
|000012a0| 73 63 75 73 73 65 73 20 | 74 68 65 20 70 72 61 63 |scusses |the prac|
|000012b0| 74 69 63 65 20 6f 66 0a | 58 76 65 72 73 69 6f 6e |tice of.|Xversion|
|000012c0| 20 63 6f 6e 74 72 6f 6c | 20 75 73 69 6e 67 20 52 | control| using R|
|000012d0| 43 53 2e 0a 58 49 74 20 | 61 6c 73 6f 20 69 6e 74 |CS..XIt |also int|
|000012e0| 72 6f 64 75 63 65 73 20 | 62 61 73 69 63 20 76 65 |roduces |basic ve|
|000012f0| 72 73 69 6f 6e 20 63 6f | 6e 74 72 6f 6c 20 63 6f |rsion co|ntrol co|
|00001300| 6e 63 65 70 74 73 2c 0a | 58 75 73 65 66 75 6c 20 |ncepts,.|Xuseful |
|00001310| 66 6f 72 20 63 6c 61 72 | 69 66 79 69 6e 67 20 63 |for clar|ifying c|
|00001320| 75 72 72 65 6e 74 20 70 | 72 61 63 74 69 63 65 20 |urrent p|ractice |
|00001330| 61 6e 64 20 64 65 73 69 | 67 6e 69 6e 67 20 73 69 |and desi|gning si|
|00001340| 6d 69 6c 61 72 20 73 79 | 73 74 65 6d 73 2e 0a 58 |milar sy|stems..X|
|00001350| 52 65 76 69 73 69 6f 6e | 20 67 72 6f 75 70 73 20 |Revision| groups |
|00001360| 6f 66 20 69 6e 64 69 76 | 69 64 75 61 6c 20 63 6f |of indiv|idual co|
|00001370| 6d 70 6f 6e 65 6e 74 73 | 20 61 72 65 20 74 72 65 |mponents| are tre|
|00001380| 61 74 65 64 20 69 6e 20 | 74 68 65 20 6e 65 78 74 |ated in |the next|
|00001390| 20 74 68 72 65 65 20 73 | 65 63 74 69 6f 6e 73 2c | three s|ections,|
|000013a0| 0a 58 61 6e 64 20 74 68 | 65 20 65 78 74 65 6e 73 |.Xand th|e extens|
|000013b0| 69 6f 6e 73 20 74 6f 20 | 63 6f 6e 66 69 67 75 72 |ions to |configur|
|000013c0| 61 74 69 6f 6e 73 20 66 | 6f 6c 6c 6f 77 2e 0a 58 |ations f|ollow..X|
|000013d0| 42 65 63 61 75 73 65 20 | 6f 66 20 69 74 73 20 73 |Because |of its s|
|000013e0| 69 7a 65 2c 20 61 20 73 | 75 72 76 65 79 20 6f 66 |ize, a s|urvey of|
|000013f0| 20 76 65 72 73 69 6f 6e | 20 63 6f 6e 74 72 6f 6c | version| control|
|00001400| 20 74 6f 6f 6c 73 0a 58 | 61 70 70 65 61 72 73 20 | tools.X|appears |
|00001410| 61 74 20 74 68 65 20 65 | 6e 64 20 6f 66 20 74 68 |at the e|nd of th|
|00001420| 65 20 70 61 70 65 72 2e | 0a 58 2e 4e 48 0a 58 47 |e paper.|.X.NH.XG|
|00001430| 65 74 74 69 6e 67 20 73 | 74 61 72 74 65 64 20 77 |etting s|tarted w|
|00001440| 69 74 68 20 52 43 53 0a | 58 2e 50 50 0a 58 53 75 |ith RCS.|X.PP.XSu|
|00001450| 70 70 6f 73 65 20 61 20 | 74 65 78 74 20 66 69 6c |ppose a |text fil|
|00001460| 65 20 5c 66 49 66 2e 63 | 5c 66 52 20 69 73 20 74 |e \fIf.c|\fR is t|
|00001470| 6f 20 62 65 20 70 6c 61 | 63 65 64 20 75 6e 64 65 |o be pla|ced unde|
|00001480| 72 20 63 6f 6e 74 72 6f | 6c 20 6f 66 20 52 43 53 |r contro|l of RCS|
|00001490| 2e 0a 58 49 6e 76 6f 6b | 69 6e 67 20 74 68 65 20 |..XInvok|ing the |
|000014a0| 63 68 65 63 6b 2d 69 6e | 20 63 6f 6d 6d 61 6e 64 |check-in| command|
|000014b0| 0a 58 2e 44 28 0a 58 63 | 69 20 20 66 2e 63 0a 58 |.X.D(.Xc|i  f.c.X|
|000014c0| 2e 44 29 0a 58 63 72 65 | 61 74 65 73 20 61 20 6e |.D).Xcre|ates a n|
|000014d0| 65 77 20 72 65 76 69 73 | 69 6f 6e 20 67 72 6f 75 |ew revis|ion grou|
|000014e0| 70 20 77 69 74 68 20 74 | 68 65 20 63 6f 6e 74 65 |p with t|he conte|
|000014f0| 6e 74 73 20 6f 66 0a 58 | 5c 66 49 66 2e 63 5c 66 |nts of.X|\fIf.c\f|
|00001500| 52 20 61 73 20 74 68 65 | 20 69 6e 69 74 69 61 6c |R as the| initial|
|00001510| 0a 58 72 65 76 69 73 69 | 6f 6e 20 28 6e 75 6d 62 |.Xrevisi|on (numb|
|00001520| 65 72 65 64 20 31 2e 31 | 29 0a 58 61 6e 64 20 73 |ered 1.1|).Xand s|
|00001530| 74 6f 72 65 73 20 74 68 | 65 20 67 72 6f 75 70 20 |tores th|e group |
|00001540| 69 6e 74 6f 20 74 68 65 | 20 66 69 6c 65 20 5c 66 |into the| file \f|
|00001550| 49 66 2e 63 2c 76 5c 66 | 52 2e 0a 58 55 6e 6c 65 |If.c,v\f|R..XUnle|
|00001560| 73 73 20 74 6f 6c 64 20 | 6f 74 68 65 72 77 69 73 |ss told |otherwis|
|00001570| 65 2c 20 74 68 65 20 63 | 6f 6d 6d 61 6e 64 20 64 |e, the c|ommand d|
|00001580| 65 6c 65 74 65 73 20 5c | 66 49 66 2e 63 5c 66 52 |eletes \|fIf.c\fR|
|00001590| 2e 0a 58 49 74 20 61 6c | 73 6f 20 61 73 6b 73 20 |..XIt al|so asks |
|000015a0| 66 6f 72 20 61 20 64 65 | 73 63 72 69 70 74 69 6f |for a de|scriptio|
|000015b0| 6e 20 6f 66 20 74 68 65 | 20 67 72 6f 75 70 2e 0a |n of the| group..|
|000015c0| 58 54 68 65 20 64 65 73 | 63 72 69 70 74 69 6f 6e |XThe des|cription|
|000015d0| 20 73 68 6f 75 6c 64 20 | 73 74 61 74 65 20 74 68 | should |state th|
|000015e0| 65 20 63 6f 6d 6d 6f 6e | 20 70 75 72 70 6f 73 65 |e common| purpose|
|000015f0| 20 6f 66 20 61 6c 6c 20 | 72 65 76 69 73 69 6f 6e | of all |revision|
|00001600| 73 20 69 6e 20 74 68 65 | 20 67 72 6f 75 70 2c 0a |s in the| group,.|
|00001610| 58 61 6e 64 20 62 65 63 | 6f 6d 65 73 20 70 61 72 |Xand bec|omes par|
|00001620| 74 20 6f 66 20 74 68 65 | 20 67 72 6f 75 70 27 73 |t of the| group's|
|00001630| 20 64 6f 63 75 6d 65 6e | 74 61 74 69 6f 6e 2e 0a | documen|tation..|
|00001640| 58 41 6c 6c 20 6c 61 74 | 65 72 20 63 68 65 63 6b |XAll lat|er check|
|00001650| 2d 69 6e 20 63 6f 6d 6d | 61 6e 64 73 20 77 69 6c |-in comm|ands wil|
|00001660| 6c 20 61 73 6b 20 66 6f | 72 20 61 20 6c 6f 67 20 |l ask fo|r a log |
|00001670| 65 6e 74 72 79 2c 0a 58 | 77 68 69 63 68 20 73 68 |entry,.X|which sh|
|00001680| 6f 75 6c 64 20 73 75 6d | 6d 61 72 69 7a 65 20 74 |ould sum|marize t|
|00001690| 68 65 20 63 68 61 6e 67 | 65 73 20 6d 61 64 65 2e |he chang|es made.|
|000016a0| 0a 58 28 54 68 65 20 66 | 69 72 73 74 20 72 65 76 |.X(The f|irst rev|
|000016b0| 69 73 69 6f 6e 20 69 73 | 20 61 73 73 69 67 6e 65 |ision is| assigne|
|000016c0| 64 20 61 20 64 65 66 61 | 75 6c 74 20 6c 6f 67 20 |d a defa|ult log |
|000016d0| 6d 65 73 73 61 67 65 2c | 0a 58 77 68 69 63 68 20 |message,|.Xwhich |
|000016e0| 6a 75 73 74 20 72 65 63 | 6f 72 64 73 20 74 68 65 |just rec|ords the|
|000016f0| 20 66 61 63 74 20 74 68 | 61 74 20 69 74 20 69 73 | fact th|at it is|
|00001700| 20 74 68 65 20 69 6e 69 | 74 69 61 6c 20 72 65 76 | the ini|tial rev|
|00001710| 69 73 69 6f 6e 2e 29 0a | 58 2e 50 50 0a 58 46 69 |ision.).|X.PP.XFi|
|00001720| 6c 65 73 20 65 6e 64 69 | 6e 67 20 69 6e 20 5c 66 |les endi|ng in \f|
|00001730| 49 2c 76 5c 66 52 0a 58 | 61 72 65 20 63 61 6c 6c |I,v\fR.X|are call|
|00001740| 65 64 20 5c 66 49 52 43 | 53 20 66 69 6c 65 73 5c |ed \fIRC|S files\|
|00001750| 66 52 20 28 5c 66 49 76 | 5c 66 52 20 73 74 61 6e |fR (\fIv|\fR stan|
|00001760| 64 73 20 66 6f 72 20 5c | 66 49 76 5c 66 52 65 72 |ds for \|fIv\fRer|
|00001770| 73 69 6f 6e 73 29 3b 0a | 58 74 68 65 20 6f 74 68 |sions);.|Xthe oth|
|00001780| 65 72 73 20 61 72 65 20 | 63 61 6c 6c 65 64 20 77 |ers are |called w|
|00001790| 6f 72 6b 69 6e 67 20 66 | 69 6c 65 73 2e 0a 58 54 |orking f|iles..XT|
|000017a0| 6f 20 67 65 74 20 62 61 | 63 6b 20 74 68 65 20 77 |o get ba|ck the w|
|000017b0| 6f 72 6b 69 6e 67 20 66 | 69 6c 65 20 5c 66 49 66 |orking f|ile \fIf|
|000017c0| 2e 63 5c 66 52 20 69 6e | 20 74 68 65 20 70 72 65 |.c\fR in| the pre|
|000017d0| 76 69 6f 75 73 20 65 78 | 61 6d 70 6c 65 2c 0a 58 |vious ex|ample,.X|
|000017e0| 65 78 65 63 75 74 65 20 | 74 68 65 20 63 68 65 63 |execute |the chec|
|000017f0| 6b 2d 6f 75 74 20 63 6f | 6d 6d 61 6e 64 3a 0a 58 |k-out co|mmand:.X|
|00001800| 2e 44 28 0a 58 63 6f 20 | 20 66 2e 63 0a 58 2e 44 |.D(.Xco | f.c.X.D|
|00001810| 29 0a 58 2e 52 0a 58 54 | 68 69 73 20 63 6f 6d 6d |).X.R.XT|his comm|
|00001820| 61 6e 64 20 65 78 74 72 | 61 63 74 73 20 74 68 65 |and extr|acts the|
|00001830| 20 6c 61 74 65 73 74 20 | 72 65 76 69 73 69 6f 6e | latest |revision|
|00001840| 20 66 72 6f 6d 0a 58 74 | 68 65 20 72 65 76 69 73 | from.Xt|he revis|
|00001850| 69 6f 6e 20 67 72 6f 75 | 70 20 5c 66 49 66 2e 63 |ion grou|p \fIf.c|
|00001860| 2c 76 5c 66 52 20 61 6e | 64 20 77 72 69 74 65 73 |,v\fR an|d writes|
|00001870| 0a 58 69 74 20 69 6e 74 | 6f 20 5c 66 49 66 2e 63 |.Xit int|o \fIf.c|
|00001880| 5c 66 52 2e 0a 58 54 68 | 65 20 66 69 6c 65 20 5c |\fR..XTh|e file \|
|00001890| 66 49 66 2e 63 5c 66 52 | 20 63 61 6e 20 6e 6f 77 |fIf.c\fR| can now|
|000018a0| 20 62 65 20 65 64 69 74 | 65 64 20 61 6e 64 2c 20 | be edit|ed and, |
|000018b0| 77 68 65 6e 20 66 69 6e | 69 73 68 65 64 2c 0a 58 |when fin|ished,.X|
|000018c0| 63 68 65 63 6b 65 64 20 | 62 61 63 6b 20 69 6e 20 |checked |back in |
|000018d0| 77 69 74 68 20 5c 66 49 | 63 69 5c 66 52 3a 0a 58 |with \fI|ci\fR:.X|
|000018e0| 2e 44 28 0a 58 63 69 20 | 20 66 2e 63 0a 58 2e 44 |.D(.Xci | f.c.X.D|
|000018f0| 29 0a 58 5c 66 49 43 69 | 5c 66 52 20 61 73 73 69 |).X\fICi|\fR assi|
|00001900| 67 6e 73 20 6e 75 6d 62 | 65 72 20 31 2e 32 20 74 |gns numb|er 1.2 t|
|00001910| 6f 0a 58 74 68 65 20 6e | 65 77 20 72 65 76 69 73 |o.Xthe n|ew revis|
|00001920| 69 6f 6e 2e 0a 58 49 66 | 20 5c 66 49 63 69 5c 66 |ion..XIf| \fIci\f|
|00001930| 52 20 63 6f 6d 70 6c 61 | 69 6e 73 20 77 69 74 68 |R compla|ins with|
|00001940| 20 74 68 65 20 6d 65 73 | 73 61 67 65 0a 58 2e 44 | the mes|sage.X.D|
|00001950| 28 0a 58 63 69 20 65 72 | 72 6f 72 3a 20 6e 6f 20 |(.Xci er|ror: no |
|00001960| 6c 6f 63 6b 20 73 65 74 | 20 62 79 20 3c 6c 6f 67 |lock set| by <log|
|00001970| 69 6e 3e 0a 58 2e 44 29 | 0a 58 74 68 65 6e 20 74 |in>.X.D)|.Xthen t|
|00001980| 68 65 20 73 79 73 74 65 | 6d 20 61 64 6d 69 6e 69 |he syste|m admini|
|00001990| 73 74 72 61 74 6f 72 20 | 68 61 73 20 64 65 63 69 |strator |has deci|
|000019a0| 64 65 64 20 74 6f 20 63 | 6f 6e 66 69 67 75 72 65 |ded to c|onfigure|
|000019b0| 20 52 43 53 20 66 6f 72 | 20 61 0a 58 70 72 6f 64 | RCS for| a.Xprod|
|000019c0| 75 63 74 69 6f 6e 20 65 | 6e 76 69 72 6f 6e 6d 65 |uction e|nvironme|
|000019d0| 6e 74 20 62 79 20 65 6e | 61 62 6c 69 6e 67 20 74 |nt by en|abling t|
|000019e0| 68 65 20 60 73 74 72 69 | 63 74 20 6c 6f 63 6b 69 |he `stri|ct locki|
|000019f0| 6e 67 20 66 65 61 74 75 | 72 65 27 2e 0a 58 49 66 |ng featu|re'..XIf|
|00001a00| 20 74 68 69 73 20 66 65 | 61 74 75 72 65 20 69 73 | this fe|ature is|
|00001a10| 20 65 6e 61 62 6c 65 64 | 2c 20 61 6c 6c 20 52 43 | enabled|, all RC|
|00001a20| 53 20 66 69 6c 65 73 20 | 61 72 65 20 69 6e 69 74 |S files |are init|
|00001a30| 69 61 6c 69 7a 65 64 0a | 58 73 75 63 68 20 74 68 |ialized.|Xsuch th|
|00001a40| 61 74 20 63 68 65 63 6b | 2d 69 6e 20 6f 70 65 72 |at check|-in oper|
|00001a50| 61 74 69 6f 6e 73 20 72 | 65 71 75 69 72 65 20 61 |ations r|equire a|
|00001a60| 20 6c 6f 63 6b 20 6f 6e | 20 74 68 65 20 70 72 65 | lock on| the pre|
|00001a70| 76 69 6f 75 73 20 72 65 | 76 69 73 69 6f 6e 0a 58 |vious re|vision.X|
|00001a80| 28 74 68 65 20 6f 6e 65 | 20 66 72 6f 6d 20 77 68 |(the one| from wh|
|00001a90| 69 63 68 20 74 68 65 20 | 63 75 72 72 65 6e 74 20 |ich the |current |
|00001aa0| 6f 6e 65 20 65 76 6f 6c | 76 65 64 29 2e 0a 58 4c |one evol|ved)..XL|
|00001ab0| 6f 63 6b 69 6e 67 20 70 | 72 65 76 65 6e 74 73 20 |ocking p|revents |
|00001ac0| 6f 76 65 72 6c 61 70 70 | 69 6e 67 20 6d 6f 64 69 |overlapp|ing modi|
|00001ad0| 66 69 63 61 74 69 6f 6e | 73 20 69 66 20 73 65 76 |fication|s if sev|
|00001ae0| 65 72 61 6c 20 70 65 6f | 70 6c 65 20 77 6f 72 6b |eral peo|ple work|
|00001af0| 20 6f 6e 20 74 68 65 20 | 73 61 6d 65 20 66 69 6c | on the |same fil|
|00001b00| 65 2e 0a 58 49 66 20 6c | 6f 63 6b 69 6e 67 20 69 |e..XIf l|ocking i|
|00001b10| 73 20 72 65 71 75 69 72 | 65 64 2c 20 74 68 65 20 |s requir|ed, the |
|00001b20| 72 65 76 69 73 69 6f 6e | 20 73 68 6f 75 6c 64 0a |revision| should.|
|00001b30| 58 68 61 76 65 20 62 65 | 65 6e 20 6c 6f 63 6b 65 |Xhave be|en locke|
|00001b40| 64 20 64 75 72 69 6e 67 | 20 74 68 65 20 63 68 65 |d during| the che|
|00001b50| 63 6b 2d 6f 75 74 20 62 | 79 20 75 73 69 6e 67 0a |ck-out b|y using.|
|00001b60| 58 74 68 65 20 6f 70 74 | 69 6f 6e 20 5c 66 49 5c |Xthe opt|ion \fI\|
|00001b70| 2d 6c 5c 66 52 3a 0a 58 | 2e 44 28 0a 58 63 6f 20 |-l\fR:.X|.D(.Xco |
|00001b80| 20 5c 2d 6c 20 20 66 2e | 63 0a 58 2e 44 29 0a 58 | \-l  f.|c.X.D).X|
|00001b90| 4f 66 20 63 6f 75 72 73 | 65 20 69 74 20 69 73 20 |Of cours|e it is |
|00001ba0| 74 6f 6f 20 6c 61 74 65 | 20 6e 6f 77 20 66 6f 72 |too late| now for|
|00001bb0| 20 74 68 65 20 63 68 65 | 63 6b 2d 6f 75 74 20 77 | the che|ck-out w|
|00001bc0| 69 74 68 20 6c 6f 63 6b | 69 6e 67 2c 20 62 65 63 |ith lock|ing, bec|
|00001bd0| 61 75 73 65 0a 58 5c 66 | 49 66 2e 63 5c 66 52 20 |ause.X\f|If.c\fR |
|00001be0| 68 61 73 20 61 6c 72 65 | 61 64 79 20 62 65 65 6e |has alre|ady been|
|00001bf0| 20 63 68 61 6e 67 65 64 | 3b 20 63 68 65 63 6b 69 | changed|; checki|
|00001c00| 6e 67 20 6f 75 74 20 74 | 68 65 20 66 69 6c 65 20 |ng out t|he file |
|00001c10| 61 67 61 69 6e 0a 58 77 | 6f 75 6c 64 20 6f 76 65 |again.Xw|ould ove|
|00001c20| 72 77 72 69 74 65 20 74 | 68 65 20 6d 6f 64 69 66 |rwrite t|he modif|
|00001c30| 69 63 61 74 69 6f 6e 73 | 2e 0a 58 28 54 6f 20 70 |ications|..X(To p|
|00001c40| 72 65 76 65 6e 74 20 61 | 63 63 69 64 65 6e 74 61 |revent a|ccidenta|
|00001c50| 6c 20 6f 76 65 72 77 72 | 69 74 65 73 2c 20 5c 66 |l overwr|ites, \f|
|00001c60| 49 63 6f 5c 66 52 20 73 | 65 6e 73 65 73 20 74 68 |Ico\fR s|enses th|
|00001c70| 65 20 70 72 65 73 65 6e | 63 65 0a 58 6f 66 20 61 |e presen|ce.Xof a|
|00001c80| 20 77 6f 72 6b 69 6e 67 | 20 66 69 6c 65 20 61 6e | working| file an|
|00001c90| 64 20 61 73 6b 73 20 77 | 68 65 74 68 65 72 20 74 |d asks w|hether t|
|00001ca0| 68 65 20 75 73 65 72 20 | 72 65 61 6c 6c 79 20 69 |he user |really i|
|00001cb0| 6e 74 65 6e 64 65 64 20 | 74 6f 20 6f 76 65 72 77 |ntended |to overw|
|00001cc0| 72 69 74 65 20 69 74 2e | 0a 58 54 68 65 20 6f 76 |rite it.|.XThe ov|
|00001cd0| 65 72 77 72 69 74 69 6e | 67 20 63 68 65 63 6b 2d |erwritin|g check-|
|00001ce0| 6f 75 74 20 69 73 20 73 | 6f 6d 65 74 69 6d 65 73 |out is s|ometimes|
|00001cf0| 20 75 73 65 66 75 6c 20 | 66 6f 72 0a 58 62 61 63 | useful |for.Xbac|
|00001d00| 6b 69 6e 67 20 75 70 20 | 74 6f 20 74 68 65 20 70 |king up |to the p|
|00001d10| 72 65 76 69 6f 75 73 20 | 72 65 76 69 73 69 6f 6e |revious |revision|
|00001d20| 2e 29 0a 58 54 6f 20 62 | 65 20 61 62 6c 65 20 74 |.).XTo b|e able t|
|00001d30| 6f 20 70 72 6f 63 65 65 | 64 20 77 69 74 68 20 74 |o procee|d with t|
|00001d40| 68 65 20 63 68 65 63 6b | 2d 69 6e 20 69 6e 20 74 |he check|-in in t|
|00001d50| 68 65 20 70 72 65 73 65 | 6e 74 20 63 61 73 65 2c |he prese|nt case,|
|00001d60| 20 66 69 72 73 74 20 65 | 78 65 63 75 74 65 0a 58 | first e|xecute.X|
|00001d70| 2e 44 28 0a 58 72 63 73 | 20 20 5c 2d 6c 20 20 66 |.D(.Xrcs|  \-l  f|
|00001d80| 2e 63 0a 58 2e 44 29 0a | 58 54 68 69 73 20 63 6f |.c.X.D).|XThis co|
|00001d90| 6d 6d 61 6e 64 20 72 65 | 74 72 6f 61 63 74 69 76 |mmand re|troactiv|
|00001da0| 65 6c 79 20 6c 6f 63 6b | 73 20 74 68 65 20 6c 61 |ely lock|s the la|
|00001db0| 74 65 73 74 20 72 65 76 | 69 73 69 6f 6e 2c 20 75 |test rev|ision, u|
|00001dc0| 6e 6c 65 73 73 20 73 6f | 6d 65 6f 6e 65 0a 58 65 |nless so|meone.Xe|
|00001dd0| 6c 73 65 20 6c 6f 63 6b | 65 64 20 69 74 20 69 6e |lse lock|ed it in|
|00001de0| 20 74 68 65 20 6d 65 61 | 6e 74 69 6d 65 2e 20 20 | the mea|ntime.  |
|00001df0| 49 6e 20 74 68 69 73 20 | 63 61 73 65 2c 20 74 68 |In this |case, th|
|00001e00| 65 20 74 77 6f 20 70 72 | 6f 67 72 61 6d 6d 65 72 |e two pr|ogrammer|
|00001e10| 73 0a 58 69 6e 76 6f 6c | 76 65 64 20 68 61 76 65 |s.Xinvol|ved have|
|00001e20| 20 74 6f 20 6e 65 67 6f | 74 69 61 74 65 20 77 68 | to nego|tiate wh|
|00001e30| 6f 73 65 0a 58 6d 6f 64 | 69 66 69 63 61 74 69 6f |ose.Xmod|ificatio|
|00001e40| 6e 73 20 73 68 6f 75 6c | 64 20 74 61 6b 65 20 70 |ns shoul|d take p|
|00001e50| 72 65 63 65 64 65 6e 63 | 65 2e 0a 58 2e 50 50 0a |recedenc|e..X.PP.|
|00001e60| 58 49 66 20 61 6e 20 52 | 43 53 20 66 69 6c 65 20 |XIf an R|CS file |
|00001e70| 69 73 20 70 72 69 76 61 | 74 65 2c 20 69 2e 65 2e |is priva|te, i.e.|
|00001e80| 2c 20 69 66 20 6f 6e 6c | 79 20 74 68 65 20 6f 77 |, if onl|y the ow|
|00001e90| 6e 65 72 20 6f 66 20 74 | 68 65 20 66 69 6c 65 20 |ner of t|he file |
|00001ea0| 69 73 20 65 78 70 65 63 | 74 65 64 0a 58 74 6f 20 |is expec|ted.Xto |
|00001eb0| 64 65 70 6f 73 69 74 20 | 72 65 76 69 73 69 6f 6e |deposit |revision|
|00001ec0| 73 20 69 6e 74 6f 20 69 | 74 2c 20 74 68 65 20 73 |s into i|t, the s|
|00001ed0| 74 72 69 63 74 20 6c 6f | 63 6b 69 6e 67 20 66 65 |trict lo|cking fe|
|00001ee0| 61 74 75 72 65 20 69 73 | 20 75 6e 6e 65 63 65 73 |ature is| unneces|
|00001ef0| 73 61 72 79 20 61 6e 64 | 0a 58 6d 61 79 20 62 65 |sary and|.Xmay be|
|00001f00| 20 64 69 73 61 62 6c 65 | 64 2e 0a 58 49 66 20 73 | disable|d..XIf s|
|00001f10| 74 72 69 63 74 20 6c 6f | 63 6b 69 6e 67 20 69 73 |trict lo|cking is|
|00001f20| 20 64 69 73 61 62 6c 65 | 64 2c 0a 58 74 68 65 20 | disable|d,.Xthe |
|00001f30| 6f 77 6e 65 72 20 6f 66 | 20 74 68 65 20 52 43 53 |owner of| the RCS|
|00001f40| 20 66 69 6c 65 20 6e 65 | 65 64 20 6e 6f 74 20 68 | file ne|ed not h|
|00001f50| 61 76 65 20 61 20 6c 6f | 63 6b 20 66 6f 72 20 63 |ave a lo|ck for c|
|00001f60| 68 65 63 6b 2d 69 6e 2e | 0a 58 46 6f 72 20 73 61 |heck-in.|.XFor sa|
|00001f70| 66 65 74 79 20 72 65 61 | 73 6f 6e 73 2c 20 61 6c |fety rea|sons, al|
|00001f80| 6c 20 6f 74 68 65 72 73 | 0a 58 73 74 69 6c 6c 20 |l others|.Xstill |
|00001f90| 64 6f 2e 20 20 54 75 72 | 6e 69 6e 67 20 73 74 72 |do.  Tur|ning str|
|00001fa0| 69 63 74 20 6c 6f 63 6b | 69 6e 67 20 6f 66 66 20 |ict lock|ing off |
|00001fb0| 61 6e 64 20 6f 6e 20 69 | 73 20 64 6f 6e 65 20 77 |and on i|s done w|
|00001fc0| 69 74 68 20 74 68 65 20 | 63 6f 6d 6d 61 6e 64 73 |ith the |commands|
|00001fd0| 3a 0a 58 2e 44 28 0a 58 | 72 63 73 20 20 5c 2d 55 |:.X.D(.X|rcs  \-U|
|00001fe0| 20 20 66 2e 63 20 20 20 | 20 20 20 20 5c 66 52 61 |  f.c   |    \fRa|
|00001ff0| 6e 64 5c 66 50 20 20 20 | 20 20 20 20 20 20 72 63 |nd\fP   |      rc|
|00002000| 73 20 20 5c 2d 4c 20 20 | 66 2e 63 0a 58 2e 44 29 |s  \-L  |f.c.X.D)|
|00002010| 0a 58 54 68 65 73 65 20 | 63 6f 6d 6d 61 6e 64 73 |.XThese |commands|
|00002020| 20 65 6e 61 62 6c 65 20 | 6f 72 20 64 69 73 61 62 | enable |or disab|
|00002030| 6c 65 20 74 68 65 20 73 | 74 72 69 63 74 20 6c 6f |le the s|trict lo|
|00002040| 63 6b 69 6e 67 20 66 65 | 61 74 75 72 65 20 66 6f |cking fe|ature fo|
|00002050| 72 20 65 61 63 68 20 52 | 43 53 20 66 69 6c 65 0a |r each R|CS file.|
|00002060| 58 69 6e 64 69 76 69 64 | 75 61 6c 6c 79 2e 0a 58 |Xindivid|ually..X|
|00002070| 54 68 65 20 73 79 73 74 | 65 6d 20 61 64 6d 69 6e |The syst|em admin|
|00002080| 69 73 74 72 61 74 6f 72 | 20 6f 6e 6c 79 20 64 65 |istrator| only de|
|00002090| 63 69 64 65 73 20 77 68 | 65 74 68 65 72 20 73 74 |cides wh|ether st|
|000020a0| 72 69 63 74 20 6c 6f 63 | 6b 69 6e 67 20 69 73 0a |rict loc|king is.|
|000020b0| 58 65 6e 61 62 6c 65 64 | 20 69 6e 69 74 69 61 6c |Xenabled| initial|
|000020c0| 6c 79 2e 0a 58 2e 50 50 | 0a 58 54 6f 20 72 65 64 |ly..X.PP|.XTo red|
|000020d0| 75 63 65 20 74 68 65 20 | 63 6c 75 74 74 65 72 20 |uce the |clutter |
|000020e0| 69 6e 20 61 20 77 6f 72 | 6b 69 6e 67 20 64 69 72 |in a wor|king dir|
|000020f0| 65 63 74 6f 72 79 2c 20 | 61 6c 6c 20 52 43 53 20 |ectory, |all RCS |
|00002100| 66 69 6c 65 73 20 63 61 | 6e 20 62 65 20 6d 6f 76 |files ca|n be mov|
|00002110| 65 64 0a 58 74 6f 20 61 | 20 73 75 62 64 69 72 65 |ed.Xto a| subdire|
|00002120| 63 74 6f 72 79 20 77 69 | 74 68 20 74 68 65 20 6e |ctory wi|th the n|
|00002130| 61 6d 65 20 5c 66 49 52 | 43 53 5c 66 52 2e 0a 58 |ame \fIR|CS\fR..X|
|00002140| 52 43 53 20 63 6f 6d 6d | 61 6e 64 73 20 6c 6f 6f |RCS comm|ands loo|
|00002150| 6b 20 66 69 72 73 74 20 | 69 6e 74 6f 20 74 68 61 |k first |into tha|
|00002160| 74 20 64 69 72 65 63 74 | 6f 72 79 20 66 6f 72 20 |t direct|ory for |
|00002170| 52 43 53 20 66 69 6c 65 | 73 2e 0a 58 41 6c 6c 20 |RCS file|s..XAll |
|00002180| 74 68 65 20 63 6f 6d 6d | 61 6e 64 73 20 70 72 65 |the comm|ands pre|
|00002190| 73 65 6e 74 65 64 20 61 | 62 6f 76 65 20 77 6f 72 |sented a|bove wor|
|000021a0| 6b 0a 58 77 69 74 68 20 | 74 68 65 20 5c 66 49 52 |k.Xwith |the \fIR|
|000021b0| 43 53 5c 66 52 20 73 75 | 62 64 69 72 65 63 74 6f |CS\fR su|bdirecto|
|000021c0| 72 79 20 77 69 74 68 6f | 75 74 20 63 68 61 6e 67 |ry witho|ut chang|
|000021d0| 65 2e 5c 28 64 67 0a 58 | 2e 46 53 20 5c 28 64 67 |e.\(dg.X|.FS \(dg|
|000021e0| 0a 58 50 61 69 72 73 20 | 6f 66 20 52 43 53 20 61 |.XPairs |of RCS a|
|000021f0| 6e 64 20 77 6f 72 6b 69 | 6e 67 20 66 69 6c 65 73 |nd worki|ng files|
|00002200| 20 63 61 6e 20 61 63 74 | 75 61 6c 6c 79 20 62 65 | can act|ually be|
|00002210| 20 73 70 65 63 69 66 69 | 65 64 20 69 6e 20 33 20 | specifi|ed in 3 |
|00002220| 77 61 79 73 3a 0a 58 61 | 29 20 62 6f 74 68 20 61 |ways:.Xa|) both a|
|00002230| 72 65 20 67 69 76 65 6e | 2c 20 62 29 20 6f 6e 6c |re given|, b) onl|
|00002240| 79 20 74 68 65 20 77 6f | 72 6b 69 6e 67 20 66 69 |y the wo|rking fi|
|00002250| 6c 65 20 69 73 20 67 69 | 76 65 6e 2c 20 63 29 20 |le is gi|ven, c) |
|00002260| 6f 6e 6c 79 20 74 68 65 | 0a 58 52 43 53 20 66 69 |only the|.XRCS fi|
|00002270| 6c 65 20 69 73 20 67 69 | 76 65 6e 2e 0a 58 49 66 |le is gi|ven..XIf|
|00002280| 20 61 20 70 61 69 72 20 | 69 73 20 67 69 76 65 6e | a pair |is given|
|00002290| 2c 20 62 6f 74 68 20 66 | 69 6c 65 73 20 6d 61 79 |, both f|iles may|
|000022a0| 20 68 61 76 65 20 61 72 | 62 69 74 72 61 72 79 20 | have ar|bitrary |
|000022b0| 70 61 74 68 20 70 72 65 | 66 69 78 65 73 3b 0a 58 |path pre|fixes;.X|
|000022c0| 52 43 53 20 63 6f 6d 6d | 61 6e 64 73 20 70 61 69 |RCS comm|ands pai|
|000022d0| 72 20 74 68 65 6d 20 75 | 70 20 69 6e 74 65 6c 6c |r them u|p intell|
|000022e0| 69 67 65 6e 74 6c 79 2e | 0a 58 2e 46 45 0a 58 2e |igently.|.X.FE.X.|
|000022f0| 50 50 0a 58 49 74 20 6d | 61 79 20 62 65 20 75 6e |PP.XIt m|ay be un|
|00002300| 64 65 73 69 72 61 62 6c | 65 20 74 68 61 74 20 5c |desirabl|e that \|
|00002310| 66 49 63 69 5c 66 52 20 | 64 65 6c 65 74 65 73 20 |fIci\fR |deletes |
|00002320| 74 68 65 20 77 6f 72 6b | 69 6e 67 20 66 69 6c 65 |the work|ing file|
|00002330| 2e 0a 58 46 6f 72 20 69 | 6e 73 74 61 6e 63 65 2c |..XFor i|nstance,|
|00002340| 20 73 6f 6d 65 74 69 6d | 65 73 20 6f 6e 65 20 77 | sometim|es one w|
|00002350| 6f 75 6c 64 20 6c 69 6b | 65 20 74 6f 20 73 61 76 |ould lik|e to sav|
|00002360| 65 20 74 68 65 20 63 75 | 72 72 65 6e 74 20 72 65 |e the cu|rrent re|
|00002370| 76 69 73 69 6f 6e 2c 0a | 58 62 75 74 20 63 6f 6e |vision,.|Xbut con|
|00002380| 74 69 6e 75 65 20 65 64 | 69 74 69 6e 67 2e 0a 58 |tinue ed|iting..X|
|00002390| 49 6e 76 6f 6b 69 6e 67 | 0a 58 2e 44 28 0a 58 63 |Invoking|.X.D(.Xc|
|000023a0| 69 20 20 5c 2d 6c 20 20 | 66 2e 63 0a 58 2e 44 29 |i  \-l  |f.c.X.D)|
|000023b0| 0a 58 63 68 65 63 6b 73 | 20 69 6e 20 5c 66 49 66 |.Xchecks| in \fIf|
|000023c0| 2e 63 5c 66 52 20 61 73 | 20 75 73 75 61 6c 2c 20 |.c\fR as| usual, |
|000023d0| 62 75 74 20 70 65 72 66 | 6f 72 6d 73 20 61 6e 20 |but perf|orms an |
|000023e0| 61 64 64 69 74 69 6f 6e | 61 6c 0a 58 63 68 65 63 |addition|al.Xchec|
|000023f0| 6b 2d 6f 75 74 20 77 69 | 74 68 20 6c 6f 63 6b 69 |k-out wi|th locki|
|00002400| 6e 67 20 61 66 74 65 72 | 77 61 72 64 73 2e 20 20 |ng after|wards.  |
|00002410| 54 68 75 73 2c 20 74 68 | 65 20 77 6f 72 6b 69 6e |Thus, th|e workin|
|00002420| 67 20 66 69 6c 65 20 64 | 6f 65 73 0a 58 6e 6f 74 |g file d|oes.Xnot|
|00002430| 20 64 69 73 61 70 70 65 | 61 72 20 61 66 74 65 72 | disappe|ar after|
|00002440| 20 74 68 65 20 63 68 65 | 63 6b 2d 69 6e 2e 0a 58 | the che|ck-in..X|
|00002450| 53 69 6d 69 6c 61 72 6c | 79 2c 20 74 68 65 20 6f |Similarl|y, the o|
|00002460| 70 74 69 6f 6e 0a 58 5c | 66 49 5c 2d 75 5c 66 52 |ption.X\|fI\-u\fR|
|00002470| 20 64 6f 65 73 20 61 20 | 63 68 65 63 6b 2d 69 6e | does a |check-in|
|00002480| 20 66 6f 6c 6c 6f 77 65 | 64 20 62 79 20 61 20 63 | followe|d by a c|
|00002490| 68 65 63 6b 2d 6f 75 74 | 20 77 69 74 68 6f 75 74 |heck-out| without|
|000024a0| 0a 58 6c 6f 63 6b 69 6e | 67 2e 20 20 54 68 69 73 |.Xlockin|g.  This|
|000024b0| 20 6f 70 74 69 6f 6e 20 | 69 73 20 75 73 65 66 75 | option |is usefu|
|000024c0| 6c 20 69 66 20 74 68 65 | 20 66 69 6c 65 20 69 73 |l if the| file is|
|000024d0| 20 6e 65 65 64 65 64 20 | 66 6f 72 20 63 6f 6d 70 | needed |for comp|
|000024e0| 69 6c 61 74 69 6f 6e 20 | 61 66 74 65 72 20 74 68 |ilation |after th|
|000024f0| 65 20 63 68 65 63 6b 2d | 69 6e 2e 0a 58 42 6f 74 |e check-|in..XBot|
|00002500| 68 20 6f 70 74 69 6f 6e | 73 20 75 70 64 61 74 65 |h option|s update|
|00002510| 20 74 68 65 20 69 64 65 | 6e 74 69 66 69 63 61 74 | the ide|ntificat|
|00002520| 69 6f 6e 20 6d 61 72 6b | 65 72 73 20 69 6e 20 74 |ion mark|ers in t|
|00002530| 68 65 20 77 6f 72 6b 69 | 6e 67 20 66 69 6c 65 0a |he worki|ng file.|
|00002540| 58 28 73 65 65 20 62 65 | 6c 6f 77 29 2e 0a 58 2e |X(see be|low)..X.|
|00002550| 50 50 0a 58 42 65 73 69 | 64 65 73 20 74 68 65 20 |PP.XBesi|des the |
|00002560| 6f 70 65 72 61 74 69 6f | 6e 73 20 5c 66 49 63 69 |operatio|ns \fIci|
|00002570| 5c 66 52 20 61 6e 64 20 | 5c 66 49 63 6f 5c 66 52 |\fR and |\fIco\fR|
|00002580| 2c 20 52 43 53 20 70 72 | 6f 76 69 64 65 73 20 74 |, RCS pr|ovides t|
|00002590| 68 65 20 66 6f 6c 6c 6f | 77 69 6e 67 0a 58 63 6f |he follo|wing.Xco|
|000025a0| 6d 6d 61 6e 64 73 3a 0a | 58 2e 73 70 20 30 0a 58 |mmands:.|X.sp 0.X|
|000025b0| 2e 6e 72 20 56 53 20 31 | 32 70 0a 58 2e 76 73 20 |.nr VS 1|2p.X.vs |
|000025c0| 31 32 70 0a 58 2e 54 53 | 0a 58 74 61 62 28 25 29 |12p.X.TS|.Xtab(%)|
|000025d0| 3b 0a 58 6c 69 20 6c 2e | 0a 58 69 64 65 6e 74 25 |;.Xli l.|.Xident%|
|000025e0| 65 78 74 72 61 63 74 20 | 69 64 65 6e 74 69 66 69 |extract |identifi|
|000025f0| 63 61 74 69 6f 6e 20 6d | 61 72 6b 65 72 73 0a 58 |cation m|arkers.X|
|00002600| 72 63 73 25 63 68 61 6e | 67 65 20 52 43 53 20 66 |rcs%chan|ge RCS f|
|00002610| 69 6c 65 20 61 74 74 72 | 69 62 75 74 65 73 0a 58 |ile attr|ibutes.X|
|00002620| 72 63 73 63 6c 65 61 6e | 25 72 65 6d 6f 76 65 20 |rcsclean|%remove |
|00002630| 75 6e 63 68 61 6e 67 65 | 64 20 77 6f 72 6b 69 6e |unchange|d workin|
|00002640| 67 20 66 69 6c 65 73 20 | 28 6f 70 74 69 6f 6e 61 |g files |(optiona|
|00002650| 6c 29 0a 58 72 63 73 64 | 69 66 66 25 63 6f 6d 70 |l).Xrcsd|iff%comp|
|00002660| 61 72 65 20 72 65 76 69 | 73 69 6f 6e 73 0a 58 72 |are revi|sions.Xr|
|00002670| 63 73 66 72 65 65 7a 65 | 25 72 65 63 6f 72 64 20 |csfreeze|%record |
|00002680| 61 20 63 6f 6e 66 69 67 | 75 72 61 74 69 6f 6e 20 |a config|uration |
|00002690| 28 6f 70 74 69 6f 6e 61 | 6c 29 0a 58 72 63 73 6d |(optiona|l).Xrcsm|
|000026a0| 65 72 67 65 25 6d 65 72 | 67 65 20 72 65 76 69 73 |erge%mer|ge revis|
|000026b0| 69 6f 6e 73 0a 58 72 6c | 6f 67 25 72 65 61 64 20 |ions.Xrl|og%read |
|000026c0| 6c 6f 67 20 6d 65 73 73 | 61 67 65 73 20 61 6e 64 |log mess|ages and|
|000026d0| 20 6f 74 68 65 72 20 69 | 6e 66 6f 72 6d 61 74 69 | other i|nformati|
|000026e0| 6f 6e 20 69 6e 20 52 43 | 53 20 66 69 6c 65 73 0a |on in RC|S files.|
|000026f0| 58 2e 54 45 0a 58 41 20 | 73 79 6e 6f 70 73 69 73 |X.TE.XA |synopsis|
|00002700| 20 6f 66 20 74 68 65 73 | 65 20 63 6f 6d 6d 61 6e | of thes|e comman|
|00002710| 64 73 20 61 70 70 65 61 | 72 73 20 69 6e 20 74 68 |ds appea|rs in th|
|00002720| 65 20 41 70 70 65 6e 64 | 69 78 2e 0a 58 2e 4e 48 |e Append|ix..X.NH|
|00002730| 20 32 0a 58 41 75 74 6f | 6d 61 74 69 63 20 49 64 | 2.XAuto|matic Id|
|00002740| 65 6e 74 69 66 69 63 61 | 74 69 6f 6e 0a 58 2e 50 |entifica|tion.X.P|
|00002750| 50 0a 58 52 43 53 20 63 | 61 6e 20 73 74 61 6d 70 |P.XRCS c|an stamp|
|00002760| 20 73 6f 75 72 63 65 20 | 61 6e 64 20 6f 62 6a 65 | source |and obje|
|00002770| 63 74 20 63 6f 64 65 20 | 77 69 74 68 20 73 70 65 |ct code |with spe|
|00002780| 63 69 61 6c 20 69 64 65 | 6e 74 69 66 69 63 61 74 |cial ide|ntificat|
|00002790| 69 6f 6e 20 73 74 72 69 | 6e 67 73 2c 0a 58 73 69 |ion stri|ngs,.Xsi|
|000027a0| 6d 69 6c 61 72 20 74 6f | 20 70 72 6f 64 75 63 74 |milar to| product|
|000027b0| 20 61 6e 64 20 73 65 72 | 69 61 6c 20 6e 75 6d 62 | and ser|ial numb|
|000027c0| 65 72 73 2e 0a 58 54 6f | 20 6f 62 74 61 69 6e 20 |ers..XTo| obtain |
|000027d0| 73 75 63 68 20 69 64 65 | 6e 74 69 66 69 63 61 74 |such ide|ntificat|
|000027e0| 69 6f 6e 2c 20 70 6c 61 | 63 65 20 74 68 65 20 6d |ion, pla|ce the m|
|000027f0| 61 72 6b 65 72 0a 58 2e | 44 28 0a 58 5c 2a 73 49 |arker.X.|D(.X\*sI|
|00002800| 64 5c 2a 73 0a 58 2e 44 | 29 0a 58 69 6e 74 6f 20 |d\*s.X.D|).Xinto |
|00002810| 74 68 65 20 74 65 78 74 | 20 6f 66 20 61 20 72 65 |the text| of a re|
|00002820| 76 69 73 69 6f 6e 2c 20 | 66 6f 72 20 69 6e 73 74 |vision, |for inst|
|00002830| 61 6e 63 65 20 69 6e 73 | 69 64 65 20 61 20 63 6f |ance ins|ide a co|
|00002840| 6d 6d 65 6e 74 2e 0a 58 | 54 68 65 20 63 68 65 63 |mment..X|The chec|
|00002850| 6b 2d 6f 75 74 20 6f 70 | 65 72 61 74 69 6f 6e 20 |k-out op|eration |
|00002860| 77 69 6c 6c 20 72 65 70 | 6c 61 63 65 20 74 68 69 |will rep|lace thi|
|00002870| 73 20 6d 61 72 6b 65 72 | 20 77 69 74 68 20 61 20 |s marker| with a |
|00002880| 73 74 72 69 6e 67 20 6f | 66 20 74 68 65 20 66 6f |string o|f the fo|
|00002890| 72 6d 0a 58 2e 44 28 0a | 58 5c 2a 73 49 64 3a 20 |rm.X.D(.|X\*sId: |
|000028a0| 20 66 69 6c 65 6e 61 6d | 65 20 20 72 65 76 69 73 | filenam|e  revis|
|000028b0| 69 6f 6e 6e 75 6d 62 65 | 72 20 20 64 61 74 65 20 |ionnumbe|r  date |
|000028c0| 20 74 69 6d 65 20 20 61 | 75 74 68 6f 72 20 20 73 | time  a|uthor  s|
|000028d0| 74 61 74 65 20 20 6c 6f | 63 6b 65 72 20 5c 2a 73 |tate  lo|cker \*s|
|000028e0| 0a 58 2e 44 29 0a 58 54 | 68 69 73 20 73 74 72 69 |.X.D).XT|his stri|
|000028f0| 6e 67 20 6e 65 65 64 20 | 6e 65 76 65 72 20 62 65 |ng need |never be|
|00002900| 20 74 6f 75 63 68 65 64 | 2c 20 62 65 63 61 75 73 | touched|, becaus|
|00002910| 65 20 5c 66 49 63 6f 5c | 66 52 20 6b 65 65 70 73 |e \fIco\|fR keeps|
|00002920| 20 69 74 0a 58 75 70 20 | 74 6f 20 64 61 74 65 20 | it.Xup |to date |
|00002930| 61 75 74 6f 6d 61 74 69 | 63 61 6c 6c 79 2e 0a 58 |automati|cally..X|
|00002940| 54 6f 20 70 72 6f 70 61 | 67 61 74 65 20 74 68 65 |To propa|gate the|
|00002950| 20 6d 61 72 6b 65 72 20 | 69 6e 74 6f 20 6f 62 6a | marker |into obj|
|00002960| 65 63 74 20 63 6f 64 65 | 2c 20 73 69 6d 70 6c 79 |ect code|, simply|
|00002970| 20 70 75 74 0a 58 69 74 | 20 69 6e 74 6f 20 61 20 | put.Xit| into a |
|00002980| 6c 69 74 65 72 61 6c 20 | 63 68 61 72 61 63 74 65 |literal |characte|
|00002990| 72 20 73 74 72 69 6e 67 | 2e 20 20 49 6e 20 43 2c |r string|.  In C,|
|000029a0| 20 74 68 69 73 20 69 73 | 20 64 6f 6e 65 20 61 73 | this is| done as|
|000029b0| 20 66 6f 6c 6c 6f 77 73 | 3a 0a 58 2e 44 28 0a 58 | follows|:.X.D(.X|
|000029c0| 73 74 61 74 69 63 20 63 | 68 61 72 20 72 63 73 69 |static c|har rcsi|
|000029d0| 64 5b 5d 20 3d 20 5c 26 | 22 5c 2a 73 49 64 5c 2a |d[] = \&|"\*sId\*|
|000029e0| 73 5c 26 22 3b 0a 58 2e | 44 29 0a 58 54 68 65 20 |s\&";.X.|D).XThe |
|000029f0| 63 6f 6d 6d 61 6e 64 20 | 5c 66 49 69 64 65 6e 74 |command |\fIident|
|00002a00| 5c 66 52 20 65 78 74 72 | 61 63 74 73 20 73 75 63 |\fR extr|acts suc|
|00002a10| 68 20 6d 61 72 6b 65 72 | 73 20 66 72 6f 6d 20 61 |h marker|s from a|
|00002a20| 6e 79 20 66 69 6c 65 2c | 20 69 6e 20 70 61 72 74 |ny file,| in part|
|00002a30| 69 63 75 6c 61 72 20 66 | 72 6f 6d 0a 58 6f 62 6a |icular f|rom.Xobj|
|00002a40| 65 63 74 20 63 6f 64 65 | 2e 0a 58 5c 66 49 49 64 |ect code|..X\fIId|
|00002a50| 65 6e 74 5c 66 52 20 68 | 65 6c 70 73 20 74 6f 20 |ent\fR h|elps to |
|00002a60| 66 69 6e 64 20 6f 75 74 | 0a 58 77 68 69 63 68 20 |find out|.Xwhich |
|00002a70| 72 65 76 69 73 69 6f 6e | 73 20 6f 66 20 77 68 69 |revision|s of whi|
|00002a80| 63 68 20 6d 6f 64 75 6c | 65 73 20 77 65 72 65 20 |ch modul|es were |
|00002a90| 75 73 65 64 20 69 6e 20 | 61 20 67 69 76 65 6e 20 |used in |a given |
|00002aa0| 70 72 6f 67 72 61 6d 2e | 0a 58 49 74 20 72 65 74 |program.|.XIt ret|
|00002ab0| 75 72 6e 73 20 61 20 63 | 6f 6d 70 6c 65 74 65 20 |urns a c|omplete |
|00002ac0| 61 6e 64 20 75 6e 61 6d | 62 69 67 75 6f 75 73 20 |and unam|biguous |
|00002ad0| 63 6f 6d 70 6f 6e 65 6e | 74 20 6c 69 73 74 2c 0a |componen|t list,.|
|00002ae0| 58 66 72 6f 6d 20 77 68 | 69 63 68 20 61 20 63 6f |Xfrom wh|ich a co|
|00002af0| 70 79 20 6f 66 20 74 68 | 65 20 70 72 6f 67 72 61 |py of th|e progra|
|00002b00| 6d 20 63 61 6e 20 62 65 | 20 72 65 63 6f 6e 73 74 |m can be| reconst|
|00002b10| 72 75 63 74 65 64 2e 0a | 58 54 68 69 73 20 66 61 |ructed..|XThis fa|
|00002b20| 63 69 6c 69 74 79 20 69 | 73 20 69 6e 76 61 6c 75 |cility i|s invalu|
|00002b30| 61 62 6c 65 20 66 6f 72 | 20 70 72 6f 67 72 61 6d |able for| program|
|00002b40| 20 6d 61 69 6e 74 65 6e | 61 6e 63 65 2e 0a 58 2e | mainten|ance..X.|
|00002b50| 50 50 0a 58 54 68 65 72 | 65 20 61 72 65 20 73 65 |PP.XTher|e are se|
|00002b60| 76 65 72 61 6c 20 61 64 | 64 69 74 69 6f 6e 61 6c |veral ad|ditional|
|00002b70| 20 69 64 65 6e 74 69 66 | 69 63 61 74 69 6f 6e 20 | identif|ication |
|00002b80| 6d 61 72 6b 65 72 73 2c | 20 6f 6e 65 20 66 6f 72 |markers,| one for|
|00002b90| 20 65 61 63 68 20 63 6f | 6d 70 6f 6e 65 6e 74 0a | each co|mponent.|
|00002ba0| 58 6f 66 20 5c 2a 73 49 | 64 5c 2a 73 2e 0a 58 54 |Xof \*sI|d\*s..XT|
|00002bb0| 68 65 20 6d 61 72 6b 65 | 72 0a 58 2e 44 28 0a 58 |he marke|r.X.D(.X|
|00002bc0| 5c 2a 73 4c 6f 67 5c 2a | 73 0a 58 2e 44 29 0a 58 |\*sLog\*|s.X.D).X|
|00002bd0| 68 61 73 20 61 20 73 69 | 6d 69 6c 61 72 20 66 75 |has a si|milar fu|
|00002be0| 6e 63 74 69 6f 6e 2e 20 | 20 49 74 20 61 63 63 75 |nction. | It accu|
|00002bf0| 6d 75 6c 61 74 65 73 0a | 58 74 68 65 20 6c 6f 67 |mulates.|Xthe log|
|00002c00| 20 6d 65 73 73 61 67 65 | 73 20 74 68 61 74 20 61 | message|s that a|
|00002c10| 72 65 20 72 65 71 75 65 | 73 74 65 64 20 64 75 72 |re reque|sted dur|
|00002c20| 69 6e 67 20 63 68 65 63 | 6b 2d 69 6e 2e 0a 58 54 |ing chec|k-in..XT|
|00002c30| 68 75 73 2c 20 6f 6e 65 | 20 63 61 6e 20 6d 61 69 |hus, one| can mai|
|00002c40| 6e 74 61 69 6e 20 74 68 | 65 20 63 6f 6d 70 6c 65 |ntain th|e comple|
|00002c50| 74 65 20 68 69 73 74 6f | 72 79 20 6f 66 20 61 20 |te histo|ry of a |
|00002c60| 72 65 76 69 73 69 6f 6e | 20 64 69 72 65 63 74 6c |revision| directl|
|00002c70| 79 20 69 6e 73 69 64 65 | 20 69 74 2c 0a 58 62 79 |y inside| it,.Xby|
|00002c80| 20 65 6e 63 6c 6f 73 69 | 6e 67 20 69 74 20 69 6e | enclosi|ng it in|
|00002c90| 20 61 20 63 6f 6d 6d 65 | 6e 74 2e 0a 58 46 69 67 | a comme|nt..XFig|
|00002ca0| 75 72 65 20 31 20 69 73 | 20 61 20 70 61 72 74 69 |ure 1 is| a parti|
|00002cb0| 61 6c 20 72 65 70 72 6f | 64 75 63 74 69 6f 6e 20 |al repro|duction |
|00002cc0| 6f 66 20 61 20 6c 6f 67 | 20 63 6f 6e 74 61 69 6e |of a log| contain|
|00002cd0| 65 64 20 69 6e 20 72 65 | 76 69 73 69 6f 6e 20 34 |ed in re|vision 4|
|00002ce0| 2e 31 20 6f 66 0a 58 74 | 68 65 20 66 69 6c 65 20 |.1 of.Xt|he file |
|00002cf0| 5c 66 49 63 69 2e 63 5c | 66 52 2e 20 20 54 68 65 |\fIci.c\|fR.  The|
|00002d00| 20 6c 6f 67 20 61 70 70 | 65 61 72 73 20 61 74 20 | log app|ears at |
|00002d10| 74 68 65 20 62 65 67 69 | 6e 6e 69 6e 67 20 6f 66 |the begi|nning of|
|00002d20| 20 74 68 65 20 66 69 6c | 65 2c 0a 58 61 6e 64 20 | the fil|e,.Xand |
|00002d30| 6d 61 6b 65 73 20 69 74 | 20 65 61 73 79 20 74 6f |makes it| easy to|
|00002d40| 20 64 65 74 65 72 6d 69 | 6e 65 20 77 68 61 74 20 | determi|ne what |
|00002d50| 74 68 65 20 72 65 63 65 | 6e 74 20 6d 6f 64 69 66 |the rece|nt modif|
|00002d60| 69 63 61 74 69 6f 6e 73 | 20 77 65 72 65 2e 0a 58 |ications| were..X|
|00002d70| 2e 73 70 0a 58 2e 6e 72 | 20 56 53 20 31 32 70 0a |.sp.X.nr| VS 12p.|
|00002d80| 58 2e 76 73 20 31 32 70 | 0a 58 2e 6e 65 20 31 38 |X.vs 12p|.X.ne 18|
|00002d90| 0a 58 2e 6e 66 0a 58 2e | 69 6e 20 2b 30 2e 35 69 |.X.nf.X.|in +0.5i|
|00002da0| 0a 58 2f 2a 20 5c 2a 73 | 4c 6f 67 3a 20 63 69 2e |.X/* \*s|Log: ci.|
|00002db0| 63 2c 76 20 5c 2a 73 0a | 58 20 2a 20 52 65 76 69 |c,v \*s.|X * Revi|
|00002dc0| 73 69 6f 6e 20 34 2e 31 | 20 20 31 39 38 33 2f 30 |sion 4.1|  1983/0|
|00002dd0| 35 2f 31 30 20 20 31 37 | 3a 30 33 3a 30 36 20 20 |5/10  17|:03:06  |
|00002de0| 77 66 74 0a 58 20 2a 20 | 41 64 64 65 64 20 6f 70 |wft.X * |Added op|
|00002df0| 74 69 6f 6e 20 5c 2d 64 | 20 61 6e 64 20 5c 2d 77 |tion \-d| and \-w|
|00002e00| 2c 20 61 6e 64 20 75 70 | 64 61 74 65 64 20 61 73 |, and up|dated as|
|00002e10| 73 69 67 6e 6d 65 6e 74 | 20 6f 66 20 64 61 74 65 |signment| of date|
|00002e20| 2c 20 65 74 63 2e 20 74 | 6f 20 6e 65 77 20 64 65 |, etc. t|o new de|
|00002e30| 6c 74 61 2e 0a 58 20 2a | 20 41 64 64 65 64 20 68 |lta..X *| Added h|
|00002e40| 61 6e 64 6c 69 6e 67 20 | 6f 66 20 64 65 66 61 75 |andling |of defau|
|00002e50| 6c 74 20 62 72 61 6e 63 | 68 65 73 2e 0a 58 20 2a |lt branc|hes..X *|
|00002e60| 0a 58 20 2a 20 52 65 76 | 69 73 69 6f 6e 20 33 2e |.X * Rev|ision 3.|
|00002e70| 39 20 20 31 39 38 33 2f | 30 32 2f 31 35 20 20 31 |9  1983/|02/15  1|
|00002e80| 35 3a 32 35 3a 34 34 20 | 20 77 66 74 0a 58 20 2a |5:25:44 | wft.X *|
|00002e90| 20 41 64 64 65 64 20 63 | 61 6c 6c 20 74 6f 20 66 | Added c|all to f|
|00002ea0| 61 73 74 63 6f 70 79 28 | 29 20 74 6f 20 63 6f 70 |astcopy(|) to cop|
|00002eb0| 79 20 72 65 6d 61 69 6e | 64 65 72 20 6f 66 20 52 |y remain|der of R|
|00002ec0| 43 53 20 66 69 6c 65 2e | 0a 58 20 2a 0a 58 20 2a |CS file.|.X *.X *|
|00002ed0| 20 52 65 76 69 73 69 6f | 6e 20 33 2e 38 20 20 31 | Revisio|n 3.8  1|
|00002ee0| 39 38 33 2f 30 31 2f 31 | 34 20 20 31 35 3a 33 34 |983/01/1|4  15:34|
|00002ef0| 3a 30 35 20 20 77 66 74 | 0a 58 20 2a 20 41 64 64 |:05  wft|.X * Add|
|00002f00| 65 64 20 69 67 6e 6f 72 | 69 6e 67 20 6f 66 20 69 |ed ignor|ing of i|
|00002f10| 6e 74 65 72 72 75 70 74 | 73 20 77 68 69 6c 65 20 |nterrupt|s while |
|00002f20| 6e 65 77 20 52 43 53 20 | 66 69 6c 65 20 69 73 20 |new RCS |file is |
|00002f30| 72 65 6e 61 6d 65 64 3b | 0a 58 20 2a 20 61 76 6f |renamed;|.X * avo|
|00002f40| 69 64 73 20 64 65 6c 65 | 74 69 6f 6e 20 6f 66 20 |ids dele|tion of |
|00002f50| 52 43 53 20 66 69 6c 65 | 73 20 62 79 20 69 6e 74 |RCS file|s by int|
|00002f60| 65 72 72 75 70 74 73 2e | 0a 58 20 2a 0a 58 20 2a |errupts.|.X *.X *|
|00002f70| 20 52 65 76 69 73 69 6f | 6e 20 33 2e 37 20 20 31 | Revisio|n 3.7  1|
|00002f80| 39 38 32 2f 31 32 2f 31 | 30 20 20 31 36 3a 30 39 |982/12/1|0  16:09|
|00002f90| 3a 32 30 20 20 77 66 74 | 0a 58 20 2a 20 43 6f 72 |:20  wft|.X * Cor|
|00002fa0| 72 65 63 74 65 64 20 63 | 68 65 63 6b 69 6e 67 20 |rected c|hecking |
|00002fb0| 6f 66 20 72 65 74 75 72 | 6e 20 63 6f 64 65 20 66 |of retur|n code f|
|00002fc0| 72 6f 6d 20 64 69 66 66 | 2e 0a 58 20 2a 20 41 6e |rom diff|..X * An|
|00002fd0| 20 52 43 53 20 66 69 6c | 65 20 6e 6f 77 20 69 6e | RCS fil|e now in|
|00002fe0| 68 65 72 69 74 73 20 69 | 74 73 20 6d 6f 64 65 20 |herits i|ts mode |
|00002ff0| 64 75 72 69 6e 67 20 74 | 68 65 20 66 69 72 73 74 |during t|he first|
|00003000| 20 63 69 20 66 72 6f 6d | 20 74 68 65 20 77 6f 72 | ci from| the wor|
|00003010| 6b 69 6e 67 20 66 69 6c | 65 2c 0a 58 20 2a 20 65 |king fil|e,.X * e|
|00003020| 78 63 65 70 74 20 74 68 | 61 74 20 77 72 69 74 65 |xcept th|at write|
|00003030| 20 70 65 72 6d 69 73 73 | 69 6f 6e 20 69 73 20 72 | permiss|ion is r|
|00003040| 65 6d 6f 76 65 64 2e 0a | 58 20 2a 2f 0a 58 2e 69 |emoved..|X */.X.i|
|00003050| 6e 20 30 0a 58 2e 63 65 | 20 31 0a 58 46 69 67 75 |n 0.X.ce| 1.XFigu|
|00003060| 72 65 20 31 2e 20 20 4c | 6f 67 20 65 6e 74 72 69 |re 1.  L|og entri|
|00003070| 65 73 20 70 72 6f 64 75 | 63 65 64 20 62 79 20 74 |es produ|ced by t|
|00003080| 68 65 20 6d 61 72 6b 65 | 72 20 5c 2a 73 4c 6f 67 |he marke|r \*sLog|
|00003090| 5c 2a 73 2e 0a 58 2e 66 | 69 0a 58 2e 6e 72 20 56 |\*s..X.f|i.X.nr V|
|000030a0| 53 20 31 38 70 0a 58 2e | 76 73 20 31 38 70 0a 58 |S 18p.X.|vs 18p.X|
|000030b0| 2e 73 70 20 30 0a 58 2e | 4c 50 0a 58 53 69 6e 63 |.sp 0.X.|LP.XSinc|
|000030c0| 65 20 72 65 76 69 73 69 | 6f 6e 73 20 61 72 65 20 |e revisi|ons are |
|000030d0| 73 74 6f 72 65 64 20 69 | 6e 20 74 68 65 20 66 6f |stored i|n the fo|
|000030e0| 72 6d 20 6f 66 20 64 69 | 66 66 65 72 65 6e 63 65 |rm of di|fference|
|000030f0| 73 2c 0a 58 65 61 63 68 | 20 6c 6f 67 20 6d 65 73 |s,.Xeach| log mes|
|00003100| 73 61 67 65 20 69 73 0a | 58 70 68 79 73 69 63 61 |sage is.|Xphysica|
|00003110| 6c 6c 79 20 73 74 6f 72 | 65 64 20 6f 6e 63 65 2c |lly stor|ed once,|
|00003120| 0a 58 69 6e 64 65 70 65 | 6e 64 65 6e 74 20 6f 66 |.Xindepe|ndent of|
|00003130| 20 74 68 65 20 6e 75 6d | 62 65 72 20 6f 66 20 72 | the num|ber of r|
|00003140| 65 76 69 73 69 6f 6e 73 | 20 70 72 65 73 65 6e 74 |evisions| present|
|00003150| 2e 0a 58 54 68 75 73 2c | 20 74 68 65 20 5c 2a 73 |..XThus,| the \*s|
|00003160| 4c 6f 67 5c 2a 73 20 6d | 61 72 6b 65 72 20 69 6e |Log\*s m|arker in|
|00003170| 63 75 72 73 20 6e 65 67 | 6c 69 67 69 62 6c 65 20 |curs neg|ligible |
|00003180| 73 70 61 63 65 20 6f 76 | 65 72 68 65 61 64 2e 0a |space ov|erhead..|
|00003190| 58 2e 4e 48 0a 58 54 68 | 65 20 52 43 53 20 52 65 |X.NH.XTh|e RCS Re|
|000031a0| 76 69 73 69 6f 6e 20 54 | 72 65 65 0a 58 2e 50 50 |vision T|ree.X.PP|
|000031b0| 0a 58 52 43 53 20 61 72 | 72 61 6e 67 65 73 20 72 |.XRCS ar|ranges r|
|000031c0| 65 76 69 73 69 6f 6e 73 | 20 69 6e 20 61 6e 20 61 |evisions| in an a|
|000031d0| 6e 63 65 73 74 72 61 6c | 20 74 72 65 65 2e 0a 58 |ncestral| tree..X|
|000031e0| 54 68 65 20 5c 66 49 63 | 69 5c 66 52 20 63 6f 6d |The \fIc|i\fR com|
|000031f0| 6d 61 6e 64 20 62 75 69 | 6c 64 73 20 74 68 69 73 |mand bui|lds this|
|00003200| 20 74 72 65 65 3b 20 74 | 68 65 20 61 75 78 69 6c | tree; t|he auxil|
|00003210| 69 61 72 79 20 63 6f 6d | 6d 61 6e 64 20 5c 66 49 |iary com|mand \fI|
|00003220| 72 63 73 5c 66 52 0a 58 | 70 72 75 6e 65 73 20 69 |rcs\fR.X|prunes i|
|00003230| 74 2e 0a 58 54 68 65 20 | 74 72 65 65 20 68 61 73 |t..XThe |tree has|
|00003240| 20 61 20 72 6f 6f 74 20 | 72 65 76 69 73 69 6f 6e | a root |revision|
|00003250| 2c 20 6e 6f 72 6d 61 6c | 6c 79 20 6e 75 6d 62 65 |, normal|ly numbe|
|00003260| 72 65 64 20 31 2e 31 2c | 20 61 6e 64 20 73 75 63 |red 1.1,| and suc|
|00003270| 63 65 73 73 69 76 65 20 | 72 65 76 69 73 69 6f 6e |cessive |revision|
|00003280| 73 0a 58 61 72 65 20 6e | 75 6d 62 65 72 65 64 20 |s.Xare n|umbered |
|00003290| 31 2e 32 2c 20 31 2e 33 | 2c 20 65 74 63 2e 20 20 |1.2, 1.3|, etc.  |
|000032a0| 54 68 65 20 66 69 72 73 | 74 20 66 69 65 6c 64 20 |The firs|t field |
|000032b0| 6f 66 20 61 20 72 65 76 | 69 73 69 6f 6e 20 6e 75 |of a rev|ision nu|
|000032c0| 6d 62 65 72 0a 58 69 73 | 20 63 61 6c 6c 65 64 20 |mber.Xis| called |
|000032d0| 74 68 65 20 5c 66 49 72 | 65 6c 65 61 73 65 20 6e |the \fIr|elease n|
|000032e0| 75 6d 62 65 72 5c 66 52 | 20 61 6e 64 20 74 68 65 |umber\fR| and the|
|000032f0| 20 73 65 63 6f 6e 64 20 | 6f 6e 65 0a 58 74 68 65 | second |one.Xthe|
|00003300| 20 5c 66 49 6c 65 76 65 | 6c 20 6e 75 6d 62 65 72 | \fIleve|l number|
|00003310| 5c 66 52 2e 20 20 55 6e | 6c 65 73 73 20 67 69 76 |\fR.  Un|less giv|
|00003320| 65 6e 20 65 78 70 6c 69 | 63 69 74 6c 79 2c 0a 58 |en expli|citly,.X|
|00003330| 74 68 65 20 5c 66 49 63 | 69 5c 66 52 20 63 6f 6d |the \fIc|i\fR com|
|00003340| 6d 61 6e 64 20 61 73 73 | 69 67 6e 73 20 61 20 6e |mand ass|igns a n|
|00003350| 65 77 20 72 65 76 69 73 | 69 6f 6e 20 6e 75 6d 62 |ew revis|ion numb|
|00003360| 65 72 0a 58 62 79 20 69 | 6e 63 72 65 6d 65 6e 74 |er.Xby i|ncrement|
|00003370| 69 6e 67 20 74 68 65 20 | 6c 65 76 65 6c 20 6e 75 |ing the |level nu|
|00003380| 6d 62 65 72 20 6f 66 20 | 74 68 65 20 70 72 65 76 |mber of |the prev|
|00003390| 69 6f 75 73 20 72 65 76 | 69 73 69 6f 6e 2e 0a 58 |ious rev|ision..X|
|000033a0| 54 68 65 20 72 65 6c 65 | 61 73 65 20 6e 75 6d 62 |The rele|ase numb|
|000033b0| 65 72 20 6d 75 73 74 20 | 62 65 20 69 6e 63 72 65 |er must |be incre|
|000033c0| 6d 65 6e 74 65 64 20 65 | 78 70 6c 69 63 69 74 6c |mented e|xplicitl|
|000033d0| 79 2c 20 75 73 69 6e 67 | 20 74 68 65 0a 58 5c 66 |y, using| the.X\f|
|000033e0| 49 5c 2d 72 5c 66 52 20 | 6f 70 74 69 6f 6e 20 6f |I\-r\fR |option o|
|000033f0| 66 20 5c 66 49 63 69 5c | 66 52 2e 0a 58 41 73 73 |f \fIci\|fR..XAss|
|00003400| 75 6d 69 6e 67 20 74 68 | 65 72 65 20 61 72 65 20 |uming th|ere are |
|00003410| 72 65 76 69 73 69 6f 6e | 73 20 31 2e 31 2c 20 31 |revision|s 1.1, 1|
|00003420| 2e 32 2c 20 61 6e 64 20 | 31 2e 33 20 69 6e 20 74 |.2, and |1.3 in t|
|00003430| 68 65 20 52 43 53 20 66 | 69 6c 65 20 66 2e 63 2c |he RCS f|ile f.c,|
|00003440| 76 2c 20 74 68 65 20 63 | 6f 6d 6d 61 6e 64 0a 58 |v, the c|ommand.X|
|00003450| 2e 44 28 0a 58 63 69 20 | 20 5c 2d 72 32 2e 31 20 |.D(.Xci | \-r2.1 |
|00003460| 20 66 2e 63 20 20 20 20 | 20 20 20 5c 66 52 6f 72 | f.c    |   \fRor|
|00003470| 5c 66 50 20 20 20 20 20 | 20 20 63 69 20 20 5c 2d |\fP     |  ci  \-|
|00003480| 72 32 20 20 66 2e 63 0a | 58 2e 44 29 0a 58 61 73 |r2  f.c.|X.D).Xas|
|00003490| 73 69 67 6e 73 20 74 68 | 65 20 6e 75 6d 62 65 72 |signs th|e number|
|000034a0| 20 32 2e 31 20 74 6f 20 | 74 68 65 20 6e 65 77 20 | 2.1 to |the new |
|000034b0| 72 65 76 69 73 69 6f 6e | 2e 0a 58 4c 61 74 65 72 |revision|..XLater|
|000034c0| 20 63 68 65 63 6b 2d 69 | 6e 73 20 77 69 74 68 6f | check-i|ns witho|
|000034d0| 75 74 20 74 68 65 20 5c | 66 49 5c 2d 72 5c 66 52 |ut the \|fI\-r\fR|
|000034e0| 20 6f 70 74 69 6f 6e 20 | 77 69 6c 6c 20 61 73 73 | option |will ass|
|000034f0| 69 67 6e 20 74 68 65 20 | 6e 75 6d 62 65 72 73 20 |ign the |numbers |
|00003500| 32 2e 32 2c 20 32 2e 33 | 2c 0a 58 61 6e 64 20 73 |2.2, 2.3|,.Xand s|
|00003510| 6f 20 6f 6e 2e 0a 58 54 | 68 65 20 72 65 6c 65 61 |o on..XT|he relea|
|00003520| 73 65 20 6e 75 6d 62 65 | 72 20 73 68 6f 75 6c 64 |se numbe|r should|
|00003530| 20 62 65 20 69 6e 63 72 | 65 6d 65 6e 74 65 64 20 | be incr|emented |
|00003540| 6f 6e 6c 79 20 61 74 20 | 6d 61 6a 6f 72 20 74 72 |only at |major tr|
|00003550| 61 6e 73 69 74 69 6f 6e | 20 70 6f 69 6e 74 73 0a |ansition| points.|
|00003560| 58 69 6e 20 74 68 65 20 | 64 65 76 65 6c 6f 70 6d |Xin the |developm|
|00003570| 65 6e 74 2c 20 66 6f 72 | 20 69 6e 73 74 61 6e 63 |ent, for| instanc|
|00003580| 65 20 77 68 65 6e 20 61 | 20 6e 65 77 20 72 65 6c |e when a| new rel|
|00003590| 65 61 73 65 20 6f 66 20 | 61 20 73 6f 66 74 77 61 |ease of |a softwa|
|000035a0| 72 65 20 70 72 6f 64 75 | 63 74 20 68 61 73 0a 58 |re produ|ct has.X|
|000035b0| 62 65 65 6e 20 63 6f 6d | 70 6c 65 74 65 64 2e 0a |been com|pleted..|
|000035c0| 58 2e 4e 48 20 32 0a 58 | 57 68 65 6e 20 61 72 65 |X.NH 2.X|When are|
|000035d0| 20 62 72 61 6e 63 68 65 | 73 20 6e 65 65 64 65 64 | branche|s needed|
|000035e0| 3f 0a 58 2e 50 50 0a 58 | 41 20 79 6f 75 6e 67 20 |?.X.PP.X|A young |
|000035f0| 72 65 76 69 73 69 6f 6e | 20 74 72 65 65 20 69 73 |revision| tree is|
|00003600| 20 73 6c 65 6e 64 65 72 | 3a 0a 58 49 74 20 63 6f | slender|:.XIt co|
|00003610| 6e 73 69 73 74 73 20 6f | 66 20 6f 6e 6c 79 20 6f |nsists o|f only o|
|00003620| 6e 65 20 62 72 61 6e 63 | 68 2c 20 63 61 6c 6c 65 |ne branc|h, calle|
|00003630| 64 20 74 68 65 20 74 72 | 75 6e 6b 2e 0a 58 41 73 |d the tr|unk..XAs|
|00003640| 20 74 68 65 20 74 72 65 | 65 20 61 67 65 73 2c 20 | the tre|e ages, |
|00003650| 73 69 64 65 20 62 72 61 | 6e 63 68 65 73 20 6d 61 |side bra|nches ma|
|00003660| 79 20 66 6f 72 6d 2e 0a | 58 42 72 61 6e 63 68 65 |y form..|XBranche|
|00003670| 73 20 61 72 65 20 6e 65 | 65 64 65 64 20 69 6e 20 |s are ne|eded in |
|00003680| 74 68 65 20 66 6f 6c 6c | 6f 77 69 6e 67 20 34 20 |the foll|owing 4 |
|00003690| 73 69 74 75 61 74 69 6f | 6e 73 2e 0a 58 2e 49 50 |situatio|ns..X.IP|
|000036a0| 20 22 5c 66 49 54 65 6d | 70 6f 72 61 72 79 20 66 | "\fITem|porary f|
|000036b0| 69 78 65 73 5c 66 52 22 | 0a 58 2e 73 70 20 30 0a |ixes\fR"|.X.sp 0.|
|000036c0| 58 53 75 70 70 6f 73 65 | 20 61 20 74 72 65 65 20 |XSuppose| a tree |
|000036d0| 68 61 73 20 35 20 72 65 | 76 69 73 69 6f 6e 73 20 |has 5 re|visions |
|000036e0| 67 72 6f 75 70 65 64 20 | 69 6e 20 32 20 72 65 6c |grouped |in 2 rel|
|000036f0| 65 61 73 65 73 2c 0a 58 | 61 73 20 69 6c 6c 75 73 |eases,.X|as illus|
|00003700| 74 72 61 74 65 64 20 69 | 6e 20 46 69 67 75 72 65 |trated i|n Figure|
|00003710| 20 32 2e 0a 58 52 65 76 | 69 73 69 6f 6e 20 31 2e | 2..XRev|ision 1.|
|00003720| 33 2c 20 74 68 65 20 6c | 61 73 74 20 6f 6e 65 20 |3, the l|ast one |
|00003730| 6f 66 20 72 65 6c 65 61 | 73 65 20 31 2c 20 69 73 |of relea|se 1, is|
|00003740| 20 69 6e 20 6f 70 65 72 | 61 74 69 6f 6e 20 61 74 | in oper|ation at|
|00003750| 20 63 75 73 74 6f 6d 65 | 72 20 73 69 74 65 73 2c | custome|r sites,|
|00003760| 0a 58 77 68 69 6c 65 20 | 72 65 6c 65 61 73 65 20 |.Xwhile |release |
|00003770| 32 20 69 73 20 69 6e 20 | 61 63 74 69 76 65 20 64 |2 is in |active d|
|00003780| 65 76 65 6c 6f 70 6d 65 | 6e 74 2e 0a 58 2e 6e 65 |evelopme|nt..X.ne|
|00003790| 20 34 0a 58 2e 50 53 20 | 34 69 0a 58 2e 70 73 20 | 4.X.PS |4i.X.ps |
|000037a0| 2d 32 0a 58 62 6f 78 20 | 22 31 2e 31 22 0a 58 61 |-2.Xbox |"1.1".Xa|
|000037b0| 72 72 6f 77 0a 58 62 6f | 78 20 22 31 2e 32 22 0a |rrow.Xbo|x "1.2".|
|000037c0| 58 61 72 72 6f 77 0a 58 | 62 6f 78 20 22 31 2e 33 |Xarrow.X|box "1.3|
|000037d0| 22 0a 58 61 72 72 6f 77 | 0a 58 62 6f 78 20 22 32 |".Xarrow|.Xbox "2|
|000037e0| 2e 31 22 0a 58 61 72 72 | 6f 77 0a 58 62 6f 78 20 |.1".Xarr|ow.Xbox |
|000037f0| 22 32 2e 32 22 0a 58 61 | 72 72 6f 77 20 64 61 73 |"2.2".Xa|rrow das|
|00003800| 68 65 64 0a 58 2e 70 73 | 20 2b 32 0a 58 2e 50 45 |hed.X.ps| +2.X.PE|
|00003810| 0a 58 2e 63 65 20 31 0a | 58 46 69 67 75 72 65 20 |.X.ce 1.|XFigure |
|00003820| 32 2e 20 20 41 20 73 6c | 65 6e 64 65 72 20 72 65 |2.  A sl|ender re|
|00003830| 76 69 73 69 6f 6e 20 74 | 72 65 65 2e 0a 58 2e 73 |vision t|ree..X.s|
|00003840| 70 20 30 0a 58 4e 6f 77 | 20 69 6d 61 67 69 6e 65 |p 0.XNow| imagine|
|00003850| 20 61 20 63 75 73 74 6f | 6d 65 72 20 72 65 71 75 | a custo|mer requ|
|00003860| 65 73 74 69 6e 67 20 61 | 20 66 69 78 20 6f 66 0a |esting a| fix of.|
|00003870| 58 61 20 70 72 6f 62 6c | 65 6d 20 69 6e 20 72 65 |Xa probl|em in re|
|00003880| 76 69 73 69 6f 6e 20 31 | 2e 33 2c 20 61 6c 74 68 |vision 1|.3, alth|
|00003890| 6f 75 67 68 20 61 63 74 | 75 61 6c 20 64 65 76 65 |ough act|ual deve|
|000038a0| 6c 6f 70 6d 65 6e 74 20 | 68 61 73 20 6d 6f 76 65 |lopment |has move|
|000038b0| 64 20 6f 6e 0a 58 74 6f | 20 72 65 6c 65 61 73 65 |d on.Xto| release|
|000038c0| 20 32 2e 20 20 52 43 53 | 20 64 6f 65 73 20 6e 6f | 2.  RCS| does no|
|000038d0| 74 20 70 65 72 6d 69 74 | 20 61 6e 20 65 78 74 72 |t permit| an extr|
|000038e0| 61 0a 58 72 65 76 69 73 | 69 6f 6e 20 74 6f 20 62 |a.Xrevis|ion to b|
|000038f0| 65 20 73 70 6c 69 63 65 | 64 20 69 6e 20 62 65 74 |e splice|d in bet|
|00003900| 77 65 65 6e 20 31 2e 33 | 20 61 6e 64 20 32 2e 31 |ween 1.3| and 2.1|
|00003910| 2c 20 73 69 6e 63 65 20 | 74 68 61 74 20 77 6f 75 |, since |that wou|
|00003920| 6c 64 20 6e 6f 74 20 72 | 65 66 6c 65 63 74 0a 58 |ld not r|eflect.X|
|00003930| 74 68 65 20 61 63 74 75 | 61 6c 20 64 65 76 65 6c |the actu|al devel|
|00003940| 6f 70 6d 65 6e 74 20 68 | 69 73 74 6f 72 79 2e 20 |opment h|istory. |
|00003950| 20 49 6e 73 74 65 61 64 | 2c 20 63 72 65 61 74 65 | Instead|, create|
|00003960| 20 61 20 62 72 61 6e 63 | 68 0a 58 61 74 20 72 65 | a branc|h.Xat re|
|00003970| 76 69 73 69 6f 6e 20 31 | 2e 33 2c 20 61 6e 64 20 |vision 1|.3, and |
|00003980| 63 68 65 63 6b 20 69 6e | 20 74 68 65 20 66 69 78 |check in| the fix|
|00003990| 20 6f 6e 20 74 68 61 74 | 20 62 72 61 6e 63 68 2e | on that| branch.|
|000039a0| 0a 58 54 68 65 20 66 69 | 72 73 74 20 62 72 61 6e |.XThe fi|rst bran|
|000039b0| 63 68 20 73 74 61 72 74 | 69 6e 67 20 61 74 20 31 |ch start|ing at 1|
|000039c0| 2e 33 20 68 61 73 20 6e | 75 6d 62 65 72 20 31 2e |.3 has n|umber 1.|
|000039d0| 33 2e 31 2c 20 61 6e 64 | 0a 58 74 68 65 20 72 65 |3.1, and|.Xthe re|
|000039e0| 76 69 73 69 6f 6e 73 20 | 6f 6e 20 74 68 61 74 20 |visions |on that |
|000039f0| 62 72 61 6e 63 68 20 61 | 72 65 20 6e 75 6d 62 65 |branch a|re numbe|
|00003a00| 72 65 64 20 31 2e 33 2e | 31 2e 31 2c 20 31 2e 33 |red 1.3.|1.1, 1.3|
|00003a10| 2e 31 2e 32 2c 20 65 74 | 63 2e 0a 58 54 68 65 20 |.1.2, et|c..XThe |
|00003a20| 64 6f 75 62 6c 65 20 6e | 75 6d 62 65 72 69 6e 67 |double n|umbering|
|00003a30| 20 69 73 20 6e 65 65 64 | 65 64 20 74 6f 20 61 6c | is need|ed to al|
|00003a40| 6c 6f 77 20 66 6f 72 20 | 61 6e 6f 74 68 65 72 0a |low for |another.|
|00003a50| 58 62 72 61 6e 63 68 20 | 61 74 20 31 2e 33 2c 20 |Xbranch |at 1.3, |
|00003a60| 73 61 79 20 31 2e 33 2e | 32 2e 0a 58 52 65 76 69 |say 1.3.|2..XRevi|
|00003a70| 73 69 6f 6e 73 20 6f 6e | 20 74 68 65 20 73 65 63 |sions on| the sec|
|00003a80| 6f 6e 64 20 62 72 61 6e | 63 68 20 77 6f 75 6c 64 |ond bran|ch would|
|00003a90| 20 62 65 20 6e 75 6d 62 | 65 72 65 64 0a 58 31 2e | be numb|ered.X1.|
|00003aa0| 33 2e 32 2e 31 2c 20 31 | 2e 33 2e 32 2e 32 2c 20 |3.2.1, 1|.3.2.2, |
|00003ab0| 61 6e 64 20 73 6f 20 6f | 6e 2e 0a 58 54 68 65 20 |and so o|n..XThe |
|00003ac0| 66 6f 6c 6c 6f 77 69 6e | 67 20 73 74 65 70 73 20 |followin|g steps |
|00003ad0| 63 72 65 61 74 65 0a 58 | 62 72 61 6e 63 68 20 31 |create.X|branch 1|
|00003ae0| 2e 33 2e 31 20 61 6e 64 | 20 61 64 64 20 72 65 76 |.3.1 and| add rev|
|00003af0| 69 73 69 6f 6e 20 31 2e | 33 2e 31 2e 31 3a 0a 58 |ision 1.|3.1.1:.X|
|00003b00| 2e 73 70 20 30 0a 58 2e | 49 0a 58 2e 6e 72 20 56 |.sp 0.X.|I.X.nr V|
|00003b10| 53 20 31 32 70 0a 58 2e | 76 73 20 31 32 70 0a 58 |S 12p.X.|vs 12p.X|
|00003b20| 2e 54 53 0a 58 74 61 62 | 28 25 29 3b 0a 58 6c 20 |.TS.Xtab|(%);.Xl |
|00003b30| 6c 20 6c 2e 0a 58 20 20 | 20 20 20 25 63 6f 20 20 |l l..X  |   %co  |
|00003b40| 5c 2d 72 31 2e 33 20 20 | 66 2e 63 25 20 5c 2a 2d |\-r1.3  |f.c% \*-|
|00003b50| 20 63 68 65 63 6b 20 6f | 75 74 20 72 65 76 69 73 | check o|ut revis|
|00003b60| 69 6f 6e 20 31 2e 33 0a | 58 20 20 20 20 20 25 65 |ion 1.3.|X     %e|
|00003b70| 64 69 74 20 20 66 2e 63 | 25 20 5c 2a 2d 20 63 68 |dit  f.c|% \*- ch|
|00003b80| 61 6e 67 65 20 69 74 0a | 58 20 20 20 20 20 25 63 |ange it.|X     %c|
|00003b90| 69 20 20 5c 2d 72 31 2e | 33 2e 31 20 20 66 2e 63 |i  \-r1.|3.1  f.c|
|00003ba0| 25 20 5c 2a 2d 20 63 68 | 65 63 6b 20 69 74 20 69 |% \*- ch|eck it i|
|00003bb0| 6e 20 6f 6e 20 62 72 61 | 6e 63 68 20 31 2e 33 2e |n on bra|nch 1.3.|
|00003bc0| 31 0a 58 2e 54 45 0a 58 | 2e 6e 72 20 56 53 20 31 |1.X.TE.X|.nr VS 1|
|00003bd0| 38 70 0a 58 2e 76 73 20 | 31 38 70 0a 58 2e 52 0a |8p.X.vs |18p.X.R.|
|00003be0| 58 54 68 69 73 20 73 65 | 71 75 65 6e 63 65 20 6f |XThis se|quence o|
|00003bf0| 66 20 63 6f 6d 6d 61 6e | 64 73 20 74 72 61 6e 73 |f comman|ds trans|
|00003c00| 66 6f 72 6d 73 20 74 68 | 65 20 74 72 65 65 20 6f |forms th|e tree o|
|00003c10| 66 20 46 69 67 75 72 65 | 20 32 20 69 6e 74 6f 0a |f Figure| 2 into.|
|00003c20| 58 74 68 65 20 6f 6e 65 | 20 69 6e 20 46 69 67 75 |Xthe one| in Figu|
|00003c30| 72 65 20 33 2e 0a 58 4e | 6f 74 65 20 74 68 61 74 |re 3..XN|ote that|
|00003c40| 20 69 74 20 6d 61 79 20 | 62 65 20 6e 65 63 65 73 | it may |be neces|
|00003c50| 73 61 72 79 20 74 6f 20 | 69 6e 63 6f 72 70 6f 72 |sary to |incorpor|
|00003c60| 61 74 65 20 74 68 65 20 | 64 69 66 66 65 72 65 6e |ate the |differen|
|00003c70| 63 65 73 0a 58 62 65 74 | 77 65 65 6e 20 31 2e 33 |ces.Xbet|ween 1.3|
|00003c80| 20 61 6e 64 20 31 2e 33 | 2e 31 2e 31 0a 58 69 6e | and 1.3|.1.1.Xin|
|00003c90| 74 6f 20 61 20 72 65 76 | 69 73 69 6f 6e 20 61 74 |to a rev|ision at|
|00003ca0| 20 6c 65 76 65 6c 20 32 | 2e 20 20 54 68 65 20 6f | level 2|.  The o|
|00003cb0| 70 65 72 61 74 69 6f 6e | 20 5c 66 49 72 63 73 6d |peration| \fIrcsm|
|00003cc0| 65 72 67 65 5c 66 52 20 | 61 75 74 6f 6d 61 74 65 |erge\fR |automate|
|00003cd0| 73 20 74 68 69 73 0a 58 | 70 72 6f 63 65 73 73 20 |s this.X|process |
|00003ce0| 28 73 65 65 20 74 68 65 | 20 41 70 70 65 6e 64 69 |(see the| Appendi|
|00003cf0| 78 29 2e 0a 58 2e 6e 65 | 20 37 0a 58 2e 50 53 20 |x)..X.ne| 7.X.PS |
|00003d00| 20 34 69 0a 58 2e 70 73 | 20 2d 32 0a 58 20 20 20 | 4i.X.ps| -2.X   |
|00003d10| 20 20 62 6f 78 20 22 31 | 2e 31 22 0a 58 20 20 20 |  box "1|.1".X   |
|00003d20| 20 20 61 72 72 6f 77 0a | 58 20 20 20 20 20 62 6f |  arrow.|X     bo|
|00003d30| 78 20 22 31 2e 32 22 0a | 58 20 20 20 20 20 61 72 |x "1.2".|X     ar|
|00003d40| 72 6f 77 0a 58 52 31 33 | 3a 20 62 6f 78 20 22 31 |row.XR13|: box "1|
|00003d50| 2e 33 22 0a 58 20 20 20 | 20 20 61 72 72 6f 77 0a |.3".X   |  arrow.|
|00003d60| 58 52 32 31 3a 20 62 6f | 78 20 22 32 2e 31 22 0a |XR21: bo|x "2.1".|
|00003d70| 58 20 20 20 20 20 61 72 | 72 6f 77 0a 58 52 32 32 |X     ar|row.XR22|
|00003d80| 3a 20 62 6f 78 20 22 32 | 2e 32 22 0a 58 20 20 20 |: box "2|.2".X   |
|00003d90| 20 20 61 72 72 6f 77 20 | 64 61 73 68 65 64 0a 58 |  arrow |dashed.X|
|00003da0| 20 20 20 20 20 6c 69 6e | 65 20 69 6e 76 69 73 20 |     lin|e invis |
|00003db0| 64 6f 77 6e 20 66 72 6f | 6d 20 52 32 31 2e 73 0a |down fro|m R21.s.|
|00003dc0| 58 52 42 31 3a 20 62 6f | 78 20 22 31 2e 33 2e 31 |XRB1: bo|x "1.3.1|
|00003dd0| 2e 31 22 0a 58 20 20 20 | 20 20 61 72 72 6f 77 20 |.1".X   |  arrow |
|00003de0| 64 61 73 68 65 64 20 72 | 69 67 68 74 20 66 72 6f |dashed r|ight fro|
|00003df0| 6d 20 52 42 31 2e 65 0a | 58 20 20 20 20 20 61 72 |m RB1.e.|X     ar|
|00003e00| 72 6f 77 20 66 72 6f 6d | 20 52 31 33 2e 73 20 74 |row from| R13.s t|
|00003e10| 6f 20 52 42 31 2e 77 0a | 58 2e 70 73 20 2b 32 0a |o RB1.w.|X.ps +2.|
|00003e20| 58 2e 50 45 0a 58 2e 63 | 65 20 31 0a 58 46 69 67 |X.PE.X.c|e 1.XFig|
|00003e30| 75 72 65 20 33 2e 20 20 | 41 20 72 65 76 69 73 69 |ure 3.  |A revisi|
|00003e40| 6f 6e 20 74 72 65 65 20 | 77 69 74 68 20 6f 6e 65 |on tree |with one|
|00003e50| 20 73 69 64 65 20 62 72 | 61 6e 63 68 0a 58 2e 73 | side br|anch.X.s|
|00003e60| 70 0a 58 2e 49 50 20 22 | 5c 66 49 44 69 73 74 72 |p.X.IP "|\fIDistr|
|00003e70| 69 62 75 74 65 64 20 64 | 65 76 65 6c 6f 70 6d 65 |ibuted d|evelopme|
|00003e80| 6e 74 20 61 6e 64 20 63 | 75 73 74 6f 6d 65 72 20 |nt and c|ustomer |
|00003e90| 6d 6f 64 69 66 69 63 61 | 74 69 6f 6e 73 5c 66 52 |modifica|tions\fR|
|00003ea0| 22 0a 58 2e 73 70 20 30 | 0a 58 41 73 73 75 6d 65 |".X.sp 0|.XAssume|
|00003eb0| 20 61 20 73 69 74 75 61 | 74 69 6f 6e 20 61 73 20 | a situa|tion as |
|00003ec0| 69 6e 20 46 69 67 75 72 | 65 20 32 2c 20 77 68 65 |in Figur|e 2, whe|
|00003ed0| 72 65 20 72 65 76 69 73 | 69 6f 6e 20 31 2e 33 20 |re revis|ion 1.3 |
|00003ee0| 69 73 20 69 6e 20 6f 70 | 65 72 61 74 69 6f 6e 0a |is in op|eration.|
|00003ef0| 58 61 74 20 73 65 76 65 | 72 61 6c 20 63 75 73 74 |Xat seve|ral cust|
|00003f00| 6f 6d 65 72 20 73 69 74 | 65 73 2c 0a 58 77 68 69 |omer sit|es,.Xwhi|
|00003f10| 6c 65 20 72 65 6c 65 61 | 73 65 20 32 20 69 73 20 |le relea|se 2 is |
|00003f20| 69 6e 20 64 65 76 65 6c | 6f 70 6d 65 6e 74 2e 0a |in devel|opment..|
|00003f30| 58 43 75 73 74 6f 6d 65 | 72 20 73 69 74 65 73 20 |XCustome|r sites |
|00003f40| 73 68 6f 75 6c 64 20 75 | 73 65 20 52 43 53 20 74 |should u|se RCS t|
|00003f50| 6f 20 73 74 6f 72 65 20 | 74 68 65 20 64 69 73 74 |o store |the dist|
|00003f60| 72 69 62 75 74 65 64 20 | 73 6f 66 74 77 61 72 65 |ributed |software|
|00003f70| 2e 0a 58 48 6f 77 65 76 | 65 72 2c 20 63 75 73 74 |..XHowev|er, cust|
|00003f80| 6f 6d 65 72 20 6d 6f 64 | 69 66 69 63 61 74 69 6f |omer mod|ificatio|
|00003f90| 6e 73 20 73 68 6f 75 6c | 64 20 6e 6f 74 20 62 65 |ns shoul|d not be|
|00003fa0| 20 70 6c 61 63 65 64 20 | 6f 6e 20 74 68 65 20 73 | placed |on the s|
|00003fb0| 61 6d 65 20 62 72 61 6e | 63 68 0a 58 61 73 20 74 |ame bran|ch.Xas t|
|00003fc0| 68 65 20 64 69 73 74 72 | 69 62 75 74 65 64 20 73 |he distr|ibuted s|
|00003fd0| 6f 75 72 63 65 3b 20 69 | 6e 73 74 65 61 64 2c 20 |ource; i|nstead, |
|00003fe0| 74 68 65 79 20 73 68 6f | 75 6c 64 20 62 65 20 70 |they sho|uld be p|
|00003ff0| 6c 61 63 65 64 20 6f 6e | 20 61 20 73 69 64 65 20 |laced on| a side |
|00004000| 62 72 61 6e 63 68 2e 0a | 58 57 68 65 6e 20 74 68 |branch..|XWhen th|
|00004010| 65 20 6e 65 78 74 20 73 | 6f 66 74 77 61 72 65 20 |e next s|oftware |
|00004020| 64 69 73 74 72 69 62 75 | 74 69 6f 6e 20 61 72 72 |distribu|tion arr|
|00004030| 69 76 65 73 2c 0a 58 69 | 74 20 73 68 6f 75 6c 64 |ives,.Xi|t should|
|00004040| 20 62 65 20 61 70 70 65 | 6e 64 65 64 20 74 6f 20 | be appe|nded to |
|00004050| 74 68 65 20 74 72 75 6e | 6b 20 6f 66 0a 58 74 68 |the trun|k of.Xth|
|00004060| 65 20 63 75 73 74 6f 6d | 65 72 27 73 20 52 43 53 |e custom|er's RCS|
|00004070| 20 66 69 6c 65 2c 20 61 | 6e 64 20 74 68 65 20 63 | file, a|nd the c|
|00004080| 75 73 74 6f 6d 65 72 0a | 58 63 61 6e 20 74 68 65 |ustomer.|Xcan the|
|00004090| 6e 20 6d 65 72 67 65 20 | 74 68 65 20 6c 6f 63 61 |n merge |the loca|
|000040a0| 6c 20 6d 6f 64 69 66 69 | 63 61 74 69 6f 6e 73 20 |l modifi|cations |
|000040b0| 62 61 63 6b 20 69 6e 74 | 6f 20 74 68 65 20 6e 65 |back int|o the ne|
|000040c0| 77 20 72 65 6c 65 61 73 | 65 2e 0a 58 49 6e 20 74 |w releas|e..XIn t|
|000040d0| 68 65 20 61 62 6f 76 65 | 20 65 78 61 6d 70 6c 65 |he above| example|
|000040e0| 2c 20 61 0a 58 63 75 73 | 74 6f 6d 65 72 27 73 20 |, a.Xcus|tomer's |
|000040f0| 52 43 53 20 66 69 6c 65 | 20 77 6f 75 6c 64 20 63 |RCS file| would c|
|00004100| 6f 6e 74 61 69 6e 20 74 | 68 65 20 66 6f 6c 6c 6f |ontain t|he follo|
|00004110| 77 69 6e 67 20 74 72 65 | 65 2c 20 61 73 73 75 6d |wing tre|e, assum|
|00004120| 69 6e 67 0a 58 74 68 61 | 74 20 74 68 65 20 63 75 |ing.Xtha|t the cu|
|00004130| 73 74 6f 6d 65 72 20 68 | 61 73 20 72 65 63 65 69 |stomer h|as recei|
|00004140| 76 65 64 20 72 65 76 69 | 73 69 6f 6e 20 31 2e 33 |ved revi|sion 1.3|
|00004150| 2c 20 61 64 64 65 64 20 | 68 69 73 20 6c 6f 63 61 |, added |his loca|
|00004160| 6c 20 6d 6f 64 69 66 69 | 63 61 74 69 6f 6e 73 0a |l modifi|cations.|
|00004170| 58 61 73 20 72 65 76 69 | 73 69 6f 6e 20 31 2e 33 |Xas revi|sion 1.3|
|00004180| 2e 31 2e 31 2c 20 74 68 | 65 6e 20 72 65 63 65 69 |.1.1, th|en recei|
|00004190| 76 65 64 20 72 65 76 69 | 73 69 6f 6e 20 32 2e 34 |ved revi|sion 2.4|
|000041a0| 2c 20 61 6e 64 20 6d 65 | 72 67 65 64 0a 58 32 2e |, and me|rged.X2.|
|000041b0| 34 20 61 6e 64 20 31 2e | 33 2e 31 2e 31 2c 20 72 |4 and 1.|3.1.1, r|
|000041c0| 65 73 75 6c 74 69 6e 67 | 20 69 6e 20 32 2e 34 2e |esulting| in 2.4.|
|000041d0| 31 2e 31 2e 0a 58 2e 6e | 65 20 37 0a 58 2e 50 53 |1.1..X.n|e 7.X.PS|
|000041e0| 20 20 34 69 0a 58 2e 70 | 73 20 2d 32 0a 58 52 31 |  4i.X.p|s -2.XR1|
|000041f0| 33 3a 20 62 6f 78 20 22 | 31 2e 33 22 0a 58 20 20 |3: box "|1.3".X  |
|00004200| 20 20 20 6c 69 6e 65 20 | 69 6e 76 69 73 0a 58 52 |   line |invis.XR|
|00004210| 32 31 3a 20 62 6f 78 20 | 69 6e 76 69 73 0a 58 20 |21: box |invis.X |
|00004220| 20 20 20 20 6c 69 6e 65 | 20 69 6e 76 69 73 0a 58 |    line| invis.X|
|00004230| 52 32 32 3a 20 62 6f 78 | 20 69 6e 76 69 73 0a 58 |R22: box| invis.X|
|00004240| 20 20 20 20 20 6c 69 6e | 65 20 69 6e 76 69 73 0a |     lin|e invis.|
|00004250| 58 52 32 34 3a 20 62 6f | 78 20 22 32 2e 34 22 0a |XR24: bo|x "2.4".|
|00004260| 58 20 20 20 20 20 6c 69 | 6e 65 20 69 6e 76 69 73 |X     li|ne invis|
|00004270| 0a 58 52 32 35 3a 20 62 | 6f 78 20 69 6e 76 69 73 |.XR25: b|ox invis|
|00004280| 0a 58 20 20 20 20 20 6c | 69 6e 65 20 69 6e 76 69 |.X     l|ine invi|
|00004290| 73 0a 58 20 20 20 20 20 | 61 72 72 6f 77 20 66 72 |s.X     |arrow fr|
|000042a0| 6f 6d 20 52 31 33 2e 65 | 20 74 6f 20 52 32 34 2e |om R13.e| to R24.|
|000042b0| 77 0a 58 20 20 20 20 20 | 6c 69 6e 65 20 69 6e 76 |w.X     |line inv|
|000042c0| 69 73 20 64 6f 77 6e 20 | 66 72 6f 6d 20 52 32 31 |is down |from R21|
|000042d0| 2e 73 0a 58 52 42 31 3a | 20 62 6f 78 20 22 31 2e |.s.XRB1:| box "1.|
|000042e0| 33 2e 31 2e 31 22 0a 58 | 20 20 20 20 20 61 72 72 |3.1.1".X|     arr|
|000042f0| 6f 77 20 66 72 6f 6d 20 | 52 31 33 2e 73 20 74 6f |ow from |R13.s to|
|00004300| 20 52 42 31 2e 77 0a 58 | 20 20 20 20 20 72 69 67 | RB1.w.X|     rig|
|00004310| 68 74 0a 58 20 20 20 20 | 20 6c 69 6e 65 20 69 6e |ht.X    | line in|
|00004320| 76 69 73 20 64 6f 77 6e | 20 66 72 6f 6d 20 52 32 |vis down| from R2|
|00004330| 35 2e 73 0a 58 52 42 32 | 3a 20 62 6f 78 20 22 32 |5.s.XRB2|: box "2|
|00004340| 2e 34 2e 31 2e 31 22 0a | 58 20 20 20 20 20 61 72 |.4.1.1".|X     ar|
|00004350| 72 6f 77 20 66 72 6f 6d | 20 52 32 34 2e 73 20 74 |row from| R24.s t|
|00004360| 6f 20 52 42 32 2e 77 0a | 58 2e 70 73 20 2b 32 0a |o RB2.w.|X.ps +2.|
|00004370| 58 2e 50 45 0a 58 2e 63 | 65 20 31 0a 58 46 69 67 |X.PE.X.c|e 1.XFig|
|00004380| 75 72 65 20 34 2e 20 20 | 41 20 63 75 73 74 6f 6d |ure 4.  |A custom|
|00004390| 65 72 27 73 20 72 65 76 | 69 73 69 6f 6e 20 74 72 |er's rev|ision tr|
|000043a0| 65 65 20 77 69 74 68 20 | 6c 6f 63 61 6c 20 6d 6f |ee with |local mo|
|000043b0| 64 69 66 69 63 61 74 69 | 6f 6e 73 2e 0a 58 2e 73 |dificati|ons..X.s|
|000043c0| 70 20 31 0a 58 54 68 69 | 73 20 61 70 70 72 6f 61 |p 1.XThi|s approa|
|000043d0| 63 68 20 69 73 20 61 63 | 74 75 61 6c 6c 79 20 70 |ch is ac|tually p|
|000043e0| 72 61 63 74 69 63 65 64 | 20 69 6e 20 74 68 65 20 |racticed| in the |
|000043f0| 43 53 4e 45 54 20 70 72 | 6f 6a 65 63 74 2c 0a 58 |CSNET pr|oject,.X|
|00004400| 77 68 65 72 65 20 73 65 | 76 65 72 61 6c 20 75 6e |where se|veral un|
|00004410| 69 76 65 72 73 69 74 69 | 65 73 20 61 6e 64 20 61 |iversiti|es and a|
|00004420| 20 63 6f 6d 70 61 6e 79 | 20 63 6f 6f 70 65 72 61 | company| coopera|
|00004430| 74 65 0a 58 69 6e 20 64 | 65 76 65 6c 6f 70 69 6e |te.Xin d|evelopin|
|00004440| 67 20 61 20 6e 61 74 69 | 6f 6e 61 6c 20 63 6f 6d |g a nati|onal com|
|00004450| 70 75 74 65 72 20 6e 65 | 74 77 6f 72 6b 2e 0a 58 |puter ne|twork..X|
|00004460| 2e 49 50 20 22 5c 66 49 | 50 61 72 61 6c 6c 65 6c |.IP "\fI|Parallel|
|00004470| 20 64 65 76 65 6c 6f 70 | 6d 65 6e 74 5c 66 52 22 | develop|ment\fR"|
|00004480| 0a 58 2e 73 70 20 30 0a | 58 53 6f 6d 65 74 69 6d |.X.sp 0.|XSometim|
|00004490| 65 73 20 69 74 20 69 73 | 20 64 65 73 69 72 61 62 |es it is| desirab|
|000044a0| 6c 65 20 74 6f 20 65 78 | 70 6c 6f 72 65 20 61 6e |le to ex|plore an|
|000044b0| 20 61 6c 74 65 72 6e 61 | 74 65 20 64 65 73 69 67 | alterna|te desig|
|000044c0| 6e 20 6f 72 0a 58 61 20 | 64 69 66 66 65 72 65 6e |n or.Xa |differen|
|000044d0| 74 20 69 6d 70 6c 65 6d | 65 6e 74 61 74 69 6f 6e |t implem|entation|
|000044e0| 20 74 65 63 68 6e 69 71 | 75 65 20 69 6e 20 70 61 | techniq|ue in pa|
|000044f0| 72 61 6c 6c 65 6c 20 77 | 69 74 68 20 74 68 65 0a |rallel w|ith the.|
|00004500| 58 6d 61 69 6e 20 6c 69 | 6e 65 20 64 65 76 65 6c |Xmain li|ne devel|
|00004510| 6f 70 6d 65 6e 74 2e 20 | 20 53 75 63 68 20 64 65 |opment. | Such de|
|00004520| 76 65 6c 6f 70 6d 65 6e | 74 0a 58 73 68 6f 75 6c |velopmen|t.Xshoul|
|00004530| 64 20 62 65 20 63 61 72 | 72 69 65 64 20 6f 75 74 |d be car|ried out|
|00004540| 20 6f 6e 20 61 20 73 69 | 64 65 20 62 72 61 6e 63 | on a si|de branc|
|00004550| 68 2e 0a 58 54 68 65 20 | 65 78 70 65 72 69 6d 65 |h..XThe |experime|
|00004560| 6e 74 61 6c 20 63 68 61 | 6e 67 65 73 20 6d 61 79 |ntal cha|nges may|
|00004570| 20 6c 61 74 65 72 20 62 | 65 20 6d 6f 76 65 64 20 | later b|e moved |
|00004580| 69 6e 74 6f 20 74 68 65 | 20 6d 61 69 6e 20 6c 69 |into the| main li|
|00004590| 6e 65 2c 20 6f 72 20 61 | 62 61 6e 64 6f 6e 65 64 |ne, or a|bandoned|
|000045a0| 2e 0a 58 2e 49 50 20 22 | 5c 66 49 43 6f 6e 66 6c |..X.IP "|\fIConfl|
|000045b0| 69 63 74 69 6e 67 20 75 | 70 64 61 74 65 73 5c 66 |icting u|pdates\f|
|000045c0| 52 22 0a 58 2e 73 70 20 | 30 0a 58 41 20 63 6f 6d |R".X.sp |0.XA com|
|000045d0| 6d 6f 6e 20 6f 63 63 75 | 72 72 65 6e 63 65 20 69 |mon occu|rrence i|
|000045e0| 73 20 74 68 61 74 20 6f | 6e 65 20 70 72 6f 67 72 |s that o|ne progr|
|000045f0| 61 6d 6d 65 72 0a 58 68 | 61 73 20 63 68 65 63 6b |ammer.Xh|as check|
|00004600| 65 64 20 6f 75 74 20 61 | 20 72 65 76 69 73 69 6f |ed out a| revisio|
|00004610| 6e 2c 20 62 75 74 20 63 | 61 6e 6e 6f 74 20 63 6f |n, but c|annot co|
|00004620| 6d 70 6c 65 74 65 20 74 | 68 65 20 61 73 73 69 67 |mplete t|he assig|
|00004630| 6e 6d 65 6e 74 0a 58 66 | 6f 72 20 73 6f 6d 65 20 |nment.Xf|or some |
|00004640| 72 65 61 73 6f 6e 2e 20 | 20 49 6e 20 74 68 65 20 |reason. | In the |
|00004650| 6d 65 61 6e 74 69 6d 65 | 2c 20 61 6e 6f 74 68 65 |meantime|, anothe|
|00004660| 72 20 70 65 72 73 6f 6e | 0a 58 6d 75 73 74 20 70 |r person|.Xmust p|
|00004670| 65 72 66 6f 72 6d 20 61 | 6e 6f 74 68 65 72 20 6d |erform a|nother m|
|00004680| 6f 64 69 66 69 63 61 74 | 69 6f 6e 0a 58 69 6d 6d |odificat|ion.Ximm|
|00004690| 65 64 69 61 74 65 6c 79 | 2e 20 20 49 6e 20 74 68 |ediately|.  In th|
|000046a0| 61 74 20 63 61 73 65 2c | 20 74 68 65 20 73 65 63 |at case,| the sec|
|000046b0| 6f 6e 64 20 70 65 72 73 | 6f 6e 20 73 68 6f 75 6c |ond pers|on shoul|
|000046c0| 64 20 63 68 65 63 6b 2d | 6f 75 74 20 74 68 65 20 |d check-|out the |
|000046d0| 73 61 6d 65 20 72 65 76 | 69 73 69 6f 6e 2c 0a 58 |same rev|ision,.X|
|000046e0| 6d 6f 64 69 66 79 20 69 | 74 2c 20 61 6e 64 20 63 |modify i|t, and c|
|000046f0| 68 65 63 6b 20 69 74 20 | 69 6e 20 6f 6e 20 61 20 |heck it |in on a |
|00004700| 73 69 64 65 20 62 72 61 | 6e 63 68 2c 20 66 6f 72 |side bra|nch, for|
|00004710| 20 6c 61 74 65 72 20 6d | 65 72 67 69 6e 67 2e 0a | later m|erging..|
|00004720| 58 2e 50 50 0a 58 45 76 | 65 72 79 20 6e 6f 64 65 |X.PP.XEv|ery node|
|00004730| 20 69 6e 20 61 20 72 65 | 76 69 73 69 6f 6e 20 74 | in a re|vision t|
|00004740| 72 65 65 20 63 6f 6e 73 | 69 73 74 73 20 6f 66 20 |ree cons|ists of |
|00004750| 74 68 65 20 66 6f 6c 6c | 6f 77 69 6e 67 20 61 74 |the foll|owing at|
|00004760| 74 72 69 62 75 74 65 73 | 3a 0a 58 61 20 72 65 76 |tributes|:.Xa rev|
|00004770| 69 73 69 6f 6e 20 6e 75 | 6d 62 65 72 2c 20 61 20 |ision nu|mber, a |
|00004780| 63 68 65 63 6b 2d 69 6e | 20 64 61 74 65 20 61 6e |check-in| date an|
|00004790| 64 20 74 69 6d 65 2c 20 | 74 68 65 20 61 75 74 68 |d time, |the auth|
|000047a0| 6f 72 27 73 20 69 64 65 | 6e 74 69 66 69 63 61 74 |or's ide|ntificat|
|000047b0| 69 6f 6e 2c 0a 58 61 20 | 6c 6f 67 20 65 6e 74 72 |ion,.Xa |log entr|
|000047c0| 79 2c 20 61 20 73 74 61 | 74 65 20 61 6e 64 20 74 |y, a sta|te and t|
|000047d0| 68 65 20 61 63 74 75 61 | 6c 20 74 65 78 74 2e 20 |he actua|l text. |
|000047e0| 20 41 6c 6c 20 74 68 65 | 73 65 20 61 74 74 72 69 | All the|se attri|
|000047f0| 62 75 74 65 73 0a 58 61 | 72 65 20 64 65 74 65 72 |butes.Xa|re deter|
|00004800| 6d 69 6e 65 64 20 61 74 | 20 74 68 65 20 74 69 6d |mined at| the tim|
|00004810| 65 20 74 68 65 20 72 65 | 76 69 73 69 6f 6e 20 69 |e the re|vision i|
|00004820| 73 20 63 68 65 63 6b 65 | 64 20 69 6e 2e 0a 58 54 |s checke|d in..XT|
|00004830| 68 65 20 73 74 61 74 65 | 20 61 74 74 72 69 62 75 |he state| attribu|
|00004840| 74 65 20 69 6e 64 69 63 | 61 74 65 73 20 74 68 65 |te indic|ates the|
|00004850| 20 73 74 61 74 75 73 20 | 6f 66 20 61 20 72 65 76 | status |of a rev|
|00004860| 69 73 69 6f 6e 2e 0a 58 | 49 74 20 69 73 20 73 65 |ision..X|It is se|
|00004870| 74 20 61 75 74 6f 6d 61 | 74 69 63 61 6c 6c 79 20 |t automa|tically |
|00004880| 74 6f 20 60 65 78 70 65 | 72 69 6d 65 6e 74 61 6c |to `expe|rimental|
|00004890| 27 20 64 75 72 69 6e 67 | 20 63 68 65 63 6b 2d 69 |' during| check-i|
|000048a0| 6e 2e 0a 58 41 20 72 65 | 76 69 73 69 6f 6e 20 63 |n..XA re|vision c|
|000048b0| 61 6e 20 6c 61 74 65 72 | 20 62 65 20 70 72 6f 6d |an later| be prom|
|000048c0| 6f 74 65 64 20 74 6f 20 | 61 20 68 69 67 68 65 72 |oted to |a higher|
|000048d0| 20 73 74 61 74 75 73 2c | 20 66 6f 72 20 65 78 61 | status,| for exa|
|000048e0| 6d 70 6c 65 0a 58 60 73 | 74 61 62 6c 65 27 20 6f |mple.X`s|table' o|
|000048f0| 72 20 60 72 65 6c 65 61 | 73 65 64 27 2e 20 20 54 |r `relea|sed'.  T|
|00004900| 68 65 20 73 65 74 20 6f | 66 20 73 74 61 74 65 73 |he set o|f states|
|00004910| 20 69 73 20 75 73 65 72 | 2d 64 65 66 69 6e 65 64 | is user|-defined|
|00004920| 2e 0a 58 2e 4e 48 20 32 | 0a 58 52 65 76 69 73 69 |..X.NH 2|.XRevisi|
|00004930| 6f 6e 73 20 61 72 65 20 | 72 65 70 72 65 73 65 6e |ons are |represen|
|00004940| 74 65 64 20 61 73 20 64 | 65 6c 74 61 73 0a 58 2e |ted as d|eltas.X.|
|00004950| 50 50 0a 58 46 6f 72 20 | 63 6f 6e 73 65 72 76 69 |PP.XFor |conservi|
|00004960| 6e 67 20 73 70 61 63 65 | 2c 20 52 43 53 20 73 74 |ng space|, RCS st|
|00004970| 6f 72 65 73 20 72 65 76 | 69 73 69 6f 6e 73 20 69 |ores rev|isions i|
|00004980| 6e 20 74 68 65 20 66 6f | 72 6d 0a 58 6f 66 20 64 |n the fo|rm.Xof d|
|00004990| 65 6c 74 61 73 2c 20 69 | 2e 65 2e 2c 20 61 73 20 |eltas, i|.e., as |
|000049a0| 64 69 66 66 65 72 65 6e | 63 65 73 20 62 65 74 77 |differen|ces betw|
|000049b0| 65 65 6e 20 72 65 76 69 | 73 69 6f 6e 73 2e 0a 58 |een revi|sions..X|
|000049c0| 54 68 65 20 75 73 65 72 | 20 69 6e 74 65 72 66 61 |The user| interfa|
|000049d0| 63 65 20 63 6f 6d 70 6c | 65 74 65 6c 79 20 68 69 |ce compl|etely hi|
|000049e0| 64 65 73 20 74 68 69 73 | 20 66 61 63 74 2e 0a 58 |des this| fact..X|
|000049f0| 2e 50 50 0a 58 41 20 64 | 65 6c 74 61 20 69 73 20 |.PP.XA d|elta is |
|00004a00| 61 20 73 65 71 75 65 6e | 63 65 20 6f 66 20 65 64 |a sequen|ce of ed|
|00004a10| 69 74 20 63 6f 6d 6d 61 | 6e 64 73 20 74 68 61 74 |it comma|nds that|
|00004a20| 20 74 72 61 6e 73 66 6f | 72 6d 73 20 6f 6e 65 20 | transfo|rms one |
|00004a30| 73 74 72 69 6e 67 0a 58 | 69 6e 74 6f 20 61 6e 6f |string.X|into ano|
|00004a40| 74 68 65 72 2e 20 20 54 | 68 65 20 64 65 6c 74 61 |ther.  T|he delta|
|00004a50| 73 20 65 6d 70 6c 6f 79 | 65 64 20 62 79 20 52 43 |s employ|ed by RC|
|00004a60| 53 20 61 72 65 20 6c 69 | 6e 65 2d 62 61 73 65 64 |S are li|ne-based|
|00004a70| 2c 20 77 68 69 63 68 20 | 6d 65 61 6e 73 0a 58 74 |, which |means.Xt|
|00004a80| 68 61 74 20 74 68 65 20 | 6f 6e 6c 79 20 65 64 69 |hat the |only edi|
|00004a90| 74 20 63 6f 6d 6d 61 6e | 64 73 20 61 6c 6c 6f 77 |t comman|ds allow|
|00004aa0| 65 64 20 61 72 65 20 69 | 6e 73 65 72 74 69 6f 6e |ed are i|nsertion|
|00004ab0| 20 61 6e 64 20 64 65 6c | 65 74 69 6f 6e 20 6f 66 | and del|etion of|
|00004ac0| 20 6c 69 6e 65 73 2e 0a | 58 49 66 20 61 20 73 69 | lines..|XIf a si|
|00004ad0| 6e 67 6c 65 20 63 68 61 | 72 61 63 74 65 72 20 69 |ngle cha|racter i|
|00004ae0| 6e 20 61 20 6c 69 6e 65 | 20 69 73 20 63 68 61 6e |n a line| is chan|
|00004af0| 67 65 64 2c 20 74 68 65 | 0a 58 65 64 69 74 20 73 |ged, the|.Xedit s|
|00004b00| 63 72 69 70 74 73 20 63 | 6f 6e 73 69 64 65 72 20 |cripts c|onsider |
|00004b10| 74 68 65 20 65 6e 74 69 | 72 65 20 6c 69 6e 65 20 |the enti|re line |
|00004b20| 63 68 61 6e 67 65 64 2e | 0a 58 54 68 65 20 70 72 |changed.|.XThe pr|
|00004b30| 6f 67 72 61 6d 20 5c 66 | 49 64 69 66 66 5c 66 52 |ogram \f|Idiff\fR|
|00004b40| 5c 75 32 5c 64 0a 58 70 | 72 6f 64 75 63 65 73 20 |\u2\d.Xp|roduces |
|00004b50| 61 20 73 6d 61 6c 6c 2c | 20 6c 69 6e 65 2d 62 61 |a small,| line-ba|
|00004b60| 73 65 64 20 64 65 6c 74 | 61 20 62 65 74 77 65 65 |sed delt|a betwee|
|00004b70| 6e 20 70 61 69 72 73 20 | 6f 66 20 74 65 78 74 20 |n pairs |of text |
|00004b80| 66 69 6c 65 73 2e 0a 58 | 41 20 63 68 61 72 61 63 |files..X|A charac|
|00004b90| 74 65 72 2d 62 61 73 65 | 64 20 65 64 69 74 20 73 |ter-base|d edit s|
|00004ba0| 63 72 69 70 74 20 77 6f | 75 6c 64 20 74 61 6b 65 |cript wo|uld take|
|00004bb0| 20 6d 75 63 68 20 6c 6f | 6e 67 65 72 20 74 6f 20 | much lo|nger to |
|00004bc0| 63 6f 6d 70 75 74 65 2c | 0a 58 61 6e 64 20 77 6f |compute,|.Xand wo|
|00004bd0| 75 6c 64 20 6e 6f 74 20 | 62 65 20 73 69 67 6e 69 |uld not |be signi|
|00004be0| 66 69 63 61 6e 74 6c 79 | 20 73 68 6f 72 74 65 72 |ficantly| shorter|
|00004bf0| 2e 0a 58 2e 50 50 0a 58 | 55 73 69 6e 67 20 64 65 |..X.PP.X|Using de|
|00004c00| 6c 74 61 73 20 69 73 20 | 61 20 63 6c 61 73 73 69 |ltas is |a classi|
|00004c10| 63 61 6c 20 73 70 61 63 | 65 2d 74 69 6d 65 20 74 |cal spac|e-time t|
|00004c20| 72 61 64 65 6f 66 66 3a | 20 64 65 6c 74 61 73 20 |radeoff:| deltas |
|00004c30| 72 65 64 75 63 65 20 74 | 68 65 0a 58 73 70 61 63 |reduce t|he.Xspac|
|00004c40| 65 20 63 6f 6e 73 75 6d | 65 64 2c 20 62 75 74 20 |e consum|ed, but |
|00004c50| 69 6e 63 72 65 61 73 65 | 20 61 63 63 65 73 73 20 |increase| access |
|00004c60| 74 69 6d 65 2e 0a 58 48 | 6f 77 65 76 65 72 2c 20 |time..XH|owever, |
|00004c70| 61 20 76 65 72 73 69 6f | 6e 20 63 6f 6e 74 72 6f |a versio|n contro|
|00004c80| 6c 20 74 6f 6f 6c 20 73 | 68 6f 75 6c 64 20 69 6d |l tool s|hould im|
|00004c90| 70 6f 73 65 20 61 73 20 | 6c 69 74 74 6c 65 20 64 |pose as |little d|
|00004ca0| 65 6c 61 79 0a 58 61 73 | 20 70 6f 73 73 69 62 6c |elay.Xas| possibl|
|00004cb0| 65 20 6f 6e 20 70 72 6f | 67 72 61 6d 6d 65 72 73 |e on pro|grammers|
|00004cc0| 2e 0a 58 45 78 63 65 73 | 73 69 76 65 20 64 65 6c |..XExces|sive del|
|00004cd0| 61 79 73 20 64 69 73 63 | 6f 75 72 61 67 65 20 74 |ays disc|ourage t|
|00004ce0| 68 65 20 75 73 65 20 6f | 66 20 76 65 72 73 69 6f |he use o|f versio|
|00004cf0| 6e 20 63 6f 6e 74 72 6f | 6c 73 2c 0a 58 6f 72 20 |n contro|ls,.Xor |
|00004d00| 69 6e 64 75 63 65 20 70 | 72 6f 67 72 61 6d 6d 65 |induce p|rogramme|
|00004d10| 72 73 20 74 6f 20 74 61 | 6b 65 20 73 68 6f 72 74 |rs to ta|ke short|
|00004d20| 63 75 74 73 20 74 68 61 | 74 20 63 6f 6d 70 72 6f |cuts tha|t compro|
|00004d30| 6d 69 73 65 20 73 79 73 | 74 65 6d 20 69 6e 74 65 |mise sys|tem inte|
|00004d40| 67 72 69 74 79 2e 0a 58 | 54 6f 20 67 61 69 6e 20 |grity..X|To gain |
|00004d50| 72 65 61 73 6f 6e 61 62 | 6c 79 20 66 61 73 74 20 |reasonab|ly fast |
|00004d60| 61 63 63 65 73 73 20 74 | 69 6d 65 20 66 6f 72 20 |access t|ime for |
|00004d70| 62 6f 74 68 20 65 64 69 | 74 69 6e 67 20 61 6e 64 |both edi|ting and|
|00004d80| 20 63 6f 6d 70 69 6c 69 | 6e 67 2c 0a 58 52 43 53 | compili|ng,.XRCS|
|00004d90| 20 61 72 72 61 6e 67 65 | 73 20 64 65 6c 74 61 73 | arrange|s deltas|
|00004da0| 20 69 6e 20 74 68 65 20 | 66 6f 6c 6c 6f 77 69 6e | in the |followin|
|00004db0| 67 20 77 61 79 2e 0a 58 | 54 68 65 20 6d 6f 73 74 |g way..X|The most|
|00004dc0| 20 72 65 63 65 6e 74 20 | 72 65 76 69 73 69 6f 6e | recent |revision|
|00004dd0| 20 6f 6e 20 74 68 65 20 | 74 72 75 6e 6b 20 69 73 | on the |trunk is|
|00004de0| 20 73 74 6f 72 65 64 20 | 69 6e 74 61 63 74 2e 0a | stored |intact..|
|00004df0| 58 41 6c 6c 20 6f 74 68 | 65 72 20 72 65 76 69 73 |XAll oth|er revis|
|00004e00| 69 6f 6e 73 20 6f 6e 20 | 74 68 65 20 74 72 75 6e |ions on |the trun|
|00004e10| 6b 20 61 72 65 20 73 74 | 6f 72 65 64 20 61 73 20 |k are st|ored as |
|00004e20| 72 65 76 65 72 73 65 20 | 64 65 6c 74 61 73 2e 0a |reverse |deltas..|
|00004e30| 58 41 20 72 65 76 65 72 | 73 65 20 64 65 6c 74 61 |XA rever|se delta|
|00004e40| 20 64 65 73 63 72 69 62 | 65 73 20 68 6f 77 20 74 | describ|es how t|
|00004e50| 6f 20 67 6f 20 62 61 63 | 6b 77 61 72 64 20 69 6e |o go bac|kward in|
|00004e60| 20 74 68 65 20 64 65 76 | 65 6c 6f 70 6d 65 6e 74 | the dev|elopment|
|00004e70| 20 68 69 73 74 6f 72 79 | 3a 0a 58 69 74 20 70 72 | history|:.Xit pr|
|00004e80| 6f 64 75 63 65 73 20 74 | 68 65 20 64 65 73 69 72 |oduces t|he desir|
|00004e90| 65 64 20 72 65 76 69 73 | 69 6f 6e 20 69 66 20 61 |ed revis|ion if a|
|00004ea0| 70 70 6c 69 65 64 20 74 | 6f 20 74 68 65 20 73 75 |pplied t|o the su|
|00004eb0| 63 63 65 73 73 6f 72 20 | 6f 66 20 74 68 61 74 20 |ccessor |of that |
|00004ec0| 72 65 76 69 73 69 6f 6e | 2e 0a 58 54 68 69 73 20 |revision|..XThis |
|00004ed0| 69 6d 70 6c 65 6d 65 6e | 74 61 74 69 6f 6e 20 68 |implemen|tation h|
|00004ee0| 61 73 20 74 68 65 20 61 | 64 76 61 6e 74 61 67 65 |as the a|dvantage|
|00004ef0| 0a 58 74 68 61 74 20 65 | 78 74 72 61 63 74 69 6f |.Xthat e|xtractio|
|00004f00| 6e 20 6f 66 20 74 68 65 | 20 6c 61 74 65 73 74 20 |n of the| latest |
|00004f10| 72 65 76 69 73 69 6f 6e | 20 69 73 20 61 20 73 69 |revision| is a si|
|00004f20| 6d 70 6c 65 20 61 6e 64 | 20 66 61 73 74 20 63 6f |mple and| fast co|
|00004f30| 70 79 0a 58 6f 70 65 72 | 61 74 69 6f 6e 2e 0a 58 |py.Xoper|ation..X|
|00004f40| 41 64 64 69 6e 67 20 61 | 20 6e 65 77 20 72 65 76 |Adding a| new rev|
|00004f50| 69 73 69 6f 6e 20 74 6f | 20 74 68 65 20 74 72 75 |ision to| the tru|
|00004f60| 6e 6b 20 69 73 20 61 6c | 73 6f 20 66 61 73 74 3a |nk is al|so fast:|
|00004f70| 20 5c 66 49 63 69 5c 66 | 52 20 73 69 6d 70 6c 79 | \fIci\f|R simply|
|00004f80| 0a 58 61 64 64 73 20 74 | 68 65 20 6e 65 77 20 72 |.Xadds t|he new r|
|00004f90| 65 76 69 73 69 6f 6e 20 | 69 6e 74 61 63 74 2c 20 |evision |intact, |
|00004fa0| 72 65 70 6c 61 63 65 73 | 20 74 68 65 20 70 72 65 |replaces| the pre|
|00004fb0| 76 69 6f 75 73 0a 58 72 | 65 76 69 73 69 6f 6e 20 |vious.Xr|evision |
|00004fc0| 77 69 74 68 20 61 20 72 | 65 76 65 72 73 65 20 64 |with a r|everse d|
|00004fd0| 65 6c 74 61 2c 20 61 6e | 64 20 6b 65 65 70 73 20 |elta, an|d keeps |
|00004fe0| 74 68 65 20 72 65 73 74 | 20 6f 66 20 74 68 65 20 |the rest| of the |
|00004ff0| 6f 6c 64 20 64 65 6c 74 | 61 73 2e 0a 58 54 68 75 |old delt|as..XThu|
|00005000| 73 2c 20 5c 66 49 63 69 | 5c 66 52 20 72 65 71 75 |s, \fIci|\fR requ|
|00005010| 69 72 65 73 20 74 68 65 | 20 63 6f 6d 70 75 74 61 |ires the| computa|
|00005020| 74 69 6f 6e 0a 58 6f 66 | 20 6f 6e 6c 79 20 6f 6e |tion.Xof| only on|
|00005030| 65 20 6e 65 77 20 64 65 | 6c 74 61 2e 0a 58 2e 50 |e new de|lta..X.P|
|00005040| 50 0a 58 42 72 61 6e 63 | 68 65 73 20 6e 65 65 64 |P.XBranc|hes need|
|00005050| 20 73 70 65 63 69 61 6c | 20 74 72 65 61 74 6d 65 | special| treatme|
|00005060| 6e 74 2e 20 20 54 68 65 | 20 6e 61 69 76 65 20 73 |nt.  The| naive s|
|00005070| 6f 6c 75 74 69 6f 6e 20 | 77 6f 75 6c 64 20 62 65 |olution |would be|
|00005080| 20 74 6f 0a 58 73 74 6f | 72 65 20 63 6f 6d 70 6c | to.Xsto|re compl|
|00005090| 65 74 65 20 63 6f 70 69 | 65 73 20 66 6f 72 20 74 |ete copi|es for t|
|000050a0| 68 65 20 74 69 70 73 20 | 6f 66 20 61 6c 6c 20 62 |he tips |of all b|
|000050b0| 72 61 6e 63 68 65 73 2e | 0a 58 43 6c 65 61 72 6c |ranches.|.XClearl|
|000050c0| 79 2c 20 74 68 69 73 20 | 61 70 70 72 6f 61 63 68 |y, this |approach|
|000050d0| 20 77 6f 75 6c 64 20 63 | 6f 73 74 20 74 6f 6f 20 | would c|ost too |
|000050e0| 6d 75 63 68 20 73 70 61 | 63 65 2e 20 20 49 6e 73 |much spa|ce.  Ins|
|000050f0| 74 65 61 64 2c 0a 58 52 | 43 53 20 75 73 65 73 20 |tead,.XR|CS uses |
|00005100| 5c 66 49 66 6f 72 77 61 | 72 64 5c 66 52 20 64 65 |\fIforwa|rd\fR de|
|00005110| 6c 74 61 73 20 66 6f 72 | 20 62 72 61 6e 63 68 65 |ltas for| branche|
|00005120| 73 2e 20 20 52 65 67 65 | 6e 65 72 61 74 69 6e 67 |s.  Rege|nerating|
|00005130| 20 61 20 72 65 76 69 73 | 69 6f 6e 0a 58 6f 6e 20 | a revis|ion.Xon |
|00005140| 61 20 73 69 64 65 20 62 | 72 61 6e 63 68 20 70 72 |a side b|ranch pr|
|00005150| 6f 63 65 65 64 73 20 61 | 73 20 66 6f 6c 6c 6f 77 |oceeds a|s follow|
|00005160| 73 2e 20 20 46 69 72 73 | 74 2c 20 65 78 74 72 61 |s.  Firs|t, extra|
|00005170| 63 74 20 74 68 65 20 6c | 61 74 65 73 74 20 72 65 |ct the l|atest re|
|00005180| 76 69 73 69 6f 6e 0a 58 | 6f 6e 20 74 68 65 20 74 |vision.X|on the t|
|00005190| 72 75 6e 6b 3b 20 73 65 | 63 6f 6e 64 6c 79 2c 20 |runk; se|condly, |
|000051a0| 61 70 70 6c 79 20 72 65 | 76 65 72 73 65 20 64 65 |apply re|verse de|
|000051b0| 6c 74 61 73 20 75 6e 74 | 69 6c 20 74 68 65 20 66 |ltas unt|il the f|
|000051c0| 6f 72 6b 20 72 65 76 69 | 73 69 6f 6e 20 66 6f 72 |ork revi|sion for|
|000051d0| 0a 58 74 68 65 20 62 72 | 61 6e 63 68 20 69 73 20 |.Xthe br|anch is |
|000051e0| 6f 62 74 61 69 6e 65 64 | 3b 20 74 68 69 72 64 6c |obtained|; thirdl|
|000051f0| 79 2c 20 61 70 70 6c 79 | 20 66 6f 72 77 61 72 64 |y, apply| forward|
|00005200| 20 64 65 6c 74 61 73 20 | 75 6e 74 69 6c 20 74 68 | deltas |until th|
|00005210| 65 20 64 65 73 69 72 65 | 64 0a 58 62 72 61 6e 63 |e desire|d.Xbranc|
|00005220| 68 20 72 65 76 69 73 69 | 6f 6e 20 69 73 20 72 65 |h revisi|on is re|
|00005230| 61 63 68 65 64 2e 20 20 | 46 69 67 75 72 65 20 35 |ached.  |Figure 5|
|00005240| 20 69 6c 6c 75 73 74 72 | 61 74 65 73 20 61 20 74 | illustr|ates a t|
|00005250| 72 65 65 20 77 69 74 68 | 0a 58 6f 6e 65 20 73 69 |ree with|.Xone si|
|00005260| 64 65 20 62 72 61 6e 63 | 68 2e 20 20 54 72 69 61 |de branc|h.  Tria|
|00005270| 6e 67 6c 65 73 20 70 6f | 69 6e 74 69 6e 67 20 74 |ngles po|inting t|
|00005280| 6f 20 74 68 65 20 6c 65 | 66 74 20 61 6e 64 20 72 |o the le|ft and r|
|00005290| 69 67 68 74 20 72 65 70 | 72 65 73 65 6e 74 0a 58 |ight rep|resent.X|
|000052a0| 72 65 76 65 72 73 65 20 | 61 6e 64 20 66 6f 72 77 |reverse |and forw|
|000052b0| 61 72 64 20 64 65 6c 74 | 61 73 2c 20 72 65 73 70 |ard delt|as, resp|
|000052c0| 65 63 74 69 76 65 6c 79 | 2e 0a 58 2e 6e 65 20 38 |ectively|..X.ne 8|
|000052d0| 0a 58 2e 50 53 20 20 34 | 69 0a 58 2e 70 73 20 2d |.X.PS  4|i.X.ps -|
|000052e0| 32 0a 58 64 65 66 69 6e | 65 20 42 44 20 58 20 5b |2.Xdefin|e BD X [|
|000052f0| 6c 69 6e 65 20 69 6e 76 | 69 73 20 24 31 20 72 69 |line inv|is $1 ri|
|00005300| 67 68 74 20 2e 35 3b 0a | 58 6c 69 6e 65 20 75 70 |ght .5;.|Xline up|
|00005310| 20 2e 33 20 74 68 65 6e | 20 6c 65 66 74 20 2e 35 | .3 then| left .5|
|00005320| 20 64 6f 77 6e 20 2e 33 | 20 74 68 65 6e 20 72 69 | down .3| then ri|
|00005330| 67 68 74 20 2e 35 20 64 | 6f 77 6e 20 2e 33 20 74 |ght .5 d|own .3 t|
|00005340| 68 65 6e 20 75 70 20 2e | 33 5d 20 58 0a 58 0a 58 |hen up .|3] X.X.X|
|00005350| 64 65 66 69 6e 65 20 46 | 44 20 58 20 5b 6c 69 6e |define F|D X [lin|
|00005360| 65 20 69 6e 76 69 73 20 | 24 31 20 72 69 67 68 74 |e invis |$1 right|
|00005370| 20 2e 35 3b 0a 58 6c 69 | 6e 65 20 6c 65 66 74 20 | .5;.Xli|ne left |
|00005380| 2e 35 20 64 6f 77 6e 20 | 2e 33 20 74 68 65 6e 20 |.5 down |.3 then |
|00005390| 75 70 20 2e 36 20 74 68 | 65 6e 20 72 69 67 68 74 |up .6 th|en right|
|000053a0| 20 2e 35 20 64 6f 77 6e | 20 2e 33 3b 5d 20 58 0a | .5 down| .3;] X.|
|000053b0| 58 0a 58 72 69 67 68 74 | 0a 58 44 31 31 3a 20 20 |X.Xright|.XD11:  |
|000053c0| 20 20 42 44 28 22 20 31 | 2e 31 22 29 0a 58 09 61 |  BD(" 1|.1").X.a|
|000053d0| 72 72 6f 77 20 72 69 67 | 68 74 20 66 72 6f 6d 20 |rrow rig|ht from |
|000053e0| 44 31 31 2e 65 0a 58 44 | 31 32 3a 20 20 20 20 42 |D11.e.XD|12:    B|
|000053f0| 44 28 22 20 31 2e 32 22 | 29 0a 58 09 61 72 72 6f |D(" 1.2"|).X.arro|
|00005400| 77 20 20 72 69 67 68 74 | 20 66 72 6f 6d 20 44 31 |w  right| from D1|
|00005410| 32 2e 65 0a 58 44 31 33 | 3a 20 20 20 20 42 44 28 |2.e.XD13|:    BD(|
|00005420| 22 20 31 2e 33 22 29 0a | 58 09 61 72 72 6f 77 20 |" 1.3").|X.arrow |
|00005430| 20 72 69 67 68 74 20 66 | 72 6f 6d 20 44 31 33 2e | right f|rom D13.|
|00005440| 65 0a 58 44 32 31 3a 20 | 20 20 20 42 44 28 22 20 |e.XD21: |   BD(" |
|00005450| 32 2e 31 22 29 0a 58 09 | 61 72 72 6f 77 20 20 72 |2.1").X.|arrow  r|
|00005460| 69 67 68 74 20 66 72 6f | 6d 20 44 32 31 2e 65 0a |ight fro|m D21.e.|
|00005470| 58 44 32 32 3a 20 20 20 | 20 62 6f 78 20 22 32 2e |XD22:   | box "2.|
|00005480| 32 22 0a 58 09 6c 69 6e | 65 20 69 6e 76 69 73 20 |2".X.lin|e invis |
|00005490| 64 6f 77 6e 20 66 72 6f | 6d 20 44 32 31 2e 73 0a |down fro|m D21.s.|
|000054a0| 58 46 31 3a 20 20 20 20 | 20 46 44 28 22 31 2e 33 |XF1:    | FD("1.3|
|000054b0| 2e 31 2e 31 20 22 29 0a | 58 09 61 72 72 6f 77 20 |.1.1 ").|X.arrow |
|000054c0| 66 72 6f 6d 20 44 31 33 | 2e 73 65 20 74 6f 20 46 |from D13|.se to F|
|000054d0| 31 2e 77 0a 58 09 61 72 | 72 6f 77 20 66 72 6f 6d |1.w.X.ar|row from|
|000054e0| 20 46 31 2e 65 20 72 69 | 67 68 74 0a 58 09 72 69 | F1.e ri|ght.X.ri|
|000054f0| 67 68 74 0a 58 46 32 3a | 20 20 20 20 20 46 44 28 |ght.XF2:|     FD(|
|00005500| 22 31 2e 33 2e 31 2e 32 | 20 22 29 0a 58 2e 70 73 |"1.3.1.2| ").X.ps|
|00005510| 20 2b 32 0a 58 2e 50 45 | 0a 58 2e 63 65 20 31 0a | +2.X.PE|.X.ce 1.|
|00005520| 58 46 69 67 75 72 65 20 | 35 2e 20 20 41 20 72 65 |XFigure |5.  A re|
|00005530| 76 69 73 69 6f 6e 20 74 | 72 65 65 20 77 69 74 68 |vision t|ree with|
|00005540| 20 72 65 76 65 72 73 65 | 20 61 6e 64 20 66 6f 72 | reverse| and for|
|00005550| 77 61 72 64 20 64 65 6c | 74 61 73 2e 0a 58 2e 73 |ward del|tas..X.s|
|00005560| 70 20 30 0a 58 2e 50 50 | 0a 58 41 6c 74 68 6f 75 |p 0.X.PP|.XAlthou|
|00005570| 67 68 20 69 6d 70 6c 65 | 6d 65 6e 74 69 6e 67 20 |gh imple|menting |
|00005580| 66 61 73 74 20 63 68 65 | 63 6b 2d 6f 75 74 20 66 |fast che|ck-out f|
|00005590| 6f 72 20 74 68 65 20 6c | 61 74 65 73 74 20 74 72 |or the l|atest tr|
|000055a0| 75 6e 6b 20 72 65 76 69 | 73 69 6f 6e 2c 0a 58 74 |unk revi|sion,.Xt|
|000055b0| 68 69 73 20 61 72 72 61 | 6e 67 65 6d 65 6e 74 20 |his arra|ngement |
|000055c0| 68 61 73 20 74 68 65 20 | 64 69 73 61 64 76 61 6e |has the |disadvan|
|000055d0| 74 61 67 65 20 74 68 61 | 74 20 67 65 6e 65 72 61 |tage tha|t genera|
|000055e0| 74 69 6f 6e 20 6f 66 20 | 6f 74 68 65 72 20 72 65 |tion of |other re|
|000055f0| 76 69 73 69 6f 6e 73 0a | 58 74 61 6b 65 73 20 74 |visions.|Xtakes t|
|00005600| 69 6d 65 20 70 72 6f 70 | 6f 72 74 69 6f 6e 61 6c |ime prop|ortional|
|00005610| 20 74 6f 20 74 68 65 20 | 6e 75 6d 62 65 72 20 6f | to the |number o|
|00005620| 66 20 64 65 6c 74 61 73 | 20 61 70 70 6c 69 65 64 |f deltas| applied|
|00005630| 2e 20 20 46 6f 72 20 65 | 78 61 6d 70 6c 65 2c 0a |.  For e|xample,.|
|00005640| 58 72 65 67 65 6e 65 72 | 61 74 69 6e 67 20 74 68 |Xregener|ating th|
|00005650| 65 20 62 72 61 6e 63 68 | 20 74 69 70 20 69 6e 20 |e branch| tip in |
|00005660| 46 69 67 75 72 65 20 35 | 20 72 65 71 75 69 72 65 |Figure 5| require|
|00005670| 73 20 61 70 70 6c 69 63 | 61 74 69 6f 6e 20 6f 66 |s applic|ation of|
|00005680| 20 66 69 76 65 0a 58 64 | 65 6c 74 61 73 20 28 69 | five.Xd|eltas (i|
|00005690| 6e 63 6c 75 64 69 6e 67 | 20 74 68 65 20 69 6e 69 |ncluding| the ini|
|000056a0| 74 69 61 6c 20 6f 6e 65 | 29 2e 20 20 53 69 6e 63 |tial one|).  Sinc|
|000056b0| 65 20 75 73 61 67 65 20 | 73 74 61 74 69 73 74 69 |e usage |statisti|
|000056c0| 63 73 20 73 68 6f 77 20 | 74 68 61 74 0a 58 74 68 |cs show |that.Xth|
|000056d0| 65 20 6c 61 74 65 73 74 | 20 74 72 75 6e 6b 20 72 |e latest| trunk r|
|000056e0| 65 76 69 73 69 6f 6e 20 | 69 73 20 74 68 65 20 6f |evision |is the o|
|000056f0| 6e 65 20 74 68 61 74 20 | 69 73 20 72 65 74 72 69 |ne that |is retri|
|00005700| 65 76 65 64 20 69 6e 20 | 39 35 20 70 65 72 20 63 |eved in |95 per c|
|00005710| 65 6e 74 0a 58 6f 66 20 | 61 6c 6c 20 63 61 73 65 |ent.Xof |all case|
|00005720| 73 20 28 73 65 65 20 74 | 68 65 20 73 65 63 74 69 |s (see t|he secti|
|00005730| 6f 6e 20 6f 6e 20 75 73 | 61 67 65 20 73 74 61 74 |on on us|age stat|
|00005740| 69 73 74 69 63 73 29 2c | 20 62 69 61 73 69 6e 67 |istics),| biasing|
|00005750| 20 63 68 65 63 6b 2d 6f | 75 74 20 74 69 6d 65 0a | check-o|ut time.|
|00005760| 58 69 6e 20 66 61 76 6f | 72 20 6f 66 20 74 68 61 |Xin favo|r of tha|
|00005770| 74 20 72 65 76 69 73 69 | 6f 6e 20 72 65 73 75 6c |t revisi|on resul|
|00005780| 74 73 20 69 6e 20 73 69 | 67 6e 69 66 69 63 61 6e |ts in si|gnifican|
|00005790| 74 20 73 61 76 69 6e 67 | 73 2e 0a 58 48 6f 77 65 |t saving|s..XHowe|
|000057a0| 76 65 72 2c 20 63 61 72 | 65 66 75 6c 20 69 6d 70 |ver, car|eful imp|
|000057b0| 6c 65 6d 65 6e 74 61 74 | 69 6f 6e 20 6f 66 20 74 |lementat|ion of t|
|000057c0| 68 65 20 64 65 6c 74 61 | 20 61 70 70 6c 69 63 61 |he delta| applica|
|000057d0| 74 69 6f 6e 20 70 72 6f | 63 65 73 73 20 69 73 0a |tion pro|cess is.|
|000057e0| 58 6e 65 63 65 73 73 61 | 72 79 20 74 6f 20 70 72 |Xnecessa|ry to pr|
|000057f0| 6f 76 69 64 65 20 6c 6f | 77 20 72 65 74 72 69 65 |ovide lo|w retrie|
|00005800| 76 61 6c 20 6f 76 65 72 | 68 65 61 64 20 66 6f 72 |val over|head for|
|00005810| 20 6f 74 68 65 72 20 72 | 65 76 69 73 69 6f 6e 73 | other r|evisions|
|00005820| 2c 20 69 6e 0a 58 70 61 | 72 74 69 63 75 6c 61 72 |, in.Xpa|rticular|
|00005830| 20 66 6f 72 20 62 72 61 | 6e 63 68 20 74 69 70 73 | for bra|nch tips|
|00005840| 2e 0a 58 2e 50 50 0a 58 | 54 68 65 72 65 20 61 72 |..X.PP.X|There ar|
|00005850| 65 20 73 65 76 65 72 61 | 6c 20 74 65 63 68 6e 69 |e severa|l techni|
|00005860| 71 75 65 73 20 66 6f 72 | 20 64 65 6c 74 61 20 61 |ques for| delta a|
|00005870| 70 70 6c 69 63 61 74 69 | 6f 6e 2e 0a 58 54 68 65 |pplicati|on..XThe|
|00005880| 20 6e 61 69 76 65 20 6f | 6e 65 20 69 73 20 74 6f | naive o|ne is to|
|00005890| 20 70 61 73 73 20 65 61 | 63 68 20 64 65 6c 74 61 | pass ea|ch delta|
|000058a0| 20 74 6f 20 61 20 67 65 | 6e 65 72 61 6c 2d 70 75 | to a ge|neral-pu|
|000058b0| 72 70 6f 73 65 20 74 65 | 78 74 20 65 64 69 74 6f |rpose te|xt edito|
|000058c0| 72 2e 0a 58 41 20 70 72 | 6f 74 6f 74 79 70 65 20 |r..XA pr|ototype |
|000058d0| 6f 66 20 52 43 53 20 69 | 6e 76 6f 6b 65 64 20 74 |of RCS i|nvoked t|
|000058e0| 68 65 20 55 4e 49 58 20 | 65 64 69 74 6f 72 20 5c |he UNIX |editor \|
|000058f0| 66 49 65 64 5c 66 52 20 | 62 6f 74 68 0a 58 66 6f |fIed\fR |both.Xfo|
|00005900| 72 20 61 70 70 6c 79 69 | 6e 67 20 64 65 6c 74 61 |r applyi|ng delta|
|00005910| 73 20 61 6e 64 20 66 6f | 72 20 65 78 70 61 6e 64 |s and fo|r expand|
|00005920| 69 6e 67 20 74 68 65 20 | 69 64 65 6e 74 69 66 69 |ing the |identifi|
|00005930| 63 61 74 69 6f 6e 20 6d | 61 72 6b 65 72 73 2e 0a |cation m|arkers..|
|00005940| 58 41 6c 74 68 6f 75 67 | 68 20 65 61 73 79 20 74 |XAlthoug|h easy t|
|00005950| 6f 20 69 6d 70 6c 65 6d | 65 6e 74 2c 20 70 65 72 |o implem|ent, per|
|00005960| 66 6f 72 6d 61 6e 63 65 | 20 77 61 73 20 70 6f 6f |formance| was poo|
|00005970| 72 2c 20 6f 77 69 6e 67 | 20 74 6f 20 74 68 65 0a |r, owing| to the.|
|00005980| 58 68 69 67 68 20 73 74 | 61 72 74 2d 75 70 20 63 |Xhigh st|art-up c|
|00005990| 6f 73 74 73 20 61 6e 64 | 20 65 78 63 65 73 73 20 |osts and| excess |
|000059a0| 67 65 6e 65 72 61 6c 69 | 74 79 20 6f 66 20 5c 66 |generali|ty of \f|
|000059b0| 49 65 64 5c 66 52 2e 20 | 20 41 6e 20 69 6e 74 65 |Ied\fR. | An inte|
|000059c0| 72 6d 65 64 69 61 74 65 | 0a 58 76 65 72 73 69 6f |rmediate|.Xversio|
|000059d0| 6e 20 6f 66 20 52 43 53 | 20 75 73 65 64 20 61 20 |n of RCS| used a |
|000059e0| 73 70 65 63 69 61 6c 2d | 70 75 72 70 6f 73 65 2c |special-|purpose,|
|000059f0| 20 73 74 72 65 61 6d 2d | 6f 72 69 65 6e 74 65 64 | stream-|oriented|
|00005a00| 20 65 64 69 74 6f 72 2e | 0a 58 54 68 69 73 20 74 | editor.|.XThis t|
|00005a10| 65 63 68 6e 69 71 75 65 | 20 72 65 64 75 63 65 64 |echnique| reduced|
|00005a20| 20 74 68 65 20 63 6f 73 | 74 20 6f 66 20 61 70 70 | the cos|t of app|
|00005a30| 6c 79 69 6e 67 20 61 20 | 64 65 6c 74 61 20 74 6f |lying a |delta to|
|00005a40| 20 74 68 65 20 63 6f 73 | 74 20 6f 66 0a 58 63 68 | the cos|t of.Xch|
|00005a50| 65 63 6b 69 6e 67 20 6f | 75 74 20 74 68 65 20 6c |ecking o|ut the l|
|00005a60| 61 74 65 73 74 20 74 72 | 75 6e 6b 20 72 65 76 69 |atest tr|unk revi|
|00005a70| 73 69 6f 6e 2e 20 20 54 | 68 65 20 72 65 61 73 6f |sion.  T|he reaso|
|00005a80| 6e 20 66 6f 72 20 74 68 | 69 73 20 62 65 68 61 76 |n for th|is behav|
|00005a90| 69 6f 72 0a 58 69 73 20 | 74 68 61 74 20 65 61 63 |ior.Xis |that eac|
|00005aa0| 68 20 64 65 6c 74 61 20 | 61 70 70 6c 69 63 61 74 |h delta |applicat|
|00005ab0| 69 6f 6e 20 69 6e 76 6f | 6c 76 65 73 20 61 20 63 |ion invo|lves a c|
|00005ac0| 6f 6d 70 6c 65 74 65 20 | 70 61 73 73 20 6f 76 65 |omplete |pass ove|
|00005ad0| 72 0a 58 74 68 65 20 70 | 72 65 63 65 64 69 6e 67 |r.Xthe p|receding|
|00005ae0| 20 72 65 76 69 73 69 6f | 6e 2e 0a 58 2e 50 50 0a | revisio|n..X.PP.|
|00005af0| 58 48 6f 77 65 76 65 72 | 2c 20 74 68 65 72 65 20 |XHowever|, there |
|00005b00| 69 73 20 61 20 6d 75 63 | 68 20 62 65 74 74 65 72 |is a muc|h better|
|00005b10| 20 61 6c 67 6f 72 69 74 | 68 6d 2e 20 20 4e 6f 74 | algorit|hm.  Not|
|00005b20| 65 20 74 68 61 74 20 74 | 68 65 20 64 65 6c 74 61 |e that t|he delta|
|00005b30| 73 20 61 72 65 0a 58 6c | 69 6e 65 20 6f 72 69 65 |s are.Xl|ine orie|
|00005b40| 6e 74 65 64 20 61 6e 64 | 20 74 68 61 74 20 6d 6f |nted and| that mo|
|00005b50| 73 74 20 6f 66 20 74 68 | 65 20 77 6f 72 6b 20 6f |st of th|e work o|
|00005b60| 66 20 61 20 73 74 72 65 | 61 6d 20 65 64 69 74 6f |f a stre|am edito|
|00005b70| 72 20 69 6e 76 6f 6c 76 | 65 73 0a 58 63 6f 70 79 |r involv|es.Xcopy|
|00005b80| 69 6e 67 20 75 6e 63 68 | 61 6e 67 65 64 20 6c 69 |ing unch|anged li|
|00005b90| 6e 65 73 20 66 72 6f 6d | 20 6f 6e 65 20 72 65 76 |nes from| one rev|
|00005ba0| 69 73 69 6f 6e 20 74 6f | 20 74 68 65 20 6e 65 78 |ision to| the nex|
|00005bb0| 74 2e 20 20 41 20 66 61 | 73 74 65 72 0a 58 61 6c |t.  A fa|ster.Xal|
|00005bc0| 67 6f 72 69 74 68 6d 20 | 61 76 6f 69 64 73 20 75 |gorithm |avoids u|
|00005bd0| 6e 6e 65 63 65 73 73 61 | 72 79 20 63 6f 70 79 69 |nnecessa|ry copyi|
|00005be0| 6e 67 20 6f 66 20 63 68 | 61 72 61 63 74 65 72 20 |ng of ch|aracter |
|00005bf0| 73 74 72 69 6e 67 73 20 | 62 79 20 75 73 69 6e 67 |strings |by using|
|00005c00| 0a 58 61 20 5c 66 49 70 | 69 65 63 65 20 74 61 62 |.Xa \fIp|iece tab|
|00005c10| 6c 65 5c 66 52 2e 0a 58 | 41 20 70 69 65 63 65 20 |le\fR..X|A piece |
|00005c20| 74 61 62 6c 65 20 69 73 | 20 61 20 6f 6e 65 2d 64 |table is| a one-d|
|00005c30| 69 6d 65 6e 73 69 6f 6e | 61 6c 20 61 72 72 61 79 |imension|al array|
|00005c40| 2c 20 73 70 65 63 69 66 | 79 69 6e 67 20 68 6f 77 |, specif|ying how|
|00005c50| 20 61 20 67 69 76 65 6e | 0a 58 72 65 76 69 73 69 | a given|.Xrevisi|
|00005c60| 6f 6e 20 69 73 20 60 70 | 69 65 63 65 64 20 74 6f |on is `p|ieced to|
|00005c70| 67 65 74 68 65 72 27 20 | 66 72 6f 6d 20 6c 69 6e |gether' |from lin|
|00005c80| 65 73 20 69 6e 20 74 68 | 65 20 52 43 53 20 66 69 |es in th|e RCS fi|
|00005c90| 6c 65 2e 0a 58 53 75 70 | 70 6f 73 65 20 70 69 65 |le..XSup|pose pie|
|00005ca0| 63 65 20 74 61 62 6c 65 | 20 5c 66 49 50 54 5c 64 |ce table| \fIPT\d|
|00005cb0| 72 5c 75 5c 66 52 20 72 | 65 70 72 65 73 65 6e 74 |r\u\fR r|epresent|
|00005cc0| 73 20 72 65 76 69 73 69 | 6f 6e 20 5c 66 49 72 5c |s revisi|on \fIr\|
|00005cd0| 66 52 2e 0a 58 54 68 65 | 6e 20 5c 66 49 50 54 5c |fR..XThe|n \fIPT\|
|00005ce0| 64 72 5c 75 5b 69 5d 5c | 66 52 20 63 6f 6e 74 61 |dr\u[i]\|fR conta|
|00005cf0| 69 6e 73 20 74 68 65 20 | 73 74 61 72 74 69 6e 67 |ins the |starting|
|00005d00| 20 70 6f 73 69 74 69 6f | 6e 20 6f 66 20 6c 69 6e | positio|n of lin|
|00005d10| 65 20 5c 66 49 69 5c 66 | 52 0a 58 6f 66 20 72 65 |e \fIi\f|R.Xof re|
|00005d20| 76 69 73 69 6f 6e 20 5c | 66 49 72 5c 66 52 2e 0a |vision \|fIr\fR..|
|00005d30| 58 41 70 70 6c 69 63 61 | 74 69 6f 6e 20 6f 66 20 |XApplica|tion of |
|00005d40| 74 68 65 20 6e 65 78 74 | 20 64 65 6c 74 61 20 74 |the next| delta t|
|00005d50| 72 61 6e 73 66 6f 72 6d | 73 20 70 69 65 63 65 20 |ransform|s piece |
|00005d60| 74 61 62 6c 65 20 5c 66 | 49 50 54 5c 64 72 5c 75 |table \f|IPT\dr\u|
|00005d70| 5c 66 52 0a 58 69 6e 74 | 6f 20 5c 66 49 50 54 5c |\fR.Xint|o \fIPT\|
|00005d80| 64 72 2b 31 5c 75 5c 66 | 52 2e 20 20 46 6f 72 20 |dr+1\u\f|R.  For |
|00005d90| 69 6e 73 74 61 6e 63 65 | 2c 20 61 20 64 65 6c 65 |instance|, a dele|
|00005da0| 74 65 20 63 6f 6d 6d 61 | 6e 64 20 72 65 6d 6f 76 |te comma|nd remov|
|00005db0| 65 73 20 61 0a 58 73 65 | 72 69 65 73 20 6f 66 20 |es a.Xse|ries of |
|00005dc0| 65 6e 74 72 69 65 73 20 | 66 72 6f 6d 20 74 68 65 |entries |from the|
|00005dd0| 20 70 69 65 63 65 20 74 | 61 62 6c 65 2e 20 20 41 | piece t|able.  A|
|00005de0| 6e 20 69 6e 73 65 72 74 | 69 6f 6e 20 63 6f 6d 6d |n insert|ion comm|
|00005df0| 61 6e 64 20 69 6e 73 65 | 72 74 73 0a 58 6e 65 77 |and inse|rts.Xnew|
|00005e00| 20 65 6e 74 72 69 65 73 | 2c 20 6d 6f 76 69 6e 67 | entries|, moving|
|00005e10| 20 74 68 65 20 65 6e 74 | 72 69 65 73 20 66 6f 6c | the ent|ries fol|
|00005e20| 6c 6f 77 69 6e 67 20 74 | 68 65 20 69 6e 73 65 72 |lowing t|he inser|
|00005e30| 74 69 6f 6e 20 70 6f 69 | 6e 74 20 66 75 72 74 68 |tion poi|nt furth|
|00005e40| 65 72 20 64 6f 77 6e 20 | 74 68 65 0a 58 61 72 72 |er down |the.Xarr|
|00005e50| 61 79 2e 20 20 54 68 65 | 20 69 6e 73 65 72 74 65 |ay.  The| inserte|
|00005e60| 64 20 65 6e 74 72 69 65 | 73 20 70 6f 69 6e 74 20 |d entrie|s point |
|00005e70| 74 6f 20 74 68 65 20 74 | 65 78 74 20 6c 69 6e 65 |to the t|ext line|
|00005e80| 73 20 69 6e 20 74 68 65 | 20 64 65 6c 74 61 2e 0a |s in the| delta..|
|00005e90| 58 54 68 75 73 2c 20 6e | 6f 20 49 2f 4f 20 69 73 |XThus, n|o I/O is|
|00005ea0| 20 69 6e 76 6f 6c 76 65 | 64 20 65 78 63 65 70 74 | involve|d except|
|00005eb0| 20 66 6f 72 20 72 65 61 | 64 69 6e 67 20 74 68 65 | for rea|ding the|
|00005ec0| 20 64 65 6c 74 61 20 69 | 74 73 65 6c 66 2e 20 20 | delta i|tself.  |
|00005ed0| 57 68 65 6e 20 61 6c 6c | 0a 58 64 65 6c 74 61 73 |When all|.Xdeltas|
|00005ee0| 20 68 61 76 65 20 62 65 | 65 6e 20 61 70 70 6c 69 | have be|en appli|
|00005ef0| 65 64 20 74 6f 20 74 68 | 65 20 70 69 65 63 65 20 |ed to th|e piece |
|00005f00| 74 61 62 6c 65 2c 20 61 | 20 73 65 71 75 65 6e 74 |table, a| sequent|
|00005f10| 69 61 6c 20 70 61 73 73 | 0a 58 74 68 72 6f 75 67 |ial pass|.Xthroug|
|00005f20| 68 20 74 68 65 20 74 61 | 62 6c 65 20 6c 6f 6f 6b |h the ta|ble look|
|00005f30| 73 20 75 70 20 65 61 63 | 68 20 6c 69 6e 65 20 69 |s up eac|h line i|
|00005f40| 6e 20 74 68 65 20 52 43 | 53 20 66 69 6c 65 20 61 |n the RC|S file a|
|00005f50| 6e 64 20 63 6f 70 69 65 | 73 20 69 74 20 74 6f 0a |nd copie|s it to.|
|00005f60| 58 74 68 65 20 6f 75 74 | 70 75 74 20 66 69 6c 65 |Xthe out|put file|
|00005f70| 2c 20 75 70 64 61 74 69 | 6e 67 20 69 64 65 6e 74 |, updati|ng ident|
|00005f80| 69 66 69 63 61 74 69 6f | 6e 20 6d 61 72 6b 65 72 |ificatio|n marker|
|00005f90| 73 20 61 74 20 74 68 65 | 20 73 61 6d 65 20 74 69 |s at the| same ti|
|00005fa0| 6d 65 2e 0a 58 4f 66 20 | 63 6f 75 72 73 65 2c 20 |me..XOf |course, |
|00005fb0| 74 68 65 20 52 43 53 20 | 66 69 6c 65 20 6d 75 73 |the RCS |file mus|
|00005fc0| 74 20 70 65 72 6d 69 74 | 20 72 61 6e 64 6f 6d 20 |t permit| random |
|00005fd0| 61 63 63 65 73 73 2c 20 | 73 69 6e 63 65 20 74 68 |access, |since th|
|00005fe0| 65 20 63 6f 70 69 65 64 | 0a 58 6c 69 6e 65 73 20 |e copied|.Xlines |
|00005ff0| 61 72 65 20 73 63 61 74 | 74 65 72 65 64 20 74 68 |are scat|tered th|
|00006000| 72 6f 75 67 68 6f 75 74 | 20 74 68 61 74 20 66 69 |roughout| that fi|
|00006010| 6c 65 2e 20 20 46 69 67 | 75 72 65 20 36 20 69 6c |le.  Fig|ure 6 il|
|00006020| 6c 75 73 74 72 61 74 65 | 73 20 61 6e 0a 58 52 43 |lustrate|s an.XRC|
|00006030| 53 20 66 69 6c 65 20 77 | 69 74 68 20 74 77 6f 20 |S file w|ith two |
|00006040| 72 65 76 69 73 69 6f 6e | 73 20 61 6e 64 20 74 68 |revision|s and th|
|00006050| 65 20 63 6f 72 72 65 73 | 70 6f 6e 64 69 6e 67 20 |e corres|ponding |
|00006060| 70 69 65 63 65 20 74 61 | 62 6c 65 73 2e 0a 58 2e |piece ta|bles..X.|
|00006070| 6e 65 20 31 33 0a 58 2e | 73 70 20 36 0a 58 2e 63 |ne 13.X.|sp 6.X.c|
|00006080| 65 20 31 0a 58 5c 66 49 | 46 69 67 75 72 65 20 36 |e 1.X\fI|Figure 6|
|00006090| 20 69 73 20 6e 6f 74 20 | 61 76 61 69 6c 61 62 6c | is not |availabl|
|000060a0| 65 2e 5c 66 50 0a 58 2e | 73 70 20 35 0a 58 2e 63 |e.\fP.X.|sp 5.X.c|
|000060b0| 65 20 31 0a 58 46 69 67 | 75 72 65 20 36 2e 20 20 |e 1.XFig|ure 6.  |
|000060c0| 41 6e 20 52 43 53 20 66 | 69 6c 65 20 61 6e 64 20 |An RCS f|ile and |
|000060d0| 69 74 73 20 70 69 65 63 | 65 20 74 61 62 6c 65 73 |its piec|e tables|
|000060e0| 0a 58 2e 73 70 20 30 0a | 58 2e 50 50 0a 58 54 68 |.X.sp 0.|X.PP.XTh|
|000060f0| 65 20 70 69 65 63 65 20 | 74 61 62 6c 65 20 61 70 |e piece |table ap|
|00006100| 70 72 6f 61 63 68 20 68 | 61 73 20 74 68 65 20 70 |proach h|as the p|
|00006110| 72 6f 70 65 72 74 79 20 | 74 68 61 74 20 74 68 65 |roperty |that the|
|00006120| 20 74 69 6d 65 20 66 6f | 72 20 61 70 70 6c 79 69 | time fo|r applyi|
|00006130| 6e 67 20 61 20 73 69 6e | 67 6c 65 0a 58 64 65 6c |ng a sin|gle.Xdel|
|00006140| 74 61 20 69 73 20 72 6f | 75 67 68 6c 79 20 64 65 |ta is ro|ughly de|
|00006150| 74 65 72 6d 69 6e 65 64 | 20 62 79 20 74 68 65 20 |termined| by the |
|00006160| 73 69 7a 65 20 6f 66 20 | 74 68 65 20 64 65 6c 74 |size of |the delt|
|00006170| 61 2c 20 61 6e 64 20 6e | 6f 74 20 62 79 20 74 68 |a, and n|ot by th|
|00006180| 65 0a 58 73 69 7a 65 20 | 6f 66 20 74 68 65 20 72 |e.Xsize |of the r|
|00006190| 65 76 69 73 69 6f 6e 2e | 20 20 46 6f 72 20 65 78 |evision.|  For ex|
|000061a0| 61 6d 70 6c 65 2c 20 69 | 66 20 61 20 64 65 6c 74 |ample, i|f a delt|
|000061b0| 61 20 69 73 0a 58 31 30 | 20 70 65 72 20 63 65 6e |a is.X10| per cen|
|000061c0| 74 20 6f 66 20 74 68 65 | 20 73 69 7a 65 20 6f 66 |t of the| size of|
|000061d0| 20 61 20 72 65 76 69 73 | 69 6f 6e 2c 20 74 68 65 | a revis|ion, the|
|000061e0| 6e 20 61 70 70 6c 79 69 | 6e 67 20 69 74 20 74 61 |n applyi|ng it ta|
|000061f0| 6b 65 73 20 6f 6e 6c 79 | 0a 58 31 30 20 70 65 72 |kes only|.X10 per|
|00006200| 20 63 65 6e 74 20 6f 66 | 20 74 68 65 20 74 69 6d | cent of| the tim|
|00006210| 65 20 74 6f 20 67 65 6e | 65 72 61 74 65 20 74 68 |e to gen|erate th|
|00006220| 65 20 6c 61 74 65 73 74 | 20 74 72 75 6e 6b 20 72 |e latest| trunk r|
|00006230| 65 76 69 73 69 6f 6e 2e | 20 20 28 54 68 65 20 73 |evision.|  (The s|
|00006240| 74 72 65 61 6d 0a 58 65 | 64 69 74 6f 72 20 77 6f |tream.Xe|ditor wo|
|00006250| 75 6c 64 20 74 61 6b 65 | 20 31 30 30 20 70 65 72 |uld take| 100 per|
|00006260| 20 63 65 6e 74 2e 29 0a | 58 2e 50 50 0a 58 54 68 | cent.).|X.PP.XTh|
|00006270| 65 72 65 20 69 73 20 61 | 6e 20 69 6d 70 6f 72 74 |ere is a|n import|
|00006280| 61 6e 74 20 61 6c 74 65 | 72 6e 61 74 69 76 65 20 |ant alte|rnative |
|00006290| 66 6f 72 20 72 65 70 72 | 65 73 65 6e 74 69 6e 67 |for repr|esenting|
|000062a0| 20 64 65 6c 74 61 73 20 | 74 68 61 74 20 61 66 66 | deltas |that aff|
|000062b0| 65 63 74 73 0a 58 70 65 | 72 66 6f 72 6d 61 6e 63 |ects.Xpe|rformanc|
|000062c0| 65 2e 20 20 53 43 43 53 | 5c 75 33 5c 64 2c 0a 58 |e.  SCCS|\u3\d,.X|
|000062d0| 61 20 70 72 65 63 75 72 | 73 6f 72 20 6f 66 20 52 |a precur|sor of R|
|000062e0| 43 53 2c 20 75 73 65 73 | 20 5c 66 49 69 6e 74 65 |CS, uses| \fIinte|
|000062f0| 72 6c 65 61 76 65 64 5c | 66 52 20 64 65 6c 74 61 |rleaved\|fR delta|
|00006300| 73 2e 0a 58 41 20 66 69 | 6c 65 20 63 6f 6e 74 61 |s..XA fi|le conta|
|00006310| 69 6e 69 6e 67 20 69 6e | 74 65 72 6c 65 61 76 65 |ining in|terleave|
|00006320| 64 20 64 65 6c 74 61 73 | 20 69 73 20 70 61 72 74 |d deltas| is part|
|00006330| 69 74 69 6f 6e 65 64 20 | 69 6e 74 6f 20 62 6c 6f |itioned |into blo|
|00006340| 63 6b 73 20 6f 66 20 6c | 69 6e 65 73 2e 0a 58 45 |cks of l|ines..XE|
|00006350| 61 63 68 20 62 6c 6f 63 | 6b 20 68 61 73 20 61 20 |ach bloc|k has a |
|00006360| 68 65 61 64 65 72 20 74 | 68 61 74 20 73 70 65 63 |header t|hat spec|
|00006370| 69 66 69 65 73 20 74 6f | 20 77 68 69 63 68 20 72 |ifies to| which r|
|00006380| 65 76 69 73 69 6f 6e 28 | 73 29 20 74 68 65 20 62 |evision(|s) the b|
|00006390| 6c 6f 63 6b 0a 58 62 65 | 6c 6f 6e 67 73 2e 20 20 |lock.Xbe|longs.  |
|000063a0| 54 68 65 20 62 6c 6f 63 | 6b 73 20 61 72 65 20 73 |The bloc|ks are s|
|000063b0| 6f 72 74 65 64 20 6f 75 | 74 20 69 6e 20 73 75 63 |orted ou|t in suc|
|000063c0| 68 20 61 20 77 61 79 20 | 74 68 61 74 20 61 20 73 |h a way |that a s|
|000063d0| 69 6e 67 6c 65 0a 58 70 | 61 73 73 20 6f 76 65 72 |ingle.Xp|ass over|
|000063e0| 20 74 68 65 20 66 69 6c | 65 20 63 61 6e 20 70 69 | the fil|e can pi|
|000063f0| 63 6b 20 75 70 20 61 6c | 6c 20 74 68 65 20 6c 69 |ck up al|l the li|
+--------+-------------------------+-------------------------+--------+--------+