Fossil SCM

Update the "compiling and installing" instructions to describe how to build for MacOS 10.2.

drh 2012-12-11 16:53 trunk

Commit 44610be49d048f2b8c8317da5adc2d5c89f97e30

Parent fbe87e0cfb9fd0b…

3 files changed +29 -28 +1 -1 +2 -2

~ www/build.wiki ~ www/mkindex.tcl ~ www/permutedindex.wiki

M www/build.wiki

+29 -28

		--- www/build.wiki
		+++ www/build.wiki
		@@ -1,6 +1,6 @@
1		-<title>Building and Installing Fossil</title>
	1	+<title>Compiling and Installing Fossil</title>
2	2
3	3	<h2>0.0 Using A Pre-compiled Binary</h2>
4	4
5	5	<p>Released versions of fossil come with
6	6	<a href="http://www.fossil-scm.org/download.html">pre-compiled binaries and
		@@ -25,33 +25,29 @@
25	25
26	26	<p><hr>
27	27
28	28	<h2>1.0 Obtaining The Source Code</h2>
29	29
30		-<p>Fossil is self-hosting, so you can obtain a ZIP archive containing
31		-a snapshot of the <em>latest</em> version directly from fossil's own fossil
32		-repository. Additionally, source archives of <em>released</em> versions of
	30	+<p>Fossil is self-hosting, so you can obtain a ZIP archive or tarball
	31	+containing a snapshot of the <em>latest</em> version directly from
	32	+Fossil's own fossil repository. Additionally, source archives of
	33	+<em>released</em> versions of
33	34	fossil are available from the <a href="http://www.fossil-scm.org/download.html">downloads page</a>.
34	35	To obtain a development version of fossil, follow these steps:</p>
35	36
36	37	<ol>
37	38	<li><p>Point your web browser at
38	39	<a href="http://www.fossil-scm.org/">
39		-http://www.fossil-scm.org/</a>. Click on the "Login" menu button.</p></li>
40		-
41		-<li><p>Log in as anonymous. The password is shown on screen.
42		-The reason for requiring this login is to prevent spiders from
43		-walking the entire website, downloading ZIP archives
44		-of every historical version, and thereby soaking up all our bandwidth.</p></li>
	40	+http://www.fossil-scm.org/</a>.</p></li>
45	41
46	42	<li><p>Click on the
47	43	<a href="http://www.fossil-scm.org/fossil/timeline">Timeline</a>
48	44	link at the top of the page.</p></li>
49	45
50		-<li><p>Select a version of of fossil you want to download. Click on its
51		-link. Note that you must successfully log in as "anonymous" in step 1
52		-above in order to see the link to the detailed version information.</p></li>
	46	+<li><p>Select a version of of Fossil you want to download. The latest
	47	+version on the trunk branch is usually a good choice. Click on its
	48	+link.</p></li>
53	49
54	50	<li><p>Finally, click on one of the
55	51	"Zip Archive" or "Tarball" links, according to your preference.
56	52	These link will build a ZIP archive or a gzip-compressed tarball of the
57	53	complete source code and download it to your browser.
		@@ -59,11 +55,11 @@
59	55
60	56	<h2>2.0 Compiling</h2>
61	57
62	58	<ol>
63	59	<li value="6">
64		-<p>Unpack the ZIP or tarball you downloaded into that directory then
	60	+<p>Unpack the ZIP or tarball you downloaded then
65	61	<b>cd</b> into the directory created.</p></li>
66	62
67	63	<li><i>(Optional, unix only)</i>
68	64	Run <b>./configure</b> to construct a makefile.
69	65
		@@ -79,12 +75,12 @@
79	75	<li><p>
80	76	Other configuration options can be seen by running
81	77	<b>./configure --help</b>
82	78	</ol>
83	79
84		-<li><p>Run make to build the "fossil" or "fossil.exe" executable. The
85		-details depend on your platform and compiler.
	80	+<li><p>Run "<b>make</b>" to build the "fossil" or "fossil.exe" executable.
	81	+The details depend on your platform and compiler.
86	82
87	83	<ol type="a">
88	84	<li><p><i>Unix</i> → the configure-generated Makefile should work on
89	85	all unix and unix-like systems. Simply type "<b>make</b>".
90	86
		@@ -102,16 +98,10 @@
