Hex Artifact Content
Not logged in

Artifact f69075047f9b5d8e3d7d622ae5e1df5dd9a3efc9:

File todo.txt part of check-in [dead090c0b] - Update the ZIP archiver to include date information. Provide a function that constructs a ZIP archive from manifest. by drh on 2007-07-31 20:20:40.

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 20 20 20 20 20 2b 20 20 41  blobs..     +  A
0c30: 64 64 20 61 20 6c 69 6e 6b 20 74 68 61 74 20 77  dd a link that w
0c40: 69 6c 6c 20 64 6f 77 6e 6c 6f 61 64 20 61 20 5a  ill download a Z
0c50: 49 50 20 61 72 63 68 69 76 65 20 63 6f 6e 74 61  IP archive conta
0c60: 69 6e 69 6e 67 20 74 68 65 0a 20 20 20 20 20 20  ining the.      
0c70: 20 20 63 6f 6d 70 6c 65 74 65 20 62 61 73 65 6c    complete basel
0c80: 69 6e 65 2e 20 20 55 73 65 20 7a 69 70 5f 6f 66  ine.  Use zip_of
0c90: 5f 62 61 73 65 6c 69 6e 65 28 29 20 66 75 6e 63  _baseline() func
0ca0: 74 69 6f 6e 20 69 6e 20 0a 20 20 20 20 20 20 20  tion in .       
0cb0: 20 7a 69 70 2e 63 20 74 6f 20 63 6f 6e 73 74 72   zip.c to constr
0cc0: 75 63 74 20 74 68 65 20 5a 49 50 20 61 72 63 68  uct the ZIP arch
0cd0: 69 76 65 2e 0a 0a 20 2a 20 20 41 20 6e 65 77 20  ive... *  A new 
0ce0: 77 65 62 70 61 67 65 3a 20 22 66 69 6e 66 6f 22  webpage: "finfo"
0cf0: 20 20 49 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62    Information ab
0d00: 6f 75 74 20 61 20 70 61 72 74 69 63 75 6c 61 72  out a particular
0d10: 20 66 69 6c 65 0a 20 20 20 20 67 69 76 65 6e 20   file.    given 
0d20: 69 74 73 20 6e 61 6d 65 2e 0a 0a 20 20 20 20 20  its name...     
0d30: 2b 20 20 41 6c 6c 20 68 69 73 74 6f 72 69 63 61  +  All historica
0d40: 6c 20 63 68 61 6e 67 65 73 20 74 6f 20 74 68 69  l changes to thi
0d50: 73 20 66 69 6c 65 20 77 69 74 68 20 76 65 72 73  s file with vers
0d60: 69 6f 6e 20 6e 75 6d 62 65 72 2c 0a 20 20 20 20  ion number,.    
0d70: 20 20 20 20 75 73 65 72 2c 20 61 6e 64 20 63 6f      user, and co
0d80: 6d 6d 65 6e 74 2c 20 61 6e 64 20 68 79 70 65 72  mment, and hyper
0d90: 6c 69 6e 6b 20 74 6f 20 74 68 65 20 76 69 6e 66  link to the vinf
0da0: 6f 20 70 61 67 65 20 66 6f 72 0a 20 20 20 20 20  o page for.     
0db0: 20 20 20 74 68 65 20 76 65 72 73 69 6f 6e 2e 20     the version. 
0dc0: 20 49 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 76 61   Information ava
0dd0: 69 6c 61 62 6c 65 20 66 72 6f 6d 20 74 68 65 20  ilable from the 
0de0: 6d 69 6e 66 6f 20 74 61 62 6c 65 2e 0a 20 20 20  minfo table..   
0df0: 20 20 2b 20 20 48 79 70 65 72 6c 69 6e 6b 73 20    +  Hyperlinks 
0e00: 66 6f 72 20 64 69 66 66 69 6e 67 20 63 6f 6e 73  for diffing cons
0e10: 65 63 75 74 69 76 65 20 76 65 72 73 69 6f 6e 73  ecutive versions
0e20: 20 6f 66 20 74 68 65 20 66 69 6c 65 2e 0a 0a 20   of the file... 
0e30: 2a 20 20 54 69 6d 65 6c 69 6e 65 20 65 6e 68 61  *  Timeline enha
0e40: 6e 63 65 64 20 73 6f 20 74 68 61 74 20 79 6f 75  nced so that you
0e50: 20 63 61 6e 20 73 70 65 63 69 66 79 20 61 20 72   can specify a r
0e60: 61 6e 67 65 20 6f 66 20 64 61 74 65 73 2e 0a 0a  ange of dates...
0e70: 20 2a 20 20 54 68 65 20 2f 78 66 65 72 20 68 61   *  The /xfer ha
0e80: 6e 64 6c 65 72 20 28 66 6f 72 20 70 75 73 68 2c  ndler (for push,
0e90: 20 70 75 6c 6c 2c 20 61 6e 64 20 63 6c 6f 6e 65   pull, and clone
0ea0: 29 20 64 6f 65 73 20 6e 6f 74 20 64 6f 0a 20 20  ) does not do.  
0eb0: 20 20 64 65 6c 74 61 20 63 6f 6d 70 72 65 73 73    delta compress
0ec0: 69 6f 6e 2e 20 20 54 68 69 73 20 72 65 73 75 6c  ion.  This resul
0ed0: 74 73 20 69 6e 20 65 78 63 65 73 73 20 62 61 6e  ts in excess ban
0ee0: 64 77 69 64 74 68 20 75 73 61 67 65 2e 0a 20 20  dwidth usage..  
0ef0: 20 20 54 68 65 72 65 20 61 72 65 20 73 6f 6d 65    There are some
0f00: 20 63 6f 64 65 20 69 6e 20 78 66 65 72 2e 63 20   code in xfer.c 
0f10: 74 68 61 74 20 61 72 65 20 73 6b 65 74 63 68 65  that are sketche
0f20: 73 20 6f 66 20 69 64 65 61 73 20 6f 6e 0a 20 20  s of ideas on.  
0f30: 20 20 68 6f 77 20 74 6f 20 64 6f 20 64 65 6c 74    how to do delt
0f40: 61 20 63 6f 6d 70 72 65 73 73 69 6f 6e 2c 20 62  a compression, b
0f50: 75 74 20 6e 6f 74 68 69 6e 67 20 68 61 73 20 62  ut nothing has b
0f60: 65 65 6e 20 69 6d 70 6c 65 6d 65 6e 74 65 64 2e  een implemented.
0f70: 0a 0a 20 2a 20 20 45 6e 68 61 6e 63 65 6d 65 6e  .. *  Enhancemen
0f80: 74 73 20 74 6f 20 74 68 65 20 64 69 66 66 20 61  ts to the diff a
0f90: 6e 64 20 74 6b 64 69 66 66 20 63 6f 6d 6d 61 6e  nd tkdiff comman
0fa0: 64 73 20 69 6e 20 74 68 65 20 63 6c 69 2e 0a 20  ds in the cli.. 
0fb0: 20 20 20 41 6c 6c 6f 77 20 74 68 65 20 65 6e 74     Allow the ent
0fc0: 69 72 65 20 74 72 65 65 20 6f 72 20 61 20 73 75  ire tree or a su
0fd0: 62 74 72 65 65 20 74 6f 20 62 65 20 64 69 66 66  btree to be diff
0fe0: 65 64 2c 20 6e 6f 74 20 6a 75 73 74 20 61 20 0a  ed, not just a .
0ff0: 20 20 20 20 73 69 6e 67 6c 65 20 66 69 6c 65 2e      single file.
1000: 20 20 41 6c 6c 6f 77 20 64 69 66 66 73 20 61 67    Allow diffs ag
1010: 61 69 6e 73 74 20 61 6e 79 20 74 77 6f 20 61 72  ainst any two ar
1020: 62 69 74 72 61 72 79 20 76 65 72 73 69 6f 6e 73  bitrary versions
1030: 2c 0a 20 20 20 20 6e 6f 74 20 6a 75 73 74 20 64  ,.    not just d
1040: 69 66 66 73 20 61 67 61 69 6e 73 74 20 74 68 65  iffs against the
1050: 20 63 75 72 72 65 6e 74 20 63 68 65 63 6b 2d 6f   current check-o
1060: 75 74 2e 20 20 41 6c 6c 6f 77 20 0a 20 20 20 20  ut.  Allow .    
1070: 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6f 70  configuration op
1080: 74 69 6f 6e 73 20 74 6f 20 72 65 70 6c 61 63 65  tions to replace
1090: 20 74 6b 64 69 66 66 20 77 69 74 68 20 73 6f 6d   tkdiff with som
10a0: 65 20 6f 74 68 65 72 0a 20 20 20 20 76 69 73 75  e other.    visu
10b0: 61 6c 20 64 69 66 66 65 72 20 6f 66 20 74 68 65  al differ of the
10c0: 20 75 73 65 72 73 20 63 68 6f 69 63 65 2e 0a 0a   users choice...
10d0: 20 2a 20 20 54 69 63 6b 65 74 69 6e 67 20 69 6e   *  Ticketing in
10e0: 74 65 72 66 61 63 65 20 28 65 78 70 61 6e 64 20  terface (expand 
10f0: 74 68 69 73 20 62 75 6c 6c 65 74 29 0a 0a 20 20  this bullet)..  
1100: 20 20 20 2b 20 20 43 72 65 61 74 65 20 6e 65 77     +  Create new
1110: 20 74 69 63 6b 65 74 73 20 61 73 20 66 69 6c 65   tickets as file
1120: 73 20 69 6e 20 74 68 65 20 66 69 6c 65 20 68 69  s in the file hi
1130: 65 72 61 72 63 68 79 0a 20 20 20 20 20 2b 20 20  erarchy.     +  
1140: 41 70 70 65 6e 64 20 72 65 6d 61 72 6b 73 20 74  Append remarks t
1150: 6f 20 61 20 74 69 63 6b 65 74 0a 20 20 20 20 20  o a ticket.     
1160: 2b 20 20 41 64 64 20 61 74 74 61 63 68 6d 65 6e  +  Add attachmen
1170: 74 73 20 74 6f 20 61 20 74 69 63 6b 65 74 0a 20  ts to a ticket. 
1180: 20 20 20 20 2b 20 20 43 68 61 6e 67 65 20 61 74      +  Change at
1190: 74 72 69 62 75 74 65 73 20 6f 66 20 61 20 74 69  tributes of a ti
11a0: 63 6b 65 74 0a 20 20 20 20 20 2b 20 20 44 65 6c  cket.     +  Del
11b0: 65 74 65 20 74 69 63 6b 65 74 73 20 74 68 61 74  ete tickets that
11c0: 20 61 72 65 20 6e 6f 20 6c 6f 6e 67 65 72 20 63   are no longer c
11d0: 75 72 72 65 6e 74 2e 20 20 28 54 68 65 20 6f 6c  urrent.  (The ol
11e0: 64 0a 20 20 20 20 20 20 20 20 63 6f 6e 74 65 6e  d.        conten
11f0: 74 20 69 73 20 73 74 69 6c 6c 20 61 63 63 65 73  t is still acces
1200: 73 69 62 6c 65 2c 20 74 68 65 20 74 69 63 6b 65  sible, the ticke
1210: 74 20 69 73 20 6a 75 73 74 20 6e 6f 74 20 69 6e  t is just not in
1220: 0a 20 20 20 20 20 20 20 20 74 68 65 20 63 75 72  .        the cur
1230: 72 65 6e 74 20 63 68 65 63 6b 2d 6f 75 74 2e 29  rent check-out.)
1240: 0a 20 20 20 20 20 2b 20 20 53 65 72 76 65 72 20  .     +  Server 
1250: 73 65 74 75 70 20 74 6f 20 64 65 66 69 6e 65 20  setup to define 
1260: 74 68 65 20 61 6c 6c 6f 77 65 64 20 61 74 74 72  the allowed attr
1270: 69 62 75 74 65 73 20 61 6e 64 0a 20 20 20 20 20  ibutes and.     
1280: 20 20 20 61 74 74 72 69 62 75 74 65 20 76 61 6c     attribute val
1290: 75 65 73 20 66 6f 72 20 74 69 63 6b 65 74 73 0a  ues for tickets.
12a0: 20 20 20 20 20 2b 20 20 50 65 72 6d 61 6e 65 6e       +  Permanen
12b0: 74 6c 79 20 72 65 6d 6f 76 65 20 6d 61 6c 69 63  tly remove malic
12c0: 69 6f 75 73 20 65 64 69 74 73 20 61 6e 64 2f 6f  ious edits and/o
12d0: 72 20 61 74 74 61 63 68 6d 65 6e 74 73 0a 20 20  r attachments.  
12e0: 20 20 20 20 20 20 73 75 63 68 20 61 73 20 77 69        such as wi
12f0: 6b 69 2d 73 70 61 6d 20 6f 72 20 77 61 72 65 7a  ki-spam or warez
1300: 2e 20 20 28 43 6f 6e 74 65 6e 74 20 69 73 20 6e  .  (Content is n
1310: 6f 20 6c 6f 6e 67 65 72 20 61 63 63 65 73 73 69  o longer accessi
1320: 62 6c 65 2e 29 0a 20 20 20 20 20 2b 20 20 56 69  ble.).     +  Vi
1330: 65 77 20 61 20 68 69 73 74 6f 72 79 20 6f 66 20  ew a history of 
1340: 61 6c 6c 20 63 68 61 6e 67 65 73 20 74 6f 20 61  all changes to a
1350: 20 74 69 63 6b 65 74 0a 20 20 20 20 20 2b 20 20   ticket.     +  
1360: 47 65 6e 65 72 61 74 65 20 72 65 70 6f 72 74 73  Generate reports
1370: 20 6f 76 65 72 20 61 6c 6c 20 74 69 63 6b 65 74   over all ticket
1380: 73 0a 20 20 20 20 20 2b 20 20 47 65 6e 65 72 61  s.     +  Genera
1390: 74 65 20 72 65 70 6f 72 74 73 20 6f 76 65 72 20  te reports over 
13a0: 61 6c 6c 20 74 69 63 6b 65 74 73 20 61 73 20 74  all tickets as t
13b0: 68 65 79 20 65 78 69 73 74 65 64 20 66 6f 72 0a  hey existed for.
13c0: 20 20 20 20 20 20 20 20 61 20 63 68 6f 73 65 6e          a chosen
13d0: 20 70 6f 69 6e 74 20 69 6e 20 74 69 6d 65 20 61   point in time a
13e0: 6e 64 20 73 70 61 63 65 2e 0a 20 20 20 20 20 2b  nd space..     +
13f0: 20 20 44 6f 20 66 75 6c 6c 20 74 65 78 74 20 73    Do full text s
1400: 65 61 72 63 68 20 61 67 61 69 6e 73 74 20 74 68  earch against th
1410: 65 20 74 65 78 74 20 69 6e 20 61 6e 79 20 73 69  e text in any si
1420: 6e 67 6c 65 20 74 69 63 6b 65 74 20 6f 72 0a 20  ngle ticket or. 
1430: 20 20 20 20 20 20 20 61 63 72 6f 73 73 20 74 68         across th
1440: 65 20 63 75 72 72 65 6e 74 20 76 65 72 73 69 6f  e current versio
1450: 6e 73 20 6f 66 20 61 6c 6c 20 74 69 63 6b 65 74  ns of all ticket
1460: 73 2c 20 6f 72 20 61 63 72 6f 73 73 20 61 6c 6c  s, or across all
1470: 20 63 75 72 72 65 6e 74 0a 20 20 20 20 20 20 20   current.       
1480: 20 61 6e 64 20 68 69 73 74 6f 72 69 63 61 6c 20   and historical 
1490: 76 65 72 73 69 6f 6e 73 20 6f 66 20 61 6c 6c 20  versions of all 
14a0: 74 69 63 6b 65 74 73 2e 0a 0a 20 2a 20 20 57 69  tickets... *  Wi
14b0: 6b 69 20 69 6e 74 65 72 66 61 63 65 20 28 65 78  ki interface (ex
14c0: 70 61 6e 64 20 74 68 69 73 20 62 75 6c 6c 65 74  pand this bullet
14d0: 29 0a 0a 20 20 20 20 20 2b 20 20 43 72 65 61 74  )..     +  Creat
14e0: 65 20 6e 65 77 20 77 69 6b 69 20 70 61 67 65 73  e new wiki pages
14f0: 0a 20 20 20 20 20 2b 20 20 44 65 73 69 67 6e 61  .     +  Designa
1500: 74 65 20 61 20 73 69 6e 67 6c 65 20 77 69 6b 69  te a single wiki
1510: 20 70 61 67 65 20 61 73 20 74 68 65 20 68 6f 6d   page as the hom
1520: 65 20 70 61 67 65 20 66 6f 72 20 74 68 65 20 77  e page for the w
1530: 77 77 20 69 6e 74 65 72 66 61 63 65 0a 20 20 20  ww interface.   
1540: 20 20 2b 20 20 44 65 73 69 67 6e 61 74 65 20 77    +  Designate w
1550: 69 6b 69 20 70 61 67 65 73 20 61 73 20 72 65 61  iki pages as rea
1560: 64 2d 6f 6e 6c 79 2c 20 61 70 70 65 6e 64 2d 6f  d-only, append-o
1570: 6e 6c 79 2c 20 6f 72 20 72 65 61 64 2f 77 72 69  nly, or read/wri
1580: 74 65 2e 0a 20 20 20 20 20 2b 20 20 41 70 70 65  te..     +  Appe
1590: 6e 64 20 63 6f 6d 6d 65 6e 74 73 20 74 6f 20 61  nd comments to a
15a0: 20 77 69 6b 69 20 70 61 67 65 0a 20 20 20 20 20   wiki page.     
15b0: 2b 20 20 41 64 64 20 61 74 74 61 63 68 6d 65 6e  +  Add attachmen
15c0: 74 73 20 28 73 75 63 68 20 61 73 20 47 49 46 20  ts (such as GIF 
15d0: 69 6d 61 67 65 73 29 20 74 6f 20 61 20 77 69 6b  images) to a wik
15e0: 69 20 70 61 67 65 0a 20 20 20 20 20 2b 20 20 43  i page.     +  C
15f0: 68 61 6e 67 65 20 74 68 65 20 63 6f 6e 74 65 6e  hange the conten
1600: 74 20 6f 66 20 61 20 77 69 6b 69 20 70 61 67 65  t of a wiki page
1610: 0a 20 20 20 20 20 2b 20 20 44 65 6c 65 74 65 20  .     +  Delete 
1620: 6f 62 73 6f 6c 65 74 65 20 77 69 6b 69 20 70 61  obsolete wiki pa
1630: 67 65 73 2e 20 20 28 4f 6c 64 20 63 6f 6e 74 65  ges.  (Old conte
1640: 6e 74 20 69 73 20 73 74 69 6c 6c 20 61 63 63 65  nt is still acce
1650: 73 73 69 62 6c 65 2c 0a 20 20 20 20 20 20 20 20  ssible,.        
1660: 74 68 65 20 70 61 67 65 20 69 73 20 6a 75 73 74  the page is just
1670: 20 6e 6f 74 20 6f 6e 20 74 68 65 20 63 75 72 72   not on the curr
1680: 65 6e 74 20 6c 69 73 74 20 6f 66 20 70 61 67 65  ent list of page
1690: 73 2e 29 0a 20 20 20 20 20 2b 20 20 50 65 72 6d  s.).     +  Perm
16a0: 61 6e 65 6e 74 6c 79 20 72 65 6d 6f 76 65 20 6d  anently remove m
16b0: 61 6c 69 63 69 6f 75 73 20 65 64 69 74 73 20 61  alicious edits a
16c0: 6e 64 2f 6f 72 20 61 74 74 61 63 68 6d 65 6e 74  nd/or attachment
16d0: 73 0a 20 20 20 20 20 20 20 20 73 75 63 68 20 61  s.        such a
16e0: 73 20 77 69 6b 69 2d 73 70 61 6d 20 6f 72 20 77  s wiki-spam or w
16f0: 61 72 65 7a 2e 20 20 28 4f 6c 64 20 63 6f 6e 74  arez.  (Old cont
1700: 65 6e 74 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72  ent is no longer
1710: 20 61 63 63 65 73 73 69 62 6c 65 2e 29 0a 20 20   accessible.).  
1720: 20 20 20 2b 20 20 41 64 64 20 6e 6f 66 6f 6c 6c     +  Add nofoll
1730: 6f 77 20 6f 6e 20 65 78 74 65 72 6e 61 6c 20 6c  ow on external l
1740: 69 6e 6b 73 20 61 64 64 65 64 20 62 79 20 75 6e  inks added by un
1750: 70 72 69 76 69 6c 65 67 65 64 0a 20 20 20 20 20  privileged.     
1760: 20 20 20 75 73 65 72 73 20 77 68 65 6e 20 74 68     users when th
1770: 65 20 6c 69 6e 6b 20 69 73 20 6c 65 73 73 20 74  e link is less t
1780: 68 61 6e 20 4e 20 68 6f 75 72 73 20 6f 6c 64 2e  han N hours old.
1790: 0a 20 20 20 20 20 2b 20 20 53 68 6f 77 20 74 68  .     +  Show th
17a0: 65 20 63 6f 6d 70 6c 65 74 65 20 68 69 73 74 6f  e complete histo
17b0: 72 79 20 6f 66 20 61 20 73 69 6e 67 6c 65 20 77  ry of a single w
17c0: 69 6b 69 20 70 61 67 65 0a 20 20 20 20 20 2b 20  iki page.     + 
17d0: 20 50 72 6f 76 69 64 65 20 74 68 65 20 61 62 69   Provide the abi
17e0: 6c 69 74 79 20 74 6f 20 64 69 66 66 20 74 77 6f  lity to diff two
17f0: 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 61 20 77   versions of a w
1800: 69 6b 69 20 70 61 67 65 0a 20 20 20 20 20 2b 20  iki page.     + 
1810: 20 53 68 6f 77 20 61 20 6c 69 73 74 69 6e 67 20   Show a listing 
1820: 6f 66 20 61 6c 6c 20 77 69 6b 69 20 70 61 67 65  of all wiki page
1830: 73 2c 20 62 6f 74 68 20 63 75 72 72 65 6e 74 20  s, both current 
1840: 61 6e 64 20 64 65 6c 65 74 65 64 0a 20 20 20 20  and deleted.    
1850: 20 2b 20 20 44 6f 20 61 20 66 75 6c 6c 2d 74 65   +  Do a full-te
1860: 78 74 20 73 65 61 72 63 68 20 61 67 61 69 6e 73  xt search agains
1870: 74 20 63 75 72 72 65 6e 74 20 76 65 72 73 69 6f  t current versio
1880: 6e 73 20 6f 66 20 61 6c 6c 20 77 69 6b 69 20 70  ns of all wiki p
1890: 61 67 65 73 0a 20 20 20 20 20 2b 20 20 44 6f 20  ages.     +  Do 
18a0: 61 20 66 75 6c 6c 2d 74 65 78 74 20 73 65 61 72  a full-text sear
18b0: 63 68 20 61 67 61 69 6e 73 74 20 61 6c 6c 20 68  ch against all h
18c0: 69 73 74 6f 72 69 63 61 6c 20 76 65 72 73 69 6f  istorical versio
18d0: 6e 73 20 6f 66 20 61 20 73 69 6e 67 6c 65 0a 20  ns of a single. 
18e0: 20 20 20 20 20 20 20 77 69 6b 69 20 70 61 67 65         wiki page
18f0: 0a 20 20 20 20 20 2b 20 20 44 6f 20 61 20 66 75  .     +  Do a fu
1900: 6c 6c 2d 74 65 78 74 20 73 65 61 72 63 68 20 61  ll-text search a
1910: 67 61 69 6e 73 74 20 61 6c 6c 20 68 69 73 74 6f  gainst all histo
1920: 72 69 63 61 6c 20 76 65 72 73 69 6f 6e 73 20 6f  rical versions o
1930: 66 20 61 6c 6c 0a 20 20 20 20 20 20 20 20 77 69  f all.        wi
1940: 6b 69 20 70 61 67 65 73 0a 0a 20 2a 20 20 46 75  ki pages.. *  Fu
1950: 6c 6c 2d 74 65 78 74 20 73 65 61 72 63 68 20 61  ll-text search a
1960: 67 61 69 6e 73 74 20 63 68 65 63 6b 2d 69 6e 20  gainst check-in 
1970: 63 6f 6d 6d 65 6e 74 73 20 61 6e 64 20 64 69 66  comments and dif
1980: 66 73 20 6f 66 20 65 61 63 68 0a 20 20 20 20 63  fs of each.    c
1990: 68 65 63 6b 2d 69 6e 2e 0a 0a 20 2a 20 20 41 62  heck-in... *  Ab
19a0: 69 6c 69 74 79 20 74 6f 20 63 68 65 63 6b 2d 69  ility to check-i
19b0: 6e 20 73 6f 6d 65 20 73 75 62 73 65 74 20 6f 66  n some subset of
19c0: 20 63 68 61 6e 67 65 73 20 74 6f 20 74 68 65 20   changes to the 
19d0: 74 72 65 65 20 69 6e 73 74 65 61 64 0a 20 20 20  tree instead.   
19e0: 20 6f 66 20 68 61 76 69 6e 67 20 74 6f 20 63 68   of having to ch
19f0: 65 63 6b 20 69 6e 20 61 6c 6c 20 63 68 61 6e 67  eck in all chang
1a00: 65 73 2e 0a 0a 20 2a 20 20 41 64 64 20 61 20 22  es... *  Add a "
1a10: 72 65 76 65 72 74 22 20 63 6f 6d 6d 61 6e 64 20  revert" command 
1a20: 74 68 61 74 20 77 69 6c 6c 20 75 6e 64 6f 20 61  that will undo a
1a30: 6c 6c 20 63 68 61 6e 67 65 73 20 74 6f 20 61 20  ll changes to a 
1a40: 66 69 6c 65 0a 20 20 20 20 6f 72 20 66 69 6c 65  file.    or file
1a50: 73 20 69 6e 20 74 68 65 20 63 75 72 72 65 6e 74  s in the current
1a60: 20 63 68 65 63 6b 2d 6f 75 74 20 2d 20 72 65 73   check-out - res
1a70: 74 6f 72 69 6e 67 20 74 68 65 20 66 69 6c 65 73  toring the files
1a80: 20 62 61 63 6b 0a 20 20 20 20 74 6f 20 74 68 65   back.    to the
1a90: 69 72 20 6f 72 69 67 69 6e 61 6c 20 63 68 65 63  ir original chec
1aa0: 6b 2d 6f 75 74 20 73 74 61 74 65 2e 0a 0a 20 2a  k-out state... *
1ab0: 20 20 41 64 64 20 61 6e 20 22 61 6e 6e 6f 74 61    Add an "annota
1ac0: 74 65 22 20 63 6f 6d 6d 61 6e 64 20 69 6e 20 62  te" command in b
1ad0: 6f 74 68 20 74 68 65 20 63 6c 69 20 61 6e 64 20  oth the cli and 
1ae0: 74 68 65 20 77 77 77 20 69 6e 74 65 72 66 61 63  the www interfac
1af0: 65 0a 20 20 20 20 74 68 61 74 20 77 69 6c 6c 20  e.    that will 
1b00: 73 68 6f 77 20 6c 69 6e 65 2d 62 79 2d 6c 69 6e  show line-by-lin
1b10: 65 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e  e the most recen
1b20: 74 20 63 68 61 6e 67 65 73 20 74 6f 20 65 76 65  t changes to eve
1b30: 72 79 20 6c 69 6e 65 0a 20 20 20 20 69 6e 20 74  ry line.    in t
1b40: 68 65 20 66 69 6c 65 2e 0a 0a 20 2a 20 20 42 72  he file... *  Br
1b50: 6f 77 73 65 20 74 68 65 20 66 69 6c 65 20 68 69  owse the file hi
1b60: 65 72 61 72 63 68 79 2c 20 73 69 6d 69 6c 61 72  erarchy, similar
1b70: 20 74 6f 20 74 68 65 20 22 42 72 6f 77 73 65 22   to the "Browse"
1b80: 20 66 65 61 74 75 72 65 20 69 6e 0a 20 20 20 20   feature in.    
1b90: 43 56 53 54 72 61 63 2e 0a 0a 20 2a 20 20 41 64  CVSTrac... *  Ad
1ba0: 64 20 74 68 65 20 61 62 69 6c 69 74 79 20 74 6f  d the ability to
1bb0: 20 6f 76 65 72 72 69 64 65 20 63 68 65 63 6b 2d   override check-
1bc0: 69 6e 20 63 6f 6d 6d 65 6e 74 73 2e 20 20 49 74  in comments.  It
1bd0: 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65   is not possible
1be0: 0a 20 20 20 20 74 6f 20 63 68 61 6e 67 65 20 74  .    to change t
1bf0: 68 65 20 63 6f 6d 6d 65 6e 74 20 69 6e 20 74 68  he comment in th
1c00: 65 20 63 68 65 63 6b 2d 69 6e 20 69 74 73 65 6c  e check-in itsel
1c10: 66 20 64 75 65 20 74 6f 20 74 68 65 20 63 72 79  f due to the cry
1c20: 70 74 6f 67 72 61 70 68 69 63 0a 20 20 20 20 68  ptographic.    h
1c30: 61 73 68 2e 20 20 42 75 74 20 79 6f 75 20 63 61  ash.  But you ca
1c40: 6e 20 61 64 64 20 61 20 6e 65 77 20 72 65 63 6f  n add a new reco
1c50: 72 64 20 74 6f 20 74 68 65 20 72 65 70 6f 73 69  rd to the reposi
1c60: 74 6f 72 79 20 74 68 61 74 20 6f 76 65 72 6c 6f  tory that overlo
1c70: 61 64 73 0a 20 20 20 20 61 20 63 68 65 63 6b 2d  ads.    a check-
1c80: 69 6e 20 63 6f 6d 6d 65 6e 74 20 77 69 74 68 20  in comment with 
1c90: 61 20 6e 65 77 20 63 6f 6d 6d 65 6e 74 2e 20 20  a new comment.  
1ca0: 43 6f 6d 6d 65 6e 74 20 63 68 61 6e 67 65 73 20  Comment changes 
1cb0: 73 68 6f 75 6c 64 20 62 65 0a 20 20 20 20 47 50  should be.    GP
1cc0: 47 20 63 6c 65 61 72 73 69 67 6e 65 64 20 61 74  G clearsigned at
1cd0: 20 74 68 65 20 76 65 72 79 20 6c 65 61 73 74 2e   the very least.
1ce0: 20 20 43 6f 6d 6d 65 6e 74 20 63 68 61 6e 67 65    Comment change
1cf0: 73 20 6f 6e 6c 79 20 61 70 70 6c 79 20 69 66 0a  s only apply if.
1d00: 20 20 20 20 74 68 65 20 75 73 65 72 20 77 68 6f      the user who
1d10: 20 6d 61 64 65 20 74 68 65 20 63 68 61 6e 67 65   made the change
1d20: 20 68 61 73 20 74 68 65 20 72 69 67 68 74 20 70   has the right p
1d30: 65 72 6d 69 73 73 69 6f 6e 73 2e 0a 0a 20 2a 20  ermissions... * 
1d40: 20 4e 65 77 20 63 6c 69 20 63 6f 6d 6d 61 6e 64   New cli command
1d50: 73 3a 20 22 64 65 63 6f 6e 73 74 72 75 63 74 22  s: "deconstruct"
1d60: 20 61 6e 64 20 22 72 65 63 6f 6e 73 74 72 75 63   and "reconstruc
1d70: 74 22 2e 20 20 54 68 65 20 64 65 63 6f 6e 73 74  t".  The deconst
1d80: 72 75 63 74 0a 20 20 20 20 63 6f 6d 6d 61 6e 64  ruct.    command
1d90: 20 70 6f 70 75 6c 61 74 65 73 20 61 6e 20 69 6e   populates an in
1da0: 64 69 63 61 74 65 64 20 64 69 72 65 63 74 6f 72  dicated director
1db0: 79 20 77 69 74 68 20 63 6f 70 69 65 73 20 6f 66  y with copies of
1dc0: 20 61 6c 6c 20 66 69 6c 65 73 0a 20 20 20 20 63   all files.    c
1dd0: 6f 6e 74 61 69 6e 65 64 20 77 69 74 68 69 6e 20  ontained within 
1de0: 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 2e 20  the repository. 
1df0: 20 46 69 6c 65 73 20 61 72 65 20 6e 61 6d 65 64   Files are named
1e00: 20 61 61 61 2f 62 62 62 62 62 62 62 20 77 68 65   aaa/bbbbbbb whe
1e10: 72 65 0a 20 20 20 20 61 61 61 20 69 73 20 74 68  re.    aaa is th
1e20: 65 20 66 69 72 73 74 20 33 20 63 68 61 72 61 63  e first 3 charac
1e30: 74 65 72 73 20 6f 66 20 74 68 65 20 75 75 69 64  ters of the uuid
1e40: 20 61 6e 64 20 62 62 62 62 62 62 20 69 73 20 74   and bbbbbb is t
1e50: 68 65 0a 20 20 20 20 72 65 6d 61 69 6e 69 6e 67  he.    remaining
1e60: 20 33 37 20 63 68 61 72 61 63 74 65 72 73 2e 20   37 characters. 
1e70: 20 72 65 63 6f 6e 73 74 72 75 63 74 20 62 75 69   reconstruct bui
1e80: 6c 64 73 20 61 20 6e 65 77 20 72 65 70 6f 73 69  lds a new reposi
1e90: 74 6f 72 79 0a 20 20 20 20 63 6f 6e 74 61 69 6e  tory.    contain
1ea0: 69 6e 67 20 61 6c 6c 20 66 69 6c 65 73 20 69 6e  ing all files in
1eb0: 20 61 6e 20 69 6e 64 69 63 61 74 65 64 20 64 69   an indicated di
1ec0: 72 65 63 74 6f 72 79 2e 20 20 57 68 65 6e 20 72  rectory.  When r
1ed0: 65 63 6f 6e 73 74 72 75 63 74 69 6e 67 2c 0a 20  econstructing,. 
1ee0: 20 20 20 73 6f 6d 65 20 69 6e 66 6f 72 6d 61 74     some informat
1ef0: 69 6f 6e 20 69 73 20 6c 6f 73 74 3a 20 70 72 6f  ion is lost: pro
1f00: 6a 65 63 74 2d 63 6f 64 65 2c 20 73 65 72 76 65  ject-code, serve
1f10: 72 2d 63 6f 64 65 2c 20 75 73 65 72 73 2e 20 20  r-code, users.  
1f20: 0a 20 20 20 20 4a 75 73 74 20 6d 61 6b 65 20 75  .    Just make u
1f30: 70 20 61 20 6e 65 77 20 70 72 6f 6a 65 63 74 2d  p a new project-
1f40: 63 6f 64 65 2e 20 20 0a 0a 20 2a 20 20 47 65 74  code.  .. *  Get
1f50: 20 61 20 62 75 69 6c 64 20 77 6f 72 6b 69 6e 67   a build working
1f60: 20 66 6f 72 20 77 69 6e 33 32 2e 20 20 50 65 72   for win32.  Per
1f70: 68 61 70 73 20 75 73 65 20 63 79 67 77 69 6e 2e  haps use cygwin.
1f80: 20 20 4f 72 20 6f 6d 69 74 0a 20 20 20 20 74 68    Or omit.    th
1f90: 65 20 73 65 72 76 65 72 20 63 6f 6d 70 6f 6e 65  e server compone
1fa0: 6e 74 20 66 72 6f 6d 20 77 69 6e 33 32 20 28 74  nt from win32 (t
1fb0: 6f 20 65 6c 69 6d 69 6e 61 74 65 20 74 68 65 20  o eliminate the 
1fc0: 6e 65 65 64 20 66 6f 72 20 66 6f 72 6b 28 29 29  need for fork())
1fd0: 2e 0a 0a 20 2a 20 20 4d 61 6b 65 20 74 68 65 20  ... *  Make the 
1fe0: 69 6e 74 65 72 66 61 63 65 20 74 6f 20 66 6f 73  interface to fos
1ff0: 73 69 6c 20 6c 6f 6f 6b 20 70 72 65 74 74 79 20  sil look pretty 
2000: 61 6e 64 20 62 65 20 63 75 73 74 6f 6d 69 7a 61  and be customiza
2010: 62 6c 65 20 73 6f 0a 20 20 20 20 74 68 61 74 20  ble so.    that 
2020: 6f 74 68 65 72 20 70 65 6f 70 6c 65 20 77 69 6c  other people wil
2030: 6c 20 62 65 20 61 74 74 72 61 63 74 65 64 20 74  l be attracted t
2040: 6f 20 69 74 2c 20 77 69 6c 6c 20 74 61 6b 65 20  o it, will take 
2050: 6f 76 65 72 20 6d 61 69 6e 74 65 6e 61 6e 63 65  over maintenance
2060: 0a 20 20 20 20 6f 66 20 69 74 2c 20 61 6e 64 20  .    of it, and 
2070: 77 65 20 63 61 6e 20 65 76 65 6e 74 75 61 6c 6c  we can eventuall
2080: 79 20 6d 6f 76 65 20 6f 6e 20 74 6f 20 6f 74 68  y move on to oth
2090: 65 72 20 74 68 69 6e 67 73 2e 0a                 er things..