Fossil SCM
Additional documentation updates prior to the 1.23 release.
Commit
411e88cbaf5dc1ff71ad2a7f0e80a24b3554f28b
Parent
0324ed61fb152f0…
2 files changed
+12
-8
+19
-1
+12
-8
| --- www/changes.wiki | ||
| +++ www/changes.wiki | ||
| @@ -2,22 +2,26 @@ | ||
| 2 | 2 | |
| 3 | 3 | <h2>Changes For Version 1.23 (2012-08-08)</h2> |
| 4 | 4 | * The default checkout database name is now ".fslckout" instead of |
| 5 | 5 | "_FOSSIL_" on unix. Both names continue to work. |
| 6 | 6 | * Added the "fossil all changes" command |
| 7 | - * Added the "fossil all list --ckout" command | |
| 8 | - * Added the "public-pages" glob pattern that allows anonymous users to | |
| 9 | - embedded documentation on sites where source code should not be | |
| 10 | - accessible to anonymous users. | |
| 7 | + * Added the --ckout option to the "fossil all list" command | |
| 8 | + * Added the "public-pages" glob pattern that can be configured to allow | |
| 9 | + anonymous users to see embedded documentation on sites where source | |
| 10 | + code should not be accessible to anonymous users. | |
| 11 | 11 | * Allow multiple --tag options on the same "fossil commit" command. |
| 12 | 12 | * Change the meaning of the --bgcolor option for "fossil commit" to only |
| 13 | 13 | change the color for that one commit. The new --branchcolor option |
| 14 | 14 | is available to set a persistent background color. |
| 15 | 15 | * Add the branch= query parameter to the vdiff page and the --branch option |
| 16 | 16 | to the "fossil diff" command. |
| 17 | 17 | * Check-in names of the form "root:BRANCH" now refer to the origin of |
| 18 | - the branch. | |
| 18 | + the branch. Hence to see all changes in a branch, use | |
| 19 | + "fossil diff --from root:BRANCH --to BRANCH". The --branch option on | |
| 20 | + the diff command is an alias for the same. | |
| 21 | + * Add the ability to configure ad-units to be displayed between the menu | |
| 22 | + bar and the content. | |
| 19 | 23 | * Add the ability to set a background image as part of server configuration. |
| 20 | 24 | * Allow partial commits of cherrypick merges. |
| 21 | 25 | * Updates against an uncommitted merge are now a warning, not a fatal error. |
| 22 | 26 | * Prompt the user to continue if a check-in comment is unedited. |
| 23 | 27 | * Fixes to case sensitivity settings with the /dir webpage. |
| @@ -25,16 +29,16 @@ | ||
| 25 | 29 | web-access URLs and display this information with the |
| 26 | 30 | "fossil info $REPO" command. |
| 27 | 31 | * Improved defense against spiders: The src= attribute of |
| 28 | 32 | <a> elements is set using javascript after the page loads. |
| 29 | 33 | * Enhanced formatting of the user list page. |
| 30 | - * If a file named in "fossil add" is missing, that is now a warning not | |
| 31 | - a fatal error. | |
| 34 | + * If a file named in "fossil add" is missing, that is now a warning instead | |
| 35 | + of a fatal error. | |
| 32 | 36 | * Fix side-by-side diff so that it displays correctly with |
| 33 | 37 | multi-byte UTF8 characters. |
| 34 | 38 | * Performance improvements in the diff logic. |
| 35 | - * Lots of other performance tweaks and documentation updates. | |
| 39 | + * Other performance tweaks and documentation updates. | |
| 36 | 40 | |
| 37 | 41 | <h2>Changes For Version 1.22 (2012-03-17)</h2> |
| 38 | 42 | * Greatly improved "diff" processing including the new --brief option, |
| 39 | 43 | partial line matching, colorized in-line diffs, and better performance. |
| 40 | 44 | * Promote "allow-symlinks" to a versionable setting |
| 41 | 45 |
| --- www/changes.wiki | |
| +++ www/changes.wiki | |
| @@ -2,22 +2,26 @@ | |
| 2 | |
| 3 | <h2>Changes For Version 1.23 (2012-08-08)</h2> |
| 4 | * The default checkout database name is now ".fslckout" instead of |
| 5 | "_FOSSIL_" on unix. Both names continue to work. |
| 6 | * Added the "fossil all changes" command |
| 7 | * Added the "fossil all list --ckout" command |
| 8 | * Added the "public-pages" glob pattern that allows anonymous users to |
| 9 | embedded documentation on sites where source code should not be |
| 10 | accessible to anonymous users. |
| 11 | * Allow multiple --tag options on the same "fossil commit" command. |
| 12 | * Change the meaning of the --bgcolor option for "fossil commit" to only |
| 13 | change the color for that one commit. The new --branchcolor option |
| 14 | is available to set a persistent background color. |
| 15 | * Add the branch= query parameter to the vdiff page and the --branch option |
| 16 | to the "fossil diff" command. |
| 17 | * Check-in names of the form "root:BRANCH" now refer to the origin of |
| 18 | the branch. |
| 19 | * Add the ability to set a background image as part of server configuration. |
| 20 | * Allow partial commits of cherrypick merges. |
| 21 | * Updates against an uncommitted merge are now a warning, not a fatal error. |
| 22 | * Prompt the user to continue if a check-in comment is unedited. |
| 23 | * Fixes to case sensitivity settings with the /dir webpage. |
| @@ -25,16 +29,16 @@ | |
| 25 | web-access URLs and display this information with the |
| 26 | "fossil info $REPO" command. |
| 27 | * Improved defense against spiders: The src= attribute of |
| 28 | <a> elements is set using javascript after the page loads. |
| 29 | * Enhanced formatting of the user list page. |
| 30 | * If a file named in "fossil add" is missing, that is now a warning not |
| 31 | a fatal error. |
| 32 | * Fix side-by-side diff so that it displays correctly with |
| 33 | multi-byte UTF8 characters. |
| 34 | * Performance improvements in the diff logic. |
| 35 | * Lots of other performance tweaks and documentation updates. |
| 36 | |
| 37 | <h2>Changes For Version 1.22 (2012-03-17)</h2> |
| 38 | * Greatly improved "diff" processing including the new --brief option, |
| 39 | partial line matching, colorized in-line diffs, and better performance. |
| 40 | * Promote "allow-symlinks" to a versionable setting |
| 41 |
| --- www/changes.wiki | |
| +++ www/changes.wiki | |
| @@ -2,22 +2,26 @@ | |
| 2 | |
| 3 | <h2>Changes For Version 1.23 (2012-08-08)</h2> |
| 4 | * The default checkout database name is now ".fslckout" instead of |
| 5 | "_FOSSIL_" on unix. Both names continue to work. |
| 6 | * Added the "fossil all changes" command |
| 7 | * Added the --ckout option to the "fossil all list" command |
| 8 | * Added the "public-pages" glob pattern that can be configured to allow |
| 9 | anonymous users to see embedded documentation on sites where source |
| 10 | code should not be accessible to anonymous users. |
| 11 | * Allow multiple --tag options on the same "fossil commit" command. |
| 12 | * Change the meaning of the --bgcolor option for "fossil commit" to only |
| 13 | change the color for that one commit. The new --branchcolor option |
| 14 | is available to set a persistent background color. |
| 15 | * Add the branch= query parameter to the vdiff page and the --branch option |
| 16 | to the "fossil diff" command. |
| 17 | * Check-in names of the form "root:BRANCH" now refer to the origin of |
| 18 | the branch. Hence to see all changes in a branch, use |
| 19 | "fossil diff --from root:BRANCH --to BRANCH". The --branch option on |
| 20 | the diff command is an alias for the same. |
| 21 | * Add the ability to configure ad-units to be displayed between the menu |
| 22 | bar and the content. |
| 23 | * Add the ability to set a background image as part of server configuration. |
| 24 | * Allow partial commits of cherrypick merges. |
| 25 | * Updates against an uncommitted merge are now a warning, not a fatal error. |
| 26 | * Prompt the user to continue if a check-in comment is unedited. |
| 27 | * Fixes to case sensitivity settings with the /dir webpage. |
| @@ -25,16 +29,16 @@ | |
| 29 | web-access URLs and display this information with the |
| 30 | "fossil info $REPO" command. |
| 31 | * Improved defense against spiders: The src= attribute of |
| 32 | <a> elements is set using javascript after the page loads. |
| 33 | * Enhanced formatting of the user list page. |
| 34 | * If a file named in "fossil add" is missing, that is now a warning instead |
| 35 | of a fatal error. |
| 36 | * Fix side-by-side diff so that it displays correctly with |
| 37 | multi-byte UTF8 characters. |
| 38 | * Performance improvements in the diff logic. |
| 39 | * Other performance tweaks and documentation updates. |
| 40 | |
| 41 | <h2>Changes For Version 1.22 (2012-03-17)</h2> |
| 42 | * Greatly improved "diff" processing including the new --brief option, |
| 43 | partial line matching, colorized in-line diffs, and better performance. |
| 44 | * Promote "allow-symlinks" to a versionable setting |
| 45 |
+19
-1
| --- www/checkin_names.wiki | ||
| +++ www/checkin_names.wiki | ||
| @@ -8,10 +8,11 @@ | ||
| 8 | 8 | <ul> |
| 9 | 9 | <li> SHA1 hash prefix |
| 10 | 10 | <li> Tag or branchname |
| 11 | 11 | <li> Timestamp: <i>YYYY-MM-DD HH:MM:SS</i> |
| 12 | 12 | <li> <i>tag-name</i> <big><b>:</b></big> <i>timestamp</i> |
| 13 | +<li> <b>root :</b> <i>branchname</i> | |
| 13 | 14 | <li> Special names: |
| 14 | 15 | <ul> |
| 15 | 16 | <li> <b>tip</b> |
| 16 | 17 | <li> <b>current</b> |
| 17 | 18 | <li> <b>next</b> |
| @@ -123,14 +124,18 @@ | ||
| 123 | 124 | check-in that occurs no later than the timestamp given: |
| 124 | 125 | |
| 125 | 126 | * <i>YYYY-MM-DD</i> |
| 126 | 127 | * <i>YYYY-MM-DD HH:MM</i> |
| 127 | 128 | * <i>YYYY-MM-DD HH:MM:SS</i> |
| 129 | + * <i>YYYY-MM-DD HH:MM:SS.SSS</i> | |
| 128 | 130 | |
| 129 | 131 | The space between the day and the year can optionally be |
| 130 | 132 | replaced by an uppercase <b>T</b> and the entire timestamp can |
| 131 | -optionally be followed by "<b>z</b>" or "<b>Z</b>". | |
| 133 | +optionally be followed by "<b>z</b>" or "<b>Z</b>". In the fourth | |
| 134 | +form with fractional seconds, any number of digits may follow the | |
| 135 | +decimal point, though due to precision limits only the first three | |
| 136 | +digits will be significant. | |
| 132 | 137 | |
| 133 | 138 | In its default configuration, Fossil interprets and displays all dates |
| 134 | 139 | in Universal Coordinated Time (UTC). This tends to work the best for |
| 135 | 140 | distributed projects where participants are scattered around the globe. |
| 136 | 141 | But there is an option on the Admin/Timeline page of the web-interface to |
| @@ -167,10 +172,23 @@ | ||
| 167 | 172 | </blockquote> |
| 168 | 173 | |
| 169 | 174 | Would cause Fossil to update the working check-out to be the most recent |
| 170 | 175 | check-in on the trunk that is not more recent that 14:30 (UTC) on |
| 171 | 176 | July 1, 2010. |
| 177 | + | |
| 178 | +<h2>Root Of A Branch</h2> | |
| 179 | + | |
| 180 | +A branch name that begins with the "<tt>root:</tt>" prefix refers to the | |
| 181 | +last check-in in the parent branch prior to the beginning of the branch. | |
| 182 | +Such a label is useful, for example, in computing all diffs for a single | |
| 183 | +branch. The following example will show all changes in the hypothetical | |
| 184 | +branch "xyzzy": | |
| 185 | + | |
| 186 | +<blockquote> | |
| 187 | +fossil diff --from root:xyzzy --to xyzzy | |
| 188 | +</blockquote> | |
| 189 | + | |
| 172 | 190 | |
| 173 | 191 | <h2>Special Tags</h2> |
| 174 | 192 | |
| 175 | 193 | The tag "tip" means the most recent check-in. The "tip" tag is roughly |
| 176 | 194 | equivalent to the timestamp tag "5000-01-01". |
| 177 | 195 |
| --- www/checkin_names.wiki | |
| +++ www/checkin_names.wiki | |
| @@ -8,10 +8,11 @@ | |
| 8 | <ul> |
| 9 | <li> SHA1 hash prefix |
| 10 | <li> Tag or branchname |
| 11 | <li> Timestamp: <i>YYYY-MM-DD HH:MM:SS</i> |
| 12 | <li> <i>tag-name</i> <big><b>:</b></big> <i>timestamp</i> |
| 13 | <li> Special names: |
| 14 | <ul> |
| 15 | <li> <b>tip</b> |
| 16 | <li> <b>current</b> |
| 17 | <li> <b>next</b> |
| @@ -123,14 +124,18 @@ | |
| 123 | check-in that occurs no later than the timestamp given: |
| 124 | |
| 125 | * <i>YYYY-MM-DD</i> |
| 126 | * <i>YYYY-MM-DD HH:MM</i> |
| 127 | * <i>YYYY-MM-DD HH:MM:SS</i> |
| 128 | |
| 129 | The space between the day and the year can optionally be |
| 130 | replaced by an uppercase <b>T</b> and the entire timestamp can |
| 131 | optionally be followed by "<b>z</b>" or "<b>Z</b>". |
| 132 | |
| 133 | In its default configuration, Fossil interprets and displays all dates |
| 134 | in Universal Coordinated Time (UTC). This tends to work the best for |
| 135 | distributed projects where participants are scattered around the globe. |
| 136 | But there is an option on the Admin/Timeline page of the web-interface to |
| @@ -167,10 +172,23 @@ | |
| 167 | </blockquote> |
| 168 | |
| 169 | Would cause Fossil to update the working check-out to be the most recent |
| 170 | check-in on the trunk that is not more recent that 14:30 (UTC) on |
| 171 | July 1, 2010. |
| 172 | |
| 173 | <h2>Special Tags</h2> |
| 174 | |
| 175 | The tag "tip" means the most recent check-in. The "tip" tag is roughly |
| 176 | equivalent to the timestamp tag "5000-01-01". |
| 177 |
| --- www/checkin_names.wiki | |
| +++ www/checkin_names.wiki | |
| @@ -8,10 +8,11 @@ | |
| 8 | <ul> |
| 9 | <li> SHA1 hash prefix |
| 10 | <li> Tag or branchname |
| 11 | <li> Timestamp: <i>YYYY-MM-DD HH:MM:SS</i> |
| 12 | <li> <i>tag-name</i> <big><b>:</b></big> <i>timestamp</i> |
| 13 | <li> <b>root :</b> <i>branchname</i> |
| 14 | <li> Special names: |
| 15 | <ul> |
| 16 | <li> <b>tip</b> |
| 17 | <li> <b>current</b> |
| 18 | <li> <b>next</b> |
| @@ -123,14 +124,18 @@ | |
| 124 | check-in that occurs no later than the timestamp given: |
| 125 | |
| 126 | * <i>YYYY-MM-DD</i> |
| 127 | * <i>YYYY-MM-DD HH:MM</i> |
| 128 | * <i>YYYY-MM-DD HH:MM:SS</i> |
| 129 | * <i>YYYY-MM-DD HH:MM:SS.SSS</i> |
| 130 | |
| 131 | The space between the day and the year can optionally be |
| 132 | replaced by an uppercase <b>T</b> and the entire timestamp can |
| 133 | optionally be followed by "<b>z</b>" or "<b>Z</b>". In the fourth |
| 134 | form with fractional seconds, any number of digits may follow the |
| 135 | decimal point, though due to precision limits only the first three |
| 136 | digits will be significant. |
| 137 | |
| 138 | In its default configuration, Fossil interprets and displays all dates |
| 139 | in Universal Coordinated Time (UTC). This tends to work the best for |
| 140 | distributed projects where participants are scattered around the globe. |
| 141 | But there is an option on the Admin/Timeline page of the web-interface to |
| @@ -167,10 +172,23 @@ | |
| 172 | </blockquote> |
| 173 | |
| 174 | Would cause Fossil to update the working check-out to be the most recent |
| 175 | check-in on the trunk that is not more recent that 14:30 (UTC) on |
| 176 | July 1, 2010. |
| 177 | |
| 178 | <h2>Root Of A Branch</h2> |
| 179 | |
| 180 | A branch name that begins with the "<tt>root:</tt>" prefix refers to the |
| 181 | last check-in in the parent branch prior to the beginning of the branch. |
| 182 | Such a label is useful, for example, in computing all diffs for a single |
| 183 | branch. The following example will show all changes in the hypothetical |
| 184 | branch "xyzzy": |
| 185 | |
| 186 | <blockquote> |
| 187 | fossil diff --from root:xyzzy --to xyzzy |
| 188 | </blockquote> |
| 189 | |
| 190 | |
| 191 | <h2>Special Tags</h2> |
| 192 | |
| 193 | The tag "tip" means the most recent check-in. The "tip" tag is roughly |
| 194 | equivalent to the timestamp tag "5000-01-01". |
| 195 |