Artifact f692396968e7e06de9259097922cd926bfbaa88d:
Wiki page
[Import CVS Repositories]
by
anonymous on
2007-12-05 21:02:30.
0000: 44 20 32 30 30 37 2d 31 32 2d 30 35 54 32 31 3a D 2007-12-05T21:
0010: 30 32 3a 33 30 0a 4c 20 49 6d 70 6f 72 74 5c 73 02:30.L Import\s
0020: 43 56 53 5c 73 52 65 70 6f 73 69 74 6f 72 69 65 CVS\sRepositorie
0030: 73 0a 50 20 31 66 38 37 31 31 63 66 31 37 62 36 s.P 1f8711cf17b6
0040: 38 34 63 66 32 38 39 33 62 64 63 64 65 33 31 30 84cf2893bdcde310
0050: 61 65 31 36 30 31 65 32 64 31 38 31 0a 55 20 61 ae1601e2d181.U a
0060: 6e 6f 6e 79 6d 6f 75 73 0a 57 20 35 37 38 38 0a nonymous.W 5788.
0070: 53 70 69 72 69 74 75 61 6c 20 61 6e 63 65 73 74 Spiritual ancest
0080: 6f 72 3a 20 5b 68 74 74 70 3a 2f 2f 63 76 73 32 or: [http://cvs2
0090: 73 76 6e 2e 74 69 67 72 69 73 2e 6f 72 67 2f 7c svn.tigris.org/|
00a0: 63 76 73 32 73 76 6e 5d 2e 0d 0a 0d 0a 53 69 6d cvs2svn].....Sim
00b0: 69 6c 61 72 69 74 69 65 73 3a 0d 0a 20 20 2a 20 ilarities:.. *
00c0: 20 55 73 69 6e 67 20 69 64 65 6e 74 69 63 61 6c Using identical
00d0: 20 68 69 67 68 6c 65 76 65 6c 20 61 72 63 68 69 highlevel archi
00e0: 74 65 63 74 75 72 65 20 28 70 61 73 73 2d 62 61 tecture (pass-ba
00f0: 73 65 64 29 0d 0a 20 20 2a 20 20 55 73 69 6e 67 sed).. * Using
0100: 20 73 6f 6d 65 20 73 70 65 63 69 66 69 63 20 61 some specific a
0110: 6c 67 6f 72 69 74 68 6d 73 20 28 67 72 61 70 68 lgorithms (graph
0120: 20 74 72 61 76 65 72 73 61 6c 29 2e 0d 0a 0d 0a traversal).....
0130: 44 69 66 66 65 72 65 6e 63 65 73 3a 0d 0a 20 20 Differences:..
0140: 2a 20 20 4e 6f 74 20 75 73 69 6e 67 20 61 6e 79 * Not using any
0150: 20 6f 66 20 69 74 73 20 63 6f 64 65 20 28 44 69 of its code (Di
0160: 66 66 65 72 65 6e 74 20 6c 61 6e 67 75 61 67 65 fferent language
0170: 73 20 66 6f 72 20 6f 6e 65 20 74 68 69 6e 67 2c s for one thing,
0180: 20 5b 68 74 74 70 3a 2f 2f 77 77 77 2e 70 79 74 [http://www.pyt
0190: 68 6f 6e 2e 6f 72 67 2f 7c 50 79 74 68 6f 6e 5d hon.org/|Python]
01a0: 20 74 68 65 72 65 2c 20 5b 68 74 74 70 3a 2f 2f there, [http://
01b0: 77 77 77 2e 74 63 6c 2e 74 6b 2f 7c 54 63 6c 5d www.tcl.tk/|Tcl]
01c0: 20 68 65 72 65 29 2e 0d 0a 20 20 2a 20 20 50 65 here)... * Pe
01d0: 72 73 69 73 74 65 6e 74 20 73 74 61 74 65 20 63 rsistent state c
01e0: 6f 6d 70 6c 65 74 65 6c 79 20 64 69 66 66 65 72 ompletely differ
01f0: 65 6e 74 2c 20 75 73 69 6e 67 20 5b 68 74 74 70 ent, using [http
0200: 3a 2f 2f 77 77 77 2e 73 71 6c 69 74 65 2e 6f 72 ://www.sqlite.or
0210: 67 2f 7c 73 71 6c 69 74 65 5d 20 64 61 74 61 62 g/|sqlite] datab
0220: 61 73 65 20 66 6f 72 20 61 6c 6c 20 74 68 69 6e ase for all thin
0230: 67 73 20 77 65 20 77 69 73 68 20 74 6f 20 6b 65 gs we wish to ke
0240: 65 70 20 62 65 74 77 65 65 6e 20 70 61 73 73 65 ep between passe
0250: 73 2e 0d 0a 0d 0a 3c 70 3e 0d 0a 53 74 61 74 75 s.....<p>..Statu
0260: 73 3a 0d 0a 3c 74 61 62 6c 65 20 61 6c 69 67 6e s:..<table align
0270: 3d 6c 65 66 74 20 62 6f 72 64 65 72 3d 31 3e 0d =left border=1>.
0280: 0a 3c 74 72 3e 0d 0a 3c 74 68 3e 50 61 73 73 3c .<tr>..<th>Pass<
0290: 2f 74 68 3e 0d 0a 3c 74 68 3e 44 65 73 63 72 69 /th>..<th>Descri
02a0: 70 74 69 6f 6e 3c 2f 74 68 3e 0d 0a 3c 74 68 3e ption</th>..<th>
02b0: 4e 6f 74 65 73 3c 2f 74 68 3e 0d 0a 3c 2f 74 72 Notes</th>..</tr
02c0: 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 43 6f 6c >..<tr>..<td>Col
02d0: 6c 65 63 74 41 72 3c 2f 74 64 3e 0d 0a 3c 74 64 lectAr</td>..<td
02e0: 3e 43 6f 6c 6c 65 63 74 20 61 72 63 68 69 76 65 >Collect archive
02f0: 73 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 4f 6b 3c 2f s</td>..<td>Ok</
0300: 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e td>..</tr>..<tr>
0310: 0d 0a 3c 74 64 3e 43 6f 6c 6c 65 63 74 52 65 76 ..<td>CollectRev
0320: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 43 6f 6c 6c 65 </td>..<td>Colle
0330: 63 74 20 72 65 76 69 73 69 6f 6e 73 2c 20 74 61 ct revisions, ta
0340: 67 73 2c 20 62 72 61 6e 63 68 65 73 20 28 66 69 gs, branches (fi
0350: 6c 65 20 6c 65 76 65 6c 29 3c 2f 74 64 3e 0d 0a le level)</td>..
0360: 3c 74 64 3e 4f 6b 3c 2f 74 64 3e 0d 0a 3c 2f 74 <td>Ok</td>..</t
0370: 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 43 6f r>..<tr>..<td>Co
0380: 6c 6c 61 74 65 53 79 6d 62 6f 6c 73 3c 2f 74 64 llateSymbols</td
0390: 3e 0d 0a 3c 74 64 3e 43 6f 6c 6c 61 74 65 20 73 >..<td>Collate s
03a0: 79 6d 62 6f 6c 20 28 70 72 6f 6a 65 63 74 20 6c ymbol (project l
03b0: 65 76 65 6c 29 20 66 72 6f 6d 20 74 68 65 20 66 evel) from the f
03c0: 69 6c 65 20 6c 65 76 65 6c 20 64 61 74 61 3c 2f ile level data</
03d0: 74 64 3e 0d 0a 3c 74 64 3e 4f 6b 3c 2f 74 64 3e td>..<td>Ok</td>
03e0: 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c ..</tr>..<tr>..<
03f0: 74 64 3e 46 69 6c 74 65 72 53 79 6d 62 6f 6c 73 td>FilterSymbols
0400: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 46 69 6c 74 65 </td>..<td>Filte
0410: 72 20 73 79 6d 62 6f 6c 73 2c 20 65 78 63 6c 75 r symbols, exclu
0420: 64 65 20 73 79 6d 62 6f 6c 73 20 61 6e 64 20 6c de symbols and l
0430: 69 6e 65 73 20 6f 66 20 64 65 76 65 6c 6f 70 6d ines of developm
0440: 65 6e 74 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 4f 6b ent</td>..<td>Ok
0450: 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 </td>..</tr>..<t
0460: 72 3e 0d 0a 3c 74 64 3e 49 6e 69 74 43 73 65 74 r>..<td>InitCset
0470: 73 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 43 72 65 61 s</td>..<td>Crea
0480: 74 65 20 69 6e 69 74 69 61 6c 20 63 68 61 6e 67 te initial chang
0490: 65 73 65 74 73 3c 2f 74 64 3e 0d 0a 3c 74 64 3e esets</td>..<td>
04a0: 4f 6b 2e 20 3c 62 3e 4d 65 6d 6f 72 79 20 48 6f Ok. <b>Memory Ho
04b0: 67 2c 20 53 6c 6f 77 20 63 6f 6d 6d 69 74 3c 2f g, Slow commit</
04c0: 62 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a b></td>..</tr>..
04d0: 3c 74 72 3e 0d 0a 3c 74 64 3e 43 73 65 74 44 65 <tr>..<td>CsetDe
04e0: 70 73 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 43 6f 6d ps</td>..<td>Com
04f0: 70 75 74 65 20 63 68 61 6e 67 65 73 65 74 20 64 pute changeset d
0500: 65 70 65 6e 64 65 6e 63 69 65 73 20 66 72 6f 6d ependencies from
0510: 20 72 65 76 69 73 69 6f 6e 20 64 65 70 65 6e 64 revision depend
0520: 65 6e 63 69 65 73 3c 2f 74 64 3e 0d 0a 3c 74 64 encies</td>..<td
0530: 3e 4f 6b 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d >Ok</td>..</tr>.
0540: 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 50 61 73 73 20 .<tr>..<td>Pass
0550: 42 72 65 61 6b 52 65 76 43 73 65 74 43 79 63 6c BreakRevCsetCycl
0560: 65 73 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 42 72 65 es</td>..<td>Bre
0570: 61 6b 20 63 79 63 6c 65 73 20 61 6d 6f 6e 67 20 ak cycles among
0580: 72 65 76 69 73 69 6f 6e 20 63 68 61 6e 67 65 73 revision changes
0590: 65 74 73 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 4f 6b ets</td>..<td>Ok
05a0: 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 </td>..</tr>..<t
05b0: 72 3e 0d 0a 3c 74 64 3e 52 65 76 54 6f 70 6f 6c r>..<td>RevTopol
05c0: 6f 67 69 63 61 6c 53 6f 72 74 3c 2f 74 64 3e 0d ogicalSort</td>.
05d0: 0a 3c 74 64 3e 54 6f 70 6f 6c 6f 67 69 63 61 6c .<td>Topological
05e0: 6c 79 20 73 6f 72 74 20 72 65 76 69 73 69 6f 6e ly sort revision
05f0: 20 63 68 61 6e 67 65 73 65 74 73 3c 2f 74 64 3e changesets</td>
0600: 0d 0a 3c 74 64 3e 4f 6b 3c 2f 74 64 3e 0d 0a 3c ..<td>Ok</td>..<
0610: 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e /tr>..<tr>..<td>
0620: 42 72 65 61 6b 53 79 6d 43 73 65 74 43 79 63 6c BreakSymCsetCycl
0630: 65 73 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 42 72 65 es</td>..<td>Bre
0640: 61 6b 20 63 79 63 6c 65 73 20 61 6d 6f 6e 67 20 ak cycles among
0650: 73 79 6d 62 6f 6c 20 63 68 61 6e 67 65 73 65 74 symbol changeset
0660: 73 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 4f 6b 3c 2f s</td>..<td>Ok</
0670: 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e td>..</tr>..<tr>
0680: 0d 0a 3c 74 64 3e 42 72 65 61 6b 41 6c 6c 43 73 ..<td>BreakAllCs
0690: 65 74 43 79 63 6c 65 73 3c 2f 74 64 3e 0d 0a 3c etCycles</td>..<
06a0: 74 64 3e 42 72 65 61 6b 20 63 79 63 6c 65 73 20 td>Break cycles
06b0: 6f 76 65 72 20 61 6c 6c 20 63 68 61 6e 67 65 73 over all changes
06c0: 65 74 73 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 3c 62 ets</td>..<td><b
06d0: 3e 4d 61 79 20 73 74 69 6c 6c 20 63 68 61 6e 67 >May still chang
06e0: 65 20 74 68 65 20 6f 72 64 65 72 20 6f 66 20 72 e the order of r
06f0: 65 76 69 73 69 6f 6e 20 63 68 61 6e 67 65 73 65 evision changese
0700: 74 73 20 6f 76 65 72 20 74 68 65 20 72 65 73 75 ts over the resu
0710: 6c 74 20 6f 66 20 70 61 73 73 20 37 2e 3c 2f 62 lt of pass 7.</b
0720: 3e 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c ></td>..</tr>..<
0730: 74 72 3e 0d 0a 3c 74 64 3e 41 6c 6c 54 6f 70 6f tr>..<td>AllTopo
0740: 6c 6f 67 69 63 61 6c 6c 53 6f 72 74 3c 2f 74 64 logicallSort</td
0750: 3e 0d 0a 3c 74 64 3e 54 6f 70 6f 6c 6f 67 69 63 >..<td>Topologic
0760: 61 6c 6c 79 20 73 6f 72 74 20 61 6c 6c 20 63 68 ally sort all ch
0770: 61 6e 67 65 73 65 74 73 3c 2f 74 64 3e 0d 0a 3c angesets</td>..<
0780: 74 64 3e 4f 6b 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 td>Ok</td>..</tr
0790: 3e 0d 0a 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 49 >....<tr>..<td>I
07a0: 6d 70 6f 72 74 3c 2f 74 64 3e 0d 0a 3c 74 64 3e mport</td>..<td>
07b0: 49 6d 70 6f 72 74 20 66 69 6c 65 73 20 61 6e 64 Import files and
07c0: 20 63 68 61 6e 67 65 73 65 74 73 3c 2f 74 64 3e changesets</td>
07d0: 0d 0a 3c 74 64 3e 42 65 69 6e 67 20 77 6f 72 6b ..<td>Being work
07e0: 65 64 20 6f 6e 2c 20 63 75 72 72 65 6e 74 6c 79 ed on, currently
07f0: 20 66 69 6c 65 73 3c 2f 74 64 3e 0d 0a 3c 2f 74 files</td>..</t
0800: 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 0d 0a 3c 2f r>..</table>..</
0810: 70 3e 0d 0a 0d 0a 50 61 73 73 65 73 20 74 6f 20 p>....Passes to
0820: 64 6f 3a 0d 0a 20 20 2a 20 20 50 75 74 20 63 68 do:.. * Put ch
0830: 61 6e 67 65 73 65 74 20 6f 72 64 65 72 20 66 72 angeset order fr
0840: 6f 6d 20 74 68 65 20 74 6f 70 2e 73 6f 72 74 20 om the top.sort
0850: 70 61 73 73 65 73 20 61 6e 64 20 74 72 65 65 20 passes and tree
0860: 6f 66 20 73 79 6d 62 6f 6c 73 20 66 72 6f 6d 20 of symbols from
0870: 74 68 65 20 63 6f 6c 6c 7c 46 69 6c 74 65 72 53 the coll|FilterS
0880: 79 6d 20 70 61 73 73 65 73 20 74 6f 67 65 74 68 ym passes togeth
0890: 65 72 20 69 6e 74 6f 20 61 20 74 72 65 65 20 6f er into a tree o
08a0: 66 20 63 68 61 6e 67 65 73 65 74 73 2e 20 4e 6f f changesets. No
08b0: 74 65 20 74 68 61 74 20 69 74 20 6d 69 67 68 74 te that it might
08c0: 20 6e 6f 74 20 62 65 20 61 20 74 72 65 65 20 69 not be a tree i
08d0: 66 20 74 68 65 72 65 20 69 73 20 61 6e 20 4e 54 f there is an NT
08e0: 44 42 20 61 72 6f 75 6e 64 2e 0d 0a 20 20 2a 20 DB around... *
08f0: 20 50 65 72 66 6f 72 6d 20 74 68 65 20 61 63 74 Perform the act
0900: 75 61 6c 20 69 6d 70 6f 72 74 2e 0d 0a 0d 0a 4e ual import.....N
0910: 6f 74 65 73 20 72 65 67 61 72 64 69 6e 67 20 74 otes regarding t
0920: 68 65 20 61 63 74 75 61 6c 20 69 6d 70 6f 72 74 he actual import
0930: 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 63 76 73 :..<ul>..<li>cvs
0940: 32 73 76 6e 20 69 73 20 65 69 74 68 65 72 20 73 2svn is either s
0950: 6c 6f 77 2c 20 6f 72 20 68 75 6e 67 72 79 20 66 low, or hungry f
0960: 6f 72 20 64 69 73 6b 73 70 61 63 65 2e 20 54 68 or diskspace. Th
0970: 65 20 72 65 61 73 6f 6e 3a 20 49 74 20 69 73 20 e reason: It is
0980: 69 6d 70 6f 72 74 69 6e 67 20 63 68 61 6e 67 65 importing change
0990: 73 65 74 20 62 79 20 63 68 61 6e 67 65 73 65 74 set by changeset
09a0: 20 61 6e 64 20 73 6f 20 68 61 73 20 74 6f 20 65 and so has to e
09b0: 69 74 68 65 72 20 72 65 67 65 6e 65 72 61 74 65 ither regenerate
09c0: 20 74 68 65 20 6e 65 65 64 65 64 20 72 65 76 69 the needed revi
09d0: 73 69 6f 6e 73 20 6f 66 20 74 68 65 20 66 69 6c sions of the fil
09e0: 65 73 20 6f 6e 2d 64 65 6d 61 6e 64 20 6f 76 65 es on-demand ove
09f0: 72 20 61 6e 64 20 6f 76 65 72 2c 20 6f 72 20 69 r and over, or i
0a00: 74 20 63 61 63 68 65 73 20 74 68 65 20 6e 65 65 t caches the nee
0a10: 64 65 64 20 72 65 76 69 73 69 6f 6e 73 20 77 68 ded revisions wh
0a20: 65 6e 20 63 72 65 61 74 65 64 20 75 6e 74 69 6c en created until
0a30: 20 74 68 65 20 6c 61 73 74 20 75 73 65 72 20 69 the last user i
0a40: 73 20 67 6f 6e 65 2e 0d 0a 3c 2f 6c 69 3e 0d 0a s gone...</li>..
0a50: 3c 6c 69 3e 57 65 20 63 61 6e 20 64 6f 20 62 65 <li>We can do be
0a60: 74 74 65 72 2c 20 69 66 20 77 65 20 67 65 74 20 tter, if we get
0a70: 68 65 6c 70 20 66 72 6f 6d 20 66 6f 73 73 69 6c help from fossil
0a80: 2e 20 57 65 20 77 6f 75 6c 64 20 6e 65 65 64 20 . We would need
0a90: 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 70 65 72 66 commands to perf
0aa0: 6f 72 6d 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e orm the followin
0ab0: 67 20 61 63 74 69 6f 6e 73 3a 0d 0a 3c 75 6c 3e g actions:..<ul>
0ac0: 0d 0a 3c 6c 69 3e 20 49 6d 70 6f 72 74 20 61 20 ..<li> Import a
0ad0: 66 69 6c 65 20 61 73 20 62 6c 6f 62 2c 20 72 65 file as blob, re
0ae0: 74 75 72 6e 20 69 74 73 20 69 6e 74 65 72 6e 61 turn its interna
0af0: 6c 20 69 64 2e 0d 0a 3c 2f 6c 69 3e 0d 0a 3c 6c l id...</li>..<l
0b00: 69 3e 20 44 65 6c 74 69 66 79 20 61 20 6b 6e 6f i> Deltify a kno
0b10: 77 6e 20 66 69 6c 65 20 72 65 73 70 65 63 74 69 wn file respecti
0b20: 76 65 20 74 6f 20 61 20 73 65 63 6f 6e 64 20 6b ve to a second k
0b30: 6e 6f 77 6e 20 66 69 6c 65 2e 0d 0a 3c 2f 6c 69 nown file...</li
0b40: 3e 0d 0a 3c 6c 69 3e 20 47 65 6e 65 72 61 74 65 >..<li> Generate
0b50: 20 61 20 6d 61 6e 69 66 65 73 74 20 66 69 6c 65 a manifest file
0b60: 20 66 6f 72 20 61 20 6c 69 73 74 20 6f 66 20 66 for a list of f
0b70: 69 6c 65 73 20 28 70 61 74 68 73 2c 20 69 64 73 iles (paths, ids
0b80: 29 2c 20 70 61 72 65 6e 74 20 6d 61 6e 69 66 65 ), parent manife
0b90: 73 74 20 72 65 66 65 72 65 6e 63 65 73 2c 20 75 st references, u
0ba0: 73 65 72 2c 20 74 69 6d 65 73 74 61 6d 70 2c 20 ser, timestamp,
0bb0: 6c 6f 67 20 6d 65 73 73 61 67 65 2e 20 43 6f 75 log message. Cou
0bc0: 6c 64 20 62 65 20 73 69 67 6e 65 64 20 6f 72 20 ld be signed or
0bd0: 6e 6f 74 2e 0d 0a 3c 2f 6c 69 3e 0d 0a 3c 2f 75 not...</li>..</u
0be0: 6c 3e 0d 0a 3c 62 72 3e 0d 0a 57 69 74 68 20 74 l>..<br>..With t
0bf0: 68 65 73 65 20 61 63 74 69 6f 6e 73 20 28 70 6f hese actions (po
0c00: 73 73 69 62 6c 65 20 69 6e 20 63 6f 6d 62 69 6e ssible in combin
0c10: 61 74 69 6f 6e 29 20 77 65 20 63 61 6e 20 69 6d ation) we can im
0c20: 70 6f 72 74 20 74 68 65 20 61 72 63 68 69 76 65 port the archive
0c30: 20 66 69 6c 65 73 20 66 69 72 73 74 2c 20 6e 65 files first, ne
0c40: 65 64 69 6e 67 20 6f 6e 6c 79 20 73 70 61 63 65 eding only space
0c50: 20 66 6f 72 20 74 68 65 20 72 65 76 69 73 69 6f for the revisio
0c60: 6e 73 20 6f 66 20 61 20 73 69 6e 67 6c 65 20 66 ns of a single f
0c70: 69 6c 65 20 28 62 6f 75 6e 64 65 64 20 62 79 20 ile (bounded by
0c80: 74 68 65 20 6c 61 72 67 65 73 74 20 66 69 6c 65 the largest file
0c90: 20 69 6e 20 74 65 72 6d 73 20 6f 66 20 73 69 7a in terms of siz
0ca0: 65 20 61 6e 64 20 68 69 73 74 6f 72 79 29 2c 20 e and history),
0cb0: 77 69 74 68 20 74 68 65 69 72 20 64 65 6c 74 61 with their delta
0cc0: 2d 6c 69 6e 6b 73 20 6d 69 72 72 6f 72 69 6e 67 -links mirroring
0cd0: 20 74 68 65 20 52 43 53 20 73 74 72 75 63 74 75 the RCS structu
0ce0: 72 65 2e 20 41 66 74 65 72 20 74 68 61 74 20 77 re. After that w
0cf0: 65 20 63 61 6e 20 69 6e 64 65 70 65 6e 64 65 6e e can independen
0d00: 74 6c 79 20 67 65 6e 65 72 61 74 65 2c 20 69 6d tly generate, im
0d10: 70 6f 72 74 2c 20 61 6e 64 20 64 65 6c 74 69 66 port, and deltif
0d20: 79 20 74 68 65 20 6d 61 6e 69 66 65 73 74 73 20 y the manifests
0d30: 66 6f 72 20 63 68 61 6e 67 65 73 65 74 73 2e 20 for changesets.
0d40: 74 6f 20 66 69 6e 61 6c 69 7a 65 20 77 65 20 73 to finalize we s
0d50: 69 6d 70 6c 79 20 27 72 65 62 75 69 6c 64 27 20 imply 'rebuild'
0d60: 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 2e 20 the repository.
0d70: 54 68 69 73 20 73 68 6f 75 6c 64 20 62 65 20 66 This should be f
0d80: 61 73 74 20 77 69 74 68 6f 75 74 20 6e 65 65 64 ast without need
0d90: 69 6e 67 20 6d 75 63 68 20 74 65 6d 70 6f 72 61 ing much tempora
0da0: 72 79 20 64 69 73 6b 20 73 70 61 63 65 20 65 69 ry disk space ei
0db0: 74 68 65 72 2e 0d 0a 3c 62 72 3e 0d 0a 43 75 72 ther...<br>..Cur
0dc0: 72 65 6e 74 6c 79 20 49 20 61 6d 20 74 68 69 6e rently I am thin
0dd0: 6b 69 6e 67 20 61 62 6f 75 74 20 77 61 6e 74 69 king about wanti
0de0: 6e 67 20 61 20 63 6f 6d 6d 61 6e 64 0d 0a 3c 70 ng a command..<p
0df0: 72 65 3e 0d 0a 66 6f 73 73 69 6c 20 69 6d 70 6f re>..fossil impo
0e00: 72 74 2d 66 69 6c 65 73 20 53 50 45 43 46 49 4c rt-files SPECFIL
0e10: 45 0d 0a 3c 2f 70 72 65 3e 0d 0a 77 68 69 63 68 E..</pre>..which
0e20: 20 69 6d 70 6f 72 74 73 20 61 6e 64 20 64 65 6c imports and del
0e30: 74 69 66 69 65 73 20 66 69 6c 65 73 20 61 73 20 tifies files as
0e40: 62 6c 6f 62 20 70 65 72 20 74 68 65 20 53 50 45 blob per the SPE
0e50: 43 46 49 4c 45 2c 20 72 65 74 75 72 6e 69 6e 67 CFILE, returning
0e60: 20 6f 6e 20 73 74 64 6f 75 74 20 74 68 65 20 61 on stdout the a
0e70: 73 73 6f 63 69 61 74 65 64 20 6f 66 20 70 61 74 ssociated of pat
0e80: 68 73 20 61 6e 64 20 69 6e 74 65 72 6e 61 6c 20 hs and internal
0e90: 69 64 73 2e 20 45 78 61 6d 70 6c 65 20 53 50 45 ids. Example SPE
0ea0: 43 46 49 4c 45 3a 0d 0a 3c 70 72 65 3e 0d 0a 46 CFILE:..<pre>..F
0eb0: 20 70 61 74 68 31 0d 0a 44 20 70 61 74 68 32 20 path1..D path2
0ec0: 70 61 74 68 31 0d 0a 2e 2e 2e 0d 0a 3c 2f 70 72 path1.......</pr
0ed0: 65 3e 0d 0a 54 68 65 20 27 46 27 20 63 61 72 64 e>..The 'F' card
0ee0: 20 74 65 6c 6c 73 20 69 74 20 74 6f 20 69 6d 70 tells it to imp
0ef0: 6f 72 74 20 27 70 61 74 68 31 27 20 61 73 20 69 ort 'path1' as i
0f00: 73 2e 20 54 68 65 20 27 44 27 20 63 61 72 64 20 s. The 'D' card
0f10: 74 68 65 6e 20 74 65 6c 6c 73 20 69 74 20 74 6f then tells it to
0f20: 20 69 6d 70 6f 72 74 20 27 70 61 74 68 32 27 20 import 'path2'
0f30: 61 73 20 69 73 20 61 6e 64 20 74 68 65 6e 20 64 as is and then d
0f40: 65 6c 74 69 66 79 20 27 70 61 74 68 31 27 20 69 eltify 'path1' i
0f50: 6e 20 74 65 72 6d 73 20 6f 66 20 27 70 61 74 68 n terms of 'path
0f60: 32 27 2e 20 41 6e 64 20 73 6f 20 6f 6e 2e 0d 0a 2'. And so on...
0f70: 3c 62 72 3e 0d 0a 54 6f 20 69 6d 70 6f 72 74 20 <br>..To import
0f80: 61 6e 20 52 43 53 20 61 72 63 68 69 76 65 20 77 an RCS archive w
0f90: 65 20 6e 6f 77 20 6a 75 73 74 20 68 61 76 65 20 e now just have
0fa0: 74 6f 20 67 65 6e 65 72 61 74 65 20 74 68 65 20 to generate the
0fb0: 66 75 6c 6c 20 72 65 76 69 73 69 6f 6e 73 20 69 full revisions i
0fc0: 6e 20 73 6f 6d 65 20 74 65 6d 70 64 69 72 2c 20 n some tempdir,
0fd0: 74 68 65 6e 20 63 72 65 61 74 65 20 61 20 53 50 then create a SP
0fe0: 45 43 20 73 68 6f 77 69 6e 67 20 74 68 65 20 64 EC showing the d
0ff0: 65 6c 74 61 2d 6c 69 6e 6b 73 20 61 6e 64 20 6c elta-links and l
1000: 65 74 20 66 6f 73 73 69 6c 20 68 61 76 65 20 74 et fossil have t
1010: 68 69 73 2e 20 54 68 65 20 72 65 73 75 6c 74 69 his. The resulti
1020: 6e 67 20 69 64 73 20 74 68 65 6e 20 67 6f 20 69 ng ids then go i
1030: 6e 74 6f 20 74 68 65 20 69 6d 70 6f 72 74 65 72 nto the importer
1040: 20 73 74 61 74 65 20 66 6f 72 20 77 68 65 6e 20 state for when
1050: 77 65 20 67 65 6e 65 72 61 74 65 20 74 68 65 20 we generate the
1060: 6d 61 6e 69 66 65 73 74 73 2e 0d 0a 3c 62 72 3e manifests...<br>
1070: 0d 0a 54 6f 20 69 6d 70 6f 72 74 20 6d 61 6e 69 ..To import mani
1080: 66 65 73 74 73 20 77 65 20 6e 65 65 64 20 73 65 fests we need se
1090: 63 6f 6e 64 20 63 6f 6d 6d 61 6e 64 2c 20 77 68 cond command, wh
10a0: 69 63 68 20 67 65 6e 65 72 61 74 65 73 20 69 74 ich generates it
10b0: 20 66 72 6f 6d 20 63 68 61 6e 67 65 73 65 74 20 from changeset
10c0: 64 61 74 61 2c 20 61 6e 64 20 69 6d 70 6f 72 74 data, and import
10d0: 73 20 69 74 20 74 6f 6f 2e 0d 0a 3c 70 72 65 3e s it too...<pre>
10e0: 0d 0a 66 6f 73 73 69 6c 20 69 6d 70 6f 72 74 2d ..fossil import-
10f0: 6d 61 6e 69 66 65 73 74 20 75 73 65 72 20 74 69 manifest user ti
1100: 6d 65 73 74 61 6d 70 20 4d 45 53 53 41 47 45 46 mestamp MESSAGEF
1110: 49 4c 45 20 46 49 4c 45 46 49 4c 45 20 70 61 72 ILE FILEFILE par
1120: 65 6e 74 2e 2e 2e 0d 0a 3c 2f 70 72 65 3e 0d 0a ent.....</pre>..
1130: 54 68 65 20 27 6d 65 73 73 61 67 65 66 69 6c 65 The 'messagefile
1140: 27 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 6c ' contains the l
1150: 6f 67 20 6d 65 73 73 61 67 65 2c 20 74 68 65 20 og message, the
1160: 27 66 69 6c 65 66 69 6c 65 27 20 6c 69 73 74 73 'filefile' lists
1170: 20 74 68 65 20 72 65 76 69 73 69 6f 6e 73 20 69 the revisions i
1180: 6e 20 74 68 65 20 6d 61 6e 69 66 65 73 74 20 62 n the manifest b
1190: 79 20 69 64 2c 20 61 6e 64 20 77 69 74 68 20 70 y id, and with p
11a0: 61 74 68 20 69 6e 20 74 68 65 20 77 6f 72 6b 73 ath in the works
11b0: 70 61 63 65 2e 20 54 68 65 20 70 61 72 65 6e 74 pace. The parent
11c0: 73 20 61 72 65 20 74 68 65 20 69 64 73 20 6f 66 s are the ids of
11d0: 20 74 68 65 20 70 61 72 65 6e 74 20 6d 61 6e 69 the parent mani
11e0: 66 65 73 74 73 2e 20 54 68 65 20 72 65 73 75 6c fests. The resul
11f0: 74 20 6f 66 20 74 68 65 20 63 6f 6d 6d 61 6e 64 t of the command
1200: 20 69 73 20 74 68 65 20 69 64 20 6f 66 20 74 68 is the id of th
1210: 65 20 6e 65 77 20 6d 61 6e 69 66 65 73 74 2e 0d e new manifest..
1220: 0a 3c 62 72 3e 0d 0a 4e 6f 74 65 3a 20 57 65 20 .<br>..Note: We
1230: 68 61 76 65 20 61 6c 72 65 61 64 79 20 63 6f 6d have already com
1240: 6d 61 6e 64 73 20 66 6f 72 20 74 68 65 20 70 75 mands for the pu
1250: 74 20 61 6e 64 20 64 65 6c 74 69 66 79 20 6f 70 t and deltify op
1260: 65 72 61 74 69 6f 6e 73 2c 20 61 6c 62 65 69 74 erations, albeit
1270: 20 75 6e 64 6f 63 75 6d 65 6e 74 65 64 2c 20 69 undocumented, i
1280: 6e 20 74 68 65 20 73 65 74 20 6f 66 20 74 65 73 n the set of tes
1290: 74 20 63 6f 6d 6d 61 6e 64 73 2e 0d 0a 3c 2f 6c t commands...</l
12a0: 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 0d 0a 4d 69 73 i>..</ul>....Mis
12b0: 63 65 6c 6c 61 6e 65 6f 75 73 3a 0d 0a 3c 75 6c cellaneous:..<ul
12c0: 3e 0d 0a 3c 6c 69 3e 41 64 64 20 6f 70 74 69 6f >..<li>Add optio
12d0: 6e 20 74 6f 20 61 6c 6c 6f 77 20 64 69 76 65 72 n to allow diver
12e0: 74 69 6e 67 20 74 68 65 20 6c 6f 67 20 6f 75 74 ting the log out
12f0: 70 75 74 20 69 6e 74 6f 20 61 20 66 69 6c 65 2c put into a file,
1300: 20 65 78 63 65 70 74 20 66 6f 72 20 74 68 65 20 except for the
1310: 70 72 6f 67 72 65 73 73 20 72 65 70 6f 72 74 69 progress reporti
1320: 6e 67 2e 20 52 65 73 75 6c 74 20 69 73 20 6e 69 ng. Result is ni
1330: 63 65 20 69 6e 74 65 72 61 63 74 69 76 65 20 6c ce interactive l
1340: 6f 67 20 2b 20 70 72 6f 67 72 65 73 73 2c 20 61 og + progress, a
1350: 6e 64 20 61 20 28 72 65 6c 61 74 69 76 65 6c 79 nd a (relatively
1360: 29 20 73 6d 61 6c 6c 20 6c 6f 67 20 66 69 6c 65 ) small log file
1370: 20 77 69 74 68 6f 75 74 20 61 6c 6c 20 74 68 65 without all the
1380: 20 75 6e 77 61 6e 74 65 64 20 70 72 6f 67 72 65 unwanted progre
1390: 73 73 20 6e 75 6d 62 65 72 73 2e 0d 0a 3c 2f 6c ss numbers...</l
13a0: 69 3e 0d 0a 3c 6c 69 3e 47 6f 20 6f 76 65 72 20 i>..<li>Go over
13b0: 74 68 65 20 53 51 4c 20 73 74 61 74 65 6d 65 6e the SQL statemen
13c0: 74 73 20 61 6e 64 20 63 68 65 63 6b 20 74 68 61 ts and check tha
13d0: 74 20 74 68 65 79 20 68 61 76 65 20 67 6f 6f 64 t they have good
13e0: 20 71 75 65 72 79 20 70 6c 61 6e 73 0d 0a 3c 2f query plans..</
13f0: 6c 69 3e 0d 0a 3c 6c 69 3e 47 6f 20 6f 76 65 72 li>..<li>Go over
1400: 20 74 68 65 20 53 51 4c 20 73 74 61 74 65 6d 65 the SQL stateme
1410: 6e 74 73 20 61 6e 64 20 61 64 64 20 63 6f 6d 6d nts and add comm
1420: 65 6e 74 73 20 77 68 65 72 65 20 74 68 65 79 20 ents where they
1430: 61 72 65 20 6e 6f 6e 2d 74 72 69 76 69 61 6c 2e are non-trivial.
1440: 0d 0a 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 43 75 72 ..</li>..<li>Cur
1450: 72 65 6e 74 6c 79 20 73 6f 6d 65 20 70 61 73 73 rently some pass
1460: 65 73 20 74 61 6b 65 20 71 75 69 74 65 20 61 20 es take quite a
1470: 62 69 74 20 6f 66 20 74 69 6d 65 20 77 68 65 6e bit of time when
1480: 20 74 68 65 69 72 20 61 63 74 75 61 6c 20 6f 70 their actual op
1490: 65 72 61 74 69 6f 6e 20 69 73 20 61 6c 72 65 61 eration is alrea
14a0: 64 79 20 63 6f 6d 70 6c 65 74 65 2e 20 49 74 20 dy complete. It
14b0: 73 65 65 6d 73 20 74 68 61 74 20 73 71 6c 69 74 seems that sqlit
14c0: 65 20 69 73 20 68 65 61 76 69 6c 79 20 77 6f 72 e is heavily wor
14d0: 6b 69 6e 67 20 6f 6e 20 63 6f 6d 6d 69 74 74 69 king on committi
14e0: 6e 67 20 61 20 6c 6f 74 20 6f 66 20 63 68 61 6e ng a lot of chan
14f0: 67 65 73 20 28 4d 6f 73 74 20 70 61 73 73 65 73 ges (Most passes
1500: 20 61 72 65 20 77 72 61 70 70 65 64 20 69 6e 74 are wrapped int
1510: 6f 20 61 20 73 69 6e 67 6c 65 20 74 72 61 6e 73 o a single trans
1520: 61 63 74 69 6f 6e 29 2e 20 43 6f 6e 73 69 64 65 action). Conside
1530: 72 20 77 61 79 73 20 6f 66 20 73 70 65 65 64 69 r ways of speedi
1540: 6e 67 20 74 68 69 73 20 75 70 2e 0d 0a 3c 75 6c ng this up...<ul
1550: 3e 0d 0a 3c 6c 69 3e 44 6f 20 6f 75 72 20 6f 77 >..<li>Do our ow
1560: 6e 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d 61 n transaction ma
1570: 6e 61 67 65 6d 65 6e 74 3f 20 53 6f 20 74 68 61 nagement? So tha
1580: 74 20 77 65 20 63 61 6e 20 63 6f 6d 6d 69 74 20 t we can commit
1590: 65 76 65 72 79 20 58 20 63 68 61 6e 67 65 73 3f every X changes?
15a0: 2e 0d 0a 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 53 68 ...</li>..<li>Sh
15b0: 6f 75 6c 64 20 77 65 20 64 69 73 61 62 6c 65 20 ould we disable
15c0: 73 79 6e 63 68 72 6f 6e 6f 75 73 20 6f 70 65 72 synchronous oper
15d0: 61 74 69 6f 6e 3f 20 54 68 65 20 73 74 61 74 65 ation? The state
15e0: 20 64 61 74 61 62 61 73 65 20 69 73 20 6e 6f 74 database is not
15f0: 20 74 68 61 74 20 63 72 69 74 69 63 61 6c 2c 20 that critical,
1600: 69 2e 65 2e 20 69 74 20 63 61 6e 20 61 6c 77 61 i.e. it can alwa
1610: 79 73 20 62 65 20 72 65 67 65 6e 65 72 61 74 65 ys be regenerate
1620: 64 2e 20 4f 6e 20 74 68 65 20 6f 74 68 65 72 20 d. On the other
1630: 68 61 6e 64 2c 20 62 65 69 6e 67 20 61 62 6c 65 hand, being able
1640: 20 74 6f 20 62 65 20 73 75 72 65 20 74 68 61 74 to be sure that
1650: 20 77 65 20 63 61 6e 20 72 65 73 74 61 72 74 20 we can restart
1660: 66 72 6f 6d 20 74 68 65 20 69 6e 74 65 72 72 75 from the interru
1670: 70 74 65 64 20 70 61 73 73 20 69 73 20 6e 69 63 pted pass is nic
1680: 65 2c 20 61 6e 64 20 6e 6f 74 20 70 6f 73 73 69 e, and not possi
1690: 62 6c 65 20 69 66 20 77 65 20 67 6f 74 20 69 74 ble if we got it
16a0: 20 63 6f 72 72 75 70 74 65 64 20 62 79 20 61 73 corrupted by as
16b0: 79 6e 63 68 72 6f 6e 6f 75 73 20 6f 70 65 72 61 ynchronous opera
16c0: 74 69 6f 6e 2e 20 3c 62 3e 54 61 62 6c 65 64 20 tion. <b>Tabled
16d0: 66 6f 72 20 6e 6f 77 2c 20 74 68 69 73 20 69 73 for now, this is
16e0: 20 6e 6f 74 20 79 65 74 20 63 72 69 74 69 63 61 not yet critica
16f0: 6c 3c 2f 62 3e 0d 0a 3c 2f 6c 69 3e 0d 0a 3c 2f l</b>..</li>..</
1700: 75 6c 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 0a 5a 20 30 ul>..</ul>...Z 0
1710: 62 62 62 33 38 64 61 38 33 38 34 34 36 38 61 39 bbb38da8384468a9
1720: 63 66 30 63 63 37 66 39 62 64 32 30 33 36 62 0a cf0cc7f9bd2036b.