Artifact 0b28339535bf53d193a70c324d5b500b84042152:
File www/build.html part of check-in [c403f9dc40] - Documentation updates. by drh on 2008-02-03 02:38:32.
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 70 3e 5b 20 3c 61 20 68 72 65 66 e">.<p>[ <a href 0060: 3d 22 69 6e 64 65 78 2e 68 74 6d 6c 22 3e 49 6e ="index.html">In 0070: 64 65 78 3c 2f 61 3e 20 5d 3c 2f 70 3e 0a 3c 68 dex</a> ]</p>.<h 0080: 72 3e 0a 3c 68 31 3e 49 6e 73 74 61 6c 6c 69 6e r>.<h1>Installin 0090: 67 20 46 6f 73 73 69 6c 3c 2f 68 31 3e 0a 0a 3c g Fossil</h1>..< 00a0: 70 3e 54 68 69 73 20 70 61 67 65 20 64 65 73 63 p>This page desc 00b0: 72 69 62 65 73 20 68 6f 77 20 74 6f 20 62 75 69 ribes how to bui 00c0: 6c 64 20 61 6e 64 20 69 6e 73 74 61 6c 6c 20 46 ld and install F 00d0: 6f 73 73 69 6c 2e 20 20 54 68 65 0a 77 68 6f 6c ossil. The.whol 00e0: 65 20 70 72 6f 63 65 73 73 20 69 73 20 64 65 73 e process is des 00f0: 69 67 6e 65 64 20 74 6f 20 62 65 20 76 65 72 79 igned to be very 0100: 20 65 61 73 79 2e 3c 2f 70 3e 0a 0a 3c 68 32 3e easy.</p>..<h2> 0110: 31 2e 30 20 4f 62 74 61 69 6e 69 6e 67 20 54 68 1.0 Obtaining Th 0120: 65 20 53 6f 75 72 63 65 20 43 6f 64 65 3c 2f 68 e Source Code</h 0130: 32 3e 0a 0a 3c 70 3e 46 6f 73 73 69 6c 20 69 73 2>..<p>Fossil is 0140: 20 73 65 6c 66 2d 68 6f 73 74 69 6e 67 2c 20 73 self-hosting, s 0150: 6f 20 79 6f 75 20 63 61 6e 20 6f 62 74 61 69 6e o you can obtain 0160: 20 61 20 5a 49 50 20 61 72 63 68 69 76 65 20 63 a ZIP archive c 0170: 6f 6e 74 61 69 6e 69 6e 67 0a 61 20 73 6e 61 70 ontaining.a snap 0180: 73 68 6f 74 20 6f 66 20 74 68 65 20 6c 61 74 65 shot of the late 0190: 73 74 20 76 65 72 73 69 6f 6e 20 64 69 72 65 63 st version direc 01a0: 74 6c 79 20 66 72 6f 6d 20 66 6f 73 73 69 6c 27 tly from fossil' 01b0: 73 20 6f 77 6e 20 66 6f 73 73 69 6c 0a 72 65 70 s own fossil.rep 01c0: 6f 73 69 74 6f 72 79 2e 20 20 46 6f 6c 6c 6f 77 ository. Follow 01d0: 20 74 68 65 73 65 20 73 74 65 70 73 3a 3c 2f 70 these steps:</p 01e0: 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 3e 3c 70 3e 50 >..<ol>.<li><p>P 01f0: 6f 69 6e 74 65 72 20 79 6f 75 72 20 77 65 62 62 ointer your webb 0200: 72 6f 77 73 65 72 20 61 74 0a 3c 61 20 68 72 65 rowser at.<a hre 0210: 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e 66 6f f="http://www.fo 0220: 73 73 69 6c 2d 73 63 6d 2e 6f 72 67 2f 66 6f 73 ssil-scm.org/fos 0230: 73 69 6c 2f 6c 6f 67 69 6e 22 3e 0a 68 74 74 70 sil/login">.http 0240: 3a 2f 2f 77 77 77 2e 66 6f 73 73 69 6c 2d 73 63 ://www.fossil-sc 0250: 6d 2e 6f 72 67 2f 66 6f 73 73 69 6c 2f 6c 6f 67 m.org/fossil/log 0260: 69 6e 3c 2f 61 3e 2e 3c 2f 70 3e 3c 2f 6c 69 3e in</a>.</p></li> 0270: 0a 0a 3c 6c 69 3e 3c 70 3e 4c 6f 67 20 69 6e 20 ..<li><p>Log in 0280: 61 73 20 61 6e 6f 6e 79 6d 6f 75 73 2e 20 20 54 as anonymous. T 0290: 68 65 20 70 61 73 73 77 6f 72 64 20 69 73 20 73 he password is s 02a0: 68 6f 77 6e 20 6f 6e 20 73 63 72 65 65 6e 2e 0a hown on screen.. 02b0: 54 68 65 20 72 65 61 73 6f 6e 20 66 6f 72 20 72 The reason for r 02c0: 65 71 75 69 72 69 6e 67 20 74 68 69 73 20 6c 6f equiring this lo 02d0: 67 69 6e 20 69 73 20 74 6f 20 70 72 65 76 65 6e gin is to preven 02e0: 74 20 73 70 69 64 65 72 73 20 66 72 6f 6d 0a 77 t spiders from.w 02f0: 61 6c 6b 69 6e 67 20 74 68 65 20 65 6e 74 69 72 alking the entir 0300: 65 20 77 65 62 73 69 74 65 2c 20 64 6f 77 6e 6c e website, downl 0310: 6f 61 64 69 6e 67 20 5a 49 50 20 61 72 63 68 69 oading ZIP archi 0320: 76 65 73 0a 6f 66 20 65 76 65 72 79 20 68 69 73 ves.of every his 0330: 74 6f 72 69 63 61 6c 20 76 65 72 73 69 6f 6e 2c torical version, 0340: 20 61 6e 64 20 74 68 65 72 65 62 79 20 73 6f 61 and thereby soa 0350: 6b 69 6e 67 20 75 70 20 61 6c 6c 20 6f 75 72 20 king up all our 0360: 62 61 6e 64 77 69 64 74 68 2e 3c 2f 70 3e 3c 2f bandwidth.</p></ 0370: 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 43 6c 69 63 li>..<li><p>Clic 0380: 6b 20 6f 6e 20 74 68 65 20 0a 3c 61 20 68 72 65 k on the .<a hre 0390: 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e 66 6f f="http://www.fo 03a0: 73 73 69 6c 2d 73 63 6d 2e 6f 72 67 2f 66 6f 73 ssil-scm.org/fos 03b0: 73 69 6c 2f 74 69 6d 65 6c 69 6e 65 22 3e 54 69 sil/timeline">Ti 03c0: 6d 65 6c 69 6e 65 3c 2f 61 3e 20 6f 72 0a 3c 61 meline</a> or.<a 03d0: 20 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f 77 77 href="http://ww 03e0: 77 2e 66 6f 73 73 69 6c 2d 73 63 6d 2e 6f 72 67 w.fossil-scm.org 03f0: 2f 66 6f 73 73 69 6c 2f 6c 65 61 76 65 73 22 3e /fossil/leaves"> 0400: 4c 65 61 76 65 73 3c 2f 61 3e 20 6c 69 6e 6b 20 Leaves</a> link 0410: 61 74 0a 74 68 65 20 74 6f 70 20 6f 66 20 74 68 at.the top of th 0420: 65 20 70 61 67 65 2e 3c 2f 70 3e 3c 2f 6c 69 3e e page.</p></li> 0430: 0a 0a 3c 6c 69 3e 3c 70 3e 53 65 6c 65 63 74 20 ..<li><p>Select 0440: 61 20 76 65 72 73 69 6f 6e 20 6f 66 20 6f 66 20 a version of of 0450: 66 6f 73 73 69 6c 20 79 6f 75 20 77 61 6e 74 20 fossil you want 0460: 74 6f 20 64 6f 77 6e 6c 6f 61 64 2e 20 20 43 6c to download. Cl 0470: 69 63 6b 20 6f 6e 20 69 74 73 0a 6c 69 6e 6b 2e ick on its.link. 0480: 20 20 4e 6f 74 65 20 74 68 61 74 20 79 6f 75 20 Note that you 0490: 6d 75 73 74 20 73 75 63 63 65 73 73 66 75 6c 6c must successfull 04a0: 79 20 6c 6f 67 20 69 6e 20 61 73 20 22 61 6e 6f y log in as "ano 04b0: 6e 79 6d 6f 75 73 22 20 69 6e 20 73 74 65 70 20 nymous" in step 04c0: 31 0a 61 62 6f 76 65 20 69 6e 20 6f 72 64 65 72 1.above in order 04d0: 20 74 6f 20 73 65 65 20 74 68 65 20 6c 69 6e 6b to see the link 04e0: 20 74 6f 20 74 68 65 20 64 65 74 61 69 6c 65 64 to the detailed 04f0: 20 76 65 72 73 69 6f 6e 20 69 6e 66 6f 72 6d 61 version informa 0500: 74 69 6f 6e 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a tion.</p></li>.. 0510: 3c 6c 69 3e 3c 70 3e 4f 6e 20 74 68 65 20 76 65 <li><p>On the ve 0520: 72 73 69 6f 6e 20 69 6e 66 6f 72 6d 61 74 69 6f rsion informatio 0530: 6e 20 70 61 67 65 2c 20 63 6c 69 63 6b 20 6f 6e n page, click on 0540: 20 74 68 65 0a 22 5a 69 70 20 41 72 63 68 69 76 the."Zip Archiv 0550: 65 22 20 6c 69 6e 6b 2e 20 20 54 68 69 73 20 6c e" link. This l 0560: 69 6e 6b 20 77 69 6c 6c 20 62 75 69 6c 64 20 61 ink will build a 0570: 20 5a 49 50 20 61 72 63 68 69 76 65 20 6f 66 20 ZIP archive of 0580: 74 68 65 20 0a 63 6f 6d 70 6c 65 74 65 20 73 6f the .complete so 0590: 75 72 63 65 20 63 6f 64 65 20 61 6e 64 20 64 6f urce code and do 05a0: 77 6e 6c 6f 61 64 20 69 74 20 74 6f 20 79 6f 75 wnload it to you 05b0: 72 20 62 72 6f 77 73 65 72 2e 3c 2f 70 3e 3c 2f r browser.</p></ 05c0: 6c 69 3e 0a 3c 2f 6f 6c 3e 0a 0a 3c 68 32 3e 32 li>.</ol>..<h2>2 05d0: 2e 30 20 43 6f 6d 70 69 6c 69 6e 67 3c 2f 68 32 .0 Compiling</h2 05e0: 3e 0a 0a 3c 70 3e 46 6f 6c 6c 6f 77 20 74 68 65 >..<p>Follow the 05f0: 73 65 20 73 74 65 70 73 20 74 6f 20 63 6f 6d 70 se steps to comp 0600: 69 6c 65 3a 3c 2f 70 3e 0a 0a 3c 6f 6c 3e 0a 3c ile:</p>..<ol>.< 0610: 6c 69 20 76 61 6c 75 65 3d 22 36 22 3e 0a 3c 70 li value="6">.<p 0620: 3e 43 72 65 61 74 65 20 61 20 64 69 72 65 63 74 >Create a direct 0630: 6f 72 79 20 74 6f 20 68 6f 6c 64 20 74 68 65 20 ory to hold the 0640: 73 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 54 68 source code. Th 0650: 65 6e 20 75 6e 7a 69 70 20 74 68 65 0a 5a 49 50 en unzip the.ZIP 0660: 20 61 72 63 68 69 76 65 20 79 6f 75 20 64 6f 77 archive you dow 0670: 6e 6c 6f 61 64 65 64 20 69 6e 74 6f 20 74 68 61 nloaded into tha 0680: 74 20 64 69 72 65 63 74 6f 72 79 2e 20 20 59 6f t directory. Yo 0690: 75 20 73 68 6f 75 6c 64 20 62 65 0a 69 6e 20 74 u should be.in t 06a0: 68 65 20 74 6f 70 2d 6c 65 76 65 6c 20 66 6f 6c he top-level fol 06b0: 64 65 72 20 6f 66 20 74 68 61 74 20 64 69 72 65 der of that dire 06c0: 63 74 6f 72 79 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a ctory</p></li>.. 06d0: 3c 6c 69 3e 3c 70 3e 3c 62 3e 28 4f 70 74 69 6f <li><p><b>(Optio 06e0: 6e 61 6c 3a 29 3c 2f 62 3e 0a 45 64 69 74 20 74 nal:)</b>.Edit t 06f0: 68 65 20 4d 61 6b 65 66 69 6c 65 20 74 6f 20 73 he Makefile to s 0700: 65 74 20 69 74 20 75 70 20 6c 69 6b 65 20 79 6f et it up like yo 0710: 75 20 77 61 6e 74 2e 20 20 59 6f 75 20 70 72 6f u want. You pro 0720: 62 61 62 6c 79 20 64 6f 20 6e 6f 74 0a 6e 65 65 bably do not.nee 0730: 64 20 74 6f 20 64 6f 20 61 6e 79 74 68 69 6e 67 d to do anything 0740: 2e 20 20 44 6f 20 6e 6f 74 20 62 65 20 69 6e 74 . Do not be int 0750: 69 6d 69 64 61 74 65 64 3a 20 20 54 68 65 72 65 imidated: There 0760: 20 61 72 65 20 6f 6e 6c 79 20 35 0a 76 61 72 69 are only 5.vari 0770: 61 62 6c 65 73 20 69 6e 20 74 68 65 20 6d 61 6b ables in the mak 0780: 65 66 69 6c 65 20 74 68 61 74 20 63 61 6e 20 62 efile that can b 0790: 65 20 63 68 61 6e 67 65 64 2e 20 20 54 68 65 20 e changed. The 07a0: 77 68 6f 6c 65 20 4d 61 6b 65 66 69 6c 65 0a 69 whole Makefile.i 07b0: 73 20 6f 6e 6c 79 20 61 20 66 65 77 20 64 6f 7a s only a few doz 07c0: 65 6e 20 6c 69 6e 65 73 20 6c 6f 6e 67 20 61 6e en lines long an 07d0: 64 20 6d 6f 73 74 20 6f 66 20 74 68 6f 73 65 20 d most of those 07e0: 6c 69 6e 65 73 20 61 72 65 20 63 6f 6d 6d 65 6e lines are commen 07f0: 74 73 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e ts.</p>..<li><p> 0800: 54 79 70 65 20 22 3c 62 3e 6d 61 6b 65 3c 2f 62 Type "<b>make</b 0810: 3e 22 0a 3c 2f 6f 6c 3e 0a 0a 3c 68 32 3e 33 2e >".</ol>..<h2>3. 0820: 30 20 49 6e 73 74 61 6c 6c 69 6e 67 3c 2f 68 32 0 Installing</h2 0830: 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 20 76 61 6c 75 >..<ol>.<li valu 0840: 65 3d 22 39 22 3e 0a 3c 70 3e 54 68 65 20 66 69 e="9">.<p>The fi 0850: 6e 69 73 68 65 64 20 62 69 6e 61 72 79 20 69 73 nished binary is 0860: 20 6e 61 6d 65 64 20 22 66 6f 73 73 69 6c 22 2e named "fossil". 0870: 20 20 50 75 74 20 74 68 69 73 20 62 69 6e 61 72 Put this binar 0880: 79 20 69 6e 20 61 20 0a 64 69 72 65 63 74 6f 72 y in a .director 0890: 79 20 74 68 61 74 20 69 73 20 73 6f 6d 65 77 68 y that is somewh 08a0: 65 72 65 20 6f 6e 20 79 6f 75 72 20 50 41 54 48 ere on your PATH 08b0: 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 environment var 08c0: 69 61 62 6c 65 2e 0a 49 74 20 64 6f 65 73 20 6e iable..It does n 08d0: 6f 74 20 6d 61 74 74 65 72 20 77 68 65 72 65 2e ot matter where. 08e0: 3c 2f 70 3e 0a 0a 3c 6c 69 3e 0a 3c 70 3e 3c 62 </p>..<li>.<p><b 08f0: 3e 28 4f 70 74 69 6f 6e 61 6c 3a 29 3c 2f 62 3e >(Optional:)</b> 0900: 0a 54 6f 20 75 6e 69 6e 73 74 61 6c 6c 2c 20 6a .To uninstall, j 0910: 75 73 74 20 64 65 6c 65 74 65 20 74 68 65 20 62 ust delete the b 0920: 69 6e 61 72 79 2e 3c 2f 70 3e 0a 3c 2f 6f 6c 3e inary.</p>.</ol> 0930: 0a 0a 3c 2f 62 6f 64 79 3e 0a 3c 2f 68 74 6d 6c ..</body>.</html 0940: 3e 0a >.