Hex Artifact Content
Not logged in

Artifact 555b72ded17f4d117832787938a94cc47dcfd6dd:

File ideas.txt part of check-in [ab637af752] - Add enumeration lists and indented paragraphs in the wiki. by drh on 2007-09-28 15:44:08.

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 43 68 61  ------------.Cha
0450: 6e 67 65 20 74 6f 20 77 69 6b 69 3a 0a 0a 20 20  nge to wiki:..  
0460: 20 41 20 75 75 69 64 20 66 69 6c 65 6e 61 6d 65   A uuid filename
0470: 20 64 65 73 63 72 69 70 74 69 6f 6e 0a 20 20 20   description.   
0480: 44 20 64 61 74 65 74 69 6d 65 0a 20 20 20 50 20  D datetime.   P 
0490: 75 75 69 64 20 2e 2e 2e 0a 20 20 20 55 20 75 73  uuid ....   U us
04a0: 65 72 0a 20 20 20 57 20 77 69 6b 69 70 61 67 65  er.   W wikipage
04b0: 6e 61 6d 65 20 75 75 69 64 0a 20 20 20 5a 20 6d  name uuid.   Z m
04c0: 64 35 73 75 6d 0a 0a 4f 6e 20 70 61 67 65 3a 0a  d5sum..On page:.
04d0: 0a 20 20 20 3c 74 69 74 6c 65 3e 2e 2e 2e 2e 3c  .   <title>....<
04e0: 2f 74 69 74 6c 65 3e 0a 20 20 20 3c 72 65 61 64  /title>.   <read
04f0: 6f 6e 6c 79 2f 3e 0a 0a 48 79 70 65 72 6c 69 6e  only/>..Hyperlin
0500: 6b 73 3a 0a 0a 20 20 20 5b 6c 6f 77 65 72 63 61  ks:..   [lowerca
0510: 73 65 68 65 78 5d 20 20 20 20 20 20 20 2f 69 6e  sehex]       /in
0520: 66 6f 2f 6c 6f 77 65 72 63 61 73 65 68 65 78 0a  fo/lowercasehex.
0530: 20 20 20 5b 61 74 74 61 63 68 6d 65 6e 74 2e 67     [attachment.g
0540: 69 66 5d 20 20 20 20 20 69 6e 6c 69 6e 65 20 69  if]     inline i
0550: 6d 61 67 65 0a 20 20 20 5b 74 61 67 6e 61 6d 65  mage.   [tagname
0560: 5d 20 20 20 20 20 20 20 20 20 20 20 20 2f 69 6e  ]            /in
0570: 66 6f 2f 74 61 67 6e 61 6d 65 0a 20 20 20 5b 77  fo/tagname.   [w
0580: 69 6b 69 70 61 67 65 6e 61 6d 65 5d 20 20 20 20  ikipagename]    
0590: 20 20 20 2f 77 69 6b 69 2f 77 69 6b 69 70 61 67     /wiki/wikipag
05a0: 65 6e 61 6d 65 0a 20 20 20 5b 2f 69 6e 74 65 72  ename.   [/inter
05b0: 6e 61 6c 2f 70 61 67 65 5d 20 20 20 20 20 2f 69  nal/page]     /i
05c0: 6e 74 65 72 6e 61 6c 2f 70 61 67 65 0a 20 20 20  nternal/page.   
05d0: 5b 68 74 74 70 3a 2e 2e 2e 5d 20 20 20 20 20 20  [http:...]      
05e0: 20 20 20 20 20 65 78 74 65 72 6e 61 6c 20 6c 69       external li
05f0: 6e 6b 0a 0a 4d 61 72 6b 75 70 3a 0a 0a 20 20 20  nk..Markup:..   
0600: 62 6c 61 6e 6b 2d 6c 69 6e 65 20 20 20 20 20 20  blank-line      
0610: 20 20 20 20 20 70 61 72 61 67 72 61 70 68 20 62       paragraph b
0620: 72 65 61 6b 0a 20 20 20 5f 2a 5f 5f 20 20 20 20  reak.   _*__    
0630: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 75 6c               bul
0640: 6c 65 74 0a 20 20 20 5f 5f 20 20 20 20 20 20 20  let.   __       
0650: 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 64 65              inde
0660: 6e 74 61 74 69 6f 6e 0a 20 20 20 5f 23 2e 5f 5f  ntation.   _#.__
0670: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0680: 65 6e 75 6d 65 72 61 74 69 6f 6e 0a 20 20 20 2a  enumeration.   *
0690: 74 65 78 74 2a 20 20 20 20 20 20 20 20 20 20 20  text*           
06a0: 20 20 20 20 62 6f 6c 64 0a 20 20 20 5f 74 65 78      bold.   _tex
06b0: 74 5f 20 20 20 20 20 20 20 20 20 20 20 20 20 20  t_              
06c0: 20 69 74 61 6c 69 63 0a 0a 0a 2d 2d 2d 2d 2d 2d   italic...------
06d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
06e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
06f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0700: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0710: 2d 2d 0a 0a 52 61 6e 64 6f 6d 20 74 68 6f 75 67  --..Random thoug
0720: 68 74 73 3a 0a 0a 20 20 2a 20 50 6c 69 6e 6b 2e  hts:..  * Plink.
0730: 69 73 70 72 69 6d 20 63 68 61 6e 67 65 64 20 74  isprim changed t
0740: 6f 20 72 65 63 6f 72 64 3a 0a 20 20 20 20 20 2b  o record:.     +
0750: 20 20 63 68 69 6c 64 20 69 73 20 74 68 65 20 70    child is the p
0760: 72 69 6e 63 69 70 61 6c 20 64 65 73 63 65 6e 64  rincipal descend
0770: 65 6e 74 20 6f 66 20 70 61 72 65 6e 74 2e 20 28  ent of parent. (
0780: 31 29 0a 20 20 20 20 20 2b 20 20 63 68 69 6c 64  1).     +  child
0790: 20 69 73 20 61 20 62 72 61 6e 63 68 20 66 72 6f   is a branch fro
07a0: 6d 20 70 61 72 65 6e 74 20 28 32 29 0a 20 20 20  m parent (2).   
07b0: 20 20 2b 20 20 63 68 69 6c 64 20 75 73 65 73 20    +  child uses 
07c0: 70 61 72 65 6e 74 20 61 73 20 61 20 6d 65 72 67  parent as a merg
07d0: 65 20 28 30 29 0a 0a 20 20 2a 20 77 65 62 73 69  e (0)..  * websi
07e0: 74 65 20 63 61 6e 20 74 6f 67 67 6c 65 20 69 73  te can toggle is
07f0: 70 72 69 6d 20 62 65 74 77 65 65 6e 20 70 72 69  prim between pri
0800: 6e 63 69 70 61 6c 20 61 6e 64 20 62 72 61 6e 63  ncipal and branc
0810: 68 2e 0a 20 20 20 20 20 2b 20 48 6f 77 20 74 6f  h..     + How to
0820: 20 70 72 65 73 65 72 76 65 20 61 63 72 6f 73 73   preserve across
0830: 20 72 65 62 75 69 6c 64 2e 20 20 41 20 6e 65 77   rebuild.  A new
0840: 20 72 65 63 6f 72 64 20 74 79 70 65 3f 0a 20 20   record type?.  
0850: 20 20 20 2b 20 48 6f 77 20 74 6f 20 73 68 61 72     + How to shar
0860: 65 20 77 69 74 68 20 6f 74 68 65 72 20 72 65 70  e with other rep
0870: 6f 73 69 74 6f 72 69 65 73 0a 20 20 2a 20 69 73  ositories.  * is
0880: 70 72 69 6d 20 67 75 65 73 73 65 64 20 75 73 69  prim guessed usi
0890: 6e 67 20 75 73 65 72 69 64 20 6f 66 20 70 61 72  ng userid of par
08a0: 65 6e 74 20 61 6e 64 20 63 68 69 6c 64 2e 20 20  ent and child.  
08b0: 43 68 61 6e 67 65 0a 20 20 20 20 69 6e 20 69 64  Change.    in id
08c0: 20 73 75 67 67 65 73 74 73 20 61 20 62 72 61 6e   suggests a bran
08d0: 63 68 2e 20 20 53 61 6d 65 20 69 64 20 73 75 67  ch.  Same id sug
08e0: 67 65 73 74 73 20 70 72 69 6e 63 69 70 61 6c 2e  gests principal.
08f0: 0a 20 20 20 20 46 6f 72 20 61 20 74 69 65 2c 20  .    For a tie, 
0900: 67 6f 20 77 69 74 68 20 74 68 65 20 65 61 72 6c  go with the earl
0910: 69 65 73 74 20 63 68 65 63 6b 2d 69 6e 20 61 73  iest check-in as
0920: 20 74 68 65 20 70 72 69 6e 63 69 70 61 6c 27 0a   the principal'.
0930: 0a 20 20 2a 20 41 75 74 6f 73 79 6e 63 20 6d 6f  .  * Autosync mo
0940: 64 65 0a 20 20 20 20 20 2a 20 4e 6f 74 65 73 3a  de.     * Notes:
0950: 0a 20 20 20 20 20 20 20 2b 20 44 65 73 69 67 6e  .       + Design
0960: 65 64 20 74 6f 20 61 76 6f 69 64 20 62 72 61 6e  ed to avoid bran
0970: 63 68 69 6e 67 20 69 6e 20 68 69 67 68 6c 79 20  ching in highly 
0980: 63 6f 6c 6c 61 62 6f 72 61 74 69 76 65 20 0a 20  collaborative . 
0990: 20 20 20 20 20 20 20 20 65 6e 76 69 72 6f 6e 6d          environm
09a0: 65 6e 74 73 2e 0a 20 20 20 20 20 2a 20 4f 75 74  ents..     * Out
09b0: 73 74 61 6e 64 69 6e 67 3a 0a 20 20 20 20 20 20  standing:.      
09c0: 20 2b 20 4f 6e 20 63 6f 6d 6d 69 74 2c 20 66 69   + On commit, fi
09d0: 72 73 74 20 70 75 6c 6c 2e 20 20 49 66 20 63 6f  rst pull.  If co
09e0: 6d 6d 69 74 20 62 61 73 65 6c 69 6e 65 20 69 73  mmit baseline is
09f0: 20 6e 6f 74 20 61 20 74 69 70 0a 20 20 20 20 20   not a tip.     
0a00: 20 20 20 20 70 72 6f 6d 70 74 20 75 73 65 72 20      prompt user 
0a10: 74 6f 20 63 61 6e 63 65 6c 20 6f 72 20 62 72 61  to cancel or bra
0a20: 6e 63 68 2e 20 20 44 65 66 61 75 6c 74 20 69 73  nch.  Default is
0a30: 20 63 61 6e 63 65 6c 2e 0a 20 20 20 20 20 20 20   cancel..       
0a40: 2b 20 4e 65 65 64 20 61 6e 20 22 75 6e 64 6f 22  + Need an "undo"
0a50: 20 63 61 70 61 62 69 6c 69 74 79 0a 20 20 20 20   capability.    
0a60: 20 2a 20 44 6f 6e 65 3a 0a 20 20 20 20 20 20 20   * Done:.       
0a70: 2a 20 53 65 74 20 61 20 70 72 65 66 65 72 72 65  * Set a preferre
0a80: 64 20 72 65 6d 6f 74 65 20 72 65 70 6f 73 69 74  d remote reposit
0a90: 6f 72 79 20 74 6f 20 75 73 65 20 61 73 20 61 20  ory to use as a 
0aa0: 73 65 72 76 65 72 0a 20 20 20 20 20 20 20 20 20  server.         
0ab0: 20 3d 20 20 43 6c 6f 6e 65 20 72 65 70 6f 73 69   =  Clone reposi
0ac0: 74 6f 72 79 20 69 73 20 74 68 65 20 64 65 66 61  tory is the defa
0ad0: 75 6c 74 0a 20 20 20 20 20 20 20 2a 20 50 75 73  ult.       * Pus
0ae0: 68 20 61 66 74 65 72 20 63 6f 6d 6d 69 74 0a 20  h after commit. 
0af0: 20 20 20 20 20 20 2a 20 41 75 74 6f 6d 61 74 69        * Automati
0b00: 63 61 6c 6c 79 20 70 75 6c 6c 20 70 72 69 6f 72  cally pull prior
0b10: 20 74 6f 20 75 70 64 61 74 65 2e 0a 0a 20 20 2a   to update...  *
0b20: 20 41 72 63 68 65 6f 6c 6f 67 69 63 61 6c 20 77   Archeological w
0b30: 65 62 70 61 67 65 20 69 6d 70 72 6f 76 65 6d 65  ebpage improveme
0b40: 6e 74 73 3a 0a 20 20 20 20 20 2b 20 55 73 65 20  nts:.     + Use 
0b50: 61 20 73 6d 61 6c 6c 20 61 6d 6f 75 6e 74 20 6f  a small amount o
0b60: 66 20 43 53 53 2b 6a 61 76 61 73 63 72 69 70 74  f CSS+javascript
0b70: 20 6f 6e 20 74 69 6d 65 6c 69 6e 65 73 20 73 6f   on timelines so
0b80: 20 74 68 61 74 0a 20 20 20 20 20 20 20 62 72 61   that.       bra
0b90: 6e 63 68 69 6e 67 20 73 74 72 75 63 74 75 72 65  nching structure
0ba0: 20 69 73 20 64 69 73 70 6c 61 79 65 64 20 6f 6e   is displayed on
0bb0: 20 6d 6f 75 73 65 6f 76 65 72 2e 20 20 4f 6e 20   mouseover.  On 
0bc0: 6d 6f 75 73 65 6f 76 65 72 0a 20 20 20 20 20 20  mouseover.      
0bd0: 20 6f 66 20 61 20 63 68 65 63 6b 69 6e 2c 20 68   of a checkin, h
0be0: 69 67 68 6c 69 67 68 74 20 6f 74 68 65 72 20 63  ighlight other c
0bf0: 68 65 63 6b 69 6e 73 20 74 68 61 74 20 61 72 65  heckins that are
0c00: 20 64 69 72 65 63 74 20 28 6e 6f 6e 2d 6d 65 72   direct (non-mer
0c10: 67 65 29 0a 20 20 20 20 20 20 20 64 65 73 63 65  ge).       desce
0c20: 6e 64 65 6e 74 73 20 61 6e 64 20 61 6e 63 65 73  ndents and ances
0c30: 74 6f 72 73 20 6f 66 20 74 68 65 20 6d 6f 75 73  tors of the mous
0c40: 65 6f 76 65 72 20 63 68 65 63 6b 69 6e 2e 0a 20  eover checkin.. 
0c50: 20 20 20 20 2b 20 54 69 6d 65 6c 69 6e 65 20 73      + Timeline s
0c60: 68 6f 77 69 6e 67 20 69 6e 64 69 76 69 64 75 61  howing individua
0c70: 6c 20 62 72 61 6e 63 68 65 73 0a 20 20 20 20 20  l branches.     
0c80: 2b 20 54 69 6d 65 6c 69 6e 65 20 73 68 6f 77 73  + Timeline shows
0c90: 20 66 6f 72 6b 73 20 61 6e 64 20 6d 65 72 67 65   forks and merge
0ca0: 73 0a 20 20 20 20 20 2b 20 54 61 67 73 20 73 68  s.     + Tags sh
0cb0: 6f 77 6e 20 6f 6e 20 74 69 6d 65 6c 69 6e 65 20  own on timeline 
0cc0: 28 6d 61 79 62 65 29 20 61 6e 64 20 69 6e 20 76  (maybe) and in v
0cd0: 69 6e 66 6f 20 28 73 75 72 65 6c 79 29 2e 0a 0a  info (surely)...
0ce0: 46 65 61 74 75 72 65 73 20 6e 65 65 64 65 64 3a  Features needed:
0cf0: 0a 20 20 2a 20 4d 65 61 6e 73 20 74 6f 20 73 75  .  * Means to su
0d00: 70 70 72 65 73 73 20 61 72 74 69 66 61 63 74 73  ppress artifacts
0d10: 0a 20 20 2a 20 4d 65 61 6e 73 20 74 6f 20 63 61  .  * Means to ca
0d20: 70 20 61 20 62 72 61 6e 63 68 0a 20 20 2a 20 54  p a branch.  * T
0d30: 69 63 6b 65 74 69 6e 67 0a 20 20 20 20 20 2b 20  icketing.     + 
0d40: 20 50 72 6f 62 6c 65 6d 20 69 73 2f 69 73 2d 6e   Problem is/is-n
0d50: 6f 74 20 65 78 70 72 65 73 73 65 64 20 69 6e 20  ot expressed in 
0d60: 62 61 73 65 6c 69 6e 65 20 58 2e 0a 20 20 20 20  baseline X..    
0d70: 20 2b 20 20 41 70 70 65 6e 64 20 63 6f 6d 6d 65   +  Append comme
0d80: 6e 74 20 61 6e 64 20 7a 65 72 6f 20 6f 72 20 6d  nt and zero or m
0d90: 6f 72 65 20 61 74 74 61 63 68 6d 65 6e 74 73 0a  ore attachments.
0da0: 20 20 2a 20 4d 6f 64 69 66 79 20 63 6f 6d 6d 65    * Modify comme
0db0: 6e 74 73 20 6f 6e 20 62 61 73 65 6c 69 6e 65 73  nts on baselines
0dc0: 0a 20 20 2a 20 41 70 70 65 6e 64 20 63 6f 6d 6d  .  * Append comm
0dd0: 65 6e 74 73 20 74 6f 20 61 6e 79 20 61 72 74 69  ents to any arti
0de0: 66 61 63 74 0a 20 20 2a 20 57 69 6b 69 3f 0a 0a  fact.  * Wiki?..
0df0: 20 20 0a 0a 45 78 74 65 6e 64 65 64 20 6d 61 6e    ..Extended man
0e00: 69 66 65 73 74 73 2e 0a 20 20 2a 20 6e 6f 72 6d  ifests..  * norm
0e10: 61 6c 20 6d 61 6e 69 66 65 73 74 20 68 61 73 3a  al manifest has:
0e20: 0a 20 20 20 20 20 20 20 43 20 63 6f 6d 6d 65 6e  .       C commen
0e30: 74 0a 20 20 20 20 20 20 20 44 20 64 61 74 65 2d  t.       D date-
0e40: 74 69 6d 65 0a 20 20 20 20 20 20 20 46 2a 20 66  time.       F* f
0e50: 69 6c 65 6e 61 6d 65 20 75 75 69 64 0a 20 20 20  ilename uuid.   
0e60: 20 20 20 20 50 20 75 75 69 64 20 2e 2e 2e 20 20      P uuid ...  
0e70: 20 20 20 20 20 20 20 20 20 2d 2d 20 6f 6d 69 74           -- omit
0e80: 74 65 64 20 66 6f 72 20 66 69 72 73 74 20 6d 61  ted for first ma
0e90: 6e 69 66 65 73 74 0a 20 20 20 20 20 20 20 52 20  nifest.       R 
0ea0: 72 65 70 6f 73 69 74 6f 72 79 2d 6d 64 35 73 75  repository-md5su
0eb0: 6d 0a 20 20 20 20 20 20 20 55 20 75 73 65 72 2d  m.       U user-
0ec0: 6c 6f 67 69 6e 0a 20 20 20 20 20 20 20 5a 20 6d  login.       Z m
0ed0: 61 6e 69 66 65 73 74 2d 63 68 65 63 6b 73 75 6d  anifest-checksum
0ee0: 0a 0a 20 20 2a 20 41 63 63 65 73 73 6f 72 79 3a  ..  * Accessory:
0ef0: 0a 20 20 20 20 20 20 20 41 20 75 75 69 64 7c 2a  .       A uuid|*
0f00: 20 61 74 74 61 63 68 6d 65 6e 74 2d 75 75 69 64   attachment-uuid
0f10: 20 64 65 73 63 72 69 70 74 69 6f 6e 0a 20 20 20   description.   
0f20: 20 20 20 20 44 20 64 61 74 65 2d 74 69 6d 65 0a      D date-time.
0f30: 20 20 20 20 20 20 20 45 20 75 75 69 64 20 6e 65         E uuid ne
0f40: 77 2d 63 6f 6d 6d 65 6e 74 0a 20 20 20 20 20 20  w-comment.      
0f50: 20 47 20 75 75 69 64 20 61 70 70 65 6e 64 65 64   G uuid appended
0f60: 2d 72 65 6d 61 72 6b 0a 20 20 20 20 20 20 20 53  -remark.       S
0f70: 20 72 65 70 6f 73 69 74 6f 72 79 69 64 20 73 65   repositoryid se
0f80: 72 69 61 6c 2d 6e 75 6d 62 65 72 0a 20 20 20 20  rial-number.    
0f90: 20 20 20 54 20 28 2b 7c 2d 29 74 61 67 20 75 75     T (+|-)tag uu
0fa0: 69 64 0a 20 20 20 20 20 20 20 55 20 75 73 65 72  id.       U user
0fb0: 69 64 0a 20 20 20 20 20 20 20 58 20 75 75 69 64  id.       X uuid
0fc0: 2d 74 6f 2d 73 75 72 70 72 65 73 73 0a 20 20 20  -to-surpress.   
0fd0: 20 20 20 20 5a 20 74 68 69 73 2d 66 69 6c 65 2d      Z this-file-
0fe0: 63 68 65 63 6b 73 75 6d 0a 0a 20 20 2a 20 43 68  checksum..  * Ch
0ff0: 61 6e 67 65 20 74 68 65 20 63 6f 6d 6d 65 6e 74  ange the comment
1000: 20 6f 6e 20 61 20 76 65 72 73 69 6f 6e 3a 20 20   on a version:  
1010: 20 2d 2d 20 61 6c 77 61 79 73 20 61 20 6c 65 61   -- always a lea
1020: 66 20 65 78 63 65 70 74 20 69 6e 20 63 6c 75 73  f except in clus
1030: 74 65 72 0a 20 20 20 20 20 20 20 44 20 64 61 74  ter.       D dat
1040: 65 2d 74 69 6d 65 0a 20 20 20 20 20 20 20 45 20  e-time.       E 
1050: 6e 65 77 2d 63 6f 6d 6d 65 6e 74 0a 20 20 20 20  new-comment.    
1060: 20 20 20 50 20 75 75 69 64 20 20 20 20 20 20 20     P uuid       
1070: 20 20 20 20 20 20 20 2d 2d 20 62 61 73 65 6c 69         -- baseli
1080: 6e 65 20 77 68 6f 73 65 20 63 6f 6d 6d 65 6e 74  ne whose comment
1090: 20 69 73 20 63 68 61 6e 67 65 64 0a 20 20 20 20   is changed.    
10a0: 20 20 20 55 20 75 73 65 72 2d 6c 6f 67 69 6e 0a     U user-login.
10b0: 20 20 20 20 20 20 20 5a 20 63 68 65 63 6b 73 75         Z checksu
10c0: 6d 0a 20 20 20 20 20 20 20 2d 2d 20 6d 6f 73 74  m.       -- most
10d0: 20 72 65 63 65 6e 74 20 77 69 6e 73 0a 20 20 2a   recent wins.  *
10e0: 20 57 69 6b 69 20 65 64 69 74 0a 20 20 20 20 20   Wiki edit.     
10f0: 20 20 41 2a 20 6e 61 6d 65 20 75 75 69 64 20 20    A* name uuid  
1100: 20 2d 2d 20 7a 65 72 6f 20 6f 72 20 6d 6f 72 65   -- zero or more
1110: 20 61 74 74 61 63 68 6d 65 6e 74 73 0a 20 20 20   attachments.   
1120: 20 20 20 20 43 3f 20 63 6f 6d 6d 65 6e 74 0a 20      C? comment. 
1130: 20 20 20 20 20 20 44 20 64 61 74 65 2d 74 69 6d        D date-tim
1140: 65 0a 20 20 20 20 20 20 20 4e 20 6e 61 6d 65 20  e.       N name 
1150: 20 20 20 20 20 20 20 20 2d 2d 20 6e 61 6d 65 20          -- name 
1160: 6f 66 20 74 68 65 20 77 69 6b 69 20 70 61 67 65  of the wiki page
1170: 0a 20 20 20 20 20 20 20 50 20 75 75 69 64 20 2e  .       P uuid .
1180: 2e 2e 20 20 20 20 20 2d 2d 20 6f 6d 69 74 20 66  ..     -- omit f
1190: 6f 72 20 6e 65 77 20 77 69 6b 69 0a 20 20 20 20  or new wiki.    
11a0: 20 20 20 55 20 75 73 65 72 2d 6c 6f 67 69 6e 0a     U user-login.
11b0: 20 20 20 20 20 20 20 57 20 75 75 69 64 20 20 20         W uuid   
11c0: 20 20 20 20 20 20 2d 2d 20 54 68 65 20 63 6f 6e        -- The con
11d0: 74 65 6e 74 20 66 69 6c 65 0a 20 20 20 20 20 20  tent file.      
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 2a 20 54 69 63 6b 65 74 20 65 64 69  m.  * Ticket edi
1200: 74 0a 20 20 20 20 20 20 20 41 2a 20 6e 61 6d 65  t.       A* name
1210: 20 75 75 69 64 20 20 20 2d 2d 20 7a 65 72 6f 20   uuid   -- zero 
1220: 6f 72 20 6d 6f 72 65 20 61 74 74 61 63 68 6d 65  or more attachme
1230: 6e 74 73 0a 20 20 20 20 20 20 20 44 20 64 61 74  nts.       D dat
1240: 65 2d 74 69 6d 65 0a 20 20 20 20 20 20 20 4e 20  e-time.       N 
1250: 6e 61 6d 65 20 20 20 20 20 20 20 20 20 2d 2d 20  name         -- 
1260: 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 69 63 6b  name of the tick
1270: 65 74 0a 20 20 20 20 20 20 20 50 20 75 75 69 64  et.       P uuid
1280: 20 20 20 20 20 20 20 20 20 2d 2d 20 6f 6d 69 74           -- omit
1290: 20 66 6f 72 20 6e 65 77 20 74 69 63 6b 65 74 0a   for new ticket.
12a0: 20 20 20 20 20 20 20 54 20 75 75 69 64 20 20 20         T uuid   
12b0: 20 20 20 20 20 20 2d 2d 20 63 6f 6e 74 65 6e 74        -- content
12c0: 20 6f 66 20 74 68 65 20 74 69 63 6b 65 74 0a 20   of the ticket. 
12d0: 20 20 20 20 20 20 55 20 75 73 65 72 2d 6c 6f 67        U user-log
12e0: 69 6e 0a 20 20 20 20 20 20 20 5a 20 6d 61 6e 69  in.       Z mani
12f0: 66 65 73 74 2d 63 6b 73 75 6d 0a 20 20 2a 20 53  fest-cksum.  * S
1300: 65 74 20 6f 72 20 65 72 61 73 65 20 61 20 74 61  et or erase a ta
1310: 67 20 20 20 20 2d 2d 20 6d 6f 73 74 20 72 65 63  g    -- most rec
1320: 65 6e 74 20 64 61 74 65 20 77 69 6e 73 0a 20 20  ent date wins.  
1330: 20 20 20 20 20 42 2a 20 28 2b 7c 2d 29 74 61 67       B* (+|-)tag
1340: 20 75 75 69 64 0a 20 20 20 20 20 20 20 43 3f 20   uuid.       C? 
1350: 63 6f 6d 6d 65 6e 74 0a 20 20 20 20 20 20 20 44  comment.       D
1360: 20 64 61 74 65 2d 74 69 6d 65 0a 20 20 20 20 20   date-time.     
1370: 20 20 56 2a 20 28 2b 7c 2d 29 20 74 61 67 20 75    V* (+|-) tag u
1380: 75 69 64 20 20 20 20 2d 2d 20 2b 20 74 6f 20 73  uid    -- + to s
1390: 65 74 2c 20 2d 20 74 6f 20 63 6c 65 61 72 2e 20  et, - to clear. 
13a0: 20 0a 20 20 20 20 20 20 20 5a 20 6d 61 6e 69 66   .       Z manif
13b0: 65 73 74 2d 63 6b 73 75 6d 0a 20 20 20 20 20 20  est-cksum.      
13c0: 20 2d 2d 20 4d 75 73 74 20 68 61 76 65 20 61 74   -- Must have at
13d0: 20 6c 65 61 73 74 20 6f 6e 65 20 42 20 6f 72 20   least one B or 
13e0: 56 2e 0a 20 20 20 20 20 20 20 2d 2d 20 42 72 61  V..       -- Bra
13f0: 6e 63 68 20 74 61 67 20 22 68 69 64 64 65 6e 22  nch tag "hidden"
1400: 20 6d 65 61 6e 73 20 64 6f 20 6e 6f 74 20 73 79   means do not sy
1410: 6e 63 0a 20 20 20 20 20 20 20 2d 2d 20 56 65 72  nc.       -- Ver
1420: 73 69 6f 6e 20 74 61 67 20 22 63 6c 6f 73 65 64  sion tag "closed
1430: 22 20 6d 65 61 6e 73 20 64 6f 20 6e 6f 74 20 64  " means do not d
1440: 69 73 70 6c 61 79 20 61 73 20 61 20 6c 65 61 66  isplay as a leaf
1450: 0a 20 20 2a 20 41 20 63 6c 75 73 74 65 72 0a 20  .  * A cluster. 
1460: 20 20 20 20 20 20 4d 2b 20 75 75 69 64 0a 20 20        M+ uuid.  
1470: 20 20 20 20 20 5a 20 6d 61 6e 69 66 65 73 74 2d       Z manifest-
1480: 63 6b 73 75 6d 0a 0a 20 20 2a 20 43 6f 6d 70 6c  cksum..  * Compl
1490: 65 74 65 20 73 65 74 20 6f 66 20 63 61 72 64 73  ete set of cards
14a0: 20 69 6e 20 61 20 63 6f 6e 74 72 6f 6c 20 66 69   in a control fi
14b0: 6c 65 3a 0a 20 20 20 20 20 20 20 41 20 66 69 6c  le:.       A fil
14c0: 65 6e 61 6d 65 20 75 75 69 64 20 20 20 20 20 20  ename uuid      
14d0: 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 42         .       B
14e0: 20 28 2b 7c 2d 29 62 72 61 6e 63 68 2d 74 61 67   (+|-)branch-tag
14f0: 20 75 75 69 64 20 20 20 20 20 20 0a 20 20 20 20   uuid      .    
1500: 20 20 20 43 20 63 6f 6d 6d 65 6e 74 20 20 20 20     C comment    
1510: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0a                 .
1520: 20 20 20 20 20 20 20 44 20 64 61 74 65 2d 74 69         D date-ti
1530: 6d 65 20 20 20 20 20 20 20 20 20 20 20 20 20 20  me              
1540: 20 20 20 0a 20 20 20 20 20 20 20 45 20 75 75 69     .       E uui
1550: 64 20 65 64 69 74 65 64 2d 63 6f 6d 6d 65 6e 74  d edited-comment
1560: 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 46         .       F
1570: 20 66 69 6c 65 6e 61 6d 65 20 75 75 69 64 20 20   filename uuid  
1580: 20 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 20             .    
1590: 20 20 20 4d 20 75 75 69 64 20 20 20 20 20 20 20     M uuid       
15a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0a                 .
15b0: 20 20 20 20 20 20 20 4e 20 6e 61 6d 65 20 20 20         N name   
15c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
15d0: 20 20 20 0a 20 20 20 20 20 20 20 50 20 75 75 69     .       P uui
15e0: 64 20 2e 2e 2e 20 20 20 20 20 20 20 20 20 20 20  d ...           
15f0: 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 52         .       R
1600: 20 72 65 70 6f 73 69 74 6f 72 79 2d 6d 64 35 73   repository-md5s
1610: 75 6d 20 20 20 20 20 20 20 20 20 0a 20 20 20 20  um         .    
1620: 20 20 20 54 20 75 75 69 64 20 20 20 20 20 20 20     T uuid       
1630: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0a                 .
1640: 20 20 20 20 20 20 20 55 20 75 73 65 72 2d 6c 6f         U user-lo
1650: 67 69 6e 20 20 20 20 20 20 20 20 20 20 20 20 20  gin             
1660: 20 20 20 0a 20 20 20 20 20 20 20 56 20 28 2b 7c     .       V (+|
1670: 2d 29 76 65 72 73 69 6f 6e 2d 74 61 67 20 75 75  -)version-tag uu
1680: 69 64 20 20 20 20 20 0a 20 20 20 20 20 20 20 57  id     .       W
1690: 20 75 75 69 64 20 20 20 20 20 20 20 20 20 20 20   uuid           
16a0: 20 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 20             .    
16b0: 20 20 20 5a 20 6d 61 6e 69 66 65 73 74 2d 63 68     Z manifest-ch
16c0: 65 63 6b 73 75 6d 0a                             ecksum.