102	98	change to the "win/" subdirectory ("<b>cd win</b>") then run
103	99	"<b>nmake /f Makefile.msc</b>".
104	100	</ol>
105	101	</ol>
106	102
107		-<p>Note that Fossil requires the "zlib" compression library. This library
108		-is available by default on most unix systems, but it will typically have to
109		-be installed separately on windows systems. For windows builds, you may
110		-need to edit the makefile to tell it exactly where zlib is located on your
111		-system.</p>
112		-
113	103	<h2>3.0 Installing</h2>
114	104
115	105	<ol>
116	106	<li value="9">
117	107	<p>The finished binary is named "fossil" (or "fossil.exe" on windows).
		@@ -124,11 +114,22 @@
124	114	To uninstall, just delete the binary.</p>
125	115	</ol>
126	116
127	117	<h2>4.0 Additional Considerations</h2>
128	118
129		-</nowiki>
130		- * If the makefiles that come with Fossil do not work for
131		- you, or for some other reason you want to know how to build
132		- Fossil manually, then refer to the
133		- [./makefile.wiki \| Fossil Build Process] document which describes
134		- in detail what the makefiles do behind the scenes.
	119	+<ul>
	120	+<li><p>
	121	+ If the makefiles that come with Fossil do not work for
	122	+ you, or for some other reason you want to know how to build
	123	+ Fossil manually, then refer to the
	124	+ [./makefile.wiki \| Fossil Build Process] document which describes
	125	+ in detail what the makefiles do behind the scenes.
	126	+
	127	+<li><p>
	128	+ To build on older Macs (circa 2002, MacOS 10.2) edit the Makefile
	129	+ generated by configure to add the following lines:
	130	+ <blockquote><pre>
	131	+ TCC += -DSQLITE_WITHOUT_ZONEMALLOC
	132	+ TCC += -DWITHOUT_ICONV
	133	+ TCC += -Dsocketlen_t=int
	134	+ </pre></blockquote>
	135	+</ul>
135	136

	--- www/build.wiki
	+++ www/build.wiki
	@@ -1,6 +1,6 @@
1	<title>Building and Installing Fossil</title>
2
3	<h2>0.0 Using A Pre-compiled Binary</h2>
4
5	<p>Released versions of fossil come with
6	<a href="http://www.fossil-scm.org/download.html">pre-compiled binaries and
	@@ -25,33 +25,29 @@
25
26	<p><hr>
27
28	<h2>1.0 Obtaining The Source Code</h2>
29
30	<p>Fossil is self-hosting, so you can obtain a ZIP archive containing
31	a snapshot of the <em>latest</em> version directly from fossil's own fossil
32	repository. Additionally, source archives of <em>released</em> versions of

33	fossil are available from the <a href="http://www.fossil-scm.org/download.html">downloads page</a>.
34	To obtain a development version of fossil, follow these steps:</p>
35
36	<ol>
37	<li><p>Point your web browser at
38	<a href="http://www.fossil-scm.org/">
39	http://www.fossil-scm.org/</a>. Click on the "Login" menu button.</p></li>
40
41	<li><p>Log in as anonymous. The password is shown on screen.
42	The reason for requiring this login is to prevent spiders from
43	walking the entire website, downloading ZIP archives
44	of every historical version, and thereby soaking up all our bandwidth.</p></li>
45
46	<li><p>Click on the
47	<a href="http://www.fossil-scm.org/fossil/timeline">Timeline</a>
48	link at the top of the page.</p></li>
49
50	<li><p>Select a version of of fossil you want to download. Click on its
51	link. Note that you must successfully log in as "anonymous" in step 1
52	above in order to see the link to the detailed version information.</p></li>
53
54	<li><p>Finally, click on one of the
55	"Zip Archive" or "Tarball" links, according to your preference.
56	These link will build a ZIP archive or a gzip-compressed tarball of the
57	complete source code and download it to your browser.
	@@ -59,11 +55,11 @@
