Fossil SCM

Updates to the encrypted Fossil documentation.

drh 2016-07-05 14:54 trunk
Commit 7fd600903f599770df2bfe7273ff9b5b872c6c9d
Parent 8ce629f916c615f…
3 files changed +9 -3 +1 +4
~ www/encryptedrepos.wiki ~ www/mkindex.tcl ~ www/permutedindex.html
M www/encryptedrepos.wiki
+9 -3
--- www/encryptedrepos.wiki
+++ www/encryptedrepos.wiki
@@ -10,11 +10,13 @@
1010
 <p>
1111
 Assuming you have an SEE license, the first step of compiling Fossil to
1212
 use SEE is to create an SEE-enabled version of the SQLite database source code.
1313
 This alternative SQLite database source file should be called "sqlite3-see.c"
1414
 and should be placed in the src/ subfolder of the Fossil sources, right beside
15
-the public-domain "sqlite3.c" source file.
15
+the public-domain "sqlite3.c" source file. Also make a copy of the SEE-enabled
16
+"shell.c" file, renamed as "shell-see.c", and place it in the src/ subfolder
17
+beside the original "shell.c".
1618
 <p>
1719
 Add the --with-see command-line option to the configuration script to enable
1820
 the use of SEE on unix-like systems.
1921
 <blockquote><pre>
2022
 ./configure --with-see; make
@@ -28,10 +30,14 @@
2830
 <h2>Using Encrypted Repositories</h2><blockquote>
2931
 Any Fossil repositories whose filename ends with ".efossil" is taken to be
3032
 an encrypted repository. Fossil will prompt for the encryption password and
3133
 attempt to open the repository database using that password.
3234
 <p>
33
-Every use of an encrypted repository requires retyping the encryption password.
35
+Every invocation of fossil on an encrypted repository requires retyping the
36
+encryption password.
37
+To avoid excess password typing, consider using the "fossil shell"
38
+command which prompts for the password just once, then reuses it for each
39
+subsequent Fossil command entered at the prompt.
3440
 <p>
35
-On Windows, the "fossil server" and "fossil ui" commands do not
41
+On Windows, the "fossil server", "fossil ui", and "fossil shell" commands do not
3642
 (currently) work on an encrypted repository.
3743
 </blockquote>
3844
--- www/encryptedrepos.wiki
+++ www/encryptedrepos.wiki
@@ -10,11 +10,13 @@
10 <p>
11 Assuming you have an SEE license, the first step of compiling Fossil to
12 use SEE is to create an SEE-enabled version of the SQLite database source code.
13 This alternative SQLite database source file should be called "sqlite3-see.c"
14 and should be placed in the src/ subfolder of the Fossil sources, right beside
15 the public-domain "sqlite3.c" source file.
 
 
16 <p>
17 Add the --with-see command-line option to the configuration script to enable
18 the use of SEE on unix-like systems.
19 <blockquote><pre>
20 ./configure --with-see; make
@@ -28,10 +30,14 @@
28 <h2>Using Encrypted Repositories</h2><blockquote>
29 Any Fossil repositories whose filename ends with ".efossil" is taken to be
30 an encrypted repository. Fossil will prompt for the encryption password and
31 attempt to open the repository database using that password.
32 <p>
33 Every use of an encrypted repository requires retyping the encryption password.
 
 
 
 
34 <p>
35 On Windows, the "fossil server" and "fossil ui" commands do not
36 (currently) work on an encrypted repository.
37 </blockquote>
38
--- www/encryptedrepos.wiki
+++ www/encryptedrepos.wiki
@@ -10,11 +10,13 @@
10 <p>
11 Assuming you have an SEE license, the first step of compiling Fossil to
12 use SEE is to create an SEE-enabled version of the SQLite database source code.
13 This alternative SQLite database source file should be called "sqlite3-see.c"
14 and should be placed in the src/ subfolder of the Fossil sources, right beside
15 the public-domain "sqlite3.c" source file. Also make a copy of the SEE-enabled
16 "shell.c" file, renamed as "shell-see.c", and place it in the src/ subfolder
17 beside the original "shell.c".
18 <p>
19 Add the --with-see command-line option to the configuration script to enable
20 the use of SEE on unix-like systems.
21 <blockquote><pre>
22 ./configure --with-see; make
@@ -28,10 +30,14 @@
30 <h2>Using Encrypted Repositories</h2><blockquote>
31 Any Fossil repositories whose filename ends with ".efossil" is taken to be
32 an encrypted repository. Fossil will prompt for the encryption password and
33 attempt to open the repository database using that password.
34 <p>
35 Every invocation of fossil on an encrypted repository requires retyping the
36 encryption password.
37 To avoid excess password typing, consider using the "fossil shell"
38 command which prompts for the password just once, then reuses it for each
39 subsequent Fossil command entered at the prompt.
40 <p>
41 On Windows, the "fossil server", "fossil ui", and "fossil shell" commands do not
42 (currently) work on an encrypted repository.
43 </blockquote>
44
M www/mkindex.tcl
+1
--- www/mkindex.tcl
+++ www/mkindex.tcl
@@ -24,10 +24,11 @@
2424
 customskin.md {Theming: Customizing The Appearance of Web Pages}
