Fossil SCM

link the new help page to the reference.wiki document

wolfgang 2010-10-08 15:51 wolfgangHelpCmd
Commit 47fd0df0b0e64477d0d91bcca3bd91b8a6931c70
1 file changed +48 -642
+48 -642
--- www/reference.wiki
+++ www/reference.wiki
@@ -50,653 +50,59 @@
5050
<br /><br /> <br />
5151
<b>You should</b> probably start interacting with fossil at the command
5252
line by asking it what it can
5353
do:&nbsp;&nbsp;&nbsp;&nbsp;<a name="tof">&#710;</a>
5454
55
- <code>$ fossil help</code><nowiki><pre>
55
+ <code>$ fossil [/help|help]</code>
56
+
57
+ This will generate output in the form:<pre>
5658
Usage: fossil help COMMAND.
5759
Available COMMANDs:</pre><table width="80%"
5860
style="font-family: fixed, courier, monospace;">
5961
<tr>
60
- <td><a href="#add">add</a>*</td>
61
- <td><a href="#checkout">co</a>*</td>
62
- <td><a href="#http">http</a></td>
63
- <td><a href="#rebuild">rebuild</a></td>
64
- <td><a href="#sync">sync</a>*</td>
65
- </tr>
66
- <tr>
67
- <td><a href="#all">all</a>*</td>
68
- <td><a href="#commit">commit</a></td>
69
- <td><a href="#info">info</a></td>
70
- <td><a href="#reconstruct">reconstruct</a></td>
71
- <td><a href="#tag">tag</a></td>
72
- </tr>
73
- <tr>
74
- <td><a href="#branch">branch</a></td>
75
- <td><a href="#configuration">configuration</a></td>
76
- <td><a href="#leaves">leaves</a></td>
77
- <td><a href="#redo">redo</a></td>
78
- <td><a href="#timeline">timeline</a></td>
79
- </tr>
80
- <tr>
81
- <td><a href="#cgi">cgi</a>*</td>
82
- <td><a href="#deconstruct">deconstruct</a></td>
83
- <td><a href="#ls">ls</a>*</td>
84
- <td><a href="#mv">rename</a>*</td>
85
- <td><a href="#server">ui</a></td>
86
- </tr>
87
- <tr>
88
- <td><a href="#changes">changes</a>*</td>
89
- <td><a href="#rm">del</a>*</td>
90
- <td><a href="#merge">merge</a></td>
91
- <td><a href="#revert">revert</a></td>
92
- <td><a href="#undo">undo</a></td>
93
- </tr>
94
- <tr>
95
- <td><a href="#checkout">checkout</a>*</td>
96
- <td><a href="#descendants">descendants</a></td>
97
- <td><a href="#mv">mv</a>*</td>
98
- <td><a href="#rm">rm</a>*</td>
99
- <td><a href="#setting">unset</a></td>
100
- </tr>
101
- <tr>
102
- <td><a href="#commit">ci</a></td>
103
- <td><a href="#diff">diff</a></td>
104
- <td><a href="#new">new</a>*</td>
105
- <td><a href="#rstats">rstats</a></td>
106
- <td><a href="#update">update</a>*</td>
107
- </tr>
108
- <tr>
109
- <td><a href="#clean">clean</a></td>
110
- <td><a href="#extra">extra</a>*</td>
111
- <td><a href="#open">open</a></td>
112
- <td><a href="#server">server</a></td>
113
- <td><a href="#user">user</a></td>
114
- </tr>
115
- <tr>
116
- <td><a href="#clone">clone</a></td>
117
- <td><a href="#diff">gdiff</a></td>
118
- <td><a href="#pull">pull</a></td>
119
- <td><a href="#setting">settings</a></td>
120
- <td><a href="#version">version</a>*</td>
121
- </tr>
122
- <tr>
123
- <td><a href="#close">close</a></td>
124
- <td><a href="#help">help</a></td>
125
- <td><a href="#push">push</a></td>
126
- <td><a href="#status">status</a>*</td>
127
- <td><a href="#wiki">wiki</a></td>
128
- </tr>
129
-</table><nowiki><pre>
62
+ <td width="20%">[/help?cmd=add|add]</td>
63
+ <td>[/help?cmd=co|co]</td>
64
+ <td width="20%">[/help?cmd=info|info]</td>
65
+ <td width="20%">[/help?cmd=remote-url|remote-url]</td>
66
+ <td width="20%">[/help?cmd=ticket|ticket]</td>
67
+ </tr>
68
+ <tr>
69
+ <td>..</td>
70
+ <td>&nbsp;</td>
71
+ <td>&nbsp;</td>
72
+ <td>&nbsp;</td>
73
+ <td>&nbsp;</td>
74
+ </tr>
75
+</table><pre>
13076
This is fossil version [a89b436bc9] 2009-02-11 05:00:02 UTC
13177
</pre>
132
-<b>What follows</b> is a survey of what you get if you type<code>
133
-fossil&nbsp;help&nbsp;<i>command</i> </code>for all of the
134
-commands listed above. There are links to individual pages for each
135
-of them; pages with content (commands marked with a '*' are done) go
136
-into the reason for a command in a bit more depth than the program help.
137
-<pre>
138
-<hr><a href="#tof">&#710;</a>
139
- <a name="add">Usage: </a><code><a href="cmd_add.wiki">fossil add</a></code> FILE...
140
- Make arrangements to add one or more files to the current checkout
141
- at the next commit.
142
-
143
-<hr><a href="#tof">&#710;</a>
144
- <a name="all">Usage: </a><code><a href="cmd_all.wiki">fossil all</a></code> (list|pull|push|rebuild|sync)
145
- The ~/.fossil file records the location of all repositories for a
146
- user. This command performs certain operations on all repositories
147
- that can be useful before or after a period of disconnection operation.
148
-
149
- On Win32 systems, this file is located in %LOCALAPPDATA%, %APDDATA%
150
- or %HOMEPATH% and is named _fossil.
151
-
152
- Available operations are:
153
-
154
- list Display the location of all repositories
155
-
156
- pull Run a "pull" operation on all repositories
157
-
158
- push Run a "push" on all repositories
159
-
160
- rebuild Rebuild on all repositories
161
-
162
- sync Run a "sync" on all repositories
163
-
164
- Respositories are automatically added to the set of known repositories
165
- when one of the following commands against the repository: clone, info,
166
- pull, push, or sync
167
-
168
-<hr><a href="#tof">&#710;</a>
169
- <a name="branch">Usage: </a><code><a href="cmd_branch.wiki">fossil branch</a></code> SUBCOMMAND ... ?-R|--repository FILE?
170
-
171
-Run various subcommands on the branches of the open repository or
172
-of the repository identified by the -R or --repository option.
173
-
174
- fossil branch new BRANCH-NAME BASIS ?-bgcolor COLOR?
175
-
176
- Create a new branch BRANCH-NAME off of check-in BASIS.
177
- You can optionally give the branch a default color.
178
-
179
- fossil branch list
180
-
181
- List all branches
182
-
183
-<hr><a href="#tof">&#710;</a>
184
- <a name="cgi">Usage: </a><a href="cmd_cgi.wiki">fossil cgi</a> SCRIPT
185
- The SCRIPT argument is the name of a file that is the CGI script
186
- that is being run. The command name, "cgi", may be omitted if
187
- the GATEWAY_INTERFACE environment variable is set to "CGI" (which
188
- should always be the case for CGI scripts run by a webserver.) The
189
- SCRIPT file should look something like this:
190
-
191
- #!/usr/bin/fossil
192
- repository: /home/somebody/project.db
193
-
194
- The second line defines the name of the repository. After locating
195
- the repository, fossil will generate a webpage on stdout based on
196
- the values of standard CGI environment variables.
197
-
198
-<hr><a href="#tof">&#710;</a>
199
- <a name="changes">Usage: </a><a href="cmd_changes.wiki">fossil changes</a>
200
- Report on the edit status of all files in the current checkout.
201
- See also the "status" and "extra" commands.
202
-
203
-<hr><a href="#tof">&#710;</a>
204
- <a name="checkout">Usage: </a><a href="cmd_checkout.wiki">fossil checkout</a> VERSION ?-f|--force?
205
- Check out a version specified on the command-line. This command
206
- will not overwrite edited files in the current checkout unless
207
- the --force option appears on the command-line.
208
-
209
- See also the "update" command.
210
-
211
-<hr><a href="#tof">&#710;</a>
212
- <a name="commit">Usage: </a><a href="cmd_commit.wiki">fossil commit</a> ?-m COMMENT? ?--nosign? ?FILE...? fossil ci ... (as above)
213
-
214
- Create a new version containing all of the changes in the current
215
- checkout. You will be prompted to enter a check-in comment unless
216
- the "-m" option is used to specify a comment line. You will be
217
- prompted for your GPG passphrase in order to sign the new manifest
218
- unless the "--nosign" option is used. All files that have
219
- changed will be committed unless some subset of files is specified
220
- on the command line.
221
-
222
-<hr><a href="#tof">&#710;</a>
223
- <a name="clean">Usage: </a><a href="cmd_clean.wiki">fossil clean</a> ?-all?
224
- Delete all "extra" files in the source tree. "Extra" files are
225
- files that are not officially part of the checkout. See also
226
- the "extra" command. This operation cannot be undone.
227
-
228
- You will be prompted before removing each file. If you are
229
- sure you wish to remove all "extra" files you can specify the
230
- optional -all flag.
231
-
232
-<hr><a href="#tof">&#710;</a>
233
- <a name="clone">Usage: </a><a href="cmd_clone.wiki">fossil clone</a> URL FILENAME
234
- Make a clone of a repository specified by URL in the local
235
- file named FILENAME.
236
-
237
-<hr><a href="#tof">&#710;</a>
238
- <a name="close">Usage: </a><a href="cmd_close.wiki">fossil close</a> ?-f|--force?
239
- The opposite of "open". Close the current database connection.
240
- Require a -f or --force flag if there are unsaved changed in the
241
- current check-out.
242
-
243
-<hr><a href="#tof">&#710;</a>
244
- <a name="configuration">Usage: </a><a href="cmd_configure.wiki">fossil configuration</a> METHOD ...
245
- Where METHOD is one of: export import merge pull push reset. All methods
246
- accept the -R or --repository option to specific a repository.
247
-
248
- fossil configuration export AREA FILENAME
249
-
250
- Write to FILENAME exported configuraton information for AREA.
251
- AREA can be one of: all ticket skin project
252
-
253
- fossil configuration import FILENAME
254
-
255
- Read a configuration from FILENAME, overwriting the current
256
- configuration.
257
-
258
- fossil configuration merge FILENAME
259
-
260
- Read a configuration from FILENAME and merge its values into
261
- the current configuration. Existing values take priority over
262
- values read from FILENAME.
263
-
264
- fossil configuration pull AREA ?URL?
265
-
266
- Pull and install the configuration from a different server
267
- identified by URL. If no URL is specified, then the default
268
- server is used.
269
- fossil configuration push AREA ?URL?
270
-
271
- Push the local configuration into the remote server identified
272
- by URL. Admin privilege is required on the remote server for
273
- this to work.
274
-
275
- fossil configuration reset AREA
276
-
277
- Restore the configuration to the default. AREA as above.
278
-
279
- WARNING: Do not import, merge, or pull configurations from an untrusted
280
- source. The inbound configuration is not checked for safety and can
281
- introduce security vulnerabilities.
282
-
283
-<hr><a href="#tof">&#710;</a>
284
- COMMAND: deconstruct
285
- <a name="deconstruct">Usage: </a><a href="cmd_deconstruct.wiki">fossil deconstruct</a> ?-R|--repository REPOSITORY? DESTINATION
286
- Populates the indicated DESTINATION directory with copies of all
287
- artifcats contained within the repository. Artifacts are named AA/bbbbb
288
- where AA is the first 2 characters of the artifact ID and bbbbb is the
289
- remaining 38 characters.
290
-
291
-<hr><a href="#tof">&#710;</a>
292
- <a name="rm">Usage: </a><a href="cmd_rm.wiki">fossil rm</a> FILE... or: fossil del FILE...
293
- Remove one or more files from the tree.
294
-
295
-<hr><a href="#tof">&#710;</a>
296
- <a name="descendants">Usage: </a><a href="cmd_descendants.wiki">fossil descendants</a> ?CHECKIN-ID?
297
- Find all leaf descendants of the check-in specified or if the argument
298
- is omitted, of the check-in currently checked out.
299
-
300
-<hr><a href="#tof">&#710;</a>
301
- <a name="diff">Usage: </a><a href="cmd_diff.wiki">fossil diff</a>|gdiff ?-i? ?-r REVISION? FILE...
302
- Show the difference between the current version of a file (as it
303
- exists on disk) and that same file as it was checked out.
304
-
305
- diff will show a textual diff while gdiff will attempt to run a
306
- graphical diff command that you have setup. If the choosen command
307
- is not yet configured, the internal textual diff command will be
308
- used.
309
-
310
- If -i is supplied for either diff or gdiff, the internal textual
311
- diff command will be executed.
312
-
313
- Here are a few external diff command settings, for example:
314
-
315
- fossil setting diff-command diff
316
-
317
- fossil setting gdiff-command tkdiff
318
- fossil setting gdiff-command eskill22
319
- fossil setting gdiff-command tortoisemerge
320
- fossil setting gdiff-command meld
321
- fossil setting gdiff-command xxdiff
322
- fossil setting gdiff-command kdiff3
323
-
324
-<hr><a href="#tof">&#710;</a>
325
- <a name="extra">Usage: </a><a href="cmd_extra.wiki">fossil extra</a>
326
- Print a list of all files in the source tree that are not part of
327
- the current checkout. See also the "clean" command.
328
-
329
-<hr><a href="#tof">&#710;</a>
330
- <a name="help">Usage: </a><a href="cmd_help.wiki">fossil help</a> COMMAND
331
- Display information on how to use COMMAND
332
-
333
-<hr><a href="#tof">&#710;</a>
334
- <a name="http">Usage: </a><a href="cmd_http.wiki">fossil http</a> REPOSITORY
335
- Handle a single HTTP request appearing on stdin. The resulting webpage
336
- is delivered on stdout. This method is used to launch an HTTP request
337
- handler from inetd, for example. The argument is the name of the repository.
338
-
339
-<hr><a href="#tof">&#710;</a>
340
- <a name="info">Usage: </a><a href="cmd_info.wiki">fossil info</a> ?ARTIFACT-ID|FILENAME?
341
- With no arguments, provide information about the current tree.
342
- If an argument is specified, provide information about the object
343
- in the respository of the current tree that the argument refers
344
- to. Or if the argument is the name of a repository, show
345
- information about that repository.
346
-
347
-<hr><a href="#tof">&#710;</a>
348
- <a name="leaves">Usage: </a><a href="cmd_leaves.wiki">fossil leaves</a>
349
- Find leaves of all branches.
350
-
351
-<hr><a href="#tof">&#710;</a>
352
- <a name="ls">Usage: </a><a href="cmd_ls.wiki">fossil ls</a>
353
- Show the names of all files in the current checkout
354
-
355
-<hr><a href="#tof">&#710;</a>
356
- <a name="merge">Usage: </a><a href="cmd_merge.wiki">fossil merge</a> VERSION
357
- The argument is a version that should be merged into the current
358
- checkout.
359
- Only file content is merged. The result continues to use the
360
- file and directory names from the current check-out even if those
361
- names might have been changed in the branch being merged in.
362
-
363
-<hr><a href="#tof">&#710;</a>
364
- <a name="mv">Usage: </a><a href="cmd_mv.wiki">fossil mv|rename</a> OLDNAME NEWNAME or: fossil mv|rename OLDNAME... DIR
365
-
366
- Move or rename one or more files within the tree
367
-
368
- This command does not rename the files on disk. All this command does is
369
- record the fact that filenames have changed so that appropriate notations
370
- can be made at the next commit/checkin.
371
-
372
-<hr><a href="#tof">&#710;</a>
373
- <a name="new">Usage: </a><a href="cmd_new.wiki">fossil new</a> FILENAME
374
-
375
- Create a repository for a new project in the file named FILENAME.
376
- This command is distinct from "clone". The "clone" command makes
377
- a copy of an existing project. This command starts a new project.
378
-
379
-<hr><a href="#tof">&#710;</a>
380
- <a name="open">Usage: </a><a href="cmd_open.wiki">fossil open</a> FILENAME
381
- Open a connection to the local repository in FILENAME. A checkout
382
- for the repository is created with its root at the working directory.
383
- See also the "close" command.
384
-
385
-<hr><a href="#tof">&#710;</a>
386
- <a name="rstats">Usage: </a><a href="cmd_rstats.wiki">fossil rstats</a>
387
-
388
- Deliver a report of the repository statistics for the
389
- current checkout.
390
-
391
-<hr><a href="#tof">&#710;</a>
392
- <a name="pull">Usage: </a><a href="cmd_pull.wiki">fossil pull</a> ?URL? ?-R|--respository REPOSITORY?
393
- Pull changes in a remote repository into the local repository.
394
- The repository is identified by the -R or --repository option.
395
- If there is no such option then the open repository is used.
396
- The URL of the remote server is specified on the command line
397
- If no URL is specified then the URL used by the most recent
398
- "pull", "push", or "sync" command is used.
399
-
400
- The URL is of the following form:
401
-
402
- http://USER@HOST:PORT/PATH
403
-
404
- The "USER@" and ":PORT" substrings are optional.
405
- The "USER" substring specifies the login user. You will be
406
- prompted for the password on the command-line. The PORT
407
- specifies the TCP port of the server. The default port is
408
- 80.
409
-
410
-<hr><a href="#tof">&#710;</a>
411
- <a name="push">Usage: </a><a href="cmd_push.wiki">fossil push</a> ?URL? ?-R|--repository REPOSITORY?
412
- Push changes in the local repository over into a remote repository.
413
- See the "pull" command for additional information.
414
-
415
-<hr><a href="#tof">&#710;</a>
416
- <a name="rebuild">Usage: </a><a href="cmd_rebuild.wiki">fossil rebuild</a> REPOSITORY
417
- Reconstruct the named repository database from the core
418
- records. Run this command after updating the fossil
419
- executable in a way that changes the database schema.
420
-
421
-<hr><a href="#tof">&#710;</a>
422
- COMMAND: reconstruct
423
- <a name="reconstruct">Usage: </a><a href="cmd_reconstruct.wiki">fossil reconstruct</a> REPOSITORY ORIGIN
424
- Creates the REPOSITORY and populates it with the artifacts in the
425
- indicated ORIGIN directory.
426
-
427
-<hr><a href="#tof">&#710;</a>
428
- <a name="redo">Usage: </a><a href="cmd_redo.wiki">fossil redo</a> ?FILENAME...?
429
- Redo the an update or merge operation that has been undone by the
430
- undo command. If FILENAME is specified then restore the changes
431
- associated with the named file(s) but otherwise leave the update
432
- or merge undone.
433
-
434
- A single level of undo/redo is supported. The undo/redo stack
435
- is cleared by the commit and checkout commands.
436
-
437
-<hr><a href="#tof">&#710;</a>
438
- <a name="revert">Usage: </a><a href="cmd_revert.wiki">fossil revert</a> ?--yes? ?-r CHECKIN? FILE
439
- Revert to the current repository version of FILE, or to
440
- the version associated with check-in CHECKIN if the -r flag
441
- appears. This command will confirm your operation unless the
442
- file is missing or the --yes option is used.
443
-
444
-<hr><a href="#tof">&#710;</a>
445
- <a name="server">Usage: </a><a href="cmd_server.wiki">fossil server</a> ?-P|--port TCPPORT? ?REPOSITORY? Or: fossil ui ?-P|--port TCPPORT? ?REPOSITORY?
446
-
447
- Open a socket and begin listening and responding to HTTP requests on
448
- TCP port 8080, or on any other TCP port defined by the -P or
449
- --port option. The optional argument is the name of the repository.
450
- The repository argument may be omitted if the working directory is
451
- within an open checkout.
452
-
453
- The "ui" command automatically starts a web browser after initializing
454
- the web server.
455
-
456
-<hr><a href="#tof">&#710;</a>
457
- COMMAND: settings
458
- COMMAND: unset
459
- <a name="settings">Usage: </a><a href="cmd_setting.wiki">fossil settings</a> ?PROPERTY? ?VALUE? ?-global?
460
- fossil unset PROPERTY ?-global?
461
-
462
- The "settings" command with no arguments lists all properties and their
463
- values. With just a property name it shows the value of that property.
464
- With a value argument it changes the property for the current repository.
465
-
466
- The "unset" command clears a property setting.
467
-
468
- autosync If enabled, automatically pull prior to
469
- commit or update and automatically push
470
- after commit or tag or branch creation.
471
-
472
- diff-command External command to run when performing a diff.
473
- If undefined, the internal text diff will be used.
474
-
475
- editor Text editor command used for check-in comments.
476
-
477
- http-port The TCP/IP port number to use by the "server"
478
- and "ui" commands. Default: 8080
479
-
480
- gdiff-command External command to run when performing a graphical
481
- diff. If undefined, text diff will be used.
482
-
483
- localauth If enabled, require that HTTP connections from
484
- 127.0.0.1 be authenticated by password. If
485
- false, all HTTP requests from localhost have
486
- unrestricted access to the repository.
487
-
488
- clearsign When enabled (the default), fossil will attempt to
489
- sign all commits with gpg. When disabled, commits will
490
- be unsigned.
491
-
492
- pgp-command Command used to clear-sign manifests at check-in.
493
- The default is "gpg --clearsign -o ".
494
-
495
- mtime-changes Use file modification times (mtimes) to detect when
496
- files have been modified.
497
-
498
- proxy URL of the HTTP proxy. If undefined or "on" then
499
- the "http_proxy" environment variable is consulted.
500
- If the http_proxy environment variable is undefined
501
- then a direct HTTP connection is used.
502
-
503
- web-browser A shell command used to launch your preferred
504
- web browser when given a URL as an argument.
505
- Defaults to "start" on windows, "open" on Mac,
506
- and "firefox" on Unix.
507
-
508
-<hr><a href="#tof">&#710;</a>
509
- <a name="status">Usage: </a><a href="cmd_status.wiki">fossil status</a>
510
- Report on the status of the current checkout.
511
-
512
-<hr><a href="#tof">&#710;</a>
513
- <a name="sync">Usage: </a><a href="cmd_sync.wiki">fossil sync</a> ?URL? ?-R|--repository REPOSITORY?
514
- Synchronize the local repository with a remote repository. This is
515
- the equivalent of running both "push" and "pull" at the same time.
516
- See the "pull" command for additional information.
517
-
518
-<hr><a href="#tof">&#710;</a>
519
- <a name="tag">Usage: </a><a href="cmd_tag.wiki">fossil tag</a> SUBCOMMAND ...
520
- Run various subcommands to control tags and properties
521
-
522
- fossil tag add ?--raw? TAGNAME CHECK-IN ?VALUE?
523
-
524
- Add a new tag or property to CHECK-IN. The tag will
525
- be usable instead of a CHECK-IN in commands such as
526
- update and merge.
527
-
528
- fossil tag branch ?--raw? ?--nofork? TAGNAME CHECK-IN ?VALUE?
529
-
530
- A fork will be created so that the new checkin
531
- is a sibling of CHECK-IN and identical to it except
532
- for a generated comment. Then the new tag will
533
- be added to the new checkin and propagated to
534
- all direct children. Additionally all symbolic
535
- tags of that checkin inherited from CHECK-IN will
536
- be cancelled.
537
-
538
- However, if the option --nofork is given, no
539
- fork will be created and the tag/property will be
540
- added to CHECK-IN directly. No tags will be canceled.
541
-
542
- fossil tag cancel ?--raw? TAGNAME CHECK-IN
543
-
544
- Remove the tag TAGNAME from CHECK-IN, and also remove
545
- the propagation of the tag to any descendants.
546
-
547
- fossil tag find ?--raw? TAGNAME
548
-
549
- List all check-ins that use TAGNAME
550
-
551
- fossil tag list ?--raw? ?CHECK-IN?
552
-
553
- List all tags, or if CHECK-IN is supplied, list
554
- all tags and their values for CHECK-IN.
555
-
556
- The option --raw allows the manipulation of all types of
557
- tags used for various internal purposes in fossil. You
558
- should not use this option to make changes unless you are
559
- sure what you are doing.
560
-
561
- If you need to use a tagname that might be confused with
562
- a hexadecimal check-in or artifact ID, you can explicitly
563
- disambiguate it by prefixing it with "tag:". For instance:
564
-
565
- fossil update decaf
566
-
567
- will be taken as an artifact or check-in ID and fossil will
568
- probably complain that no such revision was found. However
569
-
570
- fossil update tag:decaf
571
-
572
- will assume that "decaf" is a tag/branch name.
573
-
574
-<hr><a href="#tof">&#710;</a>
575
- <a name="timeline">Usage: </a><a href="cmd_timeline.wiki">fossil timeline</a> ?WHEN? ?CHECK-IN|DATETIME? ?-n|--count N?
576
- Print a summary of activity going backwards in date and time
577
- specified or from the current date and time if no arguments
578
- are given. Show as many as N (default 20) check-ins. The
579
- WHEN argument can be any unique abbreviation of one of these
580
- keywords:
581
-
582
- before
583
- after
584
- descendants | children
585
- ancestors | parents
586
-
587
- The CHECK-IN can be any unique prefix of 4 characters or more.
588
- The DATETIME should be in the ISO8601 format. For
589
- examples: "2007-08-18 07:21:21". You can also say "current"
590
- for the current version or "now" for the current time.
591
-
592
-<hr><a href="#tof">&#710;</a>
593
- <a name="undo">Usage: </a><a href="cmd_undo.wiki">fossil undo</a> ?FILENAME...?
594
- Undo the most recent update or merge operation. If FILENAME is
595
- specified then restore the content of the named file(s) but otherwise
596
- leave the update or merge in effect.
597
-
598
- A single level of undo/redo is supported. The undo/redo stack
599
- is cleared by the commit and checkout commands.
600
-
601
-<hr><a href="#tof">&#710;</a>
602
- <a name="update">Usage: </a><a href="cmd_update.wiki">fossil update</a> ?VERSION? ?--latest?
603
- The optional argument is a version that should become the current
604
- version. If the argument is omitted, then use the leaf of the
605
- tree that begins with the current version, if there is only a single leaf. If there are a multiple leaves, the latest is used
606
- if the --latest flag is present.
607
-
608
- This command is different from the "checkout" in that edits are
609
- not overwritten. Edits are merged into the new version.
610
-
611
-<hr><a href="#tof">&#710;</a>
612
- <a name="user">Usage: </a><a href="cmd_user.wiki">fossil user</a> SUBCOMMAND ... ?-R|--repository FILE?
613
- Run various subcommands on users of the open repository or of
614
- the repository identified by the -R or --repository option.
615
-
616
- fossil user capabilities USERNAME ?STRING?
617
-
618
- Query or set the capabilities for user USERNAME
619
-
620
- fossil user default ?USERNAME?
621
-
622
- Query or set the default user. The default user is the
623
- user for command-line interaction.
624
-
625
- fossil user list
626
-
627
- List all users known to the repository
628
-
629
- fossil user new ?USERNAME?
630
-
631
- Create a new user in the repository. Users can never be
632
- deleted. They can be denied all access but they must continue
633
- to exist in the database.
634
-
635
- fossil user password USERNAME
636
-
637
- Change the web access password for a user.
638
-
639
-<hr><a href="#tof">&#710;</a>
640
- <a name="version">Usage: </a><a href="cmd_version.wiki">fossil version</a>
641
- Print the source code version number for the fossil executable.
642
-
643
-<hr><a href="#tof">&#710;</a>
644
- <a name="wiki">Usage: </a><a href="cmd_wiki.wiki">fossil wiki</a> (export|create|commit|list) WikiName
645
- Run various subcommands to fetch wiki entries.
646
-
647
- fossil wiki export PAGENAME ?FILE?
648
-
649
- Sends the latest version of the PAGENAME wiki
650
- entry to the given file or standard output.
651
-
652
- fossil wiki commit PAGENAME ?FILE?
653
-
654
- Commit changes to a wiki page from FILE or from standard.
655
-
656
- fossil wiki create PAGENAME ?FILE?
657
-
658
- Create a new wiki page with initial content taken from
659
- FILE or from standard input.
660
-
661
- fossil wiki list
662
-
663
- Lists all wiki entries, one per line, ordered
664
- case-insentively by name.
665
-
666
- TODOs:
667
-
668
- fossil wiki export ?-u ARTIFACT? WikiName ?FILE?
669
-
670
- Outputs the selected version of WikiName.
671
-
672
- fossil wiki delete ?-m MESSAGE? WikiName
673
-
674
- The same as deleting a file entry, but i don't know if fossil
675
- supports a commit message for Wiki entries.
676
-
677
- fossil wiki ?-u? ?-d? ?-s=[|]? list
678
-
679
- Lists the artifact ID and/or Date of last change along with
680
- each entry name, delimited by the -s char.
681
-
682
- fossil wiki diff ?ARTIFACT? ?-f infile[=stdin]? EntryName
683
-
684
- Diffs the local copy of a page with a given version (defaulting
685
- to the head version).
686
-
687
- </pre></nowiki>
688
-
689
- <hr><a href="#tof">&#710;</a>
690
-
691
- <h3>Caveats</h3>
692
- This is not actually a reference, it's the start of a reference.
693
- There are wikilinks to uncreated pages for the commands. This was
694
- created by running the fossil help for each command listed by running
695
- fossil help... Duplicate commands are only listed once (I
696
- <i>think</i>). There are several bits of <b>fossil</b> that are not addressed
697
- in the help for commands (special wiki directories, special users, etc.)
698
- so they are (currently) not addressed here. Clarity and brevity may be
699
- sacrificed for expediency at the authors indiscretion. All spelling and
700
- grammatical mistakes are somebody elses fault.<code> void * </code>
701
- prohibited where<code> __C_PLUS_PLUS__ </code>. Title and taxes extra.
702
- Not valid in Hooptigonia.
78
+
79
+
80
+ This information can also viewed in the fossil gui using the url
81
+ PROJEKT-BASEURL/[/help|help]. You'll see a web page, listing all
82
+ available commands in the current fossil build.
83
+
84
+ Each listed command is a link to a web page, displaying the detailed
85
+ command line help for the appropriate command.
86
+
87
+ There are links to individual wiki pages for each command. These pages
88
+ are named <kbd>cmd_<i>COMMAND-NAME</i></kbd>. These pages are not
89
+ defined for all commands - it's a work in progress. Existing pages give
90
+ more detailed description of the corresponding command.
91
+
92
+ <h3>Caveats</h3>
93
+ This reference is complete concerning the [/help|list] of commands
94
+ and the detailed command line reference. It's always in sync with the
95
+ used fossil build, because it uses the original command help, which is
96
+ compiled into the binary.
97
+
98
+ Additional, in-depth information in the wiki part is not available for
99
+ all commands.
100
+
101
+
102
+ There are several bits of <b>fossil</b> that are not addressed
103
+ in the help for commands (special wiki directories, special users, etc.)
104
+ so they are (currently) not addressed here. Clarity and brevity may be
105
+ sacrificed for expediency at the authors indiscretion. All spelling and
106
+ grammatical mistakes are somebody elses fault.<code> void * </code>
107
+ prohibited where<code> __C_PLUS_PLUS__ </code>. Title and taxes extra.
108
+ Not valid in Hooptigonia.
703109
--- www/reference.wiki
+++ www/reference.wiki
@@ -50,653 +50,59 @@
50 <br /><br /> <br />
51 <b>You should</b> probably start interacting with fossil at the command
52 line by asking it what it can
53 do:&nbsp;&nbsp;&nbsp;&nbsp;<a name="tof">&#710;</a>
54
55 <code>$ fossil help</code><nowiki><pre>
 
 
56 Usage: fossil help COMMAND.
57 Available COMMANDs:</pre><table width="80%"
58 style="font-family: fixed, courier, monospace;">
59 <tr>
60 <td><a href="#add">add</a>*</td>
61 <td><a href="#checkout">co</a>*</td>
62 <td><a href="#http">http</a></td>
63 <td><a href="#rebuild">rebuild</a></td>
64 <td><a href="#sync">sync</a>*</td>
65 </tr>
66 <tr>
67 <td><a href="#all">all</a>*</td>
68 <td><a href="#commit">commit</a></td>
69 <td><a href="#info">info</a></td>
70 <td><a href="#reconstruct">reconstruct</a></td>
71 <td><a href="#tag">tag</a></td>
72 </tr>
73 <tr>
74 <td><a href="#branch">branch</a></td>
75 <td><a href="#configuration">configuration</a></td>
76 <td><a href="#leaves">leaves</a></td>
77 <td><a href="#redo">redo</a></td>
78 <td><a href="#timeline">timeline</a></td>
79 </tr>
80 <tr>
81 <td><a href="#cgi">cgi</a>*</td>
82 <td><a href="#deconstruct">deconstruct</a></td>
83 <td><a href="#ls">ls</a>*</td>
84 <td><a href="#mv">rename</a>*</td>
85 <td><a href="#server">ui</a></td>
86 </tr>
87 <tr>
88 <td><a href="#changes">changes</a>*</td>
89 <td><a href="#rm">del</a>*</td>
90 <td><a href="#merge">merge</a></td>
91 <td><a href="#revert">revert</a></td>
92 <td><a href="#undo">undo</a></td>
93 </tr>
94 <tr>
95 <td><a href="#checkout">checkout</a>*</td>
96 <td><a href="#descendants">descendants</a></td>
97 <td><a href="#mv">mv</a>*</td>
98 <td><a href="#rm">rm</a>*</td>
99 <td><a href="#setting">unset</a></td>
100 </tr>
101 <tr>
102 <td><a href="#commit">ci</a></td>
103 <td><a href="#diff">diff</a></td>
104 <td><a href="#new">new</a>*</td>
105 <td><a href="#rstats">rstats</a></td>
106 <td><a href="#update">update</a>*</td>
107 </tr>
108 <tr>
109 <td><a href="#clean">clean</a></td>
110 <td><a href="#extra">extra</a>*</td>
111 <td><a href="#open">open</a></td>
112 <td><a href="#server">server</a></td>
113 <td><a href="#user">user</a></td>
114 </tr>
115 <tr>
116 <td><a href="#clone">clone</a></td>
117 <td><a href="#diff">gdiff</a></td>
118 <td><a href="#pull">pull</a></td>
119 <td><a href="#setting">settings</a></td>
120 <td><a href="#version">version</a>*</td>
121 </tr>
122 <tr>
123 <td><a href="#close">close</a></td>
124 <td><a href="#help">help</a></td>
125 <td><a href="#push">push</a></td>
126 <td><a href="#status">status</a>*</td>
127 <td><a href="#wiki">wiki</a></td>
128 </tr>
129 </table><nowiki><pre>
130 This is fossil version [a89b436bc9] 2009-02-11 05:00:02 UTC
131 </pre>
132 <b>What follows</b> is a survey of what you get if you type<code>
133 fossil&nbsp;help&nbsp;<i>command</i> </code>for all of the
134 commands listed above. There are links to individual pages for each
135 of them; pages with content (commands marked with a '*' are done) go
136 into the reason for a command in a bit more depth than the program help.
137 <pre>
138 <hr><a href="#tof">&#710;</a>
139 <a name="add">Usage: </a><code><a href="cmd_add.wiki">fossil add</a></code> FILE...
140 Make arrangements to add one or more files to the current checkout
141 at the next commit.
142
143 <hr><a href="#tof">&#710;</a>
144 <a name="all">Usage: </a><code><a href="cmd_all.wiki">fossil all</a></code> (list|pull|push|rebuild|sync)
145 The ~/.fossil file records the location of all repositories for a
146 user. This command performs certain operations on all repositories
147 that can be useful before or after a period of disconnection operation.
148
149 On Win32 systems, this file is located in %LOCALAPPDATA%, %APDDATA%
150 or %HOMEPATH% and is named _fossil.
151
152 Available operations are:
153
154 list Display the location of all repositories
155
156 pull Run a "pull" operation on all repositories
157
158 push Run a "push" on all repositories
159
160 rebuild Rebuild on all repositories
161
162 sync Run a "sync" on all repositories
163
164 Respositories are automatically added to the set of known repositories
165 when one of the following commands against the repository: clone, info,
166 pull, push, or sync
167
168 <hr><a href="#tof">&#710;</a>
169 <a name="branch">Usage: </a><code><a href="cmd_branch.wiki">fossil branch</a></code> SUBCOMMAND ... ?-R|--repository FILE?
170
171 Run various subcommands on the branches of the open repository or
172 of the repository identified by the -R or --repository option.
173
174 fossil branch new BRANCH-NAME BASIS ?-bgcolor COLOR?
175
176 Create a new branch BRANCH-NAME off of check-in BASIS.
177 You can optionally give the branch a default color.
178
179 fossil branch list
180
181 List all branches
182
183 <hr><a href="#tof">&#710;</a>
184 <a name="cgi">Usage: </a><a href="cmd_cgi.wiki">fossil cgi</a> SCRIPT
185 The SCRIPT argument is the name of a file that is the CGI script
186 that is being run. The command name, "cgi", may be omitted if
187 the GATEWAY_INTERFACE environment variable is set to "CGI" (which
188 should always be the case for CGI scripts run by a webserver.) The
189 SCRIPT file should look something like this:
190
191 #!/usr/bin/fossil
192 repository: /home/somebody/project.db
193
194 The second line defines the name of the repository. After locating
195 the repository, fossil will generate a webpage on stdout based on
196 the values of standard CGI environment variables.
197
198 <hr><a href="#tof">&#710;</a>
199 <a name="changes">Usage: </a><a href="cmd_changes.wiki">fossil changes</a>
200 Report on the edit status of all files in the current checkout.
201 See also the "status" and "extra" commands.
202
203 <hr><a href="#tof">&#710;</a>
204 <a name="checkout">Usage: </a><a href="cmd_checkout.wiki">fossil checkout</a> VERSION ?-f|--force?
205 Check out a version specified on the command-line. This command
206 will not overwrite edited files in the current checkout unless
207 the --force option appears on the command-line.
208
209 See also the "update" command.
210
211 <hr><a href="#tof">&#710;</a>
212 <a name="commit">Usage: </a><a href="cmd_commit.wiki">fossil commit</a> ?-m COMMENT? ?--nosign? ?FILE...? fossil ci ... (as above)
213
214 Create a new version containing all of the changes in the current
215 checkout. You will be prompted to enter a check-in comment unless
216 the "-m" option is used to specify a comment line. You will be
217 prompted for your GPG passphrase in order to sign the new manifest
218 unless the "--nosign" option is used. All files that have
219 changed will be committed unless some subset of files is specified
220 on the command line.
221
222 <hr><a href="#tof">&#710;</a>
223 <a name="clean">Usage: </a><a href="cmd_clean.wiki">fossil clean</a> ?-all?
224 Delete all "extra" files in the source tree. "Extra" files are
225 files that are not officially part of the checkout. See also
226 the "extra" command. This operation cannot be undone.
227
228 You will be prompted before removing each file. If you are
229 sure you wish to remove all "extra" files you can specify the
230 optional -all flag.
231
232 <hr><a href="#tof">&#710;</a>
233 <a name="clone">Usage: </a><a href="cmd_clone.wiki">fossil clone</a> URL FILENAME
234 Make a clone of a repository specified by URL in the local
235 file named FILENAME.
236
237 <hr><a href="#tof">&#710;</a>
238 <a name="close">Usage: </a><a href="cmd_close.wiki">fossil close</a> ?-f|--force?
239 The opposite of "open". Close the current database connection.
240 Require a -f or --force flag if there are unsaved changed in the
241 current check-out.
242
243 <hr><a href="#tof">&#710;</a>
244 <a name="configuration">Usage: </a><a href="cmd_configure.wiki">fossil configuration</a> METHOD ...
245 Where METHOD is one of: export import merge pull push reset. All methods
246 accept the -R or --repository option to specific a repository.
247
248 fossil configuration export AREA FILENAME
249
250 Write to FILENAME exported configuraton information for AREA.
251 AREA can be one of: all ticket skin project
252
253 fossil configuration import FILENAME
254
255 Read a configuration from FILENAME, overwriting the current
256 configuration.
257
258 fossil configuration merge FILENAME
259
260 Read a configuration from FILENAME and merge its values into
261 the current configuration. Existing values take priority over
262 values read from FILENAME.
263
264 fossil configuration pull AREA ?URL?
265
266 Pull and install the configuration from a different server
267 identified by URL. If no URL is specified, then the default
268 server is used.
269 fossil configuration push AREA ?URL?
270
271 Push the local configuration into the remote server identified
272 by URL. Admin privilege is required on the remote server for
273 this to work.
274
275 fossil configuration reset AREA
276
277 Restore the configuration to the default. AREA as above.
278
279 WARNING: Do not import, merge, or pull configurations from an untrusted
280 source. The inbound configuration is not checked for safety and can
281 introduce security vulnerabilities.
282
283 <hr><a href="#tof">&#710;</a>
284 COMMAND: deconstruct
285 <a name="deconstruct">Usage: </a><a href="cmd_deconstruct.wiki">fossil deconstruct</a> ?-R|--repository REPOSITORY? DESTINATION
286 Populates the indicated DESTINATION directory with copies of all
287 artifcats contained within the repository. Artifacts are named AA/bbbbb
288 where AA is the first 2 characters of the artifact ID and bbbbb is the
289 remaining 38 characters.
290
291 <hr><a href="#tof">&#710;</a>
292 <a name="rm">Usage: </a><a href="cmd_rm.wiki">fossil rm</a> FILE... or: fossil del FILE...
293 Remove one or more files from the tree.
294
295 <hr><a href="#tof">&#710;</a>
296 <a name="descendants">Usage: </a><a href="cmd_descendants.wiki">fossil descendants</a> ?CHECKIN-ID?
297 Find all leaf descendants of the check-in specified or if the argument
298 is omitted, of the check-in currently checked out.
299
300 <hr><a href="#tof">&#710;</a>
301 <a name="diff">Usage: </a><a href="cmd_diff.wiki">fossil diff</a>|gdiff ?-i? ?-r REVISION? FILE...
302 Show the difference between the current version of a file (as it
303 exists on disk) and that same file as it was checked out.
304
305 diff will show a textual diff while gdiff will attempt to run a
306 graphical diff command that you have setup. If the choosen command
307 is not yet configured, the internal textual diff command will be
308 used.
309
310 If -i is supplied for either diff or gdiff, the internal textual
311 diff command will be executed.
312
313 Here are a few external diff command settings, for example:
314
315 fossil setting diff-command diff
316
317 fossil setting gdiff-command tkdiff
318 fossil setting gdiff-command eskill22
319 fossil setting gdiff-command tortoisemerge
320 fossil setting gdiff-command meld
321 fossil setting gdiff-command xxdiff
322 fossil setting gdiff-command kdiff3
323
324 <hr><a href="#tof">&#710;</a>
325 <a name="extra">Usage: </a><a href="cmd_extra.wiki">fossil extra</a>
326 Print a list of all files in the source tree that are not part of
327 the current checkout. See also the "clean" command.
328
329 <hr><a href="#tof">&#710;</a>
330 <a name="help">Usage: </a><a href="cmd_help.wiki">fossil help</a> COMMAND
331 Display information on how to use COMMAND
332
333 <hr><a href="#tof">&#710;</a>
334 <a name="http">Usage: </a><a href="cmd_http.wiki">fossil http</a> REPOSITORY
335 Handle a single HTTP request appearing on stdin. The resulting webpage
336 is delivered on stdout. This method is used to launch an HTTP request
337 handler from inetd, for example. The argument is the name of the repository.
338
339 <hr><a href="#tof">&#710;</a>
340 <a name="info">Usage: </a><a href="cmd_info.wiki">fossil info</a> ?ARTIFACT-ID|FILENAME?
341 With no arguments, provide information about the current tree.
342 If an argument is specified, provide information about the object
343 in the respository of the current tree that the argument refers
344 to. Or if the argument is the name of a repository, show
345 information about that repository.
346
347 <hr><a href="#tof">&#710;</a>
348 <a name="leaves">Usage: </a><a href="cmd_leaves.wiki">fossil leaves</a>
349 Find leaves of all branches.
350
351 <hr><a href="#tof">&#710;</a>
352 <a name="ls">Usage: </a><a href="cmd_ls.wiki">fossil ls</a>
353 Show the names of all files in the current checkout
354
355 <hr><a href="#tof">&#710;</a>
356 <a name="merge">Usage: </a><a href="cmd_merge.wiki">fossil merge</a> VERSION
357 The argument is a version that should be merged into the current
358 checkout.
359 Only file content is merged. The result continues to use the
360 file and directory names from the current check-out even if those
361 names might have been changed in the branch being merged in.
362
363 <hr><a href="#tof">&#710;</a>
364 <a name="mv">Usage: </a><a href="cmd_mv.wiki">fossil mv|rename</a> OLDNAME NEWNAME or: fossil mv|rename OLDNAME... DIR
365
366 Move or rename one or more files within the tree
367
368 This command does not rename the files on disk. All this command does is
369 record the fact that filenames have changed so that appropriate notations
370 can be made at the next commit/checkin.
371
372 <hr><a href="#tof">&#710;</a>
373 <a name="new">Usage: </a><a href="cmd_new.wiki">fossil new</a> FILENAME
374
375 Create a repository for a new project in the file named FILENAME.
376 This command is distinct from "clone". The "clone" command makes
377 a copy of an existing project. This command starts a new project.
378
379 <hr><a href="#tof">&#710;</a>
380 <a name="open">Usage: </a><a href="cmd_open.wiki">fossil open</a> FILENAME
381 Open a connection to the local repository in FILENAME. A checkout
382 for the repository is created with its root at the working directory.
383 See also the "close" command.
384
385 <hr><a href="#tof">&#710;</a>
386 <a name="rstats">Usage: </a><a href="cmd_rstats.wiki">fossil rstats</a>
387
388 Deliver a report of the repository statistics for the
389 current checkout.
390
391 <hr><a href="#tof">&#710;</a>
392 <a name="pull">Usage: </a><a href="cmd_pull.wiki">fossil pull</a> ?URL? ?-R|--respository REPOSITORY?
393 Pull changes in a remote repository into the local repository.
394 The repository is identified by the -R or --repository option.
395 If there is no such option then the open repository is used.
396 The URL of the remote server is specified on the command line
397 If no URL is specified then the URL used by the most recent
398 "pull", "push", or "sync" command is used.
399
400 The URL is of the following form:
401
402 http://USER@HOST:PORT/PATH
403
404 The "USER@" and ":PORT" substrings are optional.
405 The "USER" substring specifies the login user. You will be
406 prompted for the password on the command-line. The PORT
407 specifies the TCP port of the server. The default port is
408 80.
409
410 <hr><a href="#tof">&#710;</a>
411 <a name="push">Usage: </a><a href="cmd_push.wiki">fossil push</a> ?URL? ?-R|--repository REPOSITORY?
412 Push changes in the local repository over into a remote repository.
413 See the "pull" command for additional information.
414
415 <hr><a href="#tof">&#710;</a>
416 <a name="rebuild">Usage: </a><a href="cmd_rebuild.wiki">fossil rebuild</a> REPOSITORY
417 Reconstruct the named repository database from the core
418 records. Run this command after updating the fossil
419 executable in a way that changes the database schema.
420
421 <hr><a href="#tof">&#710;</a>
422 COMMAND: reconstruct
423 <a name="reconstruct">Usage: </a><a href="cmd_reconstruct.wiki">fossil reconstruct</a> REPOSITORY ORIGIN
424 Creates the REPOSITORY and populates it with the artifacts in the
425 indicated ORIGIN directory.
426
427 <hr><a href="#tof">&#710;</a>
428 <a name="redo">Usage: </a><a href="cmd_redo.wiki">fossil redo</a> ?FILENAME...?
429 Redo the an update or merge operation that has been undone by the
430 undo command. If FILENAME is specified then restore the changes
431 associated with the named file(s) but otherwise leave the update
432 or merge undone.
433
434 A single level of undo/redo is supported. The undo/redo stack
435 is cleared by the commit and checkout commands.
436
437 <hr><a href="#tof">&#710;</a>
438 <a name="revert">Usage: </a><a href="cmd_revert.wiki">fossil revert</a> ?--yes? ?-r CHECKIN? FILE
439 Revert to the current repository version of FILE, or to
440 the version associated with check-in CHECKIN if the -r flag
441 appears. This command will confirm your operation unless the
442 file is missing or the --yes option is used.
443
444 <hr><a href="#tof">&#710;</a>
445 <a name="server">Usage: </a><a href="cmd_server.wiki">fossil server</a> ?-P|--port TCPPORT? ?REPOSITORY? Or: fossil ui ?-P|--port TCPPORT? ?REPOSITORY?
446
447 Open a socket and begin listening and responding to HTTP requests on
448 TCP port 8080, or on any other TCP port defined by the -P or
449 --port option. The optional argument is the name of the repository.
450 The repository argument may be omitted if the working directory is
451 within an open checkout.
452
453 The "ui" command automatically starts a web browser after initializing
454 the web server.
455
456 <hr><a href="#tof">&#710;</a>
457 COMMAND: settings
458 COMMAND: unset
459 <a name="settings">Usage: </a><a href="cmd_setting.wiki">fossil settings</a> ?PROPERTY? ?VALUE? ?-global?
460 fossil unset PROPERTY ?-global?
461
462 The "settings" command with no arguments lists all properties and their
463 values. With just a property name it shows the value of that property.
464 With a value argument it changes the property for the current repository.
465
466 The "unset" command clears a property setting.
467
468 autosync If enabled, automatically pull prior to
469 commit or update and automatically push
470 after commit or tag or branch creation.
471
472 diff-command External command to run when performing a diff.
473 If undefined, the internal text diff will be used.
474
475 editor Text editor command used for check-in comments.
476
477 http-port The TCP/IP port number to use by the "server"
478 and "ui" commands. Default: 8080
479
480 gdiff-command External command to run when performing a graphical
481 diff. If undefined, text diff will be used.
482
483 localauth If enabled, require that HTTP connections from
484 127.0.0.1 be authenticated by password. If
485 false, all HTTP requests from localhost have
486 unrestricted access to the repository.
487
488 clearsign When enabled (the default), fossil will attempt to
489 sign all commits with gpg. When disabled, commits will
490 be unsigned.
491
492 pgp-command Command used to clear-sign manifests at check-in.
493 The default is "gpg --clearsign -o ".
494
495 mtime-changes Use file modification times (mtimes) to detect when
496 files have been modified.
497
498 proxy URL of the HTTP proxy. If undefined or "on" then
499 the "http_proxy" environment variable is consulted.
500 If the http_proxy environment variable is undefined
501 then a direct HTTP connection is used.
502
503 web-browser A shell command used to launch your preferred
504 web browser when given a URL as an argument.
505 Defaults to "start" on windows, "open" on Mac,
506 and "firefox" on Unix.
507
508 <hr><a href="#tof">&#710;</a>
509 <a name="status">Usage: </a><a href="cmd_status.wiki">fossil status</a>
510 Report on the status of the current checkout.
511
512 <hr><a href="#tof">&#710;</a>
513 <a name="sync">Usage: </a><a href="cmd_sync.wiki">fossil sync</a> ?URL? ?-R|--repository REPOSITORY?
514 Synchronize the local repository with a remote repository. This is
515 the equivalent of running both "push" and "pull" at the same time.
516 See the "pull" command for additional information.
517
518 <hr><a href="#tof">&#710;</a>
519 <a name="tag">Usage: </a><a href="cmd_tag.wiki">fossil tag</a> SUBCOMMAND ...
520 Run various subcommands to control tags and properties
521
522 fossil tag add ?--raw? TAGNAME CHECK-IN ?VALUE?
523
524 Add a new tag or property to CHECK-IN. The tag will
525 be usable instead of a CHECK-IN in commands such as
526 update and merge.
527
528 fossil tag branch ?--raw? ?--nofork? TAGNAME CHECK-IN ?VALUE?
529
530 A fork will be created so that the new checkin
531 is a sibling of CHECK-IN and identical to it except
532 for a generated comment. Then the new tag will
533 be added to the new checkin and propagated to
534 all direct children. Additionally all symbolic
535 tags of that checkin inherited from CHECK-IN will
536 be cancelled.
537
538 However, if the option --nofork is given, no
539 fork will be created and the tag/property will be
540 added to CHECK-IN directly. No tags will be canceled.
541
542 fossil tag cancel ?--raw? TAGNAME CHECK-IN
543
544 Remove the tag TAGNAME from CHECK-IN, and also remove
545 the propagation of the tag to any descendants.
546
547 fossil tag find ?--raw? TAGNAME
548
549 List all check-ins that use TAGNAME
550
551 fossil tag list ?--raw? ?CHECK-IN?
552
553 List all tags, or if CHECK-IN is supplied, list
554 all tags and their values for CHECK-IN.
555
556 The option --raw allows the manipulation of all types of
557 tags used for various internal purposes in fossil. You
558 should not use this option to make changes unless you are
559 sure what you are doing.
560
561 If you need to use a tagname that might be confused with
562 a hexadecimal check-in or artifact ID, you can explicitly
563 disambiguate it by prefixing it with "tag:". For instance:
564
565 fossil update decaf
566
567 will be taken as an artifact or check-in ID and fossil will
568 probably complain that no such revision was found. However
569
570 fossil update tag:decaf
571
572 will assume that "decaf" is a tag/branch name.
573
574 <hr><a href="#tof">&#710;</a>
575 <a name="timeline">Usage: </a><a href="cmd_timeline.wiki">fossil timeline</a> ?WHEN? ?CHECK-IN|DATETIME? ?-n|--count N?
576 Print a summary of activity going backwards in date and time
577 specified or from the current date and time if no arguments
578 are given. Show as many as N (default 20) check-ins. The
579 WHEN argument can be any unique abbreviation of one of these
580 keywords:
581
582 before
583 after
584 descendants | children
585 ancestors | parents
586
587 The CHECK-IN can be any unique prefix of 4 characters or more.
588 The DATETIME should be in the ISO8601 format. For
589 examples: "2007-08-18 07:21:21". You can also say "current"
590 for the current version or "now" for the current time.
591
592 <hr><a href="#tof">&#710;</a>
593 <a name="undo">Usage: </a><a href="cmd_undo.wiki">fossil undo</a> ?FILENAME...?
594 Undo the most recent update or merge operation. If FILENAME is
595 specified then restore the content of the named file(s) but otherwise
596 leave the update or merge in effect.
597
598 A single level of undo/redo is supported. The undo/redo stack
599 is cleared by the commit and checkout commands.
600
601 <hr><a href="#tof">&#710;</a>
602 <a name="update">Usage: </a><a href="cmd_update.wiki">fossil update</a> ?VERSION? ?--latest?
603 The optional argument is a version that should become the current
604 version. If the argument is omitted, then use the leaf of the
605 tree that begins with the current version, if there is only a single leaf. If there are a multiple leaves, the latest is used
606 if the --latest flag is present.
607
608 This command is different from the "checkout" in that edits are
609 not overwritten. Edits are merged into the new version.
610
611 <hr><a href="#tof">&#710;</a>
612 <a name="user">Usage: </a><a href="cmd_user.wiki">fossil user</a> SUBCOMMAND ... ?-R|--repository FILE?
613 Run various subcommands on users of the open repository or of
614 the repository identified by the -R or --repository option.
615
616 fossil user capabilities USERNAME ?STRING?
617
618 Query or set the capabilities for user USERNAME
619
620 fossil user default ?USERNAME?
621
622 Query or set the default user. The default user is the
623 user for command-line interaction.
624
625 fossil user list
626
627 List all users known to the repository
628
629 fossil user new ?USERNAME?
630
631 Create a new user in the repository. Users can never be
632 deleted. They can be denied all access but they must continue
633 to exist in the database.
634
635 fossil user password USERNAME
636
637 Change the web access password for a user.
638
639 <hr><a href="#tof">&#710;</a>
640 <a name="version">Usage: </a><a href="cmd_version.wiki">fossil version</a>
641 Print the source code version number for the fossil executable.
642
643 <hr><a href="#tof">&#710;</a>
644 <a name="wiki">Usage: </a><a href="cmd_wiki.wiki">fossil wiki</a> (export|create|commit|list) WikiName
645 Run various subcommands to fetch wiki entries.
646
647 fossil wiki export PAGENAME ?FILE?
648
649 Sends the latest version of the PAGENAME wiki
650 entry to the given file or standard output.
651
652 fossil wiki commit PAGENAME ?FILE?
653
654 Commit changes to a wiki page from FILE or from standard.
655
656 fossil wiki create PAGENAME ?FILE?
657
658 Create a new wiki page with initial content taken from
659 FILE or from standard input.
660
661 fossil wiki list
662
663 Lists all wiki entries, one per line, ordered
664 case-insentively by name.
665
666 TODOs:
667
668 fossil wiki export ?-u ARTIFACT? WikiName ?FILE?
669
670 Outputs the selected version of WikiName.
671
672 fossil wiki delete ?-m MESSAGE? WikiName
673
674 The same as deleting a file entry, but i don't know if fossil
675 supports a commit message for Wiki entries.
676
677 fossil wiki ?-u? ?-d? ?-s=[|]? list
678
679 Lists the artifact ID and/or Date of last change along with
680 each entry name, delimited by the -s char.
681
682 fossil wiki diff ?ARTIFACT? ?-f infile[=stdin]? EntryName
683
684 Diffs the local copy of a page with a given version (defaulting
685 to the head version).
686
687 </pre></nowiki>
688
689 <hr><a href="#tof">&#710;</a>
690
691 <h3>Caveats</h3>
692 This is not actually a reference, it's the start of a reference.
693 There are wikilinks to uncreated pages for the commands. This was
694 created by running the fossil help for each command listed by running
695 fossil help... Duplicate commands are only listed once (I
696 <i>think</i>). There are several bits of <b>fossil</b> that are not addressed
697 in the help for commands (special wiki directories, special users, etc.)
698 so they are (currently) not addressed here. Clarity and brevity may be
699 sacrificed for expediency at the authors indiscretion. All spelling and
700 grammatical mistakes are somebody elses fault.<code> void * </code>
701 prohibited where<code> __C_PLUS_PLUS__ </code>. Title and taxes extra.
702 Not valid in Hooptigonia.
703
--- www/reference.wiki
+++ www/reference.wiki
@@ -50,653 +50,59 @@
50 <br /><br /> <br />
51 <b>You should</b> probably start interacting with fossil at the command
52 line by asking it what it can
53 do:&nbsp;&nbsp;&nbsp;&nbsp;<a name="tof">&#710;</a>
54
55 <code>$ fossil [/help|help]</code>
56
57 This will generate output in the form:<pre>
58 Usage: fossil help COMMAND.
59 Available COMMANDs:</pre><table width="80%"
60 style="font-family: fixed, courier, monospace;">
61 <tr>
62 <td width="20%">[/help?cmd=add|add]</td>
63 <td>[/help?cmd=co|co]</td>
64 <td width="20%">[/help?cmd=info|info]</td>
65 <td width="20%">[/help?cmd=remote-url|remote-url]</td>
66 <td width="20%">[/help?cmd=ticket|ticket]</td>
67 </tr>
68 <tr>
69 <td>..</td>
70 <td>&nbsp;</td>
71 <td>&nbsp;</td>
72 <td>&nbsp;</td>
73 <td>&nbsp;</td>
74 </tr>
75 </table><pre>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
76 This is fossil version [a89b436bc9] 2009-02-11 05:00:02 UTC
77 </pre>
78
79
80 This information can also viewed in the fossil gui using the url
81 PROJEKT-BASEURL/[/help|help]. You'll see a web page, listing all
82 available commands in the current fossil build.
83
84 Each listed command is a link to a web page, displaying the detailed
85 command line help for the appropriate command.
86
87 There are links to individual wiki pages for each command. These pages
88 are named <kbd>cmd_<i>COMMAND-NAME</i></kbd>. These pages are not
89 defined for all commands - it's a work in progress. Existing pages give
90 more detailed description of the corresponding command.
91
92 <h3>Caveats</h3>
93 This reference is complete concerning the [/help|list] of commands
94 and the detailed command line reference. It's always in sync with the
95 used fossil build, because it uses the original command help, which is
96 compiled into the binary.
97
98 Additional, in-depth information in the wiki part is not available for
99 all commands.
100
101
102 There are several bits of <b>fossil</b> that are not addressed
103 in the help for commands (special wiki directories, special users, etc.)
104 so they are (currently) not addressed here. Clarity and brevity may be
105 sacrificed for expediency at the authors indiscretion. All spelling and
106 grammatical mistakes are somebody elses fault.<code> void * </code>
107 prohibited where<code> __C_PLUS_PLUS__ </code>. Title and taxes extra.
108 Not valid in Hooptigonia.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
109

Keyboard Shortcuts

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