59
60	<h2>2.0 Compiling</h2>
61
62	<ol>
63	<li value="6">
64	<p>Unpack the ZIP or tarball you downloaded into that directory then
65	<b>cd</b> into the directory created.</p></li>
66
67	<li><i>(Optional, unix only)</i>
68	Run <b>./configure</b> to construct a makefile.
69
	@@ -79,12 +75,12 @@
79	<li><p>
80	Other configuration options can be seen by running
81	<b>./configure --help</b>
82	</ol>
83
84	<li><p>Run make to build the "fossil" or "fossil.exe" executable. The
85	details depend on your platform and compiler.
86
87	<ol type="a">
88	<li><p><i>Unix</i> → the configure-generated Makefile should work on
89	all unix and unix-like systems. Simply type "<b>make</b>".
90
	@@ -102,16 +98,10 @@
102	change to the "win/" subdirectory ("<b>cd win</b>") then run
103	"<b>nmake /f Makefile.msc</b>".
104	</ol>
105	</ol>
106
107	<p>Note that Fossil requires the "zlib" compression library. This library
108	is available by default on most unix systems, but it will typically have to
109	be installed separately on windows systems. For windows builds, you may
110	need to edit the makefile to tell it exactly where zlib is located on your
111	system.</p>
112
113	<h2>3.0 Installing</h2>
114
115	<ol>
116	<li value="9">
117	<p>The finished binary is named "fossil" (or "fossil.exe" on windows).
	@@ -124,11 +114,22 @@
124	To uninstall, just delete the binary.</p>
125	</ol>
126
127	<h2>4.0 Additional Considerations</h2>
128
129	</nowiki>
130	* If the makefiles that come with Fossil do not work for
131	you, or for some other reason you want to know how to build
132	Fossil manually, then refer to the
133	[./makefile.wiki \| Fossil Build Process] document which describes
134	in detail what the makefiles do behind the scenes.











135

	--- www/build.wiki
	+++ www/build.wiki
	@@ -1,6 +1,6 @@
1	<title>Compiling and Installing Fossil</title>
2
3	<h2>0.0 Using A Pre-compiled Binary</h2>
4
5	<p>Released versions of fossil come with
6	<a href="http://www.fossil-scm.org/download.html">pre-compiled binaries and
	@@ -25,33 +25,29 @@
25
26	<p><hr>
27
28	<h2>1.0 Obtaining The Source Code</h2>
29
30	<p>Fossil is self-hosting, so you can obtain a ZIP archive or tarball
31	containing a snapshot of the <em>latest</em> version directly from
32	Fossil's own fossil repository. Additionally, source archives of
33	<em>released</em> versions of
34	fossil are available from the <a href="http://www.fossil-scm.org/download.html">downloads page</a>.
35	To obtain a development version of fossil, follow these steps:</p>
36
37	<ol>
38	<li><p>Point your web browser at
39	<a href="http://www.fossil-scm.org/">
40	http://www.fossil-scm.org/</a>.</p></li>





41
42	<li><p>Click on the
43	<a href="http://www.fossil-scm.org/fossil/timeline">Timeline</a>
44	link at the top of the page.</p></li>
45
46	<li><p>Select a version of of Fossil you want to download. The latest
47	version on the trunk branch is usually a good choice. Click on its
48	link.</p></li>
49
50	<li><p>Finally, click on one of the
51	"Zip Archive" or "Tarball" links, according to your preference.
52	These link will build a ZIP archive or a gzip-compressed tarball of the
53	complete source code and download it to your browser.
	@@ -59,11 +55,11 @@
55
56	<h2>2.0 Compiling</h2>
57
58	<ol>
59	<li value="6">
60	<p>Unpack the ZIP or tarball you downloaded then
61	<b>cd</b> into the directory created.</p></li>
62
63	<li><i>(Optional, unix only)</i>
64	Run <b>./configure</b> to construct a makefile.
65
	@@ -79,12 +75,12 @@
75	<li><p>
76	Other configuration options can be seen by running
77	<b>./configure --help</b>
78	</ol>
79
80	<li><p>Run "<b>make</b>" to build the "fossil" or "fossil.exe" executable.
81	The details depend on your platform and compiler.
82
83	<ol type="a">
84	<li><p><i>Unix</i> → the configure-generated Makefile should work on
85	all unix and unix-like systems. Simply type "<b>make</b>".
86
	@@ -102,16 +98,10 @@
