Fossil SCM

More tweaks to the "Hash Policy" document. Add the Hash Policy document to the permuted index.

drh 2017-03-05 19:49 UTC fossil-2.1

Commit f55db74d972912d9ea827b40db5726e68b6f0bcc

Parent b0d3e9cc311bcca…

3 files changed +2 -2 +1 +6

~ www/hashpolicy.wiki ~ www/mkindex.tcl ~ www/permutedindex.html

M www/hashpolicy.wiki

+2 -2

		--- www/hashpolicy.wiki
		+++ www/hashpolicy.wiki
		@@ -59,11 +59,11 @@
59	59	someone says "SHA1 is broken, and Fossil uses SHA1, therefore Fossil is
60	60	broken", you can rebut the argument by pointing out that Fossil uses
61	61	<em>Hardened SHA1</em> not generic SHA1 and Hardened SHA1 is <em>not</em>
62	62	broken.
63	63
64		-<h2>Introduction Of SHA3-256</h2>
	64	+<h2>Support For SHA3-256</h2>
65	65
66	66	Prior to Fossil version 2.0 ([/timeline?c=version-2.0\|2017-03-03]),
67	67	all artifacts in all Fossil repositories were named
68	68	by only a SHA1 hash.
69	69	Version 2.0 expanded the Fossil file format to allow artifacts to
		@@ -80,11 +80,11 @@
80	80	as none of the repositories contain artifacts named using SHA3. If
81	81	a repository does contain artifacts named using SHA3, Fossil 1.37 will
82	82	not know how to interpret those artifacts and will generate various warnings
83	83	and errors.
84	84
85		-<h2>Picking Which Hash Algorithm To Use</h2>
	85	+<h2>How Fossil Decides Which Hash Algorithm To Use</h2>
86	86
87	87	If newer versions of Fossil are able to use either SHA1 or SHA3 to
88	88	name artifacts, which hash algorithm is actually used? That question
89	89	is answered by the "hash policy". These are the supported hash policies:
90	90
91	91

	--- www/hashpolicy.wiki
	+++ www/hashpolicy.wiki
	@@ -59,11 +59,11 @@
59	someone says "SHA1 is broken, and Fossil uses SHA1, therefore Fossil is
60	broken", you can rebut the argument by pointing out that Fossil uses
61	<em>Hardened SHA1</em> not generic SHA1 and Hardened SHA1 is <em>not</em>
62	broken.
63
64	<h2>Introduction Of SHA3-256</h2>
65
66	Prior to Fossil version 2.0 ([/timeline?c=version-2.0\|2017-03-03]),
67	all artifacts in all Fossil repositories were named
68	by only a SHA1 hash.
69	Version 2.0 expanded the Fossil file format to allow artifacts to
	@@ -80,11 +80,11 @@
80	as none of the repositories contain artifacts named using SHA3. If
81	a repository does contain artifacts named using SHA3, Fossil 1.37 will
82	not know how to interpret those artifacts and will generate various warnings
83	and errors.
84
85	<h2>Picking Which Hash Algorithm To Use</h2>
86
87	If newer versions of Fossil are able to use either SHA1 or SHA3 to
88	name artifacts, which hash algorithm is actually used? That question
89	is answered by the "hash policy". These are the supported hash policies:
90
91

	--- www/hashpolicy.wiki
	+++ www/hashpolicy.wiki
	@@ -59,11 +59,11 @@
59	someone says "SHA1 is broken, and Fossil uses SHA1, therefore Fossil is
60	broken", you can rebut the argument by pointing out that Fossil uses
61	<em>Hardened SHA1</em> not generic SHA1 and Hardened SHA1 is <em>not</em>
62	broken.
63
64	<h2>Support For SHA3-256</h2>
65
66	Prior to Fossil version 2.0 ([/timeline?c=version-2.0\|2017-03-03]),
67	all artifacts in all Fossil repositories were named
68	by only a SHA1 hash.
69	Version 2.0 expanded the Fossil file format to allow artifacts to
	@@ -80,11 +80,11 @@
