Hex Artifact Content
Not logged in

Artifact 403e94306f8d3f1731cbd8c1941311641672977b:

File ideas.txt part of check-in [bd35e98274] - Updates to the ideas.txt file with notes on ideas for doing tickets. by drh on 2007-09-27 03:24:49.

0000: 0a 50 6f 73 73 69 62 6c 65 20 74 69 63 6b 65 74  .Possible ticket
0010: 20 66 69 6c 65 20 66 6f 72 6d 61 74 3a 0a 0a 20   file format:.. 
0020: 20 20 41 20 75 75 69 64 20 6e 61 6d 65 20 64 65    A uuid name de
0030: 73 63 72 69 70 74 69 6f 6e 0a 20 20 20 44 20 64  scription.   D d
0040: 61 74 65 74 69 6d 65 0a 20 20 20 4a 20 66 69 65  atetime.   J fie
0050: 6c 64 20 76 61 6c 75 65 0a 20 20 20 4b 20 75 75  ld value.   K uu
0060: 69 64 0a 20 20 20 55 20 75 73 65 72 0a 20 20 20  id.   U user.   
0070: 5a 20 6d 64 35 73 75 6d 0a 20 20 20 0a 46 49 45  Z md5sum.   .FIE
0080: 4c 44 73 3a 0a 0a 20 20 20 63 6f 6d 6d 65 6e 74  LDs:..   comment
0090: 20 20 20 20 20 20 20 20 20 63 75 6d 75 6c 61 74           cumulat
00a0: 69 76 65 20 74 65 78 74 0a 20 20 20 74 69 74 6c  ive text.   titl
00b0: 65 20 20 20 20 20 20 20 20 20 20 20 74 65 78 74  e           text
00c0: 0a 20 20 20 61 73 73 69 67 6e 65 64 74 6f 20 20  .   assignedto  
00d0: 20 20 20 20 74 65 78 74 0a 20 20 20 73 74 61 74      text.   stat
00e0: 75 73 20 20 20 20 20 20 20 20 20 20 65 6e 75 6d  us          enum
00f0: 0a 20 20 20 72 65 73 6f 6c 75 74 69 6f 6e 20 20  .   resolution  
0100: 20 20 20 20 65 6e 75 6d 0a 20 20 20 73 75 62 73      enum.   subs
0110: 79 73 74 65 6d 20 20 20 20 20 20 20 65 6e 75 6d  ystem       enum
0120: 0a 20 20 20 74 79 70 65 20 20 20 20 20 20 20 20  .   type        
0130: 20 20 20 20 65 6e 75 6d 0a 20 20 20 70 72 69 6f      enum.   prio
0140: 72 69 74 79 20 20 20 20 20 20 20 20 65 6e 75 6d  rity        enum
0150: 0a 20 20 20 73 65 76 65 72 69 74 79 20 20 20 20  .   severity    
0160: 20 20 20 20 65 6e 75 6d 0a 20 20 20 64 65 66 65      enum.   defe
0170: 72 75 6e 74 69 6c 20 20 20 20 20 20 64 61 74 65  runtil      date
0180: 74 69 6d 65 0a 20 20 20 64 75 65 64 61 74 65 20  time.   duedate 
0190: 20 20 20 20 20 20 20 20 64 61 74 65 74 69 6d 65          datetime
01a0: 0a 20 20 20 64 65 72 69 76 65 64 66 72 6f 6d 20  .   derivedfrom 
01b0: 20 20 20 20 61 64 64 20 6f 72 20 73 75 62 74 72      add or subtr
01c0: 61 63 74 20 75 75 69 64 0a 20 20 20 72 65 6c 61  act uuid.   rela
01d0: 74 65 64 76 65 72 73 69 6f 6e 73 20 61 64 64 20  tedversions add 
01e0: 6f 72 20 73 75 62 74 72 61 63 74 20 61 73 73 6f  or subtract asso
01f0: 63 69 61 74 65 20 77 69 74 68 20 6d 61 6e 69 66  ciate with manif
0200: 65 73 74 0a 20 20 20 70 72 65 73 65 6e 74 69 6e  est.   presentin
0210: 20 20 20 20 20 20 20 61 64 64 20 6f 72 20 73 75         add or su
0220: 62 74 72 61 63 74 20 75 75 69 64 0a 20 20 20 66  btract uuid.   f
0230: 69 78 65 64 69 6e 20 20 20 20 20 20 20 20 20 61  ixedin         a
0240: 64 64 20 6f 72 20 73 75 62 74 72 61 63 74 20 75  dd or subtract u
0250: 75 69 64 0a 0a 4f 74 68 65 72 20 74 61 62 6c 65  uid..Other table
0260: 20 63 6f 6c 75 6d 6e 73 3a 0a 20 20 20 6f 72 69   columns:.   ori
0270: 67 69 6e 74 69 6d 65 0a 20 20 20 6c 61 73 74 63  gintime.   lastc
0280: 68 61 6e 67 65 0a 20 20 20 0a 0a 54 61 62 6c 65  hange.   ..Table
0290: 73 3a 0a 0a 20 20 20 74 6b 74 72 69 64 28 72 69  s:..   tktrid(ri
02a0: 64 2c 20 74 6b 69 64 2c 20 6d 74 69 6d 65 29 3b  d, tkid, mtime);
02b0: 20 20 69 6e 64 65 78 28 74 6b 69 64 2c 20 6d 74    index(tkid, mt
02c0: 69 6d 65 29 3b 0a 20 20 20 74 69 63 6b 65 74 28  ime);.   ticket(
02d0: 74 6b 69 64 2c 20 74 6b 75 75 69 64 2c 20 74 69  tkid, tkuuid, ti
02e0: 74 6c 65 2c 20 63 6f 6d 2c 20 73 74 61 74 75 73  tle, com, status
02f0: 2c 20 2e 2e 2e 29 3b 0a 20 20 20 74 6b 74 66 69  , ...);.   tktfi
0300: 65 6c 64 28 6e 61 6d 65 2c 20 74 79 70 65 2c 20  eld(name, type, 
0310: 77 69 64 74 68 2c 20 68 65 69 67 68 74 2c 20 64  width, height, d
0320: 65 66 61 75 6c 74 2c 20 76 61 6c 75 65 6c 69 73  efault, valuelis
0330: 74 29 3b 0a 20 20 20 74 6b 74 78 72 65 66 28 74  t);.   tktxref(t
0340: 6b 69 64 2c 20 6d 69 64 29 3b 20 69 6e 64 65 78  kid, mid); index
0350: 28 74 6b 69 64 29 3b 20 69 6e 64 65 78 28 6d 69  (tkid); index(mi
0360: 64 29 3b 0a 0a 54 6b 74 66 6f 72 6d 61 74 20 69  d);..Tktformat i
0370: 6e 20 74 68 65 20 63 6f 6e 66 69 67 20 74 61 62  n the config tab
0380: 6c 65 2e 0a 0a 20 20 20 2a 20 54 68 72 65 65 20  le...   * Three 
0390: 70 61 67 65 73 3a 20 20 63 72 65 61 74 69 6f 6e  pages:  creation
03a0: 2c 20 64 69 73 70 6c 61 79 2c 20 61 6e 64 20 65  , display, and e
03b0: 64 69 74 0a 20 20 20 2a 20 48 54 4d 4c 0a 20 20  dit.   * HTML.  
03c0: 20 2a 20 5b 5b 66 69 65 6c 64 5d 5d 20 74 6f 20   * [[field]] to 
03d0: 73 75 62 73 74 69 74 75 74 65 20 74 68 65 20 61  substitute the a
03e0: 70 70 72 6f 70 72 69 61 74 65 20 66 6f 72 6d 20  ppropriate form 
03f0: 6f 72 20 64 69 73 70 6c 61 79 20 65 6c 65 6d 65  or display eleme
0400: 6e 74 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  nt..------------
0410: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0420: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0430: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0440: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 57 69 6b  ------------.Wik
0450: 69 20 68 65 61 64 65 72 20 66 6f 72 6d 61 74 3a  i header format:
0460: 0a 20 20 20 22 57 69 6b 69 50 61 67 65 22 0a 20  .   "WikiPage". 
0470: 20 20 70 61 72 65 6e 74 3a 20 55 55 49 44 2a 0a    parent: UUID*.
0480: 20 20 20 74 69 74 6c 65 3a 20 54 45 58 54 0a 20     title: TEXT. 
0490: 20 20 70 61 67 65 6e 61 6d 65 3a 20 54 45 58 54    pagename: TEXT
04a0: 0a 20 20 20 6d 6f 64 65 3a 20 28 72 65 61 64 6f  .   mode: (reado
04b0: 6e 6c 79 7c 61 70 70 65 6e 64 6f 6e 6c 79 7c 72  nly|appendonly|r
04c0: 65 61 64 77 72 69 74 65 29 0a 20 20 20 61 74 74  eadwrite).   att
04d0: 61 63 68 6d 65 6e 74 3a 20 55 55 49 44 20 6e 61  achment: UUID na
04e0: 6d 65 20 64 65 73 63 72 69 70 74 69 6f 6e 0a 0a  me description..
04f0: 20 20 20 2a 20 48 65 61 64 65 72 20 65 6e 64 73     * Header ends
0500: 20 77 69 74 68 20 61 20 62 6c 61 6e 6b 20 6c 69   with a blank li
0510: 6e 65 2e 20 20 77 69 6b 69 20 63 6f 6e 74 65 6e  ne.  wiki conten
0520: 74 20 66 6f 6c 6c 6f 77 73 2e 0a 0a 4e 65 65 64  t follows...Need
0530: 20 61 20 64 65 70 68 61 6e 74 6f 6d 69 7a 65 20   a dephantomize 
0540: 61 6c 67 6f 72 69 74 68 6d 0a 0a 0a 52 61 6e 64  algorithm...Rand
0550: 6f 6d 20 74 68 6f 75 67 68 74 73 3a 0a 0a 20 20  om thoughts:..  
0560: 2a 20 50 6c 69 6e 6b 2e 69 73 70 72 69 6d 20 63  * Plink.isprim c
0570: 68 61 6e 67 65 64 20 74 6f 20 72 65 63 6f 72 64  hanged to record
0580: 3a 0a 20 20 20 20 20 2b 20 20 63 68 69 6c 64 20  :.     +  child 
0590: 69 73 20 74 68 65 20 70 72 69 6e 63 69 70 61 6c  is the principal
05a0: 20 64 65 73 63 65 6e 64 65 6e 74 20 6f 66 20 70   descendent of p
05b0: 61 72 65 6e 74 2e 20 28 31 29 0a 20 20 20 20 20  arent. (1).     
05c0: 2b 20 20 63 68 69 6c 64 20 69 73 20 61 20 62 72  +  child is a br
05d0: 61 6e 63 68 20 66 72 6f 6d 20 70 61 72 65 6e 74  anch from parent
05e0: 20 28 32 29 0a 20 20 20 20 20 2b 20 20 63 68 69   (2).     +  chi
05f0: 6c 64 20 75 73 65 73 20 70 61 72 65 6e 74 20 61  ld uses parent a
0600: 73 20 61 20 6d 65 72 67 65 20 28 30 29 0a 0a 20  s a merge (0).. 
0610: 20 2a 20 77 65 62 73 69 74 65 20 63 61 6e 20 74   * website can t
0620: 6f 67 67 6c 65 20 69 73 70 72 69 6d 20 62 65 74  oggle isprim bet
0630: 77 65 65 6e 20 70 72 69 6e 63 69 70 61 6c 20 61  ween principal a
0640: 6e 64 20 62 72 61 6e 63 68 2e 0a 20 20 20 20 20  nd branch..     
0650: 2b 20 48 6f 77 20 74 6f 20 70 72 65 73 65 72 76  + How to preserv
0660: 65 20 61 63 72 6f 73 73 20 72 65 62 75 69 6c 64  e across rebuild
0670: 2e 20 20 41 20 6e 65 77 20 72 65 63 6f 72 64 20  .  A new record 
0680: 74 79 70 65 3f 0a 20 20 20 20 20 2b 20 48 6f 77  type?.     + How
0690: 20 74 6f 20 73 68 61 72 65 20 77 69 74 68 20 6f   to share with o
06a0: 74 68 65 72 20 72 65 70 6f 73 69 74 6f 72 69 65  ther repositorie
06b0: 73 0a 20 20 2a 20 69 73 70 72 69 6d 20 67 75 65  s.  * isprim gue
06c0: 73 73 65 64 20 75 73 69 6e 67 20 75 73 65 72 69  ssed using useri
06d0: 64 20 6f 66 20 70 61 72 65 6e 74 20 61 6e 64 20  d of parent and 
06e0: 63 68 69 6c 64 2e 20 20 43 68 61 6e 67 65 0a 20  child.  Change. 
06f0: 20 20 20 69 6e 20 69 64 20 73 75 67 67 65 73 74     in id suggest
0700: 73 20 61 20 62 72 61 6e 63 68 2e 20 20 53 61 6d  s a branch.  Sam
0710: 65 20 69 64 20 73 75 67 67 65 73 74 73 20 70 72  e id suggests pr
0720: 69 6e 63 69 70 61 6c 2e 0a 20 20 20 20 46 6f 72  incipal..    For
0730: 20 61 20 74 69 65 2c 20 67 6f 20 77 69 74 68 20   a tie, go with 
0740: 74 68 65 20 65 61 72 6c 69 65 73 74 20 63 68 65  the earliest che
0750: 63 6b 2d 69 6e 20 61 73 20 74 68 65 20 70 72 69  ck-in as the pri
0760: 6e 63 69 70 61 6c 27 0a 0a 20 20 2a 20 41 75 74  ncipal'..  * Aut
0770: 6f 73 79 6e 63 20 6d 6f 64 65 0a 20 20 20 20 20  osync mode.     
0780: 2a 20 4e 6f 74 65 73 3a 0a 20 20 20 20 20 20 20  * Notes:.       
0790: 2b 20 44 65 73 69 67 6e 65 64 20 74 6f 20 61 76  + Designed to av
07a0: 6f 69 64 20 62 72 61 6e 63 68 69 6e 67 20 69 6e  oid branching in
07b0: 20 68 69 67 68 6c 79 20 63 6f 6c 6c 61 62 6f 72   highly collabor
07c0: 61 74 69 76 65 20 0a 20 20 20 20 20 20 20 20 20  ative .         
07d0: 65 6e 76 69 72 6f 6e 6d 65 6e 74 73 2e 0a 20 20  environments..  
07e0: 20 20 20 2a 20 4f 75 74 73 74 61 6e 64 69 6e 67     * Outstanding
07f0: 3a 0a 20 20 20 20 20 20 20 2b 20 4f 6e 20 63 6f  :.       + On co
0800: 6d 6d 69 74 2c 20 66 69 72 73 74 20 70 75 6c 6c  mmit, first pull
0810: 2e 20 20 49 66 20 63 6f 6d 6d 69 74 20 62 61 73  .  If commit bas
0820: 65 6c 69 6e 65 20 69 73 20 6e 6f 74 20 61 20 74  eline is not a t
0830: 69 70 0a 20 20 20 20 20 20 20 20 20 70 72 6f 6d  ip.         prom
0840: 70 74 20 75 73 65 72 20 74 6f 20 63 61 6e 63 65  pt user to cance
0850: 6c 20 6f 72 20 62 72 61 6e 63 68 2e 20 20 44 65  l or branch.  De
0860: 66 61 75 6c 74 20 69 73 20 63 61 6e 63 65 6c 2e  fault is cancel.
0870: 0a 20 20 20 20 20 20 20 2b 20 4e 65 65 64 20 61  .       + Need a
0880: 6e 20 22 75 6e 64 6f 22 20 63 61 70 61 62 69 6c  n "undo" capabil
0890: 69 74 79 0a 20 20 20 20 20 2a 20 44 6f 6e 65 3a  ity.     * Done:
08a0: 0a 20 20 20 20 20 20 20 2a 20 53 65 74 20 61 20  .       * Set a 
08b0: 70 72 65 66 65 72 72 65 64 20 72 65 6d 6f 74 65  preferred remote
08c0: 20 72 65 70 6f 73 69 74 6f 72 79 20 74 6f 20 75   repository to u
08d0: 73 65 20 61 73 20 61 20 73 65 72 76 65 72 0a 20  se as a server. 
08e0: 20 20 20 20 20 20 20 20 20 3d 20 20 43 6c 6f 6e           =  Clon
08f0: 65 20 72 65 70 6f 73 69 74 6f 72 79 20 69 73 20  e repository is 
0900: 74 68 65 20 64 65 66 61 75 6c 74 0a 20 20 20 20  the default.    
0910: 20 20 20 2a 20 50 75 73 68 20 61 66 74 65 72 20     * Push after 
0920: 63 6f 6d 6d 69 74 0a 20 20 20 20 20 20 20 2a 20  commit.       * 
0930: 41 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 70 75  Automatically pu
0940: 6c 6c 20 70 72 69 6f 72 20 74 6f 20 75 70 64 61  ll prior to upda
0950: 74 65 2e 0a 0a 20 20 2a 20 41 72 63 68 65 6f 6c  te...  * Archeol
0960: 6f 67 69 63 61 6c 20 77 65 62 70 61 67 65 20 69  ogical webpage i
0970: 6d 70 72 6f 76 65 6d 65 6e 74 73 3a 0a 20 20 20  mprovements:.   
0980: 20 20 2b 20 55 73 65 20 61 20 73 6d 61 6c 6c 20    + Use a small 
0990: 61 6d 6f 75 6e 74 20 6f 66 20 43 53 53 2b 6a 61  amount of CSS+ja
09a0: 76 61 73 63 72 69 70 74 20 6f 6e 20 74 69 6d 65  vascript on time
09b0: 6c 69 6e 65 73 20 73 6f 20 74 68 61 74 0a 20 20  lines so that.  
09c0: 20 20 20 20 20 62 72 61 6e 63 68 69 6e 67 20 73       branching s
09d0: 74 72 75 63 74 75 72 65 20 69 73 20 64 69 73 70  tructure is disp
09e0: 6c 61 79 65 64 20 6f 6e 20 6d 6f 75 73 65 6f 76  layed on mouseov
09f0: 65 72 2e 20 20 4f 6e 20 6d 6f 75 73 65 6f 76 65  er.  On mouseove
0a00: 72 0a 20 20 20 20 20 20 20 6f 66 20 61 20 63 68  r.       of a ch
0a10: 65 63 6b 69 6e 2c 20 68 69 67 68 6c 69 67 68 74  eckin, highlight
0a20: 20 6f 74 68 65 72 20 63 68 65 63 6b 69 6e 73 20   other checkins 
0a30: 74 68 61 74 20 61 72 65 20 64 69 72 65 63 74 20  that are direct 
0a40: 28 6e 6f 6e 2d 6d 65 72 67 65 29 0a 20 20 20 20  (non-merge).    
0a50: 20 20 20 64 65 73 63 65 6e 64 65 6e 74 73 20 61     descendents a
0a60: 6e 64 20 61 6e 63 65 73 74 6f 72 73 20 6f 66 20  nd ancestors of 
0a70: 74 68 65 20 6d 6f 75 73 65 6f 76 65 72 20 63 68  the mouseover ch
0a80: 65 63 6b 69 6e 2e 0a 20 20 20 20 20 2b 20 54 69  eckin..     + Ti
0a90: 6d 65 6c 69 6e 65 20 73 68 6f 77 69 6e 67 20 69  meline showing i
0aa0: 6e 64 69 76 69 64 75 61 6c 20 62 72 61 6e 63 68  ndividual branch
0ab0: 65 73 0a 20 20 20 20 20 2b 20 54 69 6d 65 6c 69  es.     + Timeli
0ac0: 6e 65 20 73 68 6f 77 73 20 66 6f 72 6b 73 20 61  ne shows forks a
0ad0: 6e 64 20 6d 65 72 67 65 73 0a 20 20 20 20 20 2b  nd merges.     +
0ae0: 20 54 61 67 73 20 73 68 6f 77 6e 20 6f 6e 20 74   Tags shown on t
0af0: 69 6d 65 6c 69 6e 65 20 28 6d 61 79 62 65 29 20  imeline (maybe) 
0b00: 61 6e 64 20 69 6e 20 76 69 6e 66 6f 20 28 73 75  and in vinfo (su
0b10: 72 65 6c 79 29 2e 0a 0a 46 65 61 74 75 72 65 73  rely)...Features
0b20: 20 6e 65 65 64 65 64 3a 0a 20 20 2a 20 4d 65 61   needed:.  * Mea
0b30: 6e 73 20 74 6f 20 73 75 70 70 72 65 73 73 20 61  ns to suppress a
0b40: 72 74 69 66 61 63 74 73 0a 20 20 2a 20 4d 65 61  rtifacts.  * Mea
0b50: 6e 73 20 74 6f 20 63 61 70 20 61 20 62 72 61 6e  ns to cap a bran
0b60: 63 68 0a 20 20 2a 20 54 69 63 6b 65 74 69 6e 67  ch.  * Ticketing
0b70: 0a 20 20 20 20 20 2b 20 20 50 72 6f 62 6c 65 6d  .     +  Problem
0b80: 20 69 73 2f 69 73 2d 6e 6f 74 20 65 78 70 72 65   is/is-not expre
0b90: 73 73 65 64 20 69 6e 20 62 61 73 65 6c 69 6e 65  ssed in baseline
0ba0: 20 58 2e 0a 20 20 20 20 20 2b 20 20 41 70 70 65   X..     +  Appe
0bb0: 6e 64 20 63 6f 6d 6d 65 6e 74 20 61 6e 64 20 7a  nd comment and z
0bc0: 65 72 6f 20 6f 72 20 6d 6f 72 65 20 61 74 74 61  ero or more atta
0bd0: 63 68 6d 65 6e 74 73 0a 20 20 2a 20 4d 6f 64 69  chments.  * Modi
0be0: 66 79 20 63 6f 6d 6d 65 6e 74 73 20 6f 6e 20 62  fy comments on b
0bf0: 61 73 65 6c 69 6e 65 73 0a 20 20 2a 20 41 70 70  aselines.  * App
0c00: 65 6e 64 20 63 6f 6d 6d 65 6e 74 73 20 74 6f 20  end comments to 
0c10: 61 6e 79 20 61 72 74 69 66 61 63 74 0a 20 20 2a  any artifact.  *
0c20: 20 57 69 6b 69 3f 0a 0a 20 20 0a 0a 45 78 74 65   Wiki?..  ..Exte
0c30: 6e 64 65 64 20 6d 61 6e 69 66 65 73 74 73 2e 0a  nded manifests..
0c40: 20 20 2a 20 6e 6f 72 6d 61 6c 20 6d 61 6e 69 66    * normal manif
0c50: 65 73 74 20 68 61 73 3a 0a 20 20 20 20 20 20 20  est has:.       
0c60: 43 20 63 6f 6d 6d 65 6e 74 0a 20 20 20 20 20 20  C comment.      
0c70: 20 44 20 64 61 74 65 2d 74 69 6d 65 0a 20 20 20   D date-time.   
0c80: 20 20 20 20 46 2a 20 66 69 6c 65 6e 61 6d 65 20      F* filename 
0c90: 75 75 69 64 0a 20 20 20 20 20 20 20 50 20 75 75  uuid.       P uu
0ca0: 69 64 20 2e 2e 2e 20 20 20 20 20 20 20 20 20 20  id ...          
0cb0: 20 2d 2d 20 6f 6d 69 74 74 65 64 20 66 6f 72 20   -- omitted for 
0cc0: 66 69 72 73 74 20 6d 61 6e 69 66 65 73 74 0a 20  first manifest. 
0cd0: 20 20 20 20 20 20 52 20 72 65 70 6f 73 69 74 6f        R reposito
0ce0: 72 79 2d 6d 64 35 73 75 6d 0a 20 20 20 20 20 20  ry-md5sum.      
0cf0: 20 55 20 75 73 65 72 2d 6c 6f 67 69 6e 0a 20 20   U user-login.  
0d00: 20 20 20 20 20 5a 20 6d 61 6e 69 66 65 73 74 2d       Z manifest-
0d10: 63 68 65 63 6b 73 75 6d 0a 0a 20 20 2a 20 41 63  checksum..  * Ac
0d20: 63 65 73 73 6f 72 79 3a 0a 20 20 20 20 20 20 20  cessory:.       
0d30: 41 20 75 75 69 64 7c 2a 20 61 74 74 61 63 68 6d  A uuid|* attachm
0d40: 65 6e 74 2d 75 75 69 64 20 64 65 73 63 72 69 70  ent-uuid descrip
0d50: 74 69 6f 6e 0a 20 20 20 20 20 20 20 44 20 64 61  tion.       D da
0d60: 74 65 2d 74 69 6d 65 0a 20 20 20 20 20 20 20 45  te-time.       E
0d70: 20 75 75 69 64 20 6e 65 77 2d 63 6f 6d 6d 65 6e   uuid new-commen
0d80: 74 0a 20 20 20 20 20 20 20 47 20 75 75 69 64 20  t.       G uuid 
0d90: 61 70 70 65 6e 64 65 64 2d 72 65 6d 61 72 6b 0a  appended-remark.
0da0: 20 20 20 20 20 20 20 53 20 72 65 70 6f 73 69 74         S reposit
0db0: 6f 72 79 69 64 20 73 65 72 69 61 6c 2d 6e 75 6d  oryid serial-num
0dc0: 62 65 72 0a 20 20 20 20 20 20 20 54 20 28 2b 7c  ber.       T (+|
0dd0: 2d 29 74 61 67 20 75 75 69 64 0a 20 20 20 20 20  -)tag uuid.     
0de0: 20 20 55 20 75 73 65 72 69 64 0a 20 20 20 20 20    U userid.     
0df0: 20 20 58 20 75 75 69 64 2d 74 6f 2d 73 75 72 70    X uuid-to-surp
0e00: 72 65 73 73 0a 20 20 20 20 20 20 20 5a 20 74 68  ress.       Z th
0e10: 69 73 2d 66 69 6c 65 2d 63 68 65 63 6b 73 75 6d  is-file-checksum
0e20: 0a 0a 20 20 2a 20 43 68 61 6e 67 65 20 74 68 65  ..  * Change the
0e30: 20 63 6f 6d 6d 65 6e 74 20 6f 6e 20 61 20 76 65   comment on a ve
0e40: 72 73 69 6f 6e 3a 20 20 20 2d 2d 20 61 6c 77 61  rsion:   -- alwa
0e50: 79 73 20 61 20 6c 65 61 66 20 65 78 63 65 70 74  ys a leaf except
0e60: 20 69 6e 20 63 6c 75 73 74 65 72 0a 20 20 20 20   in cluster.    
0e70: 20 20 20 44 20 64 61 74 65 2d 74 69 6d 65 0a 20     D date-time. 
0e80: 20 20 20 20 20 20 45 20 6e 65 77 2d 63 6f 6d 6d        E new-comm
0e90: 65 6e 74 0a 20 20 20 20 20 20 20 50 20 75 75 69  ent.       P uui
0ea0: 64 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2d  d              -
0eb0: 2d 20 62 61 73 65 6c 69 6e 65 20 77 68 6f 73 65  - baseline whose
0ec0: 20 63 6f 6d 6d 65 6e 74 20 69 73 20 63 68 61 6e   comment is chan
0ed0: 67 65 64 0a 20 20 20 20 20 20 20 55 20 75 73 65  ged.       U use
0ee0: 72 2d 6c 6f 67 69 6e 0a 20 20 20 20 20 20 20 5a  r-login.       Z
0ef0: 20 63 68 65 63 6b 73 75 6d 0a 20 20 20 20 20 20   checksum.      
0f00: 20 2d 2d 20 6d 6f 73 74 20 72 65 63 65 6e 74 20   -- most recent 
0f10: 77 69 6e 73 0a 20 20 2a 20 57 69 6b 69 20 65 64  wins.  * Wiki ed
0f20: 69 74 0a 20 20 20 20 20 20 20 41 2a 20 6e 61 6d  it.       A* nam
0f30: 65 20 75 75 69 64 20 20 20 2d 2d 20 7a 65 72 6f  e uuid   -- zero
0f40: 20 6f 72 20 6d 6f 72 65 20 61 74 74 61 63 68 6d   or more attachm
0f50: 65 6e 74 73 0a 20 20 20 20 20 20 20 43 3f 20 63  ents.       C? c
0f60: 6f 6d 6d 65 6e 74 0a 20 20 20 20 20 20 20 44 20  omment.       D 
0f70: 64 61 74 65 2d 74 69 6d 65 0a 20 20 20 20 20 20  date-time.      
0f80: 20 4e 20 6e 61 6d 65 20 20 20 20 20 20 20 20 20   N name         
0f90: 2d 2d 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 77  -- name of the w
0fa0: 69 6b 69 20 70 61 67 65 0a 20 20 20 20 20 20 20  iki page.       
0fb0: 50 20 75 75 69 64 20 2e 2e 2e 20 20 20 20 20 2d  P uuid ...     -
0fc0: 2d 20 6f 6d 69 74 20 66 6f 72 20 6e 65 77 20 77  - omit for new w
0fd0: 69 6b 69 0a 20 20 20 20 20 20 20 55 20 75 73 65  iki.       U use
0fe0: 72 2d 6c 6f 67 69 6e 0a 20 20 20 20 20 20 20 57  r-login.       W
0ff0: 20 75 75 69 64 20 20 20 20 20 20 20 20 20 2d 2d   uuid         --
1000: 20 54 68 65 20 63 6f 6e 74 65 6e 74 20 66 69 6c   The content fil
1010: 65 0a 20 20 20 20 20 20 20 5a 20 6d 61 6e 69 66  e.       Z manif
1020: 65 73 74 2d 63 6b 73 75 6d 0a 20 20 2a 20 54 69  est-cksum.  * Ti
1030: 63 6b 65 74 20 65 64 69 74 0a 20 20 20 20 20 20  cket edit.      
1040: 20 41 2a 20 6e 61 6d 65 20 75 75 69 64 20 20 20   A* name uuid   
1050: 2d 2d 20 7a 65 72 6f 20 6f 72 20 6d 6f 72 65 20  -- zero or more 
1060: 61 74 74 61 63 68 6d 65 6e 74 73 0a 20 20 20 20  attachments.    
1070: 20 20 20 44 20 64 61 74 65 2d 74 69 6d 65 0a 20     D date-time. 
1080: 20 20 20 20 20 20 4e 20 6e 61 6d 65 20 20 20 20        N name    
1090: 20 20 20 20 20 2d 2d 20 6e 61 6d 65 20 6f 66 20       -- name of 
10a0: 74 68 65 20 74 69 63 6b 65 74 0a 20 20 20 20 20  the ticket.     
10b0: 20 20 50 20 75 75 69 64 20 20 20 20 20 20 20 20    P uuid        
10c0: 20 2d 2d 20 6f 6d 69 74 20 66 6f 72 20 6e 65 77   -- omit for new
10d0: 20 74 69 63 6b 65 74 0a 20 20 20 20 20 20 20 54   ticket.       T
10e0: 20 75 75 69 64 20 20 20 20 20 20 20 20 20 2d 2d   uuid         --
10f0: 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 20   content of the 
1100: 74 69 63 6b 65 74 0a 20 20 20 20 20 20 20 55 20  ticket.       U 
1110: 75 73 65 72 2d 6c 6f 67 69 6e 0a 20 20 20 20 20  user-login.     
1120: 20 20 5a 20 6d 61 6e 69 66 65 73 74 2d 63 6b 73    Z manifest-cks
1130: 75 6d 0a 20 20 2a 20 53 65 74 20 6f 72 20 65 72  um.  * Set or er
1140: 61 73 65 20 61 20 74 61 67 20 20 20 20 2d 2d 20  ase a tag    -- 
1150: 6d 6f 73 74 20 72 65 63 65 6e 74 20 64 61 74 65  most recent date
1160: 20 77 69 6e 73 0a 20 20 20 20 20 20 20 42 2a 20   wins.       B* 
1170: 28 2b 7c 2d 29 74 61 67 20 75 75 69 64 0a 20 20  (+|-)tag uuid.  
1180: 20 20 20 20 20 43 3f 20 63 6f 6d 6d 65 6e 74 0a       C? comment.
1190: 20 20 20 20 20 20 20 44 20 64 61 74 65 2d 74 69         D date-ti
11a0: 6d 65 0a 20 20 20 20 20 20 20 56 2a 20 28 2b 7c  me.       V* (+|
11b0: 2d 29 20 74 61 67 20 75 75 69 64 20 20 20 20 2d  -) tag uuid    -
11c0: 2d 20 2b 20 74 6f 20 73 65 74 2c 20 2d 20 74 6f  - + to set, - to
11d0: 20 63 6c 65 61 72 2e 20 20 0a 20 20 20 20 20 20   clear.  .      
11e0: 20 5a 20 6d 61 6e 69 66 65 73 74 2d 63 6b 73 75   Z manifest-cksu
11f0: 6d 0a 20 20 20 20 20 20 20 2d 2d 20 4d 75 73 74  m.       -- Must
1200: 20 68 61 76 65 20 61 74 20 6c 65 61 73 74 20 6f   have at least o
1210: 6e 65 20 42 20 6f 72 20 56 2e 0a 20 20 20 20 20  ne B or V..     
1220: 20 20 2d 2d 20 42 72 61 6e 63 68 20 74 61 67 20    -- Branch tag 
1230: 22 68 69 64 64 65 6e 22 20 6d 65 61 6e 73 20 64  "hidden" means d
1240: 6f 20 6e 6f 74 20 73 79 6e 63 0a 20 20 20 20 20  o not sync.     
1250: 20 20 2d 2d 20 56 65 72 73 69 6f 6e 20 74 61 67    -- Version tag
1260: 20 22 63 6c 6f 73 65 64 22 20 6d 65 61 6e 73 20   "closed" means 
1270: 64 6f 20 6e 6f 74 20 64 69 73 70 6c 61 79 20 61  do not display a
1280: 73 20 61 20 6c 65 61 66 0a 20 20 2a 20 41 20 63  s a leaf.  * A c
1290: 6c 75 73 74 65 72 0a 20 20 20 20 20 20 20 4d 2b  luster.       M+
12a0: 20 75 75 69 64 0a 20 20 20 20 20 20 20 5a 20 6d   uuid.       Z m
12b0: 61 6e 69 66 65 73 74 2d 63 6b 73 75 6d 0a 0a 20  anifest-cksum.. 
12c0: 20 2a 20 43 6f 6d 70 6c 65 74 65 20 73 65 74 20   * Complete set 
12d0: 6f 66 20 63 61 72 64 73 20 69 6e 20 61 20 63 6f  of cards in a co
12e0: 6e 74 72 6f 6c 20 66 69 6c 65 3a 0a 20 20 20 20  ntrol file:.    
12f0: 20 20 20 41 20 66 69 6c 65 6e 61 6d 65 20 75 75     A filename uu
1300: 69 64 20 20 20 20 20 20 20 20 20 20 20 20 20 0a  id             .
1310: 20 20 20 20 20 20 20 42 20 28 2b 7c 2d 29 62 72         B (+|-)br
1320: 61 6e 63 68 2d 74 61 67 20 75 75 69 64 20 20 20  anch-tag uuid   
1330: 20 20 20 0a 20 20 20 20 20 20 20 43 20 63 6f 6d     .       C com
1340: 6d 65 6e 74 20 20 20 20 20 20 20 20 20 20 20 20  ment            
1350: 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 44         .       D
1360: 20 64 61 74 65 2d 74 69 6d 65 20 20 20 20 20 20   date-time      
1370: 20 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 20             .    
1380: 20 20 20 45 20 75 75 69 64 20 65 64 69 74 65 64     E uuid edited
1390: 2d 63 6f 6d 6d 65 6e 74 20 20 20 20 20 20 20 0a  -comment       .
13a0: 20 20 20 20 20 20 20 46 20 66 69 6c 65 6e 61 6d         F filenam
13b0: 65 20 75 75 69 64 20 20 20 20 20 20 20 20 20 20  e uuid          
13c0: 20 20 20 0a 20 20 20 20 20 20 20 4d 20 75 75 69     .       M uui
13d0: 64 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  d               
13e0: 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 4e         .       N
13f0: 20 6e 61 6d 65 20 20 20 20 20 20 20 20 20 20 20   name           
1400: 20 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 20             .    
1410: 20 20 20 50 20 75 75 69 64 20 2e 2e 2e 20 20 20     P uuid ...   
1420: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0a                 .
1430: 20 20 20 20 20 20 20 52 20 72 65 70 6f 73 69 74         R reposit
1440: 6f 72 79 2d 6d 64 35 73 75 6d 20 20 20 20 20 20  ory-md5sum      
1450: 20 20 20 0a 20 20 20 20 20 20 20 54 20 75 75 69     .       T uui
1460: 64 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  d               
1470: 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 55         .       U
1480: 20 75 73 65 72 2d 6c 6f 67 69 6e 20 20 20 20 20   user-login     
1490: 20 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 20             .    
14a0: 20 20 20 56 20 28 2b 7c 2d 29 76 65 72 73 69 6f     V (+|-)versio
14b0: 6e 2d 74 61 67 20 75 75 69 64 20 20 20 20 20 0a  n-tag uuid     .
14c0: 20 20 20 20 20 20 20 57 20 75 75 69 64 20 20 20         W uuid   
14d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
14e0: 20 20 20 0a 20 20 20 20 20 20 20 5a 20 6d 61 6e     .       Z man
14f0: 69 66 65 73 74 2d 63 68 65 63 6b 73 75 6d 0a     ifest-checksum.