98	change to the "win/" subdirectory ("<b>cd win</b>") then run
99	"<b>nmake /f Makefile.msc</b>".
100	</ol>
101	</ol>
102






103	<h2>3.0 Installing</h2>
104
105	<ol>
106	<li value="9">
107	<p>The finished binary is named "fossil" (or "fossil.exe" on windows).
	@@ -124,11 +114,22 @@
114	To uninstall, just delete the binary.</p>
115	</ol>
116
117	<h2>4.0 Additional Considerations</h2>
118
119	<ul>
120	<li><p>
121	If the makefiles that come with Fossil do not work for
122	you, or for some other reason you want to know how to build
123	Fossil manually, then refer to the
124	[./makefile.wiki \| Fossil Build Process] document which describes
125	in detail what the makefiles do behind the scenes.
126
127	<li><p>
128	To build on older Macs (circa 2002, MacOS 10.2) edit the Makefile
129	generated by configure to add the following lines:
130	<blockquote><pre>
131	TCC += -DSQLITE_WITHOUT_ZONEMALLOC
132	TCC += -DWITHOUT_ICONV
133	TCC += -Dsocketlen_t=int
134	</pre></blockquote>
135	</ul>
136

M www/mkindex.tcl

+1 -1

		--- www/mkindex.tcl
		+++ www/mkindex.tcl
		@@ -7,11 +7,11 @@
