Fossil SCM

Extracted the "fossil up" vs "fossil co" discussion in gitusers.md to a separate document, since it's of broader interest than just in comparisons to Git. This freed me to expand the comparison.

wyoung 2021-01-14 14:53 trunk
Commit a5ea7891599eb3be7dac5a3b8956a9f9b82afa38ca15f93e29eee22bf57d97b4
Parent 99117745c4f5902…
3 files changed +6 -18 +1 +3
~ www/gitusers.md ~ www/mkindex.tcl ~ www/permutedindex.html
M www/gitusers.md
+6 -18
--- www/gitusers.md
+++ www/gitusers.md
@@ -74,30 +74,18 @@
7474
7575
 …is best given as:
7676
7777
 fossil update some-branch
7878
79
-…in Fossil. There is a `fossil checkout` command, but it has two
80
-restrictions that push you toward using `fossil update` instead:
81
-
82
-1. Several features in `fossil update` do not exist in
83
- `fossil checkout`.
84
-
85
-2. The lone exception is `fossil checkout --keep`, a rarely-needed
86
- operation.
87
-
88
-3. Fossil will have you typing “`fossil up`” frequently anyway to pull
89
- remote changes and merge them into the local check-out directory.
90
- Adding a `VERSION` string for the cases where you mean something
91
- other than “tip of the current branch” is an easy habit to develop.
92
-
93
-Neither command is an alias for the other. They overlap enough that they
94
-can be used interchangeably for everyday use cases, but since `update`
95
-is more powerful, we recommend that you break the habit of typing
96
-`checkout`.
79
+…in Fossil. There is a [`fossil checkout`][co] command, but it has
80
+[several differences](./co-vs-up.md) that make it less broadly useful
81
+than [`fossil update`][up] in everyday operation, so we recommend that
82
+Git users moving to Fossil develop a habit of typing `fossil up` rather
83
+than `fossil checkout`.
9784
9885
 [ckwf]: ./ckout-workflows.md
86
+[co]: /help?cmd=checkout
9987
10088
10189
 #### <a id="rname"></a> Naming Repositories
10290
10391
 The Fossil repository database file can be named anything
10492
--- www/gitusers.md
+++ www/gitusers.md
@@ -74,30 +74,18 @@
74
75 …is best given as:
76
77 fossil update some-branch
78
79 …in Fossil. There is a `fossil checkout` command, but it has two
80 restrictions that push you toward using `fossil update` instead:
81
82 1. Several features in `fossil update` do not exist in
83 `fossil checkout`.
84
85 2. The lone exception is `fossil checkout --keep`, a rarely-needed
86 operation.
87
88 3. Fossil will have you typing “`fossil up`” frequently anyway to pull
89 remote changes and merge them into the local check-out directory.
90 Adding a `VERSION` string for the cases where you mean something
91 other than “tip of the current branch” is an easy habit to develop.
92
93 Neither command is an alias for the other. They overlap enough that they
94 can be used interchangeably for everyday use cases, but since `update`
95 is more powerful, we recommend that you break the habit of typing
96 `checkout`.
97
98 [ckwf]: ./ckout-workflows.md
 
99
100
101 #### <a id="rname"></a> Naming Repositories
102
103 The Fossil repository database file can be named anything
104
--- www/gitusers.md
+++ www/gitusers.md
@@ -74,30 +74,18 @@
74
75 …is best given as:
76
77 fossil update some-branch
78
79 …in Fossil. There is a [`fossil checkout`][co] command, but it has
80 [several differences](./co-vs-up.md) that make it less broadly useful
81 than [`fossil update`][up] in everyday operation, so we recommend that
82 Git users moving to Fossil develop a habit of typing `fossil up` rather
83 than `fossil checkout`.
 
 
 
 
 
 
 
 
 
 
 
 
 
84
85 [ckwf]: ./ckout-workflows.md
86 [co]: /help?cmd=checkout
87
88
89 #### <a id="rname"></a> Naming Repositories
90
91 The Fossil repository database file can be named anything
92
M www/mkindex.tcl
+1
--- www/mkindex.tcl
+++ www/mkindex.tcl
@@ -30,10 +30,11 @@
3030
 checkin_names.wiki {Check-in And Version Names}