80	as none of the repositories contain artifacts named using SHA3. If
81	a repository does contain artifacts named using SHA3, Fossil 1.37 will
82	not know how to interpret those artifacts and will generate various warnings
83	and errors.
84
85	<h2>How Fossil Decides Which Hash Algorithm To Use</h2>
86
87	If newer versions of Fossil are able to use either SHA1 or SHA3 to
88	name artifacts, which hash algorithm is actually used? That question
89	is answered by the "hash policy". These are the supported hash policies:
90
91

M www/mkindex.tcl

		--- www/mkindex.tcl
		+++ www/mkindex.tcl
		@@ -36,10 +36,11 @@
36	36	fiveminutes.wiki {Update and Running in 5 Minutes as a Single User}
37	37	foss-cklist.wiki {Checklist For Successful Open-Source Projects}
38	38	fossil-from-msvc.wiki {Integrating Fossil in the Microsoft Express 2010 IDE}
39	39	fossil-v-git.wiki {Fossil Versus Git}
40	40	hacker-howto.wiki {Hacker How-To}
	41	+ hashpolicy.wiki {Hash Policy: Choosing Between SHA1 and SHA3-256}
41	42	/help {Lists of Commands and Webpages}
42	43	hints.wiki {Fossil Tips And Usage Hints}
43	44	index.wiki {Home Page}
44	45	inout.wiki {Import And Export To And From Git}
45	46	makefile.wiki {The Fossil Build Process}
46	47

	--- www/mkindex.tcl
	+++ www/mkindex.tcl
	@@ -36,10 +36,11 @@
36	fiveminutes.wiki {Update and Running in 5 Minutes as a Single User}
37	foss-cklist.wiki {Checklist For Successful Open-Source Projects}
38	fossil-from-msvc.wiki {Integrating Fossil in the Microsoft Express 2010 IDE}
39	fossil-v-git.wiki {Fossil Versus Git}
40	hacker-howto.wiki {Hacker How-To}

41	/help {Lists of Commands and Webpages}
42	hints.wiki {Fossil Tips And Usage Hints}
43	index.wiki {Home Page}
44	inout.wiki {Import And Export To And From Git}
45	makefile.wiki {The Fossil Build Process}
46

	--- www/mkindex.tcl
	+++ www/mkindex.tcl
	@@ -36,10 +36,11 @@
36	fiveminutes.wiki {Update and Running in 5 Minutes as a Single User}
37	foss-cklist.wiki {Checklist For Successful Open-Source Projects}
38	fossil-from-msvc.wiki {Integrating Fossil in the Microsoft Express 2010 IDE}
39	fossil-v-git.wiki {Fossil Versus Git}
40	hacker-howto.wiki {Hacker How-To}
41	hashpolicy.wiki {Hash Policy: Choosing Between SHA1 and SHA3-256}
42	/help {Lists of Commands and Webpages}
43	hints.wiki {Fossil Tips And Usage Hints}
44	index.wiki {Home Page}
45	inout.wiki {Import And Export To And From Git}
46	makefile.wiki {The Fossil Build Process}
47

M www/permutedindex.html

		--- www/permutedindex.html
		+++ www/permutedindex.html
		@@ -29,10 +29,11 @@
29	29	<li><a href="blame.wiki">Annotate/Blame Algorithm Of Fossil — The</a></li>
30	30	<li><a href="customskin.md">Appearance of Web Pages — Theming: Customizing The</a></li>
31	31	<li><a href="faq.wiki">Asked Questions — Frequently</a></li>
32	32	<li><a href="password.wiki">Authentication — Password Management And</a></li>
33	33	<li><a href="whyusefossil.wiki"><b>Benefits Of Version Control</b></a></li>
	34	+<li><a href="hashpolicy.wiki">Between SHA1 and SHA3-256 — Hash Policy: Choosing</a></li>
