19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
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
|
* Any fossil command is acceptable once enough of it has been
entered to make the intent unambiguous. 'clo' is a proper prefix of
both the 'clone' and 'close' commands, for instance, but 'clon' is
enough to make the intent—the 'clone'
command—unambiguous.
* Pragmatically, a [ | <u>version</u>] in <b>fossil</b> is a
40-character long string of hexadecimal. <b>fossil</b> will be
able to figure out which version you want with any
<i>distinct</i> prefix of that string which is at least four
characters long. <em>Commands which require a version are
looking for the string, a distinct prefix of the string, or a
<code>tag</code>.</em>
* SCM in a distributed environment can be a bit confusing with
regard to branching, merging, and versions in general. See the
[./branching.wiki | explanation of branching] and it will all make
much more sense.
You should probably start interacting with fossil at the command
line by asking it what it can
do: <a name="tof">ˆ</a>
<code>$ fossil help</code><nowiki><pre>
Usage: fossil help COMMAND.
Available COMMANDs:</pre><table width="80%"
style="font-family: fixed, courier, monospace;">
<tr>
<td><a href="#add">add</a>*</td>
<td><a href="#configuration">configuration</a></td>
<td><a href="#leaves">leaves</a></td>
<td><a href="#redo">redo</a></td>
<td><a href="#timeline">timeline</a></td>
</tr>
<tr>
<td><a href="#all">all</a>*</td>
<td><a href="#deconstruct">deconstruct</a></td>
<td><a href="#ls">ls</a>*</td>
<td><a href="#mv">rename</a>*</td>
<td><a href="#server">ui</a></td>
</tr>
<tr>
<td><a href="#cgi">cgi</a>*</td>
<td><a href="#rm">del</a>*</td>
<td><a href="#merge">merge</a></td>
<td><a href="#revert">revert</a></td>
<td><a href="#undo">undo</a></td>
</tr>
<tr>
<td><a href="#changes">changes</a>*</td>
<td><a href="#descendants">descendants</a></td>
<td><a href="#mv">mv</a>*</td>
<td><a href="#rm">rm</a>*</td>
<td><a href="#setting">unset</a></td>
</tr>
<tr>
<td><a href="#checkout">checkout</a>*</td>
<td><a href="#diff">diff</a></td>
<td><a href="#new">new</a>*</td>
<td><a href="#rstats">rstats</a></td>
<td><a href="#update">update</a>*</td>
</tr>
<tr>
<td><a href="#commit">ci</a></td>
<td><a href="#extra">extra</a>*</td>
<td><a href="#open">open</a></td>
<td><a href="#server">server</a></td>
<td><a href="#user">user</a></td>
</tr>
<tr>
<td><a href="#clean">clean</a></td>
<td><a href="#diff">gdiff</a></td>
<td><a href="#pull">pull</a></td>
<td><a href="#setting">settings</a></td>
<td><a href="#version">version</a>*</td>
</tr>
<tr>
<td><a href="#clone">clone</a></td>
<td><a href="#help">help</a></td>
<td><a href="#push">push</a></td>
<td><a href="#status">status</a>*</td>
<td><a href="#wiki">wiki</a></td>
</tr>
<tr>
<td><a href="#close">close</a></td>
<td><a href="#http">http</a></td>
<td><a href="#rebuild">rebuild</a></td>
<td><a href="#sync">sync</a>*</td>
</tr>
<tr>
<td><a href="#commit">commit</a></td>
<td><a href="#info">info</a></td>
<td><a href="#reconstruct">reconstruct</a></td>
<td><a href="#tag">tag</a></td>
</tr>
</table><nowiki><pre>
This is fossil version [b12a031557] 2008-12-26 17:41:09 UTC
|
|
|
|
|
|
|
|
>
>
>
>
>
>
>
>
>
>
>
>
|
|
|
>
>
>
>
>
>
>
>
>
>
>
>
>
>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<
<
<
<
<
<
<
<
<
<
<
<
|
|
|
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
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
|
* Any fossil command is acceptable once enough of it has been
entered to make the intent unambiguous. 'clo' is a proper prefix of
both the 'clone' and 'close' commands, for instance, but 'clon' is
enough to make the intent—the 'clone'
command—unambiguous.
* Pragmatically, a [./concepts.wiki#keyconc | <u>version</u>]
in <b>fossil</b> is a 40-character long string of hexadecimal.
<b>fossil</b> will be able to figure out which version you want
with any <i>distinct</i> prefix of that string which is at
least four characters long. <em>Commands which require a
version are looking for the string, a distinct prefix of the
string, or a <code>tag</code>.</em>
* SCM in a distributed environment can be a bit confusing with
regard to branching, merging, and versions in general. See the
[./branching.wiki | explanation of branching] and it will all make
much more sense.
* <i>Op.Ed.</i> An excellent way to learn to use <b>fossil</b>
effectively is to
[./quickstart.wiki#fslclone | clone the repository for fossil]
itself. You can then poke around using the <code>fossil ui</code>
command, and look things up with no connection worries. You can
set up test repositories and try things out on-the-fly to see how
they work, using their own ui's. The CLI will far easier to
understand if you can run a repository, watch it in a browser, and
hack around with it in a simplified environment (your tests) with
guaranteed and fast access to the sources & docs (your cloned fossil
repository).
<br /><br /> <br />
<b>You should</b> probably start interacting with fossil at the command
line by asking it what it can
do: <a name="tof">ˆ</a>
<code>$ fossil help</code><nowiki><pre>
Usage: fossil help COMMAND.
Available COMMANDs:</pre><table width="80%"
style="font-family: fixed, courier, monospace;">
<tr>
<td><a href="#add">add</a>*</td>
<td><a href="#checkout">co</a>*</td>
<td><a href="#http">http</a></td>
<td><a href="#rebuild">rebuild</a></td>
<td><a href="#sync">sync</a>*</td>
</tr>
<tr>
<td><a href="#all">all</a>*</td>
<td><a href="#commit">commit</a></td>
<td><a href="#info">info</a></td>
<td><a href="#reconstruct">reconstruct</a></td>
<td><a href="#tag">tag</a></td>
</tr>
<tr>
<td><a href="#branch">branch</a></td>
<td><a href="#configuration">configuration</a></td>
<td><a href="#leaves">leaves</a></td>
<td><a href="#redo">redo</a></td>
<td><a href="#timeline">timeline</a></td>
</tr>
<tr>
<td><a href="#cgi">cgi</a>*</td>
<td><a href="#deconstruct">deconstruct</a></td>
<td><a href="#ls">ls</a>*</td>
<td><a href="#mv">rename</a>*</td>
<td><a href="#server">ui</a></td>
</tr>
<tr>
<td><a href="#changes">changes</a>*</td>
<td><a href="#rm">del</a>*</td>
<td><a href="#merge">merge</a></td>
<td><a href="#revert">revert</a></td>
<td><a href="#undo">undo</a></td>
</tr>
<tr>
<td><a href="#checkout">checkout</a>*</td>
<td><a href="#descendants">descendants</a></td>
<td><a href="#mv">mv</a>*</td>
<td><a href="#rm">rm</a>*</td>
<td><a href="#setting">unset</a></td>
</tr>
<tr>
<td><a href="#commit">ci</a></td>
<td><a href="#diff">diff</a></td>
<td><a href="#new">new</a>*</td>
<td><a href="#rstats">rstats</a></td>
<td><a href="#update">update</a>*</td>
</tr>
<tr>
<td><a href="#clean">clean</a></td>
<td><a href="#extra">extra</a>*</td>
<td><a href="#open">open</a></td>
<td><a href="#server">server</a></td>
<td><a href="#user">user</a></td>
</tr>
<tr>
<td><a href="#clone">clone</a></td>
<td><a href="#diff">gdiff</a></td>
<td><a href="#pull">pull</a></td>
<td><a href="#setting">settings</a></td>
<td><a href="#version">version</a>*</td>
</tr>
<tr>
<td><a href="#close">close</a></td>
<td><a href="#help">help</a></td>
<td><a href="#push">push</a></td>
<td><a href="#status">status</a>*</td>
<td><a href="#wiki">wiki</a></td>
</tr>
</table><nowiki><pre>
This is fossil version [a89b436bc9] 2009-02-11 05:00:02 UTC
</pre>
<b>What follows</b> is a survey of what you get if you type<code>
fossil help <i>command</i> </code>for all of the
commands listed above. There are links to individual pages for each
of them; pages with content (commands marked with a '*' are done) go
into the reason for a command in a bit more depth than the program help.
<pre>
|
142
143
144
145
146
147
148
149
150
151
152
153
154
155
|
rebuild Rebuild on all repositories
sync Run a "sync" on all repositories
Respositories are automatically added to the set of known repositories
when one of the following commands against the repository: clone, info,
pull, push, or sync
<hr><a href="#tof">ˆ</a>
<a name="cgi">Usage: </a><a href="cmd_cgi.wiki">fossil cgi</a> SCRIPT
The SCRIPT argument is the name of a file that is the CGI script
that is being run. The command name, "cgi", may be omitted if
the GATEWAY_INTERFACE environment variable is set to "CGI" (which
should always be the case for CGI scripts run by a webserver.) The
|
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
|
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
|
rebuild Rebuild on all repositories
sync Run a "sync" on all repositories
Respositories are automatically added to the set of known repositories
when one of the following commands against the repository: clone, info,
pull, push, or sync
<hr><a href="#tof">ˆ</a>
<a name="branch">Usage: </a><code><a href="cmd_branch.wiki">fossil branch</a></code> SUBCOMMAND ... ?-R|--repository FILE?
Run various subcommands on the branches of the open repository or
of the repository identified by the -R or --repository option.
fossil branch new BRANCH-NAME BASIS ?-bgcolor COLOR?
Create a new branch BRANCH-NAME off of check-in BASIS.
You can optionally give the branch a default color.
fossil branch list
List all branches
<hr><a href="#tof">ˆ</a>
<a name="cgi">Usage: </a><a href="cmd_cgi.wiki">fossil cgi</a> SCRIPT
The SCRIPT argument is the name of a file that is the CGI script
that is being run. The command name, "cgi", may be omitted if
the GATEWAY_INTERFACE environment variable is set to "CGI" (which
should always be the case for CGI scripts run by a webserver.) The
|