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