Hex Artifact Content
Not logged in

Artifact 3b08faa93faee64e765347676c48be79d33d1f9b:

Wiki page [Import CVS Repositories] by anonymous on 2008-01-30 19:18:42.

0000: 44 20 32 30 30 38 2d 30 31 2d 33 30 54 31 39 3a  D 2008-01-30T19:
0010: 31 38 3a 34 32 0a 4c 20 49 6d 70 6f 72 74 5c 73  18:42.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 62 37 31 30 37 63 63 32 38 64 64  s.P 1b7107cc28dd
0040: 64 63 33 37 61 62 30 30 32 38 36 31 30 32 62 38  dc37ab00286102b8
0050: 32 36 66 62 35 31 62 31 34 61 37 37 0a 55 20 61  26fb51b14a77.U a
0060: 6e 6f 6e 79 6d 6f 75 73 0a 57 20 35 37 39 33 0a  nonymous.W 5793.
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 20 62 6f 72 64  s:..<table  bord
0270: 65 72 3d 31 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 68  er=1>..<tr>..<th
0280: 3e 50 61 73 73 3c 2f 74 68 3e 0d 0a 3c 74 68 3e  >Pass</th>..<th>
0290: 44 65 73 63 72 69 70 74 69 6f 6e 3c 2f 74 68 3e  Description</th>
02a0: 0d 0a 3c 74 68 3e 4e 6f 74 65 73 3c 2f 74 68 3e  ..<th>Notes</th>
02b0: 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c  ..</tr>..<tr>..<
02c0: 74 64 3e 43 6f 6c 6c 65 63 74 41 72 3c 2f 74 64  td>CollectAr</td
02d0: 3e 0d 0a 3c 74 64 3e 43 6f 6c 6c 65 63 74 20 61  >..<td>Collect a
02e0: 72 63 68 69 76 65 73 3c 2f 74 64 3e 0d 0a 3c 74  rchives</td>..<t
02f0: 64 3e 4f 6b 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e  d>Ok</td>..</tr>
0300: 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 43 6f 6c 6c  ..<tr>..<td>Coll
0310: 65 63 74 52 65 76 3c 2f 74 64 3e 0d 0a 3c 74 64  ectRev</td>..<td
0320: 3e 43 6f 6c 6c 65 63 74 20 72 65 76 69 73 69 6f  >Collect revisio
0330: 6e 73 2c 20 74 61 67 73 2c 20 62 72 61 6e 63 68  ns, tags, branch
0340: 65 73 20 28 66 69 6c 65 20 6c 65 76 65 6c 29 3c  es (file level)<
0350: 2f 74 64 3e 0d 0a 3c 74 64 3e 4f 6b 3c 2f 74 64  /td>..<td>Ok</td
0360: 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a  >..</tr>..<tr>..
0370: 3c 74 64 3e 43 6f 6c 6c 61 74 65 53 79 6d 62 6f  <td>CollateSymbo
0380: 6c 73 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 43 6f 6c  ls</td>..<td>Col
0390: 6c 61 74 65 20 73 79 6d 62 6f 6c 20 28 70 72 6f  late symbol (pro
03a0: 6a 65 63 74 20 6c 65 76 65 6c 29 20 66 72 6f 6d  ject level) from
03b0: 20 74 68 65 20 66 69 6c 65 20 6c 65 76 65 6c 20   the file level 
03c0: 64 61 74 61 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 4f  data</td>..<td>O
03d0: 6b 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c  k</td>..</tr>..<
03e0: 74 72 3e 0d 0a 3c 74 64 3e 46 69 6c 74 65 72 53  tr>..<td>FilterS
03f0: 79 6d 62 6f 6c 73 3c 2f 74 64 3e 0d 0a 3c 74 64  ymbols</td>..<td
0400: 3e 46 69 6c 74 65 72 20 73 79 6d 62 6f 6c 73 2c  >Filter symbols,
0410: 20 65 78 63 6c 75 64 65 20 73 79 6d 62 6f 6c 73   exclude symbols
0420: 20 61 6e 64 20 6c 69 6e 65 73 20 6f 66 20 64 65   and lines of de
0430: 76 65 6c 6f 70 6d 65 6e 74 3c 2f 74 64 3e 0d 0a  velopment</td>..
0440: 3c 74 64 3e 4f 6b 3c 2f 74 64 3e 0d 0a 3c 2f 74  <td>Ok</td>..</t
0450: 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 49 6e  r>..<tr>..<td>In
0460: 69 74 43 73 65 74 73 3c 2f 74 64 3e 0d 0a 3c 74  itCsets</td>..<t
0470: 64 3e 43 72 65 61 74 65 20 69 6e 69 74 69 61 6c  d>Create initial
0480: 20 63 68 61 6e 67 65 73 65 74 73 3c 2f 74 64 3e   changesets</td>
0490: 0d 0a 3c 74 64 3e 4f 6b 2e 20 3c 62 3e 4d 65 6d  ..<td>Ok. <b>Mem
04a0: 6f 72 79 20 48 6f 67 2c 20 53 6c 6f 77 20 63 6f  ory Hog, Slow co
04b0: 6d 6d 69 74 3c 2f 62 3e 3c 2f 74 64 3e 0d 0a 3c  mmit</b></td>..<
04c0: 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e  /tr>..<tr>..<td>
04d0: 43 73 65 74 44 65 70 73 3c 2f 74 64 3e 0d 0a 3c  CsetDeps</td>..<
04e0: 74 64 3e 43 6f 6d 70 75 74 65 20 63 68 61 6e 67  td>Compute chang
04f0: 65 73 65 74 20 64 65 70 65 6e 64 65 6e 63 69 65  eset dependencie
0500: 73 20 66 72 6f 6d 20 72 65 76 69 73 69 6f 6e 20  s from revision 
0510: 64 65 70 65 6e 64 65 6e 63 69 65 73 3c 2f 74 64  dependencies</td
0520: 3e 0d 0a 3c 74 64 3e 4f 6b 3c 2f 74 64 3e 0d 0a  >..<td>Ok</td>..
0530: 3c 2f 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64  </tr>..<tr>..<td
0540: 3e 50 61 73 73 20 42 72 65 61 6b 52 65 76 43 73  >Pass BreakRevCs
0550: 65 74 43 79 63 6c 65 73 3c 2f 74 64 3e 0d 0a 3c  etCycles</td>..<
0560: 74 64 3e 42 72 65 61 6b 20 63 79 63 6c 65 73 20  td>Break cycles 
0570: 61 6d 6f 6e 67 20 72 65 76 69 73 69 6f 6e 20 63  among revision c
0580: 68 61 6e 67 65 73 65 74 73 3c 2f 74 64 3e 0d 0a  hangesets</td>..
0590: 3c 74 64 3e 4f 6b 3c 2f 74 64 3e 0d 0a 3c 2f 74  <td>Ok</td>..</t
05a0: 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 52 65  r>..<tr>..<td>Re
05b0: 76 54 6f 70 6f 6c 6f 67 69 63 61 6c 53 6f 72 74  vTopologicalSort
05c0: 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 54 6f 70 6f 6c  </td>..<td>Topol
05d0: 6f 67 69 63 61 6c 6c 79 20 73 6f 72 74 20 72 65  ogically sort re
05e0: 76 69 73 69 6f 6e 20 63 68 61 6e 67 65 73 65 74  vision changeset
05f0: 73 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 4f 6b 3c 2f  s</td>..<td>Ok</
0600: 74 64 3e 0d 0a 3c 2f 74 72 3e 0d 0a 3c 74 72 3e  td>..</tr>..<tr>
0610: 0d 0a 3c 74 64 3e 42 72 65 61 6b 53 79 6d 43 73  ..<td>BreakSymCs
0620: 65 74 43 79 63 6c 65 73 3c 2f 74 64 3e 0d 0a 3c  etCycles</td>..<
0630: 74 64 3e 42 72 65 61 6b 20 63 79 63 6c 65 73 20  td>Break cycles 
0640: 61 6d 6f 6e 67 20 73 79 6d 62 6f 6c 20 63 68 61  among symbol cha
0650: 6e 67 65 73 65 74 73 3c 2f 74 64 3e 0d 0a 3c 74  ngesets</td>..<t
0660: 64 3e 4f 6b 3c 2f 74 64 3e 0d 0a 3c 2f 74 72 3e  d>Ok</td>..</tr>
0670: 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 42 72 65 61  ..<tr>..<td>Brea
0680: 6b 41 6c 6c 43 73 65 74 43 79 63 6c 65 73 3c 2f  kAllCsetCycles</
0690: 74 64 3e 0d 0a 3c 74 64 3e 42 72 65 61 6b 20 63  td>..<td>Break c
06a0: 79 63 6c 65 73 20 6f 76 65 72 20 61 6c 6c 20 63  ycles over all c
06b0: 68 61 6e 67 65 73 65 74 73 3c 2f 74 64 3e 0d 0a  hangesets</td>..
06c0: 3c 74 64 3e 3c 62 3e 4d 61 79 20 73 74 69 6c 6c  <td><b>May still
06d0: 20 63 68 61 6e 67 65 20 74 68 65 20 6f 72 64 65   change the orde
06e0: 72 20 6f 66 20 72 65 76 69 73 69 6f 6e 20 63 68  r of revision ch
06f0: 61 6e 67 65 73 65 74 73 20 6f 76 65 72 20 74 68  angesets over th
0700: 65 20 72 65 73 75 6c 74 20 6f 66 20 70 61 73 73  e result of pass
0710: 20 37 2e 3c 2f 62 3e 3c 2f 74 64 3e 0d 0a 3c 2f   7.</b></td>..</
0720: 74 72 3e 0d 0a 3c 74 72 3e 0d 0a 3c 74 64 3e 41  tr>..<tr>..<td>A
0730: 6c 6c 54 6f 70 6f 6c 6f 67 69 63 61 6c 6c 53 6f  llTopologicallSo
0740: 72 74 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 54 6f 70  rt</td>..<td>Top
0750: 6f 6c 6f 67 69 63 61 6c 6c 79 20 73 6f 72 74 20  ologically sort 
0760: 61 6c 6c 20 63 68 61 6e 67 65 73 65 74 73 3c 2f  all changesets</
0770: 74 64 3e 0d 0a 3c 74 64 3e 4f 6b 3c 2f 74 64 3e  td>..<td>Ok</td>
0780: 0d 0a 3c 2f 74 72 3e 0d 0a 0d 0a 3c 74 72 3e 0d  ..</tr>....<tr>.
0790: 0a 3c 74 64 3e 49 6d 70 6f 72 74 3c 2f 74 64 3e  .<td>Import</td>
07a0: 0d 0a 3c 74 64 3e 49 6d 70 6f 72 74 20 66 69 6c  ..<td>Import fil
07b0: 65 73 20 61 6e 64 20 63 68 61 6e 67 65 73 65 74  es and changeset
07c0: 73 3c 2f 74 64 3e 0d 0a 3c 74 64 3e 46 69 6c 65  s</td>..<td>File
07d0: 20 69 6d 70 6f 72 74 20 6f 6b 2e 20 43 68 61 6e   import ok. Chan
07e0: 67 65 73 65 74 20 69 6d 70 6f 72 74 20 68 61 73  geset import has
07f0: 20 72 65 73 74 61 72 74 65 64 2e 3c 2f 74 64 3e   restarted.</td>
0800: 0d 0a 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65  ..</tr>..</table
0810: 3e 0d 0a 3c 2f 70 3e 0d 0a 0d 0a 50 61 73 73 65  >..</p>....Passe
0820: 73 20 74 6f 20 64 6f 3a 0d 0a 20 20 2a 20 20 50  s to do:..  *  P
0830: 75 74 20 63 68 61 6e 67 65 73 65 74 20 6f 72 64  ut changeset ord
0840: 65 72 20 66 72 6f 6d 20 74 68 65 20 74 6f 70 2e  er from the top.
0850: 73 6f 72 74 20 70 61 73 73 65 73 20 61 6e 64 20  sort passes and 
0860: 74 72 65 65 20 6f 66 20 73 79 6d 62 6f 6c 73 20  tree of symbols 
0870: 66 72 6f 6d 20 74 68 65 20 63 6f 6c 6c 7c 46 69  from the coll|Fi
0880: 6c 74 65 72 53 79 6d 20 70 61 73 73 65 73 20 74  lterSym passes t
0890: 6f 67 65 74 68 65 72 20 69 6e 74 6f 20 61 20 74  ogether into a t
08a0: 72 65 65 20 6f 66 20 63 68 61 6e 67 65 73 65 74  ree of changeset
08b0: 73 2e 20 4e 6f 74 65 20 74 68 61 74 20 69 74 20  s. Note that it 
08c0: 6d 69 67 68 74 20 6e 6f 74 20 62 65 20 61 20 74  might not be a t
08d0: 72 65 65 20 69 66 20 74 68 65 72 65 20 69 73 20  ree if there is 
08e0: 61 6e 20 4e 54 44 42 20 61 72 6f 75 6e 64 2e 0d  an NTDB around..
08f0: 0a 20 20 2a 20 20 50 65 72 66 6f 72 6d 20 74 68  .  *  Perform th
0900: 65 20 61 63 74 75 61 6c 20 69 6d 70 6f 72 74 2e  e actual import.
0910: 0d 0a 0d 0a 4e 6f 74 65 73 20 72 65 67 61 72 64  ....Notes regard
0920: 69 6e 67 20 74 68 65 20 61 63 74 75 61 6c 20 69  ing the actual i
0930: 6d 70 6f 72 74 3a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c  mport:..<ul>..<l
0940: 69 3e 63 76 73 32 73 76 6e 20 69 73 20 65 69 74  i>cvs2svn is eit
0950: 68 65 72 20 73 6c 6f 77 2c 20 6f 72 20 68 75 6e  her slow, or hun
0960: 67 72 79 20 66 6f 72 20 64 69 73 6b 73 70 61 63  gry for diskspac
0970: 65 2e 20 54 68 65 20 72 65 61 73 6f 6e 3a 20 49  e. The reason: I
0980: 74 20 69 73 20 69 6d 70 6f 72 74 69 6e 67 20 63  t is importing c
0990: 68 61 6e 67 65 73 65 74 20 62 79 20 63 68 61 6e  hangeset by chan
09a0: 67 65 73 65 74 20 61 6e 64 20 73 6f 20 68 61 73  geset and so has
09b0: 20 74 6f 20 65 69 74 68 65 72 20 72 65 67 65 6e   to either regen
09c0: 65 72 61 74 65 20 74 68 65 20 6e 65 65 64 65 64  erate the needed
09d0: 20 72 65 76 69 73 69 6f 6e 73 20 6f 66 20 74 68   revisions of th
09e0: 65 20 66 69 6c 65 73 20 6f 6e 2d 64 65 6d 61 6e  e files on-deman
09f0: 64 20 6f 76 65 72 20 61 6e 64 20 6f 76 65 72 2c  d over and over,
0a00: 20 6f 72 20 69 74 20 63 61 63 68 65 73 20 74 68   or it caches th
0a10: 65 20 6e 65 65 64 65 64 20 72 65 76 69 73 69 6f  e needed revisio
0a20: 6e 73 20 77 68 65 6e 20 63 72 65 61 74 65 64 20  ns when created 
0a30: 75 6e 74 69 6c 20 74 68 65 20 6c 61 73 74 20 75  until the last u
0a40: 73 65 72 20 69 73 20 67 6f 6e 65 2e 0d 0a 3c 2f  ser is gone...</
0a50: 6c 69 3e 0d 0a 3c 6c 69 3e 57 65 20 63 61 6e 20  li>..<li>We can 
0a60: 64 6f 20 62 65 74 74 65 72 2c 20 69 66 20 77 65  do better, if we
0a70: 20 67 65 74 20 68 65 6c 70 20 66 72 6f 6d 20 66   get help from f
0a80: 6f 73 73 69 6c 2e 20 57 65 20 77 6f 75 6c 64 20  ossil. We would 
0a90: 6e 65 65 64 20 63 6f 6d 6d 61 6e 64 73 20 74 6f  need commands to
0aa0: 20 70 65 72 66 6f 72 6d 20 74 68 65 20 66 6f 6c   perform the fol
0ab0: 6c 6f 77 69 6e 67 20 61 63 74 69 6f 6e 73 3a 0d  lowing actions:.
0ac0: 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 20 49 6d 70 6f  .<ul>..<li> Impo
0ad0: 72 74 20 61 20 66 69 6c 65 20 61 73 20 62 6c 6f  rt a file as blo
0ae0: 62 2c 20 72 65 74 75 72 6e 20 69 74 73 20 69 6e  b, return its in
0af0: 74 65 72 6e 61 6c 20 69 64 2e 0d 0a 3c 2f 6c 69  ternal id...</li
0b00: 3e 0d 0a 3c 6c 69 3e 20 44 65 6c 74 69 66 79 20  >..<li> Deltify 
0b10: 61 20 6b 6e 6f 77 6e 20 66 69 6c 65 20 72 65 73  a known file res
0b20: 70 65 63 74 69 76 65 20 74 6f 20 61 20 73 65 63  pective to a sec
0b30: 6f 6e 64 20 6b 6e 6f 77 6e 20 66 69 6c 65 2e 0d  ond known file..
0b40: 0a 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 20 47 65 6e  .</li>..<li> Gen
0b50: 65 72 61 74 65 20 61 20 6d 61 6e 69 66 65 73 74  erate a manifest
0b60: 20 66 69 6c 65 20 66 6f 72 20 61 20 6c 69 73 74   file for a list
0b70: 20 6f 66 20 66 69 6c 65 73 20 28 70 61 74 68 73   of files (paths
0b80: 2c 20 69 64 73 29 2c 20 70 61 72 65 6e 74 20 6d  , ids), parent m
0b90: 61 6e 69 66 65 73 74 20 72 65 66 65 72 65 6e 63  anifest referenc
0ba0: 65 73 2c 20 75 73 65 72 2c 20 74 69 6d 65 73 74  es, user, timest
0bb0: 61 6d 70 2c 20 6c 6f 67 20 6d 65 73 73 61 67 65  amp, log message
0bc0: 2e 20 43 6f 75 6c 64 20 62 65 20 73 69 67 6e 65  . Could be signe
0bd0: 64 20 6f 72 20 6e 6f 74 2e 0d 0a 3c 2f 6c 69 3e  d or not...</li>
0be0: 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 62 72 3e 0d 0a 57  ..</ul>..<br>..W
0bf0: 69 74 68 20 74 68 65 73 65 20 61 63 74 69 6f 6e  ith these action
0c00: 73 20 28 70 6f 73 73 69 62 6c 79 20 69 6e 20 63  s (possibly in c
0c10: 6f 6d 62 69 6e 61 74 69 6f 6e 29 20 77 65 20 63  ombination) we c
0c20: 61 6e 20 69 6d 70 6f 72 74 20 74 68 65 20 61 72  an import the ar
0c30: 63 68 69 76 65 20 66 69 6c 65 73 20 66 69 72 73  chive files firs
0c40: 74 2c 20 6e 65 65 64 69 6e 67 20 6f 6e 6c 79 20  t, needing only 
0c50: 73 70 61 63 65 20 66 6f 72 20 74 68 65 20 72 65  space for the re
0c60: 76 69 73 69 6f 6e 73 20 6f 66 20 61 20 73 69 6e  visions of a sin
0c70: 67 6c 65 20 66 69 6c 65 20 28 62 6f 75 6e 64 65  gle file (bounde
0c80: 64 20 62 79 20 74 68 65 20 6c 61 72 67 65 73 74  d by the largest
0c90: 20 66 69 6c 65 20 69 6e 20 74 65 72 6d 73 20 6f   file in terms o
0ca0: 66 20 73 69 7a 65 20 61 6e 64 20 68 69 73 74 6f  f size and histo
0cb0: 72 79 29 2c 20 77 69 74 68 20 74 68 65 69 72 20  ry), with their 
0cc0: 64 65 6c 74 61 2d 6c 69 6e 6b 73 20 6d 69 72 72  delta-links mirr
0cd0: 6f 72 69 6e 67 20 74 68 65 20 52 43 53 20 73 74  oring the RCS st
0ce0: 72 75 63 74 75 72 65 2e 20 41 66 74 65 72 20 74  ructure. After t
0cf0: 68 61 74 20 77 65 20 63 61 6e 20 69 6e 64 65 70  hat we can indep
0d00: 65 6e 64 65 6e 74 6c 79 20 67 65 6e 65 72 61 74  endently generat
0d10: 65 2c 20 69 6d 70 6f 72 74 2c 20 61 6e 64 20 64  e, import, and d
0d20: 65 6c 74 69 66 79 20 74 68 65 20 6d 61 6e 69 66  eltify the manif
0d30: 65 73 74 73 20 66 6f 72 20 63 68 61 6e 67 65 73  ests for changes
0d40: 65 74 73 2e 20 54 6f 20 66 69 6e 61 6c 69 7a 65  ets. To finalize
0d50: 20 77 65 20 73 69 6d 70 6c 79 20 27 72 65 62 75   we simply 'rebu
0d60: 69 6c 64 27 20 74 68 65 20 72 65 70 6f 73 69 74  ild' the reposit
0d70: 6f 72 79 2e 20 54 68 69 73 20 73 68 6f 75 6c 64  ory. This should
0d80: 20 62 65 20 66 61 73 74 20 77 69 74 68 6f 75 74   be fast without
0d90: 20 6e 65 65 64 69 6e 67 20 6d 75 63 68 20 74 65   needing much te
0da0: 6d 70 6f 72 61 72 79 20 64 69 73 6b 20 73 70 61  mporary disk spa
0db0: 63 65 20 65 69 74 68 65 72 2e 0d 0a 3c 62 72 3e  ce either...<br>
0dc0: 0d 0a 43 75 72 72 65 6e 74 6c 79 20 49 20 61 6d  ..Currently I am
0dd0: 20 74 68 69 6e 6b 69 6e 67 20 61 62 6f 75 74 20   thinking about 
0de0: 77 61 6e 74 69 6e 67 20 61 20 63 6f 6d 6d 61 6e  wanting a comman
0df0: 64 0d 0a 3c 70 72 65 3e 0d 0a 66 6f 73 73 69 6c  d..<pre>..fossil
0e00: 20 69 6d 70 6f 72 74 2d 66 69 6c 65 73 20 53 50   import-files SP
0e10: 45 43 46 49 4c 45 0d 0a 3c 2f 70 72 65 3e 0d 0a  ECFILE..</pre>..
0e20: 77 68 69 63 68 20 69 6d 70 6f 72 74 73 20 61 6e  which imports an
0e30: 64 20 64 65 6c 74 69 66 69 65 73 20 66 69 6c 65  d deltifies file
0e40: 73 20 61 73 20 62 6c 6f 62 20 70 65 72 20 74 68  s as blob per th
0e50: 65 20 53 50 45 43 46 49 4c 45 2c 20 72 65 74 75  e SPECFILE, retu
0e60: 72 6e 69 6e 67 20 6f 6e 20 73 74 64 6f 75 74 20  rning on stdout 
0e70: 74 68 65 20 61 73 73 6f 63 69 61 74 65 64 20 6f  the associated o
0e80: 66 20 70 61 74 68 73 20 61 6e 64 20 69 6e 74 65  f paths and inte
0e90: 72 6e 61 6c 20 69 64 73 2e 20 45 78 61 6d 70 6c  rnal ids. Exampl
0ea0: 65 20 53 50 45 43 46 49 4c 45 3a 0d 0a 3c 70 72  e SPECFILE:..<pr
0eb0: 65 3e 0d 0a 46 20 70 61 74 68 31 0d 0a 44 20 70  e>..F path1..D p
0ec0: 61 74 68 32 20 70 61 74 68 31 0d 0a 2e 2e 2e 0d  ath2 path1......
0ed0: 0a 3c 2f 70 72 65 3e 0d 0a 54 68 65 20 27 46 27  .</pre>..The 'F'
0ee0: 20 63 61 72 64 20 74 65 6c 6c 73 20 69 74 20 74   card tells it t
0ef0: 6f 20 69 6d 70 6f 72 74 20 27 70 61 74 68 31 27  o import 'path1'
0f00: 20 61 73 20 69 73 2e 20 54 68 65 20 27 44 27 20   as is. The 'D' 
0f10: 63 61 72 64 20 74 68 65 6e 20 74 65 6c 6c 73 20  card then tells 
0f20: 69 74 20 74 6f 20 69 6d 70 6f 72 74 20 27 70 61  it to import 'pa
0f30: 74 68 32 27 20 61 73 20 69 73 20 61 6e 64 20 74  th2' as is and t
0f40: 68 65 6e 20 64 65 6c 74 69 66 79 20 27 70 61 74  hen deltify 'pat
0f50: 68 31 27 20 69 6e 20 74 65 72 6d 73 20 6f 66 20  h1' in terms of 
0f60: 27 70 61 74 68 32 27 2e 20 41 6e 64 20 73 6f 20  'path2'. And so 
0f70: 6f 6e 2e 0d 0a 3c 62 72 3e 0d 0a 54 6f 20 69 6d  on...<br>..To im
0f80: 70 6f 72 74 20 61 6e 20 52 43 53 20 61 72 63 68  port an RCS arch
0f90: 69 76 65 20 77 65 20 6e 6f 77 20 6a 75 73 74 20  ive we now just 
0fa0: 68 61 76 65 20 74 6f 20 67 65 6e 65 72 61 74 65  have to generate
0fb0: 20 74 68 65 20 66 75 6c 6c 20 72 65 76 69 73 69   the full revisi
0fc0: 6f 6e 73 20 69 6e 20 73 6f 6d 65 20 74 65 6d 70  ons in some temp
0fd0: 64 69 72 2c 20 74 68 65 6e 20 63 72 65 61 74 65  dir, then create
0fe0: 20 61 20 53 50 45 43 20 73 68 6f 77 69 6e 67 20   a SPEC showing 
0ff0: 74 68 65 20 64 65 6c 74 61 2d 6c 69 6e 6b 73 20  the delta-links 
1000: 61 6e 64 20 6c 65 74 20 66 6f 73 73 69 6c 20 68  and let fossil h
1010: 61 76 65 20 74 68 69 73 2e 20 54 68 65 20 72 65  ave this. The re
1020: 73 75 6c 74 69 6e 67 20 69 64 73 20 74 68 65 6e  sulting ids then
1030: 20 67 6f 20 69 6e 74 6f 20 74 68 65 20 69 6d 70   go into the imp
1040: 6f 72 74 65 72 20 73 74 61 74 65 20 66 6f 72 20  orter state for 
1050: 77 68 65 6e 20 77 65 20 67 65 6e 65 72 61 74 65  when we generate
1060: 20 74 68 65 20 6d 61 6e 69 66 65 73 74 73 2e 0d   the manifests..
1070: 0a 3c 62 72 3e 0d 0a 54 6f 20 69 6d 70 6f 72 74  .<br>..To import
1080: 20 6d 61 6e 69 66 65 73 74 73 20 77 65 20 6e 65   manifests we ne
1090: 65 64 20 73 65 63 6f 6e 64 20 63 6f 6d 6d 61 6e  ed second comman
10a0: 64 2c 20 77 68 69 63 68 20 67 65 6e 65 72 61 74  d, which generat
10b0: 65 73 20 69 74 20 66 72 6f 6d 20 63 68 61 6e 67  es it from chang
10c0: 65 73 65 74 20 64 61 74 61 2c 20 61 6e 64 20 69  eset data, and i
10d0: 6d 70 6f 72 74 73 20 69 74 20 74 6f 6f 2e 0d 0a  mports it too...
10e0: 3c 70 72 65 3e 0d 0a 66 6f 73 73 69 6c 20 69 6d  <pre>..fossil im
10f0: 70 6f 72 74 2d 6d 61 6e 69 66 65 73 74 20 75 73  port-manifest us
1100: 65 72 20 74 69 6d 65 73 74 61 6d 70 20 4d 45 53  er timestamp MES
1110: 53 41 47 45 46 49 4c 45 20 46 49 4c 45 46 49 4c  SAGEFILE FILEFIL
1120: 45 20 70 61 72 65 6e 74 2e 2e 2e 0d 0a 3c 2f 70  E parent.....</p
1130: 72 65 3e 0d 0a 54 68 65 20 27 6d 65 73 73 61 67  re>..The 'messag
1140: 65 66 69 6c 65 27 20 63 6f 6e 74 61 69 6e 73 20  efile' contains 
1150: 74 68 65 20 6c 6f 67 20 6d 65 73 73 61 67 65 2c  the log message,
1160: 20 74 68 65 20 27 66 69 6c 65 66 69 6c 65 27 20   the 'filefile' 
1170: 6c 69 73 74 73 20 74 68 65 20 72 65 76 69 73 69  lists the revisi
1180: 6f 6e 73 20 69 6e 20 74 68 65 20 6d 61 6e 69 66  ons in the manif
1190: 65 73 74 20 62 79 20 69 64 2c 20 61 6e 64 20 77  est by id, and w
11a0: 69 74 68 20 70 61 74 68 20 69 6e 20 74 68 65 20  ith path in the 
11b0: 77 6f 72 6b 73 70 61 63 65 2e 20 54 68 65 20 70  workspace. The p
11c0: 61 72 65 6e 74 73 20 61 72 65 20 74 68 65 20 69  arents are the i
11d0: 64 73 20 6f 66 20 74 68 65 20 70 61 72 65 6e 74  ds of the parent
11e0: 20 6d 61 6e 69 66 65 73 74 73 2e 20 54 68 65 20   manifests. The 
11f0: 72 65 73 75 6c 74 20 6f 66 20 74 68 65 20 63 6f  result of the co
1200: 6d 6d 61 6e 64 20 69 73 20 74 68 65 20 69 64 20  mmand is the id 
1210: 6f 66 20 74 68 65 20 6e 65 77 20 6d 61 6e 69 66  of the new manif
1220: 65 73 74 2e 0d 0a 3c 62 72 3e 0d 0a 4e 6f 74 65  est...<br>..Note
1230: 3a 20 57 65 20 68 61 76 65 20 61 6c 72 65 61 64  : We have alread
1240: 79 20 63 6f 6d 6d 61 6e 64 73 20 66 6f 72 20 74  y commands for t
1250: 68 65 20 70 75 74 20 61 6e 64 20 64 65 6c 74 69  he put and delti
1260: 66 79 20 6f 70 65 72 61 74 69 6f 6e 73 2c 20 61  fy operations, a
1270: 6c 62 65 69 74 20 75 6e 64 6f 63 75 6d 65 6e 74  lbeit undocument
1280: 65 64 2c 20 69 6e 20 74 68 65 20 73 65 74 20 6f  ed, in the set o
1290: 66 20 74 65 73 74 20 63 6f 6d 6d 61 6e 64 73 2e  f test commands.
12a0: 0d 0a 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a  ..</li>..</ul>..
12b0: 0d 0a 4d 69 73 63 65 6c 6c 61 6e 65 6f 75 73 3a  ..Miscellaneous:
12c0: 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 41 64 64 20  ..<ul>..<li>Add 
12d0: 6f 70 74 69 6f 6e 20 74 6f 20 61 6c 6c 6f 77 20  option to allow 
12e0: 64 69 76 65 72 74 69 6e 67 20 74 68 65 20 6c 6f  diverting the lo
12f0: 67 20 6f 75 74 70 75 74 20 69 6e 74 6f 20 61 20  g output into a 
1300: 66 69 6c 65 2c 20 65 78 63 65 70 74 20 66 6f 72  file, except for
1310: 20 74 68 65 20 70 72 6f 67 72 65 73 73 20 72 65   the progress re
1320: 70 6f 72 74 69 6e 67 2e 20 52 65 73 75 6c 74 20  porting. Result 
1330: 69 73 20 6e 69 63 65 20 69 6e 74 65 72 61 63 74  is nice interact
1340: 69 76 65 20 6c 6f 67 20 2b 20 70 72 6f 67 72 65  ive log + progre
1350: 73 73 2c 20 61 6e 64 20 61 20 28 72 65 6c 61 74  ss, and a (relat
1360: 69 76 65 6c 79 29 20 73 6d 61 6c 6c 20 6c 6f 67  ively) small log
1370: 20 66 69 6c 65 20 77 69 74 68 6f 75 74 20 61 6c   file without al
1380: 6c 20 74 68 65 20 75 6e 77 61 6e 74 65 64 20 70  l the unwanted p
1390: 72 6f 67 72 65 73 73 20 6e 75 6d 62 65 72 73 2e  rogress numbers.
13a0: 0d 0a 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 47 6f 20  ..</li>..<li>Go 
13b0: 6f 76 65 72 20 74 68 65 20 53 51 4c 20 73 74 61  over the SQL sta
13c0: 74 65 6d 65 6e 74 73 20 61 6e 64 20 63 68 65 63  tements and chec
13d0: 6b 20 74 68 61 74 20 74 68 65 79 20 68 61 76 65  k that they have
13e0: 20 67 6f 6f 64 20 71 75 65 72 79 20 70 6c 61 6e   good query plan
13f0: 73 0d 0a 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 47 6f  s..</li>..<li>Go
1400: 20 6f 76 65 72 20 74 68 65 20 53 51 4c 20 73 74   over the SQL st
1410: 61 74 65 6d 65 6e 74 73 20 61 6e 64 20 61 64 64  atements and add
1420: 20 63 6f 6d 6d 65 6e 74 73 20 77 68 65 72 65 20   comments where 
1430: 74 68 65 79 20 61 72 65 20 6e 6f 6e 2d 74 72 69  they are non-tri
1440: 76 69 61 6c 2e 0d 0a 3c 2f 6c 69 3e 0d 0a 3c 6c  vial...</li>..<l
1450: 69 3e 43 75 72 72 65 6e 74 6c 79 20 73 6f 6d 65  i>Currently some
1460: 20 70 61 73 73 65 73 20 74 61 6b 65 20 71 75 69   passes take qui
1470: 74 65 20 61 20 62 69 74 20 6f 66 20 74 69 6d 65  te a bit of time
1480: 20 77 68 65 6e 20 74 68 65 69 72 20 61 63 74 75   when their actu
1490: 61 6c 20 6f 70 65 72 61 74 69 6f 6e 20 69 73 20  al operation is 
14a0: 61 6c 72 65 61 64 79 20 63 6f 6d 70 6c 65 74 65  already complete
14b0: 2e 20 49 74 20 73 65 65 6d 73 20 74 68 61 74 20  . It seems that 
14c0: 73 71 6c 69 74 65 20 69 73 20 68 65 61 76 69 6c  sqlite is heavil
14d0: 79 20 77 6f 72 6b 69 6e 67 20 6f 6e 20 63 6f 6d  y working on com
14e0: 6d 69 74 74 69 6e 67 20 61 20 6c 6f 74 20 6f 66  mitting a lot of
14f0: 20 63 68 61 6e 67 65 73 20 28 4d 6f 73 74 20 70   changes (Most p
1500: 61 73 73 65 73 20 61 72 65 20 77 72 61 70 70 65  asses are wrappe
1510: 64 20 69 6e 74 6f 20 61 20 73 69 6e 67 6c 65 20  d into a single 
1520: 74 72 61 6e 73 61 63 74 69 6f 6e 29 2e 20 43 6f  transaction). Co
1530: 6e 73 69 64 65 72 20 77 61 79 73 20 6f 66 20 73  nsider ways of s
1540: 70 65 65 64 69 6e 67 20 74 68 69 73 20 75 70 2e  peeding this up.
1550: 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 44 6f 20 6f  ..<ul>..<li>Do o
1560: 75 72 20 6f 77 6e 20 74 72 61 6e 73 61 63 74 69  ur own transacti
1570: 6f 6e 20 6d 61 6e 61 67 65 6d 65 6e 74 3f 20 53  on management? S
1580: 6f 20 74 68 61 74 20 77 65 20 63 61 6e 20 63 6f  o that we can co
1590: 6d 6d 69 74 20 65 76 65 72 79 20 58 20 63 68 61  mmit every X cha
15a0: 6e 67 65 73 3f 2e 0d 0a 3c 2f 6c 69 3e 0d 0a 3c  nges?...</li>..<
15b0: 6c 69 3e 53 68 6f 75 6c 64 20 77 65 20 64 69 73  li>Should we dis
15c0: 61 62 6c 65 20 73 79 6e 63 68 72 6f 6e 6f 75 73  able synchronous
15d0: 20 6f 70 65 72 61 74 69 6f 6e 3f 20 54 68 65 20   operation? The 
15e0: 73 74 61 74 65 20 64 61 74 61 62 61 73 65 20 69  state database i
15f0: 73 20 6e 6f 74 20 74 68 61 74 20 63 72 69 74 69  s not that criti
1600: 63 61 6c 2c 20 69 2e 65 2e 20 69 74 20 63 61 6e  cal, i.e. it can
1610: 20 61 6c 77 61 79 73 20 62 65 20 72 65 67 65 6e   always be regen
1620: 65 72 61 74 65 64 2e 20 4f 6e 20 74 68 65 20 6f  erated. On the o
1630: 74 68 65 72 20 68 61 6e 64 2c 20 62 65 69 6e 67  ther hand, being
1640: 20 61 62 6c 65 20 74 6f 20 62 65 20 73 75 72 65   able to be sure
1650: 20 74 68 61 74 20 77 65 20 63 61 6e 20 72 65 73   that we can res
1660: 74 61 72 74 20 66 72 6f 6d 20 74 68 65 20 69 6e  tart from the in
1670: 74 65 72 72 75 70 74 65 64 20 70 61 73 73 20 69  terrupted pass i
1680: 73 20 6e 69 63 65 2c 20 61 6e 64 20 6e 6f 74 20  s nice, and not 
1690: 70 6f 73 73 69 62 6c 65 20 69 66 20 77 65 20 67  possible if we g
16a0: 6f 74 20 69 74 20 63 6f 72 72 75 70 74 65 64 20  ot it corrupted 
16b0: 62 79 20 61 73 79 6e 63 68 72 6f 6e 6f 75 73 20  by asynchronous 
16c0: 6f 70 65 72 61 74 69 6f 6e 2e 20 3c 62 3e 54 61  operation. <b>Ta
16d0: 62 6c 65 64 20 66 6f 72 20 6e 6f 77 2c 20 74 68  bled for now, th
16e0: 69 73 20 69 73 20 6e 6f 74 20 79 65 74 20 63 72  is is not yet cr
16f0: 69 74 69 63 61 6c 3c 2f 62 3e 0d 0a 3c 2f 6c 69  itical</b>..</li
1700: 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 2f 75 6c 3e 0d  >..</ul>..</ul>.
1710: 0a 0a 5a 20 63 35 32 30 36 33 31 34 31 66 38 32  ..Z c52063141f82
1720: 33 33 36 63 66 33 36 66 31 31 61 62 62 66 34 30  336cf36f11abbf40
1730: 37 65 39 31 0a                                   7e91.