Artifact
4ab62457233702c36f52cfd2ea5330ca79e98b0c:
Wiki page
[Fossil 2.0] by
andygoth
2015-02-24 22:12:21.
0000: 44 20 32 30 31 35 2d 30 32 2d 32 34 54 32 32 3a D 2015-02-24T22:
0010: 31 32 3a 32 31 2e 30 30 38 0a 4c 20 46 6f 73 73 12:21.008.L Foss
0020: 69 6c 5c 73 32 2e 30 0a 4e 20 74 65 78 74 2f 78 il\s2.0.N text/x
0030: 2d 6d 61 72 6b 64 6f 77 6e 0a 50 20 66 34 30 37 -markdown.P f407
0040: 61 39 65 32 34 31 33 34 66 64 65 31 63 38 64 37 a9e24134fde1c8d7
0050: 30 61 30 62 64 65 38 38 35 36 37 62 31 64 36 66 0a0bde88567b1d6f
0060: 33 35 62 65 0a 55 20 61 6e 64 79 67 6f 74 68 0a 35be.U andygoth.
0070: 57 20 32 35 39 35 0a 23 23 20 53 74 61 74 75 73 W 2595.## Status
0080: 3a 0d 0a 0d 0a 20 20 2a 20 20 46 6f 73 73 69 6c :.... * Fossil
0090: 20 32 2e 30 20 69 73 20 63 75 72 72 65 6e 74 6c 2.0 is currentl
00a0: 79 20 6a 75 73 74 20 61 6e 20 69 64 65 61 2e 20 y just an idea.
00b0: 20 4e 6f 20 63 6f 64 65 20 68 61 73 20 62 65 65 No code has bee
00c0: 6e 20 77 72 69 74 74 65 6e 2e 0d 0a 0d 0a 23 23 n written.....##
00d0: 20 43 6f 72 65 20 50 72 69 6e 63 69 70 6c 65 73 Core Principles
00e0: 3a 0d 0a 0d 0a 20 20 2a 20 20 31 30 30 25 20 72 :.... * 100% r
00f0: 65 70 6f 73 69 74 6f 72 79 20 63 6f 6d 70 61 74 epository compat
0100: 69 62 6c 65 2e 20 52 65 75 73 65 20 65 78 69 73 ible. Reuse exis
0110: 74 69 6e 67 20 72 65 70 6f 73 20 28 70 65 72 68 ting repos (perh
0120: 61 70 73 20 77 69 74 68 20 22 72 65 62 75 69 6c aps with "rebuil
0130: 64 22 29 0d 0a 0d 0a 20 20 2a 20 20 31 30 30 25 d").... * 100%
0140: 20 73 79 6e 63 20 63 6f 6d 70 61 74 69 62 6c 65 sync compatible
0150: 2e 20 20 50 75 73 68 2c 20 70 75 6c 6c 2c 20 61 . Push, pull, a
0160: 6e 64 20 63 6c 6f 6e 65 20 77 69 74 68 20 76 65 nd clone with ve
0170: 72 73 69 6f 6e 20 31 2e 78 20 72 65 70 6f 73 2e rsion 1.x repos.
0180: 0d 0a 0d 0a 23 23 20 57 65 62 20 49 6e 74 65 72 ....## Web Inter
0190: 66 61 63 65 20 45 6e 68 61 6e 63 65 6d 65 6e 74 face Enhancement
01a0: 73 3a 0d 0a 0d 0a 20 20 2a 20 20 52 65 66 61 63 s:.... * Refac
01b0: 74 6f 72 20 74 6f 20 61 20 73 6d 61 6c 6c 2c 20 tor to a small,
01c0: 73 65 6e 73 69 62 6c 65 2c 20 77 65 6c 6c 2d 64 sensible, well-d
01d0: 65 66 69 6e 65 64 20 61 6e 64 20 77 65 6c 6c 2d efined and well-
01e0: 64 6f 63 75 6d 65 6e 74 20 73 65 74 20 6f 66 0d document set of.
01f0: 0a 20 20 20 20 20 43 53 53 20 63 6c 61 73 73 65 . CSS classe
0200: 73 20 74 68 61 74 20 61 72 65 20 65 61 73 79 20 s that are easy
0210: 74 6f 20 63 6f 6e 66 69 67 75 72 65 2e 0d 0a 0d to configure....
0220: 0a 20 20 2a 20 20 4f 4b 20 74 6f 20 62 72 65 61 . * OK to brea
0230: 6b 20 65 78 69 73 74 69 6e 67 20 73 6b 69 6e 73 k existing skins
0240: 2e 0d 0a 0d 0a 20 20 2a 20 20 50 75 73 68 20 74 ..... * Push t
0250: 6f 77 61 72 64 20 62 65 69 6e 67 20 63 6c 6f 73 oward being clos
0260: 65 72 20 74 6f 20 52 45 53 54 66 75 6c 0d 0a 0d er to RESTful...
0270: 0a 20 20 2a 20 20 53 74 72 69 76 65 20 66 6f 72 . * Strive for
0280: 20 62 61 73 69 63 20 6f 70 65 72 61 74 69 6f 6e basic operation
0290: 20 77 2f 6f 20 6a 61 76 61 73 63 72 69 70 74 2c w/o javascript,
02a0: 20 74 68 6f 75 67 68 20 63 6c 65 61 72 6c 79 20 though clearly
02b0: 6a 61 76 61 73 63 72 69 70 74 0d 0a 20 20 20 20 javascript..
02c0: 20 69 73 20 61 6c 6c 6f 77 65 64 20 77 68 65 6e is allowed when
02d0: 20 6e 65 63 65 73 73 61 72 79 2e 20 20 28 4a 61 necessary. (Ja
02e0: 76 61 73 63 72 69 70 74 20 64 72 61 77 73 20 74 vascript draws t
02f0: 68 65 20 74 69 6d 65 6c 69 6e 65 20 67 72 61 70 he timeline grap
0300: 68 20 66 6f 72 0d 0a 20 20 20 20 20 65 78 61 6d h for.. exam
0310: 70 6c 65 2e 29 20 20 54 68 69 73 20 70 72 69 6e ple.) This prin
0320: 63 69 70 6c 65 20 64 6f 65 73 20 6e 6f 74 20 63 ciple does not c
0330: 68 61 6e 67 65 20 66 72 6f 6d 20 31 2e 78 2e 0d hange from 1.x..
0340: 0a 0d 0a 23 23 20 43 6f 6d 6d 61 6e 64 2d 6c 69 ...## Command-li
0350: 6e 65 20 49 6e 74 65 72 66 61 63 65 3a 0d 0a 0d ne Interface:...
0360: 0a 20 20 2a 20 20 22 66 6f 73 73 69 6c 20 6d 76 . * "fossil mv
0370: 22 20 61 6e 64 20 22 66 6f 73 73 69 6c 20 72 6d " and "fossil rm
0380: 22 20 61 63 74 75 61 6c 6c 79 20 72 65 6e 61 6d " actually renam
0390: 65 20 61 6e 64 20 64 65 6c 65 74 65 20 74 68 65 e and delete the
03a0: 20 75 6e 64 65 72 6c 79 69 6e 67 0d 0a 20 20 20 underlying..
03b0: 20 20 66 69 6c 65 73 2e 0d 0a 0d 0a 23 23 20 49 files.....## I
03c0: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 53 74 mplementation St
03d0: 72 61 74 65 67 79 3a 0d 0a 0d 0a 20 20 2a 20 20 rategy:.... *
03e0: 4d 61 6b 65 20 63 68 61 6e 67 65 73 20 69 6e 20 Make changes in
03f0: 61 20 6c 6f 6e 67 2d 72 75 6e 6e 69 6e 67 20 62 a long-running b
0400: 72 61 6e 63 68 20 28 6e 61 6d 65 64 20 22 66 6f ranch (named "fo
0410: 73 73 69 6c 2d 32 2e 30 22 3f 29 20 75 6e 74 69 ssil-2.0"?) unti
0420: 6c 0d 0a 20 20 20 20 20 72 65 61 64 79 20 74 6f l.. ready to
0430: 20 63 75 74 2d 6f 76 65 72 2c 20 74 68 65 6e 20 cut-over, then
0440: 6d 65 72 67 65 20 69 6e 74 6f 20 74 72 75 6e 6b merge into trunk
0450: 2e 0d 0a 0d 0a 20 20 2a 20 20 4b 65 65 70 20 74 ..... * Keep t
0460: 77 6f 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 46 wo versions of F
0470: 6f 73 73 69 6c 20 28 31 2e 78 20 61 6e 64 20 32 ossil (1.x and 2
0480: 2e 30 2d 61 6c 70 68 61 29 20 62 6f 74 68 20 72 .0-alpha) both r
0490: 75 6e 6e 69 6e 67 20 6f 6e 0d 0a 20 20 20 20 20 unning on..
04a0: 3c 68 74 74 70 73 3a 2f 2f 77 77 77 2e 66 6f 73 <https://www.fos
04b0: 73 69 6c 2d 73 63 6d 2e 6f 72 67 2f 3e 20 73 6f sil-scm.org/> so
04c0: 20 74 68 61 74 20 70 65 6f 70 6c 65 20 63 61 6e that people can
04d0: 20 63 6f 6d 70 61 72 65 20 74 68 65 20 63 68 61 compare the cha
04e0: 6e 67 65 73 0d 0a 20 20 20 20 20 74 6f 20 74 68 nges.. to th
04f0: 65 20 77 65 62 2d 69 6e 74 65 72 66 61 63 65 20 e web-interface
0500: 65 61 73 69 6c 79 2e 0d 0a 0d 0a 20 20 2a 20 20 easily..... *
0510: 50 72 6f 76 69 64 65 20 61 20 70 6c 61 63 65 20 Provide a place
0520: 74 6f 20 64 6f 77 6e 6c 6f 61 64 20 70 72 65 2d to download pre-
0530: 63 6f 6d 70 69 6c 65 64 20 62 69 6e 61 72 69 65 compiled binarie
0540: 73 20 6f 66 20 32 2e 30 2d 61 6c 70 68 61 2e 0d s of 2.0-alpha..
0550: 0a 0d 0a 0d 0a 2d 2d 2d 2d 2d 2d 0d 0a 2a 4f 6e .....------..*On
0560: 20 32 30 31 35 2d 30 32 2d 30 36 20 30 32 3a 31 2015-02-06 02:1
0570: 30 3a 33 35 20 55 54 43 20 6e 6f 62 6f 64 79 20 0:35 UTC nobody
0580: 28 63 6c 61 69 6d 69 6e 67 20 74 6f 20 62 65 20 (claiming to be
0590: 73 65 61 6e 29 20 61 64 64 65 64 3a 2a 0d 0a 0d sean) added:*...
05a0: 0a 2a 20 50 6f 73 73 69 62 69 6c 69 74 79 20 6f .* Possibility o
05b0: 66 20 75 73 69 6e 67 20 61 20 64 69 66 66 65 72 f using a differ
05c0: 65 6e 74 20 68 61 73 68 2c 20 73 75 63 68 20 61 ent hash, such a
05d0: 73 20 73 68 61 33 38 34 20 6f 72 20 73 68 61 35 s sha384 or sha5
05e0: 31 32 2e 20 4a 75 73 74 20 62 65 63 61 75 73 65 12. Just because
05f0: 20 73 68 61 31 20 69 73 20 66 69 6e 65 20 64 6f sha1 is fine do
0600: 65 73 6e 27 74 20 6d 65 61 6e 20 69 74 20 77 69 esn't mean it wi
0610: 6c 6c 20 61 6c 77 61 79 73 20 62 65 20 66 69 6e ll always be fin
0620: 65 2e 20 20 3c 69 3e 2d 2d 20 64 72 68 20 72 65 e. <i>-- drh re
0630: 70 6c 69 65 73 3a 0d 0a 55 6e 61 62 6c 65 2e 20 plies:..Unable.
0640: 54 68 69 73 20 77 6f 75 6c 64 20 62 65 20 61 6e This would be an
0650: 20 69 6e 63 6f 6d 70 61 74 69 62 6c 65 20 66 69 incompatible fi
0660: 6c 65 20 66 6f 72 6d 61 74 20 63 68 61 6e 67 65 le format change
0670: 2e 3c 2f 69 3e 0d 0a 2a 20 6f 6e 6c 69 6e 65 20 .</i>..* online
0680: 66 69 6c 65 20 65 64 69 74 69 6e 67 0d 0a 2a 20 file editing..*
0690: 61 6c 70 68 61 62 65 74 69 7a 61 74 69 6f 6e 20 alphabetization
06a0: 6f 66 20 6c 69 73 74 73 0d 0a 2a 20 73 6f 6d 65 of lists..* some
06b0: 20 73 74 79 6c 65 20 6f 66 20 70 61 73 74 65 62 style of pasteb
06c0: 69 6e 20 77 69 74 68 20 73 79 6e 74 61 78 20 68 in with syntax h
06d0: 69 67 68 6c 69 67 68 74 69 6e 67 2c 20 73 69 6d ighlighting, sim
06e0: 69 6c 61 72 20 74 6f 20 74 65 63 68 20 6e 6f 74 ilar to tech not
06f0: 65 73 20 6f 72 20 77 69 6b 69 0d 0a 2a 20 6c 69 es or wiki..* li
0700: 62 72 65 73 73 6c 20 73 75 70 70 6f 72 74 0d 0a bressl support..
0710: 0d 0a 0d 0a 2d 2d 2d 2d 2d 2d 0d 0a 2a 4f 6e 20 ....------..*On
0720: 32 30 31 35 2d 30 32 2d 30 36 20 30 32 3a 33 31 2015-02-06 02:31
0730: 3a 35 39 20 55 54 43 20 6e 6f 62 6f 64 79 20 28 :59 UTC nobody (
0740: 63 6c 61 69 6d 69 6e 67 20 74 6f 20 62 65 20 69 claiming to be i
0750: 73 78 65 6b 29 20 61 64 64 65 64 3a 2a 0d 0a 0d sxek) added:*...
0760: 0a 2a 20 41 6c 6c 6f 77 20 6d 61 72 6b 64 6f 77 .* Allow markdow
0770: 6e 20 75 73 65 20 77 68 65 6e 20 77 72 69 74 69 n use when writi
0780: 6e 67 20 74 69 63 6b 65 74 73 20 26 20 74 69 63 ng tickets & tic
0790: 6b 65 74 20 63 6f 6d 6d 65 6e 74 73 20 3c 69 3e ket comments <i>
07a0: 2d 2d 20 64 72 68 20 72 65 70 6c 69 65 73 3a 0d -- drh replies:.
07b0: 0a 44 6f 65 73 6e 27 74 20 74 68 69 73 20 61 6c .Doesn't this al
07c0: 72 65 61 64 79 20 77 6f 72 6b 20 69 6e 20 46 6f ready work in Fo
07d0: 73 73 69 6c 20 31 2e 33 30 3f 3c 2f 69 3e 0d 0a ssil 1.30?</i>..
07e0: 3c 62 72 20 2f 3e 3c 65 6d 3e 2d 2d 20 69 73 78 <br /><em>-- isx
07f0: 65 6b 20 72 65 70 6c 69 65 73 3a 20 49 74 20 64 ek replies: It d
0800: 6f 65 73 20 6e 6f 74 2e 20 49 27 6d 20 75 73 69 oes not. I'm usi
0810: 6e 67 20 46 6f 73 73 69 6c 20 76 65 72 73 69 6f ng Fossil versio
0820: 6e 20 5b 35 32 36 30 66 62 66 36 33 32 5d 20 32 n [5260fbf632] 2
0830: 30 31 35 2d 30 32 2d 30 35 2e 3c 2f 65 6d 3e 0d 015-02-05.</em>.
0840: 0a 0d 0a 0d 0a 2d 2d 2d 2d 2d 2d 0d 0a 2a 4f 6e .....------..*On
0850: 20 32 30 31 35 2d 30 32 2d 32 34 20 32 32 3a 31 2015-02-24 22:1
0860: 32 3a 30 30 20 55 54 43 20 61 6e 64 79 67 6f 74 2:00 UTC andygot
0870: 68 20 61 64 64 65 64 3a 2a 0d 0a 0d 0a 23 20 53 h added:*....# S
0880: 68 6f 77 20 63 68 65 72 72 79 70 69 63 6b 20 61 how cherrypick a
0890: 6e 64 20 62 61 63 6b 6f 75 74 20 6d 65 72 67 65 nd backout merge
08a0: 73 20 69 6e 20 74 69 6d 65 6c 69 6e 65 20 61 6e s in timeline an
08b0: 64 20 63 6f 6e 74 65 78 74 2e 0d 0a 0d 0a 44 69 d context.....Di
08c0: 66 66 65 72 65 6e 74 69 61 74 65 20 62 65 74 77 fferentiate betw
08d0: 65 65 6e 20 6e 6f 72 6d 61 6c 2c 20 63 68 65 72 een normal, cher
08e0: 72 79 70 69 63 6b 2c 20 61 6e 64 20 62 61 63 6b rypick, and back
08f0: 6f 75 74 20 6d 65 72 67 65 73 20 62 79 20 74 68 out merges by th
0900: 65 20 73 68 61 70 65 20 6f 66 20 74 68 65 20 61 e shape of the a
0910: 72 72 6f 77 68 65 61 64 2e 0d 0a 0d 0a 2a 20 20 rrowhead.....*
0920: e2 96 b2 3a 20 4e 6f 72 6d 61 6c 20 6d 65 72 67 ▲: Normal merg
0930: 65 20 28 6f 72 20 e2 97 80 20 6f 72 20 e2 96 b6 e (or ◀ or ▶
0940: 20 61 73 20 61 70 70 72 6f 70 72 69 61 74 65 29 as appropriate)
0950: 0d 0a 2a 20 20 e2 ad 95 3a 20 43 68 65 72 72 79 ..* ⭕: Cherry
0960: 70 69 63 6b 20 6d 65 72 67 65 20 28 72 65 73 65 pick merge (rese
0970: 6d 62 6c 65 73 20 61 20 63 68 65 72 72 79 29 0d mbles a cherry).
0980: 0a 2a 20 20 e2 9d 8c 3a 20 42 61 63 6b 6f 75 74 .* ❌: Backout
0990: 20 6d 65 72 67 65 20 28 73 69 67 6e 69 66 69 65 merge (signifie
09a0: 73 20 72 65 6d 6f 76 61 6c 29 0d 0a 0d 0a 54 68 s removal)....Th
09b0: 65 20 6d 65 72 67 65 20 6c 69 6e 65 73 20 6d 61 e merge lines ma
09c0: 79 20 61 6c 73 6f 20 62 65 20 73 68 6f 77 6e 20 y also be shown
09d0: 69 6e 20 64 69 66 66 65 72 65 6e 74 20 63 6f 6c in different col
09e0: 6f 72 73 2c 20 65 2e 67 2e 20 67 72 65 65 6e 20 ors, e.g. green
09f0: 66 6f 72 20 63 68 65 72 72 79 70 69 63 6b 20 61 for cherrypick a
0a00: 6e 64 20 72 65 64 20 66 6f 72 20 62 61 63 6b 6f nd red for backo
0a10: 75 74 2e 0d 0a 0d 0a 53 75 67 67 65 73 74 20 61 ut.....Suggest a
0a20: 6c 6c 6f 77 69 6e 67 20 74 68 69 73 20 66 65 61 llowing this fea
0a30: 74 75 72 65 20 74 6f 20 62 65 20 63 6f 6e 66 69 ture to be confi
0a40: 67 75 72 61 62 6c 65 20 76 69 61 20 74 68 65 6d gurable via them
0a50: 65 2e 20 20 41 6c 73 6f 20 6d 61 79 20 62 65 20 e. Also may be
0a60: 61 20 75 73 65 72 20 63 68 65 63 6b 62 6f 78 20 a user checkbox
0a70: 74 6f 20 73 68 6f 77 20 6f 72 20 68 69 64 65 20 to show or hide
0a80: 63 68 65 72 72 79 70 69 63 6b 2f 62 61 63 6b 6f cherrypick/backo
0a90: 75 74 20 6d 65 72 67 65 73 2e 0a 5a 20 62 36 64 ut merges..Z b6d
0aa0: 66 65 38 34 35 66 39 31 35 37 38 63 64 36 39 36 fe845f91578cd696
0ab0: 63 31 30 61 30 33 35 63 31 62 66 39 34 0a c10a035c1bf94.