Documentation Source Text

Hex Artifact Content
Login

Artifact 16988a2f2d9c8a7627276ee04f8e5b2af6e8d37b8b525cfddc7c62c5dd277fd8:


0000: 3c 74 69 74 6c 65 3e 57 68 79 20 53 51 4c 69 74  <title>Why SQLit
0010: 65 20 44 6f 65 73 20 4e 6f 74 20 55 73 65 20 47  e Does Not Use G
0020: 69 74 3f 3c 2f 74 69 74 6c 65 3e 0a 0a 3c 74 61  it?</title>..<ta
0030: 62 6c 65 5f 6f 66 5f 63 6f 6e 74 65 6e 74 73 3e  ble_of_contents>
0040: 0a 0a 3c 68 31 3e 49 6e 74 72 6f 64 75 63 74 69  ..<h1>Introducti
0050: 6f 6e 3c 2f 68 31 3e 0a 0a 3c 70 3e 0a 53 51 4c  on</h1>..<p>.SQL
0060: 69 74 65 20 64 6f 65 73 20 6e 6f 74 20 75 73 65  ite does not use
0070: 20 74 68 65 0a 5b 68 74 74 70 73 3a 2f 2f 67 69   the.[https://gi
0080: 74 2d 73 63 6d 2e 6f 72 67 7c 47 69 74 5d 20 76  t-scm.org|Git] v
0090: 65 72 73 69 6f 6e 20 63 6f 6e 74 72 6f 6c 20 73  ersion control s
00a0: 79 73 74 65 6d 2e 0a 53 51 4c 69 74 65 20 75 73  ystem..SQLite us
00b0: 65 73 0a 5b 68 74 74 70 73 3a 2f 2f 66 6f 73 73  es.[https://foss
00c0: 69 6c 2d 73 63 6d 2e 6f 72 67 2f 7c 46 6f 73 73  il-scm.org/|Foss
00d0: 69 6c 5d 20 69 6e 73 74 65 61 64 2e 0a 46 6f 73  il] instead..Fos
00e0: 73 69 6c 20 61 6e 64 20 47 69 74 20 61 72 65 20  sil and Git are 
00f0: 62 6f 74 68 20 62 6c 6f 63 6b 2d 63 68 61 69 6e  both block-chain
0100: 20 76 65 72 73 69 6f 6e 2d 63 6f 6e 74 72 6f 6c   version-control
0110: 20 73 79 73 74 65 6d 73 2e 0a 54 68 65 79 20 61   systems..They a
0120: 72 65 20 62 6f 74 68 20 22 64 69 73 74 72 69 62  re both "distrib
0130: 75 74 65 64 22 2e 20 20 54 68 65 79 20 62 6f 74  uted".  They bot
0140: 68 20 73 74 6f 72 65 20 63 6f 6e 74 65 6e 74 20  h store content 
0150: 68 61 73 20 61 20 0a 73 65 71 75 65 6e 63 65 20  has a .sequence 
0160: 6f 66 20 69 6d 6d 75 74 61 62 6c 65 20 63 68 65  of immutable che
0170: 63 6b 2d 69 6e 73 20 69 64 65 6e 74 69 66 69 65  ck-ins identifie
0180: 64 20 62 79 20 61 20 63 72 79 70 74 6f 67 72 61  d by a cryptogra
0190: 70 68 69 63 0a 68 61 73 68 2e 20 20 47 69 74 20  phic.hash.  Git 
01a0: 69 73 20 77 69 6c 64 6c 79 20 70 6f 70 75 6c 61  is wildly popula
01b0: 72 2c 20 74 6f 20 74 68 65 20 70 6f 69 6e 74 20  r, to the point 
01c0: 74 68 61 74 20 6d 61 6e 79 20 79 6f 75 6e 67 65  that many younge
01d0: 72 0a 64 65 76 65 6c 6f 70 65 72 73 20 61 72 65  r.developers are
01e0: 20 66 61 6d 69 6c 69 61 72 20 77 69 74 68 20 6e   familiar with n
01f0: 6f 74 68 69 6e 67 20 65 6c 73 65 2e 20 20 41 6e  othing else.  An
0200: 64 20 79 65 74 2c 20 74 68 65 20 64 65 76 65 6c  d yet, the devel
0210: 6f 70 65 72 73 0a 6f 66 20 53 51 4c 69 74 65 20  opers.of SQLite 
0220: 70 72 65 66 65 72 20 46 6f 73 73 69 6c 2e 20 20  prefer Fossil.  
0230: 54 68 69 73 20 61 72 74 69 63 6c 65 20 74 72 69  This article tri
0240: 65 73 20 74 6f 20 65 78 70 6c 61 69 6e 20 77 68  es to explain wh
0250: 79 2e 0a 0a 3c 68 31 3e 41 20 46 65 77 20 52 65  y...<h1>A Few Re
0260: 61 73 6f 6e 73 20 57 68 79 20 53 51 4c 69 74 65  asons Why SQLite
0270: 20 44 6f 65 73 20 4e 6f 74 20 55 73 65 20 47 69   Does Not Use Gi
0280: 74 3c 2f 68 31 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69  t</h1>..<ol>.<li
0290: 3e 3c 70 3e 0a 57 69 74 68 20 47 69 74 2c 20 69  ><p>.With Git, i
02a0: 74 20 69 73 20 76 65 72 79 20 64 69 66 66 69 63  t is very diffic
02b0: 75 6c 74 20 74 6f 20 66 69 6e 64 20 74 68 65 20  ult to find the 
02c0: 73 75 63 63 65 73 73 6f 72 73 20 28 64 65 63 65  successors (dece
02d0: 6e 64 65 6e 74 73 29 20 6f 66 0a 61 20 63 68 65  ndents) of.a che
02e0: 63 6b 2d 69 6e 2e 0a 0a 3c 70 3e 0a 47 69 74 20  ck-in...<p>.Git 
02f0: 61 6c 6c 6f 77 73 20 79 6f 75 20 74 6f 20 67 6f  allows you to go
0300: 20 62 61 63 6b 77 61 72 64 73 20 69 6e 20 74 69   backwards in ti
0310: 6d 65 2e 20 20 47 69 76 65 6e 20 74 68 65 20 6c  me.  Given the l
0320: 61 74 65 73 74 0a 63 68 65 63 6b 2d 69 6e 20 6f  atest.check-in o
0330: 6e 20 61 20 62 72 61 6e 63 68 2c 20 47 69 74 20  n a branch, Git 
0340: 6c 65 74 73 20 79 6f 75 20 73 65 65 20 61 6c 6c  lets you see all
0350: 20 74 68 65 20 61 6e 63 65 73 74 6f 72 73 20 6f   the ancestors o
0360: 66 20 74 68 61 74 0a 63 68 65 63 6b 2d 69 6e 2e  f that.check-in.
0370: 20 20 42 75 74 20 47 69 74 20 6d 61 6b 65 73 20    But Git makes 
0380: 69 74 20 76 65 72 79 20 64 69 66 66 69 63 75 6c  it very difficul
0390: 74 20 74 6f 20 6d 6f 76 65 20 69 6e 20 74 68 65  t to move in the
03a0: 20 6f 74 68 65 72 0a 64 69 72 65 63 74 69 6f 6e   other.direction
03b0: 2e 20 20 47 69 76 65 6e 20 73 6f 6d 65 20 68 69  .  Given some hi
03c0: 73 74 6f 72 69 63 61 6c 20 63 68 65 63 6b 2d 69  storical check-i
03d0: 6e 2c 20 69 74 20 69 73 20 71 75 69 74 65 20 63  n, it is quite c
03e0: 68 61 6c 6c 65 6e 67 69 6e 67 0a 69 6e 20 47 69  hallenging.in Gi
03f0: 74 20 74 6f 20 66 69 6e 64 20 6f 75 74 20 77 68  t to find out wh
0400: 61 74 20 63 61 6d 65 20 6e 65 78 74 2e 20 20 49  at came next.  I
0410: 74 20 63 61 6e 20 62 65 20 64 6f 6e 65 2c 20 62  t can be done, b
0420: 75 74 20 69 74 20 69 73 20 73 75 66 66 69 63 69  ut it is suffici
0430: 65 6e 74 6c 79 0a 64 69 66 66 69 63 75 6c 74 20  ently.difficult 
0440: 61 6e 64 20 73 6c 6f 77 20 74 68 61 74 20 6e 6f  and slow that no
0450: 62 6f 64 79 20 65 76 65 72 20 64 6f 65 73 20 69  body ever does i
0460: 74 2e 20 20 54 68 65 72 65 20 69 73 20 6e 6f 20  t.  There is no 
0470: 62 75 74 74 6f 6e 20 69 6e 0a 47 69 74 48 75 62  button in.GitHub
0480: 20 74 68 61 74 20 73 68 6f 77 73 20 74 68 65 20   that shows the 
0490: 64 65 73 63 65 6e 64 65 6e 74 73 20 6f 66 20 61  descendents of a
04a0: 20 63 68 65 63 6b 2d 69 6e 2e 0a 0a 3c 70 3e 0a   check-in...<p>.
04b0: 54 68 69 73 20 69 73 20 61 20 64 65 61 6c 2d 62  This is a deal-b
04c0: 72 65 61 6b 65 72 2c 20 61 20 73 68 6f 77 2d 73  reaker, a show-s
04d0: 74 6f 70 70 65 72 2e 20 20 54 68 65 20 70 72 69  topper.  The pri
04e0: 6e 63 69 70 6c 65 20 6d 61 69 6e 74 61 69 6e 65  nciple maintaine
04f0: 72 0a 6f 66 20 53 51 4c 69 74 65 20 63 61 6e 6e  r.of SQLite cann
0500: 6f 74 20 66 75 6e 63 74 69 6f 6e 20 65 66 66 65  ot function effe
0510: 63 74 69 76 65 6c 79 20 77 69 74 68 6f 75 74 20  ctively without 
0520: 62 65 69 6e 67 20 61 62 6c 65 20 74 6f 20 76 69  being able to vi
0530: 65 77 0a 74 68 65 20 73 75 63 63 65 73 73 6f 72  ew.the successor
0540: 73 20 6f 66 20 61 20 63 68 65 63 6b 2d 69 6e 2e  s of a check-in.
0550: 20 20 54 68 69 73 20 6f 6e 65 20 69 73 73 75 65    This one issue
0560: 20 69 73 20 73 75 66 66 69 63 69 65 6e 74 20 72   is sufficient r
0570: 65 61 73 6f 6e 0a 74 6f 20 6e 6f 74 20 75 73 65  eason.to not use
0580: 20 47 69 74 2c 20 69 6e 20 74 68 65 20 76 69 65   Git, in the vie
0590: 77 20 6f 66 20 74 68 65 20 64 65 73 69 67 6e 65  w of the designe
05a0: 72 20 6f 66 20 53 51 4c 69 74 65 2e 0a 0a 3c 6c  r of SQLite...<l
05b0: 69 3e 3c 70 3e 0a 54 68 65 20 6d 65 6e 74 61 6c  i><p>.The mental
05c0: 20 6d 6f 64 65 6c 20 66 6f 72 20 47 69 74 20 69   model for Git i
05d0: 73 20 6e 65 65 64 6c 65 73 73 6c 79 20 63 6f 6d  s needlessly com
05e0: 70 6c 65 78 20 61 6e 64 20 63 6f 6e 73 65 71 75  plex and consequ
05f0: 65 6e 74 6c 79 0a 64 69 73 74 72 61 63 74 73 20  ently.distracts 
0600: 61 74 74 65 6e 74 69 6f 6e 20 66 72 6f 6d 20 73  attention from s
0610: 6f 66 74 77 61 72 65 20 75 6e 64 65 72 20 64 65  oftware under de
0620: 76 65 6c 6f 70 6d 65 6e 74 2e 20 20 41 20 75 73  velopment.  A us
0630: 65 72 20 6f 66 20 47 69 74 0a 6e 65 65 64 73 20  er of Git.needs 
0640: 74 6f 20 6b 65 65 70 20 61 6c 6c 20 6f 66 20 74  to keep all of t
0650: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 6e 20  he following in 
0660: 6d 69 6e 64 3a 0a 3c 6f 6c 20 74 79 70 65 3d 27  mind:.<ol type='
0670: 61 27 3e 0a 3c 6c 69 3e 20 54 68 65 20 77 6f 72  a'>.<li> The wor
0680: 6b 69 6e 67 20 64 69 72 65 63 74 6f 72 79 0a 3c  king directory.<
0690: 6c 69 3e 20 54 68 65 20 22 69 6e 64 65 78 22 20  li> The "index" 
06a0: 6f 72 20 73 74 61 67 69 6e 67 20 61 72 65 61 0a  or staging area.
06b0: 3c 6c 69 3e 20 54 68 65 20 6c 6f 63 61 6c 20 68  <li> The local h
06c0: 65 61 64 0a 3c 6c 69 3e 20 54 68 65 20 6c 6f 63  ead.<li> The loc
06d0: 61 6c 20 63 6f 70 79 20 6f 66 20 74 68 65 20 72  al copy of the r
06e0: 65 6d 6f 74 65 20 68 65 61 64 0a 3c 6c 69 3e 20  emote head.<li> 
06f0: 54 68 65 20 61 63 74 75 61 6c 20 72 65 6d 6f 74  The actual remot
0700: 65 20 68 65 61 64 0a 3c 2f 6f 6c 3e 0a 3c 70 3e  e head.</ol>.<p>
0710: 0a 47 69 74 20 63 6f 6e 74 61 69 6e 73 20 63 6f  .Git contains co
0720: 6d 6d 61 6e 64 73 20 28 6f 72 20 6f 70 74 69 6f  mmands (or optio
0730: 6e 73 20 6f 6e 20 63 6f 6d 6d 61 6e 64 73 29 20  ns on commands) 
0740: 66 6f 72 20 6d 6f 76 69 6e 67 20 61 6e 64 0a 63  for moving and.c
0750: 6f 6d 70 61 72 69 6e 67 20 63 6f 6e 74 65 6e 74  omparing content
0760: 20 62 65 74 77 65 65 6e 20 61 6c 6c 20 6f 66 20   between all of 
0770: 74 68 65 73 65 20 6c 6f 63 61 74 69 6f 6e 73 2e  these locations.
0780: 20 0a 0a 3c 70 3e 49 6e 20 63 6f 6e 74 72 61 73   ..<p>In contras
0790: 74 2c 0a 46 6f 73 73 69 6c 20 75 73 65 72 73 20  t,.Fossil users 
07a0: 6f 6e 6c 79 20 6e 65 65 64 20 74 6f 20 74 68 69  only need to thi
07b0: 6e 6b 20 61 62 6f 75 74 20 74 68 65 69 72 20 77  nk about their w
07c0: 6f 72 6b 69 6e 67 20 64 69 72 65 63 74 6f 72 79  orking directory
07d0: 20 61 6e 64 0a 74 68 65 20 63 68 65 63 6b 2d 69   and.the check-i
07e0: 6e 20 74 68 65 79 20 61 72 65 20 77 6f 72 6b 69  n they are worki
07f0: 6e 67 20 6f 6e 2e 20 20 54 68 61 74 20 69 73 20  ng on.  That is 
0800: 36 30 25 20 6c 65 73 73 20 64 69 73 74 72 61 63  60% less distrac
0810: 74 69 6f 6e 2e 0a 45 76 65 72 79 20 64 65 76 65  tion..Every deve
0820: 6c 6f 70 65 72 20 68 61 73 20 61 20 66 69 6e 69  loper has a fini
0830: 74 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 72 61  te number of bra
0840: 69 6e 2d 63 79 63 6c 65 73 2e 20 20 46 6f 73 73  in-cycles.  Foss
0850: 69 6c 0a 72 65 71 75 69 72 65 73 20 66 65 77 65  il.requires fewe
0860: 72 20 62 72 61 69 6e 2d 63 79 63 6c 65 73 20 74  r brain-cycles t
0870: 6f 20 6f 70 65 72 61 74 65 2c 20 74 68 75 73 20  o operate, thus 
0880: 66 72 65 65 69 6e 67 20 75 70 20 0a 69 6e 74 65  freeing up .inte
0890: 6c 6c 65 63 74 75 61 6c 20 72 65 73 6f 75 72 63  llectual resourc
08a0: 65 73 20 74 6f 20 66 6f 63 75 73 20 6f 6e 20 74  es to focus on t
08b0: 68 65 20 73 6f 66 74 77 61 72 65 20 75 6e 64 65  he software unde
08c0: 72 20 64 65 76 65 6c 6f 70 6d 65 6e 74 2e 0a 0a  r development...
08d0: 3c 6c 69 3e 3c 70 3e 0a 47 69 74 20 64 6f 65 73  <li><p>.Git does
08e0: 20 6e 6f 74 20 74 72 61 63 6b 20 62 72 61 6e 63   not track branc
08f0: 68 20 68 69 73 74 6f 72 79 2e 20 20 54 68 69 73  h history.  This
0900: 20 6d 61 6b 65 73 20 72 65 76 69 65 77 20 6f 66   makes review of
0910: 20 68 69 73 74 6f 72 69 63 61 6c 0a 62 72 61 6e   historical.bran
0920: 63 68 65 73 20 74 65 64 69 6f 75 73 2e 0a 0a 3c  ches tedious...<
0930: 70 3e 0a 41 73 20 61 6e 20 65 78 61 6d 70 6c 65  p>.As an example
0940: 2c 20 63 6f 6e 73 69 64 65 72 20 64 69 73 70 6c  , consider displ
0950: 61 79 20 6f 66 20 61 20 73 69 6e 67 6c 65 20 68  ay of a single h
0960: 69 73 74 6f 72 69 63 61 6c 0a 62 72 61 6e 63 68  istorical.branch
0970: 20 6f 66 20 53 51 4c 69 74 65 20 61 73 20 72 65   of SQLite as re
0980: 6e 64 65 72 65 64 20 62 79 20 47 69 74 48 75 62  ndered by GitHub
0990: 20 61 6e 64 20 62 79 20 46 6f 73 73 69 6c 3a 0a   and by Fossil:.
09a0: 0a 3c 75 6c 3e 0a 3c 6c 69 3e 3c 62 3e 47 69 74  .<ul>.<li><b>Git
09b0: 48 75 62 3a 3c 2f 62 3e 20 5b 68 74 74 70 73 3a  Hub:</b> [https:
09c0: 2f 2f 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 61 63  //github.com/mac
09d0: 6b 79 6c 65 2f 73 71 6c 69 74 65 2f 63 6f 6d 6d  kyle/sqlite/comm
09e0: 69 74 73 2f 70 72 65 66 65 72 2d 63 6f 72 6f 75  its/prefer-corou
09f0: 74 69 6e 65 2d 73 6f 72 74 2d 73 75 62 71 75 65  tine-sort-subque
0a00: 72 79 5d 0a 3c 6c 69 3e 3c 62 3e 46 6f 73 73 69  ry].<li><b>Fossi
0a10: 6c 3a 3c 2f 62 3e 20 5b 68 74 74 70 73 3a 2f 2f  l:</b> [https://
0a20: 73 71 6c 69 74 65 2e 6f 72 67 2f 73 72 63 2f 74  sqlite.org/src/t
0a30: 69 6d 65 6c 69 6e 65 3f 72 3d 70 72 65 66 65 72  imeline?r=prefer
0a40: 2d 63 6f 72 6f 75 74 69 6e 65 2d 73 6f 72 74 2d  -coroutine-sort-
0a50: 73 75 62 71 75 65 72 79 5d 0a 3c 2f 75 6c 3e 0a  subquery].</ul>.
0a60: 0a 3c 70 3e 0a 54 68 65 20 46 6f 73 73 69 6c 20  .<p>.The Fossil 
0a70: 76 69 65 77 20 63 6c 65 61 72 6c 79 20 73 68 6f  view clearly sho
0a80: 77 73 20 74 68 61 74 20 74 68 65 20 62 72 61 6e  ws that the bran
0a90: 63 68 20 77 61 73 20 65 76 65 6e 74 75 61 6c 6c  ch was eventuall
0aa0: 79 20 6d 65 72 67 65 64 20 62 61 63 6b 20 69 6e  y merged back in
0ab0: 74 6f 0a 74 72 75 6e 6b 2e 20 20 49 74 20 73 68  to.trunk.  It sh
0ac0: 6f 77 73 20 77 68 65 72 65 20 74 68 65 20 62 72  ows where the br
0ad0: 61 6e 63 68 20 73 74 61 72 74 65 64 2c 20 61 6e  anch started, an
0ae0: 64 20 69 74 20 73 68 6f 77 73 20 74 77 6f 20 6f  d it shows two o
0af0: 63 63 61 73 69 6f 6e 73 20 77 68 65 72 65 20 63  ccasions where c
0b00: 68 61 6e 67 65 73 0a 6f 6e 20 74 72 75 6e 6b 20  hanges.on trunk 
0b10: 77 65 72 65 20 6d 65 72 67 65 64 20 69 6e 74 6f  were merged into
0b20: 20 74 68 65 20 62 72 61 6e 63 68 2e 20 20 47 69   the branch.  Gi
0b30: 74 48 75 62 20 73 68 6f 77 73 20 6e 6f 6e 65 20  tHub shows none 
0b40: 6f 66 20 74 68 69 73 2e 20 20 49 6e 20 66 61 63  of this.  In fac
0b50: 74 2c 20 74 68 65 0a 47 69 74 48 75 62 20 64 69  t, the.GitHub di
0b60: 73 70 6c 61 79 20 69 73 20 6d 6f 73 74 6c 79 20  splay is mostly 
0b70: 75 73 65 6c 65 73 73 20 69 6e 20 74 72 79 69 6e  useless in tryin
0b80: 67 20 74 6f 20 66 69 67 75 72 65 20 6f 75 74 20  g to figure out 
0b90: 77 68 61 74 20 68 61 70 70 65 6e 65 64 2e 0a 0a  what happened...
0ba0: 3c 6c 69 3e 3c 70 3e 0a 47 69 74 20 6c 61 63 6b  <li><p>.Git lack
0bb0: 73 20 6e 61 74 69 76 65 20 77 69 6b 69 20 61 6e  s native wiki an
0bc0: 64 20 62 75 67 20 74 72 61 63 6b 69 6e 67 2e 0a  d bug tracking..
0bd0: 49 66 20 79 6f 75 20 77 61 6e 74 20 74 68 65 73  If you want thes
0be0: 65 20 65 73 73 65 6e 74 69 61 6c 20 66 65 61 74  e essential feat
0bf0: 75 72 65 73 2c 20 79 6f 75 20 68 61 76 65 20 74  ures, you have t
0c00: 6f 20 69 6e 73 74 61 6c 6c 20 61 64 64 69 74 69  o install additi
0c10: 6f 6e 61 6c 20 73 6f 66 74 77 61 72 65 0a 73 75  onal software.su
0c20: 63 68 20 61 73 20 47 69 74 4c 61 62 2c 20 6f 72  ch as GitLab, or
0c30: 20 65 6c 73 65 20 75 73 65 20 61 20 74 68 69 72   else use a thir
0c40: 64 2d 70 61 72 74 79 20 73 65 72 76 69 63 65 20  d-party service 
0c50: 73 75 63 68 20 61 73 20 47 69 74 48 75 62 2e 20  such as GitHub. 
0c60: 20 41 6e 64 20 65 76 65 6e 0a 74 68 65 6e 2c 20   And even.then, 
0c70: 74 68 65 20 77 69 6b 69 20 61 6e 64 20 62 75 67  the wiki and bug
0c80: 20 72 65 70 6f 72 74 73 20 61 72 65 20 63 65 6e   reports are cen
0c90: 74 72 61 6c 69 7a 65 64 2c 20 6e 6f 74 20 64 69  tralized, not di
0ca0: 73 74 72 69 62 75 74 65 64 2e 0a 0a 3c 6c 69 3e  stributed...<li>
0cb0: 3c 70 3e 0a 47 69 74 20 72 65 71 75 69 72 65 73  <p>.Git requires
0cc0: 20 6d 6f 72 65 20 61 64 6d 69 6e 69 73 74 72 61   more administra
0cd0: 74 69 76 65 20 73 75 70 70 6f 72 74 2e 0a 53 65  tive support..Se
0ce0: 74 74 69 6e 67 20 75 70 20 61 20 77 65 62 73 69  tting up a websi
0cf0: 74 65 20 66 6f 72 20 61 20 70 72 6f 6a 65 63 74  te for a project
0d00: 20 74 6f 20 75 73 65 20 47 69 74 20 72 65 71 75   to use Git requ
0d10: 69 72 65 73 20 61 20 6c 6f 74 20 6d 6f 72 65 20  ires a lot more 
0d20: 73 6f 66 74 77 61 72 65 2c 0a 61 6e 64 20 61 20  software,.and a 
0d30: 6c 6f 74 20 6d 6f 72 65 20 77 6f 72 6b 2c 20 74  lot more work, t
0d40: 68 61 6e 20 73 65 74 74 69 6e 67 20 75 70 20 61  han setting up a
0d50: 20 73 69 6d 69 6c 61 72 20 73 69 74 65 20 77 69   similar site wi
0d60: 74 68 20 61 6e 20 69 6e 74 65 67 72 61 74 65 64  th an integrated
0d70: 20 70 61 63 6b 61 67 65 0a 6c 69 6b 65 20 46 6f   package.like Fo
0d80: 73 73 69 6c 2e 0a 0a 3c 6c 69 3e 3c 70 3e 4e 6f  ssil...<li><p>No
0d90: 62 6f 64 79 20 72 65 61 6c 6c 79 20 75 6e 64 65  body really unde
0da0: 72 73 74 61 6e 64 73 20 47 69 74 2e 0a 3c 69 6d  rstands Git..<im
0db0: 67 20 73 72 63 3d 22 68 74 74 70 73 3a 2f 2f 77  g src="https://w
0dc0: 77 77 2e 66 6f 73 73 69 6c 2d 73 63 6d 2e 6f 72  ww.fossil-scm.or
0dd0: 67 2f 66 6f 73 73 69 6c 2f 64 6f 63 2f 74 72 75  g/fossil/doc/tru
0de0: 6e 6b 2f 77 77 77 2f 78 6b 63 64 2d 67 69 74 2e  nk/www/xkcd-git.
0df0: 67 69 66 22 3e 3c 62 72 3e 0a 28 63 72 65 64 69  gif"><br>.(credi
0e00: 74 3a 20 5b 68 74 74 70 73 3a 2f 2f 78 6b 63 64  t: [https://xkcd
0e10: 2e 63 6f 6d 2f 31 35 39 37 2f 5d 29 0a 3c 2f 6f  .com/1597/]).</o
0e20: 6c 3e 0a 0a 3c 68 32 3e 53 65 65 20 41 6c 73 6f  l>..<h2>See Also
0e30: 3c 2f 68 32 3e 0a 0a 3c 70 3e 4f 74 68 65 72 20  </h2>..<p>Other 
0e40: 70 61 67 65 73 20 74 68 61 74 20 74 61 6c 6b 20  pages that talk 
0e50: 61 62 6f 75 74 20 46 6f 73 73 69 6c 20 61 6e 64  about Fossil and
0e60: 20 47 69 74 20 69 6e 63 6c 75 64 65 3a 0a 3c 75   Git include:.<u
0e70: 6c 3e 0a 3c 6c 69 3e 3c 70 3e 5b 68 74 74 70 73  l>.<li><p>[https
0e80: 3a 2f 2f 66 6f 73 73 69 6c 2d 73 63 6d 2e 6f 72  ://fossil-scm.or
0e90: 67 2f 66 6f 73 73 69 6c 2f 64 6f 63 2f 74 72 75  g/fossil/doc/tru
0ea0: 6e 6b 2f 77 77 77 2f 66 6f 73 73 69 6c 2d 76 2d  nk/www/fossil-v-
0eb0: 67 69 74 2e 77 69 6b 69 7c 46 6f 73 73 69 6c 20  git.wiki|Fossil 
0ec0: 76 73 2e 20 47 69 74 5d 0a 3c 6c 69 3e 3c 70 3e  vs. Git].<li><p>
0ed0: 5b 68 74 74 70 73 3a 2f 2f 77 77 77 2e 66 6f 73  [https://www.fos
0ee0: 73 69 6c 2d 73 63 6d 2e 6f 72 67 2f 66 6f 73 73  sil-scm.org/foss
0ef0: 69 6c 2f 64 6f 63 2f 74 72 75 6e 6b 2f 77 77 77  il/doc/trunk/www
0f00: 2f 71 75 6f 74 65 73 2e 77 69 6b 69 7c 57 68 61  /quotes.wiki|Wha
0f10: 74 20 6f 74 68 65 72 73 20 73 61 79 20 61 62 6f  t others say abo
0f20: 75 74 20 46 6f 73 73 69 6c 20 61 6e 64 20 47 69  ut Fossil and Gi
0f30: 74 5d 0a 3c 2f 75 6c 3e 0a 0a 3c 68 31 3e 41 20  t].</ul>..<h1>A 
0f40: 47 69 74 2d 55 73 65 72 27 73 20 47 75 69 64 65  Git-User's Guide
0f50: 20 54 6f 20 41 63 63 65 73 73 69 6e 67 20 53 51   To Accessing SQ
0f60: 4c 69 74 65 20 53 6f 75 72 63 65 20 43 6f 64 65  Lite Source Code
0f70: 3c 2f 68 31 3e 0a 0a 3c 70 3e 0a 49 66 20 79 6f  </h1>..<p>.If yo
0f80: 75 20 61 72 65 20 61 20 64 65 76 6f 74 65 64 20  u are a devoted 
0f90: 47 69 74 20 75 73 65 72 20 61 6e 64 20 68 61 76  Git user and hav
0fa0: 65 20 6e 6f 20 69 6e 74 65 6e 74 69 6f 6e 20 6f  e no intention o
0fb0: 66 20 63 68 61 6e 67 69 6e 67 2c 0a 79 6f 75 20  f changing,.you 
0fc0: 63 61 6e 20 73 74 69 6c 6c 20 65 61 73 69 6c 79  can still easily
0fd0: 20 61 63 63 65 73 73 20 53 51 4c 69 74 65 2e 20   access SQLite. 
0fe0: 20 54 68 69 73 20 73 65 63 74 69 6f 6e 20 67 69   This section gi
0ff0: 76 65 73 20 73 6f 6d 65 20 68 69 6e 74 73 0a 6f  ves some hints.o
1000: 6e 20 68 6f 77 20 74 6f 20 64 6f 20 73 6f 2e 0a  n how to do so..
1010: 0a 3c 68 32 3e 47 69 74 48 75 62 20 4d 69 72 72  .<h2>GitHub Mirr
1020: 6f 72 73 3c 2f 68 32 3e 0a 0a 3c 70 3e 0a 54 68  ors</h2>..<p>.Th
1030: 65 72 65 20 69 73 20 61 20 6d 69 72 72 6f 72 20  ere is a mirror 
1040: 6f 66 20 74 68 65 20 53 51 4c 69 74 65 20 73 6f  of the SQLite so
1050: 75 72 63 65 20 74 72 65 65 20 6f 6e 20 47 69 74  urce tree on Git
1060: 48 75 62 20 61 74 0a 5b 68 74 74 70 73 3a 2f 2f  Hub at.[https://
1070: 67 69 74 68 75 62 2e 63 6f 6d 2f 6d 61 63 6b 79  github.com/macky
1080: 6c 65 2f 73 71 6c 69 74 65 5d 2e 20 20 54 68 69  le/sqlite].  Thi
1090: 73 20 6d 69 72 72 6f 72 20 69 73 20 6d 61 69 6e  s mirror is main
10a0: 74 61 69 6e 65 64 0a 62 79 20 75 73 65 72 20 22  tained.by user "
10b0: 6d 61 63 6b 79 6c 65 22 20 77 68 6f 20 69 73 20  mackyle" who is 
10c0: 75 6e 61 66 66 69 6c 69 61 74 65 64 20 77 69 74  unaffiliated wit
10d0: 68 2c 20 61 6e 64 20 75 6e 6b 6e 6f 77 6e 20 74  h, and unknown t
10e0: 6f 2c 0a 74 68 65 20 6f 66 66 69 63 69 61 6c 20  o,.the official 
10f0: 53 51 4c 69 74 65 20 64 65 76 65 6c 6f 70 6d 65  SQLite developme
1100: 6e 74 20 74 65 61 6d 2e 20 20 57 65 20 64 6f 20  nt team.  We do 
1110: 6e 6f 74 20 6b 6e 6f 77 20 6d 61 63 6b 79 6c 65  not know mackyle
1120: 2c 0a 62 75 74 20 77 65 20 6f 62 73 65 72 76 65  ,.but we observe
1130: 20 74 68 61 74 20 68 65 20 64 6f 65 73 20 61 20   that he does a 
1140: 74 65 72 72 69 66 69 63 20 6a 6f 62 20 6f 66 20  terrific job of 
1150: 6b 65 65 70 69 6e 67 20 68 69 73 20 6d 69 72 72  keeping his mirr
1160: 6f 72 0a 63 75 72 72 65 6e 74 2c 20 61 6e 64 20  or.current, and 
1170: 73 6f 20 69 66 20 79 6f 75 20 77 61 6e 74 20 74  so if you want t
1180: 6f 20 61 63 63 65 73 73 20 74 68 65 20 53 51 4c  o access the SQL
1190: 69 74 65 20 73 6f 75 72 63 65 20 63 6f 64 65 20  ite source code 
11a0: 6f 6e 0a 47 69 74 48 75 62 2c 20 68 69 73 20 6d  on.GitHub, his m
11b0: 69 72 72 6f 72 20 69 73 20 74 68 65 20 72 65 63  irror is the rec
11c0: 6f 6d 6d 65 6e 64 65 64 20 73 6f 75 72 63 65 2e  ommended source.
11d0: 0a 0a 3c 68 32 3e 57 65 62 20 41 63 63 65 73 73  ..<h2>Web Access
11e0: 3c 2f 68 32 3e 0a 0a 3c 70 3e 0a 54 68 65 20 5b  </h2>..<p>.The [
11f0: 68 74 74 70 73 3a 2f 2f 73 71 6c 69 74 65 2e 6f  https://sqlite.o
1200: 72 67 2f 73 72 63 2f 74 69 6d 65 6c 69 6e 65 7c  rg/src/timeline|
1210: 53 51 4c 69 74 65 20 46 6f 73 73 69 6c 20 52 65  SQLite Fossil Re
1220: 70 6f 73 69 74 6f 72 79 5d 20 63 6f 6e 74 61 69  pository] contai
1230: 6e 73 20 6c 69 6e 6b 73 0a 66 6f 72 20 64 6f 77  ns links.for dow
1240: 6e 6c 6f 61 64 69 6e 67 20 20 61 20 54 61 72 62  nloading  a Tarb
1250: 61 6c 6c 2c 20 5a 49 50 20 41 72 63 68 69 76 65  all, ZIP Archive
1260: 2c 20 6f 72 20 5b 53 51 4c 69 74 65 20 41 72 63  , or [SQLite Arc
1270: 68 69 76 65 5d 20 66 6f 72 20 61 6e 79 0a 68 69  hive] for any.hi
1280: 73 74 6f 72 69 63 61 6c 20 76 65 72 73 69 6f 6e  storical version
1290: 20 6f 66 20 53 51 4c 69 74 65 2e 20 20 54 68 65   of SQLite.  The
12a0: 20 55 52 4c 73 20 66 6f 72 20 74 68 65 73 65 20   URLs for these 
12b0: 64 6f 77 6e 6c 6f 61 64 73 20 61 72 65 0a 73 69  downloads are.si
12c0: 6d 70 6c 65 20 61 6e 64 20 63 61 6e 20 62 65 20  mple and can be 
12d0: 69 6e 63 6f 72 70 6f 72 61 74 65 64 20 65 61 73  incorporated eas
12e0: 69 6c 79 20 69 6e 74 6f 20 61 75 74 6f 6d 61 74  ily into automat
12f0: 65 64 20 74 6f 6f 6c 73 2e 20 20 54 68 65 20 66  ed tools.  The f
1300: 6f 72 6d 61 74 20 69 73 3a 0a 0a 3c 63 65 6e 74  ormat is:..<cent
1310: 65 72 3e 0a 3c 74 74 3e 68 74 74 70 73 3a 2f 2f  er>.<tt>https://
1320: 73 71 6c 69 74 65 2e 6f 72 67 2f 73 72 63 2f 74  sqlite.org/src/t
1330: 61 72 62 61 6c 6c 2f 3c 2f 74 74 3e 3c 69 3e 56  arball/</tt><i>V
1340: 45 52 53 49 4f 4e 3c 2f 69 3e 3c 74 74 3e 2f 73  ERSION</i><tt>/s
1350: 71 6c 69 74 65 2e 74 61 72 2e 67 7a 3c 2f 74 74  qlite.tar.gz</tt
1360: 3e 0a 3c 2f 63 65 6e 74 65 72 3e 0a 0a 3c 70 3e  >.</center>..<p>
1370: 0a 53 69 6d 70 6c 79 20 72 65 70 6c 61 63 65 20  .Simply replace 
1380: 3c 69 3e 56 45 52 53 49 4f 4e 3c 2f 69 3e 20 77  <i>VERSION</i> w
1390: 69 74 68 20 73 6f 6d 65 20 64 65 73 63 72 69 70  ith some descrip
13a0: 74 69 6f 6e 20 6f 66 20 74 68 65 20 76 65 72 73  tion of the vers
13b0: 69 6f 6e 20 74 6f 20 62 65 0a 64 6f 77 6e 6c 6f  ion to be.downlo
13c0: 61 64 65 64 2e 20 20 54 68 65 20 3c 69 3e 56 45  aded.  The <i>VE
13d0: 52 53 49 4f 4e 3c 2f 69 3e 20 63 61 6e 20 62 65  RSION</i> can be
13e0: 20 61 20 70 72 65 66 69 78 20 6f 66 20 74 68 65   a prefix of the
13f0: 20 63 72 79 70 74 6f 67 72 61 70 68 69 63 20 68   cryptographic h
1400: 61 73 68 0a 6e 61 6d 65 20 6f 66 20 61 20 73 70  ash.name of a sp
1410: 65 63 69 66 69 63 20 63 68 65 63 6b 2d 69 6e 2c  ecific check-in,
1420: 20 6f 72 20 74 68 65 20 6e 61 6d 65 20 6f 66 20   or the name of 
1430: 61 20 62 72 61 6e 63 68 20 28 69 6e 20 77 68 69  a branch (in whi
1440: 63 68 20 63 61 73 65 20 74 68 65 0a 6d 6f 73 74  ch case the.most
1450: 20 72 65 63 65 6e 74 20 76 65 72 73 69 6f 6e 20   recent version 
1460: 6f 66 20 74 68 65 20 62 72 61 6e 63 68 20 69 73  of the branch is
1470: 20 66 65 74 63 68 65 64 29 20 6f 72 20 61 20 74   fetched) or a t
1480: 61 67 20 66 6f 72 20 61 20 73 70 65 63 69 66 69  ag for a specifi
1490: 63 0a 63 68 65 63 6b 2d 69 6e 20 6c 69 6b 65 20  c.check-in like 
14a0: 22 76 65 72 73 69 6f 6e 2d 33 2e 32 33 2e 30 22  "version-3.23.0"
14b0: 2e 0a 0a 3c 68 32 3e 46 6f 73 73 69 6c 20 41 63  ...<h2>Fossil Ac
14c0: 63 65 73 73 3c 2f 68 32 3e 0a 0a 3c 70 3e 0a 46  cess</h2>..<p>.F
14d0: 6f 73 73 69 6c 20 69 73 20 72 65 61 6c 6c 79 20  ossil is really 
14e0: 65 61 73 79 20 74 6f 20 69 6e 73 74 61 6c 6c 20  easy to install 
14f0: 61 6e 64 20 75 73 65 2e 20 20 48 65 72 65 20 61  and use.  Here a
1500: 72 65 20 74 68 65 20 73 74 65 70 73 20 66 6f 72  re the steps for
1510: 20 75 6e 69 78 2e 0a 28 57 69 6e 64 6f 77 73 20   unix..(Windows 
1520: 69 73 20 73 69 6d 69 6c 61 72 2e 29 0a 0a 3c 6f  is similar.)..<o
1530: 6c 3e 0a 3c 6c 69 3e 0a 44 6f 77 6e 6c 6f 61 64  l>.<li>.Download
1540: 20 74 68 65 20 73 65 6c 66 2d 63 6f 6e 74 61 69   the self-contai
1550: 6e 65 64 20 46 6f 73 73 69 6c 20 65 78 65 63 75  ned Fossil execu
1560: 74 61 62 6c 65 20 66 72 6f 6d 0a 5b 68 74 74 70  table from.[http
1570: 73 3a 2f 2f 66 6f 73 73 69 6c 2d 73 63 6d 2e 6f  s://fossil-scm.o
1580: 72 67 2f 66 6f 73 73 69 6c 2f 75 76 2f 64 6f 77  rg/fossil/uv/dow
1590: 6e 6c 6f 61 64 2e 68 74 6d 6c 5d 20 61 6e 64 20  nload.html] and 
15a0: 70 75 74 20 74 68 65 20 65 78 65 63 75 74 61 62  put the executab
15b0: 6c 65 0a 73 6f 6d 65 77 68 65 72 65 20 6f 6e 20  le.somewhere on 
15c0: 79 6f 75 72 20 24 50 41 54 48 2e 0a 3c 6c 69 3e  your $PATH..<li>
15d0: 3c 74 74 3e 6d 6b 64 69 72 20 7e 2f 66 6f 73 73  <tt>mkdir ~/foss
15e0: 69 6c 73 3c 2f 74 74 3e 0a 3c 6c 69 3e 3c 74 74  ils</tt>.<li><tt
15f0: 3e 66 6f 73 73 69 6c 20 63 6c 6f 6e 65 20 68 74  >fossil clone ht
1600: 74 70 73 3a 2f 2f 66 6f 73 73 69 6c 2d 73 63 6d  tps://fossil-scm
1610: 2e 6f 72 67 2f 66 6f 73 73 69 6c 20 7e 2f 66 6f  .org/fossil ~/fo
1620: 73 73 69 6c 73 2f 73 71 6c 69 74 65 2e 66 6f 73  ssils/sqlite.fos
1630: 73 69 6c 3c 2f 74 74 3e 0a 3c 6c 69 3e 3c 74 74  sil</tt>.<li><tt
1640: 3e 6d 6b 64 69 72 20 7e 2f 73 71 6c 69 74 65 3b  >mkdir ~/sqlite;
1650: 20 63 64 20 7e 2f 73 71 6c 69 74 65 3c 2f 74 74   cd ~/sqlite</tt
1660: 3e 0a 3c 6c 69 3e 3c 74 74 3e 66 6f 73 73 69 6c  >.<li><tt>fossil
1670: 20 6f 70 65 6e 20 7e 2f 73 71 6c 69 74 65 2e 66   open ~/sqlite.f
1680: 6f 73 73 69 6c 20 2e 3c 2f 74 74 3e 0a 3c 2f 6f  ossil .</tt>.</o
1690: 6c 3e 0a 0a 3c 70 3e 0a 53 75 62 73 65 71 75 65  l>..<p>.Subseque
16a0: 6e 74 6c 79 2c 20 74 6f 20 75 70 64 61 74 65 20  ntly, to update 
16b0: 79 6f 75 72 20 63 68 65 63 6b 2d 6f 75 74 2c 20  your check-out, 
16c0: 73 69 6d 70 6c 79 20 74 79 70 65 3a 0a 0a 3c 62  simply type:..<b
16d0: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 74 74 3e 66  lockquote>.<tt>f
16e0: 6f 73 73 69 6c 20 75 70 20 3c 2f 74 74 3e 3c 69  ossil up </tt><i
16f0: 3e 56 45 52 53 49 4f 4e 3c 2f 69 3e 0a 3c 2f 62  >VERSION</i>.</b
1700: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 0a  lockquote>..<p>.
1710: 55 73 65 20 22 74 72 75 6e 6b 22 20 66 6f 72 20  Use "trunk" for 
1720: 76 65 72 73 69 6f 6e 20 74 6f 20 67 65 74 20 74  version to get t
1730: 68 65 20 6c 61 74 65 73 74 20 74 72 75 6e 6b 20  he latest trunk 
1740: 76 65 72 73 69 6f 6e 20 6f 66 20 53 51 4c 69 74  version of SQLit
1750: 65 2e 0a 4f 72 20 75 73 65 20 61 20 70 72 65 66  e..Or use a pref
1760: 69 78 20 6f 66 20 61 20 63 72 79 70 74 6f 67 72  ix of a cryptogr
1770: 61 70 68 69 63 20 68 61 73 68 20 6e 61 6d 65 2c  aphic hash name,
1780: 20 6f 72 20 74 68 65 20 6e 61 6d 65 20 6f 66 20   or the name of 
1790: 73 6f 6d 65 20 62 72 61 6e 63 68 0a 6f 72 20 74  some branch.or t
17a0: 61 67 2e 0a 0a 3c 70 3e 0a 55 73 65 20 74 68 65  ag...<p>.Use the
17b0: 20 22 3c 74 74 3e 66 6f 73 73 69 6c 20 75 69 3c   "<tt>fossil ui<
17c0: 2f 74 74 3e 22 20 63 6f 6d 6d 61 6e 64 20 66 72  /tt>" command fr
17d0: 6f 6d 20 77 69 74 68 69 6e 20 74 68 65 20 7e 2f  om within the ~/
17e0: 73 71 6c 69 74 65 20 63 68 65 63 6b 6f 75 74 20  sqlite checkout 
17f0: 74 6f 0a 62 72 69 6e 67 20 75 70 20 61 20 6c 6f  to.bring up a lo
1800: 63 61 6c 20 63 6f 70 79 20 6f 66 20 74 68 65 20  cal copy of the 
1810: 77 65 62 73 69 74 65 2e 0a                       website..