2525
 custom_ticket.wiki {Customizing The Ticket System}
2626
 delta_encoder_algorithm.wiki {Fossil Delta Encoding Algorithm}
2727
 delta_format.wiki {Fossil Delta Format}
2828
 embeddeddoc.wiki {Embedded Project Documentation}
29
+ encryptedrepos.wiki {How To Use Encrypted Repositories}
2930
 env-opts.md {Environment Variables and Global Options}
3031
 event.wiki {Events}
3132
 faq.wiki {Frequently Asked Questions}
3233
 fileformat.wiki {Fossil File Format}
3334
 fiveminutes.wiki {Update and Running in 5 Minutes as a Single User}
3435
--- www/mkindex.tcl
+++ www/mkindex.tcl
@@ -24,10 +24,11 @@
24 customskin.md {Theming: Customizing The Appearance of Web Pages}
25 custom_ticket.wiki {Customizing The Ticket System}
26 delta_encoder_algorithm.wiki {Fossil Delta Encoding Algorithm}
27 delta_format.wiki {Fossil Delta Format}
28 embeddeddoc.wiki {Embedded Project Documentation}
 
29 env-opts.md {Environment Variables and Global Options}
30 event.wiki {Events}
31 faq.wiki {Frequently Asked Questions}
32 fileformat.wiki {Fossil File Format}
33 fiveminutes.wiki {Update and Running in 5 Minutes as a Single User}
34
--- www/mkindex.tcl
+++ www/mkindex.tcl
@@ -24,10 +24,11 @@
24 customskin.md {Theming: Customizing The Appearance of Web Pages}
25 custom_ticket.wiki {Customizing The Ticket System}
26 delta_encoder_algorithm.wiki {Fossil Delta Encoding Algorithm}
27 delta_format.wiki {Fossil Delta Format}
28 embeddeddoc.wiki {Embedded Project Documentation}
29 encryptedrepos.wiki {How To Use Encrypted Repositories}
30 env-opts.md {Environment Variables and Global Options}
31 event.wiki {Events}
32 faq.wiki {Frequently Asked Questions}
33 fileformat.wiki {Fossil File Format}
34 fiveminutes.wiki {Update and Running in 5 Minutes as a Single User}
35
M www/permutedindex.html
+4
--- www/permutedindex.html
+++ www/permutedindex.html
@@ -71,10 +71,11 @@
7171
 <li><a href="contribute.wiki">Documentation To The Fossil Project &mdash; Contributing Code or</a></li>
7272
 <li><a href="theory1.wiki">DVCS &mdash; Thoughts On The Design Of The Fossil</a></li>
7373
 <li><a href="quotes.wiki">DVCSes in General &mdash; Quotes: What People Are Saying About Fossil, Git, and</a></li>
7474
 <li><a href="embeddeddoc.wiki">Embedded Project Documentation</a></li>
7575
 <li><a href="delta_encoder_algorithm.wiki">Encoding Algorithm &mdash; Fossil Delta</a></li>
76
+<li><a href="encryptedrepos.wiki">Encrypted Repositories &mdash; How To Use</a></li>
7677
 <li><a href="env-opts.md">Environment Variables and Global Options</a></li>
7778
 <li><a href="event.wiki">Events</a></li>
7879
 <li><a href="webpage-ex.md">Examples &mdash; Webpage</a></li>
7980
 <li><a href="inout.wiki">Export To And From Git &mdash; Import And</a></li>
