Hex Artifact Content
Not logged in

Artifact df889dde5c2a17ced86b45bcc50f0e4b55f2eb8b:

File ideas.txt part of check-in [134e2aeccc] - Combine the "config" and "setting" commands into a single "settings" command. by drh on 2007-09-28 20:08:32.

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 0a 0a 46 69 65 6c 64 20 54 79  hange...Field Ty
0290: 70 65 73 3a 0a 0a 20 20 20 74 65 78 74 20 20 20  pes:..   text   
02a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 77 69                wi
02b0: 64 74 68 20 68 65 69 67 68 74 0a 20 20 20 65 6e  dth height.   en
02c0: 75 6d 20 20 20 20 20 20 20 20 20 20 20 20 20 20  um              
02d0: 20 20 20 77 69 64 74 68 20 76 61 6c 75 65 6c 69     width valueli
02e0: 73 74 0a 20 20 20 64 61 74 65 74 69 6d 65 20 20  st.   datetime  
02f0: 20 20 20 20 20 20 20 20 20 20 20 77 69 64 74 68             width
0300: 0a 20 20 20 63 75 6d 75 6c 61 74 69 76 65 2d 74  .   cumulative-t
0310: 65 78 74 20 20 20 20 20 20 77 69 64 74 68 20 68  ext      width h
0320: 65 69 67 68 74 0a 20 20 20 73 65 74 2d 6f 66 2d  eight.   set-of-
0330: 75 75 69 64 20 20 20 20 20 20 20 20 20 20 77 69  uuid          wi
0340: 64 74 68 0a 20 20 20 73 65 74 2d 6f 66 2d 63 68  dth.   set-of-ch
0350: 65 63 6b 69 6e 20 20 20 20 20 20 20 77 69 64 74  eckin       widt
0360: 68 0a 0a 54 61 62 6c 65 73 3a 0a 0a 20 20 20 74  h..Tables:..   t
0370: 6b 74 72 69 64 28 72 69 64 2c 20 74 6b 69 64 2c  ktrid(rid, tkid,
0380: 20 6d 74 69 6d 65 29 3b 20 20 69 6e 64 65 78 28   mtime);  index(
0390: 74 6b 69 64 2c 20 6d 74 69 6d 65 29 3b 0a 20 20  tkid, mtime);.  
03a0: 20 74 69 63 6b 65 74 28 74 6b 69 64 2c 20 74 6b   ticket(tkid, tk
03b0: 75 75 69 64 2c 20 74 69 74 6c 65 2c 20 63 6f 6d  uuid, title, com
03c0: 2c 20 73 74 61 74 75 73 2c 20 2e 2e 2e 29 3b 0a  , status, ...);.
03d0: 20 20 20 74 6b 74 66 69 65 6c 64 28 6e 61 6d 65     tktfield(name
03e0: 2c 20 74 79 70 65 2c 20 77 69 64 74 68 2c 20 68  , type, width, h
03f0: 65 69 67 68 74 2c 20 64 65 66 61 75 6c 74 2c 20  eight, default, 
0400: 76 61 6c 75 65 6c 69 73 74 29 3b 0a 20 20 20 74  valuelist);.   t
0410: 6b 74 78 72 65 66 28 74 6b 69 64 2c 20 6d 69 64  ktxref(tkid, mid
0420: 29 3b 20 69 6e 64 65 78 28 74 6b 69 64 29 3b 20  ); index(tkid); 
0430: 69 6e 64 65 78 28 6d 69 64 29 3b 0a 0a 54 6b 74  index(mid);..Tkt
0440: 66 6f 72 6d 61 74 20 69 6e 20 74 68 65 20 63 6f  format in the co
0450: 6e 66 69 67 20 74 61 62 6c 65 2e 0a 0a 20 20 20  nfig table...   
0460: 2a 20 54 68 72 65 65 20 70 61 67 65 73 3a 20 20  * Three pages:  
0470: 63 72 65 61 74 69 6f 6e 2c 20 64 69 73 70 6c 61  creation, displa
0480: 79 2c 20 61 6e 64 20 65 64 69 74 0a 20 20 20 2a  y, and edit.   *
0490: 20 48 54 4d 4c 0a 20 20 20 2a 20 5b 5b 66 69 65   HTML.   * [[fie
04a0: 6c 64 5d 5d 20 74 6f 20 73 75 62 73 74 69 74 75  ld]] to substitu
04b0: 74 65 20 74 68 65 20 61 70 70 72 6f 70 72 69 61  te the appropria
04c0: 74 65 20 66 6f 72 6d 20 6f 72 20 64 69 73 70 6c  te form or displ
04d0: 61 79 20 65 6c 65 6d 65 6e 74 0a 0a 2d 2d 2d 2d  ay element..----
04e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
04f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0500: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0510: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0520: 2d 2d 2d 2d 0a 43 68 61 6e 67 65 20 74 6f 20 77  ----.Change to w
0530: 69 6b 69 3a 0a 0a 20 20 20 41 20 75 75 69 64 20  iki:..   A uuid 
0540: 66 69 6c 65 6e 61 6d 65 20 64 65 73 63 72 69 70  filename descrip
0550: 74 69 6f 6e 0a 20 20 20 44 20 64 61 74 65 74 69  tion.   D dateti
0560: 6d 65 0a 20 20 20 50 20 75 75 69 64 20 2e 2e 2e  me.   P uuid ...
0570: 0a 20 20 20 55 20 75 73 65 72 0a 20 20 20 57 20  .   U user.   W 
0580: 77 69 6b 69 70 61 67 65 6e 61 6d 65 20 75 75 69  wikipagename uui
0590: 64 0a 20 20 20 5a 20 6d 64 35 73 75 6d 0a 0a 4f  d.   Z md5sum..O
05a0: 6e 20 70 61 67 65 3a 0a 0a 20 20 20 3c 74 69 74  n page:..   <tit
05b0: 6c 65 3e 2e 2e 2e 2e 3c 2f 74 69 74 6c 65 3e 0a  le>....</title>.
05c0: 20 20 20 3c 72 65 61 64 6f 6e 6c 79 2f 3e 0a 0a     <readonly/>..
05d0: 48 79 70 65 72 6c 69 6e 6b 73 3a 0a 0a 20 20 20  Hyperlinks:..   
05e0: 5b 6c 6f 77 65 72 63 61 73 65 68 65 78 5d 20 20  [lowercasehex]  
05f0: 20 20 20 20 20 2f 69 6e 66 6f 2f 6c 6f 77 65 72       /info/lower
0600: 63 61 73 65 68 65 78 0a 20 20 20 5b 61 74 74 61  casehex.   [atta
0610: 63 68 6d 65 6e 74 2e 67 69 66 5d 20 20 20 20 20  chment.gif]     
0620: 69 6e 6c 69 6e 65 20 69 6d 61 67 65 0a 20 20 20  inline image.   
0630: 5b 74 61 67 6e 61 6d 65 5d 20 20 20 20 20 20 20  [tagname]       
0640: 20 20 20 20 20 2f 69 6e 66 6f 2f 74 61 67 6e 61       /info/tagna
0650: 6d 65 0a 20 20 20 5b 77 69 6b 69 70 61 67 65 6e  me.   [wikipagen
0660: 61 6d 65 5d 20 20 20 20 20 20 20 2f 77 69 6b 69  ame]       /wiki
0670: 2f 77 69 6b 69 70 61 67 65 6e 61 6d 65 0a 20 20  /wikipagename.  
0680: 20 5b 2f 69 6e 74 65 72 6e 61 6c 2f 70 61 67 65   [/internal/page
0690: 5d 20 20 20 20 20 2f 69 6e 74 65 72 6e 61 6c 2f  ]     /internal/
06a0: 70 61 67 65 0a 20 20 20 5b 68 74 74 70 3a 2e 2e  page.   [http:..
06b0: 2e 5d 20 20 20 20 20 20 20 20 20 20 20 65 78 74  .]           ext
06c0: 65 72 6e 61 6c 20 6c 69 6e 6b 0a 0a 4d 61 72 6b  ernal link..Mark
06d0: 75 70 3a 0a 0a 20 20 20 62 6c 61 6e 6b 2d 6c 69  up:..   blank-li
06e0: 6e 65 20 20 20 20 20 20 20 20 20 20 20 70 61 72  ne           par
06f0: 61 67 72 61 70 68 20 62 72 65 61 6b 0a 20 20 20  agraph break.   
0700: 5f 2a 5f 5f 20 20 20 20 20 20 20 20 20 20 20 20  _*__            
0710: 20 20 20 20 20 62 75 6c 6c 65 74 0a 20 20 20 5f       bullet.   _
0720: 5f 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  _               
0730: 20 20 20 20 69 6e 64 65 6e 74 61 74 69 6f 6e 0a      indentation.
0740: 20 20 20 5f 23 2e 5f 5f 20 20 20 20 20 20 20 20     _#.__        
0750: 20 20 20 20 20 20 20 20 65 6e 75 6d 65 72 61 74          enumerat
0760: 69 6f 6e 0a 20 20 20 2a 74 65 78 74 2a 20 20 20  ion.   *text*   
0770: 20 20 20 20 20 20 20 20 20 20 20 20 62 6f 6c 64              bold
0780: 0a 20 20 20 5f 74 65 78 74 5f 20 20 20 20 20 20  .   _text_      
0790: 20 20 20 20 20 20 20 20 20 69 74 61 6c 69 63 0a           italic.
07a0: 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ..--------------
07b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
07c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
07d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
07e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 52 61 6e 64  ----------..Rand
07f0: 6f 6d 20 74 68 6f 75 67 68 74 73 3a 0a 0a 20 20  om thoughts:..  
0800: 2a 20 50 6c 69 6e 6b 2e 69 73 70 72 69 6d 20 63  * Plink.isprim c
0810: 68 61 6e 67 65 64 20 74 6f 20 72 65 63 6f 72 64  hanged to record
0820: 3a 0a 20 20 20 20 20 2b 20 20 63 68 69 6c 64 20  :.     +  child 
0830: 69 73 20 74 68 65 20 70 72 69 6e 63 69 70 61 6c  is the principal
0840: 20 64 65 73 63 65 6e 64 65 6e 74 20 6f 66 20 70   descendent of p
0850: 61 72 65 6e 74 2e 20 28 31 29 0a 20 20 20 20 20  arent. (1).     
0860: 2b 20 20 63 68 69 6c 64 20 69 73 20 61 20 62 72  +  child is a br
0870: 61 6e 63 68 20 66 72 6f 6d 20 70 61 72 65 6e 74  anch from parent
0880: 20 28 32 29 0a 20 20 20 20 20 2b 20 20 63 68 69   (2).     +  chi
0890: 6c 64 20 75 73 65 73 20 70 61 72 65 6e 74 20 61  ld uses parent a
08a0: 73 20 61 20 6d 65 72 67 65 20 28 30 29 0a 0a 20  s a merge (0).. 
08b0: 20 2a 20 77 65 62 73 69 74 65 20 63 61 6e 20 74   * website can t
08c0: 6f 67 67 6c 65 20 69 73 70 72 69 6d 20 62 65 74  oggle isprim bet
08d0: 77 65 65 6e 20 70 72 69 6e 63 69 70 61 6c 20 61  ween principal a
08e0: 6e 64 20 62 72 61 6e 63 68 2e 0a 20 20 20 20 20  nd branch..     
08f0: 2b 20 48 6f 77 20 74 6f 20 70 72 65 73 65 72 76  + How to preserv
0900: 65 20 61 63 72 6f 73 73 20 72 65 62 75 69 6c 64  e across rebuild
0910: 2e 20 20 41 20 6e 65 77 20 72 65 63 6f 72 64 20  .  A new record 
0920: 74 79 70 65 3f 0a 20 20 20 20 20 2b 20 48 6f 77  type?.     + How
0930: 20 74 6f 20 73 68 61 72 65 20 77 69 74 68 20 6f   to share with o
0940: 74 68 65 72 20 72 65 70 6f 73 69 74 6f 72 69 65  ther repositorie
0950: 73 0a 20 20 2a 20 69 73 70 72 69 6d 20 67 75 65  s.  * isprim gue
0960: 73 73 65 64 20 75 73 69 6e 67 20 75 73 65 72 69  ssed using useri
0970: 64 20 6f 66 20 70 61 72 65 6e 74 20 61 6e 64 20  d of parent and 
0980: 63 68 69 6c 64 2e 20 20 43 68 61 6e 67 65 0a 20  child.  Change. 
0990: 20 20 20 69 6e 20 69 64 20 73 75 67 67 65 73 74     in id suggest
09a0: 73 20 61 20 62 72 61 6e 63 68 2e 20 20 53 61 6d  s a branch.  Sam
09b0: 65 20 69 64 20 73 75 67 67 65 73 74 73 20 70 72  e id suggests pr
09c0: 69 6e 63 69 70 61 6c 2e 0a 20 20 20 20 46 6f 72  incipal..    For
09d0: 20 61 20 74 69 65 2c 20 67 6f 20 77 69 74 68 20   a tie, go with 
09e0: 74 68 65 20 65 61 72 6c 69 65 73 74 20 63 68 65  the earliest che
09f0: 63 6b 2d 69 6e 20 61 73 20 74 68 65 20 70 72 69  ck-in as the pri
0a00: 6e 63 69 70 61 6c 27 0a 0a 20 20 2a 20 41 75 74  ncipal'..  * Aut
0a10: 6f 73 79 6e 63 20 6d 6f 64 65 0a 20 20 20 20 20  osync mode.     
0a20: 2a 20 4e 6f 74 65 73 3a 0a 20 20 20 20 20 20 20  * Notes:.       
0a30: 2b 20 44 65 73 69 67 6e 65 64 20 74 6f 20 61 76  + Designed to av
0a40: 6f 69 64 20 62 72 61 6e 63 68 69 6e 67 20 69 6e  oid branching in
0a50: 20 68 69 67 68 6c 79 20 63 6f 6c 6c 61 62 6f 72   highly collabor
0a60: 61 74 69 76 65 20 0a 20 20 20 20 20 20 20 20 20  ative .         
0a70: 65 6e 76 69 72 6f 6e 6d 65 6e 74 73 2e 0a 20 20  environments..  
0a80: 20 20 20 2a 20 4f 75 74 73 74 61 6e 64 69 6e 67     * Outstanding
0a90: 3a 0a 20 20 20 20 20 20 20 2b 20 4f 6e 20 63 6f  :.       + On co
0aa0: 6d 6d 69 74 2c 20 66 69 72 73 74 20 70 75 6c 6c  mmit, first pull
0ab0: 2e 20 20 49 66 20 63 6f 6d 6d 69 74 20 62 61 73  .  If commit bas
0ac0: 65 6c 69 6e 65 20 69 73 20 6e 6f 74 20 61 20 74  eline is not a t
0ad0: 69 70 0a 20 20 20 20 20 20 20 20 20 70 72 6f 6d  ip.         prom
0ae0: 70 74 20 75 73 65 72 20 74 6f 20 63 61 6e 63 65  pt user to cance
0af0: 6c 20 6f 72 20 62 72 61 6e 63 68 2e 20 20 44 65  l or branch.  De
0b00: 66 61 75 6c 74 20 69 73 20 63 61 6e 63 65 6c 2e  fault is cancel.
0b10: 0a 20 20 20 20 20 20 20 2b 20 4e 65 65 64 20 61  .       + Need a
0b20: 6e 20 22 75 6e 64 6f 22 20 63 61 70 61 62 69 6c  n "undo" capabil
0b30: 69 74 79 0a 20 20 20 20 20 2a 20 44 6f 6e 65 3a  ity.     * Done:
0b40: 0a 20 20 20 20 20 20 20 2a 20 53 65 74 20 61 20  .       * Set a 
0b50: 70 72 65 66 65 72 72 65 64 20 72 65 6d 6f 74 65  preferred remote
0b60: 20 72 65 70 6f 73 69 74 6f 72 79 20 74 6f 20 75   repository to u
0b70: 73 65 20 61 73 20 61 20 73 65 72 76 65 72 0a 20  se as a server. 
0b80: 20 20 20 20 20 20 20 20 20 3d 20 20 43 6c 6f 6e           =  Clon
0b90: 65 20 72 65 70 6f 73 69 74 6f 72 79 20 69 73 20  e repository is 
0ba0: 74 68 65 20 64 65 66 61 75 6c 74 0a 20 20 20 20  the default.    
0bb0: 20 20 20 2a 20 50 75 73 68 20 61 66 74 65 72 20     * Push after 
0bc0: 63 6f 6d 6d 69 74 0a 20 20 20 20 20 20 20 2a 20  commit.       * 
0bd0: 41 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 70 75  Automatically pu
0be0: 6c 6c 20 70 72 69 6f 72 20 74 6f 20 75 70 64 61  ll prior to upda
0bf0: 74 65 2e 0a 0a 20 20 2a 20 41 72 63 68 65 6f 6c  te...  * Archeol
0c00: 6f 67 69 63 61 6c 20 77 65 62 70 61 67 65 20 69  ogical webpage i
0c10: 6d 70 72 6f 76 65 6d 65 6e 74 73 3a 0a 20 20 20  mprovements:.   
0c20: 20 20 2b 20 55 73 65 20 61 20 73 6d 61 6c 6c 20    + Use a small 
0c30: 61 6d 6f 75 6e 74 20 6f 66 20 43 53 53 2b 6a 61  amount of CSS+ja
0c40: 76 61 73 63 72 69 70 74 20 6f 6e 20 74 69 6d 65  vascript on time
0c50: 6c 69 6e 65 73 20 73 6f 20 74 68 61 74 0a 20 20  lines so that.  
0c60: 20 20 20 20 20 62 72 61 6e 63 68 69 6e 67 20 73       branching s
0c70: 74 72 75 63 74 75 72 65 20 69 73 20 64 69 73 70  tructure is disp
0c80: 6c 61 79 65 64 20 6f 6e 20 6d 6f 75 73 65 6f 76  layed on mouseov
0c90: 65 72 2e 20 20 4f 6e 20 6d 6f 75 73 65 6f 76 65  er.  On mouseove
0ca0: 72 0a 20 20 20 20 20 20 20 6f 66 20 61 20 63 68  r.       of a ch
0cb0: 65 63 6b 69 6e 2c 20 68 69 67 68 6c 69 67 68 74  eckin, highlight
0cc0: 20 6f 74 68 65 72 20 63 68 65 63 6b 69 6e 73 20   other checkins 
0cd0: 74 68 61 74 20 61 72 65 20 64 69 72 65 63 74 20  that are direct 
0ce0: 28 6e 6f 6e 2d 6d 65 72 67 65 29 0a 20 20 20 20  (non-merge).    
0cf0: 20 20 20 64 65 73 63 65 6e 64 65 6e 74 73 20 61     descendents a
0d00: 6e 64 20 61 6e 63 65 73 74 6f 72 73 20 6f 66 20  nd ancestors of 
0d10: 74 68 65 20 6d 6f 75 73 65 6f 76 65 72 20 63 68  the mouseover ch
0d20: 65 63 6b 69 6e 2e 0a 20 20 20 20 20 2b 20 54 69  eckin..     + Ti
0d30: 6d 65 6c 69 6e 65 20 73 68 6f 77 69 6e 67 20 69  meline showing i
0d40: 6e 64 69 76 69 64 75 61 6c 20 62 72 61 6e 63 68  ndividual branch
0d50: 65 73 0a 20 20 20 20 20 2b 20 54 69 6d 65 6c 69  es.     + Timeli
0d60: 6e 65 20 73 68 6f 77 73 20 66 6f 72 6b 73 20 61  ne shows forks a
0d70: 6e 64 20 6d 65 72 67 65 73 0a 20 20 20 20 20 2b  nd merges.     +
0d80: 20 54 61 67 73 20 73 68 6f 77 6e 20 6f 6e 20 74   Tags shown on t
0d90: 69 6d 65 6c 69 6e 65 20 28 6d 61 79 62 65 29 20  imeline (maybe) 
0da0: 61 6e 64 20 69 6e 20 76 69 6e 66 6f 20 28 73 75  and in vinfo (su
0db0: 72 65 6c 79 29 2e 0a 0a 46 65 61 74 75 72 65 73  rely)...Features
0dc0: 20 6e 65 65 64 65 64 3a 0a 20 20 2a 20 4d 65 61   needed:.  * Mea
0dd0: 6e 73 20 74 6f 20 73 75 70 70 72 65 73 73 20 61  ns to suppress a
0de0: 72 74 69 66 61 63 74 73 0a 20 20 2a 20 4d 65 61  rtifacts.  * Mea
0df0: 6e 73 20 74 6f 20 63 61 70 20 61 20 62 72 61 6e  ns to cap a bran
0e00: 63 68 0a 20 20 2a 20 54 69 63 6b 65 74 69 6e 67  ch.  * Ticketing
0e10: 0a 20 20 20 20 20 2b 20 20 50 72 6f 62 6c 65 6d  .     +  Problem
0e20: 20 69 73 2f 69 73 2d 6e 6f 74 20 65 78 70 72 65   is/is-not expre
0e30: 73 73 65 64 20 69 6e 20 62 61 73 65 6c 69 6e 65  ssed in baseline
0e40: 20 58 2e 0a 20 20 20 20 20 2b 20 20 41 70 70 65   X..     +  Appe
0e50: 6e 64 20 63 6f 6d 6d 65 6e 74 20 61 6e 64 20 7a  nd comment and z
0e60: 65 72 6f 20 6f 72 20 6d 6f 72 65 20 61 74 74 61  ero or more atta
0e70: 63 68 6d 65 6e 74 73 0a 20 20 2a 20 4d 6f 64 69  chments.  * Modi
0e80: 66 79 20 63 6f 6d 6d 65 6e 74 73 20 6f 6e 20 62  fy comments on b
0e90: 61 73 65 6c 69 6e 65 73 0a 20 20 2a 20 41 70 70  aselines.  * App
0ea0: 65 6e 64 20 63 6f 6d 6d 65 6e 74 73 20 74 6f 20  end comments to 
0eb0: 61 6e 79 20 61 72 74 69 66 61 63 74 0a 20 20 2a  any artifact.  *
0ec0: 20 57 69 6b 69 3f 0a 0a 20 20 0a 0a 45 78 74 65   Wiki?..  ..Exte
0ed0: 6e 64 65 64 20 6d 61 6e 69 66 65 73 74 73 2e 0a  nded manifests..
0ee0: 20 20 2a 20 6e 6f 72 6d 61 6c 20 6d 61 6e 69 66    * normal manif
0ef0: 65 73 74 20 68 61 73 3a 0a 20 20 20 20 20 20 20  est has:.       
0f00: 43 20 63 6f 6d 6d 65 6e 74 0a 20 20 20 20 20 20  C comment.      
0f10: 20 44 20 64 61 74 65 2d 74 69 6d 65 0a 20 20 20   D date-time.   
0f20: 20 20 20 20 46 2a 20 66 69 6c 65 6e 61 6d 65 20      F* filename 
0f30: 75 75 69 64 0a 20 20 20 20 20 20 20 50 20 75 75  uuid.       P uu
0f40: 69 64 20 2e 2e 2e 20 20 20 20 20 20 20 20 20 20  id ...          
0f50: 20 2d 2d 20 6f 6d 69 74 74 65 64 20 66 6f 72 20   -- omitted for 
0f60: 66 69 72 73 74 20 6d 61 6e 69 66 65 73 74 0a 20  first manifest. 
0f70: 20 20 20 20 20 20 52 20 72 65 70 6f 73 69 74 6f        R reposito
0f80: 72 79 2d 6d 64 35 73 75 6d 0a 20 20 20 20 20 20  ry-md5sum.      
0f90: 20 55 20 75 73 65 72 2d 6c 6f 67 69 6e 0a 20 20   U user-login.  
0fa0: 20 20 20 20 20 5a 20 6d 61 6e 69 66 65 73 74 2d       Z manifest-
0fb0: 63 68 65 63 6b 73 75 6d 0a 0a 20 20 2a 20 41 63  checksum..  * Ac
0fc0: 63 65 73 73 6f 72 79 3a 0a 20 20 20 20 20 20 20  cessory:.       
0fd0: 41 20 75 75 69 64 7c 2a 20 61 74 74 61 63 68 6d  A uuid|* attachm
0fe0: 65 6e 74 2d 75 75 69 64 20 64 65 73 63 72 69 70  ent-uuid descrip
0ff0: 74 69 6f 6e 0a 20 20 20 20 20 20 20 44 20 64 61  tion.       D da
1000: 74 65 2d 74 69 6d 65 0a 20 20 20 20 20 20 20 45  te-time.       E
1010: 20 75 75 69 64 20 6e 65 77 2d 63 6f 6d 6d 65 6e   uuid new-commen
1020: 74 0a 20 20 20 20 20 20 20 47 20 75 75 69 64 20  t.       G uuid 
1030: 61 70 70 65 6e 64 65 64 2d 72 65 6d 61 72 6b 0a  appended-remark.
1040: 20 20 20 20 20 20 20 53 20 72 65 70 6f 73 69 74         S reposit
1050: 6f 72 79 69 64 20 73 65 72 69 61 6c 2d 6e 75 6d  oryid serial-num
1060: 62 65 72 0a 20 20 20 20 20 20 20 54 20 28 2b 7c  ber.       T (+|
1070: 2d 29 74 61 67 20 75 75 69 64 0a 20 20 20 20 20  -)tag uuid.     
1080: 20 20 55 20 75 73 65 72 69 64 0a 20 20 20 20 20    U userid.     
1090: 20 20 58 20 75 75 69 64 2d 74 6f 2d 73 75 72 70    X uuid-to-surp
10a0: 72 65 73 73 0a 20 20 20 20 20 20 20 5a 20 74 68  ress.       Z th
10b0: 69 73 2d 66 69 6c 65 2d 63 68 65 63 6b 73 75 6d  is-file-checksum
10c0: 0a 0a 20 20 2a 20 43 68 61 6e 67 65 20 74 68 65  ..  * Change the
10d0: 20 63 6f 6d 6d 65 6e 74 20 6f 6e 20 61 20 76 65   comment on a ve
10e0: 72 73 69 6f 6e 3a 20 20 20 2d 2d 20 61 6c 77 61  rsion:   -- alwa
10f0: 79 73 20 61 20 6c 65 61 66 20 65 78 63 65 70 74  ys a leaf except
1100: 20 69 6e 20 63 6c 75 73 74 65 72 0a 20 20 20 20   in cluster.    
1110: 20 20 20 44 20 64 61 74 65 2d 74 69 6d 65 0a 20     D date-time. 
1120: 20 20 20 20 20 20 45 20 6e 65 77 2d 63 6f 6d 6d        E new-comm
1130: 65 6e 74 0a 20 20 20 20 20 20 20 50 20 75 75 69  ent.       P uui
1140: 64 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2d  d              -
1150: 2d 20 62 61 73 65 6c 69 6e 65 20 77 68 6f 73 65  - baseline whose
1160: 20 63 6f 6d 6d 65 6e 74 20 69 73 20 63 68 61 6e   comment is chan
1170: 67 65 64 0a 20 20 20 20 20 20 20 55 20 75 73 65  ged.       U use
1180: 72 2d 6c 6f 67 69 6e 0a 20 20 20 20 20 20 20 5a  r-login.       Z
1190: 20 63 68 65 63 6b 73 75 6d 0a 20 20 20 20 20 20   checksum.      
11a0: 20 2d 2d 20 6d 6f 73 74 20 72 65 63 65 6e 74 20   -- most recent 
11b0: 77 69 6e 73 0a 20 20 2a 20 57 69 6b 69 20 65 64  wins.  * Wiki ed
11c0: 69 74 0a 20 20 20 20 20 20 20 41 2a 20 6e 61 6d  it.       A* nam
11d0: 65 20 75 75 69 64 20 20 20 2d 2d 20 7a 65 72 6f  e uuid   -- zero
11e0: 20 6f 72 20 6d 6f 72 65 20 61 74 74 61 63 68 6d   or more attachm
11f0: 65 6e 74 73 0a 20 20 20 20 20 20 20 43 3f 20 63  ents.       C? c
1200: 6f 6d 6d 65 6e 74 0a 20 20 20 20 20 20 20 44 20  omment.       D 
1210: 64 61 74 65 2d 74 69 6d 65 0a 20 20 20 20 20 20  date-time.      
1220: 20 4e 20 6e 61 6d 65 20 20 20 20 20 20 20 20 20   N name         
1230: 2d 2d 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 77  -- name of the w
1240: 69 6b 69 20 70 61 67 65 0a 20 20 20 20 20 20 20  iki page.       
1250: 50 20 75 75 69 64 20 2e 2e 2e 20 20 20 20 20 2d  P uuid ...     -
1260: 2d 20 6f 6d 69 74 20 66 6f 72 20 6e 65 77 20 77  - omit for new w
1270: 69 6b 69 0a 20 20 20 20 20 20 20 55 20 75 73 65  iki.       U use
1280: 72 2d 6c 6f 67 69 6e 0a 20 20 20 20 20 20 20 57  r-login.       W
1290: 20 75 75 69 64 20 20 20 20 20 20 20 20 20 2d 2d   uuid         --
12a0: 20 54 68 65 20 63 6f 6e 74 65 6e 74 20 66 69 6c   The content fil
12b0: 65 0a 20 20 20 20 20 20 20 5a 20 6d 61 6e 69 66  e.       Z manif
12c0: 65 73 74 2d 63 6b 73 75 6d 0a 20 20 2a 20 54 69  est-cksum.  * Ti
12d0: 63 6b 65 74 20 65 64 69 74 0a 20 20 20 20 20 20  cket edit.      
12e0: 20 41 2a 20 6e 61 6d 65 20 75 75 69 64 20 20 20   A* name uuid   
12f0: 2d 2d 20 7a 65 72 6f 20 6f 72 20 6d 6f 72 65 20  -- zero or more 
1300: 61 74 74 61 63 68 6d 65 6e 74 73 0a 20 20 20 20  attachments.    
1310: 20 20 20 44 20 64 61 74 65 2d 74 69 6d 65 0a 20     D date-time. 
1320: 20 20 20 20 20 20 4e 20 6e 61 6d 65 20 20 20 20        N name    
1330: 20 20 20 20 20 2d 2d 20 6e 61 6d 65 20 6f 66 20       -- name of 
1340: 74 68 65 20 74 69 63 6b 65 74 0a 20 20 20 20 20  the ticket.     
1350: 20 20 50 20 75 75 69 64 20 20 20 20 20 20 20 20    P uuid        
1360: 20 2d 2d 20 6f 6d 69 74 20 66 6f 72 20 6e 65 77   -- omit for new
1370: 20 74 69 63 6b 65 74 0a 20 20 20 20 20 20 20 54   ticket.       T
1380: 20 75 75 69 64 20 20 20 20 20 20 20 20 20 2d 2d   uuid         --
1390: 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 20   content of the 
13a0: 74 69 63 6b 65 74 0a 20 20 20 20 20 20 20 55 20  ticket.       U 
13b0: 75 73 65 72 2d 6c 6f 67 69 6e 0a 20 20 20 20 20  user-login.     
13c0: 20 20 5a 20 6d 61 6e 69 66 65 73 74 2d 63 6b 73    Z manifest-cks
13d0: 75 6d 0a 20 20 2a 20 53 65 74 20 6f 72 20 65 72  um.  * Set or er
13e0: 61 73 65 20 61 20 74 61 67 20 20 20 20 2d 2d 20  ase a tag    -- 
13f0: 6d 6f 73 74 20 72 65 63 65 6e 74 20 64 61 74 65  most recent date
1400: 20 77 69 6e 73 0a 20 20 20 20 20 20 20 42 2a 20   wins.       B* 
1410: 28 2b 7c 2d 29 74 61 67 20 75 75 69 64 0a 20 20  (+|-)tag uuid.  
1420: 20 20 20 20 20 43 3f 20 63 6f 6d 6d 65 6e 74 0a       C? comment.
1430: 20 20 20 20 20 20 20 44 20 64 61 74 65 2d 74 69         D date-ti
1440: 6d 65 0a 20 20 20 20 20 20 20 56 2a 20 28 2b 7c  me.       V* (+|
1450: 2d 29 20 74 61 67 20 75 75 69 64 20 20 20 20 2d  -) tag uuid    -
1460: 2d 20 2b 20 74 6f 20 73 65 74 2c 20 2d 20 74 6f  - + to set, - to
1470: 20 63 6c 65 61 72 2e 20 20 0a 20 20 20 20 20 20   clear.  .      
1480: 20 5a 20 6d 61 6e 69 66 65 73 74 2d 63 6b 73 75   Z manifest-cksu
1490: 6d 0a 20 20 20 20 20 20 20 2d 2d 20 4d 75 73 74  m.       -- Must
14a0: 20 68 61 76 65 20 61 74 20 6c 65 61 73 74 20 6f   have at least o
14b0: 6e 65 20 42 20 6f 72 20 56 2e 0a 20 20 20 20 20  ne B or V..     
14c0: 20 20 2d 2d 20 42 72 61 6e 63 68 20 74 61 67 20    -- Branch tag 
14d0: 22 68 69 64 64 65 6e 22 20 6d 65 61 6e 73 20 64  "hidden" means d
14e0: 6f 20 6e 6f 74 20 73 79 6e 63 0a 20 20 20 20 20  o not sync.     
14f0: 20 20 2d 2d 20 56 65 72 73 69 6f 6e 20 74 61 67    -- Version tag
1500: 20 22 63 6c 6f 73 65 64 22 20 6d 65 61 6e 73 20   "closed" means 
1510: 64 6f 20 6e 6f 74 20 64 69 73 70 6c 61 79 20 61  do not display a
1520: 73 20 61 20 6c 65 61 66 0a 20 20 2a 20 41 20 63  s a leaf.  * A c
1530: 6c 75 73 74 65 72 0a 20 20 20 20 20 20 20 4d 2b  luster.       M+
1540: 20 75 75 69 64 0a 20 20 20 20 20 20 20 5a 20 6d   uuid.       Z m
1550: 61 6e 69 66 65 73 74 2d 63 6b 73 75 6d 0a 0a 20  anifest-cksum.. 
1560: 20 2a 20 43 6f 6d 70 6c 65 74 65 20 73 65 74 20   * Complete set 
1570: 6f 66 20 63 61 72 64 73 20 69 6e 20 61 20 63 6f  of cards in a co
1580: 6e 74 72 6f 6c 20 66 69 6c 65 3a 0a 20 20 20 20  ntrol file:.    
1590: 20 20 20 41 20 66 69 6c 65 6e 61 6d 65 20 75 75     A filename uu
15a0: 69 64 20 20 20 20 20 20 20 20 20 20 20 20 20 0a  id             .
15b0: 20 20 20 20 20 20 20 42 20 28 2b 7c 2d 29 62 72         B (+|-)br
15c0: 61 6e 63 68 2d 74 61 67 20 75 75 69 64 20 20 20  anch-tag uuid   
15d0: 20 20 20 0a 20 20 20 20 20 20 20 43 20 63 6f 6d     .       C com
15e0: 6d 65 6e 74 20 20 20 20 20 20 20 20 20 20 20 20  ment            
15f0: 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 44         .       D
1600: 20 64 61 74 65 2d 74 69 6d 65 20 20 20 20 20 20   date-time      
1610: 20 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 20             .    
1620: 20 20 20 45 20 75 75 69 64 20 65 64 69 74 65 64     E uuid edited
1630: 2d 63 6f 6d 6d 65 6e 74 20 20 20 20 20 20 20 0a  -comment       .
1640: 20 20 20 20 20 20 20 46 20 66 69 6c 65 6e 61 6d         F filenam
1650: 65 20 75 75 69 64 20 20 20 20 20 20 20 20 20 20  e uuid          
1660: 20 20 20 0a 20 20 20 20 20 20 20 4d 20 75 75 69     .       M uui
1670: 64 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  d               
1680: 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 4e         .       N
1690: 20 6e 61 6d 65 20 20 20 20 20 20 20 20 20 20 20   name           
16a0: 20 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 20             .    
16b0: 20 20 20 50 20 75 75 69 64 20 2e 2e 2e 20 20 20     P uuid ...   
16c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0a                 .
16d0: 20 20 20 20 20 20 20 52 20 72 65 70 6f 73 69 74         R reposit
16e0: 6f 72 79 2d 6d 64 35 73 75 6d 20 20 20 20 20 20  ory-md5sum      
16f0: 20 20 20 0a 20 20 20 20 20 20 20 54 20 75 75 69     .       T uui
1700: 64 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  d               
1710: 20 20 20 20 20 20 20 0a 20 20 20 20 20 20 20 55         .       U
1720: 20 75 73 65 72 2d 6c 6f 67 69 6e 20 20 20 20 20   user-login     
1730: 20 20 20 20 20 20 20 20 20 20 20 0a 20 20 20 20             .    
1740: 20 20 20 56 20 28 2b 7c 2d 29 76 65 72 73 69 6f     V (+|-)versio
1750: 6e 2d 74 61 67 20 75 75 69 64 20 20 20 20 20 0a  n-tag uuid     .
1760: 20 20 20 20 20 20 20 57 20 75 75 69 64 20 20 20         W uuid   
1770: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1780: 20 20 20 0a 20 20 20 20 20 20 20 5a 20 6d 61 6e     .       Z man
1790: 69 66 65 73 74 2d 63 68 65 63 6b 73 75 6d 0a     ifest-checksum.