Hex Artifact Content
Not logged in

Artifact 6089f0b563a9db0a6d90682fe47fd7161ff867c8:

File www/build.html part of check-in [b110d77c36] - Website updates. by drh on 2007-08-09 01:08:19.

0000: 3c 68 74 6d 6c 3e 0a 3c 74 69 74 6c 65 3e 42 75  <html>.<title>Bu
0010: 69 6c 64 69 6e 67 20 41 6e 64 20 49 6e 73 74 61  ilding And Insta
0020: 6c 6c 69 6e 67 20 46 6f 73 73 69 6c 3c 2f 74 69  lling Fossil</ti
0030: 74 6c 65 3e 0a 3c 2f 68 65 61 64 3e 0a 3c 62 6f  tle>.</head>.<bo
0040: 64 79 20 62 67 63 6f 6c 6f 72 3d 22 77 68 69 74  dy bgcolor="whit
0050: 65 22 3e 0a 3c 68 31 3e 49 6e 73 74 61 6c 6c 69  e">.<h1>Installi
0060: 6e 67 20 46 6f 73 73 69 6c 3c 2f 68 31 3e 0a 0a  ng Fossil</h1>..
0070: 3c 70 3e 54 68 69 73 20 70 61 67 65 20 64 65 73  <p>This page des
0080: 63 72 69 62 65 73 20 68 6f 77 20 74 6f 20 62 75  cribes how to bu
0090: 69 6c 64 20 61 6e 64 20 69 6e 73 74 61 6c 6c 20  ild and install 
00a0: 46 6f 73 73 69 6c 2e 20 20 54 68 65 0a 77 68 6f  Fossil.  The.who
00b0: 6c 65 20 70 72 6f 63 65 73 73 20 69 73 20 64 65  le process is de
00c0: 73 69 67 6e 65 64 20 74 6f 20 62 65 20 76 65 72  signed to be ver
00d0: 79 20 65 61 73 79 2e 3c 2f 70 3e 0a 0a 3c 68 32  y easy.</p>..<h2
00e0: 3e 31 2e 30 20 4f 62 74 61 69 6e 69 6e 67 20 54  >1.0 Obtaining T
00f0: 68 65 20 53 6f 75 72 63 65 20 43 6f 64 65 3c 2f  he Source Code</
0100: 68 32 3e 0a 0a 3c 70 3e 46 6f 73 73 69 6c 20 69  h2>..<p>Fossil i
0110: 73 20 73 65 6c 66 2d 68 6f 73 74 69 6e 67 2c 20  s self-hosting, 
0120: 73 6f 20 79 6f 75 20 63 61 6e 20 6f 62 74 61 69  so you can obtai
0130: 6e 20 61 20 5a 49 50 20 61 72 63 68 69 76 65 20  n a ZIP archive 
0140: 63 6f 6e 74 61 69 6e 69 6e 67 0a 61 20 73 6e 61  containing.a sna
0150: 70 73 68 6f 74 20 6f 66 20 74 68 65 20 6c 61 74  pshot of the lat
0160: 65 73 74 20 76 65 72 73 69 6f 6e 20 64 69 72 65  est version dire
0170: 63 74 6c 79 20 66 72 6f 6d 20 66 6f 73 73 69 6c  ctly from fossil
0180: 27 73 20 6f 77 6e 20 66 6f 73 73 69 6c 0a 72 65  's own fossil.re
0190: 70 6f 73 69 74 6f 72 79 2e 20 20 46 6f 6c 6c 6f  pository.  Follo
01a0: 77 20 74 68 65 73 65 20 73 74 65 70 73 3a 3c 2f  w these steps:</
01b0: 70 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 3e 3c 70 3e  p>..<ol>.<li><p>
01c0: 50 6f 69 6e 74 65 72 20 79 6f 75 72 20 77 65 62  Pointer your web
01d0: 62 72 6f 77 73 65 72 20 61 74 0a 3c 61 20 68 72  browser at.<a hr
01e0: 65 66 3d 22 68 74 74 70 3a 2f 2f 66 6f 73 73 69  ef="http://fossi
01f0: 6c 2d 73 63 6d 2e 68 77 61 63 69 2e 63 6f 6d 2f  l-scm.hwaci.com/
0200: 66 6f 73 73 69 6c 2f 6c 6f 67 69 6e 22 3e 0a 68  fossil/login">.h
0210: 74 74 70 3a 2f 2f 66 6f 73 73 69 6c 2d 73 63 6d  ttp://fossil-scm
0220: 2e 68 77 61 63 69 2e 63 6f 6d 2f 66 6f 73 73 69  .hwaci.com/fossi
0230: 6c 2f 6c 6f 67 69 6e 3c 2f 61 3e 2e 3c 2f 70 3e  l/login</a>.</p>
0240: 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 4c 6f  </li>..<li><p>Lo
0250: 67 20 69 6e 20 61 73 20 61 6e 6f 6e 79 6d 6f 75  g in as anonymou
0260: 73 2e 20 20 54 68 65 20 70 61 73 73 77 6f 72 64  s.  The password
0270: 20 69 73 20 73 68 6f 77 6e 20 6f 6e 20 73 63 72   is shown on scr
0280: 65 65 6e 2e 0a 54 68 65 20 72 65 61 73 6f 6e 20  een..The reason 
0290: 66 6f 72 20 72 65 71 75 69 72 69 6e 67 20 74 68  for requiring th
02a0: 69 73 20 6c 6f 67 69 6e 20 69 73 20 74 6f 20 70  is login is to p
02b0: 72 65 76 65 6e 74 20 73 70 69 64 65 72 73 20 66  revent spiders f
02c0: 72 6f 6d 0a 77 61 6c 6b 69 6e 67 20 74 68 65 20  rom.walking the 
02d0: 65 6e 74 69 72 65 20 77 65 62 73 69 74 65 2c 20  entire website, 
02e0: 64 6f 77 6e 6c 6f 61 64 69 6e 67 20 5a 49 50 20  downloading ZIP 
02f0: 61 72 63 68 69 76 65 73 0a 6f 66 20 65 76 65 72  archives.of ever
0300: 79 20 68 69 73 74 6f 72 69 63 61 6c 20 76 65 72  y historical ver
0310: 73 69 6f 6e 2c 20 61 6e 64 20 74 68 65 72 65 62  sion, and thereb
0320: 79 20 73 6f 61 6b 69 6e 67 20 75 70 20 61 6c 6c  y soaking up all
0330: 20 6f 75 72 20 62 61 6e 64 77 69 64 74 68 2e 3c   our bandwidth.<
0340: 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70  /p></li>..<li><p
0350: 3e 43 6c 69 63 6b 20 6f 6e 20 74 68 65 20 0a 3c  >Click on the .<
0360: 61 20 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f 66  a href="http://f
0370: 6f 73 73 69 6c 2d 73 63 6d 2e 68 77 61 63 69 2e  ossil-scm.hwaci.
0380: 63 6f 6d 2f 66 6f 73 73 69 6c 2f 74 69 6d 65 6c  com/fossil/timel
0390: 69 6e 65 22 3e 54 69 6d 65 6c 69 6e 65 3c 2f 61  ine">Timeline</a
03a0: 3e 20 6f 72 0a 3c 61 20 68 72 65 66 3d 22 68 74  > or.<a href="ht
03b0: 74 70 3a 2f 2f 66 6f 73 73 69 6c 2d 73 63 6d 2e  tp://fossil-scm.
03c0: 68 77 61 63 69 2e 63 6f 6d 2f 66 6f 73 73 69 6c  hwaci.com/fossil
03d0: 2f 6c 65 61 76 65 73 22 3e 4c 65 61 76 65 73 3c  /leaves">Leaves<
03e0: 2f 61 3e 20 6c 69 6e 6b 20 61 74 0a 74 68 65 20  /a> link at.the 
03f0: 74 6f 70 20 6f 66 20 74 68 65 20 70 61 67 65 2e  top of the page.
0400: 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c  </p></li>..<li><
0410: 70 3e 53 65 6c 65 63 74 20 61 20 76 65 72 73 69  p>Select a versi
0420: 6f 6e 20 6f 66 20 6f 66 20 66 6f 73 73 69 6c 20  on of of fossil 
0430: 79 6f 75 20 77 61 6e 74 20 74 6f 20 64 6f 77 6e  you want to down
0440: 6c 6f 61 64 2e 20 20 43 6c 69 63 6b 20 6f 6e 20  load.  Click on 
0450: 69 74 73 0a 6c 69 6e 6b 2e 20 20 4e 6f 74 65 20  its.link.  Note 
0460: 74 68 61 74 20 79 6f 75 20 6d 75 73 74 20 73 75  that you must su
0470: 63 63 65 73 73 66 75 6c 6c 79 20 6c 6f 67 20 69  ccessfully log i
0480: 6e 20 61 73 20 22 61 6e 6f 6e 79 6d 6f 75 73 22  n as "anonymous"
0490: 20 69 6e 20 73 74 65 70 20 31 0a 61 62 6f 76 65   in step 1.above
04a0: 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 73 65 65   in order to see
04b0: 20 74 68 65 20 6c 69 6e 6b 20 74 6f 20 74 68 65   the link to the
04c0: 20 64 65 74 61 69 6c 65 64 20 76 65 72 73 69 6f   detailed versio
04d0: 6e 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 3c 2f  n information.</
04e0: 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e  p></li>..<li><p>
04f0: 4f 6e 20 74 68 65 20 76 65 72 73 69 6f 6e 20 69  On the version i
0500: 6e 66 6f 72 6d 61 74 69 6f 6e 20 70 61 67 65 2c  nformation page,
0510: 20 63 6c 69 63 6b 20 6f 6e 20 74 68 65 0a 22 5a   click on the."Z
0520: 69 70 20 41 72 63 68 69 76 65 22 20 6c 69 6e 6b  ip Archive" link
0530: 2e 20 20 54 68 69 73 20 6c 69 6e 6b 20 77 69 6c  .  This link wil
0540: 6c 20 62 75 69 6c 64 20 61 20 5a 49 50 20 61 72  l build a ZIP ar
0550: 63 68 69 76 65 20 6f 66 20 74 68 65 20 0a 63 6f  chive of the .co
0560: 6d 70 6c 65 74 65 20 73 6f 75 72 63 65 20 63 6f  mplete source co
0570: 64 65 20 61 6e 64 20 64 6f 77 6e 6c 6f 61 64 20  de and download 
0580: 69 74 20 74 6f 20 79 6f 75 72 20 62 72 6f 77 73  it to your brows
0590: 65 72 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 3c 2f 6f  er.</p></li>.</o
05a0: 6c 3e 0a 0a 3c 68 32 3e 32 2e 30 20 43 6f 6d 70  l>..<h2>2.0 Comp
05b0: 69 6c 69 6e 67 3c 2f 68 32 3e 0a 0a 3c 70 3e 46  iling</h2>..<p>F
05c0: 6f 6c 6c 6f 77 20 74 68 65 73 65 20 73 74 65 70  ollow these step
05d0: 73 20 74 6f 20 63 6f 6d 70 69 6c 65 3a 3c 2f 70  s to compile:</p
05e0: 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 20 76 61 6c 75  >..<ol>.<li valu
05f0: 65 3d 22 36 22 3e 0a 3c 70 3e 43 72 65 61 74 65  e="6">.<p>Create
0600: 20 61 20 64 69 72 65 63 74 6f 72 79 20 74 6f 20   a directory to 
0610: 68 6f 6c 64 20 74 68 65 20 73 6f 75 72 63 65 20  hold the source 
0620: 63 6f 64 65 2e 20 20 54 68 65 6e 20 75 6e 7a 69  code.  Then unzi
0630: 70 20 74 68 65 0a 5a 49 50 20 61 72 63 68 69 76  p the.ZIP archiv
0640: 65 20 79 6f 75 20 64 6f 77 6e 6c 6f 61 64 65 64  e you downloaded
0650: 20 69 6e 74 6f 20 74 68 61 74 20 64 69 72 65 63   into that direc
0660: 74 6f 72 79 2e 20 20 59 6f 75 20 73 68 6f 75 6c  tory.  You shoul
0670: 64 20 62 65 0a 69 6e 20 74 68 65 20 74 6f 70 2d  d be.in the top-
0680: 6c 65 76 65 6c 20 66 6f 6c 64 65 72 20 6f 66 20  level folder of 
0690: 74 68 61 74 20 64 69 72 65 63 74 6f 72 79 3c 2f  that directory</
06a0: 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e  p></li>..<li><p>
06b0: 3c 62 3e 28 4f 70 74 69 6f 6e 61 6c 3a 29 3c 2f  <b>(Optional:)</
06c0: 62 3e 0a 45 64 69 74 20 74 68 65 20 4d 61 6b 65  b>.Edit the Make
06d0: 66 69 6c 65 20 74 6f 20 73 65 74 20 69 74 20 75  file to set it u
06e0: 70 20 6c 69 6b 65 20 79 6f 75 20 77 61 6e 74 2e  p like you want.
06f0: 20 20 59 6f 75 20 70 72 6f 62 61 62 6c 79 20 64    You probably d
0700: 6f 20 6e 6f 74 0a 6e 65 65 64 20 74 6f 20 64 6f  o not.need to do
0710: 20 61 6e 79 74 68 69 6e 67 2e 20 20 44 6f 20 6e   anything.  Do n
0720: 6f 74 20 62 65 20 69 6e 74 69 6d 69 64 61 74 65  ot be intimidate
0730: 64 3a 20 20 54 68 65 72 65 20 61 72 65 20 6f 6e  d:  There are on
0740: 6c 79 20 35 0a 76 61 72 69 61 62 6c 65 73 20 69  ly 5.variables i
0750: 6e 20 74 68 65 20 6d 61 6b 65 66 69 6c 65 20 74  n the makefile t
0760: 68 61 74 20 63 61 6e 20 62 65 20 63 68 61 6e 67  hat can be chang
0770: 65 64 2e 20 20 54 68 65 20 77 68 6f 6c 65 20 4d  ed.  The whole M
0780: 61 6b 65 66 69 6c 65 0a 69 73 20 6f 6e 6c 79 20  akefile.is only 
0790: 61 20 66 65 77 20 64 6f 7a 65 6e 20 6c 69 6e 65  a few dozen line
07a0: 73 20 6c 6f 6e 67 20 61 6e 64 20 6d 6f 73 74 20  s long and most 
07b0: 6f 66 20 74 68 6f 73 65 20 6c 69 6e 65 73 20 61  of those lines a
07c0: 72 65 20 63 6f 6d 6d 65 6e 74 73 2e 3c 2f 70 3e  re comments.</p>
07d0: 0a 0a 3c 6c 69 3e 3c 70 3e 54 79 70 65 20 22 3c  ..<li><p>Type "<
07e0: 62 3e 6d 61 6b 65 3c 2f 62 3e 22 0a 3c 2f 6f 6c  b>make</b>".</ol
07f0: 3e 0a 0a 3c 68 32 3e 33 2e 30 20 49 6e 73 74 61  >..<h2>3.0 Insta
0800: 6c 6c 69 6e 67 3c 2f 68 32 3e 0a 0a 3c 6f 6c 3e  lling</h2>..<ol>
0810: 0a 3c 6c 69 20 76 61 6c 75 65 3d 22 39 22 3e 0a  .<li value="9">.
0820: 3c 70 3e 54 68 65 20 66 69 6e 69 73 68 65 64 20  <p>The finished 
0830: 62 69 6e 61 72 79 20 69 73 20 6e 61 6d 65 64 20  binary is named 
0840: 22 66 6f 73 73 69 6c 22 2e 20 20 50 75 74 20 74  "fossil".  Put t
0850: 68 69 73 20 62 69 6e 61 72 79 20 69 6e 20 61 20  his binary in a 
0860: 0a 64 69 72 65 63 74 6f 72 79 20 74 68 61 74 20  .directory that 
0870: 69 73 20 73 6f 6d 65 77 68 65 72 65 20 6f 6e 20  is somewhere on 
0880: 79 6f 75 72 20 50 41 54 48 20 65 6e 76 69 72 6f  your PATH enviro
0890: 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 2e 0a  nment variable..
08a0: 49 74 20 64 6f 65 73 20 6e 6f 74 20 6d 61 74 74  It does not matt
08b0: 65 72 20 77 68 65 72 65 2e 3c 2f 70 3e 0a 0a 3c  er where.</p>..<
08c0: 6c 69 3e 0a 3c 70 3e 3c 62 3e 28 4f 70 74 69 6f  li>.<p><b>(Optio
08d0: 6e 61 6c 3a 29 3c 2f 62 3e 0a 54 6f 20 75 6e 69  nal:)</b>.To uni
08e0: 6e 73 74 61 6c 6c 2c 20 6a 75 73 74 20 64 65 6c  nstall, just del
08f0: 65 74 65 20 74 68 65 20 62 69 6e 61 72 79 2e 3c  ete the binary.<
0900: 2f 70 3e 0a 3c 2f 6f 6c 3e 0a 0a 3c 2f 62 6f 64  /p>.</ol>..</bod
0910: 79 3e 0a 3c 2f 68 74 6d 6c 3e 0a                 y>.</html>.