34	35	<li><a href="antibot.wiki">Bots — Defense against Spiders and</a></li>
35	36	<li><a href="private.wiki">Branches — Creating, Syncing, and Deleting Private</a></li>
36	37	<li><a href="branching.wiki"><b>Branching, Forking, Merging, and Tagging</b></a></li>
37	38	<li><a href="bugtheory.wiki"><b>Bug Tracking In Fossil</b></a></li>
38	39	<li><a href="makefile.wiki">Build Process — The Fossil</a></li>
		@@ -43,10 +44,11 @@
43	44	<li><a href="checkin.wiki">Checklist — Check-in</a></li>
44	45	<li><a href="../test/release-checklist.wiki">Checklist — Pre-Release Testing</a></li>
45	46	<li><a href="foss-cklist.wiki"><b>Checklist For Successful Open-Source Projects</b></a></li>
46	47	<li><a href="selfcheck.wiki">Checks — Fossil Repository Integrity Self</a></li>
47	48	<li><a href="childprojects.wiki"><b>Child Projects</b></a></li>
	49	+<li><a href="hashpolicy.wiki">Choosing Between SHA1 and SHA3-256 — Hash Policy:</a></li>
48	50	<li><a href="contribute.wiki">Code or Documentation To The Fossil Project — Contributing</a></li>
49	51	<li><a href="style.wiki">Code Style Guidelines — Source</a></li>
50	52	<li><a href="../../../help">Commands and Webpages — Lists of</a></li>
51	53	<li><a href="build.wiki"><b>Compiling and Installing Fossil</b></a></li>
52	54	<li><a href="concepts.wiki">Concepts — Fossil Core</a></li>
		@@ -111,10 +113,11 @@
111	113	<li><a href="customgraph.md">Graph — Theming: Customizing the Timeline</a></li>
112	114	<li><a href="quickstart.wiki">Guide — Fossil Quick Start</a></li>
113	115	<li><a href="style.wiki">Guidelines — Source Code Style</a></li>
114	116	<li><a href="hacker-howto.wiki"><b>Hacker How-To</b></a></li>
115	117	<li><a href="adding_code.wiki"><b>Hacking Fossil</b></a></li>
	118	+<li><a href="hashpolicy.wiki"><b>Hash Policy: Choosing Between SHA1 and SHA3-256</b></a></li>
116	119	<li><a href="hints.wiki">Hints — Fossil Tips And Usage</a></li>
117	120	<li><a href="index.wiki"><b>Home Page</b></a></li>
118	121	<li><a href="selfhost.wiki">Hosting Repositories — Fossil Self</a></li>
119	122	<li><a href="aboutcgi.wiki"><b>How CGI Works In Fossil</b></a></li>
120	123	<li><a href="server.wiki"><b>How To Configure A Fossil Server</b></a></li>
		@@ -147,10 +150,11 @@
147	150	<li><a href="index.wiki">Page — Home</a></li>
148	151	<li><a href="customskin.md">Pages — Theming: Customizing The Appearance of Web</a></li>
149	152	<li><a href="password.wiki"><b>Password Management And Authentication</b></a></li>
150	153	<li><a href="quotes.wiki">People Are Saying About Fossil, Git, and DVCSes in General — Quotes: What</a></li>
151	154	<li><a href="stats.wiki"><b>Performance Statistics</b></a></li>
	155	+<li><a href="hashpolicy.wiki">Policy: Choosing Between SHA1 and SHA3-256 — Hash</a></li>
152	156	<li><a href="../test/release-checklist.wiki"><b>Pre-Release Testing Checklist</b></a></li>
153	157	<li><a href="pop.wiki"><b>Principles Of Operation</b></a></li>
154	158	<li><a href="private.wiki">Private Branches — Creating, Syncing, and Deleting</a></li>
155	159	<li><a href="makefile.wiki">Process — The Fossil Build</a></li>
156	160	<li><a href="contribute.wiki">Project — Contributing Code or Documentation To The Fossil</a></li>
		@@ -174,10 +178,12 @@