7	7	#
8	8
9	9	set doclist {
10	10	bugtheory.wiki {Bug Tracking In Fossil}
11	11	branching.wiki {Branching, Forking, Merging, and Tagging}
12		- build.wiki {Building and Installing Fossil}
	12	+ build.wiki {Compiling and Installing Fossil}
13	13	checkin_names.wiki {Checkin And Version Names}
14	14	checkin.wiki {Check-in Checklist}
15	15	changes.wiki {Fossil Changelog}
16	16	copyright-release.html {Contributor License Agreement}
17	17	concepts.wiki {Fossil Core Concepts}
18	18

	--- www/mkindex.tcl
	+++ www/mkindex.tcl
	@@ -7,11 +7,11 @@
7	#
8
9	set doclist {
10	bugtheory.wiki {Bug Tracking In Fossil}
11	branching.wiki {Branching, Forking, Merging, and Tagging}
12	build.wiki {Building and Installing Fossil}
13	checkin_names.wiki {Checkin And Version Names}
14	checkin.wiki {Check-in Checklist}
15	changes.wiki {Fossil Changelog}
16	copyright-release.html {Contributor License Agreement}
17	concepts.wiki {Fossil Core Concepts}
18

	--- www/mkindex.tcl
	+++ www/mkindex.tcl
	@@ -7,11 +7,11 @@
7	#
8
9	set doclist {
10	bugtheory.wiki {Bug Tracking In Fossil}
11	branching.wiki {Branching, Forking, Merging, and Tagging}
12	build.wiki {Compiling and Installing Fossil}
13	checkin_names.wiki {Checkin And Version Names}
14	checkin.wiki {Check-in Checklist}
15	changes.wiki {Fossil Changelog}
16	copyright-release.html {Contributor License Agreement}
17	concepts.wiki {Fossil Core Concepts}
18

M www/permutedindex.wiki

+2 -2

		--- www/permutedindex.wiki
		+++ www/permutedindex.wiki
		@@ -19,20 +19,20 @@
19	19	<li><a href="password.wiki">Authentication — Password Management And</a></li>
20	20	<li><a href="private.wiki">Branches — Creating, Syncing, and Deleting Private</a></li>
21	21	<li><a href="branching.wiki">Branching, Forking, Merging, and Tagging</a></li>
22	22	<li><a href="bugtheory.wiki">Bug Tracking In Fossil</a></li>
23	23	<li><a href="makefile.wiki">Build Process — The Fossil</a></li>
24		-<li><a href="build.wiki">Building and Installing Fossil</a></li>
25	24	<li><a href="changes.wiki">Changelog — Fossil</a></li>
26	25	<li><a href="checkin.wiki">Check-in Checklist</a></li>
27	26	<li><a href="checkin_names.wiki">Checkin And Version Names</a></li>
28	27	<li><a href="checkin.wiki">Checklist — Check-in</a></li>
29	28	<li><a href="../test/release-checklist.wiki">Checklist — Pre-Release Testing</a></li>
30	29	<li><a href="foss-cklist.wiki">Checklist For Successful Open-Source Projects</a></li>
31	30	<li><a href="selfcheck.wiki">Checks — Fossil Repository Integrity Self</a></li>
32	31	<li><a href="contribute.wiki">Code or Documentation To The Fossil Project — Contributing</a></li>
33	32	<li><a href="style.wiki">Code Style Guidelines — Source</a></li>
	33	+<li><a href="build.wiki">Compiling and Installing Fossil</a></li>
34	34	<li><a href="concepts.wiki">Concepts — Fossil Core</a></li>
35	35	<li><a href="server.wiki">Configure A Fossil Server — How To</a></li>
36	36	<li><a href="shunning.wiki">Content From Fossil — Shunning: Deleting</a></li>
37	37	<li><a href="contribute.wiki">Contributing Code or Documentation To The Fossil Project</a></li>
38	38	<li><a href="copyright-release.html">Contributor License Agreement</a></li>
		@@ -84,11 +84,11 @@
84	84	<li><a href="selfhost.wiki">Hosting Repositories — Fossil Self</a></li>
85	85	<li><a href="server.wiki">How To Configure A Fossil Server</a></li>
86	86	<li><a href="newrepo.wiki">How To Create A New Fossil Repository</a></li>
87	87	<li><a href="tech_overview.wiki">Implementation Of Fossil — A Technical Overview Of The Design And</a></li>
88	88	<li><a href="inout.wiki">Import And Export To And From Git</a></li>
89		-<li><a href="build.wiki">Installing Fossil — Building and</a></li>
	89	+<li><a href="build.wiki">Installing Fossil — Compiling and</a></li>
90	90	<li><a href="selfcheck.wiki">Integrity Self Checks — Fossil Repository</a></li>
91	91	<li><a href="webui.wiki">Interface — The Fossil Web</a></li>
92	92	<li><a href="copyright-release.html">License Agreement — Contributor</a></li>
93	93	<li><a href="password.wiki">Management And Authentication — Password</a></li>
94	94	<li><a href="branching.wiki">Merging, and Tagging — Branching, Forking,</a></li>
95	95

	--- www/permutedindex.wiki
	+++ www/permutedindex.wiki
	@@ -19,20 +19,20 @@
19	<li><a href="password.wiki">Authentication — Password Management And</a></li>
20	<li><a href="private.wiki">Branches — Creating, Syncing, and Deleting Private</a></li>
21	<li><a href="branching.wiki">Branching, Forking, Merging, and Tagging</a></li>
22	<li><a href="bugtheory.wiki">Bug Tracking In Fossil</a></li>
23	<li><a href="makefile.wiki">Build Process — The Fossil</a></li>
24	<li><a href="build.wiki">Building and Installing Fossil</a></li>
25	<li><a href="changes.wiki">Changelog — Fossil</a></li>
26	<li><a href="checkin.wiki">Check-in Checklist</a></li>
27	<li><a href="checkin_names.wiki">Checkin And Version Names</a></li>
28	<li><a href="checkin.wiki">Checklist — Check-in</a></li>
29	<li><a href="../test/release-checklist.wiki">Checklist — Pre-Release Testing</a></li>
30	<li><a href="foss-cklist.wiki">Checklist For Successful Open-Source Projects</a></li>
31	<li><a href="selfcheck.wiki">Checks — Fossil Repository Integrity Self</a></li>
32	<li><a href="contribute.wiki">Code or Documentation To The Fossil Project — Contributing</a></li>
33	<li><a href="style.wiki">Code Style Guidelines — Source</a></li>

34	<li><a href="concepts.wiki">Concepts — Fossil Core</a></li>
35	<li><a href="server.wiki">Configure A Fossil Server — How To</a></li>
36	<li><a href="shunning.wiki">Content From Fossil — Shunning: Deleting</a></li>
37	<li><a href="contribute.wiki">Contributing Code or Documentation To The Fossil Project</a></li>
38	<li><a href="copyright-release.html">Contributor License Agreement</a></li>
	@@ -84,11 +84,11 @@
84	<li><a href="selfhost.wiki">Hosting Repositories — Fossil Self</a></li>
85	<li><a href="server.wiki">How To Configure A Fossil Server</a></li>
86	<li><a href="newrepo.wiki">How To Create A New Fossil Repository</a></li>
87	<li><a href="tech_overview.wiki">Implementation Of Fossil — A Technical Overview Of The Design And</a></li>
88	<li><a href="inout.wiki">Import And Export To And From Git</a></li>
89	<li><a href="build.wiki">Installing Fossil — Building and</a></li>
90	<li><a href="selfcheck.wiki">Integrity Self Checks — Fossil Repository</a></li>
91	<li><a href="webui.wiki">Interface — The Fossil Web</a></li>
92	<li><a href="copyright-release.html">License Agreement — Contributor</a></li>
93	<li><a href="password.wiki">Management And Authentication — Password</a></li>
94	<li><a href="branching.wiki">Merging, and Tagging — Branching, Forking,</a></li>
95

	--- www/permutedindex.wiki
	+++ www/permutedindex.wiki
	@@ -19,20 +19,20 @@
19	<li><a href="password.wiki">Authentication — Password Management And</a></li>
20	<li><a href="private.wiki">Branches — Creating, Syncing, and Deleting Private</a></li>
21	<li><a href="branching.wiki">Branching, Forking, Merging, and Tagging</a></li>
22	<li><a href="bugtheory.wiki">Bug Tracking In Fossil</a></li>
23	<li><a href="makefile.wiki">Build Process — The Fossil</a></li>

24	<li><a href="changes.wiki">Changelog — Fossil</a></li>
25	<li><a href="checkin.wiki">Check-in Checklist</a></li>
26	<li><a href="checkin_names.wiki">Checkin And Version Names</a></li>
27	<li><a href="checkin.wiki">Checklist — Check-in</a></li>
28	<li><a href="../test/release-checklist.wiki">Checklist — Pre-Release Testing</a></li>
29	<li><a href="foss-cklist.wiki">Checklist For Successful Open-Source Projects</a></li>
30	<li><a href="selfcheck.wiki">Checks — Fossil Repository Integrity Self</a></li>
31	<li><a href="contribute.wiki">Code or Documentation To The Fossil Project — Contributing</a></li>
32	<li><a href="style.wiki">Code Style Guidelines — Source</a></li>
33	<li><a href="build.wiki">Compiling and Installing Fossil</a></li>
34	<li><a href="concepts.wiki">Concepts — Fossil Core</a></li>
35	<li><a href="server.wiki">Configure A Fossil Server — How To</a></li>
36	<li><a href="shunning.wiki">Content From Fossil — Shunning: Deleting</a></li>
37	<li><a href="contribute.wiki">Contributing Code or Documentation To The Fossil Project</a></li>
38	<li><a href="copyright-release.html">Contributor License Agreement</a></li>
	@@ -84,11 +84,11 @@
84	<li><a href="selfhost.wiki">Hosting Repositories — Fossil Self</a></li>
85	<li><a href="server.wiki">How To Configure A Fossil Server</a></li>
86	<li><a href="newrepo.wiki">How To Create A New Fossil Repository</a></li>
87	<li><a href="tech_overview.wiki">Implementation Of Fossil — A Technical Overview Of The Design And</a></li>
88	<li><a href="inout.wiki">Import And Export To And From Git</a></li>
89	<li><a href="build.wiki">Installing Fossil — Compiling and</a></li>
90	<li><a href="selfcheck.wiki">Integrity Self Checks — Fossil Repository</a></li>
91	<li><a href="webui.wiki">Interface — The Fossil Web</a></li>
92	<li><a href="copyright-release.html">License Agreement — Contributor</a></li>
93	<li><a href="password.wiki">Management And Authentication — Password</a></li>
94	<li><a href="branching.wiki">Merging, and Tagging — Branching, Forking,</a></li>
95

Fossil SCM

Keyboard Shortcuts