Hex Artifact Content
Not logged in

Artifact 2f6d8979445e4b931cc04f02590b37bd78a62809:

File todo.txt part of check-in [71ed18cc4b] - Do not attempt to verify phantoms. Set the default max message size at 500K instead of 1MB. Updates to the todo list. by drh on 2007-08-01 02:03:31.

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 55 73 65 20 74 68 65 20  n:.. *  Use the 
0020: 77 69 6b 69 5f 63 6f 6e 76 65 72 74 28 29 20 72  wiki_convert() r
0030: 6f 75 74 69 6e 65 20 74 6f 20 72 65 6e 64 65 72  outine to render
0040: 20 63 6f 6d 6d 65 6e 74 73 20 61 6e 64 20 6f 74   comments and ot
0050: 68 65 72 20 74 65 78 74 0a 20 20 20 20 6f 6e 20  her text.    on 
0060: 77 65 62 20 70 61 67 65 73 2e 0a 0a 20 2a 20 20  web pages... *  
0070: 49 66 20 74 68 65 20 73 65 72 76 65 72 20 64 6f  If the server do
0080: 65 73 20 6e 6f 74 20 68 61 76 65 20 77 72 69 74  es not have writ
0090: 65 20 70 65 72 6d 69 73 73 69 6f 6e 20 6f 6e 20  e permission on 
00a0: 74 68 65 20 64 61 74 61 62 61 73 65 0a 20 20 20  the database.   
00b0: 20 66 69 6c 65 2c 20 6f 72 20 6f 6e 20 74 68 65   file, or on the
00c0: 20 64 69 72 65 63 74 6f 72 79 20 63 6f 6e 74 61   directory conta
00d0: 69 6e 69 6e 67 20 74 68 65 20 64 61 74 61 62 61  ining the databa
00e0: 73 65 20 66 69 6c 65 20 28 61 6e 64 20 0a 20 20  se file (and .  
00f0: 20 20 69 74 20 69 73 20 74 68 75 73 20 75 6e 61    it is thus una
0100: 62 6c 65 20 74 6f 20 75 70 64 61 74 65 20 64 61  ble to update da
0110: 74 61 62 61 73 65 20 62 65 63 61 75 73 65 20 69  tabase because i
0120: 74 20 63 61 6e 6e 6f 74 20 63 72 65 61 74 65 0a  t cannot create.
0130: 20 20 20 20 61 20 72 6f 6c 6c 62 61 63 6b 20 6a      a rollback j
0140: 6f 75 72 6e 61 6c 29 20 74 68 65 6e 20 69 74 20  ournal) then it 
0150: 63 75 72 72 65 6e 74 6c 79 20 66 61 69 6c 73 20  currently fails 
0160: 73 69 6c 65 6e 74 6c 79 20 6f 6e 20 61 20 70 75  silently on a pu
0170: 73 68 2e 0a 20 20 20 20 49 74 20 6e 65 65 64 73  sh..    It needs
0180: 20 74 6f 20 72 65 74 75 72 6e 20 61 20 68 65 6c   to return a hel
0190: 70 66 75 6c 20 65 72 72 6f 72 2e 0a 0a 20 2a 20  pful error... * 
01a0: 20 57 68 65 6e 20 63 6f 6e 73 74 72 75 63 74 69   When constructi
01b0: 6e 67 20 61 20 6e 65 77 20 6d 61 6e 69 66 65 73  ng a new manifes
01c0: 74 20 28 73 65 65 20 74 68 65 20 63 6f 6d 6d 69  t (see the commi
01d0: 74 5f 63 6d 64 20 66 75 6e 63 74 69 6f 6e 0a 20  t_cmd function. 
01e0: 20 20 20 69 6e 20 63 68 65 63 6b 69 6e 2e 63 2c     in checkin.c,
01f0: 20 6e 65 61 72 20 6c 69 6e 65 20 33 30 33 29 20   near line 303) 
0200: 6d 61 6b 65 20 61 6e 20 61 74 74 65 6d 70 74 20  make an attempt 
0210: 74 6f 20 50 47 50 20 63 6c 65 61 72 73 69 67 6e  to PGP clearsign
0220: 0a 20 20 20 20 74 68 65 20 6d 61 6e 69 66 65 73  .    the manifes
0230: 74 20 62 65 66 6f 72 65 20 63 68 65 63 6b 69 6e  t before checkin
0240: 67 20 69 74 20 69 6e 2e 20 20 54 68 65 72 65 20  g it in.  There 
0250: 77 69 6c 6c 20 6e 65 65 64 20 74 6f 20 62 65 0a  will need to be.
0260: 20 20 20 20 63 6f 6e 66 69 67 75 72 61 74 69 6f      configuratio
0270: 6e 20 70 61 72 61 6d 65 74 65 72 73 20 66 6f 72  n parameters for
0280: 20 74 68 65 20 50 47 50 20 28 6f 72 20 6d 6f 72   the PGP (or mor
0290: 65 20 6c 69 6b 65 6c 79 20 47 50 47 29 0a 20 20  e likely GPG).  
02a0: 20 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 64 6f 20    command to do 
02b0: 74 68 65 20 61 63 74 75 61 6c 20 73 69 67 6e 69  the actual signi
02c0: 6e 67 2e 20 20 57 72 69 74 65 20 74 68 65 20 6d  ng.  Write the m
02d0: 61 6e 69 66 65 73 74 20 74 6f 0a 20 20 20 20 61  anifest to.    a
02e0: 20 74 65 6d 70 20 66 69 6c 65 2c 20 63 6c 65 61   temp file, clea
02f0: 72 73 69 67 6e 2c 20 72 65 61 64 20 69 74 20 62  rsign, read it b
0300: 61 63 6b 20 69 6e 2c 20 76 65 72 69 66 79 20 74  ack in, verify t
0310: 68 61 74 20 69 74 20 69 73 0a 20 20 20 20 73 74  hat it is.    st
0320: 69 6c 6c 20 70 61 72 73 61 62 6c 65 20 62 79 20  ill parsable by 
0330: 6d 61 6e 69 66 65 73 74 5f 70 61 72 73 65 28 29  manifest_parse()
0340: 2c 20 74 68 65 6e 20 63 6f 6e 74 69 6e 75 65 20  , then continue 
0350: 77 69 74 68 20 74 68 65 0a 20 20 20 20 63 68 65  with the.    che
0360: 63 6b 2d 69 6e 2e 0a 0a 20 2a 20 20 54 68 65 20  ck-in... *  The 
0370: 22 6c 65 61 76 65 73 20 3f 55 55 49 44 3f 22 20  "leaves ?UUID?" 
0380: 63 6f 6d 6d 61 6e 64 20 64 69 73 70 6c 61 79 73  command displays
0390: 20 61 6c 6c 20 6c 65 61 66 20 76 65 72 73 69 6f   all leaf versio
03a0: 6e 73 20 66 6f 72 20 74 68 65 0a 20 20 20 20 76  ns for the.    v
03b0: 65 72 73 69 6f 6e 20 55 55 49 44 20 6f 72 20 66  ersion UUID or f
03c0: 6f 72 20 74 68 65 20 63 75 72 72 65 6e 74 20 76  or the current v
03d0: 65 72 73 69 6f 6e 20 69 66 20 55 55 49 44 20 69  ersion if UUID i
03e0: 73 20 6f 6d 69 74 74 65 64 2e 20 20 49 66 0a 20  s omitted.  If. 
03f0: 20 20 20 55 55 49 44 20 69 73 20 69 74 73 65 6c     UUID is itsel
0400: 66 20 61 20 6c 65 61 66 2c 20 69 74 20 77 6f 75  f a leaf, it wou
0410: 6c 64 20 62 65 20 6d 6f 72 65 20 68 65 6c 70 66  ld be more helpf
0420: 75 6c 20 74 6f 20 64 69 73 70 6c 61 79 20 61 0a  ul to display a.
0430: 20 20 20 20 6d 65 73 73 61 67 65 20 74 6f 20 74      message to t
0440: 68 61 74 20 65 66 66 65 63 74 3a 20 20 22 3c 75  hat effect:  "<u
0450: 75 69 64 3e 20 69 73 20 69 74 73 65 6c 66 20 61  uid> is itself a
0460: 20 6c 65 61 66 22 0a 0a 20 2a 20 20 57 65 20 6e   leaf".. *  We n
0470: 65 65 64 20 61 20 63 6f 6d 6d 61 6e 64 20 74 6f  eed a command to
0480: 20 73 68 6f 77 20 6f 74 68 65 72 20 62 72 61 6e   show other bran
0490: 63 68 65 73 20 2d 20 6c 65 61 76 65 73 20 6f 66  ches - leaves of
04a0: 20 74 68 65 20 72 6f 6f 74 0a 20 20 20 20 77 68   the root.    wh
04b0: 69 63 68 20 61 72 65 20 6e 6f 74 20 6c 65 61 76  ich are not leav
04c0: 65 73 20 6f 66 20 74 68 65 20 69 6e 64 69 63 61  es of the indica
04d0: 74 65 64 20 6e 6f 64 65 2e 0a 0a 20 2a 20 20 54  ted node... *  T
04e0: 68 65 20 69 70 61 64 64 72 20 66 69 65 6c 64 20  he ipaddr field 
04f0: 6f 66 20 74 68 65 20 72 63 76 66 72 6f 6d 20 74  of the rcvfrom t
0500: 61 62 6c 65 20 69 73 20 6e 6f 74 20 62 65 69 6e  able is not bein
0510: 67 20 73 65 74 2e 20 20 54 68 69 73 0a 20 20 20  g set.  This.   
0520: 20 66 69 65 6c 64 20 73 68 6f 75 6c 64 20 62 65   field should be
0530: 20 74 68 65 20 49 50 20 61 64 64 72 65 73 73 20   the IP address 
0540: 66 72 6f 6d 20 77 68 69 63 68 20 69 6e 66 6f 72  from which infor
0550: 6d 61 74 69 6f 6e 20 69 73 20 72 65 63 65 69 76  mation is receiv
0560: 65 64 0a 20 20 20 20 66 6f 72 20 74 68 65 20 6c  ed.    for the l
0570: 6f 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 2e  ocal repository.
0580: 20 20 53 6f 20 77 68 65 6e 20 73 6f 6d 65 62 6f    So when somebo
0590: 64 79 20 64 6f 65 73 20 61 20 70 75 73 68 20 6f  dy does a push o
05a0: 66 20 6e 65 77 0a 20 20 20 20 66 69 6c 65 73 20  f new.    files 
05b0: 77 65 20 72 65 63 6f 72 64 20 74 68 65 20 69 70  we record the ip
05c0: 61 64 64 72 2e 20 20 4f 72 20 77 68 65 6e 20 77  addr.  Or when w
05d0: 65 20 64 6f 20 61 20 70 75 6c 6c 2c 20 77 65 20  e do a pull, we 
05e0: 72 65 63 6f 72 64 0a 20 20 20 20 74 68 65 20 69  record.    the i
05f0: 70 61 64 64 72 2e 0a 0a 20 2a 20 20 41 64 64 69  paddr... *  Addi
0600: 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69  tional informati
0610: 6f 6e 20 64 69 73 70 6c 61 79 65 64 20 66 6f 72  on displayed for
0620: 20 74 68 65 20 22 76 69 6e 66 6f 22 20 70 61 67   the "vinfo" pag
0630: 65 3a 0a 0a 20 20 20 20 20 2b 20 20 54 68 65 20  e:..     +  The 
0640: 63 6f 6d 6d 65 6e 74 20 61 6e 64 20 75 73 65 72  comment and user
0650: 20 66 6f 72 20 74 68 69 73 20 76 65 72 73 69 6f   for this versio
0660: 6e 20 28 61 76 61 69 6c 61 62 6c 65 20 69 6e 0a  n (available in.
0670: 20 20 20 20 20 20 20 20 74 68 65 20 65 76 65 6e          the even
0680: 74 20 74 61 62 6c 65 29 2e 0a 20 20 20 20 20 2b  t table)..     +
0690: 20 20 41 6c 6c 20 64 65 63 65 6e 64 65 6e 74 73    All decendents
06a0: 20 6f 66 20 74 68 69 73 20 76 65 72 73 69 6f 6e   of this version
06b0: 20 28 74 6f 67 65 74 68 65 72 20 77 69 74 68 20   (together with 
06c0: 64 61 74 65 2c 0a 20 20 20 20 20 20 20 20 75 73  date,.        us
06d0: 65 72 2c 20 63 6f 6d 6d 65 6e 74 2c 20 61 6e 64  er, comment, and
06e0: 20 68 79 70 65 72 6c 69 6e 6b 20 74 6f 20 74 68   hyperlink to th
06f0: 65 20 76 69 6e 66 6f 20 70 61 67 65 29 20 66 6f  e vinfo page) fo
0700: 72 0a 20 20 20 20 20 20 20 20 4e 20 67 65 6e 65  r.        N gene
0710: 72 61 74 69 6f 6e 73 2e 20 20 4e 20 74 6f 20 62  rations.  N to b
0720: 65 20 64 65 74 65 72 6d 69 6e 65 64 2e 20 20 50  e determined.  P
0730: 65 72 68 61 70 73 20 63 6f 6e 66 69 67 75 72 61  erhaps configura
0740: 62 6c 65 0a 20 20 20 20 20 20 20 20 75 73 69 6e  ble.        usin
0750: 67 20 64 62 5f 67 65 74 5f 69 6e 74 28 29 2f 64  g db_get_int()/d
0760: 62 5f 73 65 74 5f 69 6e 74 28 29 2e 20 20 4e 6f  b_set_int().  No
0770: 74 65 3a 20 64 65 63 65 6e 64 65 6e 74 73 20 63  te: decendents c
0780: 61 6e 0a 20 20 20 20 20 20 20 20 62 65 20 66 6f  an.        be fo
0790: 75 6e 64 20 75 73 69 6e 67 20 74 68 65 20 70 6c  und using the pl
07a0: 69 6e 6b 20 74 61 62 6c 65 2e 0a 20 20 20 20 20  ink table..     
07b0: 2b 20 20 41 6c 6c 20 6c 65 61 76 65 73 20 6f 66  +  All leaves of
07c0: 20 74 68 69 73 20 76 65 72 73 69 6f 6e 20 74 68   this version th
07d0: 61 74 20 61 72 65 20 6e 6f 74 20 69 6e 63 6c 75  at are not inclu
07e0: 64 65 64 20 69 6e 20 74 68 65 0a 20 20 20 20 20  ded in the.     
07f0: 20 20 20 64 65 63 65 6e 64 65 6e 74 20 6c 69 73     decendent lis
0800: 74 2e 20 20 57 69 74 68 20 64 61 74 65 2c 20 75  t.  With date, u
0810: 73 65 72 2c 20 63 6f 6d 6d 65 6e 74 2c 20 61 6e  ser, comment, an
0820: 64 20 68 79 70 65 72 6c 69 6e 6b 2e 0a 20 20 20  d hyperlink..   
0830: 20 20 20 20 20 4c 65 61 76 65 73 20 69 6e 20 74       Leaves in t
0840: 68 65 20 64 65 63 65 6e 64 65 6e 74 20 74 61 62  he decendent tab
0850: 6c 65 20 73 68 6f 75 6c 64 20 62 65 20 6d 61 72  le should be mar
0860: 6b 65 64 20 61 73 20 73 75 63 68 2e 0a 20 20 20  ked as such..   
0870: 20 20 20 20 20 53 65 65 20 74 68 65 20 63 6f 6d       See the com
0880: 70 75 74 65 5f 6c 65 61 76 65 73 28 29 20 66 75  pute_leaves() fu
0890: 6e 63 74 69 6f 6e 20 74 6f 20 73 65 65 20 68 6f  nction to see ho
08a0: 77 20 74 6f 20 66 69 6e 64 20 61 6c 6c 0a 20 20  w to find all.  
08b0: 20 20 20 20 20 20 6c 65 61 76 65 73 2e 0a 20 20        leaves..  
08c0: 20 20 20 2b 20 20 41 6c 6c 20 61 6e 63 65 73 74     +  All ancest
08d0: 6f 72 73 20 6f 66 20 74 68 65 20 63 75 72 72 65  ors of the curre
08e0: 6e 74 20 76 65 72 73 69 6f 6e 20 77 69 74 68 20  nt version with 
08f0: 64 61 74 65 2c 20 75 73 65 72 2c 0a 20 20 20 20  date, user,.    
0900: 20 20 20 20 63 6f 6d 6d 65 6e 74 2c 20 68 79 70      comment, hyp
0910: 65 72 6c 69 6e 6b 2e 20 20 4d 20 67 65 6e 65 72  erlink.  M gener
0920: 61 74 69 6f 6e 73 20 62 61 63 6b 2c 20 77 68 65  ations back, whe
0930: 72 65 20 4d 20 69 73 0a 20 20 20 20 20 20 20 20  re M is.        
0940: 74 6f 20 62 65 20 64 65 74 65 72 6d 69 6e 65 64  to be determined
0950: 2e 0a 20 20 20 20 20 2b 20 20 4c 69 73 74 20 6f  ..     +  List o
0960: 66 20 66 69 6c 65 73 20 61 64 64 65 64 20 6f 72  f files added or
0970: 20 6d 6f 64 69 66 69 65 64 20 62 79 20 74 68 69   modified by thi
0980: 73 20 76 65 72 73 69 6f 6e 2e 0a 20 20 20 20 20  s version..     
0990: 20 20 20 49 6e 66 6f 72 6d 61 74 69 6f 6e 20 61     Information a
09a0: 76 61 69 6c 61 62 6c 65 20 69 6e 20 74 68 65 20  vailable in the 
09b0: 6d 6c 69 6e 6b 20 74 61 62 6c 65 2e 20 20 48 79  mlink table.  Hy
09c0: 70 65 72 6c 69 6e 6b 73 20 74 6f 0a 20 20 20 20  perlinks to.    
09d0: 20 20 20 20 74 68 65 20 66 69 6e 66 6f 20 70 61      the finfo pa
09e0: 67 65 20 66 6f 72 20 65 61 63 68 20 66 69 6c 65  ge for each file
09f0: 2e 0a 20 20 20 20 20 2b 20 20 48 79 70 65 72 6c  ..     +  Hyperl
0a00: 69 6e 6b 73 20 74 6f 20 64 69 66 66 20 61 6c 6c  inks to diff all
0a10: 20 66 69 6c 65 73 20 69 6e 20 74 68 69 73 20 76   files in this v
0a20: 65 72 73 69 6f 6e 20 61 67 61 69 6e 73 74 20 61  ersion against a
0a30: 6e 79 0a 20 20 20 20 20 20 20 20 6f 66 20 74 68  ny.        of th
0a40: 65 20 6e 61 6d 65 64 20 64 65 63 65 6e 64 65 6e  e named decenden
0a50: 74 73 20 6f 72 20 61 6e 63 65 73 74 6f 72 73 2e  ts or ancestors.
0a60: 20 20 54 68 65 20 75 6e 69 66 69 65 64 5f 64 69    The unified_di
0a70: 66 66 28 29 0a 20 20 20 20 20 20 20 20 66 75 6e  ff().        fun
0a80: 63 74 69 6f 6e 20 77 69 6c 6c 20 63 6f 6d 70 75  ction will compu
0a90: 74 65 20 61 20 75 6e 69 66 69 65 64 20 64 69 66  te a unified dif
0aa0: 66 20 67 69 76 65 6e 20 74 6f 20 66 69 6c 65 20  f given to file 
0ab0: 62 6c 6f 62 73 2e 0a 20 20 20 20 20 2b 20 20 41  blobs..     +  A
0ac0: 64 64 20 61 20 6c 69 6e 6b 20 74 68 61 74 20 77  dd a link that w
0ad0: 69 6c 6c 20 64 6f 77 6e 6c 6f 61 64 20 61 20 5a  ill download a Z
0ae0: 49 50 20 61 72 63 68 69 76 65 20 63 6f 6e 74 61  IP archive conta
0af0: 69 6e 69 6e 67 20 74 68 65 0a 20 20 20 20 20 20  ining the.      
0b00: 20 20 63 6f 6d 70 6c 65 74 65 20 62 61 73 65 6c    complete basel
0b10: 69 6e 65 2e 20 20 55 73 65 20 7a 69 70 5f 6f 66  ine.  Use zip_of
0b20: 5f 62 61 73 65 6c 69 6e 65 28 29 20 66 75 6e 63  _baseline() func
0b30: 74 69 6f 6e 20 69 6e 20 0a 20 20 20 20 20 20 20  tion in .       
0b40: 20 7a 69 70 2e 63 20 74 6f 20 63 6f 6e 73 74 72   zip.c to constr
0b50: 75 63 74 20 74 68 65 20 5a 49 50 20 61 72 63 68  uct the ZIP arch
0b60: 69 76 65 2e 0a 0a 20 2a 20 20 41 20 6e 65 77 20  ive... *  A new 
0b70: 77 65 62 70 61 67 65 3a 20 22 66 69 6e 66 6f 22  webpage: "finfo"
0b80: 20 20 49 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62    Information ab
0b90: 6f 75 74 20 61 20 70 61 72 74 69 63 75 6c 61 72  out a particular
0ba0: 20 66 69 6c 65 0a 20 20 20 20 67 69 76 65 6e 20   file.    given 
0bb0: 69 74 73 20 6e 61 6d 65 2e 0a 0a 20 20 20 20 20  its name...     
0bc0: 2b 20 20 41 6c 6c 20 68 69 73 74 6f 72 69 63 61  +  All historica
0bd0: 6c 20 63 68 61 6e 67 65 73 20 74 6f 20 74 68 69  l changes to thi
0be0: 73 20 66 69 6c 65 20 77 69 74 68 20 76 65 72 73  s file with vers
0bf0: 69 6f 6e 20 6e 75 6d 62 65 72 2c 0a 20 20 20 20  ion number,.    
0c00: 20 20 20 20 75 73 65 72 2c 20 61 6e 64 20 63 6f      user, and co
0c10: 6d 6d 65 6e 74 2c 20 61 6e 64 20 68 79 70 65 72  mment, and hyper
0c20: 6c 69 6e 6b 20 74 6f 20 74 68 65 20 76 69 6e 66  link to the vinf
0c30: 6f 20 70 61 67 65 20 66 6f 72 0a 20 20 20 20 20  o page for.     
0c40: 20 20 20 74 68 65 20 76 65 72 73 69 6f 6e 2e 20     the version. 
0c50: 20 49 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 76 61   Information ava
0c60: 69 6c 61 62 6c 65 20 66 72 6f 6d 20 74 68 65 20  ilable from the 
0c70: 6d 69 6e 66 6f 20 74 61 62 6c 65 2e 0a 20 20 20  minfo table..   
0c80: 20 20 2b 20 20 48 79 70 65 72 6c 69 6e 6b 73 20    +  Hyperlinks 
0c90: 66 6f 72 20 64 69 66 66 69 6e 67 20 63 6f 6e 73  for diffing cons
0ca0: 65 63 75 74 69 76 65 20 76 65 72 73 69 6f 6e 73  ecutive versions
0cb0: 20 6f 66 20 74 68 65 20 66 69 6c 65 2e 0a 0a 20   of the file... 
0cc0: 2a 20 20 54 69 6d 65 6c 69 6e 65 20 65 6e 68 61  *  Timeline enha
0cd0: 6e 63 65 64 20 73 6f 20 74 68 61 74 20 79 6f 75  nced so that you
0ce0: 20 63 61 6e 20 73 70 65 63 69 66 79 20 61 20 72   can specify a r
0cf0: 61 6e 67 65 20 6f 66 20 64 61 74 65 73 2e 0a 0a  ange of dates...
0d00: 20 2a 20 20 54 68 65 20 2f 78 66 65 72 20 68 61   *  The /xfer ha
0d10: 6e 64 6c 65 72 20 28 66 6f 72 20 70 75 73 68 2c  ndler (for push,
0d20: 20 70 75 6c 6c 2c 20 61 6e 64 20 63 6c 6f 6e 65   pull, and clone
0d30: 29 20 64 6f 65 73 20 6e 6f 74 20 64 6f 0a 20 20  ) does not do.  
0d40: 20 20 64 65 6c 74 61 20 63 6f 6d 70 72 65 73 73    delta compress
0d50: 69 6f 6e 2e 20 20 54 68 69 73 20 72 65 73 75 6c  ion.  This resul
0d60: 74 73 20 69 6e 20 65 78 63 65 73 73 20 62 61 6e  ts in excess ban
0d70: 64 77 69 64 74 68 20 75 73 61 67 65 2e 0a 20 20  dwidth usage..  
0d80: 20 20 54 68 65 72 65 20 61 72 65 20 73 6f 6d 65    There are some
0d90: 20 63 6f 64 65 20 69 6e 20 78 66 65 72 2e 63 20   code in xfer.c 
0da0: 74 68 61 74 20 61 72 65 20 73 6b 65 74 63 68 65  that are sketche
0db0: 73 20 6f 66 20 69 64 65 61 73 20 6f 6e 0a 20 20  s of ideas on.  
0dc0: 20 20 68 6f 77 20 74 6f 20 64 6f 20 64 65 6c 74    how to do delt
0dd0: 61 20 63 6f 6d 70 72 65 73 73 69 6f 6e 2c 20 62  a compression, b
0de0: 75 74 20 6e 6f 74 68 69 6e 67 20 68 61 73 20 62  ut nothing has b
0df0: 65 65 6e 20 69 6d 70 6c 65 6d 65 6e 74 65 64 2e  een implemented.
0e00: 0a 0a 20 2a 20 20 45 6e 68 61 6e 63 65 6d 65 6e  .. *  Enhancemen
0e10: 74 73 20 74 6f 20 74 68 65 20 64 69 66 66 20 61  ts to the diff a
0e20: 6e 64 20 74 6b 64 69 66 66 20 63 6f 6d 6d 61 6e  nd tkdiff comman
0e30: 64 73 20 69 6e 20 74 68 65 20 63 6c 69 2e 0a 20  ds in the cli.. 
0e40: 20 20 20 41 6c 6c 6f 77 20 74 68 65 20 65 6e 74     Allow the ent
0e50: 69 72 65 20 74 72 65 65 20 6f 72 20 61 20 73 75  ire tree or a su
0e60: 62 74 72 65 65 20 74 6f 20 62 65 20 64 69 66 66  btree to be diff
0e70: 65 64 2c 20 6e 6f 74 20 6a 75 73 74 20 61 20 0a  ed, not just a .
0e80: 20 20 20 20 73 69 6e 67 6c 65 20 66 69 6c 65 2e      single file.
0e90: 20 20 41 6c 6c 6f 77 20 64 69 66 66 73 20 61 67    Allow diffs ag
0ea0: 61 69 6e 73 74 20 61 6e 79 20 74 77 6f 20 61 72  ainst any two ar
0eb0: 62 69 74 72 61 72 79 20 76 65 72 73 69 6f 6e 73  bitrary versions
0ec0: 2c 0a 20 20 20 20 6e 6f 74 20 6a 75 73 74 20 64  ,.    not just d
0ed0: 69 66 66 73 20 61 67 61 69 6e 73 74 20 74 68 65  iffs against the
0ee0: 20 63 75 72 72 65 6e 74 20 63 68 65 63 6b 2d 6f   current check-o
0ef0: 75 74 2e 20 20 41 6c 6c 6f 77 20 0a 20 20 20 20  ut.  Allow .    
0f00: 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6f 70  configuration op
0f10: 74 69 6f 6e 73 20 74 6f 20 72 65 70 6c 61 63 65  tions to replace
0f20: 20 74 6b 64 69 66 66 20 77 69 74 68 20 73 6f 6d   tkdiff with som
0f30: 65 20 6f 74 68 65 72 0a 20 20 20 20 76 69 73 75  e other.    visu
0f40: 61 6c 20 64 69 66 66 65 72 20 6f 66 20 74 68 65  al differ of the
0f50: 20 75 73 65 72 73 20 63 68 6f 69 63 65 2e 0a 0a   users choice...
0f60: 20 2a 20 20 54 69 63 6b 65 74 69 6e 67 20 69 6e   *  Ticketing in
0f70: 74 65 72 66 61 63 65 20 28 65 78 70 61 6e 64 20  terface (expand 
0f80: 74 68 69 73 20 62 75 6c 6c 65 74 29 0a 0a 20 20  this bullet)..  
0f90: 20 20 20 2b 20 20 43 72 65 61 74 65 20 6e 65 77     +  Create new
0fa0: 20 74 69 63 6b 65 74 73 20 61 73 20 66 69 6c 65   tickets as file
0fb0: 73 20 69 6e 20 74 68 65 20 66 69 6c 65 20 68 69  s in the file hi
0fc0: 65 72 61 72 63 68 79 0a 20 20 20 20 20 2b 20 20  erarchy.     +  
0fd0: 41 70 70 65 6e 64 20 72 65 6d 61 72 6b 73 20 74  Append remarks t
0fe0: 6f 20 61 20 74 69 63 6b 65 74 0a 20 20 20 20 20  o a ticket.     
0ff0: 2b 20 20 41 64 64 20 61 74 74 61 63 68 6d 65 6e  +  Add attachmen
1000: 74 73 20 74 6f 20 61 20 74 69 63 6b 65 74 0a 20  ts to a ticket. 
1010: 20 20 20 20 2b 20 20 43 68 61 6e 67 65 20 61 74      +  Change at
1020: 74 72 69 62 75 74 65 73 20 6f 66 20 61 20 74 69  tributes of a ti
1030: 63 6b 65 74 0a 20 20 20 20 20 2b 20 20 44 65 6c  cket.     +  Del
1040: 65 74 65 20 74 69 63 6b 65 74 73 20 74 68 61 74  ete tickets that
1050: 20 61 72 65 20 6e 6f 20 6c 6f 6e 67 65 72 20 63   are no longer c
1060: 75 72 72 65 6e 74 2e 20 20 28 54 68 65 20 6f 6c  urrent.  (The ol
1070: 64 0a 20 20 20 20 20 20 20 20 63 6f 6e 74 65 6e  d.        conten
1080: 74 20 69 73 20 73 74 69 6c 6c 20 61 63 63 65 73  t is still acces
1090: 73 69 62 6c 65 2c 20 74 68 65 20 74 69 63 6b 65  sible, the ticke
10a0: 74 20 69 73 20 6a 75 73 74 20 6e 6f 74 20 69 6e  t is just not in
10b0: 0a 20 20 20 20 20 20 20 20 74 68 65 20 63 75 72  .        the cur
10c0: 72 65 6e 74 20 63 68 65 63 6b 2d 6f 75 74 2e 29  rent check-out.)
10d0: 0a 20 20 20 20 20 2b 20 20 53 65 72 76 65 72 20  .     +  Server 
10e0: 73 65 74 75 70 20 74 6f 20 64 65 66 69 6e 65 20  setup to define 
10f0: 74 68 65 20 61 6c 6c 6f 77 65 64 20 61 74 74 72  the allowed attr
1100: 69 62 75 74 65 73 20 61 6e 64 0a 20 20 20 20 20  ibutes and.     
1110: 20 20 20 61 74 74 72 69 62 75 74 65 20 76 61 6c     attribute val
1120: 75 65 73 20 66 6f 72 20 74 69 63 6b 65 74 73 0a  ues for tickets.
1130: 20 20 20 20 20 2b 20 20 50 65 72 6d 61 6e 65 6e       +  Permanen
1140: 74 6c 79 20 72 65 6d 6f 76 65 20 6d 61 6c 69 63  tly remove malic
1150: 69 6f 75 73 20 65 64 69 74 73 20 61 6e 64 2f 6f  ious edits and/o
1160: 72 20 61 74 74 61 63 68 6d 65 6e 74 73 0a 20 20  r attachments.  
1170: 20 20 20 20 20 20 73 75 63 68 20 61 73 20 77 69        such as wi
1180: 6b 69 2d 73 70 61 6d 20 6f 72 20 77 61 72 65 7a  ki-spam or warez
1190: 2e 20 20 28 43 6f 6e 74 65 6e 74 20 69 73 20 6e  .  (Content is n
11a0: 6f 20 6c 6f 6e 67 65 72 20 61 63 63 65 73 73 69  o longer accessi
11b0: 62 6c 65 2e 29 0a 20 20 20 20 20 2b 20 20 56 69  ble.).     +  Vi
11c0: 65 77 20 61 20 68 69 73 74 6f 72 79 20 6f 66 20  ew a history of 
11d0: 61 6c 6c 20 63 68 61 6e 67 65 73 20 74 6f 20 61  all changes to a
11e0: 20 74 69 63 6b 65 74 0a 20 20 20 20 20 2b 20 20   ticket.     +  
11f0: 47 65 6e 65 72 61 74 65 20 72 65 70 6f 72 74 73  Generate reports
1200: 20 6f 76 65 72 20 61 6c 6c 20 74 69 63 6b 65 74   over all ticket
1210: 73 0a 20 20 20 20 20 2b 20 20 47 65 6e 65 72 61  s.     +  Genera
1220: 74 65 20 72 65 70 6f 72 74 73 20 6f 76 65 72 20  te reports over 
1230: 61 6c 6c 20 74 69 63 6b 65 74 73 20 61 73 20 74  all tickets as t
1240: 68 65 79 20 65 78 69 73 74 65 64 20 66 6f 72 0a  hey existed for.
1250: 20 20 20 20 20 20 20 20 61 20 63 68 6f 73 65 6e          a chosen
1260: 20 70 6f 69 6e 74 20 69 6e 20 74 69 6d 65 20 61   point in time a
1270: 6e 64 20 73 70 61 63 65 2e 0a 20 20 20 20 20 2b  nd space..     +
1280: 20 20 44 6f 20 66 75 6c 6c 20 74 65 78 74 20 73    Do full text s
1290: 65 61 72 63 68 20 61 67 61 69 6e 73 74 20 74 68  earch against th
12a0: 65 20 74 65 78 74 20 69 6e 20 61 6e 79 20 73 69  e text in any si
12b0: 6e 67 6c 65 20 74 69 63 6b 65 74 20 6f 72 0a 20  ngle ticket or. 
12c0: 20 20 20 20 20 20 20 61 63 72 6f 73 73 20 74 68         across th
12d0: 65 20 63 75 72 72 65 6e 74 20 76 65 72 73 69 6f  e current versio
12e0: 6e 73 20 6f 66 20 61 6c 6c 20 74 69 63 6b 65 74  ns of all ticket
12f0: 73 2c 20 6f 72 20 61 63 72 6f 73 73 20 61 6c 6c  s, or across all
1300: 20 63 75 72 72 65 6e 74 0a 20 20 20 20 20 20 20   current.       
1310: 20 61 6e 64 20 68 69 73 74 6f 72 69 63 61 6c 20   and historical 
1320: 76 65 72 73 69 6f 6e 73 20 6f 66 20 61 6c 6c 20  versions of all 
1330: 74 69 63 6b 65 74 73 2e 0a 0a 20 2a 20 20 57 69  tickets... *  Wi
1340: 6b 69 20 69 6e 74 65 72 66 61 63 65 20 28 65 78  ki interface (ex
1350: 70 61 6e 64 20 74 68 69 73 20 62 75 6c 6c 65 74  pand this bullet
1360: 29 0a 0a 20 20 20 20 20 2b 20 20 43 72 65 61 74  )..     +  Creat
1370: 65 20 6e 65 77 20 77 69 6b 69 20 70 61 67 65 73  e new wiki pages
1380: 0a 20 20 20 20 20 2b 20 20 44 65 73 69 67 6e 61  .     +  Designa
1390: 74 65 20 61 20 73 69 6e 67 6c 65 20 77 69 6b 69  te a single wiki
13a0: 20 70 61 67 65 20 61 73 20 74 68 65 20 68 6f 6d   page as the hom
13b0: 65 20 70 61 67 65 20 66 6f 72 20 74 68 65 20 77  e page for the w
13c0: 77 77 20 69 6e 74 65 72 66 61 63 65 0a 20 20 20  ww interface.   
13d0: 20 20 2b 20 20 44 65 73 69 67 6e 61 74 65 20 77    +  Designate w
13e0: 69 6b 69 20 70 61 67 65 73 20 61 73 20 72 65 61  iki pages as rea
13f0: 64 2d 6f 6e 6c 79 2c 20 61 70 70 65 6e 64 2d 6f  d-only, append-o
1400: 6e 6c 79 2c 20 6f 72 20 72 65 61 64 2f 77 72 69  nly, or read/wri
1410: 74 65 2e 0a 20 20 20 20 20 2b 20 20 41 70 70 65  te..     +  Appe
1420: 6e 64 20 63 6f 6d 6d 65 6e 74 73 20 74 6f 20 61  nd comments to a
1430: 20 77 69 6b 69 20 70 61 67 65 0a 20 20 20 20 20   wiki page.     
1440: 2b 20 20 41 64 64 20 61 74 74 61 63 68 6d 65 6e  +  Add attachmen
1450: 74 73 20 28 73 75 63 68 20 61 73 20 47 49 46 20  ts (such as GIF 
1460: 69 6d 61 67 65 73 29 20 74 6f 20 61 20 77 69 6b  images) to a wik
1470: 69 20 70 61 67 65 0a 20 20 20 20 20 2b 20 20 43  i page.     +  C
1480: 68 61 6e 67 65 20 74 68 65 20 63 6f 6e 74 65 6e  hange the conten
1490: 74 20 6f 66 20 61 20 77 69 6b 69 20 70 61 67 65  t of a wiki page
14a0: 0a 20 20 20 20 20 2b 20 20 44 65 6c 65 74 65 20  .     +  Delete 
14b0: 6f 62 73 6f 6c 65 74 65 20 77 69 6b 69 20 70 61  obsolete wiki pa
14c0: 67 65 73 2e 20 20 28 4f 6c 64 20 63 6f 6e 74 65  ges.  (Old conte
14d0: 6e 74 20 69 73 20 73 74 69 6c 6c 20 61 63 63 65  nt is still acce
14e0: 73 73 69 62 6c 65 2c 0a 20 20 20 20 20 20 20 20  ssible,.        
14f0: 74 68 65 20 70 61 67 65 20 69 73 20 6a 75 73 74  the page is just
1500: 20 6e 6f 74 20 6f 6e 20 74 68 65 20 63 75 72 72   not on the curr
1510: 65 6e 74 20 6c 69 73 74 20 6f 66 20 70 61 67 65  ent list of page
1520: 73 2e 29 0a 20 20 20 20 20 2b 20 20 50 65 72 6d  s.).     +  Perm
1530: 61 6e 65 6e 74 6c 79 20 72 65 6d 6f 76 65 20 6d  anently remove m
1540: 61 6c 69 63 69 6f 75 73 20 65 64 69 74 73 20 61  alicious edits a
1550: 6e 64 2f 6f 72 20 61 74 74 61 63 68 6d 65 6e 74  nd/or attachment
1560: 73 0a 20 20 20 20 20 20 20 20 73 75 63 68 20 61  s.        such a
1570: 73 20 77 69 6b 69 2d 73 70 61 6d 20 6f 72 20 77  s wiki-spam or w
1580: 61 72 65 7a 2e 20 20 28 4f 6c 64 20 63 6f 6e 74  arez.  (Old cont
1590: 65 6e 74 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72  ent is no longer
15a0: 20 61 63 63 65 73 73 69 62 6c 65 2e 29 0a 20 20   accessible.).  
15b0: 20 20 20 2b 20 20 41 64 64 20 6e 6f 66 6f 6c 6c     +  Add nofoll
15c0: 6f 77 20 6f 6e 20 65 78 74 65 72 6e 61 6c 20 6c  ow on external l
15d0: 69 6e 6b 73 20 61 64 64 65 64 20 62 79 20 75 6e  inks added by un
15e0: 70 72 69 76 69 6c 65 67 65 64 0a 20 20 20 20 20  privileged.     
15f0: 20 20 20 75 73 65 72 73 20 77 68 65 6e 20 74 68     users when th
1600: 65 20 6c 69 6e 6b 20 69 73 20 6c 65 73 73 20 74  e link is less t
1610: 68 61 6e 20 4e 20 68 6f 75 72 73 20 6f 6c 64 2e  han N hours old.
1620: 0a 20 20 20 20 20 2b 20 20 53 68 6f 77 20 74 68  .     +  Show th
1630: 65 20 63 6f 6d 70 6c 65 74 65 20 68 69 73 74 6f  e complete histo
1640: 72 79 20 6f 66 20 61 20 73 69 6e 67 6c 65 20 77  ry of a single w
1650: 69 6b 69 20 70 61 67 65 0a 20 20 20 20 20 2b 20  iki page.     + 
1660: 20 50 72 6f 76 69 64 65 20 74 68 65 20 61 62 69   Provide the abi
1670: 6c 69 74 79 20 74 6f 20 64 69 66 66 20 74 77 6f  lity to diff two
1680: 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 61 20 77   versions of a w
1690: 69 6b 69 20 70 61 67 65 0a 20 20 20 20 20 2b 20  iki page.     + 
16a0: 20 53 68 6f 77 20 61 20 6c 69 73 74 69 6e 67 20   Show a listing 
16b0: 6f 66 20 61 6c 6c 20 77 69 6b 69 20 70 61 67 65  of all wiki page
16c0: 73 2c 20 62 6f 74 68 20 63 75 72 72 65 6e 74 20  s, both current 
16d0: 61 6e 64 20 64 65 6c 65 74 65 64 0a 20 20 20 20  and deleted.    
16e0: 20 2b 20 20 44 6f 20 61 20 66 75 6c 6c 2d 74 65   +  Do a full-te
16f0: 78 74 20 73 65 61 72 63 68 20 61 67 61 69 6e 73  xt search agains
1700: 74 20 63 75 72 72 65 6e 74 20 76 65 72 73 69 6f  t current versio
1710: 6e 73 20 6f 66 20 61 6c 6c 20 77 69 6b 69 20 70  ns of all wiki p
1720: 61 67 65 73 0a 20 20 20 20 20 2b 20 20 44 6f 20  ages.     +  Do 
1730: 61 20 66 75 6c 6c 2d 74 65 78 74 20 73 65 61 72  a full-text sear
1740: 63 68 20 61 67 61 69 6e 73 74 20 61 6c 6c 20 68  ch against all h
1750: 69 73 74 6f 72 69 63 61 6c 20 76 65 72 73 69 6f  istorical versio
1760: 6e 73 20 6f 66 20 61 20 73 69 6e 67 6c 65 0a 20  ns of a single. 
1770: 20 20 20 20 20 20 20 77 69 6b 69 20 70 61 67 65         wiki page
1780: 0a 20 20 20 20 20 2b 20 20 44 6f 20 61 20 66 75  .     +  Do a fu
1790: 6c 6c 2d 74 65 78 74 20 73 65 61 72 63 68 20 61  ll-text search a
17a0: 67 61 69 6e 73 74 20 61 6c 6c 20 68 69 73 74 6f  gainst all histo
17b0: 72 69 63 61 6c 20 76 65 72 73 69 6f 6e 73 20 6f  rical versions o
17c0: 66 20 61 6c 6c 0a 20 20 20 20 20 20 20 20 77 69  f all.        wi
17d0: 6b 69 20 70 61 67 65 73 0a 0a 20 2a 20 20 46 75  ki pages.. *  Fu
17e0: 6c 6c 2d 74 65 78 74 20 73 65 61 72 63 68 20 61  ll-text search a
17f0: 67 61 69 6e 73 74 20 63 68 65 63 6b 2d 69 6e 20  gainst check-in 
1800: 63 6f 6d 6d 65 6e 74 73 20 61 6e 64 20 64 69 66  comments and dif
1810: 66 73 20 6f 66 20 65 61 63 68 0a 20 20 20 20 63  fs of each.    c
1820: 68 65 63 6b 2d 69 6e 2e 0a 0a 20 2a 20 20 41 62  heck-in... *  Ab
1830: 69 6c 69 74 79 20 74 6f 20 63 68 65 63 6b 2d 69  ility to check-i
1840: 6e 20 73 6f 6d 65 20 73 75 62 73 65 74 20 6f 66  n some subset of
1850: 20 63 68 61 6e 67 65 73 20 74 6f 20 74 68 65 20   changes to the 
1860: 74 72 65 65 20 69 6e 73 74 65 61 64 0a 20 20 20  tree instead.   
1870: 20 6f 66 20 68 61 76 69 6e 67 20 74 6f 20 63 68   of having to ch
1880: 65 63 6b 20 69 6e 20 61 6c 6c 20 63 68 61 6e 67  eck in all chang
1890: 65 73 2e 0a 0a 20 2a 20 20 41 64 64 20 61 20 22  es... *  Add a "
18a0: 72 65 76 65 72 74 22 20 63 6f 6d 6d 61 6e 64 20  revert" command 
18b0: 74 68 61 74 20 77 69 6c 6c 20 75 6e 64 6f 20 61  that will undo a
18c0: 6c 6c 20 63 68 61 6e 67 65 73 20 74 6f 20 61 20  ll changes to a 
18d0: 66 69 6c 65 0a 20 20 20 20 6f 72 20 66 69 6c 65  file.    or file
18e0: 73 20 69 6e 20 74 68 65 20 63 75 72 72 65 6e 74  s in the current
18f0: 20 63 68 65 63 6b 2d 6f 75 74 20 2d 20 72 65 73   check-out - res
1900: 74 6f 72 69 6e 67 20 74 68 65 20 66 69 6c 65 73  toring the files
1910: 20 62 61 63 6b 0a 20 20 20 20 74 6f 20 74 68 65   back.    to the
1920: 69 72 20 6f 72 69 67 69 6e 61 6c 20 63 68 65 63  ir original chec
1930: 6b 2d 6f 75 74 20 73 74 61 74 65 2e 0a 0a 20 2a  k-out state... *
1940: 20 20 41 64 64 20 61 6e 20 22 61 6e 6e 6f 74 61    Add an "annota
1950: 74 65 22 20 63 6f 6d 6d 61 6e 64 20 69 6e 20 62  te" command in b
1960: 6f 74 68 20 74 68 65 20 63 6c 69 20 61 6e 64 20  oth the cli and 
1970: 74 68 65 20 77 77 77 20 69 6e 74 65 72 66 61 63  the www interfac
1980: 65 0a 20 20 20 20 74 68 61 74 20 77 69 6c 6c 20  e.    that will 
1990: 73 68 6f 77 20 6c 69 6e 65 2d 62 79 2d 6c 69 6e  show line-by-lin
19a0: 65 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e  e the most recen
19b0: 74 20 63 68 61 6e 67 65 73 20 74 6f 20 65 76 65  t changes to eve
19c0: 72 79 20 6c 69 6e 65 0a 20 20 20 20 69 6e 20 74  ry line.    in t
19d0: 68 65 20 66 69 6c 65 2e 0a 0a 20 2a 20 20 42 72  he file... *  Br
19e0: 6f 77 73 65 20 74 68 65 20 66 69 6c 65 20 68 69  owse the file hi
19f0: 65 72 61 72 63 68 79 2c 20 73 69 6d 69 6c 61 72  erarchy, similar
1a00: 20 74 6f 20 74 68 65 20 22 42 72 6f 77 73 65 22   to the "Browse"
1a10: 20 66 65 61 74 75 72 65 20 69 6e 0a 20 20 20 20   feature in.    
1a20: 43 56 53 54 72 61 63 2e 0a 0a 20 2a 20 20 41 64  CVSTrac... *  Ad
1a30: 64 20 74 68 65 20 61 62 69 6c 69 74 79 20 74 6f  d the ability to
1a40: 20 6f 76 65 72 72 69 64 65 20 63 68 65 63 6b 2d   override check-
1a50: 69 6e 20 63 6f 6d 6d 65 6e 74 73 2e 20 20 49 74  in comments.  It
1a60: 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65   is not possible
1a70: 0a 20 20 20 20 74 6f 20 63 68 61 6e 67 65 20 74  .    to change t
1a80: 68 65 20 63 6f 6d 6d 65 6e 74 20 69 6e 20 74 68  he comment in th
1a90: 65 20 63 68 65 63 6b 2d 69 6e 20 69 74 73 65 6c  e check-in itsel
1aa0: 66 20 64 75 65 20 74 6f 20 74 68 65 20 63 72 79  f due to the cry
1ab0: 70 74 6f 67 72 61 70 68 69 63 0a 20 20 20 20 68  ptographic.    h
1ac0: 61 73 68 2e 20 20 42 75 74 20 79 6f 75 20 63 61  ash.  But you ca
1ad0: 6e 20 61 64 64 20 61 20 6e 65 77 20 72 65 63 6f  n add a new reco
1ae0: 72 64 20 74 6f 20 74 68 65 20 72 65 70 6f 73 69  rd to the reposi
1af0: 74 6f 72 79 20 74 68 61 74 20 6f 76 65 72 6c 6f  tory that overlo
1b00: 61 64 73 0a 20 20 20 20 61 20 63 68 65 63 6b 2d  ads.    a check-
1b10: 69 6e 20 63 6f 6d 6d 65 6e 74 20 77 69 74 68 20  in comment with 
1b20: 61 20 6e 65 77 20 63 6f 6d 6d 65 6e 74 2e 20 20  a new comment.  
1b30: 43 6f 6d 6d 65 6e 74 20 63 68 61 6e 67 65 73 20  Comment changes 
1b40: 73 68 6f 75 6c 64 20 62 65 0a 20 20 20 20 47 50  should be.    GP
1b50: 47 20 63 6c 65 61 72 73 69 67 6e 65 64 20 61 74  G clearsigned at
1b60: 20 74 68 65 20 76 65 72 79 20 6c 65 61 73 74 2e   the very least.
1b70: 20 20 43 6f 6d 6d 65 6e 74 20 63 68 61 6e 67 65    Comment change
1b80: 73 20 6f 6e 6c 79 20 61 70 70 6c 79 20 69 66 0a  s only apply if.
1b90: 20 20 20 20 74 68 65 20 75 73 65 72 20 77 68 6f      the user who
1ba0: 20 6d 61 64 65 20 74 68 65 20 63 68 61 6e 67 65   made the change
1bb0: 20 68 61 73 20 74 68 65 20 72 69 67 68 74 20 70   has the right p
1bc0: 65 72 6d 69 73 73 69 6f 6e 73 2e 0a 0a 20 2a 20  ermissions... * 
1bd0: 20 4e 65 77 20 63 6c 69 20 63 6f 6d 6d 61 6e 64   New cli command
1be0: 73 3a 20 22 64 65 63 6f 6e 73 74 72 75 63 74 22  s: "deconstruct"
1bf0: 20 61 6e 64 20 22 72 65 63 6f 6e 73 74 72 75 63   and "reconstruc
1c00: 74 22 2e 20 20 54 68 65 20 64 65 63 6f 6e 73 74  t".  The deconst
1c10: 72 75 63 74 0a 20 20 20 20 63 6f 6d 6d 61 6e 64  ruct.    command
1c20: 20 70 6f 70 75 6c 61 74 65 73 20 61 6e 20 69 6e   populates an in
1c30: 64 69 63 61 74 65 64 20 64 69 72 65 63 74 6f 72  dicated director
1c40: 79 20 77 69 74 68 20 63 6f 70 69 65 73 20 6f 66  y with copies of
1c50: 20 61 6c 6c 20 66 69 6c 65 73 0a 20 20 20 20 63   all files.    c
1c60: 6f 6e 74 61 69 6e 65 64 20 77 69 74 68 69 6e 20  ontained within 
1c70: 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 2e 20  the repository. 
1c80: 20 46 69 6c 65 73 20 61 72 65 20 6e 61 6d 65 64   Files are named
1c90: 20 61 61 61 2f 62 62 62 62 62 62 62 20 77 68 65   aaa/bbbbbbb whe
1ca0: 72 65 0a 20 20 20 20 61 61 61 20 69 73 20 74 68  re.    aaa is th
1cb0: 65 20 66 69 72 73 74 20 33 20 63 68 61 72 61 63  e first 3 charac
1cc0: 74 65 72 73 20 6f 66 20 74 68 65 20 75 75 69 64  ters of the uuid
1cd0: 20 61 6e 64 20 62 62 62 62 62 62 20 69 73 20 74   and bbbbbb is t
1ce0: 68 65 0a 20 20 20 20 72 65 6d 61 69 6e 69 6e 67  he.    remaining
1cf0: 20 33 37 20 63 68 61 72 61 63 74 65 72 73 2e 20   37 characters. 
1d00: 20 72 65 63 6f 6e 73 74 72 75 63 74 20 62 75 69   reconstruct bui
1d10: 6c 64 73 20 61 20 6e 65 77 20 72 65 70 6f 73 69  lds a new reposi
1d20: 74 6f 72 79 0a 20 20 20 20 63 6f 6e 74 61 69 6e  tory.    contain
1d30: 69 6e 67 20 61 6c 6c 20 66 69 6c 65 73 20 69 6e  ing all files in
1d40: 20 61 6e 20 69 6e 64 69 63 61 74 65 64 20 64 69   an indicated di
1d50: 72 65 63 74 6f 72 79 2e 20 20 57 68 65 6e 20 72  rectory.  When r
1d60: 65 63 6f 6e 73 74 72 75 63 74 69 6e 67 2c 0a 20  econstructing,. 
1d70: 20 20 20 73 6f 6d 65 20 69 6e 66 6f 72 6d 61 74     some informat
1d80: 69 6f 6e 20 69 73 20 6c 6f 73 74 3a 20 70 72 6f  ion is lost: pro
1d90: 6a 65 63 74 2d 63 6f 64 65 2c 20 73 65 72 76 65  ject-code, serve
1da0: 72 2d 63 6f 64 65 2c 20 75 73 65 72 73 2e 20 20  r-code, users.  
1db0: 0a 20 20 20 20 4a 75 73 74 20 6d 61 6b 65 20 75  .    Just make u
1dc0: 70 20 61 20 6e 65 77 20 70 72 6f 6a 65 63 74 2d  p a new project-
1dd0: 63 6f 64 65 2e 20 20 0a 0a 20 2a 20 20 47 65 74  code.  .. *  Get
1de0: 20 61 20 62 75 69 6c 64 20 77 6f 72 6b 69 6e 67   a build working
1df0: 20 66 6f 72 20 77 69 6e 33 32 2e 20 20 50 65 72   for win32.  Per
1e00: 68 61 70 73 20 75 73 65 20 63 79 67 77 69 6e 2e  haps use cygwin.
1e10: 20 20 4f 72 20 6f 6d 69 74 0a 20 20 20 20 74 68    Or omit.    th
1e20: 65 20 73 65 72 76 65 72 20 63 6f 6d 70 6f 6e 65  e server compone
1e30: 6e 74 20 66 72 6f 6d 20 77 69 6e 33 32 20 28 74  nt from win32 (t
1e40: 6f 20 65 6c 69 6d 69 6e 61 74 65 20 74 68 65 20  o eliminate the 
1e50: 6e 65 65 64 20 66 6f 72 20 66 6f 72 6b 28 29 29  need for fork())
1e60: 2e 0a 0a 20 2a 20 20 4d 61 6b 65 20 74 68 65 20  ... *  Make the 
1e70: 69 6e 74 65 72 66 61 63 65 20 74 6f 20 66 6f 73  interface to fos
1e80: 73 69 6c 20 6c 6f 6f 6b 20 70 72 65 74 74 79 20  sil look pretty 
1e90: 61 6e 64 20 62 65 20 63 75 73 74 6f 6d 69 7a 61  and be customiza
1ea0: 62 6c 65 20 73 6f 0a 20 20 20 20 74 68 61 74 20  ble so.    that 
1eb0: 6f 74 68 65 72 20 70 65 6f 70 6c 65 20 77 69 6c  other people wil
1ec0: 6c 20 62 65 20 61 74 74 72 61 63 74 65 64 20 74  l be attracted t
1ed0: 6f 20 69 74 2c 20 77 69 6c 6c 20 74 61 6b 65 20  o it, will take 
1ee0: 6f 76 65 72 20 6d 61 69 6e 74 65 6e 61 6e 63 65  over maintenance
1ef0: 0a 20 20 20 20 6f 66 20 69 74 2c 20 61 6e 64 20  .    of it, and 
1f00: 77 65 20 63 61 6e 20 65 76 65 6e 74 75 61 6c 6c  we can eventuall
1f10: 79 20 6d 6f 76 65 20 6f 6e 20 74 6f 20 6f 74 68  y move on to oth
1f20: 65 72 20 74 68 69 6e 67 73 2e 0a                 er things..