3131
 checkin.wiki {Check-in Checklist}
3232
 childprojects.wiki {Child Projects}
3333
 chroot.md {Server Chroot Jail}
3434
 ckout-workflows.md {Check-Out Workflows}
35
+ co-vs-up.md {Checkout vs Update}
3536
 copyright-release.html {Contributor License Agreement}
3637
 concepts.wiki {Fossil Core Concepts}
3738
 contact.md {Developer Contact Information}
3839
 contribute.wiki {Contributing Code or Documentation To The Fossil Project}
3940
 css-tricks.md {Fossil CSS Tips and Tricks}
4041
--- www/mkindex.tcl
+++ www/mkindex.tcl
@@ -30,10 +30,11 @@
30 checkin_names.wiki {Check-in And Version Names}
31 checkin.wiki {Check-in Checklist}
32 childprojects.wiki {Child Projects}
33 chroot.md {Server Chroot Jail}
34 ckout-workflows.md {Check-Out Workflows}
 
35 copyright-release.html {Contributor License Agreement}
36 concepts.wiki {Fossil Core Concepts}
37 contact.md {Developer Contact Information}
38 contribute.wiki {Contributing Code or Documentation To The Fossil Project}
39 css-tricks.md {Fossil CSS Tips and Tricks}
40
--- www/mkindex.tcl
+++ www/mkindex.tcl
@@ -30,10 +30,11 @@
30 checkin_names.wiki {Check-in And Version Names}
31 checkin.wiki {Check-in Checklist}
32 childprojects.wiki {Child Projects}
33 chroot.md {Server Chroot Jail}
34 ckout-workflows.md {Check-Out Workflows}
35 co-vs-up.md {Checkout vs Update}
36 copyright-release.html {Contributor License Agreement}
37 concepts.wiki {Fossil Core Concepts}
38 contact.md {Developer Contact Information}
39 contribute.wiki {Contributing Code or Documentation To The Fossil Project}
40 css-tricks.md {Fossil CSS Tips and Tricks}
41
M www/permutedindex.html
+3
--- www/permutedindex.html
+++ www/permutedindex.html
@@ -63,10 +63,11 @@
6363
 <li><a href="checkin.wiki"><b>Check-in Checklist</b></a></li>
6464
 <li><a href="ckout-workflows.md"><b>Check-Out Workflows</b></a></li>
6565
 <li><a href="checkin.wiki">Checklist &mdash; Check-in</a></li>
6666
 <li><a href="../test/release-checklist.wiki">Checklist &mdash; Pre-Release Testing</a></li>
6767
 <li><a href="foss-cklist.wiki"><b>Checklist For Successful Open-Source Projects</b></a></li>
68
+<li><a href="co-vs-up.md"><b>Checkout vs Update</b></a></li>
6869
 <li><a href="selfcheck.wiki">Checks &mdash; Fossil Repository Integrity Self</a></li>
6970
 <li><a href="childprojects.wiki"><b>Child Projects</b></a></li>
7071
 <li><a href="hashpolicy.wiki">Choosing Between SHA1 and SHA3-256 &mdash; Hash Policy:</a></li>
7172
 <li><a href="chroot.md">Chroot Jail &mdash; Server</a></li>
7273
 <li><a href="contribute.wiki">Code or Documentation To The Fossil Project &mdash; Contributing</a></li>
@@ -328,10 +329,11 @@
328329
 <li><a href="gitusers.md">Translation Guide &mdash; Git to Fossil</a></li>
329330
 <li><a href="css-tricks.md">Tricks &mdash; Fossil CSS Tips and</a></li>
330331
 <li><a href="unvers.wiki"><b>Unversioned Files</b></a></li>
331332
 <li><a href="backup.md">Up a Remote Fossil Repository &mdash; Backing</a></li>
332333
 <li><a href="fiveminutes.wiki"><b>Up and Running in 5 Minutes as a Single User</b></a></li>
334
+<li><a href="co-vs-up.md">Update &mdash; Checkout vs</a></li>
333335
 <li><a href="hints.wiki">Usage Hints &mdash; Fossil Tips And</a></li>
334336
 <li><a href="javascript.md"><b>Use of JavaScript in Fossil</b></a></li>
