Artifact a81964674be15b5291386d1904697a3c83872668:
File www/build.wiki part of check-in [7a2c37063a] - merge trunk into creole branch by bob on 2009-09-22 07:49:39. Also file www/build.wiki part of check-in [522824b26a] - Documentation updates, including a big rework of the homepage. by drh on 2009-08-28 16:05:03.
0000: 3c 74 69 74 6c 65 3e 42 75 69 6c 64 69 6e 67 20 <title>Building 0010: 61 6e 64 20 49 6e 73 74 61 6c 6c 69 6e 67 20 46 and Installing F 0020: 6f 73 73 69 6c 3c 2f 74 69 74 6c 65 3e 0a 3c 6e ossil</title>.<n 0030: 6f 77 69 6b 69 3e 0a 0a 3c 70 3e 54 68 69 73 20 owiki>..<p>This 0040: 70 61 67 65 20 64 65 73 63 72 69 62 65 73 20 68 page describes h 0050: 6f 77 20 74 6f 20 62 75 69 6c 64 20 61 6e 64 20 ow to build and 0060: 69 6e 73 74 61 6c 6c 20 46 6f 73 73 69 6c 2e 20 install Fossil. 0070: 20 54 68 65 0a 77 68 6f 6c 65 20 70 72 6f 63 65 The.whole proce 0080: 73 73 20 69 73 20 64 65 73 69 67 6e 65 64 20 74 ss is designed t 0090: 6f 20 62 65 20 76 65 72 79 20 65 61 73 79 2e 3c o be very easy.< 00a0: 2f 70 3e 0a 0a 3c 68 32 3e 30 2e 30 20 55 73 69 /p>..<h2>0.0 Usi 00b0: 6e 67 20 41 20 50 72 65 2d 63 6f 6d 70 69 6c 65 ng A Pre-compile 00c0: 64 20 42 69 6e 61 72 79 3c 2f 68 32 3e 0a 0a 3c d Binary</h2>..< 00d0: 70 3e 59 6f 75 20 63 61 6e 20 73 6b 69 70 20 73 p>You can skip s 00e0: 74 65 70 73 20 31 2e 30 20 61 6e 64 20 32 2e 30 teps 1.0 and 2.0 00f0: 20 62 65 6c 6f 77 20 62 79 20 64 6f 77 6e 6c 6f below by downlo 0100: 61 64 69 6e 67 0a 61 20 3c 61 20 68 72 65 66 3d ading.a <a href= 0110: 22 68 74 74 70 3a 2f 2f 77 77 77 2e 66 6f 73 73 "http://www.foss 0120: 69 6c 2d 73 63 6d 2e 6f 72 67 2f 64 6f 77 6e 6c il-scm.org/downl 0130: 6f 61 64 2e 68 74 6d 6c 22 3e 70 72 65 2d 63 6f oad.html">pre-co 0140: 6d 70 69 6c 65 64 20 62 69 6e 61 72 79 3c 2f 61 mpiled binary</a 0150: 3e 0a 61 70 70 72 6f 70 72 69 61 74 65 20 66 6f >.appropriate fo 0160: 72 20 79 6f 75 72 20 70 6c 61 74 66 6f 72 6d 2e r your platform. 0170: 20 20 49 66 20 79 6f 75 20 75 73 65 20 61 20 70 If you use a p 0180: 72 65 2d 63 6f 6d 70 69 6c 65 64 20 62 69 6e 61 re-compiled bina 0190: 72 79 0a 6a 75 6d 70 20 69 6d 6d 65 64 69 61 74 ry.jump immediat 01a0: 65 20 74 6f 20 73 74 65 70 20 33 2e 30 2e 3c 2f e to step 3.0.</ 01b0: 70 3e 0a 0a 3c 68 32 3e 31 2e 30 20 4f 62 74 61 p>..<h2>1.0 Obta 01c0: 69 6e 69 6e 67 20 54 68 65 20 53 6f 75 72 63 65 ining The Source 01d0: 20 43 6f 64 65 3c 2f 68 32 3e 0a 0a 3c 70 3e 46 Code</h2>..<p>F 01e0: 6f 73 73 69 6c 20 69 73 20 73 65 6c 66 2d 68 6f ossil is self-ho 01f0: 73 74 69 6e 67 2c 20 73 6f 20 79 6f 75 20 63 61 sting, so you ca 0200: 6e 20 6f 62 74 61 69 6e 20 61 20 5a 49 50 20 61 n obtain a ZIP a 0210: 72 63 68 69 76 65 20 63 6f 6e 74 61 69 6e 69 6e rchive containin 0220: 67 0a 61 20 73 6e 61 70 73 68 6f 74 20 6f 66 20 g.a snapshot of 0230: 74 68 65 20 6c 61 74 65 73 74 20 76 65 72 73 69 the latest versi 0240: 6f 6e 20 64 69 72 65 63 74 6c 79 20 66 72 6f 6d on directly from 0250: 20 66 6f 73 73 69 6c 27 73 20 6f 77 6e 20 66 6f fossil's own fo 0260: 73 73 69 6c 0a 72 65 70 6f 73 69 74 6f 72 79 2e ssil.repository. 0270: 20 20 46 6f 6c 6c 6f 77 20 74 68 65 73 65 20 73 Follow these s 0280: 74 65 70 73 3a 3c 2f 70 3e 0a 0a 3c 6f 6c 3e 0a teps:</p>..<ol>. 0290: 3c 6c 69 3e 3c 70 3e 50 6f 69 6e 74 65 72 20 79 <li><p>Pointer y 02a0: 6f 75 72 20 77 65 62 20 62 72 6f 77 73 65 72 20 our web browser 02b0: 61 74 0a 3c 61 20 68 72 65 66 3d 22 68 74 74 70 at.<a href="http 02c0: 3a 2f 2f 77 77 77 2e 66 6f 73 73 69 6c 2d 73 63 ://www.fossil-sc 02d0: 6d 2e 6f 72 67 2f 22 3e 0a 68 74 74 70 3a 2f 2f m.org/">.http:// 02e0: 77 77 77 2e 66 6f 73 73 69 6c 2d 73 63 6d 2e 6f www.fossil-scm.o 02f0: 72 67 2f 3c 2f 61 3e 2e 20 20 43 6c 69 63 6b 20 rg/</a>. Click 0300: 6f 6e 20 74 68 65 20 22 4c 6f 67 69 6e 22 20 6d on the "Login" m 0310: 65 6e 75 20 62 75 74 74 6f 6e 2e 3c 2f 70 3e 3c enu button.</p>< 0320: 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 4c 6f 67 /li>..<li><p>Log 0330: 20 69 6e 20 61 73 20 61 6e 6f 6e 79 6d 6f 75 73 in as anonymous 0340: 2e 20 20 54 68 65 20 70 61 73 73 77 6f 72 64 20 . The password 0350: 69 73 20 73 68 6f 77 6e 20 6f 6e 20 73 63 72 65 is shown on scre 0360: 65 6e 2e 0a 54 68 65 20 72 65 61 73 6f 6e 20 66 en..The reason f 0370: 6f 72 20 72 65 71 75 69 72 69 6e 67 20 74 68 69 or requiring thi 0380: 73 20 6c 6f 67 69 6e 20 69 73 20 74 6f 20 70 72 s login is to pr 0390: 65 76 65 6e 74 20 73 70 69 64 65 72 73 20 66 72 event spiders fr 03a0: 6f 6d 0a 77 61 6c 6b 69 6e 67 20 74 68 65 20 65 om.walking the e 03b0: 6e 74 69 72 65 20 77 65 62 73 69 74 65 2c 20 64 ntire website, d 03c0: 6f 77 6e 6c 6f 61 64 69 6e 67 20 5a 49 50 20 61 ownloading ZIP a 03d0: 72 63 68 69 76 65 73 0a 6f 66 20 65 76 65 72 79 rchives.of every 03e0: 20 68 69 73 74 6f 72 69 63 61 6c 20 76 65 72 73 historical vers 03f0: 69 6f 6e 2c 20 61 6e 64 20 74 68 65 72 65 62 79 ion, and thereby 0400: 20 73 6f 61 6b 69 6e 67 20 75 70 20 61 6c 6c 20 soaking up all 0410: 6f 75 72 20 62 61 6e 64 77 69 64 74 68 2e 3c 2f our bandwidth.</ 0420: 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e p></li>..<li><p> 0430: 43 6c 69 63 6b 20 6f 6e 20 74 68 65 20 0a 3c 61 Click on the .<a 0440: 20 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f 77 77 href="http://ww 0450: 77 2e 66 6f 73 73 69 6c 2d 73 63 6d 2e 6f 72 67 w.fossil-scm.org 0460: 2f 66 6f 73 73 69 6c 2f 74 69 6d 65 6c 69 6e 65 /fossil/timeline 0470: 22 3e 54 69 6d 65 6c 69 6e 65 3c 2f 61 3e 20 6f ">Timeline</a> o 0480: 72 0a 3c 61 20 68 72 65 66 3d 22 68 74 74 70 3a r.<a href="http: 0490: 2f 2f 77 77 77 2e 66 6f 73 73 69 6c 2d 73 63 6d //www.fossil-scm 04a0: 2e 6f 72 67 2f 66 6f 73 73 69 6c 2f 6c 65 61 76 .org/fossil/leav 04b0: 65 73 22 3e 4c 65 61 76 65 73 3c 2f 61 3e 20 6c es">Leaves</a> l 04c0: 69 6e 6b 20 61 74 0a 74 68 65 20 74 6f 70 20 6f ink at.the top o 04d0: 66 20 74 68 65 20 70 61 67 65 2e 3c 2f 70 3e 3c f the page.</p>< 04e0: 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 53 65 6c /li>..<li><p>Sel 04f0: 65 63 74 20 61 20 76 65 72 73 69 6f 6e 20 6f 66 ect a version of 0500: 20 6f 66 20 66 6f 73 73 69 6c 20 79 6f 75 20 77 of fossil you w 0510: 61 6e 74 20 74 6f 20 64 6f 77 6e 6c 6f 61 64 2e ant to download. 0520: 20 20 43 6c 69 63 6b 20 6f 6e 20 69 74 73 0a 6c Click on its.l 0530: 69 6e 6b 2e 20 20 4e 6f 74 65 20 74 68 61 74 20 ink. Note that 0540: 79 6f 75 20 6d 75 73 74 20 73 75 63 63 65 73 73 you must success 0550: 66 75 6c 6c 79 20 6c 6f 67 20 69 6e 20 61 73 20 fully log in as 0560: 22 61 6e 6f 6e 79 6d 6f 75 73 22 20 69 6e 20 73 "anonymous" in s 0570: 74 65 70 20 31 0a 61 62 6f 76 65 20 69 6e 20 6f tep 1.above in o 0580: 72 64 65 72 20 74 6f 20 73 65 65 20 74 68 65 20 rder to see the 0590: 6c 69 6e 6b 20 74 6f 20 74 68 65 20 64 65 74 61 link to the deta 05a0: 69 6c 65 64 20 76 65 72 73 69 6f 6e 20 69 6e 66 iled version inf 05b0: 6f 72 6d 61 74 69 6f 6e 2e 3c 2f 70 3e 3c 2f 6c ormation.</p></l 05c0: 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 4f 6e 20 74 68 i>..<li><p>On th 05d0: 65 20 76 65 72 73 69 6f 6e 20 69 6e 66 6f 72 6d e version inform 05e0: 61 74 69 6f 6e 20 70 61 67 65 2c 20 63 6c 69 63 ation page, clic 05f0: 6b 20 6f 6e 20 74 68 65 20 22 5b 64 65 74 61 69 k on the "[detai 0600: 6c 73 5d 22 20 68 79 70 65 72 6c 69 6e 6b 0a 74 ls]" hyperlink.t 0610: 68 61 74 20 61 70 70 65 61 72 73 20 72 69 67 68 hat appears righ 0620: 74 20 61 66 74 65 72 20 74 68 65 20 63 68 65 63 t after the chec 0630: 6b 2d 69 6e 20 63 6f 6d 6d 65 6e 74 20 61 74 20 k-in comment at 0640: 74 68 65 20 74 6f 70 20 6f 66 20 74 68 65 20 70 the top of the p 0650: 61 67 65 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 age.</p>..<li><p 0660: 3e 46 69 6e 61 6c 6c 79 2c 20 63 6c 69 63 6b 20 >Finally, click 0670: 6f 6e 20 74 68 65 0a 22 5a 69 70 20 41 72 63 68 on the."Zip Arch 0680: 69 76 65 22 20 6c 69 6e 6b 2e 20 20 54 68 69 73 ive" link. This 0690: 20 6c 69 6e 6b 20 77 69 6c 6c 20 62 75 69 6c 64 link will build 06a0: 20 61 20 5a 49 50 20 61 72 63 68 69 76 65 20 6f a ZIP archive o 06b0: 66 20 74 68 65 20 0a 63 6f 6d 70 6c 65 74 65 20 f the .complete 06c0: 73 6f 75 72 63 65 20 63 6f 64 65 20 61 6e 64 20 source code and 06d0: 64 6f 77 6e 6c 6f 61 64 20 69 74 20 74 6f 20 79 download it to y 06e0: 6f 75 72 20 62 72 6f 77 73 65 72 2e 0a 0a 3c 62 our browser...<b 06f0: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 69 3e 0a 4e 6f lockquote><i>.No 0700: 74 65 20 74 6f 20 4d 61 63 20 75 73 65 72 73 3a te to Mac users: 0710: 20 20 54 68 65 20 5a 49 50 20 61 72 63 68 69 76 The ZIP archiv 0720: 65 20 63 6f 6e 73 74 72 75 63 74 65 64 20 62 79 e constructed by 0730: 20 46 6f 73 73 69 6c 20 69 73 20 61 20 77 65 6c Fossil is a wel 0740: 6c 2d 66 6f 72 6d 65 64 0a 5a 49 50 20 61 72 63 l-formed.ZIP arc 0750: 68 69 76 65 2e 20 20 48 6f 77 65 76 65 72 2c 20 hive. However, 0760: 74 68 65 20 75 6e 61 72 63 68 69 76 65 72 20 74 the unarchiver t 0770: 68 61 74 20 69 73 20 62 75 69 6c 74 20 69 6e 74 hat is built int 0780: 6f 20 74 68 65 20 4d 61 63 20 68 61 73 20 61 20 o the Mac has a 0790: 62 75 67 0a 69 6e 20 74 68 61 74 20 69 74 20 64 bug.in that it d 07a0: 6f 65 73 20 6e 6f 74 20 75 6e 64 65 72 73 74 61 oes not understa 07b0: 6e 64 20 61 6c 6c 20 77 65 6c 6c 2d 66 6f 72 6d nd all well-form 07c0: 65 64 20 5a 49 50 20 61 72 63 68 69 76 65 73 2e ed ZIP archives. 07d0: 20 20 53 6f 20 79 6f 75 20 6d 61 79 0a 67 65 74 So you may.get 07e0: 20 61 6e 20 65 72 72 6f 72 20 77 68 65 6e 20 74 an error when t 07f0: 68 65 20 4d 61 63 20 67 6f 65 73 20 74 6f 20 61 he Mac goes to a 0800: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 65 78 74 utomatically ext 0810: 72 61 63 74 20 74 68 65 20 64 6f 77 6e 6c 6f 61 ract the downloa 0820: 64 65 64 20 5a 49 50 0a 61 72 63 68 69 76 65 2e ded ZIP.archive. 0830: 20 20 57 65 20 61 72 65 20 73 74 69 6c 6c 20 74 We are still t 0840: 72 79 69 6e 67 20 74 6f 20 66 69 67 75 72 65 20 rying to figure 0850: 6f 75 74 20 77 68 61 74 20 69 74 20 69 73 20 61 out what it is a 0860: 62 6f 75 74 20 46 6f 73 73 69 6c 2d 67 65 6e 65 bout Fossil-gene 0870: 72 61 74 65 64 0a 5a 49 50 20 61 72 63 68 69 76 rated.ZIP archiv 0880: 65 73 20 74 68 61 74 20 74 68 65 20 4d 61 63 20 es that the Mac 0890: 64 6f 65 73 6e 27 74 20 6c 69 6b 65 2e 20 20 55 doesn't like. U 08a0: 6e 74 69 6c 20 77 65 20 64 6f 2c 20 0a 79 6f 75 ntil we do, .you 08b0: 72 20 77 6f 72 6b 2d 61 72 6f 75 6e 64 20 69 73 r work-around is 08c0: 20 74 6f 20 6d 61 6e 75 61 6c 6c 79 20 65 78 74 to manually ext 08d0: 72 61 63 74 20 74 68 65 20 5a 49 50 20 61 72 63 ract the ZIP arc 08e0: 68 69 76 65 20 75 73 69 6e 67 20 74 68 65 0a 22 hive using the." 08f0: 75 6e 7a 69 70 22 20 63 6f 6d 6d 61 6e 64 20 66 unzip" command f 0900: 72 6f 6d 20 61 20 63 6f 6d 6d 61 6e 64 2d 6c 69 rom a command-li 0910: 6e 65 20 73 68 65 6c 6c 2e 0a 3c 2f 69 3e 3c 2f ne shell..</i></ 0920: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 2f 6f 6c blockquote>.</ol 0930: 3e 0a 0a 3c 68 32 3e 32 2e 30 20 43 6f 6d 70 69 >..<h2>2.0 Compi 0940: 6c 69 6e 67 3c 2f 68 32 3e 0a 0a 3c 70 3e 46 6f ling</h2>..<p>Fo 0950: 6c 6c 6f 77 20 74 68 65 73 65 20 73 74 65 70 73 llow these steps 0960: 20 74 6f 20 63 6f 6d 70 69 6c 65 3a 3c 2f 70 3e to compile:</p> 0970: 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 20 76 61 6c 75 65 ..<ol>.<li value 0980: 3d 22 36 22 3e 0a 3c 70 3e 43 72 65 61 74 65 20 ="6">.<p>Create 0990: 61 20 64 69 72 65 63 74 6f 72 79 20 74 6f 20 68 a directory to h 09a0: 6f 6c 64 20 74 68 65 20 73 6f 75 72 63 65 20 63 old the source c 09b0: 6f 64 65 2e 20 20 54 68 65 6e 20 75 6e 7a 69 70 ode. Then unzip 09c0: 20 74 68 65 0a 5a 49 50 20 61 72 63 68 69 76 65 the.ZIP archive 09d0: 20 79 6f 75 20 64 6f 77 6e 6c 6f 61 64 65 64 20 you downloaded 09e0: 69 6e 74 6f 20 74 68 61 74 20 64 69 72 65 63 74 into that direct 09f0: 6f 72 79 2e 20 20 59 6f 75 20 73 68 6f 75 6c 64 ory. You should 0a00: 20 62 65 0a 69 6e 20 74 68 65 20 74 6f 70 2d 6c be.in the top-l 0a10: 65 76 65 6c 20 66 6f 6c 64 65 72 20 6f 66 20 74 evel folder of t 0a20: 68 61 74 20 64 69 72 65 63 74 6f 72 79 3c 2f 70 hat directory</p 0a30: 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c ></li>..<li><p>< 0a40: 62 3e 28 4f 70 74 69 6f 6e 61 6c 3a 29 3c 2f 62 b>(Optional:)</b 0a50: 3e 0a 45 64 69 74 20 74 68 65 20 4d 61 6b 65 66 >.Edit the Makef 0a60: 69 6c 65 20 74 6f 20 73 65 74 20 69 74 20 75 70 ile to set it up 0a70: 20 6c 69 6b 65 20 79 6f 75 20 77 61 6e 74 2e 20 like you want. 0a80: 20 59 6f 75 20 70 72 6f 62 61 62 6c 79 20 64 6f You probably do 0a90: 20 6e 6f 74 0a 6e 65 65 64 20 74 6f 20 64 6f 20 not.need to do 0aa0: 61 6e 79 74 68 69 6e 67 2e 20 20 44 6f 20 6e 6f anything. Do no 0ab0: 74 20 62 65 20 69 6e 74 69 6d 69 64 61 74 65 64 t be intimidated 0ac0: 3a 20 20 54 68 65 72 65 20 61 72 65 20 6f 6e 6c : There are onl 0ad0: 79 20 35 0a 76 61 72 69 61 62 6c 65 73 20 69 6e y 5.variables in 0ae0: 20 74 68 65 20 6d 61 6b 65 66 69 6c 65 20 74 68 the makefile th 0af0: 61 74 20 63 61 6e 20 62 65 20 63 68 61 6e 67 65 at can be change 0b00: 64 2e 20 20 54 68 65 20 77 68 6f 6c 65 20 4d 61 d. The whole Ma 0b10: 6b 65 66 69 6c 65 0a 69 73 20 6f 6e 6c 79 20 61 kefile.is only a 0b20: 20 66 65 77 20 64 6f 7a 65 6e 20 6c 69 6e 65 73 few dozen lines 0b30: 20 6c 6f 6e 67 20 61 6e 64 20 6d 6f 73 74 20 6f long and most o 0b40: 66 20 74 68 6f 73 65 20 6c 69 6e 65 73 20 61 72 f those lines ar 0b50: 65 20 63 6f 6d 6d 65 6e 74 73 2e 3c 2f 70 3e 0a e comments.</p>. 0b60: 0a 3c 6c 69 3e 3c 70 3e 54 79 70 65 20 22 3c 62 .<li><p>Type "<b 0b70: 3e 6d 61 6b 65 3c 2f 62 3e 22 0a 3c 2f 6f 6c 3e >make</b>".</ol> 0b80: 0a 0a 3c 68 32 3e 33 2e 30 20 49 6e 73 74 61 6c ..<h2>3.0 Instal 0b90: 6c 69 6e 67 3c 2f 68 32 3e 0a 0a 3c 6f 6c 3e 0a ling</h2>..<ol>. 0ba0: 3c 6c 69 20 76 61 6c 75 65 3d 22 39 22 3e 0a 3c <li value="9">.< 0bb0: 70 3e 54 68 65 20 66 69 6e 69 73 68 65 64 20 62 p>The finished b 0bc0: 69 6e 61 72 79 20 69 73 20 6e 61 6d 65 64 20 22 inary is named " 0bd0: 66 6f 73 73 69 6c 22 2e 20 20 50 75 74 20 74 68 fossil". Put th 0be0: 69 73 20 62 69 6e 61 72 79 20 69 6e 20 61 20 0a is binary in a . 0bf0: 64 69 72 65 63 74 6f 72 79 20 74 68 61 74 20 69 directory that i 0c00: 73 20 73 6f 6d 65 77 68 65 72 65 20 6f 6e 20 79 s somewhere on y 0c10: 6f 75 72 20 50 41 54 48 20 65 6e 76 69 72 6f 6e our PATH environ 0c20: 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 2e 0a 49 ment variable..I 0c30: 74 20 64 6f 65 73 20 6e 6f 74 20 6d 61 74 74 65 t does not matte 0c40: 72 20 77 68 65 72 65 2e 3c 2f 70 3e 0a 0a 3c 6c r where.</p>..<l 0c50: 69 3e 0a 3c 70 3e 3c 62 3e 28 4f 70 74 69 6f 6e i>.<p><b>(Option 0c60: 61 6c 3a 29 3c 2f 62 3e 0a 54 6f 20 75 6e 69 6e al:)</b>.To unin 0c70: 73 74 61 6c 6c 2c 20 6a 75 73 74 20 64 65 6c 65 stall, just dele 0c80: 74 65 20 74 68 65 20 62 69 6e 61 72 79 2e 3c 2f te the binary.</ 0c90: 70 3e 0a 3c 2f 6f 6c 3e 0a p>.</ol>.