Hex Artifact Content
Not logged in

Artifact f09c9b6d2852c57b12f10f8bfa9364695e148912:

File todo.txt part of check-in [634fd117b1] - Jot down some notes for how to move forward. by drh on 2007-08-25 21:01:17.

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 74 68  ble to update th
0110: 65 20 64 61 74 61 62 61 73 65 20 62 65 63 61 75  e database becau
0120: 73 65 20 69 74 20 63 61 6e 6e 6f 74 20 63 72 65  se it cannot cre
0130: 61 74 65 0a 20 20 20 20 61 20 72 6f 6c 6c 62 61  ate.    a rollba
0140: 63 6b 20 6a 6f 75 72 6e 61 6c 29 20 74 68 65 6e  ck journal) then
0150: 20 69 74 20 63 75 72 72 65 6e 74 6c 79 20 66 61   it currently fa
0160: 69 6c 73 20 73 69 6c 65 6e 74 6c 79 20 6f 6e 20  ils silently on 
0170: 61 20 70 75 73 68 2e 0a 20 20 20 20 49 74 20 6e  a push..    It n
0180: 65 65 64 73 20 74 6f 20 72 65 74 75 72 6e 20 61  eeds to return a
0190: 20 68 65 6c 70 66 75 6c 20 65 72 72 6f 72 2e 0a   helpful error..
01a0: 0a 20 2a 20 20 49 66 20 74 68 65 20 73 65 72 76  . *  If the serv
01b0: 65 72 20 72 65 74 75 72 6e 73 20 61 6e 20 65 72  er returns an er
01c0: 72 6f 72 20 28 66 6f 72 20 65 78 61 6d 70 6c 65  ror (for example
01d0: 20 69 66 20 74 68 65 20 6f 75 74 62 6f 75 6e 64   if the outbound
01e0: 20 2f 78 66 65 72 0a 20 20 20 20 6d 65 73 73 61   /xfer.    messa
01f0: 67 65 20 65 78 63 65 65 64 73 20 74 68 65 20 6d  ge exceeds the m
0200: 61 78 69 6d 75 6d 20 50 4f 53 54 20 73 69 7a 65  aximum POST size
0210: 20 6f 66 20 74 68 65 20 73 65 72 76 65 72 29 20   of the server) 
0220: 74 68 65 20 63 6c 69 65 6e 74 0a 20 20 20 20 64  the client.    d
0230: 6f 65 73 20 6e 6f 74 20 72 65 70 6f 72 74 20 74  oes not report t
0240: 68 69 73 20 65 72 72 6f 72 20 62 61 63 6b 20 74  his error back t
0250: 6f 20 74 68 65 20 75 73 65 72 20 61 73 20 69 74  o the user as it
0260: 20 73 68 6f 75 6c 64 2e 0a 0a 20 2a 20 20 42 75   should... *  Bu
0270: 67 3a 20 49 66 20 74 68 65 20 73 65 72 76 65 72  g: If the server
0280: 20 63 6c 6f 73 65 73 20 74 68 65 20 73 6f 63 6b   closes the sock
0290: 65 74 20 75 6e 65 78 70 65 63 74 65 64 6c 79 2c  et unexpectedly,
02a0: 20 74 68 65 0a 20 20 20 20 66 77 72 69 74 65 28   the.    fwrite(
02b0: 29 20 69 6e 20 68 74 74 70 2e 63 3a 31 30 33 20  ) in http.c:103 
02c0: 74 68 72 6f 77 73 20 61 20 73 69 67 6e 61 6c 20  throws a signal 
02d0: 61 6e 64 20 6b 69 6c 6c 73 20 74 68 65 20 63 68  and kills the ch
02e0: 69 6c 64 0a 20 20 20 20 70 72 6f 63 65 73 73 2e  ild.    process.
02f0: 20 20 66 77 72 69 74 65 28 29 20 69 73 20 6e 6f    fwrite() is no
0300: 74 20 73 75 70 70 6f 73 65 20 74 6f 20 64 6f 20  t suppose to do 
0310: 74 68 69 73 2e 20 20 4e 65 65 64 20 74 6f 20 66  this.  Need to f
0320: 69 67 75 72 65 0a 20 20 20 20 6f 75 74 20 77 68  igure.    out wh
0330: 61 74 20 69 73 20 67 6f 69 6e 67 20 77 72 6f 6e  at is going wron
0340: 67 2e 0a 0a 20 2a 20 20 42 75 67 3a 20 70 75 6c  g... *  Bug: pul
0350: 6c 20 69 73 20 65 6e 64 69 6e 67 20 70 72 65 6d  l is ending prem
0360: 61 74 75 72 65 6c 79 2e 0a 0a 20 2a 20 20 42 75  aturely... *  Bu
0370: 67 3a 20 4d 61 6b 65 20 73 75 72 65 20 6d 65 72  g: Make sure mer
0380: 67 65 20 61 6e 64 20 6f 74 68 65 72 20 63 6f 6d  ge and other com
0390: 6d 61 6e 64 73 20 28 63 68 65 63 6b 2d 6f 75 74  mands (check-out
03a0: 29 20 64 6f 20 6e 6f 74 20 74 72 79 0a 20 20 20  ) do not try.   
03b0: 20 74 6f 20 75 73 65 20 61 20 70 68 61 6e 74 6f   to use a phanto
03c0: 6d 2e 0a 0a 20 2a 20 20 54 68 65 20 69 70 61 64  m... *  The ipad
03d0: 64 72 20 66 69 65 6c 64 20 6f 66 20 74 68 65 20  dr field of the 
03e0: 72 63 76 66 72 6f 6d 20 74 61 62 6c 65 20 69 73  rcvfrom table is
03f0: 20 6e 6f 74 20 62 65 69 6e 67 20 73 65 74 2e 20   not being set. 
0400: 20 54 68 69 73 0a 20 20 20 20 66 69 65 6c 64 20   This.    field 
0410: 73 68 6f 75 6c 64 20 62 65 20 74 68 65 20 49 50  should be the IP
0420: 20 61 64 64 72 65 73 73 20 66 72 6f 6d 20 77 68   address from wh
0430: 69 63 68 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20  ich information 
0440: 69 73 20 72 65 63 65 69 76 65 64 0a 20 20 20 20  is received.    
0450: 66 6f 72 20 74 68 65 20 6c 6f 63 61 6c 20 72 65  for the local re
0460: 70 6f 73 69 74 6f 72 79 2e 20 20 53 6f 20 77 68  pository.  So wh
0470: 65 6e 20 73 6f 6d 65 62 6f 64 79 20 64 6f 65 73  en somebody does
0480: 20 61 20 70 75 73 68 20 6f 66 20 6e 65 77 0a 20   a push of new. 
0490: 20 20 20 66 69 6c 65 73 20 77 65 20 72 65 63 6f     files we reco
04a0: 72 64 20 74 68 65 20 69 70 61 64 64 72 2e 20 20  rd the ipaddr.  
04b0: 4f 72 20 77 68 65 6e 20 77 65 20 64 6f 20 61 20  Or when we do a 
04c0: 70 75 6c 6c 2c 20 77 65 20 72 65 63 6f 72 64 0a  pull, we record.
04d0: 20 20 20 20 74 68 65 20 69 70 61 64 64 72 2e 0a      the ipaddr..
04e0: 0a 20 2a 20 20 41 64 64 69 74 69 6f 6e 61 6c 20  . *  Additional 
04f0: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 64 69 73 70  information disp
0500: 6c 61 79 65 64 20 66 6f 72 20 74 68 65 20 22 76  layed for the "v
0510: 69 6e 66 6f 22 20 70 61 67 65 3a 0a 0a 20 20 20  info" page:..   
0520: 20 20 2b 20 20 41 6c 6c 20 6c 65 61 76 65 73 20    +  All leaves 
0530: 6f 66 20 74 68 69 73 20 76 65 72 73 69 6f 6e 20  of this version 
0540: 74 68 61 74 20 61 72 65 20 6e 6f 74 20 69 6e 63  that are not inc
0550: 6c 75 64 65 64 20 69 6e 20 74 68 65 0a 20 20 20  luded in the.   
0560: 20 20 20 20 20 64 65 73 63 65 6e 64 61 6e 74 20       descendant 
0570: 6c 69 73 74 2e 20 20 57 69 74 68 20 64 61 74 65  list.  With date
0580: 2c 20 75 73 65 72 2c 20 63 6f 6d 6d 65 6e 74 2c  , user, comment,
0590: 20 61 6e 64 20 68 79 70 65 72 6c 69 6e 6b 2e 0a   and hyperlink..
05a0: 20 20 20 20 20 20 20 20 4c 65 61 76 65 73 20 69          Leaves i
05b0: 6e 20 74 68 65 20 64 65 73 63 65 6e 64 61 6e 74  n the descendant
05c0: 20 74 61 62 6c 65 20 73 68 6f 75 6c 64 20 62 65   table should be
05d0: 20 6d 61 72 6b 65 64 20 61 73 20 73 75 63 68 2e   marked as such.
05e0: 0a 20 20 20 20 20 20 20 20 53 65 65 20 74 68 65  .        See the
05f0: 20 63 6f 6d 70 75 74 65 5f 6c 65 61 76 65 73 28   compute_leaves(
0600: 29 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 73 65  ) function to se
0610: 65 20 68 6f 77 20 74 6f 20 66 69 6e 64 20 61 6c  e how to find al
0620: 6c 0a 20 20 20 20 20 20 20 20 6c 65 61 76 65 73  l.        leaves
0630: 2e 0a 20 20 20 20 20 2b 20 20 41 64 64 20 66 69  ..     +  Add fi
0640: 6c 65 20 64 69 66 66 20 6c 69 6e 6b 73 20 74 6f  le diff links to
0650: 20 74 68 65 20 66 69 6c 65 20 63 68 61 6e 67 65   the file change
0660: 20 6c 69 73 74 2e 0a 0a 20 2a 20 20 54 69 6d 65   list... *  Time
0670: 6c 69 6e 65 20 65 6e 68 61 6e 63 65 64 20 73 6f  line enhanced so
0680: 20 74 68 61 74 20 79 6f 75 20 63 61 6e 20 73 70   that you can sp
0690: 65 63 69 66 79 20 61 20 72 61 6e 67 65 20 6f 66  ecify a range of
06a0: 20 64 61 74 65 73 2e 0a 0a 20 2a 20 20 54 68 65   dates... *  The
06b0: 20 2f 78 66 65 72 20 68 61 6e 64 6c 65 72 20 28   /xfer handler (
06c0: 66 6f 72 20 70 75 73 68 2c 20 70 75 6c 6c 2c 20  for push, pull, 
06d0: 61 6e 64 20 63 6c 6f 6e 65 29 20 64 6f 65 73 20  and clone) does 
06e0: 6e 6f 74 20 64 6f 0a 20 20 20 20 64 65 6c 74 61  not do.    delta
06f0: 20 63 6f 6d 70 72 65 73 73 69 6f 6e 2e 20 20 54   compression.  T
0700: 68 69 73 20 72 65 73 75 6c 74 73 20 69 6e 20 65  his results in e
0710: 78 63 65 73 73 20 62 61 6e 64 77 69 64 74 68 20  xcess bandwidth 
0720: 75 73 61 67 65 2e 0a 20 20 20 20 54 68 65 72 65  usage..    There
0730: 20 61 72 65 20 73 6f 6d 65 20 70 69 65 63 65 73   are some pieces
0740: 20 69 6e 20 78 66 65 72 2e 63 20 74 68 61 74 20   in xfer.c that 
0750: 61 72 65 20 73 6b 65 74 63 68 65 73 20 6f 66 20  are sketches of 
0760: 69 64 65 61 73 20 6f 6e 0a 20 20 20 20 68 6f 77  ideas on.    how
0770: 20 74 6f 20 64 6f 20 64 65 6c 74 61 20 63 6f 6d   to do delta com
0780: 70 72 65 73 73 69 6f 6e 2c 20 62 75 74 20 6e 6f  pression, but no
0790: 74 68 69 6e 67 20 68 61 73 20 62 65 65 6e 20 69  thing has been i
07a0: 6d 70 6c 65 6d 65 6e 74 65 64 2e 0a 0a 20 2a 20  mplemented... * 
07b0: 20 45 6e 68 61 6e 63 65 6d 65 6e 74 73 20 74 6f   Enhancements to
07c0: 20 74 68 65 20 64 69 66 66 20 61 6e 64 20 74 6b   the diff and tk
07d0: 64 69 66 66 20 63 6f 6d 6d 61 6e 64 73 20 69 6e  diff commands in
07e0: 20 74 68 65 20 63 6c 69 2e 0a 20 20 20 20 41 6c   the cli..    Al
07f0: 6c 6f 77 20 74 68 65 20 65 6e 74 69 72 65 20 74  low the entire t
0800: 72 65 65 20 6f 72 20 61 20 73 75 62 74 72 65 65  ree or a subtree
0810: 20 74 6f 20 62 65 20 64 69 66 66 65 64 2c 20 6e   to be diffed, n
0820: 6f 74 20 6a 75 73 74 20 61 20 0a 20 20 20 20 73  ot just a .    s
0830: 69 6e 67 6c 65 20 66 69 6c 65 2e 20 20 41 6c 6c  ingle file.  All
0840: 6f 77 20 64 69 66 66 73 20 61 67 61 69 6e 73 74  ow diffs against
0850: 20 61 6e 79 20 74 77 6f 20 61 72 62 69 74 72 61   any two arbitra
0860: 72 79 20 76 65 72 73 69 6f 6e 73 2c 0a 20 20 20  ry versions,.   
0870: 20 6e 6f 74 20 6a 75 73 74 20 64 69 66 66 73 20   not just diffs 
0880: 61 67 61 69 6e 73 74 20 74 68 65 20 63 75 72 72  against the curr
0890: 65 6e 74 20 63 68 65 63 6b 2d 6f 75 74 2e 20 20  ent check-out.  
08a0: 41 6c 6c 6f 77 20 0a 20 20 20 20 63 6f 6e 66 69  Allow .    confi
08b0: 67 75 72 61 74 69 6f 6e 20 6f 70 74 69 6f 6e 73  guration options
08c0: 20 74 6f 20 72 65 70 6c 61 63 65 20 74 6b 64 69   to replace tkdi
08d0: 66 66 20 77 69 74 68 20 73 6f 6d 65 20 6f 74 68  ff with some oth
08e0: 65 72 0a 20 20 20 20 76 69 73 75 61 6c 20 64 69  er.    visual di
08f0: 66 66 65 72 20 6f 66 20 74 68 65 20 75 73 65 72  ffer of the user
0900: 73 20 63 68 6f 69 63 65 2e 20 45 78 61 6d 70 6c  s choice. Exampl
0910: 65 3a 20 65 73 6b 69 6c 2e 0a 0a 20 2a 20 20 54  e: eskil... *  T
0920: 69 63 6b 65 74 69 6e 67 20 69 6e 74 65 72 66 61  icketing interfa
0930: 63 65 20 28 65 78 70 61 6e 64 20 74 68 69 73 20  ce (expand this 
0940: 62 75 6c 6c 65 74 29 0a 0a 20 20 20 20 20 2b 20  bullet)..     + 
0950: 20 43 72 65 61 74 65 20 6e 65 77 20 74 69 63 6b   Create new tick
0960: 65 74 73 20 61 73 20 66 69 6c 65 73 20 69 6e 20  ets as files in 
0970: 74 68 65 20 66 69 6c 65 20 68 69 65 72 61 72 63  the file hierarc
0980: 68 79 0a 20 20 20 20 20 2b 20 20 41 70 70 65 6e  hy.     +  Appen
0990: 64 20 72 65 6d 61 72 6b 73 20 74 6f 20 61 20 74  d remarks to a t
09a0: 69 63 6b 65 74 0a 20 20 20 20 20 2b 20 20 41 64  icket.     +  Ad
09b0: 64 20 61 74 74 61 63 68 6d 65 6e 74 73 20 74 6f  d attachments to
09c0: 20 61 20 74 69 63 6b 65 74 0a 20 20 20 20 20 2b   a ticket.     +
09d0: 20 20 43 68 61 6e 67 65 20 61 74 74 72 69 62 75    Change attribu
09e0: 74 65 73 20 6f 66 20 61 20 74 69 63 6b 65 74 0a  tes of a ticket.
09f0: 20 20 20 20 20 2b 20 20 44 65 6c 65 74 65 20 74       +  Delete t
0a00: 69 63 6b 65 74 73 20 74 68 61 74 20 61 72 65 20  ickets that are 
0a10: 6e 6f 20 6c 6f 6e 67 65 72 20 63 75 72 72 65 6e  no longer curren
0a20: 74 2e 20 20 28 54 68 65 20 6f 6c 64 0a 20 20 20  t.  (The old.   
0a30: 20 20 20 20 20 63 6f 6e 74 65 6e 74 20 69 73 20       content is 
0a40: 73 74 69 6c 6c 20 61 63 63 65 73 73 69 62 6c 65  still accessible
0a50: 2c 20 74 68 65 20 74 69 63 6b 65 74 20 69 73 20  , the ticket is 
0a60: 6a 75 73 74 20 6e 6f 74 20 69 6e 0a 20 20 20 20  just not in.    
0a70: 20 20 20 20 74 68 65 20 63 75 72 72 65 6e 74 20      the current 
0a80: 63 68 65 63 6b 2d 6f 75 74 2e 29 0a 20 20 20 20  check-out.).    
0a90: 20 2b 20 20 53 65 72 76 65 72 20 73 65 74 75 70   +  Server setup
0aa0: 20 74 6f 20 64 65 66 69 6e 65 20 74 68 65 20 61   to define the a
0ab0: 6c 6c 6f 77 65 64 20 61 74 74 72 69 62 75 74 65  llowed attribute
0ac0: 73 20 61 6e 64 0a 20 20 20 20 20 20 20 20 61 74  s and.        at
0ad0: 74 72 69 62 75 74 65 20 76 61 6c 75 65 73 20 66  tribute values f
0ae0: 6f 72 20 74 69 63 6b 65 74 73 0a 20 20 20 20 20  or tickets.     
0af0: 2b 20 20 50 65 72 6d 61 6e 65 6e 74 6c 79 20 72  +  Permanently r
0b00: 65 6d 6f 76 65 20 6d 61 6c 69 63 69 6f 75 73 20  emove malicious 
0b10: 65 64 69 74 73 20 61 6e 64 2f 6f 72 20 61 74 74  edits and/or att
0b20: 61 63 68 6d 65 6e 74 73 0a 20 20 20 20 20 20 20  achments.       
0b30: 20 73 75 63 68 20 61 73 20 77 69 6b 69 2d 73 70   such as wiki-sp
0b40: 61 6d 20 6f 72 20 77 61 72 65 7a 2e 20 20 28 43  am or warez.  (C
0b50: 6f 6e 74 65 6e 74 20 69 73 20 6e 6f 20 6c 6f 6e  ontent is no lon
0b60: 67 65 72 20 61 63 63 65 73 73 69 62 6c 65 2e 29  ger accessible.)
0b70: 0a 20 20 20 20 20 2b 20 20 56 69 65 77 20 61 20  .     +  View a 
0b80: 68 69 73 74 6f 72 79 20 6f 66 20 61 6c 6c 20 63  history of all c
0b90: 68 61 6e 67 65 73 20 74 6f 20 61 20 74 69 63 6b  hanges to a tick
0ba0: 65 74 0a 20 20 20 20 20 2b 20 20 47 65 6e 65 72  et.     +  Gener
0bb0: 61 74 65 20 72 65 70 6f 72 74 73 20 6f 76 65 72  ate reports over
0bc0: 20 61 6c 6c 20 74 69 63 6b 65 74 73 0a 20 20 20   all tickets.   
0bd0: 20 20 2b 20 20 47 65 6e 65 72 61 74 65 20 72 65    +  Generate re
0be0: 70 6f 72 74 73 20 6f 76 65 72 20 61 6c 6c 20 74  ports over all t
0bf0: 69 63 6b 65 74 73 20 61 73 20 74 68 65 79 20 65  ickets as they e
0c00: 78 69 73 74 65 64 20 66 6f 72 0a 20 20 20 20 20  xisted for.     
0c10: 20 20 20 61 20 63 68 6f 73 65 6e 20 70 6f 69 6e     a chosen poin
0c20: 74 20 69 6e 20 74 69 6d 65 20 61 6e 64 20 73 70  t in time and sp
0c30: 61 63 65 2e 0a 20 20 20 20 20 2b 20 20 44 6f 20  ace..     +  Do 
0c40: 66 75 6c 6c 20 74 65 78 74 20 73 65 61 72 63 68  full text search
0c50: 20 61 67 61 69 6e 73 74 20 74 68 65 20 74 65 78   against the tex
0c60: 74 20 69 6e 20 61 6e 79 20 73 69 6e 67 6c 65 20  t in any single 
0c70: 74 69 63 6b 65 74 20 6f 72 0a 20 20 20 20 20 20  ticket or.      
0c80: 20 20 61 63 72 6f 73 73 20 74 68 65 20 63 75 72    across the cur
0c90: 72 65 6e 74 20 76 65 72 73 69 6f 6e 73 20 6f 66  rent versions of
0ca0: 20 61 6c 6c 20 74 69 63 6b 65 74 73 2c 20 6f 72   all tickets, or
0cb0: 20 61 63 72 6f 73 73 20 61 6c 6c 20 63 75 72 72   across all curr
0cc0: 65 6e 74 0a 20 20 20 20 20 20 20 20 61 6e 64 20  ent.        and 
0cd0: 68 69 73 74 6f 72 69 63 61 6c 20 76 65 72 73 69  historical versi
0ce0: 6f 6e 73 20 6f 66 20 61 6c 6c 20 74 69 63 6b 65  ons of all ticke
0cf0: 74 73 2e 0a 0a 20 2a 20 20 57 69 6b 69 20 69 6e  ts... *  Wiki in
0d00: 74 65 72 66 61 63 65 20 28 65 78 70 61 6e 64 20  terface (expand 
0d10: 74 68 69 73 20 62 75 6c 6c 65 74 29 0a 0a 20 20  this bullet)..  
0d20: 20 20 20 2b 20 20 43 72 65 61 74 65 20 6e 65 77     +  Create new
0d30: 20 77 69 6b 69 20 70 61 67 65 73 0a 20 20 20 20   wiki pages.    
0d40: 20 2b 20 20 44 65 73 69 67 6e 61 74 65 20 61 20   +  Designate a 
0d50: 73 69 6e 67 6c 65 20 77 69 6b 69 20 70 61 67 65  single wiki page
0d60: 20 61 73 20 74 68 65 20 68 6f 6d 65 20 70 61 67   as the home pag
0d70: 65 20 66 6f 72 20 74 68 65 20 77 77 77 20 69 6e  e for the www in
0d80: 74 65 72 66 61 63 65 0a 20 20 20 20 20 2b 20 20  terface.     +  
0d90: 44 65 73 69 67 6e 61 74 65 20 77 69 6b 69 20 70  Designate wiki p
0da0: 61 67 65 73 20 61 73 20 72 65 61 64 2d 6f 6e 6c  ages as read-onl
0db0: 79 2c 20 61 70 70 65 6e 64 2d 6f 6e 6c 79 2c 20  y, append-only, 
0dc0: 6f 72 20 72 65 61 64 2f 77 72 69 74 65 2e 0a 20  or read/write.. 
0dd0: 20 20 20 20 2b 20 20 41 70 70 65 6e 64 20 63 6f      +  Append co
0de0: 6d 6d 65 6e 74 73 20 74 6f 20 61 20 77 69 6b 69  mments to a wiki
0df0: 20 70 61 67 65 0a 20 20 20 20 20 2b 20 20 41 64   page.     +  Ad
0e00: 64 20 61 74 74 61 63 68 6d 65 6e 74 73 20 28 73  d attachments (s
0e10: 75 63 68 20 61 73 20 47 49 46 20 69 6d 61 67 65  uch as GIF image
0e20: 73 29 20 74 6f 20 61 20 77 69 6b 69 20 70 61 67  s) to a wiki pag
0e30: 65 0a 20 20 20 20 20 2b 20 20 43 68 61 6e 67 65  e.     +  Change
0e40: 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20   the content of 
0e50: 61 20 77 69 6b 69 20 70 61 67 65 0a 20 20 20 20  a wiki page.    
0e60: 20 2b 20 20 44 65 6c 65 74 65 20 6f 62 73 6f 6c   +  Delete obsol
0e70: 65 74 65 20 77 69 6b 69 20 70 61 67 65 73 2e 20  ete wiki pages. 
0e80: 20 28 4f 6c 64 20 63 6f 6e 74 65 6e 74 20 69 73   (Old content is
0e90: 20 73 74 69 6c 6c 20 61 63 63 65 73 73 69 62 6c   still accessibl
0ea0: 65 2c 0a 20 20 20 20 20 20 20 20 74 68 65 20 70  e,.        the p
0eb0: 61 67 65 20 69 73 20 6a 75 73 74 20 6e 6f 74 20  age is just not 
0ec0: 6f 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 6c  on the current l
0ed0: 69 73 74 20 6f 66 20 70 61 67 65 73 2e 29 0a 20  ist of pages.). 
0ee0: 20 20 20 20 2b 20 20 50 65 72 6d 61 6e 65 6e 74      +  Permanent
0ef0: 6c 79 20 72 65 6d 6f 76 65 20 6d 61 6c 69 63 69  ly remove malici
0f00: 6f 75 73 20 65 64 69 74 73 20 61 6e 64 2f 6f 72  ous edits and/or
0f10: 20 61 74 74 61 63 68 6d 65 6e 74 73 0a 20 20 20   attachments.   
0f20: 20 20 20 20 20 73 75 63 68 20 61 73 20 77 69 6b       such as wik
0f30: 69 2d 73 70 61 6d 20 6f 72 20 77 61 72 65 7a 2e  i-spam or warez.
0f40: 20 20 28 4f 6c 64 20 63 6f 6e 74 65 6e 74 20 69    (Old content i
0f50: 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 61 63 63 65  s no longer acce
0f60: 73 73 69 62 6c 65 2e 29 0a 20 20 20 20 20 2b 20  ssible.).     + 
0f70: 20 41 64 64 20 6e 6f 66 6f 6c 6c 6f 77 20 6f 6e   Add nofollow on
0f80: 20 65 78 74 65 72 6e 61 6c 20 6c 69 6e 6b 73 20   external links 
0f90: 61 64 64 65 64 20 62 79 20 75 6e 70 72 69 76 69  added by unprivi
0fa0: 6c 65 67 65 64 0a 20 20 20 20 20 20 20 20 75 73  leged.        us
0fb0: 65 72 73 20 77 68 65 6e 20 74 68 65 20 6c 69 6e  ers when the lin
0fc0: 6b 20 69 73 20 6c 65 73 73 20 74 68 61 6e 20 4e  k is less than N
0fd0: 20 68 6f 75 72 73 20 6f 6c 64 2e 0a 20 20 20 20   hours old..    
0fe0: 20 2b 20 20 53 68 6f 77 20 74 68 65 20 63 6f 6d   +  Show the com
0ff0: 70 6c 65 74 65 20 68 69 73 74 6f 72 79 20 6f 66  plete history of
1000: 20 61 20 73 69 6e 67 6c 65 20 77 69 6b 69 20 70   a single wiki p
1010: 61 67 65 0a 20 20 20 20 20 2b 20 20 50 72 6f 76  age.     +  Prov
1020: 69 64 65 20 74 68 65 20 61 62 69 6c 69 74 79 20  ide the ability 
1030: 74 6f 20 64 69 66 66 20 74 77 6f 20 76 65 72 73  to diff two vers
1040: 69 6f 6e 73 20 6f 66 20 61 20 77 69 6b 69 20 70  ions of a wiki p
1050: 61 67 65 0a 20 20 20 20 20 2b 20 20 53 68 6f 77  age.     +  Show
1060: 20 61 20 6c 69 73 74 69 6e 67 20 6f 66 20 61 6c   a listing of al
1070: 6c 20 77 69 6b 69 20 70 61 67 65 73 2c 20 62 6f  l wiki pages, bo
1080: 74 68 20 63 75 72 72 65 6e 74 20 61 6e 64 20 64  th current and d
1090: 65 6c 65 74 65 64 0a 20 20 20 20 20 2b 20 20 44  eleted.     +  D
10a0: 6f 20 61 20 66 75 6c 6c 2d 74 65 78 74 20 73 65  o a full-text se
10b0: 61 72 63 68 20 61 67 61 69 6e 73 74 20 63 75 72  arch against cur
10c0: 72 65 6e 74 20 76 65 72 73 69 6f 6e 73 20 6f 66  rent versions of
10d0: 20 61 6c 6c 20 77 69 6b 69 20 70 61 67 65 73 0a   all wiki pages.
10e0: 20 20 20 20 20 2b 20 20 44 6f 20 61 20 66 75 6c       +  Do a ful
10f0: 6c 2d 74 65 78 74 20 73 65 61 72 63 68 20 61 67  l-text search ag
1100: 61 69 6e 73 74 20 61 6c 6c 20 68 69 73 74 6f 72  ainst all histor
1110: 69 63 61 6c 20 76 65 72 73 69 6f 6e 73 20 6f 66  ical versions of
1120: 20 61 20 73 69 6e 67 6c 65 0a 20 20 20 20 20 20   a single.      
1130: 20 20 77 69 6b 69 20 70 61 67 65 0a 20 20 20 20    wiki page.    
1140: 20 2b 20 20 44 6f 20 61 20 66 75 6c 6c 2d 74 65   +  Do a full-te
1150: 78 74 20 73 65 61 72 63 68 20 61 67 61 69 6e 73  xt search agains
1160: 74 20 61 6c 6c 20 68 69 73 74 6f 72 69 63 61 6c  t all historical
1170: 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 61 6c 6c   versions of all
1180: 0a 20 20 20 20 20 20 20 20 77 69 6b 69 20 70 61  .        wiki pa
1190: 67 65 73 0a 0a 20 2a 20 20 46 75 6c 6c 2d 74 65  ges.. *  Full-te
11a0: 78 74 20 73 65 61 72 63 68 20 61 67 61 69 6e 73  xt search agains
11b0: 74 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d 6d 65  t check-in comme
11c0: 6e 74 73 20 61 6e 64 20 64 69 66 66 73 20 6f 66  nts and diffs of
11d0: 20 65 61 63 68 0a 20 20 20 20 63 68 65 63 6b 2d   each.    check-
11e0: 69 6e 2e 0a 0a 20 2a 20 20 41 62 69 6c 69 74 79  in... *  Ability
11f0: 20 74 6f 20 63 68 65 63 6b 2d 69 6e 20 73 6f 6d   to check-in som
1200: 65 20 73 75 62 73 65 74 20 6f 66 20 63 68 61 6e  e subset of chan
1210: 67 65 73 20 74 6f 20 74 68 65 20 74 72 65 65 20  ges to the tree 
1220: 69 6e 73 74 65 61 64 0a 20 20 20 20 6f 66 20 68  instead.    of h
1230: 61 76 69 6e 67 20 74 6f 20 63 68 65 63 6b 20 69  aving to check i
1240: 6e 20 61 6c 6c 20 63 68 61 6e 67 65 73 2e 0a 0a  n all changes...
1250: 20 2a 20 20 41 64 64 20 61 20 22 72 65 76 65 72   *  Add a "rever
1260: 74 22 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20  t" command that 
1270: 77 69 6c 6c 20 75 6e 64 6f 20 61 6c 6c 20 63 68  will undo all ch
1280: 61 6e 67 65 73 20 74 6f 20 61 20 66 69 6c 65 0a  anges to a file.
1290: 20 20 20 20 6f 72 20 66 69 6c 65 73 20 69 6e 20      or files in 
12a0: 74 68 65 20 63 75 72 72 65 6e 74 20 63 68 65 63  the current chec
12b0: 6b 2d 6f 75 74 20 2d 20 72 65 73 74 6f 72 69 6e  k-out - restorin
12c0: 67 20 74 68 65 20 66 69 6c 65 73 20 62 61 63 6b  g the files back
12d0: 0a 20 20 20 20 74 6f 20 74 68 65 69 72 20 6f 72  .    to their or
12e0: 69 67 69 6e 61 6c 20 63 68 65 63 6b 2d 6f 75 74  iginal check-out
12f0: 20 73 74 61 74 65 2e 0a 0a 20 2a 20 20 41 64 64   state... *  Add
1300: 20 61 6e 20 22 61 6e 6e 6f 74 61 74 65 22 20 63   an "annotate" c
1310: 6f 6d 6d 61 6e 64 20 69 6e 20 62 6f 74 68 20 74  ommand in both t
1320: 68 65 20 63 6c 69 20 61 6e 64 20 74 68 65 20 77  he cli and the w
1330: 77 77 20 69 6e 74 65 72 66 61 63 65 0a 20 20 20  ww interface.   
1340: 20 74 68 61 74 20 77 69 6c 6c 20 73 68 6f 77 20   that will show 
1350: 6c 69 6e 65 2d 62 79 2d 6c 69 6e 65 20 74 68 65  line-by-line the
1360: 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 63 68 61   most recent cha
1370: 6e 67 65 73 20 74 6f 20 65 76 65 72 79 20 6c 69  nges to every li
1380: 6e 65 0a 20 20 20 20 69 6e 20 74 68 65 20 66 69  ne.    in the fi
1390: 6c 65 2e 0a 0a 20 2a 20 20 42 72 6f 77 73 65 20  le... *  Browse 
13a0: 74 68 65 20 66 69 6c 65 20 68 69 65 72 61 72 63  the file hierarc
13b0: 68 79 2c 20 73 69 6d 69 6c 61 72 20 74 6f 20 74  hy, similar to t
13c0: 68 65 20 22 42 72 6f 77 73 65 22 20 66 65 61 74  he "Browse" feat
13d0: 75 72 65 20 69 6e 0a 20 20 20 20 43 56 53 54 72  ure in.    CVSTr
13e0: 61 63 2e 0a 0a 20 2a 20 20 41 64 64 20 74 68 65  ac... *  Add the
13f0: 20 61 62 69 6c 69 74 79 20 74 6f 20 6f 76 65 72   ability to over
1400: 72 69 64 65 20 63 68 65 63 6b 2d 69 6e 20 63 6f  ride check-in co
1410: 6d 6d 65 6e 74 73 2e 20 20 49 74 20 69 73 20 6e  mments.  It is n
1420: 6f 74 20 70 6f 73 73 69 62 6c 65 0a 20 20 20 20  ot possible.    
1430: 74 6f 20 63 68 61 6e 67 65 20 74 68 65 20 63 6f  to change the co
1440: 6d 6d 65 6e 74 20 69 6e 20 74 68 65 20 63 68 65  mment in the che
1450: 63 6b 2d 69 6e 20 69 74 73 65 6c 66 20 64 75 65  ck-in itself due
1460: 20 74 6f 20 74 68 65 20 63 72 79 70 74 6f 67 72   to the cryptogr
1470: 61 70 68 69 63 0a 20 20 20 20 68 61 73 68 2e 20  aphic.    hash. 
1480: 20 42 75 74 20 79 6f 75 20 63 61 6e 20 61 64 64   But you can add
1490: 20 61 20 6e 65 77 20 72 65 63 6f 72 64 20 74 6f   a new record to
14a0: 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 20   the repository 
14b0: 74 68 61 74 20 6f 76 65 72 6c 6f 61 64 73 0a 20  that overloads. 
14c0: 20 20 20 61 20 63 68 65 63 6b 2d 69 6e 20 63 6f     a check-in co
14d0: 6d 6d 65 6e 74 20 77 69 74 68 20 61 20 6e 65 77  mment with a new
14e0: 20 63 6f 6d 6d 65 6e 74 2e 20 20 43 6f 6d 6d 65   comment.  Comme
14f0: 6e 74 20 63 68 61 6e 67 65 73 20 73 68 6f 75 6c  nt changes shoul
1500: 64 20 62 65 0a 20 20 20 20 47 50 47 20 63 6c 65  d be.    GPG cle
1510: 61 72 73 69 67 6e 65 64 20 61 74 20 74 68 65 20  arsigned at the 
1520: 76 65 72 79 20 6c 65 61 73 74 2e 20 20 43 6f 6d  very least.  Com
1530: 6d 65 6e 74 20 63 68 61 6e 67 65 73 20 6f 6e 6c  ment changes onl
1540: 79 20 61 70 70 6c 79 20 69 66 0a 20 20 20 20 74  y apply if.    t
1550: 68 65 20 75 73 65 72 20 77 68 6f 20 6d 61 64 65  he user who made
1560: 20 74 68 65 20 63 68 61 6e 67 65 20 68 61 73 20   the change has 
1570: 74 68 65 20 72 69 67 68 74 20 70 65 72 6d 69 73  the right permis
1580: 73 69 6f 6e 73 2e 0a 0a 20 2a 20 20 4e 65 77 20  sions... *  New 
1590: 63 6c 69 20 63 6f 6d 6d 61 6e 64 73 3a 20 22 64  cli commands: "d
15a0: 65 63 6f 6e 73 74 72 75 63 74 22 20 61 6e 64 20  econstruct" and 
15b0: 22 72 65 63 6f 6e 73 74 72 75 63 74 22 2e 20 20  "reconstruct".  
15c0: 54 68 65 20 64 65 63 6f 6e 73 74 72 75 63 74 0a  The deconstruct.
15d0: 20 20 20 20 63 6f 6d 6d 61 6e 64 20 70 6f 70 75      command popu
15e0: 6c 61 74 65 73 20 61 6e 20 69 6e 64 69 63 61 74  lates an indicat
15f0: 65 64 20 64 69 72 65 63 74 6f 72 79 20 77 69 74  ed directory wit
1600: 68 20 63 6f 70 69 65 73 20 6f 66 20 61 6c 6c 20  h copies of all 
1610: 66 69 6c 65 73 0a 20 20 20 20 63 6f 6e 74 61 69  files.    contai
1620: 6e 65 64 20 77 69 74 68 69 6e 20 74 68 65 20 72  ned within the r
1630: 65 70 6f 73 69 74 6f 72 79 2e 20 20 46 69 6c 65  epository.  File
1640: 73 20 61 72 65 20 6e 61 6d 65 64 20 61 61 61 2f  s are named aaa/
1650: 62 62 62 62 62 62 62 20 77 68 65 72 65 0a 20 20  bbbbbbb where.  
1660: 20 20 61 61 61 20 69 73 20 74 68 65 20 66 69 72    aaa is the fir
1670: 73 74 20 33 20 63 68 61 72 61 63 74 65 72 73 20  st 3 characters 
1680: 6f 66 20 74 68 65 20 75 75 69 64 20 61 6e 64 20  of the uuid and 
1690: 62 62 62 62 62 62 20 69 73 20 74 68 65 0a 20 20  bbbbbb is the.  
16a0: 20 20 72 65 6d 61 69 6e 69 6e 67 20 33 37 20 63    remaining 37 c
16b0: 68 61 72 61 63 74 65 72 73 2e 20 20 72 65 63 6f  haracters.  reco
16c0: 6e 73 74 72 75 63 74 20 62 75 69 6c 64 73 20 61  nstruct builds a
16d0: 20 6e 65 77 20 72 65 70 6f 73 69 74 6f 72 79 0a   new repository.
16e0: 20 20 20 20 63 6f 6e 74 61 69 6e 69 6e 67 20 61      containing a
16f0: 6c 6c 20 66 69 6c 65 73 20 69 6e 20 61 6e 20 69  ll files in an i
1700: 6e 64 69 63 61 74 65 64 20 64 69 72 65 63 74 6f  ndicated directo
1710: 72 79 2e 20 20 57 68 65 6e 20 72 65 63 6f 6e 73  ry.  When recons
1720: 74 72 75 63 74 69 6e 67 2c 0a 20 20 20 20 73 6f  tructing,.    so
1730: 6d 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69  me information i
1740: 73 20 6c 6f 73 74 3a 20 70 72 6f 6a 65 63 74 2d  s lost: project-
1750: 63 6f 64 65 2c 20 73 65 72 76 65 72 2d 63 6f 64  code, server-cod
1760: 65 2c 20 75 73 65 72 73 2e 20 20 0a 20 20 20 20  e, users.  .    
1770: 4a 75 73 74 20 6d 61 6b 65 20 75 70 20 61 20 6e  Just make up a n
1780: 65 77 20 70 72 6f 6a 65 63 74 2d 63 6f 64 65 2e  ew project-code.
1790: 20 20 0a 0a 20 2a 20 20 47 65 74 20 61 20 62 75    .. *  Get a bu
17a0: 69 6c 64 20 77 6f 72 6b 69 6e 67 20 66 6f 72 20  ild working for 
17b0: 77 69 6e 33 32 2e 20 20 50 65 72 68 61 70 73 20  win32.  Perhaps 
17c0: 75 73 65 20 63 79 67 77 69 6e 2e 20 20 4f 72 20  use cygwin.  Or 
17d0: 6f 6d 69 74 0a 20 20 20 20 74 68 65 20 73 65 72  omit.    the ser
17e0: 76 65 72 20 63 6f 6d 70 6f 6e 65 6e 74 20 66 72  ver component fr
17f0: 6f 6d 20 77 69 6e 33 32 20 28 74 6f 20 65 6c 69  om win32 (to eli
1800: 6d 69 6e 61 74 65 20 74 68 65 20 6e 65 65 64 20  minate the need 
1810: 66 6f 72 20 66 6f 72 6b 28 29 29 2e 0a 0a 20 2a  for fork())... *
1820: 20 20 4d 61 6b 65 20 74 68 65 20 69 6e 74 65 72    Make the inter
1830: 66 61 63 65 20 74 6f 20 66 6f 73 73 69 6c 20 6c  face to fossil l
1840: 6f 6f 6b 20 70 72 65 74 74 79 20 61 6e 64 20 62  ook pretty and b
1850: 65 20 63 75 73 74 6f 6d 69 7a 61 62 6c 65 20 73  e customizable s
1860: 6f 0a 20 20 20 20 74 68 61 74 20 6f 74 68 65 72  o.    that other
1870: 20 70 65 6f 70 6c 65 20 77 69 6c 6c 20 62 65 20   people will be 
1880: 61 74 74 72 61 63 74 65 64 20 74 6f 20 69 74 2c  attracted to it,
1890: 20 77 69 6c 6c 20 74 61 6b 65 20 6f 76 65 72 20   will take over 
18a0: 6d 61 69 6e 74 65 6e 61 6e 63 65 0a 20 20 20 20  maintenance.    
18b0: 6f 66 20 69 74 2c 20 61 6e 64 20 77 65 20 63 61  of it, and we ca
18c0: 6e 20 65 76 65 6e 74 75 61 6c 6c 79 20 6d 6f 76  n eventually mov
18d0: 65 20 6f 6e 20 74 6f 20 6f 74 68 65 72 20 74 68  e on to other th
18e0: 69 6e 67 73 2e 0a                                ings..