Fossil SCM

Add documentation on how the build process works.

drh 2010-12-30 14:03 trunk
Commit c429b524654c59393e67f6d5965dbf714e4d5657
--- a/www/makefile.wiki
+++ b/www/makefile.wiki
@@ -0,0 +1,105 @@
1
+<title>The Fossil Build Process</title>
2
+
3
+<h1>1.0 Introduction</h1>
4
+
5
+The build process for Fossil is tricky in that the source code
6
+needs to be p.tkwo FTS4 ithree differentipl 4. mkbuiltin5. sqlite3.c
7
+ 6. sqlite3.hprecompiled
8
+binary gram that analyzes the printf-style format
9
+strings used in SQLite for errors. This sexisting
10
+makefiles. d in this
11
+list for completeness and because the makefiles will invoke it:
12
+
13
+ 4an run"builtin_dad it:
14
+
15
+ 4an run"builtin_datadefinitions of byte arrays for
16
+various text and binary files that are built into the Fossil execuby the "mkbuiltin" in" executable whicsrc/ the
17
+4. sqlite3.c
18
+ 5. sqlite3.h
19
+ 67. th.c
20
+ 890. [../1ecutable which
21
+is built from the "mkbuiltin.c".so FTS4 is
22
+ is
23
+<title>Th
24
+are merely
25
+ disabled
26
+
27
+ in the
28
+2has been modified slightly from the standard
29
+shell.c file in the SQLite release. Se of Fossil to see the changesess</title>
30
+
31
+<h1>1.0 Introduction</h1>
32
+
33
+The build process for Fossil is tricky in that the source code
34
+needs to be p.tkwo FTS4 ithree differentipl 4. mkbuiltin5. sqlite3.c
35
+ 6. sqlite3.h
36
+ 78. th.c
37
+ 910. mkversion.c
38
+
39
+TThere is a static checker program that analyzes the printf-style format
40
+strings used in SQLite for errors. This static checker is not required
41
+to build Fossil (it is only a validation step) but it is included in this
42
+list for completeness and because the makefiles will invoke it:
43
+
44
+ 4an run"builtin_datadefinitions of byte arrays for
45
+various text and binary files that are built into the Fossil execuby the "mkbuiltin" executable which
46
+is built from the "mkbuiltin.c".so FTS4 is
47
+ is
48
+<title>Th
49
+are merely
50
+ disabled
51
+
52
+ in the
53
+4. sqlite3.c
54
+ 5. sqlite3.h
55
+ 67. th.c
56
+ 890. [../1ecutable which
57
+is built from the "mkbuiltin.c".so FTS4 is
58
+ is
59
+<title>Th
60
+are merely
61
+ disabled
62
+
63
+ in t
64
+2<title>The Fossil Build Process</title>
65
+
66
+<h1>1.0 Introduction</h1>
67
+
68
+The build process for Fosfor errors. This 910. mkversion.c
69
+
70
+TThere is a static checker program that analyzes the p9ogram that analyzes the printf-style format
71
+strings used in SQLite for errors. This static checker is not required
72
+to build Fossil (it is only a validation step) but it is included in this
73
+list0in.c".so FTS4 is
74
+ is
75
+<title>Th
76
+are merely
77
+ disabled
78
+
79
+ in the
80
+4. sqlite3.c
81
+ 5. sqlite3.h
82
+ 67. th.c
83
+ 890. [../1ecutable which
84
+is built from the "mkbuiltin.c".so FTS4 is
85
+ is
86
+<title>Th
87
+are merely
88
+ disabled
89
+
90
+ in the
91
+2has been modified slightly from the standard
92
+shell.c file in the SQLite release. Se of Fossil to see the changesess</title>
93
+
94
+<1e build process for Fossil is tricky in that the source code
95
+needs to be p.tkwo FTS4 ithree differentipl 4. mkbuiltin5. sqlite3.c
96
+ 6. sqlite3.h
97
+ 78. th.c
98
+ 910. mkversion.c
99
+
100
+TThere is a static checker program that analyzes the printf-style format
101
+strings used in SQLite for errors. This static checker is not required
102
+to build Fossil (it is only a validation step) but it is included in this
103
+list for completeness and because the makefiles will invoke it:
104
+
105
+ 4an run"builtin_datadefhas to
--- a/www/makefile.wiki
+++ b/www/makefile.wiki
@@ -0,0 +1,105 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
--- a/www/makefile.wiki
+++ b/www/makefile.wiki
@@ -0,0 +1,105 @@
1 <title>The Fossil Build Process</title>
2
3 <h1>1.0 Introduction</h1>
4
5 The build process for Fossil is tricky in that the source code
6 needs to be p.tkwo FTS4 ithree differentipl 4. mkbuiltin5. sqlite3.c
7 6. sqlite3.hprecompiled
8 binary gram that analyzes the printf-style format
9 strings used in SQLite for errors. This sexisting
10 makefiles. d in this
11 list for completeness and because the makefiles will invoke it:
12
13 4an run"builtin_dad it:
14
15 4an run"builtin_datadefinitions of byte arrays for
16 various text and binary files that are built into the Fossil execuby the "mkbuiltin" in" executable whicsrc/ the
17 4. sqlite3.c
18 5. sqlite3.h
19 67. th.c
20 890. [../1ecutable which
21 is built from the "mkbuiltin.c".so FTS4 is
22 is
23 <title>Th
24 are merely
25 disabled
26
27 in the
28 2has been modified slightly from the standard
29 shell.c file in the SQLite release. Se of Fossil to see the changesess</title>
30
31 <h1>1.0 Introduction</h1>
32
33 The build process for Fossil is tricky in that the source code
34 needs to be p.tkwo FTS4 ithree differentipl 4. mkbuiltin5. sqlite3.c
35 6. sqlite3.h
36 78. th.c
37 910. mkversion.c
38
39 TThere is a static checker program that analyzes the printf-style format
40 strings used in SQLite for errors. This static checker is not required
41 to build Fossil (it is only a validation step) but it is included in this
42 list for completeness and because the makefiles will invoke it:
43
44 4an run"builtin_datadefinitions of byte arrays for
45 various text and binary files that are built into the Fossil execuby the "mkbuiltin" executable which
46 is built from the "mkbuiltin.c".so FTS4 is
47 is
48 <title>Th
49 are merely
50 disabled
51
52 in the
53 4. sqlite3.c
54 5. sqlite3.h
55 67. th.c
56 890. [../1ecutable which
57 is built from the "mkbuiltin.c".so FTS4 is
58 is
59 <title>Th
60 are merely
61 disabled
62
63 in t
64 2<title>The Fossil Build Process</title>
65
66 <h1>1.0 Introduction</h1>
67
68 The build process for Fosfor errors. This 910. mkversion.c
69
70 TThere is a static checker program that analyzes the p9ogram that analyzes the printf-style format
71 strings used in SQLite for errors. This static checker is not required
72 to build Fossil (it is only a validation step) but it is included in this
73 list0in.c".so FTS4 is
74 is
75 <title>Th
76 are merely
77 disabled
78
79 in the
80 4. sqlite3.c
81 5. sqlite3.h
82 67. th.c
83 890. [../1ecutable which
84 is built from the "mkbuiltin.c".so FTS4 is
85 is
86 <title>Th
87 are merely
88 disabled
89
90 in the
91 2has been modified slightly from the standard
92 shell.c file in the SQLite release. Se of Fossil to see the changesess</title>
93
94 <1e build process for Fossil is tricky in that the source code
95 needs to be p.tkwo FTS4 ithree differentipl 4. mkbuiltin5. sqlite3.c
96 6. sqlite3.h
97 78. th.c
98 910. mkversion.c
99
100 TThere is a static checker program that analyzes the printf-style format
101 strings used in SQLite for errors. This static checker is not required
102 to build Fossil (it is only a validation step) but it is included in this
103 list for completeness and because the makefiles will invoke it:
104
105 4an run"builtin_datadefhas to
--- www/mkindex.tcl
+++ www/mkindex.tcl
@@ -20,10 +20,11 @@
2020
faq.wiki {Frequently Asked Questions}
2121
fileformat.wiki {Fossil File Format}
2222
fossil-v-git.wiki {Fossil Versus Git}
2323
index.wiki {Home Page}
2424
inout.wiki {Import And Export To And From Git}
25
+ makefile.wiki {The Fossil Build Process}
2526
password.wiki {Password Management And Authentication}
2627
pop.wiki {Principles Of Operations}
2728
qandc.wiki {Questions And Criticisms}
2829
quickstart.wiki {Fossil Quick Start Guide}
2930
quotes.wiki
3031
--- www/mkindex.tcl
+++ www/mkindex.tcl
@@ -20,10 +20,11 @@
20 faq.wiki {Frequently Asked Questions}
21 fileformat.wiki {Fossil File Format}
22 fossil-v-git.wiki {Fossil Versus Git}
23 index.wiki {Home Page}
24 inout.wiki {Import And Export To And From Git}
 
25 password.wiki {Password Management And Authentication}
26 pop.wiki {Principles Of Operations}
27 qandc.wiki {Questions And Criticisms}
28 quickstart.wiki {Fossil Quick Start Guide}
29 quotes.wiki
30
--- www/mkindex.tcl
+++ www/mkindex.tcl
@@ -20,10 +20,11 @@
20 faq.wiki {Frequently Asked Questions}
21 fileformat.wiki {Fossil File Format}
22 fossil-v-git.wiki {Fossil Versus Git}
23 index.wiki {Home Page}
24 inout.wiki {Import And Export To And From Git}
25 makefile.wiki {The Fossil Build Process}
26 password.wiki {Password Management And Authentication}
27 pop.wiki {Principles Of Operations}
28 qandc.wiki {Questions And Criticisms}
29 quickstart.wiki {Fossil Quick Start Guide}
30 quotes.wiki
31
--- www/permutedindex.wiki
+++ www/permutedindex.wiki
@@ -5,10 +5,11 @@
55
<li><a href="delta_encoder_algorithm.wiki">Algorithm &#151; Fossil Delta Encoding</a></li>
66
<li><a href="faq.wiki">Asked Questions &#151; Frequently</a></li>
77
<li><a href="password.wiki">Authentication &#151; Password Management And</a></li>
88
<li><a href="branching.wiki">Branching, Forking, Merging, and Tagging</a></li>
99
<li><a href="bugtheory.wiki">Bug Tracking In Fossil</a></li>
10
+<li><a href="makefile.wiki">Build Process &#151; The Fossil</a></li>
1011
<li><a href="build.wiki">Building and Installing Fossil</a></li>
1112
<li><a href="checkin_names.wiki">Checkin And Version Names</a></li>
1213
<li><a href="selfcheck.wiki">Checks &#151; Fossil Repository Integrity Self</a></li>
1314
<li><a href="concepts.wiki">Concepts &#151; Fossil Core</a></li>
1415
<li><a href="server.wiki">Configure A Fossil Server &#151; How To</a></li>
@@ -61,10 +62,11 @@
6162
<li><a href="index.wiki">Page &#151; Home</a></li>
6263
<li><a href="password.wiki">Password Management And Authentication</a></li>
6364
<li><a href="quotes.wiki">People Are Saying About Fossil, Git, and DVCSes in General &#151; Quotes: What</a></li>
6465
<li><a href="stats.wiki">Performance Statistics</a></li>
6566
<li><a href="pop.wiki">Principles Of Operations</a></li>
67
+<li><a href="makefile.wiki">Process &#151; The Fossil Build</a></li>
6668
<li><a href="embeddeddoc.wiki">Project Documentation &#151; Embedded</a></li>
6769
<li><a href="sync.wiki">Protocol &#151; The Fossil Sync</a></li>
6870
<li><a href="faq.wiki">Questions &#151; Frequently Asked</a></li>
6971
<li><a href="qandc.wiki">Questions And Criticisms</a></li>
7072
<li><a href="quickstart.wiki">Quick Start Guide &#151; Fossil</a></li>
@@ -78,10 +80,11 @@
7880
<li><a href="quickstart.wiki">Start Guide &#151; Fossil Quick</a></li>
7981
<li><a href="stats.wiki">Statistics &#151; Performance</a></li>
8082
<li><a href="sync.wiki">Sync Protocol &#151; The Fossil</a></li>
8183
<li><a href="custom_ticket.wiki">System &#151; Customizing The Ticket</a></li>
8284
<li><a href="branching.wiki">Tagging &#151; Branching, Forking, Merging, and</a></li>
85
+<li><a href="makefile.wiki">The Fossil Build Process</a></li>
8386
<li><a href="sync.wiki">The Fossil Sync Protocol</a></li>
8487
<li><a href="webui.wiki">The Fossil Web Interface</a></li>
8588
<li><a href="theory1.wiki">Thoughts On The Design Of The Fossil DVCS</a></li>
8689
<li><a href="custom_ticket.wiki">Ticket System &#151; Customizing The</a></li>
8790
<li><a href="bugtheory.wiki">Tracking In Fossil &#151; Bug</a></li>
8891
--- www/permutedindex.wiki
+++ www/permutedindex.wiki
@@ -5,10 +5,11 @@
5 <li><a href="delta_encoder_algorithm.wiki">Algorithm &#151; Fossil Delta Encoding</a></li>
6 <li><a href="faq.wiki">Asked Questions &#151; Frequently</a></li>
7 <li><a href="password.wiki">Authentication &#151; Password Management And</a></li>
8 <li><a href="branching.wiki">Branching, Forking, Merging, and Tagging</a></li>
9 <li><a href="bugtheory.wiki">Bug Tracking In Fossil</a></li>
 
10 <li><a href="build.wiki">Building and Installing Fossil</a></li>
11 <li><a href="checkin_names.wiki">Checkin And Version Names</a></li>
12 <li><a href="selfcheck.wiki">Checks &#151; Fossil Repository Integrity Self</a></li>
13 <li><a href="concepts.wiki">Concepts &#151; Fossil Core</a></li>
14 <li><a href="server.wiki">Configure A Fossil Server &#151; How To</a></li>
@@ -61,10 +62,11 @@
61 <li><a href="index.wiki">Page &#151; Home</a></li>
62 <li><a href="password.wiki">Password Management And Authentication</a></li>
63 <li><a href="quotes.wiki">People Are Saying About Fossil, Git, and DVCSes in General &#151; Quotes: What</a></li>
64 <li><a href="stats.wiki">Performance Statistics</a></li>
65 <li><a href="pop.wiki">Principles Of Operations</a></li>
 
66 <li><a href="embeddeddoc.wiki">Project Documentation &#151; Embedded</a></li>
67 <li><a href="sync.wiki">Protocol &#151; The Fossil Sync</a></li>
68 <li><a href="faq.wiki">Questions &#151; Frequently Asked</a></li>
69 <li><a href="qandc.wiki">Questions And Criticisms</a></li>
70 <li><a href="quickstart.wiki">Quick Start Guide &#151; Fossil</a></li>
@@ -78,10 +80,11 @@
78 <li><a href="quickstart.wiki">Start Guide &#151; Fossil Quick</a></li>
79 <li><a href="stats.wiki">Statistics &#151; Performance</a></li>
80 <li><a href="sync.wiki">Sync Protocol &#151; The Fossil</a></li>
81 <li><a href="custom_ticket.wiki">System &#151; Customizing The Ticket</a></li>
82 <li><a href="branching.wiki">Tagging &#151; Branching, Forking, Merging, and</a></li>
 
83 <li><a href="sync.wiki">The Fossil Sync Protocol</a></li>
84 <li><a href="webui.wiki">The Fossil Web Interface</a></li>
85 <li><a href="theory1.wiki">Thoughts On The Design Of The Fossil DVCS</a></li>
86 <li><a href="custom_ticket.wiki">Ticket System &#151; Customizing The</a></li>
87 <li><a href="bugtheory.wiki">Tracking In Fossil &#151; Bug</a></li>
88
--- www/permutedindex.wiki
+++ www/permutedindex.wiki
@@ -5,10 +5,11 @@
5 <li><a href="delta_encoder_algorithm.wiki">Algorithm &#151; Fossil Delta Encoding</a></li>
6 <li><a href="faq.wiki">Asked Questions &#151; Frequently</a></li>
7 <li><a href="password.wiki">Authentication &#151; Password Management And</a></li>
8 <li><a href="branching.wiki">Branching, Forking, Merging, and Tagging</a></li>
9 <li><a href="bugtheory.wiki">Bug Tracking In Fossil</a></li>
10 <li><a href="makefile.wiki">Build Process &#151; The Fossil</a></li>
11 <li><a href="build.wiki">Building and Installing Fossil</a></li>
12 <li><a href="checkin_names.wiki">Checkin And Version Names</a></li>
13 <li><a href="selfcheck.wiki">Checks &#151; Fossil Repository Integrity Self</a></li>
14 <li><a href="concepts.wiki">Concepts &#151; Fossil Core</a></li>
15 <li><a href="server.wiki">Configure A Fossil Server &#151; How To</a></li>
@@ -61,10 +62,11 @@
62 <li><a href="index.wiki">Page &#151; Home</a></li>
63 <li><a href="password.wiki">Password Management And Authentication</a></li>
64 <li><a href="quotes.wiki">People Are Saying About Fossil, Git, and DVCSes in General &#151; Quotes: What</a></li>
65 <li><a href="stats.wiki">Performance Statistics</a></li>
66 <li><a href="pop.wiki">Principles Of Operations</a></li>
67 <li><a href="makefile.wiki">Process &#151; The Fossil Build</a></li>
68 <li><a href="embeddeddoc.wiki">Project Documentation &#151; Embedded</a></li>
69 <li><a href="sync.wiki">Protocol &#151; The Fossil Sync</a></li>
70 <li><a href="faq.wiki">Questions &#151; Frequently Asked</a></li>
71 <li><a href="qandc.wiki">Questions And Criticisms</a></li>
72 <li><a href="quickstart.wiki">Quick Start Guide &#151; Fossil</a></li>
@@ -78,10 +80,11 @@
80 <li><a href="quickstart.wiki">Start Guide &#151; Fossil Quick</a></li>
81 <li><a href="stats.wiki">Statistics &#151; Performance</a></li>
82 <li><a href="sync.wiki">Sync Protocol &#151; The Fossil</a></li>
83 <li><a href="custom_ticket.wiki">System &#151; Customizing The Ticket</a></li>
84 <li><a href="branching.wiki">Tagging &#151; Branching, Forking, Merging, and</a></li>
85 <li><a href="makefile.wiki">The Fossil Build Process</a></li>
86 <li><a href="sync.wiki">The Fossil Sync Protocol</a></li>
87 <li><a href="webui.wiki">The Fossil Web Interface</a></li>
88 <li><a href="theory1.wiki">Thoughts On The Design Of The Fossil DVCS</a></li>
89 <li><a href="custom_ticket.wiki">Ticket System &#151; Customizing The</a></li>
90 <li><a href="bugtheory.wiki">Tracking In Fossil &#151; Bug</a></li>
91

Keyboard Shortcuts

Open search /
Next entry (timeline) j
Previous entry (timeline) k
Open focused entry Enter
Show this help ?
Toggle theme Top nav button