174	178	<li><a href="th1.md">Scripting Language — The TH1</a></li>
175	179	<li><a href="selfcheck.wiki">Self Checks — Fossil Repository Integrity</a></li>
176	180	<li><a href="selfhost.wiki">Self Hosting Repositories — Fossil</a></li>
177	181	<li><a href="server.wiki">Server — How To Configure A Fossil</a></li>
178	182	<li><a href="settings.wiki">Settings — Fossil</a></li>
	183	+<li><a href="hashpolicy.wiki">SHA1 and SHA3-256 — Hash Policy: Choosing Between</a></li>
	184	+<li><a href="hashpolicy.wiki">SHA3-256 — Hash Policy: Choosing Between SHA1 and</a></li>
179	185	<li><a href="shunning.wiki"><b>Shunning: Deleting Content From Fossil</b></a></li>
180	186	<li><a href="fiveminutes.wiki">Single User — Update and Running in 5 Minutes as a</a></li>
181	187	<li><a href="../../../sitemap"><b>Site Map</b></a></li>
182	188	<li><a href="style.wiki"><b>Source Code Style Guidelines</b></a></li>
183	189	<li><a href="antibot.wiki">Spiders and Bots — Defense against</a></li>
184	190

	--- www/permutedindex.html
	+++ www/permutedindex.html
	@@ -29,10 +29,11 @@
29	<li><a href="blame.wiki">Annotate/Blame Algorithm Of Fossil — The</a></li>
30	<li><a href="customskin.md">Appearance of Web Pages — Theming: Customizing The</a></li>
31	<li><a href="faq.wiki">Asked Questions — Frequently</a></li>
32	<li><a href="password.wiki">Authentication — Password Management And</a></li>
33	<li><a href="whyusefossil.wiki"><b>Benefits Of Version Control</b></a></li>

34	<li><a href="antibot.wiki">Bots — Defense against Spiders and</a></li>
35	<li><a href="private.wiki">Branches — Creating, Syncing, and Deleting Private</a></li>
36	<li><a href="branching.wiki"><b>Branching, Forking, Merging, and Tagging</b></a></li>
37	<li><a href="bugtheory.wiki"><b>Bug Tracking In Fossil</b></a></li>
38	<li><a href="makefile.wiki">Build Process — The Fossil</a></li>
	@@ -43,10 +44,11 @@
43	<li><a href="checkin.wiki">Checklist — Check-in</a></li>
44	<li><a href="../test/release-checklist.wiki">Checklist — Pre-Release Testing</a></li>
45	<li><a href="foss-cklist.wiki"><b>Checklist For Successful Open-Source Projects</b></a></li>
46	<li><a href="selfcheck.wiki">Checks — Fossil Repository Integrity Self</a></li>
47	<li><a href="childprojects.wiki"><b>Child Projects</b></a></li>

48	<li><a href="contribute.wiki">Code or Documentation To The Fossil Project — Contributing</a></li>
49	<li><a href="style.wiki">Code Style Guidelines — Source</a></li>
50	<li><a href="../../../help">Commands and Webpages — Lists of</a></li>
51	<li><a href="build.wiki"><b>Compiling and Installing Fossil</b></a></li>
52	<li><a href="concepts.wiki">Concepts — Fossil Core</a></li>
	@@ -111,10 +113,11 @@
111	<li><a href="customgraph.md">Graph — Theming: Customizing the Timeline</a></li>
112	<li><a href="quickstart.wiki">Guide — Fossil Quick Start</a></li>
113	<li><a href="style.wiki">Guidelines — Source Code Style</a></li>
114	<li><a href="hacker-howto.wiki"><b>Hacker How-To</b></a></li>
115	<li><a href="adding_code.wiki"><b>Hacking Fossil</b></a></li>

