Hex Artifact Content
Not logged in

Artifact 9ee026f875a33a20b395ad6cf4284d5b8af076ac:

File todo.txt part of check-in [7fe1e734e9] - Remove one to-do item. Add another. by drh on 2007-07-31 10:10:37.

0000: 54 68 69 6e 67 73 20 74 6f 20 77 6f 72 6b 20 6f  Things to work o
0010: 6e 3a 0a 0a 20 2a 20 20 42 75 67 3a 20 54 68 65  n:.. *  Bug: The
0020: 20 74 69 6d 65 6c 69 6e 65 20 69 73 20 76 69 73   timeline is vis
0030: 69 62 6c 65 20 69 6e 20 73 71 6c 69 74 65 72 74  ible in sqlitert
0040: 20 65 76 65 6e 20 74 68 6f 75 67 68 20 61 6e 6f   even though ano
0050: 6e 79 6d 6f 75 73 0a 20 20 20 20 61 63 63 65 73  nymous.    acces
0060: 73 20 69 73 20 74 75 72 6e 65 64 20 6f 66 66 2e  s is turned off.
0070: 20 20 54 68 65 20 74 69 6d 65 6c 69 6e 65 20 6d    The timeline m
0080: 65 6e 75 20 69 74 65 6d 20 73 68 6f 75 6c 64 20  enu item should 
0090: 62 65 20 6f 6d 69 74 74 65 64 0a 20 20 20 20 61  be omitted.    a
00a0: 6e 64 20 74 68 65 20 74 69 6d 65 6c 69 6e 65 20  nd the timeline 
00b0: 70 61 67 65 20 73 68 6f 75 6c 64 20 62 65 20 64  page should be d
00c0: 69 73 61 6c 6c 6f 77 65 64 20 69 66 20 74 68 65  isallowed if the
00d0: 20 75 73 65 72 20 64 6f 65 73 20 6e 6f 74 0a 20   user does not. 
00e0: 20 20 20 68 61 76 65 20 74 68 65 20 72 69 67 68     have the righ
00f0: 74 20 61 63 63 65 73 73 20 70 65 72 6d 69 73 73  t access permiss
0100: 69 6f 6e 73 2e 20 20 46 65 65 6c 20 66 72 65 65  ions.  Feel free
0110: 20 74 6f 20 61 64 64 20 6e 65 77 20 61 63 63 65   to add new acce
0120: 73 73 0a 20 20 20 20 70 65 72 6d 69 73 73 69 6f  ss.    permissio
0130: 6e 73 20 28 76 69 65 77 20 74 69 6d 65 6c 69 6e  ns (view timelin
0140: 65 20 70 65 72 6d 69 73 73 69 6f 6e 3f 29 20 69  e permission?) i
0150: 66 20 74 68 69 73 20 73 65 65 6d 73 20 6c 69 6b  f this seems lik
0160: 65 20 73 6f 6d 65 74 68 69 6e 67 0a 20 20 20 20  e something.    
0170: 61 70 70 72 6f 70 72 69 61 74 65 20 74 6f 20 64  appropriate to d
0180: 6f 2e 0a 0a 20 2a 20 20 55 73 65 20 74 68 65 20  o... *  Use the 
0190: 77 69 6b 69 5f 63 6f 6e 76 65 72 74 28 29 20 72  wiki_convert() r
01a0: 6f 75 74 69 6e 65 20 74 6f 20 72 65 6e 64 65 72  outine to render
01b0: 20 63 6f 6d 6d 65 6e 74 73 20 61 6e 64 20 6f 74   comments and ot
01c0: 68 65 72 20 74 65 78 74 0a 20 20 20 20 6f 6e 20  her text.    on 
01d0: 77 65 62 20 70 61 67 65 73 2e 0a 0a 20 2a 20 20  web pages... *  
01e0: 49 66 20 74 68 65 20 73 65 72 76 65 72 20 64 6f  If the server do
01f0: 65 73 20 6e 6f 74 20 68 61 76 65 20 77 72 69 74  es not have writ
0200: 65 20 70 65 72 6d 69 73 73 69 6f 6e 20 6f 6e 20  e permission on 
0210: 74 68 65 20 64 61 74 61 62 61 73 65 0a 20 20 20  the database.   
0220: 20 66 69 6c 65 2c 20 6f 72 20 6f 6e 20 74 68 65   file, or on the
0230: 20 64 69 72 65 63 74 6f 72 79 20 63 6f 6e 74 61   directory conta
0240: 69 6e 69 6e 67 20 74 68 65 20 64 61 74 61 62 61  ining the databa
0250: 73 65 20 66 69 6c 65 20 28 61 6e 64 20 0a 20 20  se file (and .  
0260: 20 20 69 74 20 69 73 20 74 68 75 73 20 75 6e 61    it is thus una
0270: 62 6c 65 20 74 6f 20 75 70 64 61 74 65 20 64 61  ble to update da
0280: 74 61 62 61 73 65 20 62 65 63 61 75 73 65 20 69  tabase because i
0290: 74 20 63 61 6e 6e 6f 74 20 63 72 65 61 74 65 0a  t cannot create.
02a0: 20 20 20 20 61 20 72 6f 6c 6c 62 61 63 6b 20 6a      a rollback j
02b0: 6f 75 72 6e 61 6c 29 20 74 68 65 6e 20 69 74 20  ournal) then it 
02c0: 63 75 72 72 65 6e 74 6c 79 20 66 61 69 6c 73 20  currently fails 
02d0: 73 69 6c 65 6e 74 6c 79 20 6f 6e 20 61 20 70 75  silently on a pu
02e0: 73 68 2e 0a 20 20 20 20 49 74 20 6e 65 65 64 73  sh..    It needs
02f0: 20 74 6f 20 72 65 74 75 72 6e 20 61 20 68 65 6c   to return a hel
0300: 70 66 75 6c 20 65 72 72 6f 72 2e 0a 0a 20 2a 20  pful error... * 
0310: 20 57 68 65 6e 20 63 6f 6e 73 74 72 75 63 74 69   When constructi
0320: 6e 67 20 61 20 6e 65 77 20 6d 61 6e 69 66 65 73  ng a new manifes
0330: 74 20 28 73 65 65 20 74 68 65 20 63 6f 6d 6d 69  t (see the commi
0340: 74 5f 63 6d 64 20 66 75 6e 63 74 69 6f 6e 0a 20  t_cmd function. 
0350: 20 20 20 69 6e 20 63 68 65 63 6b 69 6e 2e 63 2c     in checkin.c,
0360: 20 6e 65 61 72 20 6c 69 6e 65 20 33 30 33 29 20   near line 303) 
0370: 6d 61 6b 65 20 61 6e 20 61 74 74 65 6d 70 74 20  make an attempt 
0380: 74 6f 20 50 47 50 20 63 6c 65 61 72 73 69 67 6e  to PGP clearsign
0390: 0a 20 20 20 20 74 68 65 20 6d 61 6e 69 66 65 73  .    the manifes
03a0: 74 20 62 65 66 6f 72 65 20 63 68 65 63 6b 69 6e  t before checkin
03b0: 67 20 69 74 20 69 6e 2e 20 20 54 68 65 72 65 20  g it in.  There 
03c0: 77 69 6c 6c 20 6e 65 65 64 20 74 6f 20 62 65 0a  will need to be.
03d0: 20 20 20 20 63 6f 6e 66 69 67 75 72 61 74 69 6f      configuratio
03e0: 6e 20 70 61 72 61 6d 65 74 65 72 73 20 66 6f 72  n parameters for
03f0: 20 74 68 65 20 50 47 50 20 28 6f 72 20 6d 6f 72   the PGP (or mor
0400: 65 20 6c 69 6b 65 6c 79 20 47 50 47 29 0a 20 20  e likely GPG).  
0410: 20 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 64 6f 20    command to do 
0420: 74 68 65 20 61 63 74 75 61 6c 20 73 69 67 6e 69  the actual signi
0430: 6e 67 2e 20 20 57 72 69 74 65 20 74 68 65 20 6d  ng.  Write the m
0440: 61 6e 69 66 65 73 74 20 74 6f 0a 20 20 20 20 61  anifest to.    a
0450: 20 74 65 6d 70 20 66 69 6c 65 2c 20 63 6c 65 61   temp file, clea
0460: 72 73 69 67 6e 2c 20 72 65 61 64 20 69 74 20 62  rsign, read it b
0470: 61 63 6b 20 69 6e 2c 20 76 65 72 69 66 79 20 74  ack in, verify t
0480: 68 61 74 20 69 74 20 69 73 0a 20 20 20 20 73 74  hat it is.    st
0490: 69 6c 6c 20 70 61 72 73 61 62 6c 65 20 62 79 20  ill parsable by 
04a0: 6d 61 6e 69 66 65 73 74 5f 70 61 72 73 65 28 29  manifest_parse()
04b0: 2c 20 74 68 65 6e 20 63 6f 6e 74 69 6e 75 65 20  , then continue 
04c0: 77 69 74 68 20 74 68 65 0a 20 20 20 20 63 68 65  with the.    che
04d0: 63 6b 2d 69 6e 2e 0a 0a 20 2a 20 20 54 68 65 20  ck-in... *  The 
04e0: 22 6c 65 61 76 65 73 20 3f 55 55 49 44 3f 22 20  "leaves ?UUID?" 
04f0: 63 6f 6d 6d 61 6e 64 20 64 69 73 70 6c 61 79 73  command displays
0500: 20 61 6c 6c 20 6c 65 61 66 20 76 65 72 73 69 6f   all leaf versio
0510: 6e 73 20 66 6f 72 20 74 68 65 0a 20 20 20 20 76  ns for the.    v
0520: 65 72 73 69 6f 6e 20 55 55 49 44 20 6f 72 20 66  ersion UUID or f
0530: 6f 72 20 74 68 65 20 63 75 72 72 65 6e 74 20 76  or the current v
0540: 65 72 73 69 6f 6e 20 69 66 20 55 55 49 44 20 69  ersion if UUID i
0550: 73 20 6f 6d 69 74 74 65 64 2e 20 20 49 66 0a 20  s omitted.  If. 
0560: 20 20 20 55 55 49 44 20 69 73 20 69 74 73 65 6c     UUID is itsel
0570: 66 20 61 20 6c 65 61 66 2c 20 69 74 20 77 6f 75  f a leaf, it wou
0580: 6c 64 20 62 65 20 6d 6f 72 65 20 68 65 6c 70 66  ld be more helpf
0590: 75 6c 20 74 6f 20 64 69 73 70 6c 61 79 20 61 0a  ul to display a.
05a0: 20 20 20 20 6d 65 73 73 61 67 65 20 74 6f 20 74      message to t
05b0: 68 61 74 20 65 66 66 65 63 74 3a 20 20 22 3c 75  hat effect:  "<u
05c0: 75 69 64 3e 20 69 73 20 69 74 73 65 6c 66 20 61  uid> is itself a
05d0: 20 6c 65 61 66 22 0a 0a 20 2a 20 20 57 65 20 6e   leaf".. *  We n
05e0: 65 65 64 20 61 20 63 6f 6d 6d 61 6e 64 20 74 6f  eed a command to
05f0: 20 73 68 6f 77 20 6f 74 68 65 72 20 62 72 61 6e   show other bran
0600: 63 68 65 73 20 2d 20 6c 65 61 76 65 73 20 6f 66  ches - leaves of
0610: 20 74 68 65 20 72 6f 6f 74 0a 20 20 20 20 77 68   the root.    wh
0620: 69 63 68 20 61 72 65 20 6e 6f 74 20 6c 65 61 76  ich are not leav
0630: 65 73 20 6f 66 20 74 68 65 20 69 6e 64 69 63 61  es of the indica
0640: 74 65 64 20 6e 6f 64 65 2e 0a 0a 20 2a 20 20 54  ted node... *  T
0650: 68 65 20 69 70 61 64 64 72 20 66 69 65 6c 64 20  he ipaddr field 
0660: 6f 66 20 74 68 65 20 72 63 76 66 72 6f 6d 20 74  of the rcvfrom t
0670: 61 62 6c 65 20 69 73 20 6e 6f 74 20 62 65 69 6e  able is not bein
0680: 67 20 73 65 74 2e 20 20 54 68 69 73 0a 20 20 20  g set.  This.   
0690: 20 66 69 65 6c 64 20 73 68 6f 75 6c 64 20 62 65   field should be
06a0: 20 74 68 65 20 49 50 20 61 64 64 72 65 73 73 20   the IP address 
06b0: 66 72 6f 6d 20 77 68 69 63 68 20 69 6e 66 6f 72  from which infor
06c0: 6d 61 74 69 6f 6e 20 69 73 20 72 65 63 65 69 76  mation is receiv
06d0: 65 64 0a 20 20 20 20 66 6f 72 20 74 68 65 20 6c  ed.    for the l
06e0: 6f 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 2e  ocal repository.
06f0: 20 20 53 6f 20 77 68 65 6e 20 73 6f 6d 65 62 6f    So when somebo
0700: 64 79 20 64 6f 65 73 20 61 20 70 75 73 68 20 6f  dy does a push o
0710: 66 20 6e 65 77 0a 20 20 20 20 66 69 6c 65 73 20  f new.    files 
0720: 77 65 20 72 65 63 6f 72 64 20 74 68 65 20 69 70  we record the ip
0730: 61 64 64 72 2e 20 20 4f 72 20 77 68 65 6e 20 77  addr.  Or when w
0740: 65 20 64 6f 20 61 20 70 75 6c 6c 2c 20 77 65 20  e do a pull, we 
0750: 72 65 63 6f 72 64 0a 20 20 20 20 74 68 65 20 69  record.    the i
0760: 70 61 64 64 72 2e 0a 0a 20 2a 20 20 41 64 64 69  paddr... *  Addi
0770: 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69  tional informati
0780: 6f 6e 20 64 69 73 70 6c 61 79 65 64 20 66 6f 72  on displayed for
0790: 20 74 68 65 20 22 76 69 6e 66 6f 22 20 70 61 67   the "vinfo" pag
07a0: 65 3a 0a 0a 20 20 20 20 20 2b 20 20 54 68 65 20  e:..     +  The 
07b0: 63 6f 6d 6d 65 6e 74 20 61 6e 64 20 75 73 65 72  comment and user
07c0: 20 66 6f 72 20 74 68 69 73 20 76 65 72 73 69 6f   for this versio
07d0: 6e 20 28 61 76 61 69 6c 61 62 6c 65 20 69 6e 0a  n (available in.
07e0: 20 20 20 20 20 20 20 20 74 68 65 20 65 76 65 6e          the even
07f0: 74 20 74 61 62 6c 65 29 2e 0a 20 20 20 20 20 2b  t table)..     +
0800: 20 20 41 6c 6c 20 64 65 63 65 6e 64 65 6e 74 73    All decendents
0810: 20 6f 66 20 74 68 69 73 20 76 65 72 73 69 6f 6e   of this version
0820: 20 28 74 6f 67 65 74 68 65 72 20 77 69 74 68 20   (together with 
0830: 64 61 74 65 2c 0a 20 20 20 20 20 20 20 20 75 73  date,.        us
0840: 65 72 2c 20 63 6f 6d 6d 65 6e 74 2c 20 61 6e 64  er, comment, and
0850: 20 68 79 70 65 72 6c 69 6e 6b 20 74 6f 20 74 68   hyperlink to th
0860: 65 20 76 69 6e 66 6f 20 70 61 67 65 29 20 66 6f  e vinfo page) fo
0870: 72 0a 20 20 20 20 20 20 20 20 4e 20 67 65 6e 65  r.        N gene
0880: 72 61 74 69 6f 6e 73 2e 20 20 4e 20 74 6f 20 62  rations.  N to b
0890: 65 20 64 65 74 65 72 6d 69 6e 65 64 2e 20 20 50  e determined.  P
08a0: 65 72 68 61 70 73 20 63 6f 6e 66 69 67 75 72 61  erhaps configura
08b0: 62 6c 65 0a 20 20 20 20 20 20 20 20 75 73 69 6e  ble.        usin
08c0: 67 20 64 62 5f 67 65 74 5f 69 6e 74 28 29 2f 64  g db_get_int()/d
08d0: 62 5f 73 65 74 5f 69 6e 74 28 29 2e 20 20 4e 6f  b_set_int().  No
08e0: 74 65 3a 20 64 65 63 65 6e 64 65 6e 74 73 20 63  te: decendents c
08f0: 61 6e 0a 20 20 20 20 20 20 20 20 62 65 20 66 6f  an.        be fo
0900: 75 6e 64 20 75 73 69 6e 67 20 74 68 65 20 70 6c  und using the pl
0910: 69 6e 6b 20 74 61 62 6c 65 2e 0a 20 20 20 20 20  ink table..     
0920: 2b 20 20 41 6c 6c 20 6c 65 61 76 65 73 20 6f 66  +  All leaves of
0930: 20 74 68 69 73 20 76 65 72 73 69 6f 6e 20 74 68   this version th
0940: 61 74 20 61 72 65 20 6e 6f 74 20 69 6e 63 6c 75  at are not inclu
0950: 64 65 64 20 69 6e 20 74 68 65 0a 20 20 20 20 20  ded in the.     
0960: 20 20 20 64 65 63 65 6e 64 65 6e 74 20 6c 69 73     decendent lis
0970: 74 2e 20 20 57 69 74 68 20 64 61 74 65 2c 20 75  t.  With date, u
0980: 73 65 72 2c 20 63 6f 6d 6d 65 6e 74 2c 20 61 6e  ser, comment, an
0990: 64 20 68 79 70 65 72 6c 69 6e 6b 2e 0a 20 20 20  d hyperlink..   
09a0: 20 20 20 20 20 4c 65 61 76 65 73 20 69 6e 20 74       Leaves in t
09b0: 68 65 20 64 65 63 65 6e 64 65 6e 74 20 74 61 62  he decendent tab
09c0: 6c 65 20 73 68 6f 75 6c 64 20 62 65 20 6d 61 72  le should be mar
09d0: 6b 65 64 20 61 73 20 73 75 63 68 2e 0a 20 20 20  ked as such..   
09e0: 20 20 20 20 20 53 65 65 20 74 68 65 20 63 6f 6d       See the com
09f0: 70 75 74 65 5f 6c 65 61 76 65 73 28 29 20 66 75  pute_leaves() fu
0a00: 6e 63 74 69 6f 6e 20 74 6f 20 73 65 65 20 68 6f  nction to see ho
0a10: 77 20 74 6f 20 66 69 6e 64 20 61 6c 6c 0a 20 20  w to find all.  
0a20: 20 20 20 20 20 20 6c 65 61 76 65 73 2e 0a 20 20        leaves..  
0a30: 20 20 20 2b 20 20 41 6c 6c 20 61 6e 63 65 73 74     +  All ancest
0a40: 6f 72 73 20 6f 66 20 74 68 65 20 63 75 72 72 65  ors of the curre
0a50: 6e 74 20 76 65 72 73 69 6f 6e 20 77 69 74 68 20  nt version with 
0a60: 64 61 74 65 2c 20 75 73 65 72 2c 0a 20 20 20 20  date, user,.    
0a70: 20 20 20 20 63 6f 6d 6d 65 6e 74 2c 20 68 79 70      comment, hyp
0a80: 65 72 6c 69 6e 6b 2e 20 20 4d 20 67 65 6e 65 72  erlink.  M gener
0a90: 61 74 69 6f 6e 73 20 62 61 63 6b 2c 20 77 68 65  ations back, whe
0aa0: 72 65 20 4d 20 69 73 0a 20 20 20 20 20 20 20 20  re M is.        
0ab0: 74 6f 20 62 65 20 64 65 74 65 72 6d 69 6e 65 64  to be determined
0ac0: 2e 0a 20 20 20 20 20 2b 20 20 4c 69 73 74 20 6f  ..     +  List o
0ad0: 66 20 66 69 6c 65 73 20 61 64 64 65 64 20 6f 72  f files added or
0ae0: 20 6d 6f 64 69 66 69 65 64 20 62 79 20 74 68 69   modified by thi
0af0: 73 20 76 65 72 73 69 6f 6e 2e 0a 20 20 20 20 20  s version..     
0b00: 20 20 20 49 6e 66 6f 72 6d 61 74 69 6f 6e 20 61     Information a
0b10: 76 61 69 6c 61 62 6c 65 20 69 6e 20 74 68 65 20  vailable in the 
0b20: 6d 6c 69 6e 6b 20 74 61 62 6c 65 2e 20 20 48 79  mlink table.  Hy
0b30: 70 65 72 6c 69 6e 6b 73 20 74 6f 0a 20 20 20 20  perlinks to.    
0b40: 20 20 20 20 74 68 65 20 66 69 6e 66 6f 20 70 61      the finfo pa
0b50: 67 65 20 66 6f 72 20 65 61 63 68 20 66 69 6c 65  ge for each file
0b60: 2e 0a 20 20 20 20 20 2b 20 20 48 79 70 65 72 6c  ..     +  Hyperl
0b70: 69 6e 6b 73 20 74 6f 20 64 69 66 66 20 61 6c 6c  inks to diff all
0b80: 20 66 69 6c 65 73 20 69 6e 20 74 68 69 73 20 76   files in this v
0b90: 65 72 73 69 6f 6e 20 61 67 61 69 6e 73 74 20 61  ersion against a
0ba0: 6e 79 0a 20 20 20 20 20 20 20 20 6f 66 20 74 68  ny.        of th
0bb0: 65 20 6e 61 6d 65 64 20 64 65 63 65 6e 64 65 6e  e named decenden
0bc0: 74 73 20 6f 72 20 61 6e 63 65 73 74 6f 72 73 2e  ts or ancestors.
0bd0: 20 20 54 68 65 20 75 6e 69 66 69 65 64 5f 64 69    The unified_di
0be0: 66 66 28 29 0a 20 20 20 20 20 20 20 20 66 75 6e  ff().        fun
0bf0: 63 74 69 6f 6e 20 77 69 6c 6c 20 63 6f 6d 70 75  ction will compu
0c00: 74 65 20 61 20 75 6e 69 66 69 65 64 20 64 69 66  te a unified dif
0c10: 66 20 67 69 76 65 6e 20 74 6f 20 66 69 6c 65 20  f given to file 
0c20: 62 6c 6f 62 73 2e 0a 0a 20 2a 20 20 41 20 6e 65  blobs... *  A ne
0c30: 77 20 77 65 62 70 61 67 65 3a 20 22 66 69 6e 66  w webpage: "finf
0c40: 6f 22 20 20 49 6e 66 6f 72 6d 61 74 69 6f 6e 20  o"  Information 
0c50: 61 62 6f 75 74 20 61 20 70 61 72 74 69 63 75 6c  about a particul
0c60: 61 72 20 66 69 6c 65 0a 20 20 20 20 67 69 76 65  ar file.    give
0c70: 6e 20 69 74 73 20 6e 61 6d 65 2e 0a 0a 20 20 20  n its name...   
0c80: 20 20 2b 20 20 41 6c 6c 20 68 69 73 74 6f 72 69    +  All histori
0c90: 63 61 6c 20 63 68 61 6e 67 65 73 20 74 6f 20 74  cal changes to t
0ca0: 68 69 73 20 66 69 6c 65 20 77 69 74 68 20 76 65  his file with ve
0cb0: 72 73 69 6f 6e 20 6e 75 6d 62 65 72 2c 0a 20 20  rsion number,.  
0cc0: 20 20 20 20 20 20 75 73 65 72 2c 20 61 6e 64 20        user, and 
0cd0: 63 6f 6d 6d 65 6e 74 2c 20 61 6e 64 20 68 79 70  comment, and hyp
0ce0: 65 72 6c 69 6e 6b 20 74 6f 20 74 68 65 20 76 69  erlink to the vi
0cf0: 6e 66 6f 20 70 61 67 65 20 66 6f 72 0a 20 20 20  nfo page for.   
0d00: 20 20 20 20 20 74 68 65 20 76 65 72 73 69 6f 6e       the version
0d10: 2e 20 20 49 6e 66 6f 72 6d 61 74 69 6f 6e 20 61  .  Information a
0d20: 76 61 69 6c 61 62 6c 65 20 66 72 6f 6d 20 74 68  vailable from th
0d30: 65 20 6d 69 6e 66 6f 20 74 61 62 6c 65 2e 0a 20  e minfo table.. 
0d40: 20 20 20 20 2b 20 20 48 79 70 65 72 6c 69 6e 6b      +  Hyperlink
0d50: 73 20 66 6f 72 20 64 69 66 66 69 6e 67 20 63 6f  s for diffing co
0d60: 6e 73 65 63 75 74 69 76 65 20 76 65 72 73 69 6f  nsecutive versio
0d70: 6e 73 20 6f 66 20 74 68 65 20 66 69 6c 65 2e 0a  ns of the file..
0d80: 0a 20 2a 20 20 47 69 76 65 6e 20 61 6e 79 20 76  . *  Given any v
0d90: 65 72 73 69 6f 6e 20 75 75 69 64 2c 20 63 6f 6e  ersion uuid, con
0da0: 73 74 72 75 63 74 20 61 20 5a 49 50 20 61 72 63  struct a ZIP arc
0db0: 68 69 76 65 20 74 68 61 74 20 63 6f 6e 74 61 69  hive that contai
0dc0: 6e 73 0a 20 20 20 20 74 68 65 20 63 6f 6d 70 6c  ns.    the compl
0dd0: 65 74 65 20 63 6f 6e 74 65 6e 74 20 66 6f 72 20  ete content for 
0de0: 74 68 61 74 20 76 65 72 73 69 6f 6e 2e 20 20 46  that version.  F
0df0: 65 61 74 75 72 65 20 73 68 6f 75 6c 64 20 62 65  eature should be
0e00: 0a 20 20 20 20 63 61 6c 6c 61 62 6c 65 20 66 72  .    callable fr
0e10: 6f 6d 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2d 6c  om the command-l
0e20: 69 6e 65 20 6f 72 20 66 72 6f 6d 20 74 68 65 20  ine or from the 
0e30: 77 77 77 20 69 6e 74 65 72 66 61 63 65 2e 0a 20  www interface.. 
0e40: 20 20 20 50 65 72 68 61 70 73 20 61 20 68 79 70     Perhaps a hyp
0e50: 65 72 6c 69 6e 6b 20 6f 6e 20 74 68 65 20 76 69  erlink on the vi
0e60: 6e 66 6f 20 70 61 67 65 20 74 6f 20 64 6f 77 6e  nfo page to down
0e70: 6c 6f 61 64 20 74 68 65 20 5a 49 50 20 61 72 63  load the ZIP arc
0e80: 68 69 76 65 0a 20 20 20 20 66 6f 72 20 61 6e 79  hive.    for any
0e90: 20 76 65 72 73 69 6f 6e 2e 0a 0a 20 2a 20 20 54   version... *  T
0ea0: 69 6d 65 6c 69 6e 65 20 65 6e 68 61 6e 63 65 64  imeline enhanced
0eb0: 20 73 6f 20 74 68 61 74 20 79 6f 75 20 63 61 6e   so that you can
0ec0: 20 73 70 65 63 69 66 79 20 61 20 72 61 6e 67 65   specify a range
0ed0: 20 6f 66 20 64 61 74 65 73 2e 0a 0a 20 2a 20 20   of dates... *  
0ee0: 54 68 65 20 2f 78 66 65 72 20 68 61 6e 64 6c 65  The /xfer handle
0ef0: 72 20 28 66 6f 72 20 70 75 73 68 2c 20 70 75 6c  r (for push, pul
0f00: 6c 2c 20 61 6e 64 20 63 6c 6f 6e 65 29 20 64 6f  l, and clone) do
0f10: 65 73 20 6e 6f 74 20 64 6f 0a 20 20 20 20 64 65  es not do.    de
0f20: 6c 74 61 20 63 6f 6d 70 72 65 73 73 69 6f 6e 2e  lta compression.
0f30: 20 20 54 68 69 73 20 72 65 73 75 6c 74 73 20 69    This results i
0f40: 6e 20 65 78 63 65 73 73 20 62 61 6e 64 77 69 64  n excess bandwid
0f50: 74 68 20 75 73 61 67 65 2e 0a 20 20 20 20 54 68  th usage..    Th
0f60: 65 72 65 20 61 72 65 20 73 6f 6d 65 20 63 6f 64  ere are some cod
0f70: 65 20 69 6e 20 78 66 65 72 2e 63 20 74 68 61 74  e in xfer.c that
0f80: 20 61 72 65 20 73 6b 65 74 63 68 65 73 20 6f 66   are sketches of
0f90: 20 69 64 65 61 73 20 6f 6e 0a 20 20 20 20 68 6f   ideas on.    ho
0fa0: 77 20 74 6f 20 64 6f 20 64 65 6c 74 61 20 63 6f  w to do delta co
0fb0: 6d 70 72 65 73 73 69 6f 6e 2c 20 62 75 74 20 6e  mpression, but n
0fc0: 6f 74 68 69 6e 67 20 68 61 73 20 62 65 65 6e 20  othing has been 
0fd0: 69 6d 70 6c 65 6d 65 6e 74 65 64 2e 0a 0a 20 2a  implemented... *
0fe0: 20 20 45 6e 68 61 6e 63 65 6d 65 6e 74 73 20 74    Enhancements t
0ff0: 6f 20 74 68 65 20 64 69 66 66 20 61 6e 64 20 74  o the diff and t
1000: 6b 64 69 66 66 20 63 6f 6d 6d 61 6e 64 73 20 69  kdiff commands i
1010: 6e 20 74 68 65 20 63 6c 69 2e 0a 20 20 20 20 41  n the cli..    A
1020: 6c 6c 6f 77 20 74 68 65 20 65 6e 74 69 72 65 20  llow the entire 
1030: 74 72 65 65 20 6f 72 20 61 20 73 75 62 74 72 65  tree or a subtre
1040: 65 20 74 6f 20 62 65 20 64 69 66 66 65 64 2c 20  e to be diffed, 
1050: 6e 6f 74 20 6a 75 73 74 20 61 20 0a 20 20 20 20  not just a .    
1060: 73 69 6e 67 6c 65 20 66 69 6c 65 2e 20 20 41 6c  single file.  Al
1070: 6c 6f 77 20 64 69 66 66 73 20 61 67 61 69 6e 73  low diffs agains
1080: 74 20 61 6e 79 20 74 77 6f 20 61 72 62 69 74 72  t any two arbitr
1090: 61 72 79 20 76 65 72 73 69 6f 6e 73 2c 0a 20 20  ary versions,.  
10a0: 20 20 6e 6f 74 20 6a 75 73 74 20 64 69 66 66 73    not just diffs
10b0: 20 61 67 61 69 6e 73 74 20 74 68 65 20 63 75 72   against the cur
10c0: 72 65 6e 74 20 63 68 65 63 6b 2d 6f 75 74 2e 20  rent check-out. 
10d0: 20 41 6c 6c 6f 77 20 0a 20 20 20 20 63 6f 6e 66   Allow .    conf
10e0: 69 67 75 72 61 74 69 6f 6e 20 6f 70 74 69 6f 6e  iguration option
10f0: 73 20 74 6f 20 72 65 70 6c 61 63 65 20 74 6b 64  s to replace tkd
1100: 69 66 66 20 77 69 74 68 20 73 6f 6d 65 20 6f 74  iff with some ot
1110: 68 65 72 0a 20 20 20 20 76 69 73 75 61 6c 20 64  her.    visual d
1120: 69 66 66 65 72 20 6f 66 20 74 68 65 20 75 73 65  iffer of the use
1130: 72 73 20 63 68 6f 69 63 65 2e 0a 0a 20 2a 20 20  rs choice... *  
1140: 54 69 63 6b 65 74 69 6e 67 20 69 6e 74 65 72 66  Ticketing interf
1150: 61 63 65 20 28 65 78 70 61 6e 64 20 74 68 69 73  ace (expand this
1160: 20 62 75 6c 6c 65 74 29 0a 0a 20 20 20 20 20 2b   bullet)..     +
1170: 20 20 43 72 65 61 74 65 20 6e 65 77 20 74 69 63    Create new tic
1180: 6b 65 74 73 20 61 73 20 66 69 6c 65 73 20 69 6e  kets as files in
1190: 20 74 68 65 20 66 69 6c 65 20 68 69 65 72 61 72   the file hierar
11a0: 63 68 79 0a 20 20 20 20 20 2b 20 20 41 70 70 65  chy.     +  Appe
11b0: 6e 64 20 72 65 6d 61 72 6b 73 20 74 6f 20 61 20  nd remarks to a 
11c0: 74 69 63 6b 65 74 0a 20 20 20 20 20 2b 20 20 41  ticket.     +  A
11d0: 64 64 20 61 74 74 61 63 68 6d 65 6e 74 73 20 74  dd attachments t
11e0: 6f 20 61 20 74 69 63 6b 65 74 0a 20 20 20 20 20  o a ticket.     
11f0: 2b 20 20 43 68 61 6e 67 65 20 61 74 74 72 69 62  +  Change attrib
1200: 75 74 65 73 20 6f 66 20 61 20 74 69 63 6b 65 74  utes of a ticket
1210: 0a 20 20 20 20 20 2b 20 20 44 65 6c 65 74 65 20  .     +  Delete 
1220: 74 69 63 6b 65 74 73 20 74 68 61 74 20 61 72 65  tickets that are
1230: 20 6e 6f 20 6c 6f 6e 67 65 72 20 63 75 72 72 65   no longer curre
1240: 6e 74 2e 20 20 28 54 68 65 20 6f 6c 64 0a 20 20  nt.  (The old.  
1250: 20 20 20 20 20 20 63 6f 6e 74 65 6e 74 20 69 73        content is
1260: 20 73 74 69 6c 6c 20 61 63 63 65 73 73 69 62 6c   still accessibl
1270: 65 2c 20 74 68 65 20 74 69 63 6b 65 74 20 69 73  e, the ticket is
1280: 20 6a 75 73 74 20 6e 6f 74 20 69 6e 0a 20 20 20   just not in.   
1290: 20 20 20 20 20 74 68 65 20 63 75 72 72 65 6e 74       the current
12a0: 20 63 68 65 63 6b 2d 6f 75 74 2e 29 0a 20 20 20   check-out.).   
12b0: 20 20 2b 20 20 53 65 72 76 65 72 20 73 65 74 75    +  Server setu
12c0: 70 20 74 6f 20 64 65 66 69 6e 65 20 74 68 65 20  p to define the 
12d0: 61 6c 6c 6f 77 65 64 20 61 74 74 72 69 62 75 74  allowed attribut
12e0: 65 73 20 61 6e 64 0a 20 20 20 20 20 20 20 20 61  es and.        a
12f0: 74 74 72 69 62 75 74 65 20 76 61 6c 75 65 73 20  ttribute values 
1300: 66 6f 72 20 74 69 63 6b 65 74 73 0a 20 20 20 20  for tickets.    
1310: 20 2b 20 20 50 65 72 6d 61 6e 65 6e 74 6c 79 20   +  Permanently 
1320: 72 65 6d 6f 76 65 20 6d 61 6c 69 63 69 6f 75 73  remove malicious
1330: 20 65 64 69 74 73 20 61 6e 64 2f 6f 72 20 61 74   edits and/or at
1340: 74 61 63 68 6d 65 6e 74 73 0a 20 20 20 20 20 20  tachments.      
1350: 20 20 73 75 63 68 20 61 73 20 77 69 6b 69 2d 73    such as wiki-s
1360: 70 61 6d 20 6f 72 20 77 61 72 65 7a 2e 20 20 28  pam or warez.  (
1370: 43 6f 6e 74 65 6e 74 20 69 73 20 6e 6f 20 6c 6f  Content is no lo
1380: 6e 67 65 72 20 61 63 63 65 73 73 69 62 6c 65 2e  nger accessible.
1390: 29 0a 20 20 20 20 20 2b 20 20 56 69 65 77 20 61  ).     +  View a
13a0: 20 68 69 73 74 6f 72 79 20 6f 66 20 61 6c 6c 20   history of all 
13b0: 63 68 61 6e 67 65 73 20 74 6f 20 61 20 74 69 63  changes to a tic
13c0: 6b 65 74 0a 20 20 20 20 20 2b 20 20 47 65 6e 65  ket.     +  Gene
13d0: 72 61 74 65 20 72 65 70 6f 72 74 73 20 6f 76 65  rate reports ove
13e0: 72 20 61 6c 6c 20 74 69 63 6b 65 74 73 0a 20 20  r all tickets.  
13f0: 20 20 20 2b 20 20 47 65 6e 65 72 61 74 65 20 72     +  Generate r
1400: 65 70 6f 72 74 73 20 6f 76 65 72 20 61 6c 6c 20  eports over all 
1410: 74 69 63 6b 65 74 73 20 61 73 20 74 68 65 79 20  tickets as they 
1420: 65 78 69 73 74 65 64 20 66 6f 72 0a 20 20 20 20  existed for.    
1430: 20 20 20 20 61 20 63 68 6f 73 65 6e 20 70 6f 69      a chosen poi
1440: 6e 74 20 69 6e 20 74 69 6d 65 20 61 6e 64 20 73  nt in time and s
1450: 70 61 63 65 2e 0a 20 20 20 20 20 2b 20 20 44 6f  pace..     +  Do
1460: 20 66 75 6c 6c 20 74 65 78 74 20 73 65 61 72 63   full text searc
1470: 68 20 61 67 61 69 6e 73 74 20 74 68 65 20 74 65  h against the te
1480: 78 74 20 69 6e 20 61 6e 79 20 73 69 6e 67 6c 65  xt in any single
1490: 20 74 69 63 6b 65 74 20 6f 72 0a 20 20 20 20 20   ticket or.     
14a0: 20 20 20 61 63 72 6f 73 73 20 74 68 65 20 63 75     across the cu
14b0: 72 72 65 6e 74 20 76 65 72 73 69 6f 6e 73 20 6f  rrent versions o
14c0: 66 20 61 6c 6c 20 74 69 63 6b 65 74 73 2c 20 6f  f all tickets, o
14d0: 72 20 61 63 72 6f 73 73 20 61 6c 6c 20 63 75 72  r across all cur
14e0: 72 65 6e 74 0a 20 20 20 20 20 20 20 20 61 6e 64  rent.        and
14f0: 20 68 69 73 74 6f 72 69 63 61 6c 20 76 65 72 73   historical vers
1500: 69 6f 6e 73 20 6f 66 20 61 6c 6c 20 74 69 63 6b  ions of all tick
1510: 65 74 73 2e 0a 0a 20 2a 20 20 57 69 6b 69 20 69  ets... *  Wiki i
1520: 6e 74 65 72 66 61 63 65 20 28 65 78 70 61 6e 64  nterface (expand
1530: 20 74 68 69 73 20 62 75 6c 6c 65 74 29 0a 0a 20   this bullet).. 
1540: 20 20 20 20 2b 20 20 43 72 65 61 74 65 20 6e 65      +  Create ne
1550: 77 20 77 69 6b 69 20 70 61 67 65 73 0a 20 20 20  w wiki pages.   
1560: 20 20 2b 20 20 44 65 73 69 67 6e 61 74 65 20 61    +  Designate a
1570: 20 73 69 6e 67 6c 65 20 77 69 6b 69 20 70 61 67   single wiki pag
1580: 65 20 61 73 20 74 68 65 20 68 6f 6d 65 20 70 61  e as the home pa
1590: 67 65 20 66 6f 72 20 74 68 65 20 77 77 77 20 69  ge for the www i
15a0: 6e 74 65 72 66 61 63 65 0a 20 20 20 20 20 2b 20  nterface.     + 
15b0: 20 44 65 73 69 67 6e 61 74 65 20 77 69 6b 69 20   Designate wiki 
15c0: 70 61 67 65 73 20 61 73 20 72 65 61 64 2d 6f 6e  pages as read-on
15d0: 6c 79 2c 20 61 70 70 65 6e 64 2d 6f 6e 6c 79 2c  ly, append-only,
15e0: 20 6f 72 20 72 65 61 64 2f 77 72 69 74 65 2e 0a   or read/write..
15f0: 20 20 20 20 20 2b 20 20 41 70 70 65 6e 64 20 63       +  Append c
1600: 6f 6d 6d 65 6e 74 73 20 74 6f 20 61 20 77 69 6b  omments to a wik
1610: 69 20 70 61 67 65 0a 20 20 20 20 20 2b 20 20 41  i page.     +  A
1620: 64 64 20 61 74 74 61 63 68 6d 65 6e 74 73 20 28  dd attachments (
1630: 73 75 63 68 20 61 73 20 47 49 46 20 69 6d 61 67  such as GIF imag
1640: 65 73 29 20 74 6f 20 61 20 77 69 6b 69 20 70 61  es) to a wiki pa
1650: 67 65 0a 20 20 20 20 20 2b 20 20 43 68 61 6e 67  ge.     +  Chang
1660: 65 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66  e the content of
1670: 20 61 20 77 69 6b 69 20 70 61 67 65 0a 20 20 20   a wiki page.   
1680: 20 20 2b 20 20 44 65 6c 65 74 65 20 6f 62 73 6f    +  Delete obso
1690: 6c 65 74 65 20 77 69 6b 69 20 70 61 67 65 73 2e  lete wiki pages.
16a0: 20 20 28 4f 6c 64 20 63 6f 6e 74 65 6e 74 20 69    (Old content i
16b0: 73 20 73 74 69 6c 6c 20 61 63 63 65 73 73 69 62  s still accessib
16c0: 6c 65 2c 0a 20 20 20 20 20 20 20 20 74 68 65 20  le,.        the 
16d0: 70 61 67 65 20 69 73 20 6a 75 73 74 20 6e 6f 74  page is just not
16e0: 20 6f 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20   on the current 
16f0: 6c 69 73 74 20 6f 66 20 70 61 67 65 73 2e 29 0a  list of pages.).
1700: 20 20 20 20 20 2b 20 20 50 65 72 6d 61 6e 65 6e       +  Permanen
1710: 74 6c 79 20 72 65 6d 6f 76 65 20 6d 61 6c 69 63  tly remove malic
1720: 69 6f 75 73 20 65 64 69 74 73 20 61 6e 64 2f 6f  ious edits and/o
1730: 72 20 61 74 74 61 63 68 6d 65 6e 74 73 0a 20 20  r attachments.  
1740: 20 20 20 20 20 20 73 75 63 68 20 61 73 20 77 69        such as wi
1750: 6b 69 2d 73 70 61 6d 20 6f 72 20 77 61 72 65 7a  ki-spam or warez
1760: 2e 20 20 28 4f 6c 64 20 63 6f 6e 74 65 6e 74 20  .  (Old content 
1770: 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 61 63 63  is no longer acc
1780: 65 73 73 69 62 6c 65 2e 29 0a 20 20 20 20 20 2b  essible.).     +
1790: 20 20 41 64 64 20 6e 6f 66 6f 6c 6c 6f 77 20 6f    Add nofollow o
17a0: 6e 20 65 78 74 65 72 6e 61 6c 20 6c 69 6e 6b 73  n external links
17b0: 20 61 64 64 65 64 20 62 79 20 75 6e 70 72 69 76   added by unpriv
17c0: 69 6c 65 67 65 64 0a 20 20 20 20 20 20 20 20 75  ileged.        u
17d0: 73 65 72 73 20 77 68 65 6e 20 74 68 65 20 6c 69  sers when the li
17e0: 6e 6b 20 69 73 20 6c 65 73 73 20 74 68 61 6e 20  nk is less than 
17f0: 4e 20 68 6f 75 72 73 20 6f 6c 64 2e 0a 20 20 20  N hours old..   
1800: 20 20 2b 20 20 53 68 6f 77 20 74 68 65 20 63 6f    +  Show the co
1810: 6d 70 6c 65 74 65 20 68 69 73 74 6f 72 79 20 6f  mplete history o
1820: 66 20 61 20 73 69 6e 67 6c 65 20 77 69 6b 69 20  f a single wiki 
1830: 70 61 67 65 0a 20 20 20 20 20 2b 20 20 50 72 6f  page.     +  Pro
1840: 76 69 64 65 20 74 68 65 20 61 62 69 6c 69 74 79  vide the ability
1850: 20 74 6f 20 64 69 66 66 20 74 77 6f 20 76 65 72   to diff two ver
1860: 73 69 6f 6e 73 20 6f 66 20 61 20 77 69 6b 69 20  sions of a wiki 
1870: 70 61 67 65 0a 20 20 20 20 20 2b 20 20 53 68 6f  page.     +  Sho
1880: 77 20 61 20 6c 69 73 74 69 6e 67 20 6f 66 20 61  w a listing of a
1890: 6c 6c 20 77 69 6b 69 20 70 61 67 65 73 2c 20 62  ll wiki pages, b
18a0: 6f 74 68 20 63 75 72 72 65 6e 74 20 61 6e 64 20  oth current and 
18b0: 64 65 6c 65 74 65 64 0a 20 20 20 20 20 2b 20 20  deleted.     +  
18c0: 44 6f 20 61 20 66 75 6c 6c 2d 74 65 78 74 20 73  Do a full-text s
18d0: 65 61 72 63 68 20 61 67 61 69 6e 73 74 20 63 75  earch against cu
18e0: 72 72 65 6e 74 20 76 65 72 73 69 6f 6e 73 20 6f  rrent versions o
18f0: 66 20 61 6c 6c 20 77 69 6b 69 20 70 61 67 65 73  f all wiki pages
1900: 0a 20 20 20 20 20 2b 20 20 44 6f 20 61 20 66 75  .     +  Do a fu
1910: 6c 6c 2d 74 65 78 74 20 73 65 61 72 63 68 20 61  ll-text search a
1920: 67 61 69 6e 73 74 20 61 6c 6c 20 68 69 73 74 6f  gainst all histo
1930: 72 69 63 61 6c 20 76 65 72 73 69 6f 6e 73 20 6f  rical versions o
1940: 66 20 61 20 73 69 6e 67 6c 65 0a 20 20 20 20 20  f a single.     
1950: 20 20 20 77 69 6b 69 20 70 61 67 65 0a 20 20 20     wiki page.   
1960: 20 20 2b 20 20 44 6f 20 61 20 66 75 6c 6c 2d 74    +  Do a full-t
1970: 65 78 74 20 73 65 61 72 63 68 20 61 67 61 69 6e  ext search again
1980: 73 74 20 61 6c 6c 20 68 69 73 74 6f 72 69 63 61  st all historica
1990: 6c 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 61 6c  l versions of al
19a0: 6c 0a 20 20 20 20 20 20 20 20 77 69 6b 69 20 70  l.        wiki p
19b0: 61 67 65 73 0a 0a 20 2a 20 20 46 75 6c 6c 2d 74  ages.. *  Full-t
19c0: 65 78 74 20 73 65 61 72 63 68 20 61 67 61 69 6e  ext search again
19d0: 73 74 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d 6d  st check-in comm
19e0: 65 6e 74 73 20 61 6e 64 20 64 69 66 66 73 20 6f  ents and diffs o
19f0: 66 20 65 61 63 68 0a 20 20 20 20 63 68 65 63 6b  f each.    check
1a00: 2d 69 6e 2e 0a 0a 20 2a 20 20 41 62 69 6c 69 74  -in... *  Abilit
1a10: 79 20 74 6f 20 63 68 65 63 6b 2d 69 6e 20 73 6f  y to check-in so
1a20: 6d 65 20 73 75 62 73 65 74 20 6f 66 20 63 68 61  me subset of cha
1a30: 6e 67 65 73 20 74 6f 20 74 68 65 20 74 72 65 65  nges to the tree
1a40: 20 69 6e 73 74 65 61 64 0a 20 20 20 20 6f 66 20   instead.    of 
1a50: 68 61 76 69 6e 67 20 74 6f 20 63 68 65 63 6b 20  having to check 
1a60: 69 6e 20 61 6c 6c 20 63 68 61 6e 67 65 73 2e 0a  in all changes..
1a70: 0a 20 2a 20 20 41 64 64 20 61 20 22 72 65 76 65  . *  Add a "reve
1a80: 72 74 22 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74  rt" command that
1a90: 20 77 69 6c 6c 20 75 6e 64 6f 20 61 6c 6c 20 63   will undo all c
1aa0: 68 61 6e 67 65 73 20 74 6f 20 61 20 66 69 6c 65  hanges to a file
1ab0: 0a 20 20 20 20 6f 72 20 66 69 6c 65 73 20 69 6e  .    or files in
1ac0: 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 68 65   the current che
1ad0: 63 6b 2d 6f 75 74 20 2d 20 72 65 73 74 6f 72 69  ck-out - restori
1ae0: 6e 67 20 74 68 65 20 66 69 6c 65 73 20 62 61 63  ng the files bac
1af0: 6b 0a 20 20 20 20 74 6f 20 74 68 65 69 72 20 6f  k.    to their o
1b00: 72 69 67 69 6e 61 6c 20 63 68 65 63 6b 2d 6f 75  riginal check-ou
1b10: 74 20 73 74 61 74 65 2e 0a 0a 20 2a 20 20 41 64  t state... *  Ad
1b20: 64 20 61 6e 20 22 61 6e 6e 6f 74 61 74 65 22 20  d an "annotate" 
1b30: 63 6f 6d 6d 61 6e 64 20 69 6e 20 62 6f 74 68 20  command in both 
1b40: 74 68 65 20 63 6c 69 20 61 6e 64 20 74 68 65 20  the cli and the 
1b50: 77 77 77 20 69 6e 74 65 72 66 61 63 65 0a 20 20  www interface.  
1b60: 20 20 74 68 61 74 20 77 69 6c 6c 20 73 68 6f 77    that will show
1b70: 20 6c 69 6e 65 2d 62 79 2d 6c 69 6e 65 20 74 68   line-by-line th
1b80: 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 63 68  e most recent ch
1b90: 61 6e 67 65 73 20 74 6f 20 65 76 65 72 79 20 6c  anges to every l
1ba0: 69 6e 65 0a 20 20 20 20 69 6e 20 74 68 65 20 66  ine.    in the f
1bb0: 69 6c 65 2e 0a 0a 20 2a 20 20 42 72 6f 77 73 65  ile... *  Browse
1bc0: 20 74 68 65 20 66 69 6c 65 20 68 69 65 72 61 72   the file hierar
1bd0: 63 68 79 2c 20 73 69 6d 69 6c 61 72 20 74 6f 20  chy, similar to 
1be0: 74 68 65 20 22 42 72 6f 77 73 65 22 20 66 65 61  the "Browse" fea
1bf0: 74 75 72 65 20 69 6e 0a 20 20 20 20 43 56 53 54  ture in.    CVST
1c00: 72 61 63 2e 0a 0a 20 2a 20 20 41 64 64 20 74 68  rac... *  Add th
1c10: 65 20 61 62 69 6c 69 74 79 20 74 6f 20 6f 76 65  e ability to ove
1c20: 72 72 69 64 65 20 63 68 65 63 6b 2d 69 6e 20 63  rride check-in c
1c30: 6f 6d 6d 65 6e 74 73 2e 20 20 49 74 20 69 73 20  omments.  It is 
1c40: 6e 6f 74 20 70 6f 73 73 69 62 6c 65 0a 20 20 20  not possible.   
1c50: 20 74 6f 20 63 68 61 6e 67 65 20 74 68 65 20 63   to change the c
1c60: 6f 6d 6d 65 6e 74 20 69 6e 20 74 68 65 20 63 68  omment in the ch
1c70: 65 63 6b 2d 69 6e 20 69 74 73 65 6c 66 20 64 75  eck-in itself du
1c80: 65 20 74 6f 20 74 68 65 20 63 72 79 70 74 6f 67  e to the cryptog
1c90: 72 61 70 68 69 63 0a 20 20 20 20 68 61 73 68 2e  raphic.    hash.
1ca0: 20 20 42 75 74 20 79 6f 75 20 63 61 6e 20 61 64    But you can ad
1cb0: 64 20 61 20 6e 65 77 20 72 65 63 6f 72 64 20 74  d a new record t
1cc0: 6f 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79  o the repository
1cd0: 20 74 68 61 74 20 6f 76 65 72 6c 6f 61 64 73 0a   that overloads.
1ce0: 20 20 20 20 61 20 63 68 65 63 6b 2d 69 6e 20 63      a check-in c
1cf0: 6f 6d 6d 65 6e 74 20 77 69 74 68 20 61 20 6e 65  omment with a ne
1d00: 77 20 63 6f 6d 6d 65 6e 74 2e 20 20 43 6f 6d 6d  w comment.  Comm
1d10: 65 6e 74 20 63 68 61 6e 67 65 73 20 73 68 6f 75  ent changes shou
1d20: 6c 64 20 62 65 0a 20 20 20 20 47 50 47 20 63 6c  ld be.    GPG cl
1d30: 65 61 72 73 69 67 6e 65 64 20 61 74 20 74 68 65  earsigned at the
1d40: 20 76 65 72 79 20 6c 65 61 73 74 2e 20 20 43 6f   very least.  Co
1d50: 6d 6d 65 6e 74 20 63 68 61 6e 67 65 73 20 6f 6e  mment changes on
1d60: 6c 79 20 61 70 70 6c 79 20 69 66 0a 20 20 20 20  ly apply if.    
1d70: 74 68 65 20 75 73 65 72 20 77 68 6f 20 6d 61 64  the user who mad
1d80: 65 20 74 68 65 20 63 68 61 6e 67 65 20 68 61 73  e the change has
1d90: 20 74 68 65 20 72 69 67 68 74 20 70 65 72 6d 69   the right permi
1da0: 73 73 69 6f 6e 73 2e 0a 0a 20 2a 20 20 4e 65 77  ssions... *  New
1db0: 20 63 6c 69 20 63 6f 6d 6d 61 6e 64 73 3a 20 22   cli commands: "
1dc0: 64 65 63 6f 6e 73 74 72 75 63 74 22 20 61 6e 64  deconstruct" and
1dd0: 20 22 72 65 63 6f 6e 73 74 72 75 63 74 22 2e 20   "reconstruct". 
1de0: 20 54 68 65 20 64 65 63 6f 6e 73 74 72 75 63 74   The deconstruct
1df0: 0a 20 20 20 20 63 6f 6d 6d 61 6e 64 20 70 6f 70  .    command pop
1e00: 75 6c 61 74 65 73 20 61 6e 20 69 6e 64 69 63 61  ulates an indica
1e10: 74 65 64 20 64 69 72 65 63 74 6f 72 79 20 77 69  ted directory wi
1e20: 74 68 20 63 6f 70 69 65 73 20 6f 66 20 61 6c 6c  th copies of all
1e30: 20 66 69 6c 65 73 0a 20 20 20 20 63 6f 6e 74 61   files.    conta
1e40: 69 6e 65 64 20 77 69 74 68 69 6e 20 74 68 65 20  ined within the 
1e50: 72 65 70 6f 73 69 74 6f 72 79 2e 20 20 46 69 6c  repository.  Fil
1e60: 65 73 20 61 72 65 20 6e 61 6d 65 64 20 61 61 61  es are named aaa
1e70: 2f 62 62 62 62 62 62 62 20 77 68 65 72 65 0a 20  /bbbbbbb where. 
1e80: 20 20 20 61 61 61 20 69 73 20 74 68 65 20 66 69     aaa is the fi
1e90: 72 73 74 20 33 20 63 68 61 72 61 63 74 65 72 73  rst 3 characters
1ea0: 20 6f 66 20 74 68 65 20 75 75 69 64 20 61 6e 64   of the uuid and
1eb0: 20 62 62 62 62 62 62 20 69 73 20 74 68 65 0a 20   bbbbbb is the. 
1ec0: 20 20 20 72 65 6d 61 69 6e 69 6e 67 20 33 37 20     remaining 37 
1ed0: 63 68 61 72 61 63 74 65 72 73 2e 20 20 72 65 63  characters.  rec
1ee0: 6f 6e 73 74 72 75 63 74 20 62 75 69 6c 64 73 20  onstruct builds 
1ef0: 61 20 6e 65 77 20 72 65 70 6f 73 69 74 6f 72 79  a new repository
1f00: 0a 20 20 20 20 63 6f 6e 74 61 69 6e 69 6e 67 20  .    containing 
1f10: 61 6c 6c 20 66 69 6c 65 73 20 69 6e 20 61 6e 20  all files in an 
1f20: 69 6e 64 69 63 61 74 65 64 20 64 69 72 65 63 74  indicated direct
1f30: 6f 72 79 2e 20 20 57 68 65 6e 20 72 65 63 6f 6e  ory.  When recon
1f40: 73 74 72 75 63 74 69 6e 67 2c 0a 20 20 20 20 73  structing,.    s
1f50: 6f 6d 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20  ome information 
1f60: 69 73 20 6c 6f 73 74 3a 20 70 72 6f 6a 65 63 74  is lost: project
1f70: 2d 63 6f 64 65 2c 20 73 65 72 76 65 72 2d 63 6f  -code, server-co
1f80: 64 65 2c 20 75 73 65 72 73 2e 20 20 0a 20 20 20  de, users.  .   
1f90: 20 4a 75 73 74 20 6d 61 6b 65 20 75 70 20 61 20   Just make up a 
1fa0: 6e 65 77 20 70 72 6f 6a 65 63 74 2d 63 6f 64 65  new project-code
1fb0: 2e 20 20 0a 0a 20 2a 20 20 47 65 74 20 61 20 62  .  .. *  Get a b
1fc0: 75 69 6c 64 20 77 6f 72 6b 69 6e 67 20 66 6f 72  uild working for
1fd0: 20 77 69 6e 33 32 2e 20 20 50 65 72 68 61 70 73   win32.  Perhaps
1fe0: 20 75 73 65 20 63 79 67 77 69 6e 2e 20 20 4f 72   use cygwin.  Or
1ff0: 20 6f 6d 69 74 0a 20 20 20 20 74 68 65 20 73 65   omit.    the se
2000: 72 76 65 72 20 63 6f 6d 70 6f 6e 65 6e 74 20 66  rver component f
2010: 72 6f 6d 20 77 69 6e 33 32 20 28 74 6f 20 65 6c  rom win32 (to el
2020: 69 6d 69 6e 61 74 65 20 74 68 65 20 6e 65 65 64  iminate the need
2030: 20 66 6f 72 20 66 6f 72 6b 28 29 29 2e 0a 0a 20   for fork())... 
2040: 2a 20 20 4d 61 6b 65 20 74 68 65 20 69 6e 74 65  *  Make the inte
2050: 72 66 61 63 65 20 74 6f 20 66 6f 73 73 69 6c 20  rface to fossil 
2060: 6c 6f 6f 6b 20 70 72 65 74 74 79 20 61 6e 64 20  look pretty and 
2070: 62 65 20 63 75 73 74 6f 6d 69 7a 61 62 6c 65 20  be customizable 
2080: 73 6f 0a 20 20 20 20 74 68 61 74 20 6f 74 68 65  so.    that othe
2090: 72 20 70 65 6f 70 6c 65 20 77 69 6c 6c 20 62 65  r people will be
20a0: 20 61 74 74 72 61 63 74 65 64 20 74 6f 20 69 74   attracted to it
20b0: 2c 20 77 69 6c 6c 20 74 61 6b 65 20 6f 76 65 72  , will take over
20c0: 20 6d 61 69 6e 74 65 6e 61 6e 63 65 0a 20 20 20   maintenance.   
20d0: 20 6f 66 20 69 74 2c 20 61 6e 64 20 77 65 20 63   of it, and we c
20e0: 61 6e 20 65 76 65 6e 74 75 61 6c 6c 79 20 6d 6f  an eventually mo
20f0: 76 65 20 6f 6e 20 74 6f 20 6f 74 68 65 72 20 74  ve on to other t
2100: 68 69 6e 67 73 2e 0a                             hings..