Fossil

Check-in [10db583a]
Login

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment:update ref page
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1:10db583adc08da54f9119de70160f2f2f656e8fb
User & Date: kejoki 2008-12-19 23:09:26
References
2010-01-03
11:22 Ticket [6248d17d] file not found status still Open with 2 other changes artifact: 25f3b27e user: eric
Context
2008-12-20
02:23
Fix an SQL syntax error. Ticket [62c84f3e604a06f9b8f3f4ca39f774d6909115aa]. check-in: 491b2c69 user: drh tags: trunk
2008-12-19
23:09
update ref page check-in: 10db583a user: kejoki tags: trunk
2008-12-16
18:39
Add randomness in the form of a comment to each sync protocol request. This will break older servers which do not understand comments. But comments have been understood by servers for months now, so hopefully everybody has upgraded. check-in: ba837fd2 user: drh tags: trunk
Changes
Hide Diffs Unified Diffs Ignore Whitespace Patch

Changes to www/reference.wiki.

11
12
13
14
15
16
17






18
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
...
313
314
315
316
317
318
319

320
321
322
323
324
325
326
327
328
329
330
331






332
333
334
335
336
337
338
...
349
350
351
352
353
354
355

356
357
358
359
360
361
362
  <h3>Things to note</h3>
  *  Fossil cli commands do not use special delimeters, they use spaces.
  This is traditional with VCS/SCM.  Some <i>options</i> to fossil commands
  <i>do</i> use special delimiters, particularly the '-' (hyphen, or dash)
  character.  This is very similar to Tcl.  Think of fossil as a shell you
  invoke and feed a command to, including any options, and it will make
  more sense.







  *  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&#8212;the 'clone' command&#8212;unambiguous.

  You should probably start interacting with fossil at the command line
  by asking it what it can do:&nbsp;&nbsp;&nbsp;&nbsp;<a name="tof">&#710;</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="#configure">configuration</a></td>
	<td><a href="#leaves">leaves</a></td>
	<td><a href="#redo">redo</a></td>
	<td><a href="#server">ui</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="#undo">undo</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="#setting">unset</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="#update">update</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="#server">server</a></td>
	<td><a href="#user">user</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="#setting">settings</a></td>
	<td><a href="#version">version</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="#status">status</a></td>
	<td><a href="#wiki">wiki</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="#sync">sync</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="#tag">tag</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="#timeline">timeline</a></td>
      </tr>
    </table><nowiki><pre>
This is fossil version [2be82dcc2a] 2008-12-07 18:48:09 UTC
</pre>
<b>What follows</b> is a survey of what you get if you type<code>
fossil&nbsp;help&nbsp;<i>command</i> </code>for all of the
commands listed above.  There are links to individual pages for each
of them; pages with content (not all of them are done) go into the command
in a bit more depth than the program help.
<pre>
<hr><a href="#tof">&#710;</a>
    <a name="add">Usage: </a><code><a href="cmd_add.wiki">fossil add</a></code> FILE...
    Make arrangements to add one or more files to the current checkout
    at the next commit.

<hr><a href="#tof">&#710;</a>
................................................................................
    <a name="mv">Usage: </a><a href="cmd_mv.wiki">fossil mv|rename</a> OLDNAME NEWNAME       or: fossil mv|rename OLDNAME... DIR

    Move or rename one or more files within the tree

    This command does not rename the files on disk.  All this command does is
    record the fact that filenames have changed so that appropriate notations
    can be made at the next commit/checkin.

<hr><a href="#tof">&#710;</a>
    <a name="new">Usage: </a><a href="cmd_new.wiki">fossil new</a> FILENAME

    Create a repository for a new project in the file named FILENAME.
    This command is distinct from "clone".  The "clone" command makes
    a copy of an existing project.  This command starts a new project.

<hr><a href="#tof">&#710;</a>
    <a name="open">Usage: </a><a href="cmd_open.wiki">fossil open</a> FILENAME
    Open a connection to the local repository in FILENAME.  A checkout
    for the repository is created with its root at the working directory.
    See also the "close" command.







<hr><a href="#tof">&#710;</a>
    <a name="pull">Usage: </a><a href="cmd_pull.wiki">fossil pull</a> ?URL? ?-R|--respository REPOSITORY?
    Pull changes in a remote repository into the local repository.
    The repository is identified by the -R or --repository option.
    If there is no such option then the open repository is used.
    The URL of the remote server is specified on the command line
................................................................................
    specifies the TCP port of the server.  The default port is
    80.