116	<li><a href="hints.wiki">Hints — Fossil Tips And Usage</a></li>
117	<li><a href="index.wiki"><b>Home Page</b></a></li>
118	<li><a href="selfhost.wiki">Hosting Repositories — Fossil Self</a></li>
119	<li><a href="aboutcgi.wiki"><b>How CGI Works In Fossil</b></a></li>
120	<li><a href="server.wiki"><b>How To Configure A Fossil Server</b></a></li>
	@@ -147,10 +150,11 @@
147	<li><a href="index.wiki">Page — Home</a></li>
148	<li><a href="customskin.md">Pages — Theming: Customizing The Appearance of Web</a></li>
149	<li><a href="password.wiki"><b>Password Management And Authentication</b></a></li>
150	<li><a href="quotes.wiki">People Are Saying About Fossil, Git, and DVCSes in General — Quotes: What</a></li>
151	<li><a href="stats.wiki"><b>Performance Statistics</b></a></li>

152	<li><a href="../test/release-checklist.wiki"><b>Pre-Release Testing Checklist</b></a></li>
153	<li><a href="pop.wiki"><b>Principles Of Operation</b></a></li>
154	<li><a href="private.wiki">Private Branches — Creating, Syncing, and Deleting</a></li>
155	<li><a href="makefile.wiki">Process — The Fossil Build</a></li>
156	<li><a href="contribute.wiki">Project — Contributing Code or Documentation To The Fossil</a></li>
	@@ -174,10 +178,12 @@
174	<li><a href="th1.md">Scripting Language — The TH1</a></li>
175	<li><a href="selfcheck.wiki">Self Checks — Fossil Repository Integrity</a></li>
176	<li><a href="selfhost.wiki">Self Hosting Repositories — Fossil</a></li>
177	<li><a href="server.wiki">Server — How To Configure A Fossil</a></li>
178	<li><a href="settings.wiki">Settings — Fossil</a></li>


179	<li><a href="shunning.wiki"><b>Shunning: Deleting Content From Fossil</b></a></li>
180	<li><a href="fiveminutes.wiki">Single User — Update and Running in 5 Minutes as a</a></li>
181	<li><a href="../../../sitemap"><b>Site Map</b></a></li>
182	<li><a href="style.wiki"><b>Source Code Style Guidelines</b></a></li>
183	<li><a href="antibot.wiki">Spiders and Bots — Defense against</a></li>
184

	--- www/permutedindex.html
	+++ www/permutedindex.html
	@@ -29,10 +29,11 @@
29	<li><a href="blame.wiki">Annotate/Blame Algorithm Of Fossil — The</a></li>
30	<li><a href="customskin.md">Appearance of Web Pages — Theming: Customizing The</a></li>
31	<li><a href="faq.wiki">Asked Questions — Frequently</a></li>
32	<li><a href="password.wiki">Authentication — Password Management And</a></li>
33	<li><a href="whyusefossil.wiki"><b>Benefits Of Version Control</b></a></li>
34	<li><a href="hashpolicy.wiki">Between SHA1 and SHA3-256 — Hash Policy: Choosing</a></li>
35	<li><a href="antibot.wiki">Bots — Defense against Spiders and</a></li>
36	<li><a href="private.wiki">Branches — Creating, Syncing, and Deleting Private</a></li>
37	<li><a href="branching.wiki"><b>Branching, Forking, Merging, and Tagging</b></a></li>
38	<li><a href="bugtheory.wiki"><b>Bug Tracking In Fossil</b></a></li>
39	<li><a href="makefile.wiki">Build Process — The Fossil</a></li>
	@@ -43,10 +44,11 @@
44	<li><a href="checkin.wiki">Checklist — Check-in</a></li>
45	<li><a href="../test/release-checklist.wiki">Checklist — Pre-Release Testing</a></li>
46	<li><a href="foss-cklist.wiki"><b>Checklist For Successful Open-Source Projects</b></a></li>
47	<li><a href="selfcheck.wiki">Checks — Fossil Repository Integrity Self</a></li>
48	<li><a href="childprojects.wiki"><b>Child Projects</b></a></li>
49	<li><a href="hashpolicy.wiki">Choosing Between SHA1 and SHA3-256 — Hash Policy:</a></li>
50	<li><a href="contribute.wiki">Code or Documentation To The Fossil Project — Contributing</a></li>
51	<li><a href="style.wiki">Code Style Guidelines — Source</a></li>
52	<li><a href="../../../help">Commands and Webpages — Lists of</a></li>
53	<li><a href="build.wiki"><b>Compiling and Installing Fossil</b></a></li>
54	<li><a href="concepts.wiki">Concepts — Fossil Core</a></li>
	@@ -111,10 +113,11 @@
