Hex Artifact Content
Not logged in

Artifact 084c43a6534289d4045cb657a0aceb3651244e39:

File ideas.txt part of check-in [ba486fec5a] - Add the unclustered table and the M lines to manifests. Process clusters in manifest_parse and manifest_crossref. The xfer process still does not yet use clusters though so it is still compatible. But that is about to change. by drh on 2007-09-03 01:28:57.

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 22 43 6c 75  format:..   "Clu
0300: 73 74 65 72 22 0a 20 20 20 28 55 55 49 44 5c 6e  ster".   (UUID\n
0310: 29 2b 0a 0a 20 20 20 2a 20 43 6c 75 73 74 65 72  )+..   * Cluster
0320: 20 67 65 6e 65 72 61 74 65 64 20 69 6e 20 73 65   generated in se
0330: 72 76 65 72 20 6d 6f 64 65 20 6f 6e 6c 79 2e 0a  rver mode only..
0340: 20 20 20 2a 20 45 6d 62 61 72 67 6f 20 63 6c 75     * Embargo clu
0350: 73 74 65 72 20 74 68 61 74 20 72 65 66 65 72 65  ster that refere
0360: 6e 63 65 20 70 68 61 6e 74 6f 6d 73 20 6f 72 20  nce phantoms or 
0370: 6f 74 68 65 72 20 65 6d 62 61 72 67 6f 65 64 20  other embargoed 
0380: 63 6c 75 73 74 65 72 73 2e 0a 20 20 20 2a 20 4e  clusters..   * N
0390: 65 76 65 72 20 73 65 6e 64 20 6f 72 20 69 68 61  ever send or iha
03a0: 76 65 20 61 6e 20 65 6d 62 61 72 67 6f 65 64 20  ve an embargoed 
03b0: 63 6c 75 73 74 65 72 0a 0a 4e 65 77 20 73 79 6e  cluster..New syn
03c0: 63 20 61 6c 67 6f 72 69 74 68 6d 20 62 61 73 65  c algorithm base
03d0: 64 20 6f 6e 20 63 6c 75 73 74 65 72 73 3a 0a 0a  d on clusters:..
03e0: 20 20 20 2a 20 4b 65 65 70 20 61 20 74 61 62 6c     * Keep a tabl
03f0: 65 20 6f 66 20 75 6e 63 6c 75 73 74 65 72 65 64  e of unclustered
0400: 20 61 72 74 69 66 61 63 74 73 2e 20 20 53 74 72   artifacts.  Str
0410: 69 76 65 20 74 6f 20 6b 65 65 70 20 74 68 69 73  ive to keep this
0420: 20 74 61 62 6c 65 0a 20 20 20 20 20 6c 65 73 73   table.     less
0430: 20 74 68 61 6e 20 31 30 30 20 65 6e 74 72 69 65   than 100 entrie
0440: 73 2e 0a 20 20 20 2a 20 43 6c 69 65 6e 74 20 73  s..   * Client s
0450: 65 6e 64 73 20 63 6f 6e 74 65 6e 74 20 6f 66 20  ends content of 
0460: 75 6e 63 6c 75 73 74 65 72 65 64 20 74 61 62 6c  unclustered tabl
0470: 65 20 61 73 20 69 68 61 76 65 73 20 74 6f 20 73  e as ihaves to s
0480: 65 72 76 65 72 0a 20 20 20 2a 20 53 65 72 76 65  erver.   * Serve
0490: 72 20 62 75 69 6c 64 73 20 61 20 6e 65 77 20 63  r builds a new c
04a0: 6c 75 73 74 65 72 20 69 66 20 73 69 7a 65 20 6f  luster if size o
04b0: 66 20 63 6c 75 73 74 65 72 20 74 61 62 6c 65 20  f cluster table 
04c0: 3e 31 30 30 2e 0a 20 20 20 2a 20 53 65 72 76 65  >100..   * Serve
04d0: 72 20 73 65 6e 64 73 20 75 6e 63 6c 75 73 74 65  r sends uncluste
04e0: 72 65 64 20 74 61 62 6c 65 20 74 6f 20 63 6c 69  red table to cli
04f0: 65 6e 74 0a 20 20 20 2a 20 53 65 72 76 65 72 20  ent.   * Server 
0500: 73 65 6e 64 73 20 67 69 6d 6d 65 20 66 6f 72 20  sends gimme for 
0510: 61 6c 6c 20 75 6e 6b 6e 6f 77 6e 20 69 68 61 76  all unknown ihav
0520: 65 20 72 65 63 65 69 76 65 64 20 66 72 6f 6d 20  e received from 
0530: 63 6c 69 65 6e 74 0a 20 20 20 2a 20 43 6c 69 65  client.   * Clie
0540: 6e 74 20 73 65 6e 64 73 20 67 69 6d 6d 65 20 66  nt sends gimme f
0550: 6f 72 20 61 6c 6c 20 75 6e 6b 6e 6f 77 6e 20 69  or all unknown i
0560: 68 61 76 65 20 72 65 63 65 69 76 65 64 20 66 72  have received fr
0570: 6f 6d 20 73 65 72 76 65 72 0a 20 20 20 2a 20 50  om server.   * P
0580: 72 65 76 69 6f 75 73 20 74 77 6f 20 73 74 65 70  revious two step
0590: 73 20 72 65 70 65 61 74 20 75 6e 74 69 6c 20 6e  s repeat until n
05a0: 6f 20 6d 6f 72 65 20 67 69 6d 6d 65 73 0a 0a 44  o more gimmes..D
05b0: 65 74 61 69 6c 73 20 6f 66 20 6e 65 77 20 70 75  etails of new pu
05c0: 73 68 20 61 6c 67 6f 72 69 74 68 6d 3a 0a 0a 20  sh algorithm:.. 
05d0: 20 20 2a 20 54 61 62 6c 65 20 22 75 6e 73 65 6e    * Table "unsen
05e0: 74 22 20 63 6f 6e 74 61 69 6e 73 20 61 6c 6c 20  t" contains all 
05f0: 66 69 6c 65 73 20 6e 65 76 65 72 20 70 75 73 68  files never push
0600: 65 64 0a 20 20 20 2a 20 54 45 4d 50 20 74 61 62  ed.   * TEMP tab
0610: 6c 65 20 22 77 61 6e 74 65 64 22 20 63 6f 6e 74  le "wanted" cont
0620: 61 69 6e 73 20 66 69 6c 65 73 20 74 68 65 20 73  ains files the s
0630: 65 72 76 65 72 20 64 6f 65 73 20 6e 6f 74 20 68  erver does not h
0640: 61 76 65 0a 20 20 20 4c 6f 6f 70 3a 0a 20 20 20  ave.   Loop:.   
0650: 20 20 2a 20 43 6c 69 65 6e 74 20 73 65 6e 64 73    * Client sends
0660: 20 6c 6f 67 69 6e 20 61 6e 64 20 22 70 75 73 68   login and "push
0670: 22 20 72 65 63 6f 72 64 0a 20 20 20 20 20 2a 20  " record.     * 
0680: 43 6c 69 65 6e 74 20 73 65 6e 64 73 20 66 69 6c  Client sends fil
0690: 65 20 6d 65 73 73 61 67 65 20 66 6f 72 20 61 6c  e message for al
06a0: 6c 20 66 69 6c 65 73 20 69 6e 20 75 6e 73 65 6e  l files in unsen
06b0: 74 20 61 6e 64 20 72 65 6d 6f 76 65 73 0a 20 20  t and removes.  
06c0: 20 20 20 20 20 74 68 6f 73 65 20 66 69 6c 65 73       those files
06d0: 20 66 72 6f 6d 20 74 68 65 20 74 61 62 6c 65 2e   from the table.
06e0: 0a 20 20 20 20 20 2a 20 43 6c 69 65 6e 74 20 73  .     * Client s
06f0: 65 6e 64 73 20 66 69 6c 65 20 6d 65 73 73 61 67  ends file messag
0700: 65 20 66 6f 72 20 61 6c 6c 20 66 69 6c 65 73 20  e for all files 
0710: 69 6e 20 77 61 6e 74 65 64 2e 0a 20 20 20 20 20  in wanted..     
0720: 2a 20 43 6c 69 65 6e 74 20 73 65 6e 64 73 20 69  * Client sends i
0730: 68 61 76 65 20 6d 65 73 73 61 67 65 73 20 66 6f  have messages fo
0740: 72 20 65 61 63 68 20 65 6e 74 72 79 20 69 6e 20  r each entry in 
0750: 75 6e 63 6c 75 73 74 65 72 65 64 0a 20 20 20 20  unclustered.    
0760: 20 2d 2d 2d 2d 2d 2d 0a 20 20 20 20 20 2a 20 53   ------.     * S
0770: 65 72 76 65 72 20 72 65 63 65 69 76 65 73 20 66  erver receives f
0780: 69 6c 65 20 6d 65 73 73 61 67 65 0a 20 20 20 20  ile message.    
0790: 20 2a 20 53 65 72 76 65 72 20 63 72 65 61 74 65   * Server create
07a0: 73 20 70 68 61 6e 74 6f 6d 73 20 66 6f 72 20 75  s phantoms for u
07b0: 6e 6b 6e 6f 77 6e 20 69 68 61 76 65 73 0a 20 20  nknown ihaves.  
07c0: 20 20 20 2a 20 53 65 72 76 65 72 20 73 65 6e 64     * Server send
07d0: 73 20 67 69 6d 6d 65 20 6d 65 73 73 61 67 65 73  s gimme messages
07e0: 20 66 6f 72 20 61 6c 6c 20 70 68 61 6e 74 6f 6d   for all phantom
07f0: 73 0a 20 20 20 20 20 2d 2d 2d 2d 2d 2d 0a 20 20  s.     ------.  
0800: 20 20 20 2a 20 46 6f 72 20 65 61 63 68 20 67 69     * For each gi
0810: 6d 6d 65 20 6d 65 73 73 61 67 65 20 61 64 64 20  mme message add 
0820: 61 6e 20 65 6e 74 72 79 20 74 6f 20 77 61 6e 74  an entry to want
0830: 65 64 0a 20 20 20 20 20 2a 20 48 61 6c 74 20 69  ed.     * Halt i
0840: 66 20 74 68 65 20 77 61 6e 74 65 64 20 74 61 62  f the wanted tab
0850: 6c 65 20 69 73 20 65 6d 70 74 79 0a 0a 44 65 74  le is empty..Det
0860: 61 69 6c 73 20 6f 6e 20 6e 65 77 20 70 75 6c 6c  ails on new pull
0870: 20 61 6c 67 6f 72 69 74 68 6d 3a 0a 0a 20 20 20   algorithm:..   
0880: 4c 6f 6f 70 3a 0a 20 20 20 20 20 2a 20 43 6c 69  Loop:.     * Cli
0890: 65 6e 74 20 73 65 6e 64 73 20 6c 6f 67 69 6e 20  ent sends login 
08a0: 61 6e 64 20 22 70 75 6c 6c 22 20 72 65 63 6f 72  and "pull" recor
08b0: 64 0a 20 20 20 20 20 2a 20 43 6c 69 65 6e 74 20  d.     * Client 
08c0: 73 65 6e 64 73 20 22 70 72 69 6f 72 22 20 6d 65  sends "prior" me
08d0: 73 73 61 67 65 20 77 69 74 68 20 72 65 70 6f 73  ssage with repos
08e0: 69 74 6f 72 79 20 69 64 20 61 6e 64 20 6d 61 78  itory id and max
08f0: 20 72 65 63 6f 72 64 20 6e 75 6d 62 65 72 0a 20   record number. 
0900: 20 20 20 20 2a 20 43 6c 69 65 6e 74 20 73 65 6e      * Client sen
0910: 64 73 20 22 67 69 6d 6d 65 22 20 66 6f 72 20 65  ds "gimme" for e
0920: 61 63 68 20 70 68 61 6e 74 6f 6d 0a 20 20 20 20  ach phantom.    
0930: 20 2d 2d 2d 2d 2d 2d 2d 2d 0a 20 20 20 20 20 2a   --------.     *
0940: 20 53 65 72 76 65 72 20 63 72 65 61 74 65 73 20   Server creates 
0950: 6e 65 77 20 63 6c 75 73 74 65 72 73 20 74 6f 20  new clusters to 
0960: 67 65 74 20 75 6e 63 6c 75 73 74 65 72 65 64 20  get unclustered 
0970: 73 69 7a 65 20 62 65 6c 6f 77 20 31 30 30 0a 20  size below 100. 
0980: 20 20 20 20 2a 20 49 66 20 74 68 65 72 65 20 69      * If there i
0990: 73 20 22 70 72 69 6f 72 22 20 6d 65 73 73 61 67  s "prior" messag
09a0: 65 20 77 69 74 68 20 72 65 70 6f 73 69 74 6f 72  e with repositor
09b0: 79 20 69 64 20 74 68 61 74 20 6d 61 74 63 68 65  y id that matche
09c0: 73 20 74 68 69 73 0a 20 20 20 20 20 20 20 73 65  s this.       se
09d0: 72 76 65 72 2c 20 74 68 65 6e 20 73 65 6e 64 20  rver, then send 
09e0: 66 69 6c 65 20 6d 65 73 73 61 67 65 73 20 66 6f  file messages fo
09f0: 72 20 61 6c 6c 20 72 65 63 6f 72 64 20 69 64 73  r all record ids
0a00: 20 67 72 65 61 74 65 72 20 74 68 61 6e 0a 20 20   greater than.  
0a10: 20 20 20 20 20 70 72 69 6f 72 0a 20 20 20 20 20       prior.     
0a20: 2a 20 53 65 72 76 65 72 20 73 65 6e 64 73 20 69  * Server sends i
0a30: 68 61 76 65 20 6d 65 73 73 61 67 65 73 20 66 6f  have messages fo
0a40: 72 20 65 61 63 68 20 65 6e 74 72 79 20 69 6e 20  r each entry in 
0a50: 75 6e 63 6c 75 73 74 65 72 65 64 0a 20 20 20 20  unclustered.    
0a60: 20 2a 20 53 65 72 76 65 72 20 73 65 6e 64 73 20   * Server sends 
0a70: 6d 61 78 72 69 64 20 6d 65 73 73 61 67 65 0a 20  maxrid message. 
0a80: 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 0a 20 20 20      --------.   
0a90: 20 20 2a 20 43 6c 69 65 6e 74 20 72 65 63 65 69    * Client recei
0aa0: 76 65 73 20 66 69 6c 65 20 72 65 63 6f 72 64 73  ves file records
0ab0: 0a 20 20 20 20 20 2a 20 43 6c 69 65 6e 74 20 63  .     * Client c
0ac0: 72 65 61 74 65 73 20 70 68 61 6e 74 6f 6d 73 20  reates phantoms 
0ad0: 66 6f 72 20 75 6e 6b 6e 6f 77 6e 20 69 68 61 76  for unknown ihav
0ae0: 65 73 0a 20 20 20 20 20 2a 20 49 66 20 6e 6f 20  es.     * If no 
0af0: 70 68 61 6e 74 6f 6d 73 20 65 78 69 73 74 2c 20  phantoms exist, 
0b00: 72 65 63 6f 72 64 20 6d 61 78 72 69 64 20 66 6f  record maxrid fo
0b10: 72 20 74 68 65 20 73 65 72 76 65 72 20 61 6e 64  r the server and
0b20: 20 68 61 6c 74 0a 0a 4e 65 65 64 20 61 20 64 65   halt..Need a de
0b30: 70 68 61 6e 74 6f 6d 69 7a 65 20 61 6c 67 6f 72  phantomize algor
0b40: 69 74 68 6d 0a 0a 0a 41 75 78 69 6c 69 61 72 79  ithm...Auxiliary
0b50: 20 74 61 62 6c 65 73 20 6e 65 65 64 65 64 20 66   tables needed f
0b60: 6f 72 20 6e 65 77 20 73 79 6e 63 20 61 6c 67 6f  or new sync algo
0b70: 72 69 74 68 6d 3a 0a 0a 20 20 20 2a 20 75 6e 73  rithm:..   * uns
0b80: 65 6e 74 3a 20 20 66 69 6c 65 73 20 74 68 61 74  ent:  files that
0b90: 20 68 61 76 65 20 6e 65 76 65 72 20 62 65 65 6e   have never been
0ba0: 20 73 65 6e 74 20 74 6f 20 61 6e 6f 74 68 65 72   sent to another
0bb0: 20 72 65 70 6f 73 69 74 6f 72 79 0a 20 20 20 2a   repository.   *
0bc0: 20 75 6e 63 6c 75 73 74 65 72 65 64 3a 20 6e 6f   unclustered: no
0bd0: 6e 2d 70 68 61 6e 74 6f 6d 20 66 69 6c 65 73 20  n-phantom files 
0be0: 6e 6f 74 20 6d 65 6e 74 69 6f 6e 65 64 20 62 79  not mentioned by
0bf0: 20 61 20 63 6c 75 73 74 65 72 0a 0a 52 61 6e 64   a cluster..Rand
0c00: 6f 6d 20 74 68 6f 75 67 68 74 73 3a 0a 0a 20 20  om thoughts:..  
0c10: 2a 20 20 43 68 61 6e 67 65 73 20 74 6f 20 6d 61  *  Changes to ma
0c20: 6e 69 66 65 73 74 20 74 6f 20 73 75 70 70 6f 72  nifest to suppor
0c30: 74 3a 0a 20 20 20 20 20 2b 20 20 54 72 65 65 73  t:.     +  Trees
0c40: 20 6f 66 20 77 69 6b 69 20 70 61 67 65 73 20 61   of wiki pages a
0c50: 6e 64 20 74 69 63 6b 65 74 73 0a 20 20 20 20 20  nd tickets.     
0c60: 2b 20 20 54 68 65 20 61 62 69 6c 69 74 79 20 74  +  The ability t
0c70: 6f 20 63 61 70 20 6f 72 20 63 6c 6f 73 65 20 61  o cap or close a
0c80: 20 62 72 61 6e 63 68 0a 20 20 20 20 20 2b 20 20   branch.     +  
0c90: 53 65 65 20 22 45 78 74 65 6e 64 65 64 20 4d 61  See "Extended Ma
0ca0: 6e 69 66 65 73 74 73 22 20 62 65 6c 6f 77 0a 0a  nifests" below..
0cb0: 20 20 2a 20 20 41 64 64 20 74 68 65 20 63 6f 6e    *  Add the con
0cc0: 63 65 70 74 20 6f 66 20 22 63 6c 75 73 74 65 72  cept of "cluster
0cd0: 73 22 20 74 6f 20 73 70 65 65 64 20 74 68 65 20  s" to speed the 
0ce0: 74 72 61 6e 73 66 65 72 20 6f 66 20 22 74 69 70  transfer of "tip
0cf0: 73 22 0a 20 20 20 20 20 6f 6e 20 61 20 73 79 6e  s".     on a syn
0d00: 63 2e 0a 0a 20 20 2a 20 20 41 75 78 69 6c 69 61  c...  *  Auxilia
0d10: 72 79 20 74 61 62 6c 65 73 3a 0a 20 20 20 20 20  ry tables:.     
0d20: 2b 20 20 74 69 70 0a 20 20 20 20 20 2b 20 20 70  +  tip.     +  p
0d30: 68 61 6e 74 6f 6d 0a 20 20 20 20 20 2b 20 20 6d  hantom.     +  m
0d40: 6c 69 6e 6b 0a 20 20 20 20 20 2b 20 20 70 6c 69  link.     +  pli
0d50: 6e 6b 0a 20 20 20 20 20 2b 20 20 62 72 61 6e 63  nk.     +  branc
0d60: 68 0a 20 20 20 20 20 2b 20 20 74 72 65 65 0a 0a  h.     +  tree..
0d70: 20 20 2a 20 50 6c 69 6e 6b 2e 69 73 70 72 69 6d    * Plink.isprim
0d80: 20 63 68 61 6e 67 65 64 20 74 6f 20 72 65 63 6f   changed to reco
0d90: 72 64 3a 0a 20 20 20 20 20 2b 20 20 63 68 69 6c  rd:.     +  chil
0da0: 64 20 69 73 20 74 68 65 20 70 72 69 6e 63 69 70  d is the princip
0db0: 61 6c 20 64 65 73 63 65 6e 64 65 6e 74 20 6f 66  al descendent of
0dc0: 20 70 61 72 65 6e 74 2e 20 28 31 29 0a 20 20 20   parent. (1).   
0dd0: 20 20 2b 20 20 63 68 69 6c 64 20 69 73 20 61 20    +  child is a 
0de0: 62 72 61 6e 63 68 20 66 72 6f 6d 20 70 61 72 65  branch from pare
0df0: 6e 74 20 28 32 29 0a 20 20 20 20 20 2b 20 20 63  nt (2).     +  c
0e00: 68 69 6c 64 20 75 73 65 73 20 70 61 72 65 6e 74  hild uses parent
0e10: 20 61 73 20 61 20 6d 65 72 67 65 20 28 30 29 0a   as a merge (0).
0e20: 0a 20 20 2a 20 74 72 65 65 20 72 65 63 6f 72 64  .  * tree record
0e30: 73 0a 20 20 20 20 20 2b 20 74 79 70 65 20 20 28  s.     + type  (
0e40: 63 6f 64 65 2c 20 77 69 6b 69 2c 20 74 69 63 6b  code, wiki, tick
0e50: 65 74 29 0a 20 20 20 20 20 2b 20 6e 61 6d 65 20  et).     + name 
0e60: 20 28 66 6f 72 20 77 69 6b 69 20 61 6e 64 20 74   (for wiki and t
0e70: 69 63 6b 65 74 20 6f 6e 6c 79 29 0a 20 20 20 20  icket only).    
0e80: 20 2b 20 74 72 65 65 69 64 0a 0a 20 20 2a 20 62   + treeid..  * b
0e90: 72 61 6e 63 68 20 72 65 63 6f 72 64 73 0a 20 20  ranch records.  
0ea0: 20 20 20 2b 20 74 72 65 65 69 64 0a 20 20 20 20     + treeid.    
0eb0: 20 2b 20 6f 72 69 67 69 6e 5f 72 69 64 0a 20 20   + origin_rid.  
0ec0: 20 20 20 2b 20 6f 72 69 67 69 6e 5f 74 69 6d 65     + origin_time
0ed0: 0a 20 20 20 20 20 2b 20 74 69 70 5f 72 69 64 0a  .     + tip_rid.
0ee0: 20 20 20 20 20 2b 20 74 69 70 5f 74 69 6d 65 0a       + tip_time.
0ef0: 20 20 20 20 20 2b 20 63 6f 6c 6f 72 0a 0a 20 20       + color..  
0f00: 2a 20 77 65 62 73 69 74 65 20 63 61 6e 20 74 6f  * website can to
0f10: 67 67 6c 65 20 69 73 70 72 69 6d 20 62 65 74 77  ggle isprim betw
0f20: 65 65 6e 20 70 72 69 6e 63 69 70 61 6c 20 61 6e  een principal an
0f30: 64 20 62 72 61 6e 63 68 2e 0a 20 20 20 20 20 2b  d branch..     +
0f40: 20 48 6f 77 20 74 6f 20 70 72 65 73 65 72 76 65   How to preserve
0f50: 20 61 63 72 6f 73 73 20 72 65 62 75 69 6c 64 2e   across rebuild.
0f60: 20 20 41 20 6e 65 77 20 72 65 63 6f 72 64 20 74    A new record t
0f70: 79 70 65 3f 0a 20 20 20 20 20 2b 20 48 6f 77 20  ype?.     + How 
0f80: 74 6f 20 73 68 61 72 65 20 77 69 74 68 20 6f 74  to share with ot
0f90: 68 65 72 20 72 65 70 6f 73 69 74 6f 72 69 65 73  her repositories
0fa0: 0a 20 20 2a 20 69 73 70 72 69 6d 20 67 75 65 73  .  * isprim gues
0fb0: 73 65 64 20 75 73 69 6e 67 20 75 73 65 72 69 64  sed using userid
0fc0: 20 6f 66 20 70 61 72 65 6e 74 20 61 6e 64 20 63   of parent and c
0fd0: 68 69 6c 64 2e 20 20 43 68 61 6e 67 65 0a 20 20  hild.  Change.  
0fe0: 20 20 69 6e 20 69 64 20 73 75 67 67 65 73 74 73    in id suggests
0ff0: 20 61 20 62 72 61 6e 63 68 2e 20 20 53 61 6d 65   a branch.  Same
1000: 20 69 64 20 73 75 67 67 65 73 74 73 20 70 72 69   id suggests pri
1010: 6e 63 69 70 61 6c 2e 0a 20 20 20 20 46 6f 72 20  ncipal..    For 
1020: 61 20 74 69 65 2c 20 67 6f 20 77 69 74 68 20 74  a tie, go with t
1030: 68 65 20 65 61 72 6c 69 65 73 74 20 63 68 65 63  he earliest chec
1040: 6b 2d 69 6e 20 61 73 20 74 68 65 20 70 72 69 6e  k-in as the prin
1050: 63 69 70 61 6c 27 0a 0a 20 20 2a 20 41 75 74 6f  cipal'..  * Auto
1060: 73 79 6e 63 20 6d 6f 64 65 0a 20 20 20 20 20 2b  sync mode.     +
1070: 20 53 65 74 20 61 20 70 72 65 66 65 72 72 65 64   Set a preferred
1080: 20 72 65 6d 6f 74 65 20 72 65 70 6f 73 69 74 6f   remote reposito
1090: 72 79 20 74 6f 20 75 73 65 20 61 73 20 61 20 73  ry to use as a s
10a0: 65 72 76 65 72 0a 20 20 20 20 20 20 20 20 3d 20  erver.        = 
10b0: 20 43 6c 6f 6e 65 20 72 65 70 6f 73 69 74 6f 72   Clone repositor
10c0: 79 20 69 73 20 74 68 65 20 64 65 66 61 75 6c 74  y is the default
10d0: 0a 20 20 20 20 20 2b 20 4f 6e 20 63 6f 6d 6d 69  .     + On commi
10e0: 74 2c 20 66 69 72 73 74 20 70 75 6c 6c 2e 20 20  t, first pull.  
10f0: 49 66 20 63 6f 6d 6d 69 74 20 62 61 73 65 6c 69  If commit baseli
1100: 6e 65 20 69 73 20 6e 6f 74 20 61 20 74 69 70 0a  ne is not a tip.
1110: 20 20 20 20 20 20 20 70 72 6f 6d 70 74 20 75 73         prompt us
1120: 65 72 20 74 6f 20 63 61 6e 63 65 6c 20 6f 72 20  er to cancel or 
1130: 62 72 61 6e 63 68 2e 20 20 44 65 66 61 75 6c 74  branch.  Default
1140: 20 69 73 20 63 61 6e 63 65 6c 2e 0a 20 20 20 20   is cancel..    
1150: 20 2b 20 50 75 73 68 20 61 66 74 65 72 20 63 6f   + Push after co
1160: 6d 6d 69 74 0a 20 20 20 20 20 2b 20 41 75 74 6f  mmit.     + Auto
1170: 6d 61 74 69 63 61 6c 6c 79 20 70 75 6c 6c 20 70  matically pull p
1180: 72 69 6f 72 20 74 6f 20 75 70 64 61 74 65 2e 0a  rior to update..
1190: 20 20 20 20 20 2b 20 4e 65 65 64 20 61 6e 20 22       + Need an "
11a0: 75 6e 64 6f 22 20 63 61 70 61 62 69 6c 69 74 79  undo" capability
11b0: 0a 20 20 20 20 20 2b 20 44 65 73 69 67 6e 65 64  .     + Designed
11c0: 20 74 6f 20 61 76 6f 69 64 20 62 72 61 6e 63 68   to avoid branch
11d0: 69 6e 67 20 69 6e 20 68 69 67 68 6c 79 20 63 6f  ing in highly co
11e0: 6c 6c 61 62 6f 72 61 74 69 76 65 20 0a 20 20 20  llaborative .   
11f0: 20 20 20 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 73      environments
1200: 2e 0a 0a 20 20 2a 20 41 72 63 68 65 6f 6c 6f 67  ...  * Archeolog
1210: 69 63 61 6c 20 77 65 62 70 61 67 65 20 69 6d 70  ical webpage imp
1220: 72 6f 76 65 6d 65 6e 74 73 3a 0a 20 20 20 20 20  rovements:.     
1230: 2b 20 55 73 65 20 61 20 73 6d 61 6c 6c 20 61 6d  + Use a small am
1240: 6f 75 6e 74 20 6f 66 20 43 53 53 2b 6a 61 76 61  ount of CSS+java
1250: 73 63 72 69 70 74 20 6f 6e 20 74 69 6d 65 6c 69  script on timeli
1260: 6e 65 73 20 73 6f 20 74 68 61 74 0a 20 20 20 20  nes so that.    
1270: 20 20 20 62 72 61 6e 63 68 69 6e 67 20 73 74 72     branching str
1280: 75 63 74 75 72 65 20 69 73 20 64 69 73 70 6c 61  ucture is displa
1290: 79 65 64 20 6f 6e 20 6d 6f 75 73 65 6f 76 65 72  yed on mouseover
12a0: 2e 20 20 4f 6e 20 6d 6f 75 73 65 6f 76 65 72 0a  .  On mouseover.
12b0: 20 20 20 20 20 20 20 6f 66 20 61 20 63 68 65 63         of a chec
12c0: 6b 69 6e 2c 20 68 69 67 68 6c 69 67 68 74 20 6f  kin, highlight o
12d0: 74 68 65 72 20 63 68 65 63 6b 69 6e 73 20 74 68  ther checkins th
12e0: 61 74 20 61 72 65 20 64 69 72 65 63 74 20 28 6e  at are direct (n
12f0: 6f 6e 2d 6d 65 72 67 65 29 0a 20 20 20 20 20 20  on-merge).      
1300: 20 64 65 73 63 65 6e 64 65 6e 74 73 20 61 6e 64   descendents and
1310: 20 61 6e 63 65 73 74 6f 72 73 20 6f 66 20 74 68   ancestors of th
1320: 65 20 6d 6f 75 73 65 6f 76 65 72 20 63 68 65 63  e mouseover chec
1330: 6b 69 6e 2e 0a 20 20 20 20 20 2b 20 54 69 6d 65  kin..     + Time
1340: 6c 69 6e 65 20 73 68 6f 77 69 6e 67 20 69 6e 64  line showing ind
1350: 69 76 69 64 75 61 6c 20 62 72 61 6e 63 68 65 73  ividual branches
1360: 0a 20 20 20 20 20 2b 20 54 69 6d 65 6c 69 6e 65  .     + Timeline
1370: 20 73 68 6f 77 73 20 66 6f 72 6b 73 20 61 6e 64   shows forks and
1380: 20 6d 65 72 67 65 73 0a 20 20 20 20 20 2b 20 54   merges.     + T
1390: 61 67 73 20 73 68 6f 77 6e 20 6f 6e 20 74 69 6d  ags shown on tim
13a0: 65 6c 69 6e 65 20 28 6d 61 79 62 65 29 20 61 6e  eline (maybe) an
13b0: 64 20 69 6e 20 76 69 6e 66 6f 20 28 73 75 72 65  d in vinfo (sure
13c0: 6c 79 29 2e 0a 0a 46 65 61 74 75 72 65 73 20 6e  ly)...Features n
13d0: 65 65 64 65 64 3a 0a 20 20 2a 20 4d 65 61 6e 73  eeded:.  * Means
13e0: 20 74 6f 20 73 75 70 70 72 65 73 73 20 61 72 74   to suppress art
13f0: 69 66 61 63 74 73 0a 20 20 2a 20 4d 65 61 6e 73  ifacts.  * Means
1400: 20 74 6f 20 63 61 70 20 61 20 62 72 61 6e 63 68   to cap a branch
1410: 0a 20 20 2a 20 54 69 63 6b 65 74 69 6e 67 0a 20  .  * Ticketing. 
1420: 20 20 20 20 2b 20 20 50 72 6f 62 6c 65 6d 20 69      +  Problem i
1430: 73 2f 69 73 2d 6e 6f 74 20 65 78 70 72 65 73 73  s/is-not express
1440: 65 64 20 69 6e 20 62 61 73 65 6c 69 6e 65 20 58  ed in baseline X
1450: 2e 0a 20 20 20 20 20 2b 20 20 41 70 70 65 6e 64  ..     +  Append
1460: 20 63 6f 6d 6d 65 6e 74 20 61 6e 64 20 7a 65 72   comment and zer
1470: 6f 20 6f 72 20 6d 6f 72 65 20 61 74 74 61 63 68  o or more attach
1480: 6d 65 6e 74 73 0a 20 20 2a 20 4d 6f 64 69 66 79  ments.  * Modify
1490: 20 63 6f 6d 6d 65 6e 74 73 20 6f 6e 20 62 61 73   comments on bas
14a0: 65 6c 69 6e 65 73 0a 20 20 2a 20 41 70 70 65 6e  elines.  * Appen
14b0: 64 20 63 6f 6d 6d 65 6e 74 73 20 74 6f 20 61 6e  d comments to an
14c0: 79 20 61 72 74 69 66 61 63 74 0a 20 20 2a 20 57  y artifact.  * W
14d0: 69 6b 69 3f 0a 0a 20 20 0a 0a 45 78 74 65 6e 64  iki?..  ..Extend
14e0: 65 64 20 6d 61 6e 69 66 65 73 74 73 2e 0a 20 20  ed manifests..  
14f0: 2a 20 6e 6f 72 6d 61 6c 20 6d 61 6e 69 66 65 73  * normal manifes
1500: 74 20 68 61 73 3a 0a 20 20 20 20 20 20 20 43 20  t has:.       C 
1510: 63 6f 6d 6d 65 6e 74 0a 20 20 20 20 20 20 20 44  comment.       D
1520: 20 64 61 74 65 2d 74 69 6d 65 0a 20 20 20 20 20   date-time.     
1530: 20 20 46 2a 20 66 69 6c 65 6e 61 6d 65 20 75 75    F* filename uu
1540: 69 64 0a 20 20 20 20 20 20 20 50 20 75 75 69 64  id.       P uuid
1550: 20 2e 2e 2e 20 20 20 20 20 20 20 20 20 20 20 2d   ...           -
1560: 2d 20 6f 6d 69 74 74 65 64 20 66 6f 72 20 66 69  - omitted for fi
1570: 72 73 74 20 6d 61 6e 69 66 65 73 74 0a 20 20 20  rst manifest.   
1580: 20 20 20 20 52 20 72 65 70 6f 73 69 74 6f 72 79      R repository
1590: 2d 6d 64 35 73 75 6d 0a 20 20 20 20 20 20 20 55  -md5sum.       U
15a0: 20 75 73 65 72 2d 6c 6f 67 69 6e 0a 20 20 20 20   user-login.    
15b0: 20 20 20 5a 20 6d 61 6e 69 66 65 73 74 2d 63 68     Z manifest-ch
15c0: 65 63 6b 73 75 6d 0a 0a 20 20 2a 20 41 63 63 65  ecksum..  * Acce
15d0: 73 73 6f 72 79 3a 0a 20 20 20 20 20 20 20 41 20  ssory:.       A 
15e0: 75 75 69 64 7c 2a 20 61 74 74 61 63 68 6d 65 6e  uuid|* attachmen
15f0: 74 2d 75 75 69 64 20 64 65 73 63 72 69 70 74 69  t-uuid descripti
1600: 6f 6e 0a 20 20 20 20 20 20 20 42 20 28 2b 7c 2d  on.       B (+|-
1610: 29 62 72 61 6e 63 68 74 61 67 20 75 75 69 64 0a  )branchtag uuid.
1620: 20 20 20 20 20 20 20 44 20 64 61 74 65 2d 74 69         D date-ti
1630: 6d 65 0a 20 20 20 20 20 20 20 45 20 75 75 69 64  me.       E uuid
1640: 20 6e 65 77 2d 63 6f 6d 6d 65 6e 74 0a 20 20 20   new-comment.   
1650: 20 20 20 20 47 20 75 75 69 64 20 61 70 70 65 6e      G uuid appen
1660: 64 65 64 2d 72 65 6d 61 72 6b 0a 20 20 20 20 20  ded-remark.     
1670: 20 20 53 20 72 65 70 6f 73 69 74 6f 72 79 69 64    S repositoryid
1680: 20 73 65 72 69 61 6c 2d 6e 75 6d 62 65 72 0a 20   serial-number. 
1690: 20 20 20 20 20 20 55 20 75 73 65 72 69 64 0a 20        U userid. 
16a0: 20 20 20 20 20 20 56 20 28 2b 7c 2d 29 76 65 72        V (+|-)ver
16b0: 73 69 6f 6e 74 61 67 20 75 75 69 64 0a 20 20 20  siontag uuid.   
16c0: 20 20 20 20 58 20 75 75 69 64 2d 74 6f 2d 73 75      X uuid-to-su
16d0: 72 70 72 65 73 73 0a 20 20 20 20 20 20 20 5a 20  rpress.       Z 
16e0: 74 68 69 73 2d 66 69 6c 65 2d 63 68 65 63 6b 73  this-file-checks
16f0: 75 6d 0a 0a 20 20 2a 20 43 68 61 6e 67 65 20 74  um..  * Change t
1700: 68 65 20 63 6f 6d 6d 65 6e 74 20 6f 6e 20 61 20  he comment on a 
1710: 76 65 72 73 69 6f 6e 3a 20 20 20 2d 2d 20 61 6c  version:   -- al
1720: 77 61 79 73 20 61 20 6c 65 61 66 20 65 78 63 65  ways a leaf exce
1730: 70 74 20 69 6e 20 63 6c 75 73 74 65 72 0a 20 20  pt in cluster.  
1740: 20 20 20 20 20 44 20 64 61 74 65 2d 74 69 6d 65       D date-time
1750: 0a 20 20 20 20 20 20 20 45 20 6e 65 77 2d 63 6f  .       E new-co
1760: 6d 6d 65 6e 74 0a 20 20 20 20 20 20 20 50 20 75  mment.       P u
1770: 75 69 64 20 20 20 20 20 20 20 20 20 20 20 20 20  uid             
1780: 20 2d 2d 20 62 61 73 65 6c 69 6e 65 20 77 68 6f   -- baseline who
1790: 73 65 20 63 6f 6d 6d 65 6e 74 20 69 73 20 63 68  se comment is ch
17a0: 61 6e 67 65 64 0a 20 20 20 20 20 20 20 55 20 75  anged.       U u
17b0: 73 65 72 2d 6c 6f 67 69 6e 0a 20 20 20 20 20 20  ser-login.      
17c0: 20 5a 20 63 68 65 63 6b 73 75 6d 0a 20 20 20 20   Z checksum.    
17d0: 20 20 20 2d 2d 20 6d 6f 73 74 20 72 65 63 65 6e     -- most recen
17e0: 74 20 77 69 6e 73 0a 20 20 2a 20 57 69 6b 69 20  t wins.  * Wiki 
17f0: 65 64 69 74 0a 20 20 20 20 20 20 20 41 2a 20 6e  edit.       A* n
1800: 61 6d 65 20 75 75 69 64 20 20 20 2d 2d 20 7a 65  ame uuid   -- ze
1810: 72 6f 20 6f 72 20 6d 6f 72 65 20 61 74 74 61 63  ro or more attac
1820: 68 6d 65 6e 74 73 0a 20 20 20 20 20 20 20 43 3f  hments.       C?
1830: 20 63 6f 6d 6d 65 6e 74 0a 20 20 20 20 20 20 20   comment.       
1840: 44 20 64 61 74 65 2d 74 69 6d 65 0a 20 20 20 20  D date-time.    
1850: 20 20 20 4e 20 6e 61 6d 65 20 20 20 20 20 20 20     N name       
1860: 20 20 2d 2d 20 6e 61 6d 65 20 6f 66 20 74 68 65    -- name of the
1870: 20 77 69 6b 69 20 70 61 67 65 0a 20 20 20 20 20   wiki page.     
1880: 20 20 50 20 75 75 69 64 20 2e 2e 2e 20 20 20 20    P uuid ...    
1890: 20 2d 2d 20 6f 6d 69 74 20 66 6f 72 20 6e 65 77   -- omit for new
18a0: 20 77 69 6b 69 0a 20 20 20 20 20 20 20 55 20 75   wiki.       U u
18b0: 73 65 72 2d 6c 6f 67 69 6e 0a 20 20 20 20 20 20  ser-login.      
18c0: 20 57 20 75 75 69 64 20 20 20 20 20 20 20 20 20   W uuid         
18d0: 2d 2d 20 54 68 65 20 63 6f 6e 74 65 6e 74 20 66  -- The content f
18e0: 69 6c 65 0a 20 20 20 20 20 20 20 5a 20 6d 61 6e  ile.       Z man
18f0: 69 66 65 73 74 2d 63 6b 73 75 6d 0a 20 20 2a 20  ifest-cksum.  * 
1900: 54 69 63 6b 65 74 20 65 64 69 74 0a 20 20 20 20  Ticket edit.    
1910: 20 20 20 41 2a 20 6e 61 6d 65 20 75 75 69 64 20     A* name uuid 
1920: 20 20 2d 2d 20 7a 65 72 6f 20 6f 72 20 6d 6f 72    -- zero or mor
1930: 65 20 61 74 74 61 63 68 6d 65 6e 74 73 0a 20 20  e attachments.  
1940: 20 20 20 20 20 44 20 64 61 74 65 2d 74 69 6d 65       D date-time
1950: 0a 20 20 20 20 20 20 20 4e 20 6e 61 6d 65 20 20  .       N name  
1960: 20 20 20 20 20 20 20 2d 2d 20 6e 61 6d 65 20 6f         -- name o
1970: 66 20 74 68 65 20 74 69 63 6b 65 74 0a 20 20 20  f the ticket.   
1980: 20 20 20 20 50 20 75 75 69 64 20 20 20 20 20 20      P uuid      
1990: 20 20 20 2d 2d 20 6f 6d 69 74 20 66 6f 72 20 6e     -- omit for n
19a0: 65 77 20 74 69 63 6b 65 74 0a 20 20 20 20 20 20  ew ticket.      
19b0: 20 54 20 75 75 69 64 20 20 20 20 20 20 20 20 20   T uuid         
19c0: 2d 2d 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68  -- content of th
19d0: 65 20 74 69 63 6b 65 74 0a 20 20 20 20 20 20 20  e ticket.       
19e0: 55 20 75 73 65 72 2d 6c 6f 67 69 6e 0a 20 20 20  U user-login.   
19f0: 20 20 20 20 5a 20 6d 61 6e 69 66 65 73 74 2d 63      Z manifest-c
1a00: 6b 73 75 6d 0a 20 20 2a 20 53 65 74 20 6f 72 20  ksum.  * Set or 
1a10: 65 72 61 73 65 20 61 20 74 61 67 20 20 20 20 2d  erase a tag    -
1a20: 2d 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 64 61  - most recent da
1a30: 74 65 20 77 69 6e 73 0a 20 20 20 20 20 20 20 42  te wins.       B
1a40: 2a 20 28 2b 7c 2d 29 74 61 67 20 75 75 69 64 0a  * (+|-)tag uuid.
1a50: 20 20 20 20 20 20 20 43 3f 20 63 6f 6d 6d 65 6e         C? commen
1a60: 74 0a 20 20 20 20 20 20 20 44 20 64 61 74 65 2d  t.       D date-
1a70: 74 69 6d 65 0a 20 20 20 20 20 20 20 56 2a 20 28  time.       V* (
1a80: 2b 7c 2d 29 20 74 61 67 20 75 75 69 64 20 20 20  +|-) tag uuid   
1a90: 20 2d 2d 20 2b 20 74 6f 20 73 65 74 2c 20 2d 20   -- + to set, - 
1aa0: 74 6f 20 63 6c 65 61 72 2e 20 20 0a 20 20 20 20  to clear.  .    
1ab0: 20 20 20 5a 20 6d 61 6e 69 66 65 73 74 2d 63 6b     Z manifest-ck
1ac0: 73 75 6d 0a 20 20 20 20 20 20 20 2d 2d 20 4d 75  sum.       -- Mu
1ad0: 73 74 20 68 61 76 65 20 61 74 20 6c 65 61 73 74  st have at least
1ae0: 20 6f 6e 65 20 42 20 6f 72 20 56 2e 0a 20 20 20   one B or V..   
1af0: 20 20 20 20 2d 2d 20 54 61 67 20 22 68 69 64 64      -- Tag "hidd
1b00: 65 6e 22 20 6d 65 61 6e 73 20 64 6f 20 6e 6f 74  en" means do not
1b10: 20 73 79 6e 63 0a 20 20 20 20 20 20 20 2d 2d 20   sync.       -- 
1b20: 54 61 67 20 22 63 6c 6f 73 65 64 22 20 6d 65 61  Tag "closed" mea
1b30: 6e 73 20 64 6f 20 6e 6f 74 20 64 69 73 70 6c 61  ns do not displa
1b40: 79 20 61 73 20 61 20 6c 65 61 66 0a 20 20 2a 20  y as a leaf.  * 
1b50: 41 20 63 6c 75 73 74 65 72 0a 20 20 20 20 20 20  A cluster.      
1b60: 20 4d 2b 20 75 75 69 64 0a 20 20 20 20 20 20 20   M+ uuid.       
1b70: 5a 20 6d 61 6e 69 66 65 73 74 2d 63 6b 73 75 6d  Z manifest-cksum
1b80: 0a 20 20 2a 20 43 6f 6d 70 6c 65 74 65 20 73 65  .  * Complete se
1b90: 74 20 6f 66 20 63 61 72 64 73 20 69 6e 20 61 20  t of cards in a 
1ba0: 6d 61 6e 69 66 65 73 74 20 66 69 6c 65 73 3a 0a  manifest files:.
1bb0: 20 20 20 20 20 20 20 41 20 66 69 6c 65 6e 61 6d         A filenam
1bc0: 65 20 75 75 69 64 0a 20 20 20 20 20 20 20 42 20  e uuid.       B 
1bd0: 28 2b 7c 2d 29 62 72 61 6e 63 68 2d 74 61 67 20  (+|-)branch-tag 
1be0: 75 75 69 64 0a 20 20 20 20 20 20 20 43 20 63 6f  uuid.       C co
1bf0: 6d 6d 65 6e 74 0a 20 20 20 20 20 20 20 44 20 64  mment.       D d
1c00: 61 74 65 2d 74 69 6d 65 0a 20 20 20 20 20 20 20  ate-time.       
1c10: 45 20 65 64 69 74 65 64 2d 63 6f 6d 6d 65 6e 74  E edited-comment
1c20: 0a 20 20 20 20 20 20 20 46 20 66 69 6c 65 6e 61  .       F filena
1c30: 6d 65 20 75 75 69 64 0a 20 20 20 20 20 20 20 4e  me uuid.       N
1c40: 20 6e 61 6d 65 0a 20 20 20 20 20 20 20 50 20 75   name.       P u
1c50: 75 69 64 20 2e 2e 2e 0a 20 20 20 20 20 20 20 52  uid ....       R
1c60: 20 72 65 70 6f 73 69 74 6f 72 79 2d 6d 64 35 73   repository-md5s
1c70: 75 6d 0a 20 20 20 20 20 20 20 54 20 75 75 69 64  um.       T uuid
1c80: 0a 20 20 20 20 20 20 20 55 20 75 73 65 72 2d 6c  .       U user-l
1c90: 6f 67 69 6e 0a 20 20 20 20 20 20 20 56 20 28 2b  ogin.       V (+
1ca0: 7c 2d 29 76 65 72 73 69 6f 6e 2d 74 61 67 20 75  |-)version-tag u
1cb0: 75 69 64 0a 20 20 20 20 20 20 20 57 20 75 75 69  uid.       W uui
1cc0: 64 0a 20 20 20 20 20 20 20 5a 20 6d 61 6e 69 66  d.       Z manif
1cd0: 65 73 74 2d 63 68 65 63 6b 73 75 6d 0a           est-checksum.