8081
 <li><a href="fossil-from-msvc.wiki">Express 2010 IDE &mdash; Integrating Fossil in the Microsoft</a></li>
@@ -111,10 +112,11 @@
111112
 <li><a href="hints.wiki">Hints &mdash; Fossil Tips And Usage</a></li>
112113
 <li><a href="index.wiki">Home Page</a></li>
113114
 <li><a href="selfhost.wiki">Hosting Repositories &mdash; Fossil Self</a></li>
114115
 <li><a href="server.wiki">How To Configure A Fossil Server</a></li>
115116
 <li><a href="newrepo.wiki">How To Create A New Fossil Repository</a></li>
117
+<li><a href="encryptedrepos.wiki">How To Use Encrypted Repositories</a></li>
116118
 <li><a href="hacker-howto.wiki">How-To &mdash; Hacker</a></li>
117119
 <li><a href="fossil-from-msvc.wiki">IDE &mdash; Integrating Fossil in the Microsoft Express 2010</a></li>
118120
 <li><a href="tech_overview.wiki">Implementation Of Fossil &mdash; A Technical Overview Of The Design And</a></li>
119121
 <li><a href="inout.wiki">Import And Export To And From Git</a></li>
120122
 <li><a href="build.wiki">Installing Fossil &mdash; Compiling and</a></li>
@@ -150,10 +152,11 @@
150152
 <li><a href="faq.wiki">Questions &mdash; Frequently Asked</a></li>
151153
 <li><a href="qandc.wiki">Questions And Criticisms</a></li>
152154
 <li><a href="quickstart.wiki">Quick Start Guide &mdash; Fossil</a></li>
153155
 <li><a href="quotes.wiki">Quotes: What People Are Saying About Fossil, Git, and DVCSes in General</a></li>
154156
 <li><a href="selfhost.wiki">Repositories &mdash; Fossil Self Hosting</a></li>
157
+<li><a href="encryptedrepos.wiki">Repositories &mdash; How To Use Encrypted</a></li>
155158
 <li><a href="newrepo.wiki">Repository &mdash; How To Create A New Fossil</a></li>
156159
 <li><a href="selfcheck.wiki">Repository Integrity Self Checks &mdash; Fossil</a></li>
157160
 <li><a href="reviews.wiki">Reviews</a></li>
158161
 <li><a href="fiveminutes.wiki">Running in 5 Minutes as a Single User &mdash; Update and</a></li>
159162
 <li><a href="quotes.wiki">Saying About Fossil, Git, and DVCSes in General &mdash; Quotes: What People Are</a></li>
@@ -194,10 +197,11 @@
194197
 <li><a href="customgraph.md">Timeline Graph &mdash; Theming: Customizing the</a></li>
195198
 <li><a href="hints.wiki">Tips And Usage Hints &mdash; Fossil</a></li>
196199
 <li><a href="bugtheory.wiki">Tracking In Fossil &mdash; Bug</a></li>
197200
 <li><a href="fiveminutes.wiki">Update and Running in 5 Minutes as a Single User</a></li>
198201
 <li><a href="hints.wiki">Usage Hints &mdash; Fossil Tips And</a></li>
202
+<li><a href="encryptedrepos.wiki">Use Encrypted Repositories &mdash; How To</a></li>
199203
 <li><a href="fiveminutes.wiki">User &mdash; Update and Running in 5 Minutes as a Single</a></li>
200204
 <li><a href="ssl.wiki">Using SSL with Fossil</a></li>
201205
 <li><a href="env-opts.md">Variables and Global Options &mdash; Environment</a></li>
202206
 <li><a href="checkin_names.wiki">Version Names &mdash; Check-in And</a></li>
203207
 <li><a href="fossil-v-git.wiki">Versus Git &mdash; Fossil</a></li>
204208
--- www/permutedindex.html
+++ www/permutedindex.html
@@ -71,10 +71,11 @@
71 <li><a href="contribute.wiki">Documentation To The Fossil Project &mdash; Contributing Code or</a></li>
72 <li><a href="theory1.wiki">DVCS &mdash; Thoughts On The Design Of The Fossil</a></li>
73 <li><a href="quotes.wiki">DVCSes in General &mdash; Quotes: What People Are Saying About Fossil, Git, and</a></li>
74 <li><a href="embeddeddoc.wiki">Embedded Project Documentation</a></li>
75 <li><a href="delta_encoder_algorithm.wiki">Encoding Algorithm &mdash; Fossil Delta</a></li>
 
