Artifact
12316c8f835ea3bb9fa520c5f274ced20fd7e2bf2a8cf3876efa35e899853733:
Wiki page
[Abridged Version History] by
tangent
2022-09-01 14:22:21.
0000: 44 20 32 30 32 32 2d 30 39 2d 30 31 54 31 34 3a D 2022-09-01T14:
0010: 32 32 3a 32 31 2e 32 38 37 0a 4c 20 41 62 72 69 22:21.287.L Abri
0020: 64 67 65 64 5c 73 56 65 72 73 69 6f 6e 5c 73 48 dged\sVersion\sH
0030: 69 73 74 6f 72 79 0a 4e 20 74 65 78 74 2f 78 2d istory.N text/x-
0040: 6d 61 72 6b 64 6f 77 6e 0a 50 20 36 61 61 61 31 markdown.P 6aaa1
0050: 32 33 39 32 66 63 33 37 37 36 66 35 30 30 64 62 2392fc3776f500db
0060: 31 39 39 36 33 61 31 38 32 33 38 66 34 63 36 32 19963a18238f4c62
0070: 34 38 31 37 39 62 66 30 64 30 65 38 30 36 37 37 48179bf0d0e80677
0080: 30 33 30 36 38 31 66 36 39 62 64 0a 55 20 74 61 030681f69bd.U ta
0090: 6e 67 65 6e 74 0a 57 20 37 38 33 39 0a 23 20 4d ngent.W 7839.# M
00a0: 69 73 73 69 6e 67 20 48 69 73 74 6f 72 79 0d 0a issing History..
00b0: 0d 0a 46 72 6f 6d 20 32 30 31 37 2e 30 36 2e 32 ..From 2017.06.2
00c0: 38 20 6f 6e 77 61 72 64 2c 20 74 68 69 73 20 46 8 onward, this F
00d0: 6f 73 73 69 6c 20 72 65 70 6f 73 69 74 6f 72 79 ossil repository
00e0: 20 68 61 73 20 74 68 65 20 66 75 6c 6c 20 63 68 has the full ch
00f0: 65 63 6b 69 6e 2d 62 79 2d 63 68 65 63 6b 69 6e eckin-by-checkin
0100: 20 68 69 73 74 6f 72 79 20 6f 66 20 74 68 65 20 history of the
0110: 4d 79 53 51 4c 2b 2b 20 70 72 6f 6a 65 63 74 2c MySQL++ project,
0120: 20 70 6c 75 73 20 6d 61 74 65 72 69 61 6c 20 73 plus material s
0130: 75 63 68 20 61 73 20 77 69 6b 69 20 70 61 67 65 uch as wiki page
0140: 73 20 6c 69 6b 65 20 74 68 69 73 20 6f 6e 65 20 s like this one
0150: 77 68 69 63 68 20 6e 65 76 65 72 20 77 61 73 20 which never was
0160: 61 76 61 69 6c 61 62 6c 65 20 69 6e 20 74 68 65 available in the
0170: 20 6f 6c 64 20 53 75 62 76 65 72 73 69 6f 6e 20 old Subversion
0180: 72 65 70 6f 73 69 74 6f 72 79 2e 0d 0a 0d 0a 50 repository.....P
0190: 72 69 6f 72 20 74 6f 20 74 68 61 74 20 64 61 74 rior to that dat
01a0: 65 2c 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 e, the repositor
01b0: 79 20 63 6f 6e 74 61 69 6e 73 20 65 76 65 72 79 y contains every
01c0: 20 72 65 6c 65 61 73 65 64 20 76 65 72 73 69 6f released versio
01d0: 6e 20 6f 66 20 4d 79 53 51 4c 2b 2b 20 66 72 6f n of MySQL++ fro
01e0: 6d 20 74 68 65 20 70 72 6f 6a 65 63 74 27 73 20 m the project's
01f0: 66 6f 75 6e 64 69 6e 67 20 69 6e 20 31 39 39 38 founding in 1998
0200: 20 77 69 74 68 20 76 65 72 73 69 6f 6e 20 30 2e with version 0.
0210: 36 34 2e 31 2e 31 2e 61 20 75 70 20 75 6e 74 69 64.1.1.a up unti
0220: 6c 20 74 68 65 20 33 2e 32 2e 33 20 72 65 6c 65 l the 3.2.3 rele
0230: 61 73 65 20 6d 61 64 65 20 61 74 20 74 68 65 20 ase made at the
0240: 65 6e 64 20 6f 66 20 32 30 31 36 2e 0d 0a 0d 0a end of 2016.....
0250: 0d 0a 23 20 57 68 61 74 20 48 61 70 70 65 6e 65 ..# What Happene
0260: 64 3f 0d 0a 0d 0a 4f 75 72 20 5b 70 72 69 6f 72 d?....Our [prior
0270: 20 76 65 72 73 69 6f 6e 20 63 6f 6e 74 72 6f 6c version control
0280: 20 68 6f 73 74 5d 28 68 74 74 70 73 3a 2f 2f 65 host](https://e
0290: 6e 2e 77 69 6b 69 70 65 64 69 61 2e 6f 72 67 2f n.wikipedia.org/
02a0: 77 69 6b 69 2f 47 6e 61 21 29 20 63 65 61 73 65 wiki/Gna!) cease
02b0: 64 20 6f 70 65 72 61 74 69 6f 6e 73 20 77 69 74 d operations wit
02c0: 68 6f 75 74 20 6e 6f 74 69 66 79 69 6e 67 20 6d hout notifying m
02d0: 65 20 76 69 61 20 61 6e 79 20 63 68 61 6e 6e 65 e via any channe
02e0: 6c 20 49 20 70 61 79 20 61 74 74 65 6e 74 69 6f l I pay attentio
02f0: 6e 20 74 6f 2c 20 61 6e 64 20 74 68 65 79 20 64 n to, and they d
0300: 69 64 6e 27 74 20 6f 66 66 65 72 20 61 20 6d 65 idn't offer a me
0310: 74 68 6f 64 20 74 6f 20 64 6f 77 6e 6c 6f 61 64 thod to download
0320: 20 74 68 65 20 61 72 63 68 69 76 65 64 20 53 75 the archived Su
0330: 62 76 65 72 73 69 6f 6e 20 72 65 70 6f 73 69 74 bversion reposit
0340: 6f 72 79 20 61 66 74 65 72 20 74 68 65 20 66 61 ory after the fa
0350: 63 74 2e 20 54 68 61 74 20 6c 65 66 74 20 6d 65 ct. That left me
0360: 20 77 69 74 68 20 6f 6e 6c 79 20 74 68 65 20 72 with only the r
0370: 65 6c 65 61 73 65 20 74 61 72 62 61 6c 6c 73 20 elease tarballs
0380: 61 6e 64 20 61 20 66 65 77 20 6c 6f 63 61 6c 20 and a few local
0390: 76 65 72 73 69 6f 6e 20 63 68 65 63 6b 6f 75 74 version checkout
03a0: 73 20 66 72 6f 6d 20 77 68 69 63 68 20 74 6f 20 s from which to
03b0: 72 65 63 6f 6e 73 74 72 75 63 74 20 74 68 65 20 reconstruct the
03c0: 70 72 6f 6a 65 63 74 20 68 69 73 74 6f 72 79 2e project history.
03d0: 0d 0a 0d 0a 49 20 77 72 6f 74 65 20 61 20 5b 63 ....I wrote a [c
03e0: 6f 6e 76 65 72 73 69 6f 6e 20 73 63 72 69 70 74 onversion script
03f0: 5d 5b 63 73 5d 20 74 68 61 74 20 75 6e 70 61 63 ][cs] that unpac
0400: 6b 65 64 20 65 61 63 68 20 5b 72 65 6c 65 61 73 ked each [releas
0410: 65 20 74 61 72 62 61 6c 6c 5d 28 2f 72 65 6c 65 e tarball](/rele
0420: 61 73 65 73 29 20 69 6e 20 74 75 72 6e 2c 20 72 ases) in turn, r
0430: 65 6d 6f 76 65 64 20 61 6c 6c 20 67 65 6e 65 72 emoved all gener
0440: 61 74 65 64 20 66 69 6c 65 73 20 61 63 63 6f 72 ated files accor
0450: 64 69 6e 67 20 74 6f 20 61 20 73 65 74 20 6f 66 ding to a set of
0460: 20 5b 69 67 6e 6f 72 65 20 72 75 6c 65 73 5d 5b [ignore rules][
0470: 69 72 5d 2c 20 74 68 65 6e 20 63 68 65 63 6b 65 ir], then checke
0480: 64 20 74 68 65 20 64 69 66 66 65 72 65 6e 63 65 d the difference
0490: 73 20 72 65 6c 61 74 69 76 65 20 74 6f 20 74 68 s relative to th
04a0: 65 20 70 72 69 6f 72 20 74 61 72 62 61 6c 6c 20 e prior tarball
04b0: 69 6e 74 6f 20 61 20 66 72 65 73 68 20 46 6f 73 into a fresh Fos
04c0: 73 69 6c 20 72 65 70 6f 73 69 74 6f 72 79 2e 20 sil repository.
04d0: 54 68 69 73 20 67 69 76 65 73 20 75 73 20 61 20 This gives us a
04e0: 72 65 6c 65 61 73 65 2d 62 79 2d 72 65 6c 65 61 release-by-relea
04f0: 73 65 20 63 6f 6d 6d 69 74 20 68 69 73 74 6f 72 se commit histor
0500: 79 20 70 72 69 6f 72 20 74 6f 20 32 30 31 37 2c y prior to 2017,
0510: 20 77 69 74 68 20 61 20 73 69 6e 67 6c 65 20 65 with a single e
0520: 78 63 65 70 74 69 6f 6e 3a 20 74 68 65 20 5b 76 xception: the [v
0530: 65 72 73 69 6f 6e 20 31 2e 37 2e 33 33 20 74 61 ersion 1.7.33 ta
0540: 72 62 61 6c 6c 5d 28 2f 72 65 6c 65 61 73 65 73 rball](/releases
0550: 2f 6d 79 73 71 6c 2b 2b 2d 31 2e 37 2e 33 33 2e /mysql++-1.7.33.
0560: 74 61 72 2e 67 7a 29 20 49 20 68 61 76 65 20 61 tar.gz) I have a
0570: 72 63 68 69 76 65 64 20 69 73 20 64 61 6d 61 67 rchived is damag
0580: 65 64 2c 20 73 6f 20 49 20 65 6c 65 63 74 65 64 ed, so I elected
0590: 20 6e 6f 74 20 74 6f 20 63 68 65 63 6b 20 74 68 not to check th
05a0: 61 74 20 70 61 72 74 69 61 6c 20 72 65 6c 65 61 at partial relea
05b0: 73 65 20 69 6e 74 6f 20 74 68 69 73 20 46 6f 73 se into this Fos
05c0: 73 69 6c 20 72 65 70 6f 73 69 74 6f 72 79 2c 20 sil repository,
05d0: 63 61 75 73 69 6e 67 20 74 68 65 20 72 65 76 69 causing the revi
05e0: 73 69 6f 6e 20 68 69 73 74 6f 72 79 20 74 6f 20 sion history to
05f0: 73 6b 69 70 20 66 72 6f 6d 20 76 65 72 73 69 6f skip from versio
0600: 6e 20 31 2e 37 2e 33 32 20 74 6f 20 31 2e 37 2e n 1.7.32 to 1.7.
0610: 33 34 2e 0d 0a 0d 0a 42 65 63 61 75 73 65 20 46 34.....Because F
0620: 6f 73 73 69 6c 20 69 73 20 61 20 5b 64 69 73 74 ossil is a [dist
0630: 72 69 62 75 74 65 64 20 76 65 72 73 69 6f 6e 20 ributed version
0640: 63 6f 6e 74 72 6f 6c 20 73 79 73 74 65 6d 5d 5b control system][
0650: 64 76 63 73 5d 20 64 65 73 69 67 6e 65 64 20 61 dvcs] designed a
0660: 72 6f 75 6e 64 20 61 20 5b 70 68 69 6c 6f 73 6f round a [philoso
0670: 70 68 79 5d 5b 66 76 67 5d 20 6f 66 20 65 6e 73 phy][fvg] of ens
0680: 75 72 69 6e 67 20 74 68 61 74 20 65 61 63 68 20 uring that each
0690: 63 6c 6f 6e 65 20 64 69 76 65 72 67 65 73 20 61 clone diverges a
06a0: 73 20 6c 69 74 74 6c 65 20 61 73 20 69 73 20 70 s little as is p
06b0: 72 61 63 74 69 63 61 6c 20 66 72 6f 6d 20 74 68 ractical from th
06c0: 65 20 6f 74 68 65 72 20 63 6c 6f 6e 65 73 2c 20 e other clones,
06d0: 74 68 65 20 6f 6e 6c 79 20 77 61 79 20 74 68 69 the only way thi
06e0: 73 20 63 61 6e 20 65 76 65 72 20 68 61 70 70 65 s can ever happe
06f0: 6e 20 61 67 61 69 6e 20 69 73 20 69 66 20 65 76 n again is if ev
0700: 65 72 79 6f 6e 65 20 77 68 6f 20 68 61 73 20 61 eryone who has a
0710: 20 63 6c 6f 6e 65 20 6f 66 20 4d 79 53 51 4c 2b clone of MySQL+
0720: 2b 27 73 20 72 65 70 6f 73 69 74 6f 72 79 20 64 +'s repository d
0730: 65 6c 65 74 65 73 20 61 6c 6c 20 74 68 65 69 72 eletes all their
0740: 20 63 6f 70 69 65 73 2e 20 53 6f 20 6c 6f 6e 67 copies. So long
0750: 20 61 73 20 74 68 65 72 65 20 69 73 20 61 74 20 as there is at
0760: 6c 65 61 73 74 20 6f 6e 65 20 70 65 72 73 6f 6e least one person
0770: 20 6f 6e 20 74 68 65 20 70 6c 61 6e 65 74 20 77 on the planet w
0780: 69 74 68 20 61 6e 20 75 70 2d 74 6f 2d 64 61 74 ith an up-to-dat
0790: 65 20 63 6c 6f 6e 65 2c 20 74 68 65 20 4d 79 53 e clone, the MyS
07a0: 51 4c 2b 2b 20 64 65 76 65 6c 6f 70 6d 65 6e 74 QL++ development
07b0: 20 68 69 73 74 6f 72 79 20 77 69 6c 6c 20 62 65 history will be
07c0: 20 70 72 65 73 65 72 76 65 64 2e 0d 0a 0d 0a 5b preserved.....[
07d0: 63 73 5d 3a 20 20 20 2f 64 6f 63 2f 74 72 75 6e cs]: /doc/trun
07e0: 6b 2f 74 6f 6f 6c 73 2f 74 61 72 62 61 6c 6c 73 k/tools/tarballs
07f0: 2d 74 6f 2d 66 6f 73 73 69 6c 3f 6d 69 6d 65 74 -to-fossil?mimet
0800: 79 70 65 3d 74 65 78 74 2f 70 6c 61 69 6e 0d 0a ype=text/plain..
0810: 5b 64 76 63 73 5d 3a 20 68 74 74 70 3a 2f 2f 65 [dvcs]: http://e
0820: 6e 2e 77 69 6b 69 70 65 64 69 61 2e 6f 72 67 2f n.wikipedia.org/
0830: 77 69 6b 69 2f 44 69 73 74 72 69 62 75 74 65 64 wiki/Distributed
0840: 5f 72 65 76 69 73 69 6f 6e 5f 63 6f 6e 74 72 6f _revision_contro
0850: 6c 0d 0a 5b 66 76 67 5d 3a 20 20 68 74 74 70 73 l..[fvg]: https
0860: 3a 2f 2f 66 6f 73 73 69 6c 2d 73 63 6d 2e 6f 72 ://fossil-scm.or
0870: 67 2f 68 6f 6d 65 2f 64 6f 63 2f 74 72 75 6e 6b g/home/doc/trunk
0880: 2f 77 77 77 2f 66 6f 73 73 69 6c 2d 76 2d 67 69 /www/fossil-v-gi
0890: 74 2e 77 69 6b 69 23 64 65 76 6f 72 67 0d 0a 5b t.wiki#devorg..[
08a0: 69 72 5d 3a 20 20 20 2f 64 6f 63 2f 74 72 75 6e ir]: /doc/trun
08b0: 6b 2f 74 6f 6f 6c 73 2f 74 62 2d 69 67 6e 6f 72 k/tools/tb-ignor
08c0: 65 2d 67 6c 6f 62 3f 6d 69 6d 65 74 79 70 65 3d e-glob?mimetype=
08d0: 74 65 78 74 2f 70 6c 61 69 6e 0d 0a 0d 0a 0d 0a text/plain......
08e0: 23 20 54 68 65 20 56 61 6c 75 65 20 6f 66 20 48 # The Value of H
08f0: 69 73 74 6f 72 79 0d 0a 0d 0a 49 66 20 49 27 64 istory....If I'd
0900: 20 63 68 6f 73 65 6e 20 74 6f 20 6d 69 67 72 61 chosen to migra
0910: 74 65 20 74 68 65 20 4d 79 53 51 4c 2b 2b 20 70 te the MySQL++ p
0920: 72 6f 6a 65 63 74 20 74 6f 20 46 6f 73 73 69 6c roject to Fossil
0930: 20 62 65 66 6f 72 65 20 6c 6f 73 69 6e 67 20 61 before losing a
0940: 63 63 65 73 73 20 74 6f 20 74 68 65 20 6f 6c 64 ccess to the old
0950: 20 53 75 62 76 65 72 73 69 6f 6e 20 72 65 70 6f Subversion repo
0960: 2c 20 49 27 64 20 68 61 76 65 20 61 20 63 68 65 , I'd have a che
0970: 63 6b 69 6e 2d 62 79 2d 63 68 65 63 6b 69 6e 20 ckin-by-checkin
0980: 63 6f 6e 76 65 72 73 69 6f 6e 20 69 6e 73 74 65 conversion inste
0990: 61 64 20 6f 66 20 74 68 69 73 20 70 72 65 73 65 ad of this prese
09a0: 6e 74 20 72 65 6c 65 61 73 65 2d 6c 65 76 65 6c nt release-level
09b0: 20 63 6f 6e 76 65 72 73 69 6f 6e 2c 20 74 68 65 conversion, the
09c0: 20 70 72 69 6d 61 72 79 20 62 65 6e 65 66 69 74 primary benefit
09d0: 20 6f 66 20 77 68 69 63 68 20 77 6f 75 6c 64 20 of which would
09e0: 62 65 20 74 6f 20 67 65 74 20 61 6c 6c 20 6f 66 be to get all of
09f0: 20 74 68 65 20 70 72 65 2d 32 30 31 37 20 63 68 the pre-2017 ch
0a00: 65 63 6b 69 6e 20 63 6f 6d 6d 65 6e 74 73 2e 20 eckin comments.
0a10: 57 65 20 62 65 73 74 20 77 65 27 72 65 20 6c 65 We best we're le
0a20: 66 74 20 77 69 74 68 20 69 73 20 5b 74 68 65 20 ft with is [the
0a30: 60 43 68 61 6e 67 65 4c 6f 67 2e 6d 64 60 20 66 `ChangeLog.md` f
0a40: 69 6c 65 5d 28 2f 64 6f 63 2f 74 72 75 6e 6b 2f ile](/doc/trunk/
0a50: 43 68 61 6e 67 65 4c 6f 67 2e 6d 64 29 2c 20 77 ChangeLog.md), w
0a60: 68 69 63 68 20 77 61 73 20 64 69 73 74 69 6c 6c hich was distill
0a70: 65 64 20 66 72 6f 6d 20 74 68 61 74 20 63 6f 6d ed from that com
0a80: 6d 65 6e 74 20 73 74 72 65 61 6d 2e 0d 0a 0d 0a ment stream.....
0a90: 54 68 65 20 74 68 69 6e 67 20 69 73 2c 20 74 68 The thing is, th
0aa0: 61 74 20 63 6f 6d 6d 69 74 20 63 6f 6d 6d 65 6e at commit commen
0ab0: 74 20 73 74 72 65 61 6d 20 69 73 20 6c 61 72 67 t stream is larg
0ac0: 65 6c 79 20 61 20 6d 61 74 74 65 72 20 6f 66 20 ely a matter of
0ad0: 68 69 73 74 6f 72 69 63 61 6c 20 63 75 72 69 6f historical curio
0ae0: 73 69 74 79 2e 20 49 66 20 49 20 63 6f 75 6c 64 sity. If I could
0af0: 20 77 61 76 65 20 61 20 6d 61 67 69 63 20 77 61 wave a magic wa
0b00: 6e 64 20 61 6e 64 20 67 6f 20 62 61 63 6b 20 69 nd and go back i
0b10: 6e 20 74 69 6d 65 20 74 6f 20 64 6f 20 61 20 63 n time to do a c
0b20: 6f 6d 6d 69 74 2d 6c 65 76 65 6c 20 63 6f 6e 76 ommit-level conv
0b30: 65 72 73 69 6f 6e 20 62 65 66 6f 72 65 20 74 68 ersion before th
0b40: 65 20 6f 6c 64 20 72 65 70 6f 20 68 6f 73 74 20 e old repo host
0b50: 64 6f 77 6e 2c 20 74 68 65 20 72 65 73 75 6c 74 down, the result
0b60: 69 6e 67 20 46 6f 73 73 69 6c 20 72 65 70 6f 73 ing Fossil repos
0b70: 69 74 6f 72 79 20 77 6f 75 6c 64 20 62 65 20 6c itory would be l
0b80: 61 72 67 65 72 2c 20 62 75 74 20 69 74 20 77 6f arger, but it wo
0b90: 75 6c 64 6e 27 74 20 62 65 20 61 70 70 72 65 63 uldn't be apprec
0ba0: 69 61 62 6c 79 20 6d 6f 72 65 20 75 73 65 66 75 iably more usefu
0bb0: 6c 2e 20 4d 79 53 51 4c 2b 2b 20 6c 6f 6e 67 20 l. MySQL++ long
0bc0: 73 69 6e 63 65 20 62 65 63 61 6d 65 20 73 74 61 since became sta
0bd0: 62 6c 65 20 65 6e 6f 75 67 68 20 74 68 61 74 20 ble enough that
0be0: 6f 6c 64 20 76 65 72 73 69 6f 6e 73 20 61 72 65 old versions are
0bf0: 20 6f 66 20 76 65 72 79 20 6c 69 74 74 6c 65 20 of very little
0c00: 70 72 61 63 74 69 63 61 6c 20 69 6e 74 65 72 65 practical intere
0c10: 73 74 2e 20 43 75 72 72 65 6e 74 20 76 65 72 73 st. Current vers
0c20: 69 6f 6e 73 20 62 75 69 6c 64 20 61 6e 64 20 77 ions build and w
0c30: 6f 72 6b 20 6f 6e 20 70 72 65 74 74 79 20 6d 75 ork on pretty mu
0c40: 63 68 20 65 76 65 72 79 20 6d 61 6a 6f 72 20 4f ch every major O
0c50: 53 20 72 65 6c 65 61 73 65 64 20 69 6e 20 74 68 S released in th
0c60: 65 20 70 61 73 74 20 31 30 20 79 65 61 72 73 20 e past 10 years
0c70: 6f 72 20 6d 6f 72 65 2c 20 61 6e 64 20 6f 6c 64 or more, and old
0c80: 65 72 20 4f 53 65 73 20 6f 66 74 65 6e 20 68 61 er OSes often ha
0c90: 76 65 20 61 20 63 6f 6e 74 65 6d 70 6f 72 61 72 ve a contemporar
0ca0: 79 20 4d 79 53 51 4c 2b 2b 20 70 61 63 6b 61 67 y MySQL++ packag
0cb0: 65 20 62 75 69 6c 74 20 66 6f 72 20 74 68 65 6d e built for them
0cc0: 2e 20 54 68 65 72 65 20 73 69 6d 70 6c 79 20 69 . There simply i
0cd0: 73 20 76 65 72 79 20 6c 69 74 74 6c 65 20 63 61 s very little ca
0ce0: 6c 6c 20 66 6f 72 20 64 69 67 67 69 6e 67 20 69 ll for digging i
0cf0: 6e 74 6f 20 70 61 73 74 20 76 65 72 73 69 6f 6e nto past version
0d00: 73 20 76 69 61 20 74 68 69 73 20 76 65 72 73 69 s via this versi
0d10: 6f 6e 20 63 6f 6e 74 72 6f 6c 20 73 79 73 74 65 on control syste
0d20: 6d 2e 0d 0a 0d 0a 48 61 76 69 6e 67 20 63 6f 6e m.....Having con
0d30: 66 72 6f 6e 74 65 64 20 74 68 61 74 20 72 65 61 fronted that rea
0d40: 6c 69 74 79 2c 20 74 68 65 20 71 75 65 73 74 69 lity, the questi
0d50: 6f 6e 20 74 68 65 6e 20 63 61 6d 65 20 64 6f 77 on then came dow
0d60: 6e 20 74 6f 20 68 6f 77 20 6d 75 63 68 20 68 69 n to how much hi
0d70: 73 74 6f 72 79 20 74 6f 20 74 72 79 20 61 6e 64 story to try and
0d80: 20 70 72 65 73 65 72 76 65 20 69 6e 20 74 68 65 preserve in the
0d90: 20 63 6f 6e 76 65 72 73 69 6f 6e 2e 0d 0a 0d 0a conversion.....
0da0: 49 20 63 6f 6e 73 69 64 65 72 65 64 20 63 68 65 I considered che
0db0: 63 6b 69 6e 67 20 69 6e 20 6f 6e 6c 79 20 61 20 cking in only a
0dc0: 68 61 6e 64 66 75 6c 20 6f 66 20 65 70 6f 63 68 handful of epoch
0dd0: 61 6c 20 76 65 72 73 69 6f 6e 73 20 61 6e 64 20 al versions and
0de0: 6c 65 61 76 69 6e 67 20 69 74 20 61 74 20 74 68 leaving it at th
0df0: 61 74 2e 20 53 61 79 2c 20 5b 31 2e 37 2e 39 5d at. Say, [1.7.9]
0e00: 28 2f 74 69 6d 65 6c 69 6e 65 3f 74 3d 76 31 2e (/timeline?t=v1.
0e10: 37 2e 39 29 2c 20 5b 31 2e 37 2e 34 30 5d 28 2f 7.9), [1.7.40](/
0e20: 74 69 6d 65 6c 69 6e 65 3f 74 3d 76 31 2e 37 2e timeline?t=v1.7.
0e30: 34 30 29 2c 20 70 6c 75 73 20 61 20 73 65 6c 65 40), plus a sele
0e40: 63 74 69 6f 6e 20 6f 66 20 32 2e 78 20 61 6e 64 ction of 2.x and
0e50: 20 33 2e 78 20 72 65 6c 65 61 73 65 73 20 73 68 3.x releases sh
0e60: 6f 77 69 6e 67 20 6f 66 66 20 6d 61 6a 6f 72 20 owing off major
0e70: 73 74 61 67 65 73 20 6f 66 20 74 68 65 20 6c 69 stages of the li
0e80: 62 72 61 72 79 27 73 20 64 65 76 65 6c 6f 70 6d brary's developm
0e90: 65 6e 74 2c 20 63 61 70 70 65 64 20 62 79 20 74 ent, capped by t
0ea0: 68 65 20 63 75 72 72 65 6e 74 20 72 65 6c 65 61 he current relea
0eb0: 73 65 20 61 74 20 74 68 65 20 74 69 6d 65 20 6f se at the time o
0ec0: 66 20 63 6f 6e 76 65 72 73 69 6f 6e 2c 20 33 2e f conversion, 3.
0ed0: 32 2e 33 2e 20 49 20 72 65 6a 65 63 74 65 64 20 2.3. I rejected
0ee0: 74 68 69 73 20 62 65 63 61 75 73 65 20 69 6e 20 this because in
0ef0: 61 6c 6c 20 74 68 65 20 74 69 6d 65 20 6f 66 20 all the time of
0f00: 77 61 74 63 68 69 6e 67 20 74 68 65 20 70 72 6f watching the pro
0f10: 6a 65 63 74 27 73 20 6f 6c 64 20 6d 61 69 6c 69 ject's old maili
0f20: 6e 67 20 6c 69 73 74 2c 20 49 20 64 69 64 20 6e ng list, I did n
0f30: 6f 74 20 6f 66 74 65 6e 20 73 65 65 20 70 65 6f ot often see peo
0f40: 70 6c 65 20 67 6f 69 6e 67 20 62 61 63 6b 20 74 ple going back t
0f50: 6f 20 6f 6e 65 20 6f 66 20 74 68 65 73 65 20 69 o one of these i
0f60: 6d 70 6f 72 74 61 6e 74 20 68 69 73 74 6f 72 69 mportant histori
0f70: 63 61 6c 20 76 65 72 73 69 6f 6e 73 2e 0d 0a 0d cal versions....
0f80: 0a 49 20 74 68 65 72 65 66 6f 72 65 20 64 65 63 .I therefore dec
0f90: 69 64 65 64 20 74 68 61 74 20 77 68 61 74 20 77 ided that what w
0fa0: 61 73 20 6d 6f 73 74 20 69 6d 70 6f 72 74 61 6e as most importan
0fb0: 74 20 77 61 73 20 74 6f 20 73 63 61 74 74 65 72 t was to scatter
0fc0: 20 74 68 65 20 70 72 6f 6a 65 63 74 27 73 20 63 the project's c
0fd0: 6f 6d 70 6c 65 74 65 20 72 65 6c 65 61 73 65 20 omplete release
0fe0: 68 69 73 74 6f 72 79 20 66 61 72 20 61 6e 64 20 history far and
0ff0: 77 69 64 65 2c 20 73 6f 20 61 73 20 74 6f 20 61 wide, so as to a
1000: 76 6f 69 64 20 61 20 63 61 6c 61 6d 69 74 79 20 void a calamity
1010: 6c 69 6b 65 20 74 68 69 73 20 61 67 61 69 6e 2e like this again.
1020: 20 49 20 77 61 6e 74 65 64 20 65 76 65 72 79 6f I wanted everyo
1030: 6e 65 20 77 68 6f 20 63 6c 6f 6e 65 64 20 74 68 ne who cloned th
1040: 69 73 20 46 6f 73 73 69 6c 20 72 65 70 6f 73 69 is Fossil reposi
1050: 74 6f 72 79 20 74 6f 20 68 61 76 65 20 74 68 65 tory to have the
1060: 20 61 62 69 6c 69 74 79 20 74 6f 20 72 65 70 6c ability to repl
1070: 61 63 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 ace the current
1080: 70 72 6f 6a 65 63 74 20 68 6f 6d 65 20 70 61 67 project home pag
1090: 65 20 69 66 20 49 20 64 69 73 61 70 70 65 61 72 e if I disappear
10a0: 65 64 20 6c 69 6b 65 20 47 6e 61 20 64 69 64 2e ed like Gna did.
10b0: 20 54 68 61 74 27 73 20 74 68 65 20 62 65 61 75 That's the beau
10c0: 74 79 20 6f 66 20 44 56 43 53 65 73 3a 20 77 65 ty of DVCSes: we
10d0: 20 68 61 76 65 20 70 6c 65 6e 74 79 20 6f 66 20 have plenty of
10e0: 6f 74 68 65 72 20 65 78 61 6d 70 6c 65 73 20 6f other examples o
10f0: 66 20 73 6f 75 72 63 65 20 63 6f 64 65 20 72 65 f source code re
1100: 70 6f 73 69 74 6f 72 79 20 68 6f 73 74 73 20 64 pository hosts d
1110: 69 73 61 70 70 65 61 72 69 6e 67 2c 20 6e 65 63 isappearing, nec
1120: 72 6f 74 69 7a 69 6e 67 2c 20 6f 72 20 62 65 63 rotizing, or bec
1130: 6f 6d 69 6e 67 20 65 76 69 6c 2e 0d 0a 0d 0a 0d oming evil......
1140: 0a 23 20 53 6f 20 57 68 79 20 49 73 20 49 74 20 .# So Why Is It
1150: 53 6d 61 6c 6c 65 72 3f 0d 0a 0d 0a 41 73 20 6f Smaller?....As o
1160: 66 20 74 68 69 73 20 77 72 69 74 69 6e 67 2c 20 f this writing,
1170: 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 the size of the
1180: 63 6c 6f 6e 65 64 20 72 65 70 6f 73 69 74 6f 72 cloned repositor
1190: 79 20 73 69 7a 65 20 69 73 20 61 62 6f 75 74 20 y size is about
11a0: 74 68 65 20 73 61 6d 65 20 73 69 7a 65 20 61 73 the same size as
11b0: 20 74 68 65 20 6c 61 74 65 73 74 20 72 65 6c 65 the latest rele
11c0: 61 73 65 20 74 61 72 62 61 6c 6c 3a 20 65 61 63 ase tarball: eac
11d0: 68 20 61 72 65 20 61 62 6f 75 74 20 34 c2 a0 4d h are about 4 M
11e0: 69 42 2e 20 48 6f 77 20 63 61 6e 20 74 68 69 73 iB. How can this
11f0: 20 62 65 20 69 66 20 74 68 65 20 72 65 70 6f 73 be if the repos
1200: 69 74 6f 72 79 20 63 6f 6e 74 61 69 6e 73 20 65 itory contains e
1210: 76 65 72 79 20 72 65 6c 65 61 73 65 64 20 76 65 very released ve
1220: 72 73 69 6f 6e 3f 20 54 68 65 72 65 20 61 72 65 rsion? There are
1230: 20 61 20 63 6f 75 70 6c 65 20 6f 66 20 6d 61 6a a couple of maj
1240: 6f 72 20 73 6f 75 72 63 65 73 20 6f 66 20 73 61 or sources of sa
1250: 76 69 6e 67 73 2e 0d 0a 0d 0a 0d 0a 23 23 20 46 vings.......## F
1260: 69 6c 65 20 52 65 6d 6f 76 61 6c 0d 0a 0d 0a 54 ile Removal....T
1270: 68 65 20 70 72 69 6d 61 72 79 20 72 65 61 73 6f he primary reaso
1280: 6e 20 66 6f 72 20 74 68 65 20 73 69 7a 65 20 73 n for the size s
1290: 61 76 69 6e 67 73 20 69 73 20 74 68 61 74 20 74 avings is that t
12a0: 68 65 20 5b 63 6f 6e 76 65 72 73 69 6f 6e 20 73 he [conversion s
12b0: 63 72 69 70 74 5d 5b 63 73 5d 20 72 65 6d 6f 76 cript][cs] remov
12c0: 65 64 20 61 6c 6c 20 74 68 65 20 66 69 6c 65 73 ed all the files
12d0: 20 74 68 61 74 20 63 61 6e 20 62 65 20 67 65 6e that can be gen
12e0: 65 72 61 74 65 64 20 66 72 6f 6d 20 61 6e 6f 74 erated from anot
12f0: 68 65 72 20 66 69 6c 65 20 61 6c 73 6f 20 63 68 her file also ch
1300: 65 63 6b 65 64 20 69 6e 2e 20 46 6f 72 20 74 68 ecked in. For th
1310: 65 20 6d 6f 73 74 20 70 61 72 74 2c 20 74 68 65 e most part, the
1320: 73 65 20 67 65 6e 65 72 61 74 65 64 20 66 69 6c se generated fil
1330: 65 73 20 61 72 65 20 69 6e 63 6c 75 64 65 64 20 es are included
1340: 69 6e 20 72 65 6c 65 61 73 65 20 74 61 72 62 61 in release tarba
1350: 6c 6c 73 20 6f 6e 6c 79 20 61 73 20 61 20 63 6f lls only as a co
1360: 6e 76 65 6e 69 65 6e 63 65 20 74 6f 20 74 68 65 nvenience to the
1370: 20 65 6e 64 20 75 73 65 72 20 6f 66 20 74 68 65 end user of the
1380: 20 4d 79 53 51 4c 2b 2b 20 6c 69 62 72 61 72 79 MySQL++ library
1390: 2c 20 73 69 6e 63 65 20 67 65 6e 65 72 61 74 69 , since generati
13a0: 6e 67 20 74 68 65 6d 20 69 73 20 61 20 72 61 74 ng them is a rat
13b0: 68 65 72 20 69 6e 76 6f 6c 76 65 64 20 70 72 6f her involved pro
13c0: 63 65 73 73 2c 20 72 65 71 75 69 72 69 6e 67 20 cess, requiring
13d0: 74 6f 6f 6c 73 20 74 68 61 74 20 61 72 65 6e 27 tools that aren'
13e0: 74 20 61 6c 77 61 79 73 20 65 61 73 69 6c 79 20 t always easily
13f0: 61 76 61 69 6c 61 62 6c 65 2e 0d 0a 0d 0a 49 6e available.....In
1400: 20 72 6f 75 67 68 20 6f 72 64 65 72 20 6f 66 20 rough order of
1410: 73 69 7a 65 2c 20 74 68 65 20 73 6f 75 72 63 65 size, the source
1420: 73 20 6f 66 20 62 6c 6f 61 74 20 69 6e 20 74 68 s of bloat in th
1430: 65 20 72 65 6c 65 61 73 65 20 74 61 72 62 61 6c e release tarbal
1440: 6c 73 20 72 65 6c 61 74 69 76 65 20 74 6f 20 74 ls relative to t
1450: 68 69 73 20 46 6f 73 73 69 6c 20 72 65 70 6f 73 his Fossil repos
1460: 69 74 6f 72 79 20 61 72 65 3a 0d 0a 0d 0a 2d 20 itory are:....-
1470: 2a 2a 44 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2a **Documentation*
1480: 2a 3a 20 54 68 65 20 75 73 65 72 20 61 6e 64 20 *: The user and
1490: 72 65 66 65 72 65 6e 63 65 20 6d 61 6e 75 61 6c reference manual
14a0: 73 20 61 72 65 20 63 75 72 72 65 6e 74 6c 79 20 s are currently
14b0: 67 65 6e 65 72 61 74 65 64 20 66 72 6f 6d 20 74 generated from t
14c0: 68 65 20 44 6f 63 42 6f 6f 6b 20 61 6e 64 20 44 he DocBook and D
14d0: 6f 78 79 67 65 6e 20 73 6f 75 72 63 65 20 6d 61 oxygen source ma
14e0: 74 65 72 69 61 6c 2c 20 72 65 73 70 65 63 74 69 terial, respecti
14f0: 76 65 6c 79 2e 20 54 68 65 20 46 6f 73 73 69 6c vely. The Fossil
1500: 20 72 65 70 6f 73 69 74 6f 72 79 20 6f 6e 6c 79 repository only
1510: 20 68 61 73 20 74 68 61 74 20 73 6f 75 72 63 65 has that source
1520: 20 6d 61 74 65 72 69 61 6c 20 63 68 65 63 6b 65 material checke
1530: 64 20 69 6e 2c 20 6e 6f 74 20 74 68 65 20 48 54 d in, not the HT
1540: 4d 4c 2c 20 50 44 46 2c 20 50 6f 73 74 53 63 72 ML, PDF, PostScr
1550: 69 70 74 2c 20 44 56 49 2c 20 50 4e 47 2c 20 47 ipt, DVI, PNG, G
1560: 49 46 2c 20 61 6e 64 20 6f 74 68 65 72 20 66 69 IF, and other fi
1570: 6c 65 73 20 67 65 6e 65 72 61 74 65 64 20 66 72 les generated fr
1580: 6f 6d 20 74 68 65 73 65 20 73 6f 75 72 63 65 73 om these sources
1590: 2e 0d 0a 0d 0a 2d 20 2a 2a 42 75 69 6c 64 20 53 .....- **Build S
15a0: 79 73 74 65 6d 20 46 69 6c 65 73 2a 2a 3a 20 20 ystem Files**:
15b0: 54 68 65 20 46 6f 73 73 69 6c 20 72 65 70 6f 73 The Fossil repos
15c0: 69 74 6f 72 79 20 64 6f 65 73 20 6e 6f 74 20 63 itory does not c
15d0: 6f 6e 74 61 69 6e 20 61 6e 79 20 6f 66 20 74 68 ontain any of th
15e0: 65 20 60 4d 61 6b 65 66 69 6c 65 73 60 20 6f 72 e `Makefiles` or
15f0: 20 49 44 45 20 70 72 6f 6a 65 63 74 20 66 69 6c IDE project fil
1600: 65 73 20 67 65 6e 65 72 61 74 65 64 20 66 72 6f es generated fro
1610: 6d 20 5b 60 6d 79 73 71 6c 2b 2b 2e 62 6b 6c 60 m [`mysql++.bkl`
1620: 5d 28 2f 66 69 6c 65 2f 6d 79 73 71 6c 25 32 42 ](/file/mysql%2B
1630: 25 32 42 2e 62 6b 6c 29 20 62 79 20 5b 42 61 6b %2B.bkl) by [Bak
1640: 65 66 69 6c 65 5d 28 68 74 74 70 3a 2f 2f 62 61 efile](http://ba
1650: 6b 65 66 69 6c 65 2e 6f 72 67 2f 29 2e 20 53 69 kefile.org/). Si
1660: 6d 69 6c 61 72 6c 79 2c 20 70 61 73 74 20 72 65 milarly, past re
1670: 6c 65 61 73 65 20 63 68 65 63 6b 69 6e 73 20 61 lease checkins a
1680: 72 65 20 6d 69 73 73 69 6e 67 20 74 68 65 20 6f re missing the o
1690: 75 74 70 75 74 73 20 66 72 6f 6d 20 74 68 65 20 utputs from the
16a0: 47 4e 55 20 41 75 74 6f 74 6f 6f 6c 73 20 63 61 GNU Autotools ca
16b0: 6c 6c 65 64 20 62 79 20 74 68 65 20 63 6f 6e 74 lled by the cont
16c0: 65 6d 70 6f 72 61 6e 65 6f 75 73 20 76 65 72 73 emporaneous vers
16d0: 69 6f 6e 73 20 6f 66 20 74 68 65 20 60 62 6f 6f ions of the `boo
16e0: 74 73 74 72 61 70 60 20 73 63 72 69 70 74 2e 0d tstrap` script..
16f0: 0a 0d 0a 2d 20 2a 2a 47 65 6e 65 72 61 74 65 64 ...- **Generated
1700: 20 48 65 61 64 65 72 73 2a 2a 3a 20 54 68 65 72 Headers**: Ther
1710: 65 20 61 72 65 20 61 20 63 6f 75 70 6c 65 20 6f e are a couple o
1720: 66 20 50 65 72 6c 20 73 63 72 69 70 74 73 20 69 f Perl scripts i
1730: 6e 20 4d 79 53 51 4c 2b 2b 20 74 68 61 74 20 67 n MySQL++ that g
1740: 65 6e 65 72 61 74 65 20 68 65 61 64 65 72 20 66 enerate header f
1750: 69 6c 65 73 20 74 68 61 74 20 77 6f 75 6c 64 20 iles that would
1760: 62 65 20 74 65 64 69 6f 75 73 20 74 6f 20 6d 61 be tedious to ma
1770: 69 6e 74 61 69 6e 20 62 79 20 68 61 6e 64 2e 20 intain by hand.
1780: 54 68 69 73 20 72 65 70 6f 73 69 74 6f 72 79 20 This repository
1790: 69 6e 63 6c 75 64 65 73 20 6f 6e 6c 79 20 74 68 includes only th
17a0: 65 20 50 65 72 6c 20 73 63 72 69 70 74 73 2c 20 e Perl scripts,
17b0: 6e 6f 74 20 74 68 65 20 68 65 61 64 65 72 73 20 not the headers
17c0: 74 68 65 79 20 67 65 6e 65 72 61 74 65 2e 20 54 they generate. T
17d0: 68 65 20 72 65 6c 65 61 73 65 20 74 61 72 62 61 he release tarba
17e0: 6c 6c 73 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 lls contain the
17f0: 68 65 61 64 65 72 73 20 61 73 20 77 65 6c 6c 2c headers as well,
1800: 20 73 6f 20 74 68 65 20 65 6e 64 20 75 73 65 72 so the end user
1810: 20 6f 66 20 74 68 65 20 6c 69 62 72 61 72 79 20 of the library
1820: 64 6f 65 73 6e 27 74 20 68 61 76 65 20 74 6f 20 doesn't have to
1830: 68 61 76 65 20 50 65 72 6c 2e 20 28 54 68 69 73 have Perl. (This
1840: 20 69 73 20 61 20 70 61 72 74 69 63 75 6c 61 72 is a particular
1850: 20 62 6f 74 68 65 72 20 6f 6e 20 57 69 6e 64 6f bother on Windo
1860: 77 73 2c 20 77 68 69 63 68 20 69 73 20 6f 6e 65 ws, which is one
1870: 20 72 65 61 73 6f 6e 20 77 65 20 72 65 63 6f 6d reason we recom
1880: 6d 65 6e 64 20 62 6f 6f 74 73 74 72 61 70 70 69 mend bootstrappi
1890: 6e 67 20 74 68 65 20 6c 69 62 72 61 72 79 20 6f ng the library o
18a0: 6e 20 61 20 50 4f 53 49 58 20 74 79 70 65 20 73 n a POSIX type s
18b0: 79 73 74 65 6d 2e 29 0d 0a 0d 0a 2d 20 2a 2a 2e ystem.)....- **.
18c0: 69 6e 20 46 69 6c 65 20 4f 75 74 70 75 74 73 2a in File Outputs*
18d0: 2a 3a 20 54 68 65 20 62 75 69 6c 64 20 73 79 73 *: The build sys
18e0: 74 65 6d 20 67 65 6e 65 72 61 74 65 73 20 73 65 tem generates se
18f0: 76 65 72 61 6c 20 66 69 6c 65 73 20 69 6e 63 6c veral files incl
1900: 75 64 65 64 20 69 6e 20 72 65 6c 65 61 73 65 20 uded in release
1910: 74 61 72 62 61 6c 6c 73 20 66 72 6f 6d 20 61 20 tarballs from a
1920: 66 69 6c 65 20 77 69 74 68 20 74 68 65 20 73 61 file with the sa
1930: 6d 65 20 6e 61 6d 65 20 70 6c 75 73 20 61 20 2a me name plus a *
1940: 60 2e 69 6e 60 20 65 78 74 65 6e 73 69 6f 6e 2e `.in` extension.
1950: 0d 0a 0d 0a 2d 20 2a 2a 4a 75 6e 6b 2a 2a 3a 20 ....- **Junk**:
1960: 54 68 65 20 72 65 6c 65 61 73 65 20 74 61 72 62 The release tarb
1970: 61 6c 6c 73 20 73 6f 6d 65 74 69 6d 65 73 20 69 alls sometimes i
1980: 6e 63 6c 75 64 65 64 20 66 69 6c 65 73 20 74 68 ncluded files th
1990: 61 74 20 6e 65 76 65 72 20 73 68 6f 75 6c 64 20 at never should
19a0: 68 61 76 65 20 62 65 65 6e 20 69 6e 63 6c 75 64 have been includ
19b0: 65 64 2c 20 73 75 63 68 20 61 73 20 65 64 69 74 ed, such as edit
19c0: 6f 72 20 74 65 6d 70 6f 72 61 72 69 65 73 2c 20 or temporaries,
19d0: 6f 6c 64 20 62 61 63 6b 75 70 20 66 69 6c 65 73 old backup files
19e0: 2c 20 61 6e 64 20 66 69 6c 65 73 20 74 72 69 76 , and files triv
19f0: 69 61 6c 6c 79 20 67 65 6e 65 72 61 74 65 64 20 ially generated
1a00: 66 72 6f 6d 20 61 6e 6f 74 68 65 72 20 74 68 61 from another tha
1a10: 74 20 77 65 20 77 65 72 65 20 61 6c 72 65 61 64 t we were alread
1a20: 79 20 67 6f 69 6e 67 20 74 6f 20 69 6e 63 6c 75 y going to inclu
1a30: 64 65 2e 0d 0a 0d 0a 53 65 65 20 74 68 65 20 5b de.....See the [
1a40: 69 67 6e 6f 72 65 20 72 75 6c 65 20 6c 69 73 74 ignore rule list
1a50: 5d 5b 69 72 5d 20 69 66 20 79 6f 75 20 77 61 6e ][ir] if you wan
1a60: 74 20 74 6f 20 6b 6e 6f 77 20 77 68 61 74 20 61 t to know what a
1a70: 6c 6c 20 69 73 20 70 75 72 70 6f 73 65 6c 79 20 ll is purposely
1a80: 6d 69 73 73 69 6e 67 20 66 72 6f 6d 20 74 68 65 missing from the
1a90: 20 46 6f 73 73 69 6c 20 72 65 70 6f 73 69 74 6f Fossil reposito
1aa0: 72 79 20 61 73 20 63 6f 6d 70 61 72 65 64 20 74 ry as compared t
1ab0: 6f 20 74 68 65 20 72 65 6c 65 61 73 65 20 74 61 o the release ta
1ac0: 72 62 61 6c 6c 73 2e 0d 0a 0d 0a 54 68 65 72 65 rballs.....There
1ad0: 20 61 72 65 20 74 77 6f 20 70 72 6f 63 65 73 73 are two process
1ae0: 65 73 20 74 68 61 74 20 67 65 6e 65 72 61 74 65 es that generate
1af0: 20 6d 6f 73 74 20 6f 66 20 74 68 65 20 61 62 6f most of the abo
1b00: 76 65 3a 20 74 68 65 20 5b 74 68 65 20 62 6f 6f ve: the [the boo
1b10: 74 73 74 72 61 70 20 70 72 6f 63 65 73 73 5d 28 tstrap process](
1b20: 2f 66 69 6c 65 2f 48 41 43 4b 45 52 53 2e 6d 64 /file/HACKERS.md
1b30: 29 20 61 6e 64 20 60 6d 61 6b 65 20 64 6f 63 60 ) and `make doc`
1b40: 2e 20 45 6e 64 20 75 73 65 72 73 20 6f 66 20 74 . End users of t
1b50: 68 65 20 6c 69 62 72 61 72 79 20 61 72 65 20 6e he library are n
1b60: 6f 74 20 65 78 70 65 63 74 65 64 20 74 6f 20 62 ot expected to b
1b70: 65 20 61 62 6c 65 20 74 6f 20 64 6f 20 65 69 74 e able to do eit
1b80: 68 65 72 20 65 61 73 69 6c 79 2c 20 77 68 65 72 her easily, wher
1b90: 65 61 73 20 77 65 20 64 6f 20 62 75 72 64 65 6e eas we do burden
1ba0: 20 75 73 65 72 73 20 6f 66 20 74 68 65 20 46 6f users of the Fo
1bb0: 73 73 69 6c 20 72 65 70 6f 73 69 74 6f 72 79 20 ssil repository
1bc0: 77 69 74 68 20 74 68 61 74 2e 0d 0a 0d 0a 0d 0a with that.......
1bd0: 23 23 20 43 6f 6d 70 72 65 73 73 69 6f 6e 0d 0a ## Compression..
1be0: 0d 0a 54 68 65 72 65 20 69 73 20 61 20 73 65 63 ..There is a sec
1bf0: 6f 6e 64 20 72 65 61 73 6f 6e 20 66 6f 72 20 74 ond reason for t
1c00: 68 65 20 73 76 65 6c 74 65 20 46 6f 73 73 69 6c he svelte Fossil
1c10: 20 63 6c 6f 6e 65 20 73 69 7a 65 3a 20 46 6f 73 clone size: Fos
1c20: 73 69 6c 20 65 6d 70 6c 6f 79 73 20 61 20 32 2d sil employs a 2-
1c30: 6c 65 76 65 6c 20 63 6f 6d 70 72 65 73 73 69 6f level compressio
1c40: 6e 20 73 63 68 65 6d 65 20 74 68 61 74 20 72 75 n scheme that ru
1c50: 74 68 6c 65 73 73 6c 79 20 73 71 75 69 73 68 65 thlessly squishe
1c60: 73 20 6f 75 74 20 72 65 64 75 6e 64 61 6e 63 79 s out redundancy
1c70: 20 62 65 74 77 65 65 6e 20 63 68 65 63 6b 69 6e between checkin
1c80: 73 2e 0d 0a 0d 0a 54 68 65 20 66 69 72 73 74 20 s.....The first
1c90: 6c 65 76 65 6c 20 69 73 20 5b 64 65 6c 74 61 20 level is [delta
1ca0: 63 6f 6d 70 72 65 73 73 69 6f 6e 5d 28 68 74 74 compression](htt
1cb0: 70 73 3a 2f 2f 77 77 77 2e 66 6f 73 73 69 6c 2d ps://www.fossil-
1cc0: 73 63 6d 2e 6f 72 67 2f 69 6e 64 65 78 2e 68 74 scm.org/index.ht
1cd0: 6d 6c 2f 64 6f 63 2f 74 72 75 6e 6b 2f 77 77 77 ml/doc/trunk/www
1ce0: 2f 64 65 6c 74 61 5f 66 6f 72 6d 61 74 2e 77 69 /delta_format.wi
1cf0: 6b 69 29 2c 20 77 68 69 63 68 20 73 74 6f 72 65 ki), which store
1d00: 73 20 6f 6e 6c 79 20 74 68 65 20 64 69 66 66 65 s only the diffe
1d10: 72 65 6e 63 65 73 20 62 65 74 77 65 65 6e 20 65 rences between e
1d20: 61 63 68 20 66 69 6c 65 20 74 68 61 74 20 65 78 ach file that ex
1d30: 69 73 74 73 20 69 6e 20 65 61 63 68 20 73 69 62 ists in each sib
1d40: 6c 69 6e 67 20 63 68 65 63 6b 69 6e 20 70 61 69 ling checkin pai
1d50: 72 2e 20 49 66 20 61 20 66 69 6c 65 20 6f 6e 6c r. If a file onl
1d60: 79 20 68 61 64 20 61 20 66 65 77 20 63 68 61 72 y had a few char
1d70: 61 63 74 65 72 73 20 61 64 64 65 64 20 74 6f 20 acters added to
1d80: 69 74 20 62 65 74 77 65 65 6e 20 72 65 6c 65 61 it between relea
1d90: 73 65 73 2c 20 6f 6e 6c 79 20 74 68 6f 73 65 20 ses, only those
1da0: 66 65 77 20 63 68 61 72 61 63 74 65 72 73 20 61 few characters a
1db0: 6e 64 20 61 20 62 69 74 20 6f 66 20 6d 65 74 61 nd a bit of meta
1dc0: 64 61 74 61 20 69 73 20 73 74 6f 72 65 64 20 69 data is stored i
1dd0: 6e 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 n the repository
1de0: 2e 0d 0a 0d 0a 4f 6e 20 74 6f 70 20 6f 66 20 74 .....On top of t
1df0: 68 61 74 2c 20 46 6f 73 73 69 6c 20 75 73 65 73 hat, Fossil uses
1e00: 20 5b 67 7a 69 70 20 63 6f 6d 70 72 65 73 73 69 [gzip compressi
1e10: 6f 6e 5d 28 68 74 74 70 73 3a 2f 2f 65 6e 2e 77 on](https://en.w
1e20: 69 6b 69 70 65 64 69 61 2e 6f 72 67 2f 77 69 6b ikipedia.org/wik
1e30: 69 2f 47 7a 69 70 29 20 66 6f 72 20 65 61 63 68 i/Gzip) for each
1e40: 20 73 74 6f 72 65 64 20 61 72 74 69 66 61 63 74 stored artifact
1e50: 2e 20 57 69 74 68 20 61 20 70 72 69 6d 61 72 69 . With a primari
1e60: 6c 79 2d 74 65 78 74 20 62 61 73 65 64 20 72 65 ly-text based re
1e70: 70 6f 73 69 74 6f 72 79 20 6c 69 6b 65 20 74 68 pository like th
1e80: 69 73 20 6f 6e 65 2c 20 74 68 61 74 20 63 61 6e is one, that can
1e90: 20 72 65 73 75 6c 74 20 69 6e 20 68 75 67 65 20 result in huge
1ea0: 73 61 76 69 6e 67 73 2e 0d 0a 0d 0a 41 73 20 6f savings.....As o
1eb0: 66 20 74 68 69 73 20 77 72 69 74 69 6e 67 2c 20 f this writing,
1ec0: 74 68 69 73 20 46 6f 73 73 69 6c 20 72 65 70 6f this Fossil repo
1ed0: 73 69 74 6f 72 79 20 65 6e 6a 6f 79 73 20 61 6e sitory enjoys an
1ee0: 20 6f 76 65 72 61 6c 6c 20 31 31 3a 31 20 63 6f overall 11:1 co
1ef0: 6d 70 72 65 73 73 69 6f 6e 20 72 61 74 69 6f 20 mpression ratio
1f00: 61 73 20 63 6f 6d 70 61 72 65 64 20 74 6f 20 63 as compared to c
1f10: 68 65 63 6b 69 6e 67 20 6f 75 74 20 65 61 63 68 hecking out each
1f20: 20 76 65 72 73 69 6f 6e 20 6f 6e 20 64 69 73 6b version on disk
1f30: 20 73 65 70 61 72 61 74 65 6c 79 2e 0a 5a 20 63 separately..Z c
1f40: 35 31 31 63 33 64 30 34 30 37 66 39 39 33 39 38 511c3d0407f99398
1f50: 35 38 39 39 62 37 35 37 62 36 62 65 38 35 63 0a 5899b757b6be85c.