Artifact bd5f08e8f59270382739e84247f7541cd0997671:
File www/build.wiki part of check-in [9eb6ea75c1] - doc changes -- spelling corrections and embedded ref pages. by kejoki on 2008-11-11 03:50:39.
0000: 3c 6e 6f 77 69 6b 69 3e 0a 3c 68 31 3e 49 6e 73 <nowiki>.<h1>Ins 0010: 74 61 6c 6c 69 6e 67 20 46 6f 73 73 69 6c 3c 2f talling Fossil</ 0020: 68 31 3e 0a 0a 3c 70 3e 54 68 69 73 20 70 61 67 h1>..<p>This pag 0030: 65 20 64 65 73 63 72 69 62 65 73 20 68 6f 77 20 e describes how 0040: 74 6f 20 62 75 69 6c 64 20 61 6e 64 20 69 6e 73 to build and ins 0050: 74 61 6c 6c 20 46 6f 73 73 69 6c 2e 20 20 54 68 tall Fossil. Th 0060: 65 0a 77 68 6f 6c 65 20 70 72 6f 63 65 73 73 20 e.whole process 0070: 69 73 20 64 65 73 69 67 6e 65 64 20 74 6f 20 62 is designed to b 0080: 65 20 76 65 72 79 20 65 61 73 79 2e 3c 2f 70 3e e very easy.</p> 0090: 0a 0a 3c 68 32 3e 30 2e 30 20 55 73 69 6e 67 20 ..<h2>0.0 Using 00a0: 41 20 50 72 65 2d 63 6f 6d 70 69 6c 65 64 20 42 A Pre-compiled B 00b0: 69 6e 61 72 79 3c 2f 68 32 3e 0a 0a 3c 70 3e 59 inary</h2>..<p>Y 00c0: 6f 75 20 63 61 6e 20 73 6b 69 70 20 73 74 65 70 ou can skip step 00d0: 73 20 31 2e 30 20 61 6e 64 20 32 2e 30 20 62 65 s 1.0 and 2.0 be 00e0: 6c 6f 77 20 62 79 20 64 6f 77 6e 6c 6f 61 64 69 low by downloadi 00f0: 6e 67 0a 61 20 3c 61 20 68 72 65 66 3d 22 68 74 ng.a <a href="ht 0100: 74 70 3a 2f 2f 77 77 77 2e 66 6f 73 73 69 6c 2d tp://www.fossil- 0110: 73 63 6d 2e 6f 72 67 2f 64 6f 77 6e 6c 6f 61 64 scm.org/download 0120: 2e 68 74 6d 6c 22 3e 70 72 65 2d 63 6f 6d 70 69 .html">pre-compi 0130: 6c 65 64 20 62 69 6e 61 72 79 3c 2f 61 3e 0a 61 led binary</a>.a 0140: 70 70 72 6f 70 72 69 61 74 65 20 66 6f 72 20 79 ppropriate for y 0150: 6f 75 72 20 70 6c 61 74 66 6f 72 6d 2e 20 20 49 our platform. I 0160: 66 20 79 6f 75 20 75 73 65 20 61 20 70 72 65 2d f you use a pre- 0170: 63 6f 6d 70 69 6c 65 64 20 62 69 6e 61 72 79 0a compiled binary. 0180: 6a 75 6d 70 20 69 6d 6d 65 64 69 61 74 65 20 74 jump immediate t 0190: 6f 20 73 74 65 70 20 33 2e 30 2e 3c 2f 70 3e 0a o step 3.0.</p>. 01a0: 0a 3c 68 32 3e 31 2e 30 20 4f 62 74 61 69 6e 69 .<h2>1.0 Obtaini 01b0: 6e 67 20 54 68 65 20 53 6f 75 72 63 65 20 43 6f ng The Source Co 01c0: 64 65 3c 2f 68 32 3e 0a 0a 3c 70 3e 46 6f 73 73 de</h2>..<p>Foss 01d0: 69 6c 20 69 73 20 73 65 6c 66 2d 68 6f 73 74 69 il is self-hosti 01e0: 6e 67 2c 20 73 6f 20 79 6f 75 20 63 61 6e 20 6f ng, so you can o 01f0: 62 74 61 69 6e 20 61 20 5a 49 50 20 61 72 63 68 btain a ZIP arch 0200: 69 76 65 20 63 6f 6e 74 61 69 6e 69 6e 67 0a 61 ive containing.a 0210: 20 73 6e 61 70 73 68 6f 74 20 6f 66 20 74 68 65 snapshot of the 0220: 20 6c 61 74 65 73 74 20 76 65 72 73 69 6f 6e 20 latest version 0230: 64 69 72 65 63 74 6c 79 20 66 72 6f 6d 20 66 6f directly from fo 0240: 73 73 69 6c 27 73 20 6f 77 6e 20 66 6f 73 73 69 ssil's own fossi 0250: 6c 0a 72 65 70 6f 73 69 74 6f 72 79 2e 20 20 46 l.repository. F 0260: 6f 6c 6c 6f 77 20 74 68 65 73 65 20 73 74 65 70 ollow these step 0270: 73 3a 3c 2f 70 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 s:</p>..<ol>.<li 0280: 3e 3c 70 3e 50 6f 69 6e 74 65 72 20 79 6f 75 72 ><p>Pointer your 0290: 20 77 65 62 20 62 72 6f 77 73 65 72 20 61 74 0a web browser at. 02a0: 3c 61 20 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f <a href="http:// 02b0: 77 77 77 2e 66 6f 73 73 69 6c 2d 73 63 6d 2e 6f www.fossil-scm.o 02c0: 72 67 2f 22 3e 0a 68 74 74 70 3a 2f 2f 77 77 77 rg/">.http://www 02d0: 2e 66 6f 73 73 69 6c 2d 73 63 6d 2e 6f 72 67 2f .fossil-scm.org/ 02e0: 3c 2f 61 3e 2e 20 20 43 6c 69 63 6b 20 6f 6e 20 </a>. Click on 02f0: 74 68 65 20 22 4c 6f 67 69 6e 22 20 6d 65 6e 75 the "Login" menu 0300: 20 62 75 74 74 6f 6e 2e 3c 2f 70 3e 3c 2f 6c 69 button.</p></li 0310: 3e 0a 0a 3c 6c 69 3e 3c 70 3e 4c 6f 67 20 69 6e >..<li><p>Log in 0320: 20 61 73 20 61 6e 6f 6e 79 6d 6f 75 73 2e 20 20 as anonymous. 0330: 54 68 65 20 70 61 73 73 77 6f 72 64 20 69 73 20 The password is 0340: 73 68 6f 77 6e 20 6f 6e 20 73 63 72 65 65 6e 2e shown on screen. 0350: 0a 54 68 65 20 72 65 61 73 6f 6e 20 66 6f 72 20 .The reason for 0360: 72 65 71 75 69 72 69 6e 67 20 74 68 69 73 20 6c requiring this l 0370: 6f 67 69 6e 20 69 73 20 74 6f 20 70 72 65 76 65 ogin is to preve 0380: 6e 74 20 73 70 69 64 65 72 73 20 66 72 6f 6d 0a nt spiders from. 0390: 77 61 6c 6b 69 6e 67 20 74 68 65 20 65 6e 74 69 walking the enti 03a0: 72 65 20 77 65 62 73 69 74 65 2c 20 64 6f 77 6e re website, down 03b0: 6c 6f 61 64 69 6e 67 20 5a 49 50 20 61 72 63 68 loading ZIP arch 03c0: 69 76 65 73 0a 6f 66 20 65 76 65 72 79 20 68 69 ives.of every hi 03d0: 73 74 6f 72 69 63 61 6c 20 76 65 72 73 69 6f 6e storical version 03e0: 2c 20 61 6e 64 20 74 68 65 72 65 62 79 20 73 6f , and thereby so 03f0: 61 6b 69 6e 67 20 75 70 20 61 6c 6c 20 6f 75 72 aking up all our 0400: 20 62 61 6e 64 77 69 64 74 68 2e 3c 2f 70 3e 3c bandwidth.</p>< 0410: 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 43 6c 69 /li>..<li><p>Cli 0420: 63 6b 20 6f 6e 20 74 68 65 20 0a 3c 61 20 68 72 ck on the .<a hr 0430: 65 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e 66 ef="http://www.f 0440: 6f 73 73 69 6c 2d 73 63 6d 2e 6f 72 67 2f 66 6f ossil-scm.org/fo 0450: 73 73 69 6c 2f 74 69 6d 65 6c 69 6e 65 22 3e 54 ssil/timeline">T 0460: 69 6d 65 6c 69 6e 65 3c 2f 61 3e 20 6f 72 0a 3c imeline</a> or.< 0470: 61 20 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f 77 a href="http://w 0480: 77 77 2e 66 6f 73 73 69 6c 2d 73 63 6d 2e 6f 72 ww.fossil-scm.or 0490: 67 2f 66 6f 73 73 69 6c 2f 6c 65 61 76 65 73 22 g/fossil/leaves" 04a0: 3e 4c 65 61 76 65 73 3c 2f 61 3e 20 6c 69 6e 6b >Leaves</a> link 04b0: 20 61 74 0a 74 68 65 20 74 6f 70 20 6f 66 20 74 at.the top of t 04c0: 68 65 20 70 61 67 65 2e 3c 2f 70 3e 3c 2f 6c 69 he page.</p></li 04d0: 3e 0a 0a 3c 6c 69 3e 3c 70 3e 53 65 6c 65 63 74 >..<li><p>Select 04e0: 20 61 20 76 65 72 73 69 6f 6e 20 6f 66 20 6f 66 a version of of 04f0: 20 66 6f 73 73 69 6c 20 79 6f 75 20 77 61 6e 74 fossil you want 0500: 20 74 6f 20 64 6f 77 6e 6c 6f 61 64 2e 20 20 43 to download. C 0510: 6c 69 63 6b 20 6f 6e 20 69 74 73 0a 6c 69 6e 6b lick on its.link 0520: 2e 20 20 4e 6f 74 65 20 74 68 61 74 20 79 6f 75 . Note that you 0530: 20 6d 75 73 74 20 73 75 63 63 65 73 73 66 75 6c must successful 0540: 6c 79 20 6c 6f 67 20 69 6e 20 61 73 20 22 61 6e ly log in as "an 0550: 6f 6e 79 6d 6f 75 73 22 20 69 6e 20 73 74 65 70 onymous" in step 0560: 20 31 0a 61 62 6f 76 65 20 69 6e 20 6f 72 64 65 1.above in orde 0570: 72 20 74 6f 20 73 65 65 20 74 68 65 20 6c 69 6e r to see the lin 0580: 6b 20 74 6f 20 74 68 65 20 64 65 74 61 69 6c 65 k to the detaile 0590: 64 20 76 65 72 73 69 6f 6e 20 69 6e 66 6f 72 6d d version inform 05a0: 61 74 69 6f 6e 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a ation.</p></li>. 05b0: 0a 3c 6c 69 3e 3c 70 3e 4f 6e 20 74 68 65 20 76 .<li><p>On the v 05c0: 65 72 73 69 6f 6e 20 69 6e 66 6f 72 6d 61 74 69 ersion informati 05d0: 6f 6e 20 70 61 67 65 2c 20 63 6c 69 63 6b 20 6f on page, click o 05e0: 6e 20 74 68 65 0a 22 5a 69 70 20 41 72 63 68 69 n the."Zip Archi 05f0: 76 65 22 20 6c 69 6e 6b 2e 20 20 54 68 69 73 20 ve" link. This 0600: 6c 69 6e 6b 20 77 69 6c 6c 20 62 75 69 6c 64 20 link will build 0610: 61 20 5a 49 50 20 61 72 63 68 69 76 65 20 6f 66 a ZIP archive of 0620: 20 74 68 65 20 0a 63 6f 6d 70 6c 65 74 65 20 73 the .complete s 0630: 6f 75 72 63 65 20 63 6f 64 65 20 61 6e 64 20 64 ource code and d 0640: 6f 77 6e 6c 6f 61 64 20 69 74 20 74 6f 20 79 6f ownload it to yo 0650: 75 72 20 62 72 6f 77 73 65 72 2e 3c 2f 70 3e 3c ur browser.</p>< 0660: 2f 6c 69 3e 0a 3c 2f 6f 6c 3e 0a 0a 3c 68 32 3e /li>.</ol>..<h2> 0670: 32 2e 30 20 43 6f 6d 70 69 6c 69 6e 67 3c 2f 68 2.0 Compiling</h 0680: 32 3e 0a 0a 3c 70 3e 46 6f 6c 6c 6f 77 20 74 68 2>..<p>Follow th 0690: 65 73 65 20 73 74 65 70 73 20 74 6f 20 63 6f 6d ese steps to com 06a0: 70 69 6c 65 3a 3c 2f 70 3e 0a 0a 3c 6f 6c 3e 0a pile:</p>..<ol>. 06b0: 3c 6c 69 20 76 61 6c 75 65 3d 22 36 22 3e 0a 3c <li value="6">.< 06c0: 70 3e 43 72 65 61 74 65 20 61 20 64 69 72 65 63 p>Create a direc 06d0: 74 6f 72 79 20 74 6f 20 68 6f 6c 64 20 74 68 65 tory to hold the 06e0: 20 73 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 54 source code. T 06f0: 68 65 6e 20 75 6e 7a 69 70 20 74 68 65 0a 5a 49 hen unzip the.ZI 0700: 50 20 61 72 63 68 69 76 65 20 79 6f 75 20 64 6f P archive you do 0710: 77 6e 6c 6f 61 64 65 64 20 69 6e 74 6f 20 74 68 wnloaded into th 0720: 61 74 20 64 69 72 65 63 74 6f 72 79 2e 20 20 59 at directory. Y 0730: 6f 75 20 73 68 6f 75 6c 64 20 62 65 0a 69 6e 20 ou should be.in 0740: 74 68 65 20 74 6f 70 2d 6c 65 76 65 6c 20 66 6f the top-level fo 0750: 6c 64 65 72 20 6f 66 20 74 68 61 74 20 64 69 72 lder of that dir 0760: 65 63 74 6f 72 79 3c 2f 70 3e 3c 2f 6c 69 3e 0a ectory</p></li>. 0770: 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 28 4f 70 74 69 .<li><p><b>(Opti 0780: 6f 6e 61 6c 3a 29 3c 2f 62 3e 0a 45 64 69 74 20 onal:)</b>.Edit 0790: 74 68 65 20 4d 61 6b 65 66 69 6c 65 20 74 6f 20 the Makefile to 07a0: 73 65 74 20 69 74 20 75 70 20 6c 69 6b 65 20 79 set it up like y 07b0: 6f 75 20 77 61 6e 74 2e 20 20 59 6f 75 20 70 72 ou want. You pr 07c0: 6f 62 61 62 6c 79 20 64 6f 20 6e 6f 74 0a 6e 65 obably do not.ne 07d0: 65 64 20 74 6f 20 64 6f 20 61 6e 79 74 68 69 6e ed to do anythin 07e0: 67 2e 20 20 44 6f 20 6e 6f 74 20 62 65 20 69 6e g. Do not be in 07f0: 74 69 6d 69 64 61 74 65 64 3a 20 20 54 68 65 72 timidated: Ther 0800: 65 20 61 72 65 20 6f 6e 6c 79 20 35 0a 76 61 72 e are only 5.var 0810: 69 61 62 6c 65 73 20 69 6e 20 74 68 65 20 6d 61 iables in the ma 0820: 6b 65 66 69 6c 65 20 74 68 61 74 20 63 61 6e 20 kefile that can 0830: 62 65 20 63 68 61 6e 67 65 64 2e 20 20 54 68 65 be changed. The 0840: 20 77 68 6f 6c 65 20 4d 61 6b 65 66 69 6c 65 0a whole Makefile. 0850: 69 73 20 6f 6e 6c 79 20 61 20 66 65 77 20 64 6f is only a few do 0860: 7a 65 6e 20 6c 69 6e 65 73 20 6c 6f 6e 67 20 61 zen lines long a 0870: 6e 64 20 6d 6f 73 74 20 6f 66 20 74 68 6f 73 65 nd most of those 0880: 20 6c 69 6e 65 73 20 61 72 65 20 63 6f 6d 6d 65 lines are comme 0890: 6e 74 73 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 nts.</p>..<li><p 08a0: 3e 54 79 70 65 20 22 3c 62 3e 6d 61 6b 65 3c 2f >Type "<b>make</ 08b0: 62 3e 22 0a 3c 2f 6f 6c 3e 0a 0a 3c 68 32 3e 33 b>".</ol>..<h2>3 08c0: 2e 30 20 49 6e 73 74 61 6c 6c 69 6e 67 3c 2f 68 .0 Installing</h 08d0: 32 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 20 76 61 6c 2>..<ol>.<li val 08e0: 75 65 3d 22 39 22 3e 0a 3c 70 3e 54 68 65 20 66 ue="9">.<p>The f 08f0: 69 6e 69 73 68 65 64 20 62 69 6e 61 72 79 20 69 inished binary i 0900: 73 20 6e 61 6d 65 64 20 22 66 6f 73 73 69 6c 22 s named "fossil" 0910: 2e 20 20 50 75 74 20 74 68 69 73 20 62 69 6e 61 . Put this bina 0920: 72 79 20 69 6e 20 61 20 0a 64 69 72 65 63 74 6f ry in a .directo 0930: 72 79 20 74 68 61 74 20 69 73 20 73 6f 6d 65 77 ry that is somew 0940: 68 65 72 65 20 6f 6e 20 79 6f 75 72 20 50 41 54 here on your PAT 0950: 48 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 H environment va 0960: 72 69 61 62 6c 65 2e 0a 49 74 20 64 6f 65 73 20 riable..It does 0970: 6e 6f 74 20 6d 61 74 74 65 72 20 77 68 65 72 65 not matter where 0980: 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e 0a 3c 70 3e 3c .</p>..<li>.<p>< 0990: 62 3e 28 4f 70 74 69 6f 6e 61 6c 3a 29 3c 2f 62 b>(Optional:)</b 09a0: 3e 0a 54 6f 20 75 6e 69 6e 73 74 61 6c 6c 2c 20 >.To uninstall, 09b0: 6a 75 73 74 20 64 65 6c 65 74 65 20 74 68 65 20 just delete the 09c0: 62 69 6e 61 72 79 2e 3c 2f 70 3e 0a 3c 2f 6f 6c binary.</p>.</ol 09d0: 3e 0a >.