335337
 <li><a href="fiveminutes.wiki">User &mdash; Up and Running in 5 Minutes as a Single</a></li>
336338
 <li><a href="caps/">User Capabilities &mdash; Administering</a></li>
337339
 <li><a href="caps/ref.html"><b>User Capability Reference</b></a></li>
@@ -342,10 +344,11 @@
342344
 <li><a href="whyusefossil.wiki">Version Control &mdash; Benefits Of</a></li>
343345
 <li><a href="checkin_names.wiki">Version Names &mdash; Check-in And</a></li>
344346
 <li><a href="fossil-v-git.wiki">Versus Git &mdash; Fossil</a></li>
345347
 <li><a href="image-format-vs-repo-size.md">vs Fossil Repo Size &mdash; Image Format</a></li>
346348
 <li><a href="grep.md">vs POSIX grep &mdash; Fossil grep</a></li>
349
+<li><a href="co-vs-up.md">vs Update &mdash; Checkout</a></li>
347350
 <li><a href="webui.wiki">Web Interface &mdash; The Fossil</a></li>
348351
 <li><a href="customskin.md">Web Pages &mdash; Theming: Customizing The Appearance of</a></li>
349352
 <li><a href="webpage-ex.md"><b>Webpage Examples</b></a></li>
350353
 <li><a href="../../../help">Webpages &mdash; Lists of Commands and</a></li>
351354
 <li><a href="quotes.wiki">What People Are Saying About Fossil, Git, and DVCSes in General &mdash; Quotes:</a></li>
352355
--- www/permutedindex.html
+++ www/permutedindex.html
@@ -63,10 +63,11 @@
63 <li><a href="checkin.wiki"><b>Check-in Checklist</b></a></li>
64 <li><a href="ckout-workflows.md"><b>Check-Out Workflows</b></a></li>
65 <li><a href="checkin.wiki">Checklist &mdash; Check-in</a></li>
66 <li><a href="../test/release-checklist.wiki">Checklist &mdash; Pre-Release Testing</a></li>
67 <li><a href="foss-cklist.wiki"><b>Checklist For Successful Open-Source Projects</b></a></li>
 
68 <li><a href="selfcheck.wiki">Checks &mdash; Fossil Repository Integrity Self</a></li>
69 <li><a href="childprojects.wiki"><b>Child Projects</b></a></li>
70 <li><a href="hashpolicy.wiki">Choosing Between SHA1 and SHA3-256 &mdash; Hash Policy:</a></li>
71 <li><a href="chroot.md">Chroot Jail &mdash; Server</a></li>
72 <li><a href="contribute.wiki">Code or Documentation To The Fossil Project &mdash; Contributing</a></li>
@@ -328,10 +329,11 @@
328 <li><a href="gitusers.md">Translation Guide &mdash; Git to Fossil</a></li>
329 <li><a href="css-tricks.md">Tricks &mdash; Fossil CSS Tips and</a></li>
330 <li><a href="unvers.wiki"><b>Unversioned Files</b></a></li>
331 <li><a href="backup.md">Up a Remote Fossil Repository &mdash; Backing</a></li>
332 <li><a href="fiveminutes.wiki"><b>Up and Running in 5 Minutes as a Single User</b></a></li>
 
333 <li><a href="hints.wiki">Usage Hints &mdash; Fossil Tips And</a></li>
334 <li><a href="javascript.md"><b>Use of JavaScript in Fossil</b></a></li>
335 <li><a href="fiveminutes.wiki">User &mdash; Up and Running in 5 Minutes as a Single</a></li>
336 <li><a href="caps/">User Capabilities &mdash; Administering</a></li>
337 <li><a href="caps/ref.html"><b>User Capability Reference</b></a></li>
@@ -342,10 +344,11 @@
342 <li><a href="whyusefossil.wiki">Version Control &mdash; Benefits Of</a></li>
343 <li><a href="checkin_names.wiki">Version Names &mdash; Check-in And</a></li>
344 <li><a href="fossil-v-git.wiki">Versus Git &mdash; Fossil</a></li>
345 <li><a href="image-format-vs-repo-size.md">vs Fossil Repo Size &mdash; Image Format</a></li>
346 <li><a href="grep.md">vs POSIX grep &mdash; Fossil grep</a></li>
 