76 <li><a href="env-opts.md">Environment Variables and Global Options</a></li>
77 <li><a href="event.wiki">Events</a></li>
78 <li><a href="webpage-ex.md">Examples &mdash; Webpage</a></li>
79 <li><a href="inout.wiki">Export To And From Git &mdash; Import And</a></li>
80 <li><a href="fossil-from-msvc.wiki">Express 2010 IDE &mdash; Integrating Fossil in the Microsoft</a></li>
@@ -111,10 +112,11 @@
111 <li><a href="hints.wiki">Hints &mdash; Fossil Tips And Usage</a></li>
112 <li><a href="index.wiki">Home Page</a></li>
113 <li><a href="selfhost.wiki">Hosting Repositories &mdash; Fossil Self</a></li>
114 <li><a href="server.wiki">How To Configure A Fossil Server</a></li>
115 <li><a href="newrepo.wiki">How To Create A New Fossil Repository</a></li>
 
116 <li><a href="hacker-howto.wiki">How-To &mdash; Hacker</a></li>
117 <li><a href="fossil-from-msvc.wiki">IDE &mdash; Integrating Fossil in the Microsoft Express 2010</a></li>
118 <li><a href="tech_overview.wiki">Implementation Of Fossil &mdash; A Technical Overview Of The Design And</a></li>
119 <li><a href="inout.wiki">Import And Export To And From Git</a></li>
120 <li><a href="build.wiki">Installing Fossil &mdash; Compiling and</a></li>
@@ -150,10 +152,11 @@
150 <li><a href="faq.wiki">Questions &mdash; Frequently Asked</a></li>
151 <li><a href="qandc.wiki">Questions And Criticisms</a></li>
152 <li><a href="quickstart.wiki">Quick Start Guide &mdash; Fossil</a></li>
153 <li><a href="quotes.wiki">Quotes: What People Are Saying About Fossil, Git, and DVCSes in General</a></li>
154 <li><a href="selfhost.wiki">Repositories &mdash; Fossil Self Hosting</a></li>
 
155 <li><a href="newrepo.wiki">Repository &mdash; How To Create A New Fossil</a></li>
156 <li><a href="selfcheck.wiki">Repository Integrity Self Checks &mdash; Fossil</a></li>
157 <li><a href="reviews.wiki">Reviews</a></li>
158 <li><a href="fiveminutes.wiki">Running in 5 Minutes as a Single User &mdash; Update and</a></li>
159 <li><a href="quotes.wiki">Saying About Fossil, Git, and DVCSes in General &mdash; Quotes: What People Are</a></li>
@@ -194,10 +197,11 @@
194 <li><a href="customgraph.md">Timeline Graph &mdash; Theming: Customizing the</a></li>
195 <li><a href="hints.wiki">Tips And Usage Hints &mdash; Fossil</a></li>
196 <li><a href="bugtheory.wiki">Tracking In Fossil &mdash; Bug</a></li>
197 <li><a href="fiveminutes.wiki">Update and Running in 5 Minutes as a Single User</a></li>
198 <li><a href="hints.wiki">Usage Hints &mdash; Fossil Tips And</a></li>
 
