Artifact e65ee64c40422f068a890e13a2f129f787972dbc:
File www/build.wiki part of check-in [b79994adcb] - Trying to improve the look of the homepage. It is not at all clear that this check-in is any improvement, but it is at least an attempt.... by drh on 2009-08-24 17:45:45.
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 20 22 5b 64 65 74 61 69 6c 73 5d n the "[details] 05f0: 22 20 68 79 70 65 72 6c 69 6e 6b 0a 74 68 61 74 " hyperlink.that 0600: 20 61 70 70 65 61 72 73 20 72 69 67 68 74 20 61 appears right a 0610: 66 74 65 72 20 74 68 65 20 63 68 65 63 6b 2d 69 fter the check-i 0620: 6e 20 63 6f 6d 6d 65 6e 74 20 61 74 20 74 68 65 n comment at the 0630: 20 74 6f 70 20 6f 66 20 74 68 65 20 70 61 67 65 top of the page 0640: 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 46 69 .</p>..<li><p>Fi 0650: 6e 61 6c 6c 79 2c 20 63 6c 69 63 6b 20 6f 6e 20 nally, click on 0660: 74 68 65 0a 22 5a 69 70 20 41 72 63 68 69 76 65 the."Zip Archive 0670: 22 20 6c 69 6e 6b 2e 20 20 54 68 69 73 20 6c 69 " link. This li 0680: 6e 6b 20 77 69 6c 6c 20 62 75 69 6c 64 20 61 20 nk will build a 0690: 5a 49 50 20 61 72 63 68 69 76 65 20 6f 66 20 74 ZIP archive of t 06a0: 68 65 20 0a 63 6f 6d 70 6c 65 74 65 20 73 6f 75 he .complete sou 06b0: 72 63 65 20 63 6f 64 65 20 61 6e 64 20 64 6f 77 rce code and dow 06c0: 6e 6c 6f 61 64 20 69 74 20 74 6f 20 79 6f 75 72 nload it to your 06d0: 20 62 72 6f 77 73 65 72 2e 0a 0a 3c 62 6c 6f 63 browser...<bloc 06e0: 6b 71 75 6f 74 65 3e 3c 69 3e 0a 4e 6f 74 65 20 kquote><i>.Note 06f0: 74 6f 20 4d 61 63 20 75 73 65 72 73 3a 20 20 54 to Mac users: T 0700: 68 65 20 5a 49 50 20 61 72 63 68 69 76 65 20 63 he ZIP archive c 0710: 6f 6e 73 74 72 75 63 74 65 64 20 62 79 20 46 6f onstructed by Fo 0720: 73 73 69 6c 20 69 73 20 61 20 77 65 6c 6c 2d 66 ssil is a well-f 0730: 6f 72 6d 65 64 0a 5a 49 50 20 61 72 63 68 69 76 ormed.ZIP archiv 0740: 65 2e 20 20 48 6f 77 65 76 65 72 2c 20 74 68 65 e. However, the 0750: 20 75 6e 61 72 63 68 69 76 65 72 20 74 68 61 74 unarchiver that 0760: 20 69 73 20 62 75 69 6c 74 20 69 6e 74 6f 20 74 is built into t 0770: 68 65 20 4d 61 63 20 68 61 73 20 61 20 62 75 67 he Mac has a bug 0780: 0a 69 6e 20 74 68 61 74 20 69 74 20 64 6f 65 73 .in that it does 0790: 20 6e 6f 74 20 75 6e 64 65 72 73 74 61 6e 64 20 not understand 07a0: 61 6c 6c 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 all well-formed 07b0: 5a 49 50 20 61 72 63 68 69 76 65 73 2e 20 20 53 ZIP archives. S 07c0: 6f 20 79 6f 75 20 6d 61 79 0a 67 65 74 20 61 6e o you may.get an 07d0: 20 65 72 72 6f 72 20 77 68 65 6e 20 74 68 65 20 error when the 07e0: 4d 61 63 20 67 6f 65 73 20 74 6f 20 61 75 74 6f Mac goes to auto 07f0: 6d 61 74 69 63 61 6c 6c 79 20 65 78 74 72 61 63 matically extrac 0800: 74 20 74 68 65 20 64 6f 77 6e 6c 6f 61 64 65 64 t the downloaded 0810: 20 5a 49 50 0a 61 72 63 68 69 76 65 2e 20 20 57 ZIP.archive. W 0820: 65 20 61 72 65 20 73 74 69 6c 6c 20 74 72 79 69 e are still tryi 0830: 6e 67 20 74 6f 20 66 69 67 75 72 65 20 6f 75 74 ng to figure out 0840: 20 77 68 61 74 20 69 74 20 69 73 20 61 62 6f 75 what it is abou 0850: 74 20 46 6f 73 73 69 6c 2d 67 65 6e 65 72 61 74 t Fossil-generat 0860: 65 64 0a 5a 49 50 20 61 72 63 68 69 76 65 73 20 ed.ZIP archives 0870: 74 68 61 74 20 74 68 65 20 4d 61 63 20 64 6f 65 that the Mac doe 0880: 73 6e 27 74 20 6c 69 6b 65 2e 20 20 55 6e 74 69 sn't like. Unti 0890: 6c 20 77 65 20 64 6f 2c 20 0a 79 6f 75 72 20 77 l we do, .your w 08a0: 6f 72 6b 2d 61 72 6f 75 6e 64 20 69 73 20 74 6f ork-around is to 08b0: 20 6d 61 6e 75 61 6c 6c 79 20 65 78 74 72 61 63 manually extrac 08c0: 74 20 74 68 65 20 5a 49 50 20 61 72 63 68 69 76 t the ZIP archiv 08d0: 65 20 75 73 69 6e 67 20 74 68 65 0a 22 75 6e 7a e using the."unz 08e0: 69 70 22 20 63 6f 6d 6d 61 6e 64 20 66 72 6f 6d ip" command from 08f0: 20 61 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 a command-line 0900: 73 68 65 6c 6c 2e 0a 3c 2f 69 3e 3c 2f 62 6c 6f shell..</i></blo 0910: 63 6b 71 75 6f 74 65 3e 0a 3c 2f 6f 6c 3e 0a 0a ckquote>.</ol>.. 0920: 3c 68 32 3e 32 2e 30 20 43 6f 6d 70 69 6c 69 6e <h2>2.0 Compilin 0930: 67 3c 2f 68 32 3e 0a 0a 3c 70 3e 46 6f 6c 6c 6f g</h2>..<p>Follo 0940: 77 20 74 68 65 73 65 20 73 74 65 70 73 20 74 6f w these steps to 0950: 20 63 6f 6d 70 69 6c 65 3a 3c 2f 70 3e 0a 0a 3c compile:</p>..< 0960: 6f 6c 3e 0a 3c 6c 69 20 76 61 6c 75 65 3d 22 36 ol>.<li value="6 0970: 22 3e 0a 3c 70 3e 43 72 65 61 74 65 20 61 20 64 ">.<p>Create a d 0980: 69 72 65 63 74 6f 72 79 20 74 6f 20 68 6f 6c 64 irectory to hold 0990: 20 74 68 65 20 73 6f 75 72 63 65 20 63 6f 64 65 the source code 09a0: 2e 20 20 54 68 65 6e 20 75 6e 7a 69 70 20 74 68 . Then unzip th 09b0: 65 0a 5a 49 50 20 61 72 63 68 69 76 65 20 79 6f e.ZIP archive yo 09c0: 75 20 64 6f 77 6e 6c 6f 61 64 65 64 20 69 6e 74 u downloaded int 09d0: 6f 20 74 68 61 74 20 64 69 72 65 63 74 6f 72 79 o that directory 09e0: 2e 20 20 59 6f 75 20 73 68 6f 75 6c 64 20 62 65 . You should be 09f0: 0a 69 6e 20 74 68 65 20 74 6f 70 2d 6c 65 76 65 .in the top-leve 0a00: 6c 20 66 6f 6c 64 65 72 20 6f 66 20 74 68 61 74 l folder of that 0a10: 20 64 69 72 65 63 74 6f 72 79 3c 2f 70 3e 3c 2f directory</p></ 0a20: 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 28 li>..<li><p><b>( 0a30: 4f 70 74 69 6f 6e 61 6c 3a 29 3c 2f 62 3e 0a 45 Optional:)</b>.E 0a40: 64 69 74 20 74 68 65 20 4d 61 6b 65 66 69 6c 65 dit the Makefile 0a50: 20 74 6f 20 73 65 74 20 69 74 20 75 70 20 6c 69 to set it up li 0a60: 6b 65 20 79 6f 75 20 77 61 6e 74 2e 20 20 59 6f ke you want. Yo 0a70: 75 20 70 72 6f 62 61 62 6c 79 20 64 6f 20 6e 6f u probably do no 0a80: 74 0a 6e 65 65 64 20 74 6f 20 64 6f 20 61 6e 79 t.need to do any 0a90: 74 68 69 6e 67 2e 20 20 44 6f 20 6e 6f 74 20 62 thing. Do not b 0aa0: 65 20 69 6e 74 69 6d 69 64 61 74 65 64 3a 20 20 e intimidated: 0ab0: 54 68 65 72 65 20 61 72 65 20 6f 6e 6c 79 20 35 There are only 5 0ac0: 0a 76 61 72 69 61 62 6c 65 73 20 69 6e 20 74 68 .variables in th 0ad0: 65 20 6d 61 6b 65 66 69 6c 65 20 74 68 61 74 20 e makefile that 0ae0: 63 61 6e 20 62 65 20 63 68 61 6e 67 65 64 2e 20 can be changed. 0af0: 20 54 68 65 20 77 68 6f 6c 65 20 4d 61 6b 65 66 The whole Makef 0b00: 69 6c 65 0a 69 73 20 6f 6e 6c 79 20 61 20 66 65 ile.is only a fe 0b10: 77 20 64 6f 7a 65 6e 20 6c 69 6e 65 73 20 6c 6f w dozen lines lo 0b20: 6e 67 20 61 6e 64 20 6d 6f 73 74 20 6f 66 20 74 ng and most of t 0b30: 68 6f 73 65 20 6c 69 6e 65 73 20 61 72 65 20 63 hose lines are c 0b40: 6f 6d 6d 65 6e 74 73 2e 3c 2f 70 3e 0a 0a 3c 6c omments.</p>..<l 0b50: 69 3e 3c 70 3e 54 79 70 65 20 22 3c 62 3e 6d 61 i><p>Type "<b>ma 0b60: 6b 65 3c 2f 62 3e 22 0a 3c 2f 6f 6c 3e 0a 0a 3c ke</b>".</ol>..< 0b70: 68 32 3e 33 2e 30 20 49 6e 73 74 61 6c 6c 69 6e h2>3.0 Installin 0b80: 67 3c 2f 68 32 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 g</h2>..<ol>.<li 0b90: 20 76 61 6c 75 65 3d 22 39 22 3e 0a 3c 70 3e 54 value="9">.<p>T 0ba0: 68 65 20 66 69 6e 69 73 68 65 64 20 62 69 6e 61 he finished bina 0bb0: 72 79 20 69 73 20 6e 61 6d 65 64 20 22 66 6f 73 ry is named "fos 0bc0: 73 69 6c 22 2e 20 20 50 75 74 20 74 68 69 73 20 sil". Put this 0bd0: 62 69 6e 61 72 79 20 69 6e 20 61 20 0a 64 69 72 binary in a .dir 0be0: 65 63 74 6f 72 79 20 74 68 61 74 20 69 73 20 73 ectory that is s 0bf0: 6f 6d 65 77 68 65 72 65 20 6f 6e 20 79 6f 75 72 omewhere on your 0c00: 20 50 41 54 48 20 65 6e 76 69 72 6f 6e 6d 65 6e PATH environmen 0c10: 74 20 76 61 72 69 61 62 6c 65 2e 0a 49 74 20 64 t variable..It d 0c20: 6f 65 73 20 6e 6f 74 20 6d 61 74 74 65 72 20 77 oes not matter w 0c30: 68 65 72 65 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e 0a here.</p>..<li>. 0c40: 3c 70 3e 3c 62 3e 28 4f 70 74 69 6f 6e 61 6c 3a <p><b>(Optional: 0c50: 29 3c 2f 62 3e 0a 54 6f 20 75 6e 69 6e 73 74 61 )</b>.To uninsta 0c60: 6c 6c 2c 20 6a 75 73 74 20 64 65 6c 65 74 65 20 ll, just delete 0c70: 74 68 65 20 62 69 6e 61 72 79 2e 3c 2f 70 3e 0a the binary.</p>. 0c80: 3c 2f 6f 6c 3e 0a </ol>.