Hex Artifact Content
Not logged in

Artifact 44635deb96c9ba324a8b472924c49b76b3e1fcc1:

File ideas.txt part of check-in [e1c1877c99] - Sync using clusters appears to work. More testing is needed before we go live. by drh on 2007-09-08 16:01:28. Also file ideas.txt part of check-in [bbcb6326c9] - Pulled in the navbar and timeline changes. by aku on 2007-09-17 00:58:51.

0000: 50 6f 73 73 69 62 6c 65 20 74 69 63 6b 65 74 20  Possible ticket 
0010: 66 69 6c 65 20 66 6f 72 6d 61 74 3a 0a 0a 20 20  file format:..  
0020: 20 22 54 69 63 6b 65 74 22 0a 20 20 20 74 69 74   "Ticket".   tit
0030: 6c 65 3a 20 54 45 58 54 0a 20 20 20 74 69 63 6b  le: TEXT.   tick
0040: 65 74 69 64 3a 20 54 45 58 54 0a 20 20 20 65 78  etid: TEXT.   ex
0050: 69 73 74 73 2d 69 6e 3a 20 42 41 53 45 4c 49 4e  ists-in: BASELIN
0060: 45 20 20 20 2d 2d 20 30 20 6f 72 20 6d 6f 72 65  E   -- 0 or more
0070: 0a 20 20 20 66 69 78 65 64 2d 69 6e 3a 20 42 41  .   fixed-in: BA
0080: 53 45 4c 49 4e 45 20 20 20 20 2d 2d 20 30 20 6f  SELINE    -- 0 o
0090: 72 20 6d 6f 72 65 0a 20 20 20 74 61 67 3a 20 54  r more.   tag: T
00a0: 41 47 20 20 20 20 20 20 20 20 20 20 20 20 20 20  AG              
00b0: 2d 2d 20 30 20 6f 72 20 6d 6f 72 65 0a 20 20 20  -- 0 or more.   
00c0: 63 72 65 61 74 65 64 3a 20 44 41 54 45 54 49 4d  created: DATETIM
00d0: 45 0a 20 20 20 61 74 74 61 63 68 6d 65 6e 74 3a  E.   attachment:
00e0: 20 46 49 4c 45 4e 41 4d 45 20 44 45 53 43 52 49   FILENAME DESCRI
00f0: 50 54 49 4f 4e 0a 20 20 20 70 61 72 65 6e 74 3a  PTION.   parent:
0100: 20 55 55 49 44 2a 0a 20 20 20 64 65 72 69 76 65   UUID*.   derive
0110: 64 2d 66 72 6f 6d 3a 20 54 49 43 4b 45 54 2d 46  d-from: TICKET-F
0120: 49 4c 45 4e 41 4d 45 0a 20 20 20 64 65 73 63 72  ILENAME.   descr
0130: 69 70 74 69 6f 6e 3a 20 4d 55 4c 54 49 4c 49 4e  iption: MULTILIN
0140: 45 2d 54 45 58 54 0a 20 20 20 72 65 6d 61 72 6b  E-TEXT.   remark
0150: 73 3a 20 4d 55 4c 54 49 4c 49 4e 45 2d 54 45 58  s: MULTILINE-TEX
0160: 54 0a 0a 20 20 20 2a 20 54 68 69 6e 67 73 20 68  T..   * Things h
0170: 61 6e 64 6c 65 73 20 77 69 74 68 20 74 61 67 73  andles with tags
0180: 3a 0a 20 20 20 20 20 63 72 65 61 74 65 64 2d 62  :.     created-b
0190: 79 0a 20 20 20 20 20 61 73 73 69 67 6e 65 64 2d  y.     assigned-
01a0: 74 6f 0a 20 20 20 20 20 70 72 69 6f 72 69 74 79  to.     priority
01b0: 0a 20 20 20 20 20 73 65 76 65 72 69 74 79 0a 20  .     severity. 
01c0: 20 20 20 20 74 61 72 67 65 74 2d 72 65 6c 65 61      target-relea
01d0: 73 65 0a 20 20 20 20 20 73 74 61 74 75 73 0a 20  se.     status. 
01e0: 20 20 20 20 72 65 73 6f 6c 75 74 69 6f 6e 0a 20      resolution. 
01f0: 20 20 20 20 74 79 70 65 0a 20 20 20 20 20 73 75      type.     su
0200: 62 73 79 73 74 65 6d 0a 0a 57 69 6b 69 20 68 65  bsystem..Wiki he
0210: 61 64 65 72 20 66 6f 72 6d 61 74 3a 0a 20 20 20  ader format:.   
0220: 22 57 69 6b 69 50 61 67 65 22 0a 20 20 20 70 61  "WikiPage".   pa
0230: 72 65 6e 74 3a 20 55 55 49 44 2a 0a 20 20 20 74  rent: UUID*.   t
0240: 69 74 6c 65 3a 20 54 45 58 54 0a 20 20 20 70 61  itle: TEXT.   pa
0250: 67 65 6e 61 6d 65 3a 20 54 45 58 54 0a 20 20 20  gename: TEXT.   
0260: 6d 6f 64 65 3a 20 28 72 65 61 64 6f 6e 6c 79 7c  mode: (readonly|
0270: 61 70 70 65 6e 64 6f 6e 6c 79 7c 72 65 61 64 77  appendonly|readw
0280: 72 69 74 65 29 0a 20 20 20 61 74 74 61 63 68 6d  rite).   attachm
0290: 65 6e 74 3a 20 55 55 49 44 20 6e 61 6d 65 20 64  ent: UUID name d
02a0: 65 73 63 72 69 70 74 69 6f 6e 0a 0a 20 20 20 2a  escription..   *
02b0: 20 48 65 61 64 65 72 20 65 6e 64 73 20 77 69 74   Header ends wit
02c0: 68 20 61 20 62 6c 61 6e 6b 20 6c 69 6e 65 2e 20  h a blank line. 
02d0: 20 77 69 6b 69 20 63 6f 6e 74 65 6e 74 20 66 6f   wiki content fo
02e0: 6c 6c 6f 77 73 2e 0a 0a 43 6c 75 73 74 65 72 20  llows...Cluster 
02f0: 66 6f 72 6d 61 74 3a 0a 0a 20 20 20 20 20 20 20  format:..       
0300: 4d 2b 20 75 75 69 64 0a 20 20 20 20 20 20 20 5a  M+ uuid.       Z
0310: 20 6d 61 6e 69 66 65 73 74 2d 63 6b 73 75 6d 0a   manifest-cksum.
0320: 0a 20 20 20 2a 20 43 6c 75 73 74 65 72 20 67 65  .   * Cluster ge
0330: 6e 65 72 61 74 65 64 20 69 6e 20 73 65 72 76 65  nerated in serve
0340: 72 20 6d 6f 64 65 20 6f 6e 6c 79 2e 0a 20 20 20  r mode only..   
0350: 2a 20 45 6d 62 61 72 67 6f 20 63 6c 75 73 74 65  * Embargo cluste
0360: 72 20 74 68 61 74 20 72 65 66 65 72 65 6e 63 65  r that reference
0370: 20 70 68 61 6e 74 6f 6d 73 20 6f 72 20 6f 74 68   phantoms or oth
0380: 65 72 20 65 6d 62 61 72 67 6f 65 64 20 63 6c 75  er embargoed clu
0390: 73 74 65 72 73 2e 0a 20 20 20 2a 20 4e 65 76 65  sters..   * Neve
03a0: 72 20 73 65 6e 64 20 6f 72 20 69 68 61 76 65 20  r send or ihave 
03b0: 61 6e 20 65 6d 62 61 72 67 6f 65 64 20 63 6c 75  an embargoed clu
03c0: 73 74 65 72 0a 0a 4e 65 77 20 73 79 6e 63 20 61  ster..New sync a
03d0: 6c 67 6f 72 69 74 68 6d 20 62 61 73 65 64 20 6f  lgorithm based o
03e0: 6e 20 63 6c 75 73 74 65 72 73 3a 0a 0a 20 20 20  n clusters:..   
03f0: 2a 20 4b 65 65 70 20 61 20 74 61 62 6c 65 20 6f  * Keep a table o
0400: 66 20 75 6e 63 6c 75 73 74 65 72 65 64 20 61 72  f unclustered ar
0410: 74 69 66 61 63 74 73 2e 20 20 53 74 72 69 76 65  tifacts.  Strive
0420: 20 74 6f 20 6b 65 65 70 20 74 68 69 73 20 74 61   to keep this ta
0430: 62 6c 65 0a 20 20 20 20 20 6c 65 73 73 20 74 68  ble.     less th
0440: 61 6e 20 31 30 30 20 65 6e 74 72 69 65 73 2e 0a  an 100 entries..
0450: 20 20 20 2a 20 43 6c 69 65 6e 74 20 73 65 6e 64     * Client send
0460: 73 20 63 6f 6e 74 65 6e 74 20 6f 66 20 75 6e 63  s content of unc
0470: 6c 75 73 74 65 72 65 64 20 74 61 62 6c 65 20 61  lustered table a
0480: 73 20 69 68 61 76 65 73 20 74 6f 20 73 65 72 76  s ihaves to serv
0490: 65 72 0a 20 20 20 2a 20 53 65 72 76 65 72 20 62  er.   * Server b
04a0: 75 69 6c 64 73 20 61 20 6e 65 77 20 63 6c 75 73  uilds a new clus
04b0: 74 65 72 20 69 66 20 73 69 7a 65 20 6f 66 20 63  ter if size of c
04c0: 6c 75 73 74 65 72 20 74 61 62 6c 65 20 3e 31 30  luster table >10
04d0: 30 2e 0a 20 20 20 2a 20 53 65 72 76 65 72 20 73  0..   * Server s
04e0: 65 6e 64 73 20 75 6e 63 6c 75 73 74 65 72 65 64  ends unclustered
04f0: 20 74 61 62 6c 65 20 74 6f 20 63 6c 69 65 6e 74   table to client
0500: 0a 20 20 20 2a 20 53 65 72 76 65 72 20 73 65 6e  .   * Server sen
0510: 64 73 20 67 69 6d 6d 65 20 66 6f 72 20 61 6c 6c  ds gimme for all
0520: 20 75 6e 6b 6e 6f 77 6e 20 69 68 61 76 65 20 72   unknown ihave r
0530: 65 63 65 69 76 65 64 20 66 72 6f 6d 20 63 6c 69  eceived from cli
0540: 65 6e 74 0a 20 20 20 2a 20 43 6c 69 65 6e 74 20  ent.   * Client 
0550: 73 65 6e 64 73 20 67 69 6d 6d 65 20 66 6f 72 20  sends gimme for 
0560: 61 6c 6c 20 75 6e 6b 6e 6f 77 6e 20 69 68 61 76  all unknown ihav
0570: 65 20 72 65 63 65 69 76 65 64 20 66 72 6f 6d 20  e received from 
0580: 73 65 72 76 65 72 0a 20 20 20 2a 20 50 72 65 76  server.   * Prev
0590: 69 6f 75 73 20 74 77 6f 20 73 74 65 70 73 20 72  ious two steps r
05a0: 65 70 65 61 74 20 75 6e 74 69 6c 20 6e 6f 20 6d  epeat until no m
05b0: 6f 72 65 20 67 69 6d 6d 65 73 0a 0a 44 65 74 61  ore gimmes..Deta
05c0: 69 6c 73 20 6f 66 20 6e 65 77 20 70 75 73 68 20  ils of new push 
05d0: 61 6c 67 6f 72 69 74 68 6d 3a 0a 0a 20 20 20 2a  algorithm:..   *
05e0: 20 54 61 62 6c 65 20 22 75 6e 73 65 6e 74 22 20   Table "unsent" 
05f0: 63 6f 6e 74 61 69 6e 73 20 61 6c 6c 20 66 69 6c  contains all fil
0600: 65 73 20 6e 65 76 65 72 20 70 75 73 68 65 64 0a  es never pushed.
0610: 20 20 20 2a 20 54 45 4d 50 20 74 61 62 6c 65 20     * TEMP table 
0620: 22 77 61 6e 74 65 64 22 20 63 6f 6e 74 61 69 6e  "wanted" contain
0630: 73 20 66 69 6c 65 73 20 74 68 65 20 73 65 72 76  s files the serv
0640: 65 72 20 64 6f 65 73 20 6e 6f 74 20 68 61 76 65  er does not have
0650: 0a 20 20 20 4c 6f 6f 70 3a 0a 20 20 20 20 20 2a  .   Loop:.     *
0660: 20 43 6c 69 65 6e 74 20 73 65 6e 64 73 20 6c 6f   Client sends lo
0670: 67 69 6e 20 61 6e 64 20 22 70 75 73 68 22 20 72  gin and "push" r
0680: 65 63 6f 72 64 0a 20 20 20 20 20 2a 20 43 6c 69  ecord.     * Cli
0690: 65 6e 74 20 73 65 6e 64 73 20 66 69 6c 65 20 6d  ent sends file m
06a0: 65 73 73 61 67 65 20 66 6f 72 20 61 6c 6c 20 66  essage for all f
06b0: 69 6c 65 73 20 69 6e 20 75 6e 73 65 6e 74 20 61  iles in unsent a
06c0: 6e 64 20 72 65 6d 6f 76 65 73 0a 20 20 20 20 20  nd removes.     
06d0: 20 20 74 68 6f 73 65 20 66 69 6c 65 73 20 66 72    those files fr
06e0: 6f 6d 20 74 68 65 20 74 61 62 6c 65 2e 0a 20 20  om the table..  
06f0: 20 20 20 2a 20 43 6c 69 65 6e 74 20 73 65 6e 64     * Client send
0700: 73 20 66 69 6c 65 20 6d 65 73 73 61 67 65 20 66  s file message f
0710: 6f 72 20 61 6c 6c 20 66 69 6c 65 73 20 69 6e 20  or all files in 
0720: 77 61 6e 74 65 64 2e 0a 20 20 20 20 20 2a 20 43  wanted..     * C
0730: 6c 69 65 6e 74 20 73 65 6e 64 73 20 69 68 61 76  lient sends ihav
0740: 65 20 6d 65 73 73 61 67 65 73 20 66 6f 72 20 65  e messages for e
0750: 61 63 68 20 65 6e 74 72 79 20 69 6e 20 75 6e 63  ach entry in unc
0760: 6c 75 73 74 65 72 65 64 0a 20 20 20 20 20 2d 2d  lustered.     --
0770: 2d 2d 2d 2d 0a 20 20 20 20 20 2a 20 53 65 72 76  ----.     * Serv
0780: 65 72 20 72 65 63 65 69 76 65 73 20 66 69 6c 65  er receives file
0790: 20 6d 65 73 73 61 67 65 0a 20 20 20 20 20 2a 20   message.     * 
07a0: 53 65 72 76 65 72 20 63 72 65 61 74 65 73 20 70  Server creates p
07b0: 68 61 6e 74 6f 6d 73 20 66 6f 72 20 75 6e 6b 6e  hantoms for unkn
07c0: 6f 77 6e 20 69 68 61 76 65 73 0a 20 20 20 20 20  own ihaves.     
07d0: 2a 20 53 65 72 76 65 72 20 73 65 6e 64 73 20 67  * Server sends g
07e0: 69 6d 6d 65 20 6d 65 73 73 61 67 65 73 20 66 6f  imme messages fo
07f0: 72 20 61 6c 6c 20 70 68 61 6e 74 6f 6d 73 0a 20  r all phantoms. 
0800: 20 20 20 20 2d 2d 2d 2d 2d 2d 0a 20 20 20 20 20      ------.     
0810: 2a 20 43 6c 69 65 6e 74 20 63 6c 65 61 72 73 20  * Client clears 
0820: 69 74 73 20 75 6e 73 65 6e 74 20 74 61 62 6c 65  its unsent table
0830: 0a 20 20 20 20 20 2a 20 46 6f 72 20 65 61 63 68  .     * For each
0840: 20 67 69 6d 6d 65 20 6d 65 73 73 61 67 65 20 61   gimme message a
0850: 64 64 20 61 6e 20 65 6e 74 72 79 20 74 6f 20 77  dd an entry to w
0860: 61 6e 74 65 64 0a 20 20 20 20 20 2a 20 48 61 6c  anted.     * Hal
0870: 74 20 69 66 20 74 68 65 20 77 61 6e 74 65 64 20  t if the wanted 
0880: 74 61 62 6c 65 20 69 73 20 65 6d 70 74 79 0a 0a  table is empty..
0890: 44 65 74 61 69 6c 73 20 6f 6e 20 6e 65 77 20 70  Details on new p
08a0: 75 6c 6c 20 61 6c 67 6f 72 69 74 68 6d 3a 0a 0a  ull algorithm:..
08b0: 20 20 20 4c 6f 6f 70 3a 0a 20 20 20 20 20 2a 20     Loop:.     * 
08c0: 43 6c 69 65 6e 74 20 73 65 6e 64 73 20 6c 6f 67  Client sends log
08d0: 69 6e 20 61 6e 64 20 22 70 75 6c 6c 22 20 72 65  in and "pull" re
08e0: 63 6f 72 64 0a 20 20 20 20 20 2a 20 43 6c 69 65  cord.     * Clie
08f0: 6e 74 20 73 65 6e 64 73 20 22 70 72 69 6f 72 22  nt sends "prior"
0900: 20 6d 65 73 73 61 67 65 20 77 69 74 68 20 72 65   message with re
0910: 70 6f 73 69 74 6f 72 79 20 69 64 20 61 6e 64 20  pository id and 
0920: 6d 61 78 20 72 65 63 6f 72 64 20 6e 75 6d 62 65  max record numbe
0930: 72 0a 20 20 20 20 20 2a 20 43 6c 69 65 6e 74 20  r.     * Client 
0940: 73 65 6e 64 73 20 22 67 69 6d 6d 65 22 20 66 6f  sends "gimme" fo
0950: 72 20 65 61 63 68 20 70 68 61 6e 74 6f 6d 0a 20  r each phantom. 
0960: 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 0a 20 20 20      --------.   
0970: 20 20 2a 20 53 65 72 76 65 72 20 63 72 65 61 74    * Server creat
0980: 65 73 20 6e 65 77 20 63 6c 75 73 74 65 72 73 20  es new clusters 
0990: 74 6f 20 67 65 74 20 75 6e 63 6c 75 73 74 65 72  to get uncluster
09a0: 65 64 20 73 69 7a 65 20 62 65 6c 6f 77 20 31 30  ed size below 10
09b0: 30 0a 20 20 20 20 20 2a 20 49 66 20 74 68 65 72  0.     * If ther
09c0: 65 20 69 73 20 22 70 72 69 6f 72 22 20 6d 65 73  e is "prior" mes
09d0: 73 61 67 65 20 77 69 74 68 20 72 65 70 6f 73 69  sage with reposi
09e0: 74 6f 72 79 20 69 64 20 74 68 61 74 20 6d 61 74  tory id that mat
09f0: 63 68 65 73 20 74 68 69 73 0a 20 20 20 20 20 20  ches this.      
0a00: 20 73 65 72 76 65 72 2c 20 74 68 65 6e 20 73 65   server, then se
0a10: 6e 64 20 66 69 6c 65 20 6d 65 73 73 61 67 65 73  nd file messages
0a20: 20 66 6f 72 20 61 6c 6c 20 72 65 63 6f 72 64 20   for all record 
0a30: 69 64 73 20 67 72 65 61 74 65 72 20 74 68 61 6e  ids greater than
0a40: 0a 20 20 20 20 20 20 20 70 72 69 6f 72 0a 20 20  .       prior.  
0a50: 20 20 20 2a 20 53 65 72 76 65 72 20 73 65 6e 64     * Server send
0a60: 73 20 69 68 61 76 65 20 6d 65 73 73 61 67 65 73  s ihave messages
0a70: 20 66 6f 72 20 65 61 63 68 20 65 6e 74 72 79 20   for each entry 
0a80: 69 6e 20 75 6e 63 6c 75 73 74 65 72 65 64 0a 20  in unclustered. 
0a90: 20 20 20 20 2a 20 53 65 72 76 65 72 20 73 65 6e      * Server sen
0aa0: 64 73 20 6d 61 78 72 69 64 20 6d 65 73 73 61 67  ds maxrid messag
0ab0: 65 0a 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 0a  e.     --------.
0ac0: 20 20 20 20 20 2a 20 43 6c 69 65 6e 74 20 72 65       * Client re
0ad0: 63 65 69 76 65 73 20 66 69 6c 65 20 72 65 63 6f  ceives file reco
0ae0: 72 64 73 0a 20 20 20 20 20 2a 20 43 6c 69 65 6e  rds.     * Clien
0af0: 74 20 63 72 65 61 74 65 73 20 70 68 61 6e 74 6f  t creates phanto
0b00: 6d 73 20 66 6f 72 20 75 6e 6b 6e 6f 77 6e 20 69  ms for unknown i
0b10: 68 61 76 65 73 0a 20 20 20 20 20 2a 20 49 66 20  haves.     * If 
0b20: 6e 6f 20 70 68 61 6e 74 6f 6d 73 20 65 78 69 73  no phantoms exis
0b30: 74 2c 20 72 65 63 6f 72 64 20 6d 61 78 72 69 64  t, record maxrid
0b40: 20 66 6f 72 20 74 68 65 20 73 65 72 76 65 72 20   for the server 
0b50: 61 6e 64 20 68 61 6c 74 0a 0a 4e 65 65 64 20 61  and halt..Need a
0b60: 20 64 65 70 68 61 6e 74 6f 6d 69 7a 65 20 61 6c   dephantomize al
0b70: 67 6f 72 69 74 68 6d 0a 0a 0a 41 75 78 69 6c 69  gorithm...Auxili
0b80: 61 72 79 20 74 61 62 6c 65 73 20 6e 65 65 64 65  ary tables neede
0b90: 64 20 66 6f 72 20 6e 65 77 20 73 79 6e 63 20 61  d for new sync a
0ba0: 6c 67 6f 72 69 74 68 6d 3a 0a 0a 20 20 20 2a 20  lgorithm:..   * 
0bb0: 75 6e 73 65 6e 74 3a 20 20 66 69 6c 65 73 20 74  unsent:  files t
0bc0: 68 61 74 20 68 61 76 65 20 6e 65 76 65 72 20 62  hat have never b
0bd0: 65 65 6e 20 73 65 6e 74 20 74 6f 20 61 6e 6f 74  een sent to anot
0be0: 68 65 72 20 72 65 70 6f 73 69 74 6f 72 79 0a 20  her repository. 
0bf0: 20 20 2a 20 75 6e 63 6c 75 73 74 65 72 65 64 3a    * unclustered:
0c00: 20 6e 6f 6e 2d 70 68 61 6e 74 6f 6d 20 66 69 6c   non-phantom fil
0c10: 65 73 20 6e 6f 74 20 6d 65 6e 74 69 6f 6e 65 64  es not mentioned
0c20: 20 62 79 20 61 20 63 6c 75 73 74 65 72 0a 0a 52   by a cluster..R
0c30: 61 6e 64 6f 6d 20 74 68 6f 75 67 68 74 73 3a 0a  andom thoughts:.
0c40: 0a 20 20 2a 20 20 43 68 61 6e 67 65 73 20 74 6f  .  *  Changes to
0c50: 20 6d 61 6e 69 66 65 73 74 20 74 6f 20 73 75 70   manifest to sup
0c60: 70 6f 72 74 3a 0a 20 20 20 20 20 2b 20 20 54 72  port:.     +  Tr
0c70: 65 65 73 20 6f 66 20 77 69 6b 69 20 70 61 67 65  ees of wiki page
0c80: 73 20 61 6e 64 20 74 69 63 6b 65 74 73 0a 20 20  s and tickets.  
0c90: 20 20 20 2b 20 20 54 68 65 20 61 62 69 6c 69 74     +  The abilit
0ca0: 79 20 74 6f 20 63 61 70 20 6f 72 20 63 6c 6f 73  y to cap or clos
0cb0: 65 20 61 20 62 72 61 6e 63 68 0a 20 20 20 20 20  e a branch.     
0cc0: 2b 20 20 53 65 65 20 22 45 78 74 65 6e 64 65 64  +  See "Extended
0cd0: 20 4d 61 6e 69 66 65 73 74 73 22 20 62 65 6c 6f   Manifests" belo
0ce0: 77 0a 0a 20 20 2a 20 20 41 64 64 20 74 68 65 20  w..  *  Add the 
0cf0: 63 6f 6e 63 65 70 74 20 6f 66 20 22 63 6c 75 73  concept of "clus
0d00: 74 65 72 73 22 20 74 6f 20 73 70 65 65 64 20 74  ters" to speed t
0d10: 68 65 20 74 72 61 6e 73 66 65 72 20 6f 66 20 22  he transfer of "
0d20: 74 69 70 73 22 0a 20 20 20 20 20 6f 6e 20 61 20  tips".     on a 
0d30: 73 79 6e 63 2e 0a 0a 20 20 2a 20 20 41 75 78 69  sync...  *  Auxi
0d40: 6c 69 61 72 79 20 74 61 62 6c 65 73 3a 0a 20 20  liary tables:.  
0d50: 20 20 20 2b 20 20 74 69 70 0a 20 20 20 20 20 2b     +  tip.     +
0d60: 20 20 70 68 61 6e 74 6f 6d 0a 20 20 20 20 20 2b    phantom.     +
0d70: 20 20 6d 6c 69 6e 6b 0a 20 20 20 20 20 2b 20 20    mlink.     +  
0d80: 70 6c 69 6e 6b 0a 20 20 20 20 20 2b 20 20 62 72  plink.     +  br
0d90: 61 6e 63 68 0a 20 20 20 20 20 2b 20 20 74 72 65  anch.     +  tre
0da0: 65 0a 0a 20 20 2a 20 50 6c 69 6e 6b 2e 69 73 70  e..  * Plink.isp
0db0: 72 69 6d 20 63 68 61 6e 67 65 64 20 74 6f 20 72  rim changed to r
0dc0: 65 63 6f 72 64 3a 0a 20 20 20 20 20 2b 20 20 63  ecord:.     +  c
0dd0: 68 69 6c 64 20 69 73 20 74 68 65 20 70 72 69 6e  hild is the prin
0de0: 63 69 70 61 6c 20 64 65 73 63 65 6e 64 65 6e 74  cipal descendent
0df0: 20 6f 66 20 70 61 72 65 6e 74 2e 20 28 31 29 0a   of parent. (1).
0e00: 20 20 20 20 20 2b 20 20 63 68 69 6c 64 20 69 73       +  child is
0e10: 20 61 20 62 72 61 6e 63 68 20 66 72 6f 6d 20 70   a branch from p
0e20: 61 72 65 6e 74 20 28 32 29 0a 20 20 20 20 20 2b  arent (2).     +
0e30: 20 20 63 68 69 6c 64 20 75 73 65 73 20 70 61 72    child uses par
0e40: 65 6e 74 20 61 73 20 61 20 6d 65 72 67 65 20 28  ent as a merge (
0e50: 30 29 0a 0a 20 20 2a 20 74 72 65 65 20 72 65 63  0)..  * tree rec
0e60: 6f 72 64 73 0a 20 20 20 20 20 2b 20 74 79 70 65  ords.     + type
0e70: 20 20 28 63 6f 64 65 2c 20 77 69 6b 69 2c 20 74    (code, wiki, t
0e80: 69 63 6b 65 74 29 0a 20 20 20 20 20 2b 20 6e 61  icket).     + na
0e90: 6d 65 20 20 28 66 6f 72 20 77 69 6b 69 20 61 6e  me  (for wiki an
0ea0: 64 20 74 69 63 6b 65 74 20 6f 6e 6c 79 29 0a 20  d ticket only). 
0eb0: 20 20 20 20 2b 20 74 72 65 65 69 64 0a 0a 20 20      + treeid..  
0ec0: 2a 20 62 72 61 6e 63 68 20 72 65 63 6f 72 64 73  * branch records
0ed0: 0a 20 20 20 20 20 2b 20 74 72 65 65 69 64 0a 20  .     + treeid. 
0ee0: 20 20 20 20 2b 20 6f 72 69 67 69 6e 5f 72 69 64      + origin_rid
0ef0: 0a 20 20 20 20 20 2b 20 6f 72 69 67 69 6e 5f 74  .     + origin_t
0f00: 69 6d 65 0a 20 20 20 20 20 2b 20 74 69 70 5f 72  ime.     + tip_r
0f10: 69 64 0a 20 20 20 20 20 2b 20 74 69 70 5f 74 69  id.     + tip_ti
0f20: 6d 65 0a 20 20 20 20 20 2b 20 63 6f 6c 6f 72 0a  me.     + color.
0f30: 0a 20 20 2a 20 77 65 62 73 69 74 65 20 63 61 6e  .  * website can
0f40: 20 74 6f 67 67 6c 65 20 69 73 70 72 69 6d 20 62   toggle isprim b
0f50: 65 74 77 65 65 6e 20 70 72 69 6e 63 69 70 61 6c  etween principal
0f60: 20 61 6e 64 20 62 72 61 6e 63 68 2e 0a 20 20 20   and branch..   
0f70: 20 20 2b 20 48 6f 77 20 74 6f 20 70 72 65 73 65    + How to prese
0f80: 72 76 65 20 61 63 72 6f 73 73 20 72 65 62 75 69  rve across rebui
0f90: 6c 64 2e 20 20 41 20 6e 65 77 20 72 65 63 6f 72  ld.  A new recor
0fa0: 64 20 74 79 70 65 3f 0a 20 20 20 20 20 2b 20 48  d type?.     + H
0fb0: 6f 77 20 74 6f 20 73 68 61 72 65 20 77 69 74 68  ow to share with
0fc0: 20 6f 74 68 65 72 20 72 65 70 6f 73 69 74 6f 72   other repositor
0fd0: 69 65 73 0a 20 20 2a 20 69 73 70 72 69 6d 20 67  ies.  * isprim g
0fe0: 75 65 73 73 65 64 20 75 73 69 6e 67 20 75 73 65  uessed using use
0ff0: 72 69 64 20 6f 66 20 70 61 72 65 6e 74 20 61 6e  rid of parent an
1000: 64 20 63 68 69 6c 64 2e 20 20 43 68 61 6e 67 65  d child.  Change
1010: 0a 20 20 20 20 69 6e 20 69 64 20 73 75 67 67 65  .    in id sugge
1020: 73 74 73 20 61 20 62 72 61 6e 63 68 2e 20 20 53  sts a branch.  S
1030: 61 6d 65 20 69 64 20 73 75 67 67 65 73 74 73 20  ame id suggests 
1040: 70 72 69 6e 63 69 70 61 6c 2e 0a 20 20 20 20 46  principal..    F
1050: 6f 72 20 61 20 74 69 65 2c 20 67 6f 20 77 69 74  or a tie, go wit
1060: 68 20 74 68 65 20 65 61 72 6c 69 65 73 74 20 63  h the earliest c
1070: 68 65 63 6b 2d 69 6e 20 61 73 20 74 68 65 20 70  heck-in as the p
1080: 72 69 6e 63 69 70 61 6c 27 0a 0a 20 20 2a 20 41  rincipal'..  * A
1090: 75 74 6f 73 79 6e 63 20 6d 6f 64 65 0a 20 20 20  utosync mode.   
10a0: 20 20 2b 20 53 65 74 20 61 20 70 72 65 66 65 72    + Set a prefer
10b0: 72 65 64 20 72 65 6d 6f 74 65 20 72 65 70 6f 73  red remote repos
10c0: 69 74 6f 72 79 20 74 6f 20 75 73 65 20 61 73 20  itory to use as 
10d0: 61 20 73 65 72 76 65 72 0a 20 20 20 20 20 20 20  a server.       
10e0: 20 3d 20 20 43 6c 6f 6e 65 20 72 65 70 6f 73 69   =  Clone reposi
10f0: 74 6f 72 79 20 69 73 20 74 68 65 20 64 65 66 61  tory is the defa
1100: 75 6c 74 0a 20 20 20 20 20 2b 20 4f 6e 20 63 6f  ult.     + On co
1110: 6d 6d 69 74 2c 20 66 69 72 73 74 20 70 75 6c 6c  mmit, first pull
1120: 2e 20 20 49 66 20 63 6f 6d 6d 69 74 20 62 61 73  .  If commit bas
1130: 65 6c 69 6e 65 20 69 73 20 6e 6f 74 20 61 20 74  eline is not a t
1140: 69 70 0a 20 20 20 20 20 20 20 70 72 6f 6d 70 74  ip.       prompt
1150: 20 75 73 65 72 20 74 6f 20 63 61 6e 63 65 6c 20   user to cancel 
1160: 6f 72 20 62 72 61 6e 63 68 2e 20 20 44 65 66 61  or branch.  Defa
1170: 75 6c 74 20 69 73 20 63 61 6e 63 65 6c 2e 0a 20  ult is cancel.. 
1180: 20 20 20 20 2b 20 50 75 73 68 20 61 66 74 65 72      + Push after
1190: 20 63 6f 6d 6d 69 74 0a 20 20 20 20 20 2b 20 41   commit.     + A
11a0: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 70 75 6c  utomatically pul
11b0: 6c 20 70 72 69 6f 72 20 74 6f 20 75 70 64 61 74  l prior to updat
11c0: 65 2e 0a 20 20 20 20 20 2b 20 4e 65 65 64 20 61  e..     + Need a
11d0: 6e 20 22 75 6e 64 6f 22 20 63 61 70 61 62 69 6c  n "undo" capabil
11e0: 69 74 79 0a 20 20 20 20 20 2b 20 44 65 73 69 67  ity.     + Desig
11f0: 6e 65 64 20 74 6f 20 61 76 6f 69 64 20 62 72 61  ned to avoid bra
1200: 6e 63 68 69 6e 67 20 69 6e 20 68 69 67 68 6c 79  nching in highly
1210: 20 63 6f 6c 6c 61 62 6f 72 61 74 69 76 65 20 0a   collaborative .
1220: 20 20 20 20 20 20 20 65 6e 76 69 72 6f 6e 6d 65         environme
1230: 6e 74 73 2e 0a 0a 20 20 2a 20 41 72 63 68 65 6f  nts...  * Archeo
1240: 6c 6f 67 69 63 61 6c 20 77 65 62 70 61 67 65 20  logical webpage 
1250: 69 6d 70 72 6f 76 65 6d 65 6e 74 73 3a 0a 20 20  improvements:.  
1260: 20 20 20 2b 20 55 73 65 20 61 20 73 6d 61 6c 6c     + Use a small
1270: 20 61 6d 6f 75 6e 74 20 6f 66 20 43 53 53 2b 6a   amount of CSS+j
1280: 61 76 61 73 63 72 69 70 74 20 6f 6e 20 74 69 6d  avascript on tim
1290: 65 6c 69 6e 65 73 20 73 6f 20 74 68 61 74 0a 20  elines so that. 
12a0: 20 20 20 20 20 20 62 72 61 6e 63 68 69 6e 67 20        branching 
12b0: 73 74 72 75 63 74 75 72 65 20 69 73 20 64 69 73  structure is dis
12c0: 70 6c 61 79 65 64 20 6f 6e 20 6d 6f 75 73 65 6f  played on mouseo
12d0: 76 65 72 2e 20 20 4f 6e 20 6d 6f 75 73 65 6f 76  ver.  On mouseov
12e0: 65 72 0a 20 20 20 20 20 20 20 6f 66 20 61 20 63  er.       of a c
12f0: 68 65 63 6b 69 6e 2c 20 68 69 67 68 6c 69 67 68  heckin, highligh
1300: 74 20 6f 74 68 65 72 20 63 68 65 63 6b 69 6e 73  t other checkins
1310: 20 74 68 61 74 20 61 72 65 20 64 69 72 65 63 74   that are direct
1320: 20 28 6e 6f 6e 2d 6d 65 72 67 65 29 0a 20 20 20   (non-merge).   
1330: 20 20 20 20 64 65 73 63 65 6e 64 65 6e 74 73 20      descendents 
1340: 61 6e 64 20 61 6e 63 65 73 74 6f 72 73 20 6f 66  and ancestors of
1350: 20 74 68 65 20 6d 6f 75 73 65 6f 76 65 72 20 63   the mouseover c
1360: 68 65 63 6b 69 6e 2e 0a 20 20 20 20 20 2b 20 54  heckin..     + T
1370: 69 6d 65 6c 69 6e 65 20 73 68 6f 77 69 6e 67 20  imeline showing 
1380: 69 6e 64 69 76 69 64 75 61 6c 20 62 72 61 6e 63  individual branc
1390: 68 65 73 0a 20 20 20 20 20 2b 20 54 69 6d 65 6c  hes.     + Timel
13a0: 69 6e 65 20 73 68 6f 77 73 20 66 6f 72 6b 73 20  ine shows forks 
13b0: 61 6e 64 20 6d 65 72 67 65 73 0a 20 20 20 20 20  and merges.     
13c0: 2b 20 54 61 67 73 20 73 68 6f 77 6e 20 6f 6e 20  + Tags shown on 
13d0: 74 69 6d 65 6c 69 6e 65 20 28 6d 61 79 62 65 29  timeline (maybe)
13e0: 20 61 6e 64 20 69 6e 20 76 69 6e 66 6f 20 28 73   and in vinfo (s
13f0: 75 72 65 6c 79 29 2e 0a 0a 46 65 61 74 75 72 65  urely)...Feature
1400: 73 20 6e 65 65 64 65 64 3a 0a 20 20 2a 20 4d 65  s needed:.  * Me
1410: 61 6e 73 20 74 6f 20 73 75 70 70 72 65 73 73 20  ans to suppress 
1420: 61 72 74 69 66 61 63 74 73 0a 20 20 2a 20 4d 65  artifacts.  * Me
1430: 61 6e 73 20 74 6f 20 63 61 70 20 61 20 62 72 61  ans to cap a bra
1440: 6e 63 68 0a 20 20 2a 20 54 69 63 6b 65 74 69 6e  nch.  * Ticketin
1450: 67 0a 20 20 20 20 20 2b 20 20 50 72 6f 62 6c 65  g.     +  Proble
1460: 6d 20 69 73 2f 69 73 2d 6e 6f 74 20 65 78 70 72  m is/is-not expr
1470: 65 73 73 65 64 20 69 6e 20 62 61 73 65 6c 69 6e  essed in baselin
1480: 65 20 58 2e 0a 20 20 20 20 20 2b 20 20 41 70 70  e X..     +  App
1490: 65 6e 64 20 63 6f 6d 6d 65 6e 74 20 61 6e 64 20  end comment and 
14a0: 7a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 61 74 74  zero or more att
14b0: 61 63 68 6d 65 6e 74 73 0a 20 20 2a 20 4d 6f 64  achments.  * Mod
14c0: 69 66 79 20 63 6f 6d 6d 65 6e 74 73 20 6f 6e 20  ify comments on 
14d0: 62 61 73 65 6c 69 6e 65 73 0a 20 20 2a 20 41 70  baselines.  * Ap
14e0: 70 65 6e 64 20 63 6f 6d 6d 65 6e 74 73 20 74 6f  pend comments to
14f0: 20 61 6e 79 20 61 72 74 69 66 61 63 74 0a 20 20   any artifact.  
1500: 2a 20 57 69 6b 69 3f 0a 0a 20 20 0a 0a 45 78 74  * Wiki?..  ..Ext
1510: 65 6e 64 65 64 20 6d 61 6e 69 66 65 73 74 73 2e  ended manifests.
1520: 0a 20 20 2a 20 6e 6f 72 6d 61 6c 20 6d 61 6e 69  .  * normal mani
1530: 66 65 73 74 20 68 61 73 3a 0a 20 20 20 20 20 20  fest has:.      
1540: 20 43 20 63 6f 6d 6d 65 6e 74 0a 20 20 20 20 20   C comment.     
1550: 20 20 44 20 64 61 74 65 2d 74 69 6d 65 0a 20 20    D date-time.  
1560: 20 20 20 20 20 46 2a 20 66 69 6c 65 6e 61 6d 65       F* filename
1570: 20 75 75 69 64 0a 20 20 20 20 20 20 20 50 20 75   uuid.       P u
1580: 75 69 64 20 2e 2e 2e 20 20 20 20 20 20 20 20 20  uid ...         
1590: 20 20 2d 2d 20 6f 6d 69 74 74 65 64 20 66 6f 72    -- omitted for
15a0: 20 66 69 72 73 74 20 6d 61 6e 69 66 65 73 74 0a   first manifest.
15b0: 20 20 20 20 20 20 20 52 20 72 65 70 6f 73 69 74         R reposit
15c0: 6f 72 79 2d 6d 64 35 73 75 6d 0a 20 20 20 20 20  ory-md5sum.     
15d0: 20 20 55 20 75 73 65 72 2d 6c 6f 67 69 6e 0a 20    U user-login. 
15e0: 20 20 20 20 20 20 5a 20 6d 61 6e 69 66 65 73 74        Z manifest
15f0: 2d 63 68 65 63 6b 73 75 6d 0a 0a 20 20 2a 20 41  -checksum..  * A
1600: 63 63 65 73 73 6f 72 79 3a 0a 20 20 20 20 20 20  ccessory:.      
1610: 20 41 20 75 75 69 64 7c 2a 20 61 74 74 61 63 68   A uuid|* attach
1620: 6d 65 6e 74 2d 75 75 69 64 20 64 65 73 63 72 69  ment-uuid descri
1630: 70 74 69 6f 6e 0a 20 20 20 20 20 20 20 42 20 28  ption.       B (
1640: 2b 7c 2d 29 62 72 61 6e 63 68 74 61 67 20 75 75  +|-)branchtag uu
1650: 69 64 0a 20 20 20 20 20 20 20 44 20 64 61 74 65  id.       D date
1660: 2d 74 69 6d 65 0a 20 20 20 20 20 20 20 45 20 75  -time.       E u
1670: 75 69 64 20 6e 65 77 2d 63 6f 6d 6d 65 6e 74 0a  uid new-comment.
1680: 20 20 20 20 20 20 20 47 20 75 75 69 64 20 61 70         G uuid ap
1690: 70 65 6e 64 65 64 2d 72 65 6d 61 72 6b 0a 20 20  pended-remark.  
16a0: 20 20 20 20 20 53 20 72 65 70 6f 73 69 74 6f 72       S repositor
16b0: 79 69 64 20 73 65 72 69 61 6c 2d 6e 75 6d 62 65  yid serial-numbe
16c0: 72 0a 20 20 20 20 20 20 20 55 20 75 73 65 72 69  r.       U useri
16d0: 64 0a 20 20 20 20 20 20 20 56 20 28 2b 7c 2d 29  d.       V (+|-)
16e0: 76 65 72 73 69 6f 6e 74 61 67 20 75 75 69 64 0a  versiontag uuid.
16f0: 20 20 20 20 20 20 20 58 20 75 75 69 64 2d 74 6f         X uuid-to
1700: 2d 73 75 72 70 72 65 73 73 0a 20 20 20 20 20 20  -surpress.      
1710: 20 5a 20 74 68 69 73 2d 66 69 6c 65 2d 63 68 65   Z this-file-che
1720: 63 6b 73 75 6d 0a 0a 20 20 2a 20 43 68 61 6e 67  cksum..  * Chang
1730: 65 20 74 68 65 20 63 6f 6d 6d 65 6e 74 20 6f 6e  e the comment on
1740: 20 61 20 76 65 72 73 69 6f 6e 3a 20 20 20 2d 2d   a version:   --
1750: 20 61 6c 77 61 79 73 20 61 20 6c 65 61 66 20 65   always a leaf e
1760: 78 63 65 70 74 20 69 6e 20 63 6c 75 73 74 65 72  xcept in cluster
1770: 0a 20 20 20 20 20 20 20 44 20 64 61 74 65 2d 74  .       D date-t
1780: 69 6d 65 0a 20 20 20 20 20 20 20 45 20 6e 65 77  ime.       E new
1790: 2d 63 6f 6d 6d 65 6e 74 0a 20 20 20 20 20 20 20  -comment.       
17a0: 50 20 75 75 69 64 20 20 20 20 20 20 20 20 20 20  P uuid          
17b0: 20 20 20 20 2d 2d 20 62 61 73 65 6c 69 6e 65 20      -- baseline 
17c0: 77 68 6f 73 65 20 63 6f 6d 6d 65 6e 74 20 69 73  whose comment is
17d0: 20 63 68 61 6e 67 65 64 0a 20 20 20 20 20 20 20   changed.       
17e0: 55 20 75 73 65 72 2d 6c 6f 67 69 6e 0a 20 20 20  U user-login.   
17f0: 20 20 20 20 5a 20 63 68 65 63 6b 73 75 6d 0a 20      Z checksum. 
1800: 20 20 20 20 20 20 2d 2d 20 6d 6f 73 74 20 72 65        -- most re
1810: 63 65 6e 74 20 77 69 6e 73 0a 20 20 2a 20 57 69  cent wins.  * Wi
1820: 6b 69 20 65 64 69 74 0a 20 20 20 20 20 20 20 41  ki edit.       A
1830: 2a 20 6e 61 6d 65 20 75 75 69 64 20 20 20 2d 2d  * name uuid   --
1840: 20 7a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 61 74   zero or more at
1850: 74 61 63 68 6d 65 6e 74 73 0a 20 20 20 20 20 20  tachments.      
1860: 20 43 3f 20 63 6f 6d 6d 65 6e 74 0a 20 20 20 20   C? comment.    
1870: 20 20 20 44 20 64 61 74 65 2d 74 69 6d 65 0a 20     D date-time. 
1880: 20 20 20 20 20 20 4e 20 6e 61 6d 65 20 20 20 20        N name    
1890: 20 20 20 20 20 2d 2d 20 6e 61 6d 65 20 6f 66 20       -- name of 
18a0: 74 68 65 20 77 69 6b 69 20 70 61 67 65 0a 20 20  the wiki page.  
18b0: 20 20 20 20 20 50 20 75 75 69 64 20 2e 2e 2e 20       P uuid ... 
18c0: 20 20 20 20 2d 2d 20 6f 6d 69 74 20 66 6f 72 20      -- omit for 
18d0: 6e 65 77 20 77 69 6b 69 0a 20 20 20 20 20 20 20  new wiki.       
18e0: 55 20 75 73 65 72 2d 6c 6f 67 69 6e 0a 20 20 20  U user-login.   
18f0: 20 20 20 20 57 20 75 75 69 64 20 20 20 20 20 20      W uuid      
1900: 20 20 20 2d 2d 20 54 68 65 20 63 6f 6e 74 65 6e     -- The conten
1910: 74 20 66 69 6c 65 0a 20 20 20 20 20 20 20 5a 20  t file.       Z 
1920: 6d 61 6e 69 66 65 73 74 2d 63 6b 73 75 6d 0a 20  manifest-cksum. 
1930: 20 2a 20 54 69 63 6b 65 74 20 65 64 69 74 0a 20   * Ticket edit. 
1940: 20 20 20 20 20 20 41 2a 20 6e 61 6d 65 20 75 75        A* name uu
1950: 69 64 20 20 20 2d 2d 20 7a 65 72 6f 20 6f 72 20  id   -- zero or 
1960: 6d 6f 72 65 20 61 74 74 61 63 68 6d 65 6e 74 73  more attachments
1970: 0a 20 20 20 20 20 20 20 44 20 64 61 74 65 2d 74  .       D date-t
1980: 69 6d 65 0a 20 20 20 20 20 20 20 4e 20 6e 61 6d  ime.       N nam
1990: 65 20 20 20 20 20 20 20 20 20 2d 2d 20 6e 61 6d  e         -- nam
19a0: 65 20 6f 66 20 74 68 65 20 74 69 63 6b 65 74 0a  e of the ticket.
19b0: 20 20 20 20 20 20 20 50 20 75 75 69 64 20 20 20         P uuid   
19c0: 20 20 20 20 20 20 2d 2d 20 6f 6d 69 74 20 66 6f        -- omit fo
19d0: 72 20 6e 65 77 20 74 69 63 6b 65 74 0a 20 20 20  r new ticket.   
19e0: 20 20 20 20 54 20 75 75 69 64 20 20 20 20 20 20      T uuid      
19f0: 20 20 20 2d 2d 20 63 6f 6e 74 65 6e 74 20 6f 66     -- content of
1a00: 20 74 68 65 20 74 69 63 6b 65 74 0a 20 20 20 20   the ticket.    
1a10: 20 20 20 55 20 75 73 65 72 2d 6c 6f 67 69 6e 0a     U user-login.
1a20: 20 20 20 20 20 20 20 5a 20 6d 61 6e 69 66 65 73         Z manifes
1a30: 74 2d 63 6b 73 75 6d 0a 20 20 2a 20 53 65 74 20  t-cksum.  * Set 
1a40: 6f 72 20 65 72 61 73 65 20 61 20 74 61 67 20 20  or erase a tag  
1a50: 20 20 2d 2d 20 6d 6f 73 74 20 72 65 63 65 6e 74    -- most recent
1a60: 20 64 61 74 65 20 77 69 6e 73 0a 20 20 20 20 20   date wins.     
1a70: 20 20 42 2a 20 28 2b 7c 2d 29 74 61 67 20 75 75    B* (+|-)tag uu
1a80: 69 64 0a 20 20 20 20 20 20 20 43 3f 20 63 6f 6d  id.       C? com
1a90: 6d 65 6e 74 0a 20 20 20 20 20 20 20 44 20 64 61  ment.       D da
1aa0: 74 65 2d 74 69 6d 65 0a 20 20 20 20 20 20 20 56  te-time.       V
1ab0: 2a 20 28 2b 7c 2d 29 20 74 61 67 20 75 75 69 64  * (+|-) tag uuid
1ac0: 20 20 20 20 2d 2d 20 2b 20 74 6f 20 73 65 74 2c      -- + to set,
1ad0: 20 2d 20 74 6f 20 63 6c 65 61 72 2e 20 20 0a 20   - to clear.  . 
1ae0: 20 20 20 20 20 20 5a 20 6d 61 6e 69 66 65 73 74        Z manifest
1af0: 2d 63 6b 73 75 6d 0a 20 20 20 20 20 20 20 2d 2d  -cksum.       --
1b00: 20 4d 75 73 74 20 68 61 76 65 20 61 74 20 6c 65   Must have at le
1b10: 61 73 74 20 6f 6e 65 20 42 20 6f 72 20 56 2e 0a  ast one B or V..
1b20: 20 20 20 20 20 20 20 2d 2d 20 54 61 67 20 22 68         -- Tag "h
1b30: 69 64 64 65 6e 22 20 6d 65 61 6e 73 20 64 6f 20  idden" means do 
1b40: 6e 6f 74 20 73 79 6e 63 0a 20 20 20 20 20 20 20  not sync.       
1b50: 2d 2d 20 54 61 67 20 22 63 6c 6f 73 65 64 22 20  -- Tag "closed" 
1b60: 6d 65 61 6e 73 20 64 6f 20 6e 6f 74 20 64 69 73  means do not dis
1b70: 70 6c 61 79 20 61 73 20 61 20 6c 65 61 66 0a 20  play as a leaf. 
1b80: 20 2a 20 41 20 63 6c 75 73 74 65 72 0a 20 20 20   * A cluster.   
1b90: 20 20 20 20 4d 2b 20 75 75 69 64 0a 20 20 20 20      M+ uuid.    
1ba0: 20 20 20 5a 20 6d 61 6e 69 66 65 73 74 2d 63 6b     Z manifest-ck
1bb0: 73 75 6d 0a 20 20 2a 20 43 6f 6d 70 6c 65 74 65  sum.  * Complete
1bc0: 20 73 65 74 20 6f 66 20 63 61 72 64 73 20 69 6e   set of cards in
1bd0: 20 61 20 6d 61 6e 69 66 65 73 74 20 66 69 6c 65   a manifest file
1be0: 73 3a 0a 20 20 20 20 20 20 20 41 20 66 69 6c 65  s:.       A file
1bf0: 6e 61 6d 65 20 75 75 69 64 0a 20 20 20 20 20 20  name uuid.      
1c00: 20 42 20 28 2b 7c 2d 29 62 72 61 6e 63 68 2d 74   B (+|-)branch-t
1c10: 61 67 20 75 75 69 64 0a 20 20 20 20 20 20 20 43  ag uuid.       C
1c20: 20 63 6f 6d 6d 65 6e 74 0a 20 20 20 20 20 20 20   comment.       
1c30: 44 20 64 61 74 65 2d 74 69 6d 65 0a 20 20 20 20  D date-time.    
1c40: 20 20 20 45 20 65 64 69 74 65 64 2d 63 6f 6d 6d     E edited-comm
1c50: 65 6e 74 0a 20 20 20 20 20 20 20 46 20 66 69 6c  ent.       F fil
1c60: 65 6e 61 6d 65 20 75 75 69 64 0a 20 20 20 20 20  ename uuid.     
1c70: 20 20 4e 20 6e 61 6d 65 0a 20 20 20 20 20 20 20    N name.       
1c80: 50 20 75 75 69 64 20 2e 2e 2e 0a 20 20 20 20 20  P uuid ....     
1c90: 20 20 52 20 72 65 70 6f 73 69 74 6f 72 79 2d 6d    R repository-m
1ca0: 64 35 73 75 6d 0a 20 20 20 20 20 20 20 54 20 75  d5sum.       T u
1cb0: 75 69 64 0a 20 20 20 20 20 20 20 55 20 75 73 65  uid.       U use
1cc0: 72 2d 6c 6f 67 69 6e 0a 20 20 20 20 20 20 20 56  r-login.       V
1cd0: 20 28 2b 7c 2d 29 76 65 72 73 69 6f 6e 2d 74 61   (+|-)version-ta
1ce0: 67 20 75 75 69 64 0a 20 20 20 20 20 20 20 57 20  g uuid.       W 
1cf0: 75 75 69 64 0a 20 20 20 20 20 20 20 5a 20 6d 61  uuid.       Z ma
1d00: 6e 69 66 65 73 74 2d 63 68 65 63 6b 73 75 6d 0a  nifest-checksum.