Artifact d16ea958f54c8adc624cbffd6fb0f56fbf23affa:
File www/build.wiki part of check-in [d87ca60c58] - initial ports of static .html to static /doc .wiki by stephan on 2008-05-15 20:25:46. Also file www/build.wiki part of check-in [f94f7e5f49] - Merge the fork back together. by drh on 2008-05-16 00:27:49.
0000: 3c 68 31 3e 49 6e 73 74 61 6c 6c 69 6e 67 20 46 <h1>Installing F 0010: 6f 73 73 69 6c 3c 2f 68 31 3e 0a 0a 3c 70 3e 54 ossil</h1>..<p>T 0020: 68 69 73 20 70 61 67 65 20 64 65 73 63 72 69 62 his page describ 0030: 65 73 20 68 6f 77 20 74 6f 20 62 75 69 6c 64 20 es how to build 0040: 61 6e 64 20 69 6e 73 74 61 6c 6c 20 46 6f 73 73 and install Foss 0050: 69 6c 2e 20 20 54 68 65 0a 77 68 6f 6c 65 20 70 il. The.whole p 0060: 72 6f 63 65 73 73 20 69 73 20 64 65 73 69 67 6e rocess is design 0070: 65 64 20 74 6f 20 62 65 20 76 65 72 79 20 65 61 ed to be very ea 0080: 73 79 2e 3c 2f 70 3e 0a 0a 3c 68 32 3e 30 2e 30 sy.</p>..<h2>0.0 0090: 20 55 73 69 6e 67 20 41 20 50 72 65 63 6f 6d 70 Using A Precomp 00a0: 69 6c 65 64 20 42 69 6e 61 72 79 3c 2f 68 32 3e iled Binary</h2> 00b0: 0a 0a 3c 70 3e 59 6f 75 20 63 61 6e 20 73 6b 69 ..<p>You can ski 00c0: 70 20 73 74 65 70 73 20 31 2e 30 20 61 6e 64 20 p steps 1.0 and 00d0: 32 2e 30 20 62 65 6c 6f 77 20 62 79 20 64 6f 77 2.0 below by dow 00e0: 6e 6c 6f 61 64 69 6e 67 0a 61 20 3c 61 20 68 72 nloading.a <a hr 00f0: 65 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e 66 ef="http://www.f 0100: 6f 73 73 69 6c 2d 73 63 6d 2e 6f 72 67 2f 64 6f ossil-scm.org/do 0110: 77 6e 6c 6f 61 64 2e 68 74 6d 6c 22 3e 46 49 58 wnload.html">FIX 0120: 4d 45 20 70 72 65 63 6f 6d 70 69 6c 65 64 20 62 ME precompiled b 0130: 69 6e 61 72 79 3c 2f 61 3e 0a 61 70 70 72 6f 70 inary</a>.approp 0140: 72 69 61 74 65 20 66 6f 72 20 79 6f 75 72 20 70 riate for your p 0150: 6c 61 74 66 6f 72 6d 2e 20 20 49 66 20 79 6f 75 latform. If you 0160: 20 75 73 65 20 61 20 70 72 65 63 6f 6d 70 69 6c use a precompil 0170: 65 64 20 62 69 6e 61 72 79 0a 6a 75 6d 70 20 69 ed binary.jump i 0180: 6d 6d 65 64 69 61 74 65 20 74 6f 20 73 74 65 70 mmediate to step 0190: 20 33 2e 30 2e 3c 2f 70 3e 0a 0a 3c 68 32 3e 31 3.0.</p>..<h2>1 01a0: 2e 30 20 4f 62 74 61 69 6e 69 6e 67 20 54 68 65 .0 Obtaining The 01b0: 20 53 6f 75 72 63 65 20 43 6f 64 65 3c 2f 68 32 Source Code</h2 01c0: 3e 0a 0a 3c 70 3e 46 6f 73 73 69 6c 20 69 73 20 >..<p>Fossil is 01d0: 73 65 6c 66 2d 68 6f 73 74 69 6e 67 2c 20 73 6f self-hosting, so 01e0: 20 79 6f 75 20 63 61 6e 20 6f 62 74 61 69 6e 20 you can obtain 01f0: 61 20 5a 49 50 20 61 72 63 68 69 76 65 20 63 6f a ZIP archive co 0200: 6e 74 61 69 6e 69 6e 67 0a 61 20 73 6e 61 70 73 ntaining.a snaps 0210: 68 6f 74 20 6f 66 20 74 68 65 20 6c 61 74 65 73 hot of the lates 0220: 74 20 76 65 72 73 69 6f 6e 20 64 69 72 65 63 74 t version direct 0230: 6c 79 20 66 72 6f 6d 20 66 6f 73 73 69 6c 27 73 ly from fossil's 0240: 20 6f 77 6e 20 66 6f 73 73 69 6c 0a 72 65 70 6f own fossil.repo 0250: 73 69 74 6f 72 79 2e 20 20 46 6f 6c 6c 6f 77 20 sitory. Follow 0260: 74 68 65 73 65 20 73 74 65 70 73 3a 3c 2f 70 3e these steps:</p> 0270: 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 3e 3c 70 3e 50 6f ..<ol>.<li><p>Po 0280: 69 6e 74 65 72 20 79 6f 75 72 20 77 65 62 62 72 inter your webbr 0290: 6f 77 73 65 72 20 61 74 0a 3c 61 20 68 72 65 66 owser at.<a href 02a0: 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e 66 6f 73 ="http://www.fos 02b0: 73 69 6c 2d 73 63 6d 2e 6f 72 67 2f 66 6f 73 73 sil-scm.org/foss 02c0: 69 6c 2f 6c 6f 67 69 6e 22 3e 0a 68 74 74 70 3a il/login">.http: 02d0: 2f 2f 77 77 77 2e 66 6f 73 73 69 6c 2d 73 63 6d //www.fossil-scm 02e0: 2e 6f 72 67 2f 66 6f 73 73 69 6c 2f 6c 6f 67 69 .org/fossil/logi 02f0: 6e 3c 2f 61 3e 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a n</a>.</p></li>. 0300: 0a 3c 6c 69 3e 3c 70 3e 4c 6f 67 20 69 6e 20 61 .<li><p>Log in a 0310: 73 20 61 6e 6f 6e 79 6d 6f 75 73 2e 20 20 54 68 s anonymous. Th 0320: 65 20 70 61 73 73 77 6f 72 64 20 69 73 20 73 68 e password is sh 0330: 6f 77 6e 20 6f 6e 20 73 63 72 65 65 6e 2e 0a 54 own on screen..T 0340: 68 65 20 72 65 61 73 6f 6e 20 66 6f 72 20 72 65 he reason for re 0350: 71 75 69 72 69 6e 67 20 74 68 69 73 20 6c 6f 67 quiring this log 0360: 69 6e 20 69 73 20 74 6f 20 70 72 65 76 65 6e 74 in is to prevent 0370: 20 73 70 69 64 65 72 73 20 66 72 6f 6d 0a 77 61 spiders from.wa 0380: 6c 6b 69 6e 67 20 74 68 65 20 65 6e 74 69 72 65 lking the entire 0390: 20 77 65 62 73 69 74 65 2c 20 64 6f 77 6e 6c 6f website, downlo 03a0: 61 64 69 6e 67 20 5a 49 50 20 61 72 63 68 69 76 ading ZIP archiv 03b0: 65 73 0a 6f 66 20 65 76 65 72 79 20 68 69 73 74 es.of every hist 03c0: 6f 72 69 63 61 6c 20 76 65 72 73 69 6f 6e 2c 20 orical version, 03d0: 61 6e 64 20 74 68 65 72 65 62 79 20 73 6f 61 6b and thereby soak 03e0: 69 6e 67 20 75 70 20 61 6c 6c 20 6f 75 72 20 62 ing up all our b 03f0: 61 6e 64 77 69 64 74 68 2e 3c 2f 70 3e 3c 2f 6c andwidth.</p></l 0400: 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 43 6c 69 63 6b i>..<li><p>Click 0410: 20 6f 6e 20 74 68 65 20 0a 3c 61 20 68 72 65 66 on the .<a href 0420: 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e 66 6f 73 ="http://www.fos 0430: 73 69 6c 2d 73 63 6d 2e 6f 72 67 2f 66 6f 73 73 sil-scm.org/foss 0440: 69 6c 2f 74 69 6d 65 6c 69 6e 65 22 3e 54 69 6d il/timeline">Tim 0450: 65 6c 69 6e 65 3c 2f 61 3e 20 6f 72 0a 3c 61 20 eline</a> or.<a 0460: 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 href="http://www 0470: 2e 66 6f 73 73 69 6c 2d 73 63 6d 2e 6f 72 67 2f .fossil-scm.org/ 0480: 66 6f 73 73 69 6c 2f 6c 65 61 76 65 73 22 3e 4c fossil/leaves">L 0490: 65 61 76 65 73 3c 2f 61 3e 20 6c 69 6e 6b 20 61 eaves</a> link a 04a0: 74 0a 74 68 65 20 74 6f 70 20 6f 66 20 74 68 65 t.the top of the 04b0: 20 70 61 67 65 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a page.</p></li>. 04c0: 0a 3c 6c 69 3e 3c 70 3e 53 65 6c 65 63 74 20 61 .<li><p>Select a 04d0: 20 76 65 72 73 69 6f 6e 20 6f 66 20 6f 66 20 66 version of of f 04e0: 6f 73 73 69 6c 20 79 6f 75 20 77 61 6e 74 20 74 ossil you want t 04f0: 6f 20 64 6f 77 6e 6c 6f 61 64 2e 20 20 43 6c 69 o download. Cli 0500: 63 6b 20 6f 6e 20 69 74 73 0a 6c 69 6e 6b 2e 20 ck on its.link. 0510: 20 4e 6f 74 65 20 74 68 61 74 20 79 6f 75 20 6d Note that you m 0520: 75 73 74 20 73 75 63 63 65 73 73 66 75 6c 6c 79 ust successfully 0530: 20 6c 6f 67 20 69 6e 20 61 73 20 22 61 6e 6f 6e log in as "anon 0540: 79 6d 6f 75 73 22 20 69 6e 20 73 74 65 70 20 31 ymous" in step 1 0550: 0a 61 62 6f 76 65 20 69 6e 20 6f 72 64 65 72 20 .above in order 0560: 74 6f 20 73 65 65 20 74 68 65 20 6c 69 6e 6b 20 to see the link 0570: 74 6f 20 74 68 65 20 64 65 74 61 69 6c 65 64 20 to the detailed 0580: 76 65 72 73 69 6f 6e 20 69 6e 66 6f 72 6d 61 74 version informat 0590: 69 6f 6e 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c ion.</p></li>..< 05a0: 6c 69 3e 3c 70 3e 4f 6e 20 74 68 65 20 76 65 72 li><p>On the ver 05b0: 73 69 6f 6e 20 69 6e 66 6f 72 6d 61 74 69 6f 6e sion information 05c0: 20 70 61 67 65 2c 20 63 6c 69 63 6b 20 6f 6e 20 page, click on 05d0: 74 68 65 0a 22 5a 69 70 20 41 72 63 68 69 76 65 the."Zip Archive 05e0: 22 20 6c 69 6e 6b 2e 20 20 54 68 69 73 20 6c 69 " link. This li 05f0: 6e 6b 20 77 69 6c 6c 20 62 75 69 6c 64 20 61 20 nk will build a 0600: 5a 49 50 20 61 72 63 68 69 76 65 20 6f 66 20 74 ZIP archive of t 0610: 68 65 20 0a 63 6f 6d 70 6c 65 74 65 20 73 6f 75 he .complete sou 0620: 72 63 65 20 63 6f 64 65 20 61 6e 64 20 64 6f 77 rce code and dow 0630: 6e 6c 6f 61 64 20 69 74 20 74 6f 20 79 6f 75 72 nload it to your 0640: 20 62 72 6f 77 73 65 72 2e 3c 2f 70 3e 3c 2f 6c browser.</p></l 0650: 69 3e 0a 3c 2f 6f 6c 3e 0a 0a 3c 68 32 3e 32 2e i>.</ol>..<h2>2. 0660: 30 20 43 6f 6d 70 69 6c 69 6e 67 3c 2f 68 32 3e 0 Compiling</h2> 0670: 0a 0a 3c 70 3e 46 6f 6c 6c 6f 77 20 74 68 65 73 ..<p>Follow thes 0680: 65 20 73 74 65 70 73 20 74 6f 20 63 6f 6d 70 69 e steps to compi 0690: 6c 65 3a 3c 2f 70 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c le:</p>..<ol>.<l 06a0: 69 20 76 61 6c 75 65 3d 22 36 22 3e 0a 3c 70 3e i value="6">.<p> 06b0: 43 72 65 61 74 65 20 61 20 64 69 72 65 63 74 6f Create a directo 06c0: 72 79 20 74 6f 20 68 6f 6c 64 20 74 68 65 20 73 ry to hold the s 06d0: 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 54 68 65 ource code. The 06e0: 6e 20 75 6e 7a 69 70 20 74 68 65 0a 5a 49 50 20 n unzip the.ZIP 06f0: 61 72 63 68 69 76 65 20 79 6f 75 20 64 6f 77 6e archive you down 0700: 6c 6f 61 64 65 64 20 69 6e 74 6f 20 74 68 61 74 loaded into that 0710: 20 64 69 72 65 63 74 6f 72 79 2e 20 20 59 6f 75 directory. You 0720: 20 73 68 6f 75 6c 64 20 62 65 0a 69 6e 20 74 68 should be.in th 0730: 65 20 74 6f 70 2d 6c 65 76 65 6c 20 66 6f 6c 64 e top-level fold 0740: 65 72 20 6f 66 20 74 68 61 74 20 64 69 72 65 63 er of that direc 0750: 74 6f 72 79 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c tory</p></li>..< 0760: 6c 69 3e 3c 70 3e 3c 62 3e 28 4f 70 74 69 6f 6e li><p><b>(Option 0770: 61 6c 3a 29 3c 2f 62 3e 0a 45 64 69 74 20 74 68 al:)</b>.Edit th 0780: 65 20 4d 61 6b 65 66 69 6c 65 20 74 6f 20 73 65 e Makefile to se 0790: 74 20 69 74 20 75 70 20 6c 69 6b 65 20 79 6f 75 t it up like you 07a0: 20 77 61 6e 74 2e 20 20 59 6f 75 20 70 72 6f 62 want. You prob 07b0: 61 62 6c 79 20 64 6f 20 6e 6f 74 0a 6e 65 65 64 ably do not.need 07c0: 20 74 6f 20 64 6f 20 61 6e 79 74 68 69 6e 67 2e to do anything. 07d0: 20 20 44 6f 20 6e 6f 74 20 62 65 20 69 6e 74 69 Do not be inti 07e0: 6d 69 64 61 74 65 64 3a 20 20 54 68 65 72 65 20 midated: There 07f0: 61 72 65 20 6f 6e 6c 79 20 35 0a 76 61 72 69 61 are only 5.varia 0800: 62 6c 65 73 20 69 6e 20 74 68 65 20 6d 61 6b 65 bles in the make 0810: 66 69 6c 65 20 74 68 61 74 20 63 61 6e 20 62 65 file that can be 0820: 20 63 68 61 6e 67 65 64 2e 20 20 54 68 65 20 77 changed. The w 0830: 68 6f 6c 65 20 4d 61 6b 65 66 69 6c 65 0a 69 73 hole Makefile.is 0840: 20 6f 6e 6c 79 20 61 20 66 65 77 20 64 6f 7a 65 only a few doze 0850: 6e 20 6c 69 6e 65 73 20 6c 6f 6e 67 20 61 6e 64 n lines long and 0860: 20 6d 6f 73 74 20 6f 66 20 74 68 6f 73 65 20 6c most of those l 0870: 69 6e 65 73 20 61 72 65 20 63 6f 6d 6d 65 6e 74 ines are comment 0880: 73 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 54 s.</p>..<li><p>T 0890: 79 70 65 20 22 3c 62 3e 6d 61 6b 65 3c 2f 62 3e ype "<b>make</b> 08a0: 22 0a 3c 2f 6f 6c 3e 0a 0a 3c 68 32 3e 33 2e 30 ".</ol>..<h2>3.0 08b0: 20 49 6e 73 74 61 6c 6c 69 6e 67 3c 2f 68 32 3e Installing</h2> 08c0: 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 20 76 61 6c 75 65 ..<ol>.<li value 08d0: 3d 22 39 22 3e 0a 3c 70 3e 54 68 65 20 66 69 6e ="9">.<p>The fin 08e0: 69 73 68 65 64 20 62 69 6e 61 72 79 20 69 73 20 ished binary is 08f0: 6e 61 6d 65 64 20 22 66 6f 73 73 69 6c 22 2e 20 named "fossil". 0900: 20 50 75 74 20 74 68 69 73 20 62 69 6e 61 72 79 Put this binary 0910: 20 69 6e 20 61 20 0a 64 69 72 65 63 74 6f 72 79 in a .directory 0920: 20 74 68 61 74 20 69 73 20 73 6f 6d 65 77 68 65 that is somewhe 0930: 72 65 20 6f 6e 20 79 6f 75 72 20 50 41 54 48 20 re on your PATH 0940: 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 environment vari 0950: 61 62 6c 65 2e 0a 49 74 20 64 6f 65 73 20 6e 6f able..It does no 0960: 74 20 6d 61 74 74 65 72 20 77 68 65 72 65 2e 3c t matter where.< 0970: 2f 70 3e 0a 0a 3c 6c 69 3e 0a 3c 70 3e 3c 62 3e /p>..<li>.<p><b> 0980: 28 4f 70 74 69 6f 6e 61 6c 3a 29 3c 2f 62 3e 0a (Optional:)</b>. 0990: 54 6f 20 75 6e 69 6e 73 74 61 6c 6c 2c 20 6a 75 To uninstall, ju 09a0: 73 74 20 64 65 6c 65 74 65 20 74 68 65 20 62 69 st delete the bi 09b0: 6e 61 72 79 2e 3c 2f 70 3e 0a 3c 2f 6f 6c 3e 0a nary.</p>.</ol>.