199 <li><a href="fiveminutes.wiki">User &mdash; Update and Running in 5 Minutes as a Single</a></li>
200 <li><a href="ssl.wiki">Using SSL with Fossil</a></li>
201 <li><a href="env-opts.md">Variables and Global Options &mdash; Environment</a></li>
202 <li><a href="checkin_names.wiki">Version Names &mdash; Check-in And</a></li>
203 <li><a href="fossil-v-git.wiki">Versus Git &mdash; Fossil</a></li>
204
--- www/permutedindex.html
+++ www/permutedindex.html
@@ -71,10 +71,11 @@
71 <li><a href="contribute.wiki">Documentation To The Fossil Project &mdash; Contributing Code or</a></li>
72 <li><a href="theory1.wiki">DVCS &mdash; Thoughts On The Design Of The Fossil</a></li>
73 <li><a href="quotes.wiki">DVCSes in General &mdash; Quotes: What People Are Saying About Fossil, Git, and</a></li>
74 <li><a href="embeddeddoc.wiki">Embedded Project Documentation</a></li>
75 <li><a href="delta_encoder_algorithm.wiki">Encoding Algorithm &mdash; Fossil Delta</a></li>
76 <li><a href="encryptedrepos.wiki">Encrypted Repositories &mdash; How To Use</a></li>
77 <li><a href="env-opts.md">Environment Variables and Global Options</a></li>
78 <li><a href="event.wiki">Events</a></li>
79 <li><a href="webpage-ex.md">Examples &mdash; Webpage</a></li>
80 <li><a href="inout.wiki">Export To And From Git &mdash; Import And</a></li>
81 <li><a href="fossil-from-msvc.wiki">Express 2010 IDE &mdash; Integrating Fossil in the Microsoft</a></li>
@@ -111,10 +112,11 @@
112 <li><a href="hints.wiki">Hints &mdash; Fossil Tips And Usage</a></li>
113 <li><a href="index.wiki">Home Page</a></li>
114 <li><a href="selfhost.wiki">Hosting Repositories &mdash; Fossil Self</a></li>
115 <li><a href="server.wiki">How To Configure A Fossil Server</a></li>
116 <li><a href="newrepo.wiki">How To Create A New Fossil Repository</a></li>
117 <li><a href="encryptedrepos.wiki">How To Use Encrypted Repositories</a></li>
118 <li><a href="hacker-howto.wiki">How-To &mdash; Hacker</a></li>
119 <li><a href="fossil-from-msvc.wiki">IDE &mdash; Integrating Fossil in the Microsoft Express 2010</a></li>
120 <li><a href="tech_overview.wiki">Implementation Of Fossil &mdash; A Technical Overview Of The Design And</a></li>
121 <li><a href="inout.wiki">Import And Export To And From Git</a></li>
122 <li><a href="build.wiki">Installing Fossil &mdash; Compiling and</a></li>
@@ -150,10 +152,11 @@
152 <li><a href="faq.wiki">Questions &mdash; Frequently Asked</a></li>
153 <li><a href="qandc.wiki">Questions And Criticisms</a></li>
154 <li><a href="quickstart.wiki">Quick Start Guide &mdash; Fossil</a></li>
155 <li><a href="quotes.wiki">Quotes: What People Are Saying About Fossil, Git, and DVCSes in General</a></li>
156 <li><a href="selfhost.wiki">Repositories &mdash; Fossil Self Hosting</a></li>
157 <li><a href="encryptedrepos.wiki">Repositories &mdash; How To Use Encrypted</a></li>
158 <li><a href="newrepo.wiki">Repository &mdash; How To Create A New Fossil</a></li>
159 <li><a href="selfcheck.wiki">Repository Integrity Self Checks &mdash; Fossil</a></li>
160 <li><a href="reviews.wiki">Reviews</a></li>
161 <li><a href="fiveminutes.wiki">Running in 5 Minutes as a Single User &mdash; Update and</a></li>
162 <li><a href="quotes.wiki">Saying About Fossil, Git, and DVCSes in General &mdash; Quotes: What People Are</a></li>
@@ -194,10 +197,11 @@
197 <li><a href="customgraph.md">Timeline Graph &mdash; Theming: Customizing the</a></li>
198 <li><a href="hints.wiki">Tips And Usage Hints &mdash; Fossil</a></li>
199 <li><a href="bugtheory.wiki">Tracking In Fossil &mdash; Bug</a></li>
200 <li><a href="fiveminutes.wiki">Update and Running in 5 Minutes as a Single User</a></li>
201 <li><a href="hints.wiki">Usage Hints &mdash; Fossil Tips And</a></li>
202 <li><a href="encryptedrepos.wiki">Use Encrypted Repositories &mdash; How To</a></li>
203 <li><a href="fiveminutes.wiki">User &mdash; Update and Running in 5 Minutes as a Single</a></li>
204 <li><a href="ssl.wiki">Using SSL with Fossil</a></li>
205 <li><a href="env-opts.md">Variables and Global Options &mdash; Environment</a></li>
206 <li><a href="checkin_names.wiki">Version Names &mdash; Check-in And</a></li>
207 <li><a href="fossil-v-git.wiki">Versus Git &mdash; Fossil</a></li>
208

Keyboard Shortcuts

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