113	<li><a href="customgraph.md">Graph — Theming: Customizing the Timeline</a></li>
114	<li><a href="quickstart.wiki">Guide — Fossil Quick Start</a></li>
115	<li><a href="style.wiki">Guidelines — Source Code Style</a></li>
116	<li><a href="hacker-howto.wiki"><b>Hacker How-To</b></a></li>
117	<li><a href="adding_code.wiki"><b>Hacking Fossil</b></a></li>
118	<li><a href="hashpolicy.wiki"><b>Hash Policy: Choosing Between SHA1 and SHA3-256</b></a></li>
119	<li><a href="hints.wiki">Hints — Fossil Tips And Usage</a></li>
120	<li><a href="index.wiki"><b>Home Page</b></a></li>
121	<li><a href="selfhost.wiki">Hosting Repositories — Fossil Self</a></li>
122	<li><a href="aboutcgi.wiki"><b>How CGI Works In Fossil</b></a></li>
123	<li><a href="server.wiki"><b>How To Configure A Fossil Server</b></a></li>
	@@ -147,10 +150,11 @@
150	<li><a href="index.wiki">Page — Home</a></li>
151	<li><a href="customskin.md">Pages — Theming: Customizing The Appearance of Web</a></li>
152	<li><a href="password.wiki"><b>Password Management And Authentication</b></a></li>
153	<li><a href="quotes.wiki">People Are Saying About Fossil, Git, and DVCSes in General — Quotes: What</a></li>
154	<li><a href="stats.wiki"><b>Performance Statistics</b></a></li>
155	<li><a href="hashpolicy.wiki">Policy: Choosing Between SHA1 and SHA3-256 — Hash</a></li>
156	<li><a href="../test/release-checklist.wiki"><b>Pre-Release Testing Checklist</b></a></li>
157	<li><a href="pop.wiki"><b>Principles Of Operation</b></a></li>
158	<li><a href="private.wiki">Private Branches — Creating, Syncing, and Deleting</a></li>
159	<li><a href="makefile.wiki">Process — The Fossil Build</a></li>
160	<li><a href="contribute.wiki">Project — Contributing Code or Documentation To The Fossil</a></li>
	@@ -174,10 +178,12 @@
178	<li><a href="th1.md">Scripting Language — The TH1</a></li>
179	<li><a href="selfcheck.wiki">Self Checks — Fossil Repository Integrity</a></li>
180	<li><a href="selfhost.wiki">Self Hosting Repositories — Fossil</a></li>
181	<li><a href="server.wiki">Server — How To Configure A Fossil</a></li>
182	<li><a href="settings.wiki">Settings — Fossil</a></li>
183	<li><a href="hashpolicy.wiki">SHA1 and SHA3-256 — Hash Policy: Choosing Between</a></li>
184	<li><a href="hashpolicy.wiki">SHA3-256 — Hash Policy: Choosing Between SHA1 and</a></li>
185	<li><a href="shunning.wiki"><b>Shunning: Deleting Content From Fossil</b></a></li>
186	<li><a href="fiveminutes.wiki">Single User — Update and Running in 5 Minutes as a</a></li>
187	<li><a href="../../../sitemap"><b>Site Map</b></a></li>
188	<li><a href="style.wiki"><b>Source Code Style Guidelines</b></a></li>
189	<li><a href="antibot.wiki">Spiders and Bots — Defense against</a></li>
190

Fossil SCM

Keyboard Shortcuts