88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
|
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
|
-
-
+
+
+
+
+
-
+
+
+
-
+
-
-
+
+
-
+
+
-
+
-
+
-
+
+
+
+
+
-
-
+
+
+
-
+
|
[ckwf]: ./ckout-workflows.md
[co]: /help?cmd=checkout
#### <a id="pullup"></a> Update vs Pull
The closest equivalent to [`git pull`][gpull] is [`fossil up`][up],
since Fossil tends to follow the CVS command design: `cvs up` pulls
The closest equivalent to [`git pull`][gpull] is not
[`fossil pull`][fpull], but in fact [`fossil up`][up].
This is because
Fossil tends to follow the CVS command design: `cvs up` pulls
changes from the central CVS repository and merges them into the local
working directory, so that’s what `fossil up` does, too.
working directory, so that’s what `fossil up` does, too. (This design
choice also tends to make Fossil feel comfortable to Subversion
expatriates.)
There is a `fossil pull` command, but it is simply the reverse of
The `fossil pull` command is simply the reverse of
`fossil push`, so that `fossil sync` [is functionally equivalent
to](./sync.wiki#sync):
fossil push ; fossil pull
There is no “and update the local working directory” step in Fossil’s
push, pull, or sync commands, as with `git pull`.
There is no implicit “and update the local working directory” step in Fossil’s
push, pull, or sync commands, as there is with `git pull`.
This makes `fossil up` dual-use:
checkout to the tip of the current branch.
checkout to the tip of the current branch, like `git pull`.
* With that argument, it updates to the named version. If that’s the
* Given a `VERSION` argument, it updates to the named version. If that’s the
name of a branch, it updates to the tip of that branch rather than
the current one.
the current one, like `git checkout BRANCH`.
In fact, these are the same operation, so they’re the same command in
Fossil. The first form simply allows the `VERSION` to be implicit: the
current branch.
We think this is a more sensible command design than `git checkout` vs
`git pull`. ([…vs `git checkout` vs `git checkout`!][gcokoan])
We think this is a more sensible command design than `git pull` vs
`git checkout`. ([…vs `git checkout` vs `git checkout`!][gcokoan])
[fpull]: /help?cmd=pull
[gpull]: https://git-scm.com/docs/git-pull
[gpull]: https://git-scm.com/docs/git-pull
[gcokoan]: https://stevelosh.com/blog/2013/04/git-koans/#s2-one-thing-well
#### <a id="rname"></a> Naming Repositories
The Fossil repository database file can be named anything
you want, with a single exception: if you’re going to use the
|