347 <li><a href="webui.wiki">Web Interface &mdash; The Fossil</a></li>
348 <li><a href="customskin.md">Web Pages &mdash; Theming: Customizing The Appearance of</a></li>
349 <li><a href="webpage-ex.md"><b>Webpage Examples</b></a></li>
350 <li><a href="../../../help">Webpages &mdash; Lists of Commands and</a></li>
351 <li><a href="quotes.wiki">What People Are Saying About Fossil, Git, and DVCSes in General &mdash; Quotes:</a></li>
352
--- www/permutedindex.html
+++ www/permutedindex.html
@@ -63,10 +63,11 @@
63 <li><a href="checkin.wiki"><b>Check-in Checklist</b></a></li>
64 <li><a href="ckout-workflows.md"><b>Check-Out Workflows</b></a></li>
65 <li><a href="checkin.wiki">Checklist &mdash; Check-in</a></li>
66 <li><a href="../test/release-checklist.wiki">Checklist &mdash; Pre-Release Testing</a></li>
67 <li><a href="foss-cklist.wiki"><b>Checklist For Successful Open-Source Projects</b></a></li>
68 <li><a href="co-vs-up.md"><b>Checkout vs Update</b></a></li>
69 <li><a href="selfcheck.wiki">Checks &mdash; Fossil Repository Integrity Self</a></li>
70 <li><a href="childprojects.wiki"><b>Child Projects</b></a></li>
71 <li><a href="hashpolicy.wiki">Choosing Between SHA1 and SHA3-256 &mdash; Hash Policy:</a></li>
72 <li><a href="chroot.md">Chroot Jail &mdash; Server</a></li>
73 <li><a href="contribute.wiki">Code or Documentation To The Fossil Project &mdash; Contributing</a></li>
@@ -328,10 +329,11 @@
329 <li><a href="gitusers.md">Translation Guide &mdash; Git to Fossil</a></li>
330 <li><a href="css-tricks.md">Tricks &mdash; Fossil CSS Tips and</a></li>
331 <li><a href="unvers.wiki"><b>Unversioned Files</b></a></li>
332 <li><a href="backup.md">Up a Remote Fossil Repository &mdash; Backing</a></li>
333 <li><a href="fiveminutes.wiki"><b>Up and Running in 5 Minutes as a Single User</b></a></li>
334 <li><a href="co-vs-up.md">Update &mdash; Checkout vs</a></li>
335 <li><a href="hints.wiki">Usage Hints &mdash; Fossil Tips And</a></li>
336 <li><a href="javascript.md"><b>Use of JavaScript in Fossil</b></a></li>
337 <li><a href="fiveminutes.wiki">User &mdash; Up and Running in 5 Minutes as a Single</a></li>
338 <li><a href="caps/">User Capabilities &mdash; Administering</a></li>
339 <li><a href="caps/ref.html"><b>User Capability Reference</b></a></li>
@@ -342,10 +344,11 @@
344 <li><a href="whyusefossil.wiki">Version Control &mdash; Benefits Of</a></li>
345 <li><a href="checkin_names.wiki">Version Names &mdash; Check-in And</a></li>
346 <li><a href="fossil-v-git.wiki">Versus Git &mdash; Fossil</a></li>
347 <li><a href="image-format-vs-repo-size.md">vs Fossil Repo Size &mdash; Image Format</a></li>
348 <li><a href="grep.md">vs POSIX grep &mdash; Fossil grep</a></li>
349 <li><a href="co-vs-up.md">vs Update &mdash; Checkout</a></li>
350 <li><a href="webui.wiki">Web Interface &mdash; The Fossil</a></li>
351 <li><a href="customskin.md">Web Pages &mdash; Theming: Customizing The Appearance of</a></li>
352 <li><a href="webpage-ex.md"><b>Webpage Examples</b></a></li>
353 <li><a href="../../../help">Webpages &mdash; Lists of Commands and</a></li>
354 <li><a href="quotes.wiki">What People Are Saying About Fossil, Git, and DVCSes in General &mdash; Quotes:</a></li>
355

Keyboard Shortcuts

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