Artifact
8b55a3bfa37e1bbd00264b1471392c311f0523dfe2d241ed7c12e3ab5cd6794a:
Wiki page
[Fossil-NG] by
drh
2017-11-18 20:32:20.
0000: 44 20 32 30 31 37 2d 31 31 2d 31 38 54 32 30 3a D 2017-11-18T20:
0010: 33 32 3a 32 30 2e 38 37 32 0a 4c 20 46 6f 73 73 32:20.872.L Foss
0020: 69 6c 2d 4e 47 0a 4e 20 74 65 78 74 2f 78 2d 6d il-NG.N text/x-m
0030: 61 72 6b 64 6f 77 6e 0a 55 20 64 72 68 0a 57 20 arkdown.U drh.W
0040: 31 36 31 34 0a 23 23 20 4f 76 65 72 76 69 65 77 1614.## Overview
0050: 0d 0a 0d 0a 54 68 69 73 20 69 73 20 61 20 64 69 ....This is a di
0060: 73 63 75 73 73 69 6f 6e 20 66 6f 72 6d 61 74 20 scussion format
0070: 61 6e 64 20 72 65 63 6f 72 64 20 6f 66 20 69 64 and record of id
0080: 65 61 73 20 66 6f 72 20 74 68 65 0d 0a 22 46 6f eas for the.."Fo
0090: 73 73 69 6c 20 2d 20 4e 65 78 74 20 47 65 6e 65 ssil - Next Gene
00a0: 72 61 74 69 6f 6e 22 20 6f 72 20 46 6f 73 73 69 ration" or Fossi
00b0: 6c 2d 4e 47 2e 20 20 41 73 20 74 68 69 73 20 73 l-NG. As this s
00c0: 65 6e 74 65 6e 63 65 20 69 73 0d 0a 62 65 69 6e entence is..bein
00d0: 67 20 77 72 69 74 74 65 6e 20 28 32 30 31 37 2d g written (2017-
00e0: 31 31 2d 31 38 29 20 74 68 65 72 65 20 69 73 20 11-18) there is
00f0: 6e 6f 20 63 6f 64 65 20 69 6e 20 70 6c 61 63 65 no code in place
0100: 20 66 6f 72 20 46 6f 73 73 69 6c 2d 4e 47 2e 0d for Fossil-NG..
0110: 0a 0d 0a 23 23 20 47 6f 61 6c 73 0d 0a 0d 0a 54 ...## Goals....T
0120: 68 65 20 66 69 72 73 74 20 67 6f 61 6c 20 6f 66 he first goal of
0130: 20 46 6f 73 73 69 6c 2d 4e 47 20 69 73 20 74 6f Fossil-NG is to
0140: 20 65 6e 68 61 6e 63 65 20 61 6e 64 20 69 6d 70 enhance and imp
0150: 72 6f 76 65 20 74 68 65 20 46 6f 73 73 69 6c 20 rove the Fossil
0160: 75 73 65 72 0d 0a 65 78 70 65 72 69 65 6e 63 65 user..experience
0170: 20 62 61 73 65 64 20 6f 6e 20 6c 65 73 73 6f 6e based on lesson
0180: 73 20 6c 65 61 72 6e 65 64 20 66 72 6f 6d 20 31 s learned from 1
0190: 31 20 79 65 61 72 73 20 75 73 69 6e 67 20 61 6e 1 years using an
01a0: 64 20 6d 61 69 6e 74 61 69 6e 69 6e 67 0d 0a 6c d maintaining..l
01b0: 65 67 61 63 79 20 46 6f 73 73 69 6c 2e 20 20 4e egacy Fossil. N
01c0: 65 77 20 63 61 70 61 62 69 6c 69 74 69 65 73 20 ew capabilities
01d0: 69 6e 63 6c 75 64 65 3a 0d 0a 0d 0a 20 20 2b 20 include:.... +
01e0: 20 2a 2a 53 68 61 6c 6c 6f 77 20 43 6c 6f 6e 65 **Shallow Clone
01f0: 73 2a 2a 20 2d 20 74 68 65 20 61 62 69 6c 69 74 s** - the abilit
0200: 79 20 74 6f 20 63 6c 6f 6e 65 20 6a 75 73 74 20 y to clone just
0210: 74 68 65 20 72 65 63 65 6e 74 20 68 69 73 74 6f the recent histo
0220: 72 79 0d 0a 20 20 20 20 20 6f 66 20 61 20 70 72 ry.. of a pr
0230: 6f 6a 65 63 74 0d 0a 0d 0a 20 20 2b 20 20 2a 2a oject.... + **
0240: 4e 61 72 72 6f 77 20 43 6c 6f 6e 65 73 2a 2a 20 Narrow Clones**
0250: 2d 20 74 68 65 20 61 62 69 6c 69 74 79 20 74 6f - the ability to
0260: 20 63 6c 6f 6e 65 20 61 20 73 75 62 73 65 74 20 clone a subset
0270: 6f 66 20 61 20 70 72 6f 6a 65 63 74 2c 0d 0a 20 of a project,..
0280: 20 20 20 20 66 6f 72 20 65 78 61 6d 70 6c 65 20 for example
0290: 74 6f 20 63 6c 6f 6e 65 20 6f 6e 6c 79 20 74 68 to clone only th
02a0: 65 20 66 69 6c 65 73 20 69 6e 20 74 68 65 20 22 e files in the "
02b0: 73 72 63 2f 22 20 64 69 72 65 63 74 6f 72 79 20 src/" directory
02c0: 61 6e 64 0d 0a 20 20 20 20 20 6f 6d 69 74 20 61 and.. omit a
02d0: 6c 6c 20 6f 66 20 74 68 65 20 66 69 6c 65 73 20 ll of the files
02e0: 69 6e 20 74 68 65 20 22 74 65 73 74 2f 22 20 64 in the "test/" d
02f0: 69 72 65 63 74 6f 72 79 2e 0d 0a 0d 0a 20 20 2b irectory..... +
0300: 20 20 2a 2a 53 65 6c 65 63 74 69 76 65 20 53 79 **Selective Sy
0310: 6e 63 2a 2a 20 2d 20 74 68 65 20 61 62 69 6c 69 nc** - the abili
0320: 74 79 20 74 6f 20 70 75 73 68 2f 70 75 6c 6c 2f ty to push/pull/
0330: 73 79 6e 63 20 73 69 6e 63 65 20 62 72 61 6e 63 sync since branc
0340: 68 65 73 2e 0d 0a 0d 0a 49 6e 20 74 68 65 20 31 hes.....In the 1
0350: 31 20 79 65 61 72 73 20 73 69 6e 63 65 20 46 6f 1 years since Fo
0360: 73 73 69 6c 20 77 61 73 20 63 72 65 61 74 65 64 ssil was created
0370: 2c 20 47 69 74 20 68 61 73 20 62 65 63 6f 6d 65 , Git has become
0380: 20 74 68 65 20 64 6f 6d 69 6e 61 74 65 0d 0a 76 the dominate..v
0390: 65 72 73 69 6f 6e 20 63 6f 6e 74 72 6f 6c 20 73 ersion control s
03a0: 79 73 74 65 6d 2e 20 20 54 68 69 73 20 69 73 20 ystem. This is
03b0: 75 6e 66 6f 72 74 75 6e 61 74 65 2c 20 62 65 63 unfortunate, bec
03c0: 61 75 73 65 20 6f 66 20 74 68 65 20 76 61 72 69 ause of the vari
03d0: 6f 75 73 0d 0a 76 65 72 73 69 6f 6e 20 63 6f 6e ous..version con
03e0: 74 72 6f 6c 20 73 79 73 74 65 6d 73 20 61 76 61 trol systems ava
03f0: 69 6c 61 62 6c 65 20 74 6f 64 61 79 2c 20 47 69 ilable today, Gi
0400: 74 20 69 73 20 74 68 65 20 6c 65 61 73 74 20 75 t is the least u
0410: 73 65 72 2d 66 72 69 65 6e 64 6c 79 2e 0d 0a 4e ser-friendly...N
0420: 65 76 65 72 74 68 65 6c 65 73 73 2c 20 74 68 65 evertheless, the
0430: 72 65 20 69 73 20 6e 6f 20 64 65 6e 79 69 6e 67 re is no denying
0440: 20 74 68 61 74 20 61 6e 79 20 6e 65 77 20 76 65 that any new ve
0450: 72 73 69 6f 6e 20 63 6f 6e 74 72 6f 6c 20 73 79 rsion control sy
0460: 73 74 65 6d 0d 0a 28 56 43 53 29 20 77 69 6c 6c stem..(VCS) will
0470: 20 6e 65 65 64 20 74 6f 20 64 65 61 6c 20 65 66 need to deal ef
0480: 66 65 63 74 69 76 65 6c 79 20 77 69 74 68 20 74 fectively with t
0490: 68 65 20 47 69 74 20 6c 65 67 61 63 79 2e 20 20 he Git legacy.
04a0: 46 6f 72 20 74 68 69 73 0d 0a 72 65 61 73 6f 6e For this..reason
04b0: 2c 20 6f 6e 65 20 69 6d 70 6f 72 74 61 6e 74 20 , one important
04c0: 67 6f 61 6c 20 6f 66 20 46 6f 73 73 69 6c 2d 4e goal of Fossil-N
04d0: 47 20 69 73 20 74 6f 20 61 6c 6c 6f 77 20 73 65 G is to allow se
04e0: 61 6d 6c 65 73 73 20 69 6e 74 65 67 72 61 74 69 amless integrati
04f0: 6f 6e 0d 0a 77 69 74 68 20 6c 65 67 61 63 79 20 on..with legacy
0500: 47 69 74 20 72 65 70 6f 73 69 74 6f 72 69 65 73 Git repositories
0510: 2e 0d 0a 0d 0a 54 68 65 20 70 72 69 6d 61 72 79 .....The primary
0520: 20 61 6e 64 20 6d 6f 73 74 20 69 6d 70 6f 72 74 and most import
0530: 61 6e 74 20 70 75 72 70 6f 73 65 20 6f 66 20 46 ant purpose of F
0540: 6f 73 73 69 6c 20 69 73 20 74 6f 20 73 75 70 70 ossil is to supp
0550: 6f 72 74 20 74 68 65 0d 0a 64 65 76 65 6c 6f 70 ort the..develop
0560: 6d 65 6e 74 20 6f 66 20 74 68 65 20 5b 53 51 4c ment of the [SQL
0570: 69 74 65 5d 28 68 74 74 70 73 3a 2f 2f 73 71 6c ite](https://sql
0580: 69 74 65 2e 6f 72 67 2f 29 20 70 72 6f 6a 65 63 ite.org/) projec
0590: 74 2e 20 20 4c 65 67 61 63 79 0d 0a 46 6f 73 73 t. Legacy..Foss
05a0: 69 6c 20 68 61 73 20 73 75 63 63 65 65 64 65 64 il has succeeded
05b0: 20 66 61 62 75 6c 6f 75 73 6c 79 20 69 6e 20 74 fabulously in t
05c0: 68 61 74 20 72 65 73 70 65 63 74 2e 20 20 41 6e hat respect. An
05d0: 79 20 63 68 61 6e 67 65 73 20 69 6d 70 6c 65 6d y changes implem
05e0: 65 6e 74 65 64 0d 0a 66 6f 72 20 46 6f 73 73 69 ented..for Fossi
05f0: 6c 2d 4e 47 20 6d 75 73 74 20 72 65 73 70 65 63 l-NG must respec
0600: 74 20 74 68 61 74 20 68 69 73 74 6f 72 79 2e 20 t that history.
0610: 20 49 6e 20 70 61 72 74 69 63 75 6c 61 72 2c 20 In particular,
0620: 46 6f 73 73 69 6c 2d 4e 47 0d 0a 6d 75 73 74 20 Fossil-NG..must
0630: 62 65 20 61 62 6c 65 20 74 6f 20 69 6d 70 6f 72 be able to impor
0640: 74 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 20 53 t the complete S
0650: 51 4c 69 74 65 20 68 69 73 74 6f 72 79 20 69 6e QLite history in
0660: 74 61 63 74 2c 20 77 69 74 68 6f 75 74 0d 0a 61 tact, without..a
0670: 6e 79 20 63 68 61 6e 67 65 73 20 74 6f 20 68 61 ny changes to ha
0680: 73 68 20 69 64 65 6e 74 69 66 69 65 72 73 2e 0d sh identifiers..
0690: 0a 0d 0a 0a 5a 20 62 32 38 32 32 30 32 34 64 31 ....Z b2822024d1
06a0: 63 34 32 30 35 32 30 32 34 37 39 35 63 31 63 36 c42052024795c1c6
06b0: 32 65 32 34 66 33 0a 2e24f3.