Artifact 0933d4792746d6c9ac262744c60d383336bb1c0e:
File www/build.html part of check-in [0e265b0184] - Documentation updates. Added Makefile. by drh on 2007-08-01 20:05:49.
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 68 65 6c 70 20 73 70 69 64 revent help spid 02c0: 65 72 73 20 66 72 6f 6d 0a 77 61 6c 6b 69 6e 67 ers from.walking 02d0: 20 74 68 65 20 77 61 6c 6b 69 6e 67 20 74 68 65 the walking the 02e0: 20 65 6e 74 69 72 65 20 77 65 62 73 69 74 65 2c entire website, 02f0: 20 64 6f 77 6e 6c 6f 61 64 69 6e 67 20 5a 49 50 downloading ZIP 0300: 20 61 72 63 68 69 76 65 73 0a 6f 66 20 65 76 65 archives.of eve 0310: 72 79 20 68 69 73 74 6f 72 69 63 61 6c 20 76 65 ry historical ve 0320: 72 73 69 6f 6e 2c 20 61 6e 64 20 74 68 65 72 65 rsion, and there 0330: 62 79 20 73 6f 61 6b 69 6e 67 20 75 70 20 61 6c by soaking up al 0340: 6c 20 6f 75 72 20 62 61 6e 64 77 69 64 74 68 2e l our bandwidth. 0350: 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c </p></li>..<li>< 0360: 70 3e 43 6c 69 63 6b 20 6f 6e 20 74 68 65 20 0a p>Click on the . 0370: 3c 61 20 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f <a href="http:// 0380: 66 6f 73 73 69 6c 2d 73 63 6d 2e 68 77 61 63 69 fossil-scm.hwaci 0390: 2e 63 6f 6d 2f 66 6f 73 73 69 6c 2f 74 69 6d 65 .com/fossil/time 03a0: 6c 69 6e 65 22 3e 54 69 6d 65 6c 69 6e 65 3c 2f line">Timeline</ 03b0: 61 3e 20 6f 72 0a 3c 61 20 68 72 65 66 3d 22 68 a> or.<a href="h 03c0: 74 74 70 3a 2f 2f 66 6f 73 73 69 6c 2d 73 63 6d ttp://fossil-scm 03d0: 2e 68 77 61 63 69 2e 63 6f 6d 2f 66 6f 73 73 69 .hwaci.com/fossi 03e0: 6c 2f 6c 65 61 76 65 73 22 3e 4c 65 61 76 65 73 l/leaves">Leaves 03f0: 3c 2f 61 3e 20 6c 69 6e 6b 20 61 74 0a 74 68 65 </a> link at.the 0400: 20 74 6f 70 20 6f 66 20 74 68 65 20 70 61 67 65 top of the page 0410: 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e .</p></li>..<li> 0420: 3c 70 3e 53 65 6c 65 63 74 20 61 20 76 65 72 73 <p>Select a vers 0430: 69 6f 6e 20 6f 66 20 6f 66 20 66 6f 73 73 69 6c ion of of fossil 0440: 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 64 6f 77 you want to dow 0450: 6e 6c 6f 61 64 2e 20 20 43 6c 69 63 6b 20 6f 6e nload. Click on 0460: 20 69 74 73 0a 6c 69 6e 6b 2e 20 20 4e 6f 74 65 its.link. Note 0470: 20 74 68 61 74 20 79 6f 75 20 6d 75 73 74 20 73 that you must s 0480: 75 63 63 65 73 73 66 75 6c 6c 79 20 6c 6f 67 20 uccessfully log 0490: 69 6e 20 61 73 20 22 61 6e 6f 6e 79 6d 6f 75 73 in as "anonymous 04a0: 22 20 69 6e 20 73 74 65 70 20 31 0a 61 62 6f 76 " in step 1.abov 04b0: 65 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 73 65 e in order to se 04c0: 65 20 74 68 65 20 6c 69 6e 6b 20 74 6f 20 74 68 e the link to th 04d0: 65 20 64 65 74 61 69 6c 65 64 20 76 65 72 73 69 e detailed versi 04e0: 6f 6e 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 3c on information.< 04f0: 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 /p></li>..<li><p 0500: 3e 4f 6e 20 74 68 65 20 76 65 72 73 69 6f 6e 20 >On the version 0510: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 70 61 67 65 information page 0520: 2c 20 63 6c 69 63 6b 20 6f 6e 20 74 68 65 0a 22 , click on the." 0530: 5a 69 70 20 41 72 63 68 69 76 65 22 20 6c 69 6e Zip Archive" lin 0540: 6b 2e 20 20 54 68 69 73 20 62 75 69 6c 64 20 61 k. This build a 0550: 20 5a 49 50 20 61 72 63 68 69 76 65 20 6f 66 20 ZIP archive of 0560: 74 68 65 20 63 6f 6d 70 6c 65 74 65 20 73 6f 75 the complete sou 0570: 72 63 65 0a 63 6f 64 65 20 61 6e 64 20 72 65 74 rce.code and ret 0580: 75 72 6e 20 69 74 20 74 6f 20 79 6f 75 72 20 62 urn it to your b 0590: 72 6f 77 73 65 72 2e 3c 2f 70 3e 3c 2f 6c 69 3e rowser.</p></li> 05a0: 0a 3c 2f 6f 6c 3e 0a 0a 3c 68 32 3e 32 2e 30 20 .</ol>..<h2>2.0 05b0: 43 6f 6d 70 69 6c 69 6e 67 3c 2f 68 32 3e 0a 0a Compiling</h2>.. 05c0: 3c 70 3e 46 6f 6c 6c 6f 77 20 74 68 65 73 65 20 <p>Follow these 05d0: 73 74 6f 70 73 20 74 6f 20 63 6f 6d 70 69 6c 65 stops to compile 05e0: 3a 3c 2f 70 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 20 :</p>..<ol>.<li 05f0: 76 61 6c 75 65 3d 22 36 22 3e 0a 3c 70 3e 43 72 value="6">.<p>Cr 0600: 65 61 74 65 20 61 20 64 69 72 65 63 74 6f 72 79 eate a directory 0610: 20 74 6f 20 68 6f 6c 64 20 74 68 65 20 73 6f 75 to hold the sou 0620: 72 63 65 20 63 6f 64 65 2e 20 20 54 68 65 6e 20 rce code. Then 0630: 75 6e 7a 69 70 20 74 68 65 0a 5a 49 50 20 61 72 unzip the.ZIP ar 0640: 63 68 69 76 65 20 79 6f 75 20 64 6f 77 6e 6c 6f chive you downlo 0650: 61 64 65 64 20 69 6e 74 6f 20 74 68 61 74 20 64 aded into that d 0660: 69 72 65 63 74 6f 72 79 2e 20 20 59 6f 75 20 73 irectory. You s 0670: 68 6f 75 6c 64 20 62 65 0a 69 6e 20 74 68 65 20 hould be.in the 0680: 74 6f 70 2d 6c 65 76 65 6c 20 66 6f 6c 64 65 72 top-level folder 0690: 20 6f 66 20 74 68 61 74 20 64 69 72 65 63 74 6f of that directo 06a0: 72 79 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 ry</p></li>..<li 06b0: 3e 3c 70 3e 3c 62 3e 28 4f 70 74 69 6f 6e 61 6c ><p><b>(Optional 06c0: 3a 29 3c 2f 62 3e 0a 45 64 69 74 20 74 68 65 20 :)</b>.Edit the 06d0: 4d 61 6b 65 66 69 6c 65 20 74 6f 20 73 65 74 20 Makefile to set 06e0: 69 74 20 75 70 20 6c 69 6b 65 20 79 6f 75 20 77 it up like you w 06f0: 61 6e 74 2e 20 20 59 6f 75 20 70 72 6f 62 61 62 ant. You probab 0700: 6c 79 20 64 6f 20 6e 6f 74 0a 6e 65 65 64 20 74 ly do not.need t 0710: 6f 20 64 6f 20 61 6e 79 74 68 69 6e 67 2e 20 20 o do anything. 0720: 44 6f 20 6e 6f 74 20 62 65 20 69 6e 74 69 6d 69 Do not be intimi 0730: 64 61 74 65 64 3a 20 20 54 68 65 72 65 20 61 72 dated: There ar 0740: 65 20 6f 6e 6c 79 20 35 0a 76 61 72 69 61 62 6c e only 5.variabl 0750: 65 73 20 69 6e 20 74 68 65 20 6d 61 6b 65 66 69 es in the makefi 0760: 6c 65 20 74 68 61 74 20 63 61 6e 20 62 65 20 63 le that can be c 0770: 68 61 6e 67 65 64 2e 20 20 54 68 65 20 77 68 6f hanged. The who 0780: 6c 65 20 4d 61 6b 65 66 69 6c 65 0a 69 73 20 6f le Makefile.is o 0790: 6e 6c 79 20 61 20 66 65 77 20 64 6f 7a 65 6e 20 nly a few dozen 07a0: 6c 69 6e 65 73 20 6c 6f 6e 67 20 61 6e 64 20 6d lines long and m 07b0: 6f 73 74 20 6f 66 20 74 68 6f 73 65 20 6c 69 6e ost of those lin 07c0: 65 73 20 61 72 65 20 63 6f 6d 6d 65 6e 74 73 2e es are comments. 07d0: 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 54 79 70 </p>..<li><p>Typ 07e0: 65 20 22 3c 62 3e 6d 61 6b 65 3c 2f 62 3e 22 0a e "<b>make</b>". 07f0: 3c 2f 6f 6c 3e 0a 0a 3c 68 32 3e 33 2e 30 20 49 </ol>..<h2>3.0 I 0800: 6e 73 74 61 6c 6c 69 6e 67 3c 2f 68 32 3e 0a 0a nstalling</h2>.. 0810: 3c 6f 6c 3e 0a 3c 6c 69 20 76 61 6c 75 65 3d 22 <ol>.<li value=" 0820: 39 22 3e 0a 3c 70 3e 54 68 65 20 66 69 6e 69 73 9">.<p>The finis 0830: 68 65 64 20 62 69 6e 61 72 79 20 69 73 20 6e 61 hed binary is na 0840: 6d 65 64 20 22 66 6f 73 73 69 6c 22 2e 20 20 50 med "fossil". P 0850: 75 74 20 74 68 69 73 20 62 69 6e 61 72 79 20 69 ut this binary i 0860: 6e 20 61 20 0a 64 69 72 65 63 74 6f 72 79 20 74 n a .directory t 0870: 68 61 74 20 69 73 20 73 6f 6d 65 77 68 65 72 65 hat is somewhere 0880: 20 6f 6e 20 79 6f 75 72 20 50 41 54 48 20 65 6e on your PATH en 0890: 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 vironment variab 08a0: 6c 65 2e 0a 49 74 20 64 6f 65 73 20 6e 6f 74 20 le..It does not 08b0: 6d 61 74 74 65 72 20 77 68 65 72 65 2e 3c 2f 70 matter where.</p 08c0: 3e 0a 0a 3c 6c 69 3e 0a 3c 70 3e 3c 62 3e 28 4f >..<li>.<p><b>(O 08d0: 70 74 69 6f 6e 61 6c 3a 29 3c 2f 62 3e 0a 54 6f ptional:)</b>.To 08e0: 20 75 6e 69 6e 73 74 61 6c 6c 2c 20 6a 75 73 74 uninstall, just 08f0: 20 64 65 6c 65 74 65 20 74 68 65 20 62 69 6e 61 delete the bina 0900: 72 79 2e 3c 2f 70 3e 0a 3c 2f 6f 6c 3e 0a 0a 3c ry.</p>.</ol>..< 0910: 2f 62 6f 64 79 3e 0a 3c 2f 68 74 6d 6c 3e 0a /body>.</html>.