<hr><a href="#tof">&#710;</a>
    <a name="push">Usage: </a><a href="cmd_push.wiki">fossil push</a> ?URL? ?-R|--repository REPOSITORY?
    Push changes in the local repository over into a remote repository.
    See the "pull" command for additional information.

<hr><a href="#tof">&#710;</a>
    <a name="rebuild">Usage: </a><a href="cmd_rebuild.wiki">fossil rebuild</a> REPOSITORY
    Reconstruct the named repository database from the core
    records.  Run this command after updating the fossil
    executable in a way that changes the database schema.

<hr><a href="#tof">&#710;</a>







>
>
>
>
>
>













|



|


|

|

|






|


|



|


|

|
|
|



|

|
|





|
|





|
>





|





|


|




|
|







 







>












>
>
>
>
>
>







 







>







11
12
13
14
15
16
17
18
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
...
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
...
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
  <h3>Things to note</h3>
  *  Fossil cli commands do not use special delimeters, they use spaces.
  This is traditional with VCS/SCM.  Some <i>options</i> to fossil commands
  <i>do</i> use special delimiters, particularly the '-' (hyphen, or dash)
  character.  This is very similar to Tcl.  Think of fossil as a shell you
  invoke and feed a command to, including any options, and it will make
  more sense.

  *  A <u>version</u> in <b>fossil</b> is 40 character hexadecimal string.
  <b>fossil</b> will be able to figure out which version you want with any
  prefix of that string that is distinct from all others.  <em>Commands
  which require a version are looking for that string, the unique prefix,
  or a <code>tag</code>.</em>

  *  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&#8212;the 'clone' command&#8212;unambiguous.

  You should probably start interacting with fossil at the command line
  by asking it what it can do:&nbsp;&nbsp;&nbsp;&nbsp;<a name="tof">&#710;</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="#configure">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 [ba837fd294] 2008-12-16 18:39:29 UTC
</pre>
<b>What follows</b> is a survey of what you get if you type<code>
fossil&nbsp;help&nbsp;<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>
<hr><a href="#tof">&#710;</a>
    <a name="add">Usage: </a><code><a href="cmd_add.wiki">fossil add</a></code> FILE...
    Make arrangements to add one or more files to the current checkout
    at the next commit.

<hr><a href="#tof">&#710;</a>
................................................................................
    <a name="mv">Usage: </a><a href="cmd_mv.wiki">fossil mv|rename</a> OLDNAME NEWNAME       or: fossil mv|rename OLDNAME... DIR

    Move or rename one or more files within the tree

    This command does not rename the files on disk.  All this command does is
    record the fact that filenames have changed so that appropriate notations
    can be made at the next commit/checkin.

<hr><a href="#tof">&#710;</a>
    <a name="new">Usage: </a><a href="cmd_new.wiki">fossil new</a> FILENAME

    Create a repository for a new project in the file named FILENAME.
    This command is distinct from "clone".  The "clone" command makes
    a copy of an existing project.  This command starts a new project.

<hr><a href="#tof">&#710;</a>
    <a name="open">Usage: </a><a href="cmd_open.wiki">fossil open</a> FILENAME
    Open a connection to the local repository in FILENAME.  A checkout
    for the repository is created with its root at the working directory.
    See also the "close" command.

<hr><a href="#tof">&#710;</a>
    <a name="rstats">Usage: </a><a href="cmd_rstats.wiki">fossil rstats</a>

    Deliver a report of the repository statistics for the
    current checkout.

<hr><a href="#tof">&#710;</a>
    <a name="pull">Usage: </a><a href="cmd_pull.wiki">fossil pull</a> ?URL? ?-R|--respository REPOSITORY?
    Pull changes in a remote repository into the local repository.
    The repository is identified by the -R or --repository option.
    If there is no such option then the open repository is used.
    The URL of the remote server is specified on the command line
................................................................................
    specifies the TCP port of the server.  The default port is
    80.

<hr><a href="#tof">&#710;</a>
    <a name="push">Usage: </a><a href="cmd_push.wiki">fossil push</a> ?URL? ?-R|--repository REPOSITORY?
    Push changes in the local repository over into a remote repository.
    See the "pull" command for additional information.

<hr><a href="#tof">&#710;</a>
    <a name="rebuild">Usage: </a><a href="cmd_rebuild.wiki">fossil rebuild</a> REPOSITORY
    Reconstruct the named repository database from the core
    records.  Run this command after updating the fossil
    executable in a way that changes the database schema.

<hr><a href="#tof">&#710;</a>