Artifact 3d872fddda203e00717e13b0e849240c64acf928:
File
todo.txt
part of check-in
[452a71f40b]
- Merge in aku's documentation updates.
by
drh on
2007-08-26 03:03:58.
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 bf 0a 20 2a 20 20 54 68 65 20 69 70 61 m.... * The ipa
03d0: 64 64 72 20 66 69 65 6c 64 20 6f 66 20 74 68 65 ddr field of the
03e0: 20 72 63 76 66 72 6f 6d 20 74 61 62 6c 65 20 69 rcvfrom table i
03f0: 73 20 6e 6f 74 20 62 65 69 6e 67 20 73 65 74 2e s not being set.
0400: 20 20 54 68 69 73 0a 20 20 20 20 66 69 65 6c 64 This. field
0410: 20 73 68 6f 75 6c 64 20 62 65 20 74 68 65 20 49 should be the I
0420: 50 20 61 64 64 72 65 73 73 20 66 72 6f 6d 20 77 P address from w
0430: 68 69 63 68 20 69 6e 66 6f 72 6d 61 74 69 6f 6e hich information
0440: 20 69 73 20 72 65 63 65 69 76 65 64 0a 20 20 20 is received.
0450: 20 66 6f 72 20 74 68 65 20 6c 6f 63 61 6c 20 72 for the local r
0460: 65 70 6f 73 69 74 6f 72 79 2e 20 20 53 6f 20 77 epository. So w
0470: 68 65 6e 20 73 6f 6d 65 62 6f 64 79 20 64 6f 65 hen somebody doe
0480: 73 20 61 20 70 75 73 68 20 6f 66 20 6e 65 77 0a s a push of new.
0490: 20 20 20 20 66 69 6c 65 73 20 77 65 20 72 65 63 files we rec
04a0: 6f 72 64 20 74 68 65 20 69 70 61 64 64 72 2e 20 ord the ipaddr.
04b0: 20 4f 72 20 77 68 65 6e 20 77 65 20 64 6f 20 61 Or when we do a
04c0: 20 70 75 6c 6c 2c 20 77 65 20 72 65 63 6f 72 64 pull, we record
04d0: 0a 20 20 20 20 74 68 65 20 69 70 61 64 64 72 2e . the ipaddr.
04e0: 0a 0a 20 2a 20 20 41 64 64 69 74 69 6f 6e 61 6c .. * Additional
04f0: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 64 69 73 information dis
0500: 70 6c 61 79 65 64 20 66 6f 72 20 74 68 65 20 22 played for the "
0510: 76 69 6e 66 6f 22 20 70 61 67 65 3a 0a 0a 20 20 vinfo" page:..
0520: 20 20 20 2b 20 20 41 6c 6c 20 6c 65 61 76 65 73 + All leaves
0530: 20 6f 66 20 74 68 69 73 20 76 65 72 73 69 6f 6e of this version
0540: 20 74 68 61 74 20 61 72 65 20 6e 6f 74 20 69 6e that are not in
0550: 63 6c 75 64 65 64 20 69 6e 20 74 68 65 0a 20 20 cluded in the.
0560: 20 20 20 20 20 20 64 65 73 63 65 6e 64 61 6e 74 descendant
0570: 20 6c 69 73 74 2e 20 20 57 69 74 68 20 64 61 74 list. With dat
0580: 65 2c 20 75 73 65 72 2c 20 63 6f 6d 6d 65 6e 74 e, user, comment
0590: 2c 20 61 6e 64 20 68 79 70 65 72 6c 69 6e 6b 2e , and hyperlink.
05a0: 0a 20 20 20 20 20 20 20 20 4c 65 61 76 65 73 20 . Leaves
05b0: 69 6e 20 74 68 65 20 64 65 73 63 65 6e 64 61 6e in the descendan
05c0: 74 20 74 61 62 6c 65 20 73 68 6f 75 6c 64 20 62 t table should b
05d0: 65 20 6d 61 72 6b 65 64 20 61 73 20 73 75 63 68 e marked as such
05e0: 2e 0a 20 20 20 20 20 20 20 20 53 65 65 20 74 68 .. See th
05f0: 65 20 63 6f 6d 70 75 74 65 5f 6c 65 61 76 65 73 e compute_leaves
0600: 28 29 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 73 () function to s
0610: 65 65 20 68 6f 77 20 74 6f 20 66 69 6e 64 20 61 ee how to find a
0620: 6c 6c 0a 20 20 20 20 20 20 20 20 6c 65 61 76 65 ll. leave
0630: 73 2e 0a 20 20 20 20 20 2b 20 20 41 64 64 20 66 s.. + Add f
0640: 69 6c 65 20 64 69 66 66 20 6c 69 6e 6b 73 20 74 ile diff links t
0650: 6f 20 74 68 65 20 66 69 6c 65 20 63 68 61 6e 67 o the file chang
0660: 65 20 6c 69 73 74 2e 0a 0a 20 2a 20 20 54 69 6d e list... * Tim
0670: 65 6c 69 6e 65 20 65 6e 68 61 6e 63 65 64 20 73 eline enhanced s
0680: 6f 20 74 68 61 74 20 79 6f 75 20 63 61 6e 20 73 o that you can s
0690: 70 65 63 69 66 79 20 61 20 72 61 6e 67 65 20 6f pecify a range o
06a0: 66 20 64 61 74 65 73 2e 0a 0a 20 2a 20 20 54 68 f dates... * Th
06b0: 65 20 2f 78 66 65 72 20 68 61 6e 64 6c 65 72 20 e /xfer handler
06c0: 28 66 6f 72 20 70 75 73 68 2c 20 70 75 6c 6c 2c (for push, pull,
06d0: 20 61 6e 64 20 63 6c 6f 6e 65 29 20 64 6f 65 73 and clone) does
06e0: 20 6e 6f 74 20 64 6f 0a 20 20 20 20 64 65 6c 74 not do. delt
06f0: 61 20 63 6f 6d 70 72 65 73 73 69 6f 6e 2e 20 20 a compression.
0700: 54 68 69 73 20 72 65 73 75 6c 74 73 20 69 6e 20 This results in
0710: 65 78 63 65 73 73 20 62 61 6e 64 77 69 64 74 68 excess bandwidth
0720: 20 75 73 61 67 65 2e 0a 20 20 20 20 54 68 65 72 usage.. Ther
0730: 65 20 61 72 65 20 73 6f 6d 65 20 70 69 65 63 65 e are some piece
0740: 73 20 69 6e 20 78 66 65 72 2e 63 20 74 68 61 74 s in xfer.c that
0750: 20 61 72 65 20 73 6b 65 74 63 68 65 73 20 6f 66 are sketches of
0760: 20 69 64 65 61 73 20 6f 6e 0a 20 20 20 20 68 6f ideas on. ho
0770: 77 20 74 6f 20 64 6f 20 64 65 6c 74 61 20 63 6f w to do delta co
0780: 6d 70 72 65 73 73 69 6f 6e 2c 20 62 75 74 20 6e mpression, but n
0790: 6f 74 68 69 6e 67 20 68 61 73 20 62 65 65 6e 20 othing has been
07a0: 69 6d 70 6c 65 6d 65 6e 74 65 64 2e 0a 0a 20 2a implemented... *
07b0: 20 20 45 6e 68 61 6e 63 65 6d 65 6e 74 73 20 74 Enhancements t
07c0: 6f 20 74 68 65 20 64 69 66 66 20 61 6e 64 20 74 o the diff and t
07d0: 6b 64 69 66 66 20 63 6f 6d 6d 61 6e 64 73 20 69 kdiff commands i
07e0: 6e 20 74 68 65 20 63 6c 69 2e 0a 20 20 20 20 41 n the cli.. A
07f0: 6c 6c 6f 77 20 74 68 65 20 65 6e 74 69 72 65 20 llow the entire
0800: 74 72 65 65 20 6f 72 20 61 20 73 75 62 74 72 65 tree or a subtre
0810: 65 20 74 6f 20 62 65 20 64 69 66 66 65 64 2c 20 e to be diffed,
0820: 6e 6f 74 20 6a 75 73 74 20 61 20 0a 20 20 20 20 not just a .
0830: 73 69 6e 67 6c 65 20 66 69 6c 65 2e 20 20 41 6c single file. Al
0840: 6c 6f 77 20 64 69 66 66 73 20 61 67 61 69 6e 73 low diffs agains
0850: 74 20 61 6e 79 20 74 77 6f 20 61 72 62 69 74 72 t any two arbitr
0860: 61 72 79 20 76 65 72 73 69 6f 6e 73 2c 0a 20 20 ary versions,.
0870: 20 20 6e 6f 74 20 6a 75 73 74 20 64 69 66 66 73 not just diffs
0880: 20 61 67 61 69 6e 73 74 20 74 68 65 20 63 75 72 against the cur
0890: 72 65 6e 74 20 63 68 65 63 6b 2d 6f 75 74 2e 20 rent check-out.
08a0: 20 41 6c 6c 6f 77 20 0a 20 20 20 20 63 6f 6e 66 Allow . conf
08b0: 69 67 75 72 61 74 69 6f 6e 20 6f 70 74 69 6f 6e iguration option
08c0: 73 20 74 6f 20 72 65 70 6c 61 63 65 20 74 6b 64 s to replace tkd
08d0: 69 66 66 20 77 69 74 68 20 73 6f 6d 65 20 6f 74 iff with some ot
08e0: 68 65 72 0a 20 20 20 20 76 69 73 75 61 6c 20 64 her. visual d
08f0: 69 66 66 65 72 20 6f 66 20 74 68 65 20 75 73 65 iffer of the use
0900: 72 73 20 63 68 6f 69 63 65 2e 20 45 78 61 6d 70 rs choice. Examp
0910: 6c 65 3a 20 65 73 6b 69 6c 2e 0a 0a 20 2a 20 20 le: eskil... *
0920: 54 69 63 6b 65 74 69 6e 67 20 69 6e 74 65 72 66 Ticketing interf
0930: 61 63 65 20 28 65 78 70 61 6e 64 20 74 68 69 73 ace (expand this
0940: 20 62 75 6c 6c 65 74 29 0a 0a 20 20 20 20 20 2b bullet).. +
0950: 20 20 43 72 65 61 74 65 20 6e 65 77 20 74 69 63 Create new tic
0960: 6b 65 74 73 20 61 73 20 66 69 6c 65 73 20 69 6e kets as files in
0970: 20 74 68 65 20 66 69 6c 65 20 68 69 65 72 61 72 the file hierar
0980: 63 68 79 0a 20 20 20 20 20 2b 20 20 41 70 70 65 chy. + Appe
0990: 6e 64 20 72 65 6d 61 72 6b 73 20 74 6f 20 61 20 nd remarks to a
09a0: 74 69 63 6b 65 74 0a 20 20 20 20 20 2b 20 20 41 ticket. + A
09b0: 64 64 20 61 74 74 61 63 68 6d 65 6e 74 73 20 74 dd attachments t
09c0: 6f 20 61 20 74 69 63 6b 65 74 0a 20 20 20 20 20 o a ticket.
09d0: 2b 20 20 43 68 61 6e 67 65 20 61 74 74 72 69 62 + Change attrib
09e0: 75 74 65 73 20 6f 66 20 61 20 74 69 63 6b 65 74 utes of a ticket
09f0: 0a 20 20 20 20 20 2b 20 20 44 65 6c 65 74 65 20 . + Delete
0a00: 74 69 63 6b 65 74 73 20 74 68 61 74 20 61 72 65 tickets that are
0a10: 20 6e 6f 20 6c 6f 6e 67 65 72 20 63 75 72 72 65 no longer curre
0a20: 6e 74 2e 20 20 28 54 68 65 20 6f 6c 64 0a 20 20 nt. (The old.
0a30: 20 20 20 20 20 20 63 6f 6e 74 65 6e 74 20 69 73 content is
0a40: 20 73 74 69 6c 6c 20 61 63 63 65 73 73 69 62 6c still accessibl
0a50: 65 2c 20 74 68 65 20 74 69 63 6b 65 74 20 69 73 e, the ticket is
0a60: 20 6a 75 73 74 20 6e 6f 74 20 69 6e 0a 20 20 20 just not in.
0a70: 20 20 20 20 20 74 68 65 20 63 75 72 72 65 6e 74 the current
0a80: 20 63 68 65 63 6b 2d 6f 75 74 2e 29 0a 20 20 20 check-out.).
0a90: 20 20 2b 20 20 53 65 72 76 65 72 20 73 65 74 75 + Server setu
0aa0: 70 20 74 6f 20 64 65 66 69 6e 65 20 74 68 65 20 p to define the
0ab0: 61 6c 6c 6f 77 65 64 20 61 74 74 72 69 62 75 74 allowed attribut
0ac0: 65 73 20 61 6e 64 0a 20 20 20 20 20 20 20 20 61 es and. a
0ad0: 74 74 72 69 62 75 74 65 20 76 61 6c 75 65 73 20 ttribute values
0ae0: 66 6f 72 20 74 69 63 6b 65 74 73 0a 20 20 20 20 for tickets.
0af0: 20 2b 20 20 50 65 72 6d 61 6e 65 6e 74 6c 79 20 + Permanently
0b00: 72 65 6d 6f 76 65 20 6d 61 6c 69 63 69 6f 75 73 remove malicious
0b10: 20 65 64 69 74 73 20 61 6e 64 2f 6f 72 20 61 74 edits and/or at
0b20: 74 61 63 68 6d 65 6e 74 73 0a 20 20 20 20 20 20 tachments.
0b30: 20 20 73 75 63 68 20 61 73 20 77 69 6b 69 2d 73 such as wiki-s
0b40: 70 61 6d 20 6f 72 20 77 61 72 65 7a 2e 20 20 28 pam or warez. (
0b50: 43 6f 6e 74 65 6e 74 20 69 73 20 6e 6f 20 6c 6f Content is no lo
0b60: 6e 67 65 72 20 61 63 63 65 73 73 69 62 6c 65 2e nger accessible.
0b70: 29 0a 20 20 20 20 20 2b 20 20 56 69 65 77 20 61 ). + View a
0b80: 20 68 69 73 74 6f 72 79 20 6f 66 20 61 6c 6c 20 history of all
0b90: 63 68 61 6e 67 65 73 20 74 6f 20 61 20 74 69 63 changes to a tic
0ba0: 6b 65 74 0a 20 20 20 20 20 2b 20 20 47 65 6e 65 ket. + Gene
0bb0: 72 61 74 65 20 72 65 70 6f 72 74 73 20 6f 76 65 rate reports ove
0bc0: 72 20 61 6c 6c 20 74 69 63 6b 65 74 73 0a 20 20 r all tickets.
0bd0: 20 20 20 2b 20 20 47 65 6e 65 72 61 74 65 20 72 + Generate r
0be0: 65 70 6f 72 74 73 20 6f 76 65 72 20 61 6c 6c 20 eports over all
0bf0: 74 69 63 6b 65 74 73 20 61 73 20 74 68 65 79 20 tickets as they
0c00: 65 78 69 73 74 65 64 20 66 6f 72 0a 20 20 20 20 existed for.
0c10: 20 20 20 20 61 20 63 68 6f 73 65 6e 20 70 6f 69 a chosen poi
0c20: 6e 74 20 69 6e 20 74 69 6d 65 20 61 6e 64 20 73 nt in time and s
0c30: 70 61 63 65 2e 0a 20 20 20 20 20 2b 20 20 44 6f pace.. + Do
0c40: 20 66 75 6c 6c 20 74 65 78 74 20 73 65 61 72 63 full text searc
0c50: 68 20 61 67 61 69 6e 73 74 20 74 68 65 20 74 65 h against the te
0c60: 78 74 20 69 6e 20 61 6e 79 20 73 69 6e 67 6c 65 xt in any single
0c70: 20 74 69 63 6b 65 74 20 6f 72 0a 20 20 20 20 20 ticket or.
0c80: 20 20 20 61 63 72 6f 73 73 20 74 68 65 20 63 75 across the cu
0c90: 72 72 65 6e 74 20 76 65 72 73 69 6f 6e 73 20 6f rrent versions o
0ca0: 66 20 61 6c 6c 20 74 69 63 6b 65 74 73 2c 20 6f f all tickets, o
0cb0: 72 20 61 63 72 6f 73 73 20 61 6c 6c 20 63 75 72 r across all cur
0cc0: 72 65 6e 74 0a 20 20 20 20 20 20 20 20 61 6e 64 rent. and
0cd0: 20 68 69 73 74 6f 72 69 63 61 6c 20 76 65 72 73 historical vers
0ce0: 69 6f 6e 73 20 6f 66 20 61 6c 6c 20 74 69 63 6b ions of all tick
0cf0: 65 74 73 2e 0a 0a 20 2a 20 20 57 69 6b 69 20 69 ets... * Wiki i
0d00: 6e 74 65 72 66 61 63 65 20 28 65 78 70 61 6e 64 nterface (expand
0d10: 20 74 68 69 73 20 62 75 6c 6c 65 74 29 0a 0a 20 this bullet)..
0d20: 20 20 20 20 2b 20 20 43 72 65 61 74 65 20 6e 65 + Create ne
0d30: 77 20 77 69 6b 69 20 70 61 67 65 73 0a 20 20 20 w wiki pages.
0d40: 20 20 2b 20 20 44 65 73 69 67 6e 61 74 65 20 61 + Designate a
0d50: 20 73 69 6e 67 6c 65 20 77 69 6b 69 20 70 61 67 single wiki pag
0d60: 65 20 61 73 20 74 68 65 20 68 6f 6d 65 20 70 61 e as the home pa
0d70: 67 65 20 66 6f 72 20 74 68 65 20 77 77 77 20 69 ge for the www i
0d80: 6e 74 65 72 66 61 63 65 0a 20 20 20 20 20 2b 20 nterface. +
0d90: 20 44 65 73 69 67 6e 61 74 65 20 77 69 6b 69 20 Designate wiki
0da0: 70 61 67 65 73 20 61 73 20 72 65 61 64 2d 6f 6e pages as read-on
0db0: 6c 79 2c 20 61 70 70 65 6e 64 2d 6f 6e 6c 79 2c ly, append-only,
0dc0: 20 6f 72 20 72 65 61 64 2f 77 72 69 74 65 2e 0a or read/write..
0dd0: 20 20 20 20 20 2b 20 20 41 70 70 65 6e 64 20 63 + Append c
0de0: 6f 6d 6d 65 6e 74 73 20 74 6f 20 61 20 77 69 6b omments to a wik
0df0: 69 20 70 61 67 65 0a 20 20 20 20 20 2b 20 20 41 i page. + A
0e00: 64 64 20 61 74 74 61 63 68 6d 65 6e 74 73 20 28 dd attachments (
0e10: 73 75 63 68 20 61 73 20 47 49 46 20 69 6d 61 67 such as GIF imag
0e20: 65 73 29 20 74 6f 20 61 20 77 69 6b 69 20 70 61 es) to a wiki pa
0e30: 67 65 0a 20 20 20 20 20 2b 20 20 43 68 61 6e 67 ge. + Chang
0e40: 65 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 e the content of
0e50: 20 61 20 77 69 6b 69 20 70 61 67 65 0a 20 20 20 a wiki page.
0e60: 20 20 2b 20 20 44 65 6c 65 74 65 20 6f 62 73 6f + Delete obso
0e70: 6c 65 74 65 20 77 69 6b 69 20 70 61 67 65 73 2e lete wiki pages.
0e80: 20 20 28 4f 6c 64 20 63 6f 6e 74 65 6e 74 20 69 (Old content i
0e90: 73 20 73 74 69 6c 6c 20 61 63 63 65 73 73 69 62 s still accessib
0ea0: 6c 65 2c 0a 20 20 20 20 20 20 20 20 74 68 65 20 le,. the
0eb0: 70 61 67 65 20 69 73 20 6a 75 73 74 20 6e 6f 74 page is just not
0ec0: 20 6f 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 on the current
0ed0: 6c 69 73 74 20 6f 66 20 70 61 67 65 73 2e 29 0a list of pages.).
0ee0: 20 20 20 20 20 2b 20 20 50 65 72 6d 61 6e 65 6e + Permanen
0ef0: 74 6c 79 20 72 65 6d 6f 76 65 20 6d 61 6c 69 63 tly remove malic
0f00: 69 6f 75 73 20 65 64 69 74 73 20 61 6e 64 2f 6f ious edits and/o
0f10: 72 20 61 74 74 61 63 68 6d 65 6e 74 73 0a 20 20 r attachments.
0f20: 20 20 20 20 20 20 73 75 63 68 20 61 73 20 77 69 such as wi
0f30: 6b 69 2d 73 70 61 6d 20 6f 72 20 77 61 72 65 7a ki-spam or warez
0f40: 2e 20 20 28 4f 6c 64 20 63 6f 6e 74 65 6e 74 20 . (Old content
0f50: 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 61 63 63 is no longer acc
0f60: 65 73 73 69 62 6c 65 2e 29 0a 20 20 20 20 20 2b essible.). +
0f70: 20 20 41 64 64 20 6e 6f 66 6f 6c 6c 6f 77 20 6f Add nofollow o
0f80: 6e 20 65 78 74 65 72 6e 61 6c 20 6c 69 6e 6b 73 n external links
0f90: 20 61 64 64 65 64 20 62 79 20 75 6e 70 72 69 76 added by unpriv
0fa0: 69 6c 65 67 65 64 0a 20 20 20 20 20 20 20 20 75 ileged. u
0fb0: 73 65 72 73 20 77 68 65 6e 20 74 68 65 20 6c 69 sers when the li
0fc0: 6e 6b 20 69 73 20 6c 65 73 73 20 74 68 61 6e 20 nk is less than
0fd0: 4e 20 68 6f 75 72 73 20 6f 6c 64 2e 0a 20 20 20 N hours old..
0fe0: 20 20 2b 20 20 53 68 6f 77 20 74 68 65 20 63 6f + Show the co
0ff0: 6d 70 6c 65 74 65 20 68 69 73 74 6f 72 79 20 6f mplete history o
1000: 66 20 61 20 73 69 6e 67 6c 65 20 77 69 6b 69 20 f a single wiki
1010: 70 61 67 65 0a 20 20 20 20 20 2b 20 20 50 72 6f page. + Pro
1020: 76 69 64 65 20 74 68 65 20 61 62 69 6c 69 74 79 vide the ability
1030: 20 74 6f 20 64 69 66 66 20 74 77 6f 20 76 65 72 to diff two ver
1040: 73 69 6f 6e 73 20 6f 66 20 61 20 77 69 6b 69 20 sions of a wiki
1050: 70 61 67 65 0a 20 20 20 20 20 2b 20 20 53 68 6f page. + Sho
1060: 77 20 61 20 6c 69 73 74 69 6e 67 20 6f 66 20 61 w a listing of a
1070: 6c 6c 20 77 69 6b 69 20 70 61 67 65 73 2c 20 62 ll wiki pages, b
1080: 6f 74 68 20 63 75 72 72 65 6e 74 20 61 6e 64 20 oth current and
1090: 64 65 6c 65 74 65 64 0a 20 20 20 20 20 2b 20 20 deleted. +
10a0: 44 6f 20 61 20 66 75 6c 6c 2d 74 65 78 74 20 73 Do a full-text s
10b0: 65 61 72 63 68 20 61 67 61 69 6e 73 74 20 63 75 earch against cu
10c0: 72 72 65 6e 74 20 76 65 72 73 69 6f 6e 73 20 6f rrent versions o
10d0: 66 20 61 6c 6c 20 77 69 6b 69 20 70 61 67 65 73 f all wiki pages
10e0: 0a 20 20 20 20 20 2b 20 20 44 6f 20 61 20 66 75 . + Do a fu
10f0: 6c 6c 2d 74 65 78 74 20 73 65 61 72 63 68 20 61 ll-text search a
1100: 67 61 69 6e 73 74 20 61 6c 6c 20 68 69 73 74 6f gainst all histo
1110: 72 69 63 61 6c 20 76 65 72 73 69 6f 6e 73 20 6f rical versions o
1120: 66 20 61 20 73 69 6e 67 6c 65 0a 20 20 20 20 20 f a single.
1130: 20 20 20 77 69 6b 69 20 70 61 67 65 0a 20 20 20 wiki page.
1140: 20 20 2b 20 20 44 6f 20 61 20 66 75 6c 6c 2d 74 + Do a full-t
1150: 65 78 74 20 73 65 61 72 63 68 20 61 67 61 69 6e ext search again
1160: 73 74 20 61 6c 6c 20 68 69 73 74 6f 72 69 63 61 st all historica
1170: 6c 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 61 6c l versions of al
1180: 6c 0a 20 20 20 20 20 20 20 20 77 69 6b 69 20 70 l. wiki p
1190: 61 67 65 73 0a 0a 20 2a 20 20 46 75 6c 6c 2d 74 ages.. * Full-t
11a0: 65 78 74 20 73 65 61 72 63 68 20 61 67 61 69 6e ext search again
11b0: 73 74 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d 6d st check-in comm
11c0: 65 6e 74 73 20 61 6e 64 20 64 69 66 66 73 20 6f ents and diffs o
11d0: 66 20 65 61 63 68 0a 20 20 20 20 63 68 65 63 6b f each. check
11e0: 2d 69 6e 2e 0a 0a 20 2a 20 20 41 62 69 6c 69 74 -in... * Abilit
11f0: 79 20 74 6f 20 63 68 65 63 6b 2d 69 6e 20 73 6f y to check-in so
1200: 6d 65 20 73 75 62 73 65 74 20 6f 66 20 63 68 61 me subset of cha
1210: 6e 67 65 73 20 74 6f 20 74 68 65 20 74 72 65 65 nges to the tree
1220: 20 69 6e 73 74 65 61 64 0a 20 20 20 20 6f 66 20 instead. of
1230: 68 61 76 69 6e 67 20 74 6f 20 63 68 65 63 6b 20 having to check
1240: 69 6e 20 61 6c 6c 20 63 68 61 6e 67 65 73 2e 0a in all changes..
1250: 0a 20 2a 20 20 41 64 64 20 61 20 22 72 65 76 65 . * Add a "reve
1260: 72 74 22 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 rt" command that
1270: 20 77 69 6c 6c 20 75 6e 64 6f 20 61 6c 6c 20 63 will undo all c
1280: 68 61 6e 67 65 73 20 74 6f 20 61 20 66 69 6c 65 hanges to a file
1290: 0a 20 20 20 20 6f 72 20 66 69 6c 65 73 20 69 6e . or files in
12a0: 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 68 65 the current che
12b0: 63 6b 2d 6f 75 74 20 2d 20 72 65 73 74 6f 72 69 ck-out - restori
12c0: 6e 67 20 74 68 65 20 66 69 6c 65 73 20 62 61 63 ng the files bac
12d0: 6b 0a 20 20 20 20 74 6f 20 74 68 65 69 72 20 6f k. to their o
12e0: 72 69 67 69 6e 61 6c 20 63 68 65 63 6b 2d 6f 75 riginal check-ou
12f0: 74 20 73 74 61 74 65 2e 0a 0a 20 2a 20 20 41 64 t state... * Ad
1300: 64 20 61 6e 20 22 61 6e 6e 6f 74 61 74 65 22 20 d an "annotate"
1310: 63 6f 6d 6d 61 6e 64 20 69 6e 20 62 6f 74 68 20 command in both
1320: 74 68 65 20 63 6c 69 20 61 6e 64 20 74 68 65 20 the cli and the
1330: 77 77 77 20 69 6e 74 65 72 66 61 63 65 0a 20 20 www interface.
1340: 20 20 74 68 61 74 20 77 69 6c 6c 20 73 68 6f 77 that will show
1350: 20 6c 69 6e 65 2d 62 79 2d 6c 69 6e 65 20 74 68 line-by-line th
1360: 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 63 68 e most recent ch
1370: 61 6e 67 65 73 20 74 6f 20 65 76 65 72 79 20 6c anges to every l
1380: 69 6e 65 0a 20 20 20 20 69 6e 20 74 68 65 20 66 ine. in the f
1390: 69 6c 65 2e 0a 0a 20 2a 20 20 42 72 6f 77 73 65 ile... * Browse
13a0: 20 74 68 65 20 66 69 6c 65 20 68 69 65 72 61 72 the file hierar
13b0: 63 68 79 2c 20 73 69 6d 69 6c 61 72 20 74 6f 20 chy, similar to
13c0: 74 68 65 20 22 42 72 6f 77 73 65 22 20 66 65 61 the "Browse" fea
13d0: 74 75 72 65 20 69 6e 0a 20 20 20 20 43 56 53 54 ture in. CVST
13e0: 72 61 63 2e 0a 0a 20 2a 20 20 41 64 64 20 74 68 rac... * Add th
13f0: 65 20 61 62 69 6c 69 74 79 20 74 6f 20 6f 76 65 e ability to ove
1400: 72 72 69 64 65 20 63 68 65 63 6b 2d 69 6e 20 63 rride check-in c
1410: 6f 6d 6d 65 6e 74 73 2e 20 20 49 74 20 69 73 20 omments. It is
1420: 6e 6f 74 20 70 6f 73 73 69 62 6c 65 0a 20 20 20 not possible.
1430: 20 74 6f 20 63 68 61 6e 67 65 20 74 68 65 20 63 to change the c
1440: 6f 6d 6d 65 6e 74 20 69 6e 20 74 68 65 20 63 68 omment in the ch
1450: 65 63 6b 2d 69 6e 20 69 74 73 65 6c 66 20 64 75 eck-in itself du
1460: 65 20 74 6f 20 74 68 65 20 63 72 79 70 74 6f 67 e to the cryptog
1470: 72 61 70 68 69 63 0a 20 20 20 20 68 61 73 68 2e raphic. hash.
1480: 20 20 42 75 74 20 79 6f 75 20 63 61 6e 20 61 64 But you can ad
1490: 64 20 61 20 6e 65 77 20 72 65 63 6f 72 64 20 74 d a new record t
14a0: 6f 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 o the repository
14b0: 20 74 68 61 74 20 6f 76 65 72 6c 6f 61 64 73 0a that overloads.
14c0: 20 20 20 20 61 20 63 68 65 63 6b 2d 69 6e 20 63 a check-in c
14d0: 6f 6d 6d 65 6e 74 20 77 69 74 68 20 61 20 6e 65 omment with a ne
14e0: 77 20 63 6f 6d 6d 65 6e 74 2e 20 20 43 6f 6d 6d w comment. Comm
14f0: 65 6e 74 20 63 68 61 6e 67 65 73 20 73 68 6f 75 ent changes shou
1500: 6c 64 20 62 65 0a 20 20 20 20 47 50 47 20 63 6c ld be. GPG cl
1510: 65 61 72 73 69 67 6e 65 64 20 61 74 20 74 68 65 earsigned at the
1520: 20 76 65 72 79 20 6c 65 61 73 74 2e 20 20 43 6f very least. Co
1530: 6d 6d 65 6e 74 20 63 68 61 6e 67 65 73 20 6f 6e mment changes on
1540: 6c 79 20 61 70 70 6c 79 20 69 66 0a 20 20 20 20 ly apply if.
1550: 74 68 65 20 75 73 65 72 20 77 68 6f 20 6d 61 64 the user who mad
1560: 65 20 74 68 65 20 63 68 61 6e 67 65 20 68 61 73 e the change has
1570: 20 74 68 65 20 72 69 67 68 74 20 70 65 72 6d 69 the right permi
1580: 73 73 69 6f 6e 73 2e 0a 0a 20 2a 20 20 4e 65 77 ssions... * New
1590: 20 63 6c 69 20 63 6f 6d 6d 61 6e 64 73 3a 20 22 cli commands: "
15a0: 64 65 63 6f 6e 73 74 72 75 63 74 22 20 61 6e 64 deconstruct" and
15b0: 20 22 72 65 63 6f 6e 73 74 72 75 63 74 22 2e 20 "reconstruct".
15c0: 20 54 68 65 20 64 65 63 6f 6e 73 74 72 75 63 74 The deconstruct
15d0: 0a 20 20 20 20 63 6f 6d 6d 61 6e 64 20 70 6f 70 . command pop
15e0: 75 6c 61 74 65 73 20 61 6e 20 69 6e 64 69 63 61 ulates an indica
15f0: 74 65 64 20 64 69 72 65 63 74 6f 72 79 20 77 69 ted directory wi
1600: 74 68 20 63 6f 70 69 65 73 20 6f 66 20 61 6c 6c th copies of all
1610: 20 66 69 6c 65 73 0a 20 20 20 20 63 6f 6e 74 61 files. conta
1620: 69 6e 65 64 20 77 69 74 68 69 6e 20 74 68 65 20 ined within the
1630: 72 65 70 6f 73 69 74 6f 72 79 2e 20 20 46 69 6c repository. Fil
1640: 65 73 20 61 72 65 20 6e 61 6d 65 64 20 61 61 61 es are named aaa
1650: 2f 62 62 62 62 62 62 62 20 77 68 65 72 65 0a 20 /bbbbbbb where.
1660: 20 20 20 61 61 61 20 69 73 20 74 68 65 20 66 69 aaa is the fi
1670: 72 73 74 20 33 20 63 68 61 72 61 63 74 65 72 73 rst 3 characters
1680: 20 6f 66 20 74 68 65 20 75 75 69 64 20 61 6e 64 of the uuid and
1690: 20 62 62 62 62 62 62 20 69 73 20 74 68 65 0a 20 bbbbbb is the.
16a0: 20 20 20 72 65 6d 61 69 6e 69 6e 67 20 33 37 20 remaining 37
16b0: 63 68 61 72 61 63 74 65 72 73 2e 20 20 72 65 63 characters. rec
16c0: 6f 6e 73 74 72 75 63 74 20 62 75 69 6c 64 73 20 onstruct builds
16d0: 61 20 6e 65 77 20 72 65 70 6f 73 69 74 6f 72 79 a new repository
16e0: 0a 20 20 20 20 63 6f 6e 74 61 69 6e 69 6e 67 20 . containing
16f0: 61 6c 6c 20 66 69 6c 65 73 20 69 6e 20 61 6e 20 all files in an
1700: 69 6e 64 69 63 61 74 65 64 20 64 69 72 65 63 74 indicated direct
1710: 6f 72 79 2e 20 20 57 68 65 6e 20 72 65 63 6f 6e ory. When recon
1720: 73 74 72 75 63 74 69 6e 67 2c 0a 20 20 20 20 73 structing,. s
1730: 6f 6d 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 ome information
1740: 69 73 20 6c 6f 73 74 3a 20 70 72 6f 6a 65 63 74 is lost: project
1750: 2d 63 6f 64 65 2c 20 73 65 72 76 65 72 2d 63 6f -code, server-co
1760: 64 65 2c 20 75 73 65 72 73 2e 20 20 0a 20 20 20 de, users. .
1770: 20 4a 75 73 74 20 6d 61 6b 65 20 75 70 20 61 20 Just make up a
1780: 6e 65 77 20 70 72 6f 6a 65 63 74 2d 63 6f 64 65 new project-code
1790: 2e 20 20 0a 0a 20 2a 20 20 47 65 74 20 61 20 62 . .. * Get a b
17a0: 75 69 6c 64 20 77 6f 72 6b 69 6e 67 20 66 6f 72 uild working for
17b0: 20 77 69 6e 33 32 2e 20 20 50 65 72 68 61 70 73 win32. Perhaps
17c0: 20 75 73 65 20 63 79 67 77 69 6e 2e 20 20 4f 72 use cygwin. Or
17d0: 20 6f 6d 69 74 0a 20 20 20 20 74 68 65 20 73 65 omit. the se
17e0: 72 76 65 72 20 63 6f 6d 70 6f 6e 65 6e 74 20 66 rver component f
17f0: 72 6f 6d 20 77 69 6e 33 32 20 28 74 6f 20 65 6c rom win32 (to el
1800: 69 6d 69 6e 61 74 65 20 74 68 65 20 6e 65 65 64 iminate the need
1810: 20 66 6f 72 20 66 6f 72 6b 28 29 29 2e 0a 0a 20 for fork())...
1820: 2a 20 20 4d 61 6b 65 20 74 68 65 20 69 6e 74 65 * Make the inte
1830: 72 66 61 63 65 20 74 6f 20 66 6f 73 73 69 6c 20 rface to fossil
1840: 6c 6f 6f 6b 20 70 72 65 74 74 79 20 61 6e 64 20 look pretty and
1850: 62 65 20 63 75 73 74 6f 6d 69 7a 61 62 6c 65 20 be customizable
1860: 73 6f 0a 20 20 20 20 74 68 61 74 20 6f 74 68 65 so. that othe
1870: 72 20 70 65 6f 70 6c 65 20 77 69 6c 6c 20 62 65 r people will be
1880: 20 61 74 74 72 61 63 74 65 64 20 74 6f 20 69 74 attracted to it
1890: 2c 20 77 69 6c 6c 20 74 61 6b 65 20 6f 76 65 72 , will take over
18a0: 20 6d 61 69 6e 74 65 6e 61 6e 63 65 0a 20 20 20 maintenance.
18b0: 20 6f 66 20 69 74 2c 20 61 6e 64 20 77 65 20 63 of it, and we c
18c0: 61 6e 20 65 76 65 6e 74 75 61 6c 6c 79 20 6d 6f an eventually mo
18d0: 76 65 20 6f 6e 20 74 6f 20 6f 74 68 65 72 20 74 ve on to other t
18e0: 68 69 6e 67 73 2e 0a hings..