Documentation Source Text

Hex Artifact Content
Login

Artifact 57c44d97aa5b6e25067b09240d46a29b923035370419a617cf2aa5b8d520d168:


0000: 3c 74 69 74 6c 65 3e 4d 61 69 6e 74 61 69 6e 69  <title>Maintaini
0010: 6e 67 20 50 72 69 76 61 74 65 20 42 72 61 6e 63  ng Private Branc
0020: 68 65 73 20 4f 66 20 53 51 4c 69 74 65 3c 2f 74  hes Of SQLite</t
0030: 69 74 6c 65 3e 0a 3c 74 63 6c 3e 68 64 5f 6b 65  itle>.<tcl>hd_ke
0040: 79 77 6f 72 64 73 20 7b 70 72 69 76 61 74 65 20  ywords {private 
0050: 62 72 61 6e 63 68 65 73 7d 3c 2f 74 63 6c 3e 0a  branches}</tcl>.
0060: 0a 3c 74 61 62 6c 65 5f 6f 66 5f 63 6f 6e 74 65  .<table_of_conte
0070: 6e 74 73 3e 0a 0a 3c 68 31 3e 20 49 6e 74 72 6f  nts>..<h1> Intro
0080: 64 75 63 74 69 6f 6e 3c 2f 68 31 3e 0a 0a 3c 70  duction</h1>..<p
0090: 3e 53 51 4c 69 74 65 20 69 73 20 64 65 73 69 67  >SQLite is desig
00a0: 6e 65 64 20 74 6f 20 6d 65 65 74 20 6d 6f 73 74  ned to meet most
00b0: 20 64 65 76 65 6c 6f 70 65 72 27 73 20 6e 65 65   developer's nee
00c0: 64 73 20 77 69 74 68 6f 75 74 20 61 6e 79 20 0a  ds without any .
00d0: 63 68 61 6e 67 65 73 20 6f 72 20 63 75 73 74 6f  changes or custo
00e0: 6d 69 7a 61 74 69 6f 6e 2e 20 20 57 68 65 6e 20  mization.  When 
00f0: 63 68 61 6e 67 65 73 20 61 72 65 20 6e 65 65 64  changes are need
0100: 65 64 2c 20 74 68 65 79 20 63 61 6e 20 6e 6f 72  ed, they can nor
0110: 6d 61 6c 6c 79 0a 62 65 20 61 63 63 6f 6d 70 6c  mally.be accompl
0120: 69 73 68 65 64 20 75 73 69 6e 67 20 73 74 61 72  ished using star
0130: 74 2d 74 69 6d 65 20 5b 73 71 6c 69 74 65 33 5f  t-time [sqlite3_
0140: 63 6f 6e 66 69 67 20 7c 20 28 31 29 5d 0a 6f 72  config | (1)].or
0150: 20 72 75 6e 74 69 6d 65 0a 5b 73 71 6c 69 74 65   runtime.[sqlite
0160: 33 5f 64 62 5f 63 6f 6e 66 69 67 20 7c 20 28 32  3_db_config | (2
0170: 29 5d 0a 5b 73 71 6c 69 74 65 33 5f 6c 69 6d 69  )].[sqlite3_limi
0180: 74 20 7c 20 28 33 29 5d 0a 5b 73 71 6c 69 74 65  t | (3)].[sqlite
0190: 33 5f 76 66 73 5f 72 65 67 69 73 74 65 72 20 7c  3_vfs_register |
01a0: 20 28 34 29 5d 20 63 6f 6e 66 69 67 75 72 61 74   (4)] configurat
01b0: 69 6f 6e 20 6d 65 74 68 6f 64 73 0a 6f 72 20 76  ion methods.or v
01c0: 69 61 20 5b 63 6f 6d 70 69 6c 65 2d 74 69 6d 65  ia [compile-time
01d0: 20 6f 70 74 69 6f 6e 73 5d 2e 20 20 49 74 20 69   options].  It i
01e0: 73 20 76 65 72 79 20 72 61 72 65 20 74 68 61 74  s very rare that
01f0: 20 61 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e 20   an application 
0200: 0a 64 65 76 65 6c 6f 70 65 72 20 77 69 6c 6c 20  .developer will 
0210: 6e 65 65 64 20 74 6f 20 65 64 69 74 20 74 68 65  need to edit the
0220: 20 53 51 4c 69 74 65 20 73 6f 75 72 63 65 20 63   SQLite source c
0230: 6f 64 65 20 69 6e 20 6f 72 64 65 72 20 74 6f 20  ode in order to 
0240: 0a 69 6e 63 6f 72 70 6f 72 61 74 65 20 53 51 4c  .incorporate SQL
0250: 69 74 65 20 69 6e 74 6f 20 61 20 70 72 6f 64 75  ite into a produ
0260: 63 74 2e 3c 70 3e 0a 0a 3c 70 3e 57 65 20 63 61  ct.<p>..<p>We ca
0270: 6c 6c 20 63 75 73 74 6f 6d 20 6d 6f 64 69 66 69  ll custom modifi
0280: 63 61 74 69 6f 6e 73 20 74 6f 20 74 68 65 20 53  cations to the S
0290: 51 4c 69 74 65 20 73 6f 75 72 63 65 20 63 6f 64  QLite source cod
02a0: 65 20 74 68 61 74 20 61 72 65 20 68 65 6c 64 0a  e that are held.
02b0: 66 6f 72 20 74 68 65 20 75 73 65 20 6f 66 20 61  for the use of a
02c0: 20 73 69 6e 67 6c 65 20 61 70 70 6c 69 63 61 74   single applicat
02d0: 69 6f 6e 20 61 20 22 70 72 69 76 61 74 65 20 62  ion a "private b
02e0: 72 61 6e 63 68 22 2e 20 20 57 68 65 6e 20 61 20  ranch".  When a 
02f0: 70 72 69 76 61 74 65 0a 62 72 61 6e 63 68 20 62  private.branch b
0300: 65 63 6f 6d 65 73 20 6e 65 63 65 73 73 61 72 79  ecomes necessary
0310: 2c 20 74 68 65 20 61 70 70 6c 69 63 61 74 69 6f  , the applicatio
0320: 6e 20 64 65 76 65 6c 6f 70 65 72 20 6d 75 73 74  n developer must
0330: 20 74 61 6b 65 20 6f 6e 20 74 68 65 0a 74 61 73   take on the.tas
0340: 6b 20 6f 66 20 6b 65 65 70 69 6e 67 20 74 68 65  k of keeping the
0350: 20 70 72 69 76 61 74 65 20 62 72 61 6e 63 68 20   private branch 
0360: 69 6e 20 73 79 6e 63 68 72 6f 6e 69 7a 61 74 69  in synchronizati
0370: 6f 6e 20 77 69 74 68 20 74 68 65 20 70 75 62 6c  on with the publ
0380: 69 63 0a 53 51 4c 69 74 65 20 73 6f 75 72 63 65  ic.SQLite source
0390: 73 2e 20 20 54 68 69 73 20 69 73 20 74 65 64 69  s.  This is tedi
03a0: 6f 75 73 2e 20 20 49 74 20 63 61 6e 20 61 6c 73  ous.  It can als
03b0: 6f 20 62 65 20 74 72 69 63 6b 79 2c 20 73 69 6e  o be tricky, sin
03c0: 63 65 20 77 68 69 6c 65 0a 74 68 65 20 53 51 4c  ce while.the SQL
03d0: 69 74 65 20 66 69 6c 65 20 66 6f 72 6d 61 74 20  ite file format 
03e0: 61 6e 64 20 70 75 62 6c 69 73 68 65 64 20 69 6e  and published in
03f0: 74 65 72 66 61 63 65 73 20 61 72 65 20 76 65 72  terfaces are ver
0400: 79 20 73 74 61 62 6c 65 2c 20 74 68 65 0a 69 6e  y stable, the.in
0410: 74 65 72 6e 61 6c 20 69 6d 70 6c 65 6d 65 6e 74  ternal implement
0420: 61 74 69 6f 6e 20 6f 66 20 53 51 4c 69 74 65 20  ation of SQLite 
0430: 63 68 61 6e 67 65 73 20 71 75 69 74 65 20 72 61  changes quite ra
0440: 70 69 64 6c 79 2e 20 20 48 75 6e 64 72 65 64 73  pidly.  Hundreds
0450: 20 6f 72 0a 74 68 6f 75 73 61 6e 64 73 20 6f 66   or.thousands of
0460: 20 6c 69 6e 65 73 20 6f 66 20 63 6f 64 65 20 6d   lines of code m
0470: 69 67 68 74 20 63 68 61 6e 67 65 20 66 6f 72 20  ight change for 
0480: 61 6e 79 20 67 69 76 65 6e 20 53 51 4c 69 74 65  any given SQLite
0490: 20 70 6f 69 6e 74 20 72 65 6c 65 61 73 65 2e 0a   point release..
04a0: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 69 73 20 61 72  </p>..<p>This ar
04b0: 74 69 63 6c 65 20 6f 75 74 6c 69 6e 65 73 20 6f  ticle outlines o
04c0: 6e 65 20 70 6f 73 73 69 62 6c 65 20 6d 65 74 68  ne possible meth
04d0: 6f 64 20 66 6f 72 20 6b 65 65 70 69 6e 67 20 61  od for keeping a
04e0: 20 70 72 69 76 61 74 65 20 62 72 61 6e 63 68 0a   private branch.
04f0: 6f 66 20 53 51 4c 69 74 65 20 69 6e 20 73 79 6e  of SQLite in syn
0500: 63 20 77 69 74 68 20 74 68 65 20 70 75 62 6c 69  c with the publi
0510: 63 20 53 51 4c 69 74 65 20 73 6f 75 72 63 65 20  c SQLite source 
0520: 63 6f 64 65 2e 0a 54 68 65 72 65 20 61 72 65 20  code..There are 
0530: 6d 61 6e 79 20 77 61 79 73 20 6f 66 20 6d 61 69  many ways of mai
0540: 6e 74 61 69 6e 69 6e 67 20 61 20 70 72 69 76 61  ntaining a priva
0550: 74 65 20 62 72 61 6e 63 68 2c 20 6f 66 20 63 6f  te branch, of co
0560: 75 72 73 65 2e 0a 4e 6f 62 6f 64 79 20 69 73 20  urse..Nobody is 
0570: 63 6f 6d 70 65 6c 6c 65 64 20 74 6f 20 75 73 65  compelled to use
0580: 20 74 68 65 20 6d 65 74 68 6f 64 20 64 65 73 63   the method desc
0590: 72 69 62 65 20 68 65 72 65 2e 0a 54 68 69 73 20  ribe here..This 
05a0: 61 72 74 69 63 6c 65 20 69 73 20 6e 6f 74 20 74  article is not t
05b0: 72 79 69 6e 67 20 74 6f 20 69 6d 70 6f 73 65 20  rying to impose 
05c0: 61 20 70 61 72 74 69 63 75 6c 61 72 20 70 72 6f  a particular pro
05d0: 63 65 64 75 72 65 20 6f 6e 20 0a 6d 61 69 6e 74  cedure on .maint
05e0: 61 69 6e 65 72 73 20 6f 66 20 70 72 69 76 61 74  ainers of privat
05f0: 65 20 62 72 61 6e 63 68 65 73 2e 20 20 54 68 65  e branches.  The
0600: 20 70 6f 69 6e 74 20 6f 66 20 74 68 69 73 20 61   point of this a
0610: 72 74 69 63 6c 65 20 69 73 20 74 6f 20 6f 66 66  rticle is to off
0620: 65 72 0a 61 6e 20 65 78 61 6d 70 6c 65 20 6f 66  er.an example of
0630: 20 6f 6e 65 20 70 72 6f 63 65 73 73 20 66 6f 72   one process for
0640: 20 6d 61 69 6e 74 61 69 6e 69 6e 67 20 61 20 70   maintaining a p
0650: 72 69 76 61 74 65 20 62 72 61 6e 63 68 20 77 68  rivate branch wh
0660: 69 63 68 20 63 61 6e 0a 62 65 20 75 73 65 64 20  ich can.be used 
0670: 61 73 20 61 20 74 65 6d 70 6c 61 74 65 20 66 6f  as a template fo
0680: 72 20 64 65 73 69 67 6e 69 6e 67 20 70 72 6f 63  r designing proc
0690: 65 73 73 65 73 20 62 65 73 74 20 73 75 69 74 65  esses best suite
06a0: 64 20 66 6f 72 20 74 68 65 0a 63 69 72 63 75 6d  d for the.circum
06b0: 73 74 61 6e 63 65 73 20 6f 66 20 65 61 63 68 20  stances of each 
06c0: 69 6e 64 69 76 69 64 75 61 6c 20 70 72 6f 6a 65  individual proje
06d0: 63 74 2e 3c 2f 70 3e 0a 0a 3c 69 6d 67 20 73 72  ct.</p>..<img sr
06e0: 63 3d 22 69 6d 61 67 65 73 2f 70 72 69 76 61 74  c="images/privat
06f0: 65 5f 62 72 61 6e 63 68 2e 67 69 66 22 20 61 6c  e_branch.gif" al
0700: 69 67 6e 3d 22 72 69 67 68 74 22 3e 0a 3c 68 31  ign="right">.<h1
0710: 3e 20 54 68 65 20 42 61 73 69 63 20 49 64 65 61  > The Basic Idea
0720: 3c 2f 68 31 3e 0a 0a 0a 3c 70 3e 57 65 20 70 72  </h1>...<p>We pr
0730: 6f 70 6f 73 65 20 74 6f 20 75 73 65 20 74 68 65  opose to use the
0740: 0a 5b 68 74 74 70 3a 2f 2f 77 77 77 2e 66 6f 73  .[http://www.fos
0750: 73 69 6c 2d 73 63 6d 2e 6f 72 67 20 7c 20 66 6f  sil-scm.org | fo
0760: 73 73 69 6c 20 73 6f 66 74 77 61 72 65 20 63 6f  ssil software co
0770: 6e 66 69 67 75 72 61 74 69 6f 6e 20 6d 61 6e 61  nfiguration mana
0780: 67 65 6d 65 6e 74 5d 0a 73 79 73 74 65 6d 20 74  gement].system t
0790: 6f 20 73 65 74 20 75 70 20 74 77 6f 20 62 72 61  o set up two bra
07a0: 6e 63 68 65 73 2e 20 20 4f 6e 65 20 62 72 61 6e  nches.  One bran
07b0: 63 68 20 28 74 68 65 20 22 70 75 62 6c 69 63 20  ch (the "public 
07c0: 62 72 61 6e 63 68 22 20 6f 72 20 22 74 72 75 6e  branch" or "trun
07d0: 6b 22 29 0a 63 6f 6e 74 61 69 6e 73 20 74 68 65  k").contains the
07e0: 20 70 75 62 6c 69 73 68 65 64 20 53 51 4c 69 74   published SQLit
07f0: 65 20 73 6f 75 72 63 65 73 20 61 6e 64 20 74 68  e sources and th
0800: 65 20 6f 74 68 65 72 20 62 72 61 6e 63 68 20 69  e other branch i
0810: 73 20 74 68 65 20 0a 70 72 69 76 61 74 65 20 62  s the .private b
0820: 72 61 6e 63 68 20 77 68 69 63 68 20 63 6f 6e 74  ranch which cont
0830: 61 69 6e 73 20 74 68 65 20 63 6f 64 65 20 74 68  ains the code th
0840: 61 74 20 69 73 20 63 75 73 74 6f 6d 69 7a 65 64  at is customized
0850: 20 66 6f 72 20 74 68 65 20 70 72 6f 6a 65 63 74   for the project
0860: 2e 0a 57 68 65 6e 65 76 65 72 20 61 20 6e 65 77  ..Whenever a new
0870: 20 70 75 62 6c 69 63 20 72 65 6c 65 61 73 65 20   public release 
0880: 6f 66 20 53 51 4c 69 74 65 20 69 73 20 6d 61 64  of SQLite is mad
0890: 65 2c 20 74 68 61 74 20 72 65 6c 65 61 73 65 20  e, that release 
08a0: 69 73 20 61 64 64 65 64 20 74 6f 0a 74 68 65 20  is added to.the 
08b0: 70 75 62 6c 69 63 20 62 72 61 6e 63 68 20 61 6e  public branch an
08c0: 64 20 74 68 65 6e 20 74 68 65 20 63 68 61 6e 67  d then the chang
08d0: 65 73 20 61 72 65 20 6d 65 72 67 65 64 20 69 6e  es are merged in
08e0: 74 6f 20 74 68 65 20 70 72 69 76 61 74 65 20 62  to the private b
08f0: 72 61 6e 63 68 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54  ranch.</p>..<p>T
0900: 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 70 72 6f  his document pro
0910: 70 6f 73 65 73 20 74 6f 20 75 73 65 0a 5b 68 74  poses to use.[ht
0920: 74 70 3a 2f 2f 77 77 77 2e 66 6f 73 73 69 6c 2d  tp://www.fossil-
0930: 73 63 6d 2e 6f 72 67 2f 20 7c 20 66 6f 73 73 69  scm.org/ | fossi
0940: 6c 5d 2c 0a 62 75 74 20 61 6e 79 20 6f 74 68 65  l],.but any othe
0950: 72 20 64 69 73 74 72 69 62 75 74 65 64 20 73 6f  r distributed so
0960: 66 74 77 61 72 65 20 63 6f 6e 66 69 67 75 72 61  ftware configura
0970: 74 69 6f 6e 20 6d 61 6e 61 67 65 6d 65 6e 74 20  tion management 
0980: 73 79 73 74 65 6d 20 73 75 63 68 20 61 73 0a 5b  system such as.[
0990: 68 74 74 70 3a 2f 2f 77 77 77 2e 6d 6f 6e 6f 74  http://www.monot
09a0: 6f 6e 65 2e 63 61 2f 20 7c 20 6d 6f 6e 6f 74 6f  one.ca/ | monoto
09b0: 6e 65 5d 20 6f 72 0a 5b 68 74 74 70 3a 2f 2f 77  ne] or.[http://w
09c0: 77 77 2e 73 65 6c 65 6e 69 63 2e 63 6f 6d 2f 6d  ww.selenic.com/m
09d0: 65 72 63 75 72 69 61 6c 2f 77 69 6b 69 2f 20 7c  ercurial/wiki/ |
09e0: 20 6d 65 72 63 75 72 69 61 6c 5d 20 28 61 2e 6b   mercurial] (a.k
09f0: 2e 61 2e 20 22 68 67 22 29 2c 20 6f 72 0a 5b 68  .a. "hg"), or.[h
0a00: 74 74 70 3a 2f 2f 77 77 77 2e 67 69 74 2d 73 63  ttp://www.git-sc
0a10: 6d 2e 6f 72 67 2f 20 7c 20 67 69 74 5d 20 63 6f  m.org/ | git] co
0a20: 75 6c 64 20 73 65 72 76 65 20 6a 75 73 74 20 61  uld serve just a
0a30: 73 20 77 65 6c 6c 2e 0a 54 68 65 20 63 6f 6e 63  s well..The conc
0a40: 65 70 74 20 77 69 6c 6c 20 62 65 20 74 68 65 20  ept will be the 
0a50: 73 61 6d 65 2c 20 0a 74 68 6f 75 67 68 20 74 68  same, .though th
0a60: 65 20 73 70 65 63 69 66 69 63 73 20 6f 66 20 74  e specifics of t
0a70: 68 65 20 70 72 6f 63 65 64 75 72 65 20 77 69 6c  he procedure wil
0a80: 6c 20 76 61 72 79 2e 3c 2f 70 3e 0a 0a 3c 70 3e  l vary.</p>..<p>
0a90: 54 68 65 20 64 69 61 67 72 61 6d 20 61 74 20 74  The diagram at t
0aa0: 68 65 20 72 69 67 68 74 20 69 6c 6c 75 73 74 72  he right illustr
0ab0: 61 74 65 73 20 74 68 65 20 63 6f 6e 63 65 70 74  ates the concept
0ac0: 2e 0a 4f 6e 65 20 62 65 67 69 6e 73 20 77 69 74  ..One begins wit
0ad0: 68 20 61 20 73 74 61 6e 64 61 72 64 20 53 51 4c  h a standard SQL
0ae0: 69 74 65 20 72 65 6c 65 61 73 65 2e 20 20 46 6f  ite release.  Fo
0af0: 72 20 74 68 65 0a 73 61 6b 65 20 6f 66 20 65 78  r the.sake of ex
0b00: 61 6d 70 6c 65 2c 20 73 75 70 70 6f 73 65 20 74  ample, suppose t
0b10: 68 61 74 20 6f 6e 65 20 69 6e 74 65 6e 64 73 20  hat one intends 
0b20: 74 6f 20 63 72 65 61 74 65 20 61 0a 70 72 69 76  to create a.priv
0b30: 61 74 65 20 62 72 61 6e 63 68 20 6f 66 66 20 6f  ate branch off o
0b40: 66 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e  f SQLite version
0b50: 20 33 2e 36 2e 31 35 2e 20 20 49 6e 20 74 68 65   3.6.15.  In the
0b60: 0a 64 69 61 67 72 61 6d 20 74 68 69 73 20 69 73  .diagram this is
0b70: 20 76 65 72 73 69 6f 6e 20 28 31 29 2e 20 20 54   version (1).  T
0b80: 68 65 0a 6d 61 69 6e 74 61 69 6e 65 72 20 6d 61  he.maintainer ma
0b90: 6b 65 73 20 61 6e 20 65 78 61 63 74 20 63 6f 70  kes an exact cop
0ba0: 79 20 6f 66 20 74 68 65 20 62 61 73 65 6c 69 6e  y of the baselin
0bb0: 65 0a 53 51 4c 69 74 65 20 69 6e 74 6f 20 74 68  e.SQLite into th
0bc0: 65 20 62 72 61 6e 63 68 20 73 70 61 63 65 2c 20  e branch space, 
0bd0: 73 68 6f 77 6e 20 61 73 20 76 65 72 73 69 6f 6e  shown as version
0be0: 20 28 32 29 2e 0a 4e 6f 74 65 20 74 68 61 74 20   (2)..Note that 
0bf0: 28 31 29 20 61 6e 64 20 28 32 29 20 61 72 65 20  (1) and (2) are 
0c00: 65 78 61 63 74 6c 79 20 74 68 65 20 73 61 6d 65  exactly the same
0c10: 2e 20 20 54 68 65 6e 0a 74 68 65 20 6d 61 69 6e  .  Then.the main
0c20: 74 61 69 6e 65 72 20 61 70 70 6c 69 65 73 20 74  tainer applies t
0c30: 68 65 20 70 72 69 76 61 74 65 20 63 68 61 6e 67  he private chang
0c40: 65 73 20 74 6f 20 0a 76 65 72 73 69 6f 6e 20 28  es to .version (
0c50: 32 29 20 72 65 73 75 6c 74 69 6e 67 20 69 6e 20  2) resulting in 
0c60: 76 65 72 73 69 6f 6e 20 28 33 29 2e 20 20 49 6e  version (3).  In
0c70: 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 0a 76 65   other words,.ve
0c80: 72 73 69 6f 6e 20 28 33 29 20 69 73 20 53 51 4c  rsion (3) is SQL
0c90: 69 74 65 20 76 65 72 73 69 6f 6e 20 33 2e 36 2e  ite version 3.6.
0ca0: 31 35 20 70 6c 75 73 20 65 64 69 74 73 2e 3c 2f  15 plus edits.</
0cb0: 70 3e 0a 0a 3c 70 3e 4c 61 74 65 72 2c 20 53 51  p>..<p>Later, SQ
0cc0: 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 33 2e 36  Lite version 3.6
0cd0: 2e 31 36 20 69 73 20 72 65 6c 65 61 73 65 64 2c  .16 is released,
0ce0: 20 61 73 20 73 68 6f 77 6e 20 0a 62 79 20 63 69   as shown .by ci
0cf0: 72 63 6c 65 20 28 34 29 20 69 6e 20 74 68 65 20  rcle (4) in the 
0d00: 64 69 61 67 72 61 6d 2e 20 20 41 74 20 74 68 65  diagram.  At the
0d10: 20 70 6f 69 6e 74 2c 20 74 68 65 20 70 72 69 76   point, the priv
0d20: 61 74 65 0a 62 72 61 6e 63 68 20 6d 61 69 6e 74  ate.branch maint
0d30: 61 69 6e 65 72 20 64 6f 65 73 20 61 20 6d 65 72  ainer does a mer
0d40: 67 65 20 77 68 69 63 68 20 74 61 6b 65 73 20 61  ge which takes a
0d50: 6c 6c 20 6f 66 20 74 68 65 0a 63 68 61 6e 67 65  ll of the.change
0d60: 73 20 67 6f 69 6e 67 20 66 72 6f 6d 20 28 31 29  s going from (1)
0d70: 20 74 6f 20 28 34 29 20 61 6e 64 20 61 70 70 6c   to (4) and appl
0d80: 69 65 73 20 74 68 6f 73 65 20 63 68 61 6e 67 65  ies those change
0d90: 73 20 74 6f 0a 28 33 29 2e 20 20 54 68 65 20 72  s to.(3).  The r
0da0: 65 73 75 6c 74 20 69 73 20 76 65 72 73 69 6f 6e  esult is version
0db0: 20 28 35 29 2c 20 77 68 69 63 68 20 69 73 20 53   (5), which is S
0dc0: 51 4c 69 74 65 20 33 2e 36 2e 31 36 0a 70 6c 75  QLite 3.6.16.plu
0dd0: 73 20 65 64 69 74 73 2e 3c 2f 70 3e 0a 0a 3c 70  s edits.</p>..<p
0de0: 3e 54 68 65 72 65 20 6d 69 67 68 74 20 62 65 20  >There might be 
0df0: 6d 65 72 67 65 20 63 6f 6e 66 6c 69 63 74 73 2e  merge conflicts.
0e00: 20 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73    In other words
0e10: 2c 20 69 74 20 6d 69 67 68 74 0a 62 65 20 74 68  , it might.be th
0e20: 61 74 20 74 68 65 20 63 68 61 6e 67 65 73 20 66  at the changes f
0e30: 72 6f 6d 20 28 32 29 20 74 6f 20 28 33 29 20 61  rom (2) to (3) a
0e40: 72 65 20 69 6e 63 6f 6d 70 61 74 69 62 6c 65 20  re incompatible 
0e50: 77 69 74 68 20 74 68 65 0a 63 68 61 6e 67 65 73  with the.changes
0e60: 20 66 72 6f 6d 20 28 31 29 20 74 6f 20 28 34 29   from (1) to (4)
0e70: 2e 20 20 49 6e 20 74 68 61 74 20 63 61 73 65 2c  .  In that case,
0e80: 20 74 68 65 20 6d 61 69 6e 74 61 69 6e 65 72 20   the maintainer 
0e90: 77 69 6c 6c 0a 68 61 76 65 20 74 6f 20 6d 61 6e  will.have to man
0ea0: 75 61 6c 6c 79 20 72 65 73 6f 6c 76 65 20 74 68  ually resolve th
0eb0: 65 20 63 6f 6e 66 6c 69 63 74 73 2e 20 20 48 6f  e conflicts.  Ho
0ec0: 70 65 66 75 6c 6c 79 20 63 6f 6e 66 6c 69 63 74  pefully conflict
0ed0: 73 0a 77 69 6c 6c 20 6e 6f 74 20 63 6f 6d 65 20  s.will not come 
0ee0: 75 70 20 74 68 61 74 20 6f 66 74 65 6e 2e 20 20  up that often.  
0ef0: 43 6f 6e 66 6c 69 63 74 73 20 61 72 65 20 6c 65  Conflicts are le
0f00: 73 73 20 6c 69 6b 65 6c 79 20 74 6f 0a 6f 63 63  ss likely to.occ
0f10: 75 72 20 77 68 65 6e 20 74 68 65 20 70 72 69 76  ur when the priv
0f20: 61 74 65 20 65 64 69 74 73 20 61 72 65 20 6b 65  ate edits are ke
0f30: 70 74 20 74 6f 20 61 20 6d 69 6e 69 6d 75 6d 2e  pt to a minimum.
0f40: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 63 79 63  </p>..<p>The cyc
0f50: 6c 65 20 61 62 6f 76 65 20 63 61 6e 20 62 65 20  le above can be 
0f60: 72 65 70 65 61 74 65 64 20 6d 61 6e 79 20 74 69  repeated many ti
0f70: 6d 65 73 2e 20 20 54 68 65 0a 64 69 61 67 72 61  mes.  The.diagra
0f80: 6d 20 73 68 6f 77 73 20 61 20 74 68 69 72 64 20  m shows a third 
0f90: 53 51 4c 69 74 65 20 72 65 6c 65 61 73 65 2c 20  SQLite release, 
0fa0: 33 2e 36 2e 31 37 20 69 6e 0a 63 69 72 63 6c 65  3.6.17 in.circle
0fb0: 20 28 36 29 2e 20 20 54 68 65 20 70 72 69 76 61   (6).  The priva
0fc0: 74 65 20 62 72 61 6e 63 68 20 6d 61 69 6e 74 61  te branch mainta
0fd0: 69 6e 65 72 20 63 61 6e 20 64 6f 0a 61 6e 6f 74  iner can do.anot
0fe0: 68 65 72 20 6d 65 72 67 65 20 69 6e 20 6f 72 64  her merge in ord
0ff0: 65 72 20 74 6f 20 69 6e 63 6f 72 70 6f 72 61 74  er to incorporat
1000: 65 20 74 68 65 20 63 68 61 6e 67 65 73 0a 6d 6f  e the changes.mo
1010: 76 69 6e 67 20 66 72 6f 6d 20 28 34 29 20 74 6f  ving from (4) to
1020: 20 28 36 29 20 69 6e 74 6f 20 74 68 65 20 70 72   (6) into the pr
1030: 69 76 61 74 65 20 62 72 61 6e 63 68 2c 20 72 65  ivate branch, re
1040: 73 75 6c 74 69 6e 67 0a 69 6e 20 76 65 72 73 69  sulting.in versi
1050: 6f 6e 20 28 37 29 2e 3c 2f 70 3e 0a 0a 3c 68 31  on (7).</p>..<h1
1060: 3e 20 54 68 65 20 50 72 6f 63 65 64 75 72 65 3c  > The Procedure<
1070: 2f 68 31 3e 0a 0a 3c 70 3e 54 68 65 20 72 65 6d  /h1>..<p>The rem
1080: 61 69 6e 64 65 72 20 6f 66 20 74 68 69 73 20 64  ainder of this d
1090: 6f 63 75 6d 65 6e 74 20 77 69 6c 6c 20 67 75 69  ocument will gui
10a0: 64 65 20 74 68 65 20 72 65 61 64 65 72 20 74 68  de the reader th
10b0: 72 6f 75 67 68 0a 74 68 65 20 73 74 65 70 73 20  rough.the steps 
10c0: 6e 65 65 64 65 64 20 74 6f 20 6d 61 69 6e 74 61  needed to mainta
10d0: 69 6e 20 61 20 70 72 69 76 61 74 65 20 62 72 61  in a private bra
10e0: 6e 63 68 2e 20 20 54 68 65 20 67 65 6e 65 72 61  nch.  The genera
10f0: 6c 20 69 64 65 61 0a 69 73 20 74 68 65 20 73 61  l idea.is the sa
1100: 6d 65 20 61 73 20 6f 75 74 6c 69 6e 65 64 20 61  me as outlined a
1110: 62 6f 76 65 2e 20 20 54 68 69 73 20 73 65 63 74  bove.  This sect
1120: 69 6f 6e 20 6d 65 72 65 6c 79 20 70 72 6f 76 69  ion merely provi
1130: 64 65 73 20 6d 6f 72 65 0a 64 65 74 61 69 6c 2e  des more.detail.
1140: 3c 2f 70 3e 0a 0a 3c 70 3e 57 65 20 65 6d 70 68  </p>..<p>We emph
1150: 61 73 69 7a 65 20 61 67 61 69 6e 20 74 68 61 74  asize again that
1160: 20 74 68 65 73 65 20 73 74 65 70 73 20 61 72 65   these steps are
1170: 20 6e 6f 74 20 69 6e 74 65 6e 64 65 64 20 74 6f   not intended to
1180: 20 62 65 20 74 68 65 20 6f 6e 6c 79 0a 61 63 63   be the only.acc
1190: 65 70 74 61 62 6c 65 20 6d 65 74 68 6f 64 20 66  eptable method f
11a0: 6f 72 20 6d 61 69 6e 74 61 69 6e 69 6e 67 20 70  or maintaining p
11b0: 72 69 76 61 74 65 20 62 72 61 6e 63 68 2e 20 20  rivate branch.  
11c0: 54 68 69 73 20 61 70 70 72 6f 61 63 68 0a 69 73  This approach.is
11d0: 20 6f 6e 65 20 6f 66 20 6d 61 6e 79 2e 20 20 55   one of many.  U
11e0: 73 65 20 74 68 69 73 20 64 6f 63 75 6d 65 6e 74  se this document
11f0: 20 61 73 20 61 20 62 61 73 65 6c 69 6e 65 20 66   as a baseline f
1200: 6f 72 20 70 72 65 70 61 72 69 6e 67 0a 70 72 6f  or preparing.pro
1210: 6a 65 63 74 2d 73 70 65 63 69 66 69 63 20 70 72  ject-specific pr
1220: 6f 63 65 64 75 72 65 73 2e 20 20 44 6f 20 6e 6f  ocedures.  Do no
1230: 74 20 62 65 20 61 66 72 61 69 64 20 74 6f 20 65  t be afraid to e
1240: 78 70 65 72 69 6d 65 6e 74 2e 3c 2f 70 3e 0a 0a  xperiment.</p>..
1250: 3c 68 32 3e 20 4f 62 74 61 69 6e 20 54 68 65 20  <h2> Obtain The 
1260: 53 6f 66 74 77 61 72 65 3c 2f 68 32 3e 0a 0a 3c  Software</h2>..<
1270: 70 3e 5b 68 74 74 70 3a 2f 2f 77 77 77 2e 66 6f  p>[http://www.fo
1280: 73 73 69 6c 2d 73 63 6d 2e 6f 72 67 2f 20 7c 20  ssil-scm.org/ | 
1290: 46 6f 73 73 69 6c 5d 20 69 73 20 61 20 63 6f 6d  Fossil] is a com
12a0: 70 75 74 65 72 20 70 72 6f 67 72 61 6d 0a 74 68  puter program.th
12b0: 61 74 20 6d 75 73 74 20 62 65 20 69 6e 73 74 61  at must be insta
12c0: 6c 6c 65 64 20 6f 6e 20 79 6f 75 72 20 6d 61 63  lled on your mac
12d0: 68 69 6e 65 20 62 65 66 6f 72 65 20 79 6f 75 20  hine before you 
12e0: 75 73 65 20 69 74 2e 0a 46 6f 72 74 75 6e 61 74  use it..Fortunat
12f0: 65 6c 79 2c 20 69 6e 73 74 61 6c 6c 69 6e 67 20  ely, installing 
1300: 66 6f 73 73 69 6c 20 69 73 20 76 65 72 79 20 65  fossil is very e
1310: 61 73 79 2e 20 20 46 6f 73 73 69 6c 20 69 73 20  asy.  Fossil is 
1320: 61 20 73 69 6e 67 6c 65 0a 22 2a 2e 65 78 65 22  a single."*.exe"
1330: 20 66 69 6c 65 20 74 68 61 74 20 79 6f 75 20 73   file that you s
1340: 69 6d 70 6c 79 20 64 6f 77 6e 6c 6f 61 64 20 61  imply download a
1350: 6e 64 20 72 75 6e 2e 20 20 54 6f 20 75 6e 69 6e  nd run.  To unin
1360: 73 74 61 6c 6c 20 66 6f 73 73 69 6c 2c 0a 73 69  stall fossil,.si
1370: 6d 70 6c 79 20 64 65 6c 65 74 65 20 74 68 65 20  mply delete the 
1380: 65 78 65 20 66 69 6c 65 2e 20 20 0a 5b 68 74 74  exe file.  .[htt
1390: 70 3a 2f 2f 77 77 77 2e 66 6f 73 73 69 6c 2d 73  p://www.fossil-s
13a0: 63 6d 2e 6f 72 67 2f 69 6e 64 65 78 2e 68 74 6d  cm.org/index.htm
13b0: 6c 2f 64 6f 63 2f 74 69 70 2f 77 77 77 2f 71 75  l/doc/tip/www/qu
13c0: 69 63 6b 73 74 61 72 74 2e 77 69 6b 69 20 7c 20  ickstart.wiki | 
13d0: 44 65 74 61 69 6c 65 64 20 69 6e 73 74 72 75 63  Detailed instruc
13e0: 74 69 6f 6e 73 5d 20 66 6f 72 20 69 6e 73 74 61  tions] for insta
13f0: 6c 6c 69 6e 67 20 61 6e 64 20 67 65 74 74 69 6e  lling and gettin
1400: 67 20 73 74 61 72 74 65 64 20 77 69 74 68 0a 66  g started with.f
1410: 6f 73 73 69 6c 20 61 72 65 20 61 76 61 69 6c 61  ossil are availa
1420: 62 6c 65 20 6f 6e 20 74 68 65 20 0a 5b 68 74 74  ble on the .[htt
1430: 70 3a 2f 2f 77 77 77 2e 66 6f 73 73 69 6c 2d 73  p://www.fossil-s
1440: 63 6d 2e 6f 72 67 20 7c 20 66 6f 73 73 69 6c 20  cm.org | fossil 
1450: 77 65 62 73 69 74 65 5d 2e 3c 2f 70 3e 0a 0a 3c  website].</p>..<
1460: 68 32 3e 20 43 72 65 61 74 65 20 41 20 50 72 6f  h2> Create A Pro
1470: 6a 65 63 74 20 52 65 70 6f 73 69 74 6f 72 79 3c  ject Repository<
1480: 2f 68 32 3e 0a 0a 3c 70 3e 43 72 65 61 74 65 20  /h2>..<p>Create 
1490: 61 20 66 6f 73 73 69 6c 20 72 65 70 6f 73 69 74  a fossil reposit
14a0: 6f 72 79 20 74 6f 20 68 6f 73 74 20 74 68 65 20  ory to host the 
14b0: 70 72 69 76 61 74 65 20 62 72 61 6e 63 68 20 75  private branch u
14c0: 73 69 6e 67 20 74 68 65 0a 66 6f 6c 6c 6f 77 69  sing the.followi
14d0: 6e 67 20 63 6f 6d 6d 61 6e 64 3a 3c 2f 70 3e 0a  ng command:</p>.
14e0: 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72  .<blockquote><pr
14f0: 65 3e 0a 66 6f 73 73 69 6c 20 6e 65 77 20 70 72  e>.fossil new pr
1500: 69 76 61 74 65 2d 70 72 6f 6a 65 63 74 2e 66 6f  ivate-project.fo
1510: 73 73 69 6c 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f  ssil.</pre></blo
1520: 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 59 6f 75  ckquote>..<p>You
1530: 20 63 61 6e 20 63 61 6c 6c 20 79 6f 75 72 20 70   can call your p
1540: 72 6f 6a 65 63 74 20 61 6e 79 74 68 69 6e 67 20  roject anything 
1550: 79 6f 75 20 6c 69 6b 65 2e 20 20 54 68 65 20 22  you like.  The "
1560: 3c 74 74 3e 2e 66 6f 73 73 69 6c 3c 2f 74 74 3e  <tt>.fossil</tt>
1570: 22 0a 73 75 66 66 69 78 20 69 73 20 6f 70 74 69  ".suffix is opti
1580: 6f 6e 61 6c 2e 20 20 46 6f 72 20 74 68 69 73 20  onal.  For this 
1590: 64 6f 63 75 6d 65 6e 74 2c 20 77 65 20 77 69 6c  document, we wil
15a0: 6c 20 63 6f 6e 74 69 6e 75 65 20 74 6f 20 63 61  l continue to ca
15b0: 6c 6c 20 74 68 65 0a 70 72 6f 6a 65 63 74 20 22  ll the.project "
15c0: 3c 74 74 3e 70 72 69 76 61 74 65 2d 70 72 6f 6a  <tt>private-proj
15d0: 65 63 74 2e 66 6f 73 73 69 6c 3c 2f 74 74 3e 22  ect.fossil</tt>"
15e0: 2e 20 20 4e 6f 74 65 20 74 68 61 74 0a 3c 74 74  .  Note that.<tt
15f0: 3e 70 72 69 76 61 74 65 2d 70 72 6f 6a 65 63 74  >private-project
1600: 2e 66 6f 73 73 69 6c 3c 2f 74 74 3e 20 69 73 20  .fossil</tt> is 
1610: 61 6e 20 6f 72 64 69 6e 61 72 79 20 64 69 73 6b  an ordinary disk
1620: 20 66 69 6c 65 20 28 61 63 74 75 61 6c 6c 79 20   file (actually 
1630: 61 6e 0a 53 51 4c 69 74 65 20 64 61 74 61 62 61  an.SQLite databa
1640: 73 65 29 20 74 68 61 74 20 77 69 6c 6c 20 63 6f  se) that will co
1650: 6e 74 61 69 6e 20 79 6f 75 72 20 63 6f 6d 70 6c  ntain your compl
1660: 65 74 65 20 70 72 6f 6a 65 63 74 20 68 69 73 74  ete project hist
1670: 6f 72 79 2e 0a 59 6f 75 20 63 61 6e 20 6d 61 6b  ory..You can mak
1680: 65 20 61 20 62 61 63 6b 75 70 20 6f 66 20 74 68  e a backup of th
1690: 65 20 70 72 6f 6a 65 63 74 20 73 69 6d 70 6c 79  e project simply
16a0: 20 62 79 20 6d 61 6b 69 6e 67 20 61 20 63 6f 70   by making a cop
16b0: 79 20 6f 66 20 74 68 61 74 0a 6f 6e 65 20 66 69  y of that.one fi
16c0: 6c 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 49 66 20 79  le.</p>..<p>If y
16d0: 6f 75 20 77 61 6e 74 20 74 6f 20 63 6f 6e 66 69  ou want to confi
16e0: 67 75 72 65 20 74 68 65 20 6e 65 77 20 70 72 6f  gure the new pro
16f0: 6a 65 63 74 2c 20 74 79 70 65 3a 3c 2f 70 3e 0a  ject, type:</p>.
1700: 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72  .<blockquote><pr
1710: 65 3e 0a 66 6f 73 73 69 6c 20 75 69 20 70 72 69  e>.fossil ui pri
1720: 76 61 74 65 2d 70 72 6f 6a 65 63 74 2e 66 6f 73  vate-project.fos
1730: 73 69 6c 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63  sil.</pre></bloc
1740: 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 54 68 65 20  kquote>..<p>The 
1750: 22 75 69 22 20 63 6f 6d 6d 61 6e 64 20 77 69 6c  "ui" command wil
1760: 6c 20 63 61 75 73 65 20 66 6f 73 73 69 6c 20 74  l cause fossil t
1770: 6f 20 72 75 6e 20 61 20 6d 69 6e 69 61 74 75 72  o run a miniatur
1780: 65 20 62 75 69 6c 74 2d 69 6e 20 77 65 62 73 65  e built-in webse
1790: 72 76 65 72 0a 61 6e 64 20 74 6f 20 6c 61 75 6e  rver.and to laun
17a0: 63 68 20 79 6f 75 72 20 77 65 62 2d 62 72 6f 77  ch your web-brow
17b0: 73 65 72 20 70 6f 69 6e 74 69 6e 67 0a 61 74 20  ser pointing.at 
17c0: 74 68 61 74 20 77 65 62 73 65 72 76 65 72 2e 20  that webserver. 
17d0: 20 59 6f 75 20 63 61 6e 20 75 73 65 20 79 6f 75   You can use you
17e0: 72 20 77 65 62 2d 62 72 6f 77 73 65 72 20 74 6f  r web-browser to
17f0: 20 63 6f 6e 66 69 67 75 72 65 20 79 6f 75 72 20   configure your 
1800: 70 72 6f 6a 65 63 74 0a 69 6e 20 76 61 72 69 6f  project.in vario
1810: 75 73 20 77 61 79 73 2e 20 20 53 65 65 20 74 68  us ways.  See th
1820: 65 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 6f  e instructions o
1830: 6e 20 74 68 65 20 66 6f 73 73 69 6c 20 77 65 62  n the fossil web
1840: 73 69 74 65 20 66 6f 72 20 61 64 64 69 74 69 6f  site for additio
1850: 6e 61 6c 0a 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e  nal.information.
1860: 3c 2f 70 3e 0a 0a 3c 70 3e 4f 6e 63 65 20 74 68  </p>..<p>Once th
1870: 65 20 70 72 6f 6a 65 63 74 20 72 65 70 6f 73 69  e project reposi
1880: 74 6f 72 79 20 69 73 20 63 72 65 61 74 65 64 2c  tory is created,
1890: 20 63 72 65 61 74 65 20 61 6e 20 6f 70 65 6e 20   create an open 
18a0: 63 68 65 63 6b 6f 75 74 20 6f 66 20 74 68 65 0a  checkout of the.
18b0: 70 72 6f 6a 65 63 74 20 62 79 20 6d 6f 76 69 6e  project by movin
18c0: 67 20 74 6f 20 74 68 65 20 64 69 72 65 63 74 6f  g to the directo
18d0: 72 79 20 77 68 65 72 65 20 79 6f 75 20 77 61 6e  ry where you wan
18e0: 74 20 74 6f 20 6b 65 65 70 20 61 6c 6c 20 6f 66  t to keep all of
18f0: 20 74 68 65 0a 70 72 6f 6a 65 63 74 20 73 6f 75   the.project sou
1900: 72 63 65 20 63 6f 64 65 20 61 6e 64 20 74 79 70  rce code and typ
1910: 69 6e 67 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b  ing:</p>..<block
1920: 71 75 6f 74 65 3e 3c 70 72 65 3e 0a 66 6f 73 73  quote><pre>.foss
1930: 69 6c 20 6f 70 65 6e 20 70 72 69 76 61 74 65 2d  il open private-
1940: 70 72 6f 6a 65 63 74 2e 66 6f 73 73 69 6c 0a 3c  project.fossil.<
1950: 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74  /pre></blockquot
1960: 65 3e 0a 0a 3c 70 3e 59 6f 75 20 63 61 6e 20 68  e>..<p>You can h
1970: 61 76 65 20 6d 75 6c 74 69 70 6c 65 20 63 68 65  ave multiple che
1980: 63 6b 6f 75 74 73 20 6f 66 20 74 68 65 20 73 61  ckouts of the sa
1990: 6d 65 20 70 72 6f 6a 65 63 74 20 69 66 20 79 6f  me project if yo
19a0: 75 20 77 61 6e 74 2e 20 0a 41 6e 64 20 79 6f 75  u want. .And you
19b0: 20 63 61 6e 20 22 63 6c 6f 6e 65 22 20 74 68 65   can "clone" the
19c0: 20 72 65 70 6f 73 69 74 6f 72 79 20 74 6f 20 64   repository to d
19d0: 69 66 66 65 72 65 6e 74 20 6d 61 63 68 69 6e 65  ifferent machine
19e0: 73 20 73 6f 20 74 68 61 74 20 6d 75 6c 74 69 70  s so that multip
19f0: 6c 65 0a 64 65 76 65 6c 6f 70 65 72 73 20 63 61  le.developers ca
1a00: 6e 20 75 73 65 20 69 74 2e 20 20 53 65 65 20 74  n use it.  See t
1a10: 68 65 20 66 6f 73 73 69 6c 20 77 65 62 73 69 74  he fossil websit
1a20: 65 20 66 6f 72 20 66 75 72 74 68 65 72 20 69 6e  e for further in
1a30: 66 6f 72 6d 61 74 69 6f 6e 2e 3c 2f 70 3e 0a 0a  formation.</p>..
1a40: 3c 68 32 3e 20 49 6e 73 74 61 6c 6c 69 6e 67 20  <h2> Installing 
1a50: 54 68 65 20 53 51 4c 69 74 65 20 42 61 73 65 6c  The SQLite Basel
1a60: 69 6e 65 20 49 6e 20 46 6f 73 73 69 6c 3c 2f 68  ine In Fossil</h
1a70: 32 3e 0a 0a 3c 70 3e 54 68 65 20 72 65 70 6f 73  2>..<p>The repos
1a80: 69 74 6f 72 79 20 63 72 65 61 74 65 64 20 69 6e  itory created in
1a90: 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 73 74   the previous st
1aa0: 65 70 20 69 73 20 69 6e 69 74 69 61 6c 6c 79 20  ep is initially 
1ab0: 65 6d 70 74 79 2e 20 20 54 68 65 0a 6e 65 78 74  empty.  The.next
1ac0: 20 73 74 65 70 20 69 73 20 74 6f 20 6c 6f 61 64   step is to load
1ad0: 20 74 68 65 20 62 61 73 65 6c 69 6e 65 20 53 51   the baseline SQ
1ae0: 4c 69 74 65 20 72 65 6c 65 61 73 65 20 2d 20 63  Lite release - c
1af0: 69 72 63 6c 65 20 28 31 29 20 69 6e 20 74 68 65  ircle (1) in the
1b00: 20 64 69 61 67 72 61 6d 0a 61 62 6f 76 65 2e 3c   diagram.above.<
1b10: 2f 70 3e 0a 0a 3c 70 3e 42 65 67 69 6e 20 62 79  /p>..<p>Begin by
1b20: 20 6f 62 74 61 69 6e 69 6e 67 20 61 20 63 6f 70   obtaining a cop
1b30: 79 20 6f 66 20 53 51 4c 69 74 65 20 69 6e 20 77  y of SQLite in w
1b40: 68 61 74 65 76 65 72 20 66 6f 72 6d 20 79 6f 75  hatever form you
1b50: 20 75 73 65 20 69 74 2e 0a 54 68 65 20 70 75 62   use it..The pub
1b60: 6c 69 63 20 53 51 4c 69 74 65 20 79 6f 75 20 6f  lic SQLite you o
1b70: 62 74 61 69 6e 20 73 68 6f 75 6c 64 20 62 65 20  btain should be 
1b80: 61 73 20 63 6c 6f 73 65 20 74 6f 20 79 6f 75 72  as close to your
1b90: 20 70 72 69 76 61 74 65 20 65 64 69 74 65 64 0a   private edited.
1ba0: 63 6f 70 79 20 61 73 20 70 6f 73 73 69 62 6c 65  copy as possible
1bb0: 2e 20 20 49 66 20 79 6f 75 72 20 70 72 6f 6a 65  .  If your proje
1bc0: 63 74 20 75 73 65 73 20 74 68 65 20 53 51 4c 69  ct uses the SQLi
1bd0: 74 65 20 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 2c  te amalgamation,
1be0: 20 74 68 65 6e 0a 67 65 74 20 61 20 63 6f 70 79   then.get a copy
1bf0: 20 6f 66 20 74 68 65 20 61 6d 61 6c 67 61 6d 61   of the amalgama
1c00: 74 69 6f 6e 2e 20 20 49 66 20 79 6f 75 20 75 73  tion.  If you us
1c10: 65 20 74 68 65 20 70 72 65 70 72 6f 63 65 73 73  e the preprocess
1c20: 65 64 20 73 65 70 61 72 61 74 65 0a 73 6f 75 72  ed separate.sour
1c30: 63 65 20 66 69 6c 65 73 2c 20 67 65 74 20 74 68  ce files, get th
1c40: 6f 73 65 20 69 6e 73 74 65 61 64 2e 20 20 50 75  ose instead.  Pu
1c50: 74 20 61 6c 6c 20 74 68 65 20 73 6f 75 72 63 65  t all the source
1c60: 20 66 69 6c 65 73 20 69 6e 20 74 68 65 0a 63 68   files in the.ch
1c70: 65 63 6b 6f 75 74 20 64 69 72 65 63 74 6f 72 79  eckout directory
1c80: 20 63 72 65 61 74 65 64 20 69 6e 20 74 68 65 20   created in the 
1c90: 70 72 65 76 69 6f 75 73 20 73 74 65 70 2e 3c 2f  previous step.</
1ca0: 70 3e 0a 0a 3c 70 3e 54 68 65 20 73 6f 75 72 63  p>..<p>The sourc
1cb0: 65 20 63 6f 64 65 20 69 6e 20 70 75 62 6c 69 63  e code in public
1cc0: 20 53 51 4c 69 74 65 20 72 65 6c 65 61 73 65 73   SQLite releases
1cd0: 20 75 73 65 73 20 75 6e 69 78 20 6c 69 6e 65 20   uses unix line 
1ce0: 65 6e 64 69 6e 67 73 0a 28 41 53 43 49 49 20 63  endings.(ASCII c
1cf0: 6f 64 65 20 31 30 3a 20 22 6e 65 77 6c 69 6e 65  ode 10: "newline
1d00: 22 20 6f 6e 6c 79 2c 20 4e 4c 29 20 61 6e 64 20  " only, NL) and 
1d10: 73 70 61 63 65 73 20 69 6e 73 74 65 61 64 20 6f  spaces instead o
1d20: 66 20 74 61 62 73 2e 20 20 49 66 20 79 6f 75 20  f tabs.  If you 
1d30: 77 69 6c 6c 0a 62 65 20 63 68 61 6e 67 69 6e 67  will.be changing
1d40: 20 74 68 65 20 6c 69 6e 65 20 65 6e 64 69 6e 67   the line ending
1d50: 20 74 6f 20 77 69 6e 64 6f 77 73 2d 73 74 79 6c   to windows-styl
1d60: 65 20 6c 69 6e 65 20 65 6e 64 69 6e 67 73 0a 28  e line endings.(
1d70: 41 53 43 49 49 20 63 6f 64 65 73 20 31 33 2c 20  ASCII codes 13, 
1d80: 31 30 3a 20 22 63 61 72 72 69 61 67 65 2d 72 65  10: "carriage-re
1d90: 74 75 72 6e 22 20 61 6e 64 20 22 6e 65 77 6c 69  turn" and "newli
1da0: 6e 65 22 3b 20 43 52 2d 4e 4c 29 20 6f 72 20 69  ne"; CR-NL) or i
1db0: 66 20 79 6f 75 20 77 69 6c 6c 20 62 65 0a 63 68  f you will be.ch
1dc0: 61 6e 67 69 6e 67 20 73 70 61 63 65 20 69 6e 64  anging space ind
1dd0: 65 6e 74 73 20 69 6e 74 6f 20 74 61 62 20 69 6e  ents into tab in
1de0: 64 65 6e 74 73 2c 20 3c 62 3e 6d 61 6b 65 20 74  dents, <b>make t
1df0: 68 61 74 20 63 68 61 6e 67 65 20 6e 6f 77 3c 2f  hat change now</
1e00: 62 3e 0a 62 65 66 6f 72 65 20 79 6f 75 20 63 68  b>.before you ch
1e10: 65 63 6b 20 69 6e 20 74 68 65 20 62 61 73 65 6c  eck in the basel
1e20: 69 6e 65 2e 20 20 54 68 65 20 6d 65 72 67 69 6e  ine.  The mergin
1e30: 67 20 70 72 6f 63 65 73 73 20 77 69 6c 6c 20 6f  g process will o
1e40: 6e 6c 79 20 77 6f 72 6b 0a 77 65 6c 6c 20 69 66  nly work.well if
1e50: 20 74 68 65 20 64 69 66 66 65 72 65 6e 63 65 73   the differences
1e60: 20 62 65 74 77 65 65 6e 20 74 68 65 20 70 75 62   between the pub
1e70: 6c 69 63 20 61 6e 64 20 74 68 65 20 70 72 69 76  lic and the priv
1e80: 61 74 65 20 62 72 61 6e 63 68 65 73 20 61 72 65  ate branches are
1e90: 0a 6d 69 6e 69 6d 61 6c 2e 20 20 49 66 20 65 76  .minimal.  If ev
1ea0: 65 72 79 20 73 69 6e 67 6c 65 20 6c 69 6e 65 20  ery single line 
1eb0: 6f 66 20 74 68 65 20 73 6f 75 72 63 65 20 66 69  of the source fi
1ec0: 6c 65 20 69 73 20 63 68 61 6e 67 65 64 20 69 6e  le is changed in
1ed0: 20 74 68 65 0a 70 72 69 76 61 74 65 20 62 72 61   the.private bra
1ee0: 6e 63 68 20 62 65 63 61 75 73 65 20 79 6f 75 20  nch because you 
1ef0: 63 68 61 6e 67 65 64 20 66 72 6f 6d 20 4e 4c 20  changed from NL 
1f00: 74 6f 20 43 52 2d 4e 4c 20 6c 69 6e 65 20 65 6e  to CR-NL line en
1f10: 64 69 6e 67 73 2c 20 74 68 65 6e 0a 74 68 65 20  dings, then.the 
1f20: 6d 65 72 67 65 20 73 74 65 70 73 20 77 69 6c 6c  merge steps will
1f30: 20 6e 6f 74 20 77 6f 72 6b 20 63 6f 72 72 65 63   not work correc
1f40: 74 6c 79 2e 3c 2f 70 3e 0a 0a 3c 70 3e 4c 65 74  tly.</p>..<p>Let
1f50: 20 75 73 20 61 73 73 75 6d 65 20 74 68 61 74 20   us assume that 
1f60: 79 6f 75 20 61 72 65 20 75 73 69 6e 67 20 74 68  you are using th
1f70: 65 20 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 20 73  e amalgamation s
1f80: 6f 75 72 63 65 20 63 6f 64 65 2e 0a 41 64 64 20  ource code..Add 
1f90: 74 68 65 20 62 61 73 65 6c 69 6e 65 20 74 6f 20  the baseline to 
1fa0: 79 6f 75 72 20 70 72 6f 6a 65 63 74 20 61 73 20  your project as 
1fb0: 66 6f 6c 6c 6f 77 73 3a 3c 2f 70 3e 0a 0a 3c 62  follows:</p>..<b
1fc0: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a  lockquote><pre>.
1fd0: 66 6f 73 73 69 6c 20 61 64 64 20 73 71 6c 69 74  fossil add sqlit
1fe0: 65 33 2e 63 20 73 71 6c 69 74 65 33 2e 68 0a 3c  e3.c sqlite3.h.<
1ff0: 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74  /pre></blockquot
2000: 65 3e 0a 0a 3c 70 3e 49 66 20 79 6f 75 20 61 72  e>..<p>If you ar
2010: 65 20 75 73 69 6e 67 20 73 65 70 61 72 61 74 65  e using separate
2020: 20 73 6f 75 72 63 65 20 66 69 6c 65 73 2c 20 6e   source files, n
2030: 61 6d 65 20 61 6c 6c 20 6f 66 20 74 68 65 20 73  ame all of the s
2040: 6f 75 72 63 65 20 66 69 6c 65 73 20 69 6e 73 74  ource files inst
2050: 65 61 64 0a 6f 66 20 6a 75 73 74 20 74 68 65 20  ead.of just the 
2060: 74 77 6f 20 61 6d 61 6c 67 61 6d 61 74 69 6f 6e  two amalgamation
2070: 20 73 6f 75 72 63 65 20 66 69 6c 65 73 2e 20 20   source files.  
2080: 4f 6e 63 65 20 74 68 69 73 20 69 73 20 64 6f 6e  Once this is don
2090: 65 2c 20 63 6f 6d 6d 69 74 20 79 6f 75 72 0a 63  e, commit your.c
20a0: 68 61 6e 67 65 73 20 61 73 20 66 6f 6c 6c 6f 77  hanges as follow
20b0: 73 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75  s:</p>..<blockqu
20c0: 6f 74 65 3e 3c 70 72 65 3e 0a 66 6f 73 73 69 6c  ote><pre>.fossil
20d0: 20 63 6f 6d 6d 69 74 0a 3c 2f 70 72 65 3e 3c 2f   commit.</pre></
20e0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e  blockquote>..<p>
20f0: 59 6f 75 20 77 69 6c 6c 20 62 65 20 70 72 6f 6d  You will be prom
2100: 70 74 65 64 20 66 6f 72 20 61 20 63 68 65 63 6b  pted for a check
2110: 2d 69 6e 20 63 6f 6d 6d 65 6e 74 2e 20 20 53 61  -in comment.  Sa
2120: 79 20 77 68 61 74 65 76 65 72 20 79 6f 75 20 6c  y whatever you l
2130: 69 6b 65 2e 0a 41 66 74 65 72 20 74 68 65 20 63  ike..After the c
2140: 6f 6d 6d 69 74 20 63 6f 6d 70 6c 65 74 65 73 2c  ommit completes,
2150: 20 79 6f 75 72 20 62 61 73 65 6c 69 6e 65 20 77   your baseline w
2160: 69 6c 6c 20 62 65 20 70 61 72 74 20 6f 66 20 74  ill be part of t
2170: 68 65 20 72 65 70 6f 73 69 74 6f 72 79 2e 0a 54  he repository..T
2180: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d  he following com
2190: 6d 61 6e 64 2c 20 69 66 20 79 6f 75 20 6c 69 6b  mand, if you lik
21a0: 65 2c 20 74 6f 20 73 65 65 20 74 68 69 73 20 6f  e, to see this o
21b0: 6e 20 74 68 65 20 22 74 69 6d 65 6c 69 6e 65 22  n the "timeline"
21c0: 3a 0a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75  :.</p>..<blockqu
21d0: 6f 74 65 3e 3c 70 72 65 3e 0a 66 6f 73 73 69 6c  ote><pre>.fossil
21e0: 20 75 69 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63   ui.</pre></bloc
21f0: 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 54 68 61 74  kquote>..<p>That
2200: 20 6c 61 73 74 20 63 6f 6d 6d 61 6e 64 20 69 73   last command is
2210: 20 74 68 65 20 73 61 6d 65 20 22 75 69 22 20 63   the same "ui" c
2220: 6f 6d 6d 61 6e 64 20 74 68 61 74 20 77 65 20 72  ommand that we r
2230: 61 6e 20 62 65 66 6f 72 65 2e 20 20 49 74 0a 73  an before.  It.s
2240: 74 61 72 74 73 20 61 20 6d 69 6e 69 2d 77 65 62  tarts a mini-web
2250: 73 65 72 76 65 72 20 72 75 6e 6e 69 6e 67 20 61  server running a
2260: 6e 64 20 70 6f 69 6e 74 73 20 79 6f 75 72 20 77  nd points your w
2270: 65 62 20 62 72 6f 77 73 65 72 20 61 74 20 69 74  eb browser at it
2280: 2e 20 20 42 75 74 0a 74 68 69 73 20 74 69 6d 65  .  But.this time
2290: 20 77 65 20 64 69 64 6e 27 74 20 68 61 76 65 20   we didn't have 
22a0: 74 6f 20 73 70 65 63 69 66 79 20 74 68 65 20 72  to specify the r
22b0: 65 70 6f 73 69 74 6f 72 79 20 66 69 6c 65 20 62  epository file b
22c0: 65 63 61 75 73 65 20 77 65 20 61 72 65 0a 6c 6f  ecause we are.lo
22d0: 63 61 74 65 64 20 69 6e 73 69 64 65 20 61 20 63  cated inside a c
22e0: 68 65 63 6b 6f 75 74 20 61 6e 64 20 73 6f 20 66  heckout and so f
22f0: 6f 73 73 69 6c 20 63 61 6e 20 66 69 67 75 72 65  ossil can figure
2300: 20 6f 75 74 20 74 68 65 20 72 65 70 6f 73 69 74   out the reposit
2310: 6f 72 79 20 66 6f 72 0a 69 74 73 65 6c 66 2e 20  ory for.itself. 
2320: 20 49 66 20 79 6f 75 20 77 61 6e 74 20 74 6f 20   If you want to 
2330: 74 79 70 65 20 69 6e 20 74 68 65 20 72 65 70 6f  type in the repo
2340: 73 69 74 6f 72 79 20 66 69 6c 65 6e 61 6d 65 20  sitory filename 
2350: 61 73 20 74 68 65 20 73 65 63 6f 6e 64 0a 61 72  as the second.ar
2360: 67 75 6d 65 6e 74 2c 20 79 6f 75 20 63 61 6e 2e  gument, you can.
2370: 20 20 42 75 74 20 69 74 20 69 73 20 6f 70 74 69    But it is opti
2380: 6f 6e 61 6c 2e 3c 2f 70 3e 0a 0a 3c 70 3e 49 66  onal.</p>..<p>If
2390: 20 79 6f 75 20 64 6f 20 6e 6f 74 20 77 61 6e 74   you do not want
23a0: 20 74 6f 20 75 73 65 20 79 6f 75 72 20 77 65 62   to use your web
23b0: 20 62 72 6f 77 73 65 72 20 74 6f 20 76 69 65 77   browser to view
23c0: 20 74 68 65 20 6e 65 77 20 63 68 65 63 6b 2d 69   the new check-i
23d0: 6e 2c 0a 79 6f 75 20 63 61 6e 20 67 65 74 20 73  n,.you can get s
23e0: 6f 6d 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20  ome information 
23f0: 66 72 6f 6d 20 74 68 65 20 63 6f 6d 6d 61 6e 64  from the command
2400: 2d 6c 69 6e 65 20 75 73 69 6e 67 20 63 6f 6d 6d  -line using comm
2410: 61 6e 64 73 20 6c 69 6b 65 0a 74 68 65 73 65 3a  ands like.these:
2420: 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70  ..<blockquote><p
2430: 72 65 3e 0a 66 6f 73 73 69 6c 20 74 69 6d 65 6c  re>.fossil timel
2440: 69 6e 65 0a 66 6f 73 73 69 6c 20 69 6e 66 6f 0a  ine.fossil info.
2450: 66 6f 73 73 69 6c 20 73 74 61 74 75 73 0a 3c 2f  fossil status.</
2460: 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65  pre></blockquote
2470: 3e 0a 0a 3c 68 32 3e 20 43 72 65 61 74 69 6e 67  >..<h2> Creating
2480: 20 54 68 65 20 50 72 69 76 61 74 65 20 42 72 61   The Private Bra
2490: 6e 63 68 3c 2f 68 32 3e 0a 0a 3c 70 3e 54 68 65  nch</h2>..<p>The
24a0: 20 70 72 65 76 69 6f 75 73 20 73 74 65 70 20 63   previous step c
24b0: 72 65 61 74 65 64 20 63 69 72 63 6c 65 20 28 31  reated circle (1
24c0: 29 20 69 6e 20 74 68 65 20 64 69 61 67 72 61 6d  ) in the diagram
24d0: 20 61 62 6f 76 65 2e 0a 54 68 69 73 20 73 74 65   above..This ste
24e0: 70 20 77 69 6c 6c 20 63 72 65 61 74 65 20 63 69  p will create ci
24f0: 72 63 6c 65 20 28 32 29 2e 20 20 52 75 6e 20 74  rcle (2).  Run t
2500: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d  he following com
2510: 6d 61 6e 64 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63  mand:</p>..<bloc
2520: 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 20 0a 66 6f  kquote><pre> .fo
2530: 73 73 69 6c 20 62 72 61 6e 63 68 20 6e 65 77 20  ssil branch new 
2540: 70 72 69 76 61 74 65 20 74 72 75 6e 6b 20 2d 62  private trunk -b
2550: 67 63 6f 6c 6f 72 20 22 23 61 64 64 38 65 38 22  gcolor "#add8e8"
2560: 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75  .</pre></blockqu
2570: 6f 74 65 3e 0a 0a 3c 70 3e 54 68 69 73 20 63 6f  ote>..<p>This co
2580: 6d 6d 61 6e 64 20 77 69 6c 6c 20 63 72 65 61 74  mmand will creat
2590: 65 20 61 20 6e 65 77 20 62 72 61 6e 63 68 20 6e  e a new branch n
25a0: 61 6d 65 64 20 22 70 72 69 76 61 74 65 22 20 28  amed "private" (
25b0: 79 6f 75 20 63 61 6e 20 75 73 65 0a 61 20 64 69  you can use.a di
25c0: 66 66 65 72 65 6e 74 20 6e 61 6d 65 20 69 66 20  fferent name if 
25d0: 79 6f 75 20 6c 69 6b 65 29 20 61 6e 64 20 61 73  you like) and as
25e0: 73 69 67 6e 20 69 74 20 61 20 62 61 63 6b 67 72  sign it a backgr
25f0: 6f 75 6e 64 20 63 6f 6c 6f 72 0a 6f 66 20 6c 69  ound color.of li
2600: 67 68 74 20 62 6c 75 65 20 28 22 23 61 64 64 38  ght blue ("#add8
2610: 65 38 22 29 2e 20 20 59 6f 75 20 63 61 6e 20 6f  e8").  You can o
2620: 6d 69 74 20 74 68 65 20 62 61 63 6b 67 72 6f 75  mit the backgrou
2630: 6e 64 20 63 6f 6c 6f 72 20 69 66 20 79 6f 75 20  nd color if you 
2640: 77 61 6e 74 2c 0a 74 68 6f 75 67 68 20 68 61 76  want,.though hav
2650: 69 6e 67 20 61 20 64 69 73 74 69 6e 63 74 20 62  ing a distinct b
2660: 61 63 6b 67 72 6f 75 6e 64 20 64 6f 65 73 20 6d  ackground does m
2670: 61 6b 65 20 69 74 20 65 61 73 69 65 72 20 74 6f  ake it easier to
2680: 20 74 65 6c 6c 20 74 68 65 0a 62 72 61 6e 63 68   tell the.branch
2690: 20 66 72 6f 6d 20 74 68 65 20 22 74 72 75 6e 6b   from the "trunk
26a0: 22 20 28 74 68 65 20 70 75 62 6c 69 63 20 62 72  " (the public br
26b0: 61 6e 63 68 29 20 6f 6e 20 74 69 6d 65 6c 69 6e  anch) on timelin
26c0: 65 20 64 69 73 70 6c 61 79 73 2e 20 20 59 6f 75  e displays.  You
26d0: 0a 63 61 6e 20 63 68 61 6e 67 65 20 74 68 65 20  .can change the 
26e0: 62 61 63 6b 67 72 6f 75 6e 64 20 63 6f 6c 6f 72  background color
26f0: 20 6f 66 20 74 68 65 20 70 72 69 76 61 74 65 20   of the private 
2700: 62 72 61 6e 63 68 20 6f 72 20 6f 66 20 74 68 65  branch or of the
2710: 20 70 75 62 6c 69 63 0a 62 72 61 6e 63 68 20 28   public.branch (
2720: 74 68 65 20 22 74 72 75 6e 6b 22 29 20 75 73 69  the "trunk") usi
2730: 6e 67 20 74 68 65 20 77 65 62 20 69 6e 74 65 72  ng the web inter
2740: 66 61 63 65 20 69 66 20 79 6f 75 20 6c 69 6b 65  face if you like
2750: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 63 6f  .</p>..<p>The co
2760: 6d 6d 61 6e 64 20 61 62 6f 76 65 20 63 72 65 61  mmand above crea
2770: 74 65 64 20 74 68 65 20 6e 65 77 20 62 72 61 6e  ted the new bran
2780: 63 68 2e 20 20 42 75 74 20 79 6f 75 72 20 63 68  ch.  But your ch
2790: 65 63 6b 6f 75 74 20 69 73 0a 73 74 69 6c 6c 20  eckout is.still 
27a0: 6f 6e 20 74 68 65 20 74 72 75 6e 6b 20 2d 20 61  on the trunk - a
27b0: 20 66 61 63 74 20 79 6f 75 20 63 61 6e 20 73 65   fact you can se
27c0: 65 20 62 79 20 72 75 6e 6e 69 6e 67 20 74 68 65  e by running the
27d0: 20 63 6f 6d 6d 61 6e 64 3a 3c 2f 70 3e 0a 0a 3c   command:</p>..<
27e0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e  blockquote><pre>
27f0: 0a 66 6f 73 73 69 6c 20 69 6e 66 6f 0a 3c 2f 70  .fossil info.</p
2800: 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e  re></blockquote>
2810: 0a 0a 3c 70 3e 54 6f 20 63 68 61 6e 67 65 20 79  ..<p>To change y
2820: 6f 75 72 20 63 68 65 63 6b 2d 6f 75 74 20 74 6f  our check-out to
2830: 20 74 68 65 20 70 72 69 76 61 74 65 20 62 72 61   the private bra
2840: 6e 63 68 2c 20 74 79 70 65 3a 3c 2f 70 3e 0a 0a  nch, type:</p>..
2850: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65  <blockquote><pre
2860: 3e 0a 66 6f 73 73 69 6c 20 75 70 64 61 74 65 20  >.fossil update 
2870: 70 72 69 76 61 74 65 0a 3c 2f 70 72 65 3e 3c 2f  private.</pre></
2880: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e  blockquote>..<p>
2890: 59 6f 75 20 63 61 6e 20 72 75 6e 20 74 68 65 20  You can run the 
28a0: 22 69 6e 66 6f 22 20 63 6f 6d 6d 61 6e 64 20 61  "info" command a
28b0: 67 61 69 6e 20 74 6f 20 76 65 72 69 66 79 20 74  gain to verify t
28c0: 68 61 74 20 79 6f 75 20 61 72 65 20 6f 6e 20 74  hat you are on t
28d0: 68 65 0a 70 72 69 76 61 74 65 20 62 72 61 6e 63  he.private branc
28e0: 68 2e 20 20 54 6f 20 67 6f 20 62 61 63 6b 20 74  h.  To go back t
28f0: 6f 20 74 68 65 20 70 75 62 6c 69 63 20 62 72 61  o the public bra
2900: 6e 63 68 2c 20 74 79 70 65 3a 3c 2f 70 3e 0a 0a  nch, type:</p>..
2910: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65  <blockquote><pre
2920: 3e 0a 66 6f 73 73 69 6c 20 75 70 64 61 74 65 20  >.fossil update 
2930: 74 72 75 6e 6b 0a 3c 2f 70 72 65 3e 3c 2f 62 6c  trunk.</pre></bl
2940: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 4e 6f  ockquote>..<p>No
2950: 72 6d 61 6c 6c 79 2c 20 66 6f 73 73 69 6c 20 77  rmally, fossil w
2960: 69 6c 6c 20 6d 6f 64 69 66 79 20 61 6c 6c 20 74  ill modify all t
2970: 68 65 20 66 69 6c 65 73 20 69 6e 20 79 6f 75 72  he files in your
2980: 20 63 68 65 63 6b 6f 75 74 20 77 68 65 6e 20 73   checkout when s
2990: 77 69 74 63 68 69 6e 67 0a 62 65 74 77 65 65 6e  witching.between
29a0: 20 74 68 65 20 70 72 69 76 61 74 65 20 61 6e 64   the private and
29b0: 20 74 68 65 20 70 75 62 6c 69 63 20 62 72 61 6e   the public bran
29c0: 63 68 65 73 2e 20 20 42 75 74 20 61 74 20 74 68  ches.  But at th
29d0: 69 73 20 70 6f 69 6e 74 2c 20 74 68 65 20 66 69  is point, the fi
29e0: 6c 65 73 0a 61 72 65 20 69 64 65 6e 74 69 63 61  les.are identica
29f0: 6c 20 69 6e 20 62 6f 74 68 20 62 72 61 6e 63 68  l in both branch
2a00: 65 73 20 73 6f 20 6e 6f 74 20 6d 6f 64 69 66 69  es so not modifi
2a10: 63 61 74 69 6f 6e 73 20 6e 65 65 64 20 74 6f 20  cations need to 
2a20: 62 65 20 6d 61 64 65 2e 3c 2f 70 3e 0a 0a 3c 68  be made.</p>..<h
2a30: 32 3e 20 41 64 64 69 6e 67 20 43 75 73 74 6f 6d  2> Adding Custom
2a40: 69 7a 61 74 69 6f 6e 73 20 54 6f 20 54 68 65 20  izations To The 
2a50: 43 6f 64 65 20 49 6e 20 54 68 65 20 50 72 69 76  Code In The Priv
2a60: 61 74 65 20 42 72 61 6e 63 68 3c 2f 68 32 3e 0a  ate Branch</h2>.
2a70: 0a 3c 70 3e 4e 6f 77 20 69 74 20 69 73 20 74 69  .<p>Now it is ti
2a80: 6d 65 20 74 6f 20 6d 61 6b 65 20 74 68 65 20 70  me to make the p
2a90: 72 69 76 61 74 65 2c 20 63 75 73 74 6f 6d 20 6d  rivate, custom m
2aa0: 6f 64 69 66 69 63 61 74 69 6f 6e 73 20 74 6f 20  odifications to 
2ab0: 53 51 4c 69 74 65 0a 77 68 69 63 68 20 61 72 65  SQLite.which are
2ac0: 20 74 68 65 20 77 68 6f 6c 65 20 70 6f 69 6e 74   the whole point
2ad0: 20 6f 66 20 74 68 69 73 20 65 78 65 72 63 69 73   of this exercis
2ae0: 65 2e 20 20 53 77 69 74 63 68 20 74 6f 20 74 68  e.  Switch to th
2af0: 65 20 70 72 69 76 61 74 65 20 62 72 61 6e 63 68  e private branch
2b00: 0a 28 69 66 20 79 6f 75 20 61 72 65 20 6e 6f 74  .(if you are not
2b10: 20 61 6c 72 65 61 64 79 20 74 68 65 72 65 29 20   already there) 
2b20: 75 73 69 6e 67 20 74 68 65 20 22 3c 74 74 3e 66  using the "<tt>f
2b30: 6f 73 73 69 6c 20 75 70 64 61 74 65 20 70 72 69  ossil update pri
2b40: 76 61 74 65 3c 2f 74 74 3e 22 0a 63 6f 6d 6d 61  vate</tt>".comma
2b50: 6e 64 2c 20 74 68 65 6e 20 62 72 69 6e 67 20 75  nd, then bring u
2b60: 70 20 74 68 65 20 73 6f 75 72 63 65 20 66 69 6c  p the source fil
2b70: 65 73 20 69 6e 20 79 6f 75 72 20 74 65 78 74 20  es in your text 
2b80: 65 64 69 74 6f 72 20 61 6e 64 20 6d 61 6b 65 0a  editor and make.
2b90: 77 68 61 74 65 76 65 72 20 63 68 61 6e 67 65 73  whatever changes
2ba0: 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 6d 61 6b   you want to mak
2bb0: 65 2e 20 20 4f 6e 63 65 20 79 6f 75 20 68 61 76  e.  Once you hav
2bc0: 65 20 66 69 6e 69 73 68 65 64 20 6d 61 6b 69 6e  e finished makin
2bd0: 67 0a 63 68 61 6e 67 65 73 2c 20 63 6f 6d 6d 69  g.changes, commi
2be0: 74 20 74 68 6f 73 65 20 63 68 61 6e 67 65 73 20  t those changes 
2bf0: 75 73 69 6e 67 20 74 68 69 73 20 63 6f 6d 6d 61  using this comma
2c00: 6e 64 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71  nd:</p>..<blockq
2c10: 75 6f 74 65 3e 3c 70 72 65 3e 0a 66 6f 73 73 69  uote><pre>.fossi
2c20: 6c 20 63 6f 6d 6d 69 74 0a 3c 2f 70 72 65 3e 3c  l commit.</pre><
2c30: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70  /blockquote>..<p
2c40: 3e 59 6f 75 20 77 69 6c 6c 20 62 65 20 70 72 6f  >You will be pro
2c50: 6d 70 74 65 64 20 6f 6e 63 65 20 61 67 61 69 6e  mpted once again
2c60: 20 74 6f 20 65 6e 74 65 72 20 61 20 63 6f 6d 6d   to enter a comm
2c70: 69 74 20 64 65 73 63 72 69 62 69 6e 67 20 79 6f  it describing yo
2c80: 75 72 0a 63 68 61 6e 67 65 73 2e 20 20 54 68 65  ur.changes.  The
2c90: 6e 20 74 68 65 20 63 6f 6d 6d 69 74 20 77 69 6c  n the commit wil
2ca0: 6c 20 6f 63 63 75 72 2e 20 20 54 68 65 20 63 6f  l occur.  The co
2cb0: 6d 6d 69 74 20 63 72 65 61 74 65 73 20 61 20 6e  mmit creates a n
2cc0: 65 77 20 63 68 65 63 6b 69 6e 0a 69 6e 20 74 68  ew checkin.in th
2cd0: 65 20 72 65 70 6f 73 69 74 6f 72 79 20 74 68 61  e repository tha
2ce0: 74 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f  t corresponds to
2cf0: 20 63 69 72 63 6c 65 20 28 33 29 20 69 6e 20 74   circle (3) in t
2d00: 68 65 20 64 69 61 67 72 61 6d 20 61 62 6f 76 65  he diagram above
2d10: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 4e 6f 77 20 74 68  .</p>..<p>Now th
2d20: 61 74 20 74 68 65 20 70 75 62 6c 69 63 20 61 6e  at the public an
2d30: 64 20 70 72 69 76 61 74 65 20 62 72 61 6e 63 68  d private branch
2d40: 65 73 20 61 72 65 20 64 69 66 66 65 72 65 6e 74  es are different
2d50: 2c 20 79 6f 75 20 63 61 6e 20 72 75 6e 0a 74 68  , you can run.th
2d60: 65 20 22 3c 74 74 3e 66 6f 73 73 69 6c 20 75 70  e "<tt>fossil up
2d70: 64 61 74 65 20 74 72 75 6e 6b 3c 2f 74 74 3e 22  date trunk</tt>"
2d80: 20 61 6e 64 20 22 3c 74 74 3e 66 6f 73 73 69 6c   and "<tt>fossil
2d90: 20 75 70 64 61 74 65 20 70 72 69 76 61 74 65 3c   update private<
2da0: 2f 74 74 3e 22 0a 63 6f 6d 6d 61 6e 64 73 20 61  /tt>".commands a
2db0: 6e 64 20 73 65 65 20 74 68 61 74 20 66 6f 73 73  nd see that foss
2dc0: 69 6c 20 72 65 61 6c 6c 79 20 64 6f 65 73 20 63  il really does c
2dd0: 68 61 6e 67 65 20 74 68 65 20 66 69 6c 65 73 20  hange the files 
2de0: 69 6e 20 74 68 65 20 63 68 65 63 6b 6f 75 74 0a  in the checkout.
2df0: 61 73 20 79 6f 75 20 73 77 69 74 63 68 20 62 61  as you switch ba
2e00: 63 6b 20 61 6e 64 20 66 6f 72 74 68 20 62 65 74  ck and forth bet
2e10: 77 65 65 6e 20 62 72 61 6e 63 68 65 73 2e 3c 2f  ween branches.</
2e20: 70 3e 0a 0a 3c 70 3e 4e 6f 74 65 20 74 68 61 74  p>..<p>Note that
2e30: 20 69 6e 20 74 68 65 20 64 69 61 67 72 61 6d 20   in the diagram 
2e40: 61 62 6f 76 65 2c 20 77 65 20 73 68 6f 77 65 64  above, we showed
2e50: 20 74 68 65 20 70 72 69 76 61 74 65 20 65 64 69   the private edi
2e60: 74 73 20 61 73 20 61 20 73 69 6e 67 6c 65 0a 63  ts as a single.c
2e70: 6f 6d 6d 69 74 2e 20 20 54 68 69 73 20 77 61 73  ommit.  This was
2e80: 20 66 6f 72 20 63 6c 61 72 69 74 79 20 6f 66 20   for clarity of 
2e90: 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 6f 6e 6c  presentation onl
2ea0: 79 2e 20 20 54 68 65 72 65 20 69 73 20 6e 6f 74  y.  There is not
2eb0: 68 69 6e 67 20 74 6f 20 73 74 6f 70 0a 79 6f 75  hing to stop.you
2ec0: 20 66 72 6f 6d 20 64 6f 69 6e 67 20 64 6f 7a 65   from doing doze
2ed0: 6e 73 20 6f 72 20 68 75 6e 64 72 65 64 73 20 6f  ns or hundreds o
2ee0: 66 20 73 65 70 61 72 61 74 65 20 74 69 6e 79 20  f separate tiny 
2ef0: 63 68 61 6e 67 65 73 20 61 6e 64 20 63 6f 6d 6d  changes and comm
2f00: 69 74 74 69 6e 67 0a 65 61 63 68 20 73 65 70 61  itting.each sepa
2f10: 72 61 74 65 6c 79 2e 20 20 49 6e 20 66 61 63 74  rately.  In fact
2f20: 2c 20 6d 61 6b 69 6e 67 20 6d 61 6e 79 20 73 6d  , making many sm
2f30: 61 6c 6c 20 63 68 61 6e 67 65 73 20 69 73 20 74  all changes is t
2f40: 68 65 20 70 72 65 66 65 72 72 65 64 20 77 61 79  he preferred way
2f50: 0a 74 6f 20 77 6f 72 6b 2e 20 20 54 68 65 20 6f  .to work.  The o
2f60: 6e 6c 79 20 72 65 61 73 6f 6e 20 66 6f 72 20 64  nly reason for d
2f70: 6f 69 6e 67 20 61 6c 6c 20 74 68 65 20 63 68 61  oing all the cha
2f80: 6e 67 65 73 20 69 6e 20 61 20 73 69 6e 67 6c 65  nges in a single
2f90: 20 63 6f 6d 6d 69 74 0a 69 73 20 74 68 61 74 20   commit.is that 
2fa0: 69 74 20 6d 61 6b 65 73 20 74 68 65 20 64 69 61  it makes the dia
2fb0: 67 72 61 6d 20 65 61 73 69 65 72 20 74 6f 20 64  gram easier to d
2fc0: 72 61 77 2e 3c 2f 70 3e 0a 0a 3c 68 32 3e 20 49  raw.</p>..<h2> I
2fd0: 6e 63 6f 72 70 6f 72 61 74 69 6e 67 20 4e 65 77  ncorporating New
2fe0: 20 50 75 62 6c 69 63 20 53 51 4c 69 74 65 20 52   Public SQLite R
2ff0: 65 6c 65 61 73 65 73 3c 2f 68 32 3e 0a 0a 3c 70  eleases</h2>..<p
3000: 3e 53 75 70 70 6f 73 65 20 74 68 61 74 20 61 66  >Suppose that af
3010: 74 65 72 20 61 20 77 68 69 6c 65 20 28 61 62 6f  ter a while (abo
3020: 75 74 20 61 20 6d 6f 6e 74 68 2c 20 75 73 75 61  ut a month, usua
3030: 6c 6c 79 29 20 61 20 6e 65 77 20 76 65 72 73 69  lly) a new versi
3040: 6f 6e 20 6f 66 0a 53 51 4c 69 74 65 20 69 73 20  on of.SQLite is 
3050: 72 65 6c 65 61 73 65 64 3a 20 33 2e 36 2e 31 36  released: 3.6.16
3060: 2e 20 20 59 6f 75 20 77 69 6c 6c 20 77 61 6e 74  .  You will want
3070: 20 74 6f 20 69 6e 63 6f 72 70 6f 72 61 74 65 20   to incorporate 
3080: 74 68 69 73 20 6e 65 77 0a 70 75 62 6c 69 63 20  this new.public 
3090: 76 65 72 73 69 6f 6e 20 6f 66 20 53 51 4c 69 74  version of SQLit
30a0: 65 20 69 6e 74 6f 20 79 6f 75 72 20 72 65 70 6f  e into your repo
30b0: 73 69 74 6f 72 79 20 69 6e 20 74 68 65 20 70 75  sitory in the pu
30c0: 62 6c 69 63 20 62 72 61 6e 63 68 20 28 74 68 65  blic branch (the
30d0: 0a 74 72 75 6e 6b 29 2e 20 20 54 6f 20 64 6f 20  .trunk).  To do 
30e0: 74 68 69 73 2c 20 66 69 72 73 74 20 63 68 61 6e  this, first chan
30f0: 67 65 20 79 6f 75 72 20 72 65 70 6f 73 69 74 6f  ge your reposito
3100: 72 79 20 6f 76 65 72 20 74 6f 20 74 68 65 20 74  ry over to the t
3110: 72 75 6e 6b 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63  runk:</p>..<bloc
3120: 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a 66 6f 73  kquote><pre>.fos
3130: 73 69 6c 20 75 70 64 61 74 65 20 74 72 75 6e 6b  sil update trunk
3140: 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75  .</pre></blockqu
3150: 6f 74 65 3e 0a 0a 3c 70 3e 54 68 65 6e 20 64 6f  ote>..<p>Then do
3160: 77 6e 6c 6f 61 64 20 74 68 65 20 6e 65 77 20 76  wnload the new v
3170: 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 53 51  ersion of the SQ
3180: 4c 69 74 65 20 73 6f 75 72 63 65 73 20 61 6e 64  Lite sources and
3190: 20 6f 76 65 72 77 72 69 74 65 20 74 68 65 0a 66   overwrite the.f
31a0: 69 6c 65 73 20 74 68 61 74 20 61 72 65 20 69 6e  iles that are in
31b0: 20 74 68 65 20 63 68 65 63 6b 6f 75 74 2e 3c 70   the checkout.<p
31c0: 3e 0a 0a 3c 70 3e 49 66 20 79 6f 75 20 6d 61 64  >..<p>If you mad
31d0: 65 20 4e 4c 20 74 6f 20 43 52 2d 4e 4c 20 6c 69  e NL to CR-NL li
31e0: 6e 65 20 65 6e 64 69 6e 67 20 63 68 61 6e 67 65  ne ending change
31f0: 73 20 6f 72 20 73 70 61 63 65 20 74 6f 20 74 61  s or space to ta
3200: 62 0a 69 6e 64 65 6e 74 61 74 69 6f 6e 20 63 68  b.indentation ch
3210: 61 6e 67 65 73 20 69 6e 20 74 68 65 20 6f 72 69  anges in the ori
3220: 67 69 6e 61 6c 20 62 61 73 65 6c 69 6e 65 2c 20  ginal baseline, 
3230: 6d 61 6b 65 20 74 68 65 20 73 61 6d 65 20 63 68  make the same ch
3240: 61 6e 67 65 73 0a 74 6f 20 74 68 65 20 6e 65 77  anges.to the new
3250: 20 73 6f 75 72 63 65 20 66 69 6c 65 2e 3c 2f 70   source file.</p
3260: 3e 0a 0a 3c 70 3e 4f 6e 63 65 20 65 76 65 72 79  >..<p>Once every
3270: 74 68 69 6e 67 20 69 73 20 72 65 61 64 79 2c 20  thing is ready, 
3280: 72 75 6e 20 74 68 65 20 22 3c 74 74 3e 66 6f 73  run the "<tt>fos
3290: 73 69 6c 20 63 6f 6d 6d 69 74 3c 2f 74 74 3e 22  sil commit</tt>"
32a0: 20 63 6f 6d 6d 61 6e 64 20 74 6f 0a 63 68 65 63   command to.chec
32b0: 6b 20 69 6e 20 74 68 65 20 63 68 61 6e 67 65 73  k in the changes
32c0: 2e 20 20 54 68 69 73 20 63 72 65 61 74 65 73 20  .  This creates 
32d0: 63 69 72 63 6c 65 20 28 34 29 20 69 6e 20 74 68  circle (4) in th
32e0: 65 20 64 69 61 67 72 61 6d 20 61 62 6f 76 65 2e  e diagram above.
32f0: 3c 2f 70 3e 0a 0a 3c 68 32 3e 20 4d 65 72 67 69  </p>..<h2> Mergi
3300: 6e 67 20 50 75 62 6c 69 63 20 53 51 4c 69 74 65  ng Public SQLite
3310: 20 55 70 64 61 74 65 73 20 49 6e 74 6f 20 54 68   Updates Into Th
3320: 65 20 50 72 69 76 61 74 65 20 42 72 61 6e 63 68  e Private Branch
3330: 3c 2f 68 32 3e 0a 0a 3c 70 3e 54 68 65 20 6e 65  </h2>..<p>The ne
3340: 78 74 20 73 74 65 70 20 69 73 20 74 6f 20 6d 6f  xt step is to mo
3350: 76 65 20 74 68 65 20 63 68 61 6e 67 65 73 20 69  ve the changes i
3360: 6e 20 74 68 65 20 70 75 62 6c 69 63 20 62 72 61  n the public bra
3370: 6e 63 68 20 6f 76 65 72 20 69 6e 74 6f 0a 74 68  nch over into.th
3380: 65 20 70 72 69 76 61 74 65 20 62 72 61 6e 63 68  e private branch
3390: 2e 20 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64  .  In other word
33a0: 73 2c 20 77 65 20 77 61 6e 74 20 74 6f 20 63 72  s, we want to cr
33b0: 65 61 74 65 20 63 69 72 63 6c 65 20 28 35 29 20  eate circle (5) 
33c0: 69 6e 20 74 68 65 0a 64 69 61 67 72 61 6d 20 61  in the.diagram a
33d0: 62 6f 76 65 2e 20 20 42 65 67 69 6e 20 62 79 20  bove.  Begin by 
33e0: 63 68 61 6e 67 69 6e 67 20 74 6f 20 74 68 65 20  changing to the 
33f0: 70 72 69 76 61 74 65 20 62 72 61 6e 63 68 20 75  private branch u
3400: 73 69 6e 67 0a 22 3c 74 74 3e 66 6f 73 73 69 6c  sing."<tt>fossil
3410: 20 75 70 64 61 74 65 20 70 72 69 76 61 74 65 3c   update private<
3420: 2f 74 74 3e 22 2e 20 20 54 68 65 6e 20 74 79 70  /tt>".  Then typ
3430: 65 20 74 68 69 73 20 63 6f 6d 6d 61 6e 64 3a 3c  e this command:<
3440: 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65  /p>..<blockquote
3450: 3e 3c 70 72 65 3e 0a 66 6f 73 73 69 6c 20 6d 65  ><pre>.fossil me
3460: 72 67 65 20 74 72 75 6e 6b 0a 3c 2f 70 72 65 3e  rge trunk.</pre>
3470: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c  </blockquote>..<
3480: 70 3e 54 68 65 20 22 6d 65 72 67 65 22 20 63 6f  p>The "merge" co
3490: 6d 6d 61 6e 64 20 61 74 74 65 6d 70 74 73 20 74  mmand attempts t
34a0: 6f 20 61 70 70 6c 79 20 61 6c 6c 20 74 68 65 20  o apply all the 
34b0: 63 68 61 6e 67 65 73 20 62 65 74 77 65 65 6e 0a  changes between.
34c0: 63 69 72 63 6c 65 73 20 28 31 29 20 61 6e 64 20  circles (1) and 
34d0: 28 34 29 20 74 6f 20 74 68 65 20 66 69 6c 65 73  (4) to the files
34e0: 20 69 6e 20 74 68 65 20 6c 6f 63 61 6c 20 63 68   in the local ch
34f0: 65 63 6b 6f 75 74 2e 20 20 4e 6f 74 65 20 74 68  eckout.  Note th
3500: 61 74 0a 63 69 72 63 6c 65 20 28 35 29 20 68 61  at.circle (5) ha
3510: 73 20 6e 6f 74 20 62 65 65 6e 20 63 72 65 61 74  s not been creat
3520: 65 64 20 79 65 74 2e 20 20 59 6f 75 20 77 69 6c  ed yet.  You wil
3530: 6c 20 6e 65 65 64 20 74 6f 20 72 75 6e 20 74 68  l need to run th
3540: 65 0a 22 63 6f 6d 6d 69 74 22 20 74 6f 20 63 72  e."commit" to cr
3550: 65 61 74 65 20 63 69 72 63 6c 65 20 28 35 29 2e  eate circle (5).
3560: 3c 2f 70 3e 0a 0a 3c 70 3e 49 74 20 6d 69 67 68  </p>..<p>It migh
3570: 74 20 62 65 20 74 68 61 74 20 74 68 65 72 65 20  t be that there 
3580: 61 72 65 20 63 6f 6e 66 6c 69 63 74 73 20 69 6e  are conflicts in
3590: 20 74 68 65 20 6d 65 72 67 65 2e 20 20 43 6f 6e   the merge.  Con
35a0: 66 6c 69 63 74 73 0a 6f 63 63 75 72 20 77 68 65  flicts.occur whe
35b0: 6e 20 74 68 65 20 73 61 6d 65 20 6c 69 6e 65 20  n the same line 
35c0: 6f 66 20 63 6f 64 65 20 77 61 73 20 63 68 61 6e  of code was chan
35d0: 67 65 64 20 69 6e 20 64 69 66 66 65 72 65 6e 74  ged in different
35e0: 20 77 61 79 73 20 62 65 74 77 65 65 6e 0a 63 69   ways between.ci
35f0: 72 63 6c 65 73 20 28 31 29 20 61 6e 64 20 28 34  rcles (1) and (4
3600: 29 20 76 65 72 73 75 73 20 63 69 72 63 6c 65 73  ) versus circles
3610: 20 28 32 29 20 61 6e 64 20 28 33 29 2e 20 20 54   (2) and (3).  T
3620: 68 65 20 6d 65 72 67 65 20 63 6f 6d 6d 61 6e 64  he merge command
3630: 20 77 69 6c 6c 0a 61 6e 6e 6f 75 6e 63 65 20 61   will.announce a
3640: 6e 79 20 63 6f 6e 66 6c 69 63 74 73 20 61 6e 64  ny conflicts and
3650: 20 77 69 6c 6c 20 69 6e 63 6c 75 64 65 20 62 6f   will include bo
3660: 74 68 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 74  th versions of t
3670: 68 65 20 63 6f 6e 66 6c 69 63 74 69 6e 67 0a 6c  he conflicting.l
3680: 69 6e 65 73 20 69 6e 20 74 68 65 20 6f 75 74 70  ines in the outp
3690: 75 74 2e 20 20 59 6f 75 20 77 69 6c 6c 20 6e 65  ut.  You will ne
36a0: 65 64 20 74 6f 20 62 72 69 6e 67 20 75 70 20 74  ed to bring up t
36b0: 68 65 20 66 69 6c 65 73 20 74 68 61 74 20 63 6f  he files that co
36c0: 6e 74 61 69 6e 0a 63 6f 6e 66 6c 69 63 74 73 20  ntain.conflicts 
36d0: 61 6e 64 20 6d 61 6e 75 61 6c 6c 79 20 72 65 73  and manually res
36e0: 6f 6c 76 65 20 74 68 65 20 63 6f 6e 66 6c 69 63  olve the conflic
36f0: 74 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e 41 66 74 65  ts.</p>..<p>Afte
3700: 72 20 72 65 73 6f 6c 76 69 6e 67 20 63 6f 6e 66  r resolving conf
3710: 6c 69 63 74 73 2c 20 6d 61 6e 79 20 75 73 65 72  licts, many user
3720: 73 20 6c 69 6b 65 20 74 6f 20 63 6f 6d 70 69 6c  s like to compil
3730: 65 20 61 6e 64 20 74 65 73 74 20 74 68 65 0a 6e  e and test the.n
3740: 65 77 20 76 65 72 73 69 6f 6e 20 62 65 66 6f 72  ew version befor
3750: 65 20 63 6f 6d 6d 69 74 74 69 6e 67 20 69 74 20  e committing it 
3760: 74 6f 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72  to the repositor
3770: 79 2e 20 20 4f 72 20 79 6f 75 20 63 61 6e 20 63  y.  Or you can c
3780: 6f 6d 6d 69 74 0a 66 69 72 73 74 20 61 6e 64 20  ommit.first and 
3790: 74 65 73 74 20 6c 61 74 65 72 2e 20 20 45 69 74  test later.  Eit
37a0: 68 65 72 20 77 61 79 2c 20 72 75 6e 20 74 68 65  her way, run the
37b0: 20 22 3c 74 74 3e 66 6f 73 73 69 6c 20 63 6f 6d   "<tt>fossil com
37c0: 6d 69 74 3c 2f 74 74 3e 22 0a 63 6f 6d 6d 61 6e  mit</tt>".comman
37d0: 64 20 74 6f 20 63 68 65 63 6b 2d 69 6e 20 74 68  d to check-in th
37e0: 65 20 63 69 72 63 6c 65 20 28 35 29 20 76 65 72  e circle (5) ver
37f0: 73 69 6f 6e 2e 0a 0a 3c 68 32 3e 20 46 75 72 74  sion...<h2> Furt
3800: 68 65 72 20 55 70 64 61 74 65 73 3c 2f 68 32 3e  her Updates</h2>
3810: 0a 0a 3c 70 3e 41 73 20 6e 65 77 20 76 65 72 73  ..<p>As new vers
3820: 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 61  ions of SQLite a
3830: 72 65 20 72 65 6c 65 61 73 65 64 2c 20 72 65 70  re released, rep
3840: 65 61 74 20 73 74 65 70 73 20 33 2e 36 20 61 6e  eat steps 3.6 an
3850: 64 20 33 2e 37 20 74 6f 0a 61 64 64 20 63 68 61  d 3.7 to.add cha
3860: 6e 67 65 73 20 69 6e 20 74 68 65 20 6e 65 77 20  nges in the new 
3870: 72 65 6c 65 61 73 65 20 74 6f 20 74 68 65 20 70  release to the p
3880: 72 69 76 61 74 65 20 62 72 61 6e 63 68 2e 0a 41  rivate branch..A
3890: 64 64 69 74 69 6f 6e 61 6c 20 70 72 69 76 61 74  dditional privat
38a0: 65 20 63 68 61 6e 67 65 73 20 63 61 6e 20 62 65  e changes can be
38b0: 0a 6d 61 64 65 20 6f 6e 20 74 68 65 20 70 72 69  .made on the pri
38c0: 76 61 74 65 20 62 72 61 6e 63 68 20 69 6e 20 62  vate branch in b
38d0: 65 74 77 65 65 6e 20 72 65 6c 65 61 73 65 73 20  etween releases 
38e0: 69 66 20 64 65 73 69 72 65 64 2e 3c 2f 70 3e 0a  if desired.</p>.
38f0: 0a 3c 68 31 3e 20 56 61 72 69 61 74 69 6f 6e 73  .<h1> Variations
3900: 3c 2f 68 31 3e 0a 0a 3c 70 3e 53 69 6e 63 65 20  </h1>..<p>Since 
3910: 74 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 77 61  this document wa
3920: 73 20 66 69 72 73 74 20 77 72 69 74 74 65 6e 2c  s first written,
3930: 20 74 68 65 20 63 61 6e 6f 6e 69 63 61 6c 20 53   the canonical S
3940: 51 4c 69 74 65 20 73 6f 75 72 63 65 20 63 6f 64  QLite source cod
3950: 65 0a 68 61 73 20 62 65 65 6e 20 6d 6f 76 65 64  e.has been moved
3960: 20 66 72 6f 6d 20 74 68 65 20 76 65 6e 65 72 61   from the venera
3970: 62 6c 65 20 43 56 53 20 73 79 73 74 65 6d 20 69  ble CVS system i
3980: 6e 74 6f 20 61 20 46 6f 73 73 69 6c 20 72 65 70  nto a Fossil rep
3990: 6f 73 69 74 6f 72 79 20 61 74 0a 5b 68 74 74 70  ository at.[http
39a0: 3a 2f 2f 77 77 77 2e 73 71 6c 69 74 65 2e 6f 72  ://www.sqlite.or
39b0: 67 2f 73 72 63 5d 2e 20 20 54 68 69 73 20 6d 65  g/src].  This me
39c0: 61 6e 73 20 74 68 61 74 20 69 66 20 79 6f 75 20  ans that if you 
39d0: 61 72 65 20 77 6f 72 6b 69 6e 67 20 77 69 74 68  are working with
39e0: 0a 63 61 6e 6f 6e 69 63 61 6c 20 53 51 4c 69 74  .canonical SQLit
39f0: 65 20 73 6f 75 72 63 65 20 63 6f 64 65 20 28 61  e source code (a
3a00: 73 20 6f 70 70 6f 73 65 64 20 74 6f 20 74 68 65  s opposed to the
3a10: 20 5b 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 5d 20   [amalgamation] 
3a20: 73 6f 75 72 63 65 20 63 6f 64 65 0a 66 69 6c 65  source code.file
3a30: 73 2c 20 73 71 6c 69 74 65 33 2e 63 20 61 6e 64  s, sqlite3.c and
3a40: 20 73 71 6c 69 74 65 33 2e 68 29 20 74 68 65 6e   sqlite3.h) then
3a50: 20 79 6f 75 20 63 61 6e 20 63 72 65 61 74 65 20   you can create 
3a60: 61 20 70 72 69 76 61 74 65 20 72 65 70 6f 73 69  a private reposi
3a70: 74 6f 72 79 0a 73 69 6d 70 6c 79 20 62 79 20 63  tory.simply by c
3a80: 6c 6f 6e 69 6e 67 20 74 68 65 20 6f 66 66 69 63  loning the offic
3a90: 69 61 6c 20 72 65 70 6f 73 69 74 6f 72 79 3a 3c  ial repository:<
3aa0: 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65  /p>..<blockquote
3ab0: 3e 3c 70 72 65 3e 0a 66 6f 73 73 69 6c 20 63 6c  ><pre>.fossil cl
3ac0: 6f 6e 65 20 68 74 74 70 3a 2f 2f 77 77 77 2e 73  one http://www.s
3ad0: 71 6c 69 74 65 2e 6f 72 67 2f 73 72 63 20 70 72  qlite.org/src pr
3ae0: 69 76 61 74 65 2d 70 72 6f 6a 65 63 74 2e 66 6f  ivate-project.fo
3af0: 73 73 69 6c 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f  ssil.</pre></blo
3b00: 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 54 68 69  ckquote>..<p>Thi
3b10: 73 20 63 6f 6d 6d 61 6e 64 20 62 6f 74 68 20 63  s command both c
3b20: 72 65 61 74 65 73 20 74 68 65 20 6e 65 77 20 72  reates the new r
3b30: 65 70 6f 73 69 74 6f 72 79 20 61 6e 64 20 70 6f  epository and po
3b40: 70 75 6c 61 74 65 73 20 69 74 20 77 69 74 68 0a  pulates it with.
3b50: 61 6c 6c 20 74 68 65 20 6c 61 74 65 73 74 20 53  all the latest S
3b60: 51 4c 69 74 65 20 63 6f 64 65 2e 20 20 59 6f 75  QLite code.  You
3b70: 20 63 61 6e 20 74 68 65 6e 20 63 72 65 61 74 65   can then create
3b80: 20 61 20 70 72 69 76 61 74 65 20 62 72 61 6e 63   a private branc
3b90: 68 20 61 73 0a 64 65 73 63 72 69 62 65 64 20 69  h as.described i
3ba0: 6e 20 73 65 63 74 69 6f 6e 20 33 2e 34 2e 3c 2f  n section 3.4.</
3bb0: 70 3e 0a 0a 3c 70 3e 57 68 65 6e 20 74 68 65 20  p>..<p>When the 
3bc0: 70 72 69 76 61 74 65 20 72 65 70 6f 73 69 74 6f  private reposito
3bd0: 72 79 20 69 73 20 63 72 65 61 74 65 64 20 62 79  ry is created by
3be0: 20 63 6c 6f 6e 69 6e 67 2c 20 69 6e 63 6f 72 70   cloning, incorp
3bf0: 6f 72 61 74 69 6e 67 20 6e 65 77 0a 70 75 62 6c  orating new.publ
3c00: 69 63 20 53 51 4c 69 74 65 20 72 65 6c 65 61 73  ic SQLite releas
3c10: 65 73 20 62 65 63 6f 6d 65 73 20 6d 75 63 68 20  es becomes much 
3c20: 65 61 73 69 65 72 20 74 6f 6f 2e 20 20 54 6f 20  easier too.  To 
3c30: 70 75 6c 6c 20 69 6e 20 61 6c 6c 20 6f 66 20 74  pull in all of t
3c40: 68 65 0a 6c 61 74 65 73 74 20 63 68 61 6e 67 65  he.latest change
3c50: 73 20 66 72 6f 6d 20 74 68 65 20 70 75 62 6c 69  s from the publi
3c60: 63 20 53 51 4c 69 74 65 20 72 65 70 6f 73 69 74  c SQLite reposit
3c70: 6f 72 79 2c 20 73 69 6d 70 6c 79 20 6d 6f 76 65  ory, simply move
3c80: 20 69 6e 74 6f 0a 74 68 65 20 6f 70 65 6e 20 63   into.the open c
3c90: 68 65 63 6b 2d 6f 75 74 20 61 6e 64 20 64 6f 3a  heck-out and do:
3ca0: 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74  </p>..<blockquot
3cb0: 65 3e 3c 70 72 65 3e 0a 66 6f 73 73 69 6c 20 75  e><pre>.fossil u
3cc0: 70 64 61 74 65 0a 3c 2f 70 72 65 3e 3c 2f 62 6c  pdate.</pre></bl
3cd0: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 54 68  ockquote>..<p>Th
3ce0: 65 6e 20 63 6f 6e 74 69 6e 75 65 20 74 6f 20 6d  en continue to m
3cf0: 65 72 67 65 20 74 68 65 20 63 68 61 6e 67 65 73  erge the changes
3d00: 20 69 6e 20 22 74 72 75 6e 6b 22 20 77 69 74 68   in "trunk" with
3d10: 20 79 6f 75 72 20 22 70 72 69 76 61 74 65 22 0a   your "private".
3d20: 63 68 61 6e 67 65 73 20 61 73 20 64 65 73 63 72  changes as descr
3d30: 69 62 65 64 20 69 6e 20 73 65 63 74 69 6f 6e 20  ibed in section 
3d40: 33 2e 37 2e 3c 2f 70 3e 0a                       3.7.</p>.