Fossil SCM
Clarified the intro to the gitusers doc.
Commit
99117745c4f590296b934cb979d0f557f4b39fe2fad3edc8b8813af9de7c20f4
Parent
a7af387dd8aa7f5…
1 file changed
+18
-13
+18
-13
| --- www/gitusers.md | ||
| +++ www/gitusers.md | ||
| @@ -1,18 +1,25 @@ | ||
| 1 | 1 | # Git to Fossil Translation Guide |
| 2 | 2 | |
| 3 | 3 | ## Introduction |
| 4 | 4 | |
| 5 | -This document attempts to provide equivalents for common Git commands | |
| 6 | -and workflows where possible, and where not, to explain those cases. | |
| 7 | - | |
| 8 | -Although Fossil shares many similarities with Git, there are enough | |
| 9 | -differences that we can’t provide a simple “translation dictionary” for | |
| 10 | -some commands. This document is more concerned with those cases than the | |
| 11 | -simple 1:1 mappings, which you can likely find on your own. In many | |
| 12 | -cases, the sub-commands are identical: [`fossil bisect`][bis] does essentially | |
| 13 | -the same thing as `git bisect`, for example. | |
| 5 | +Fossil shares many similarities with Git. In many cases, the | |
| 6 | +sub-commands are identical: [`fossil bisect`][fbis] does essentially the | |
| 7 | +same thing as [`git bisect`][gbis], for example. | |
| 8 | + | |
| 9 | +This document covers the cases where there is no simple 1:1 mapping, | |
| 10 | +usually because of intentional design differences in Fossil that prevent | |
| 11 | +it from working exactly like Git. We choose to explain these differences | |
| 12 | +rather than provide a simple “translation dictionary,” since to | |
| 13 | +understand the conversion, you need to know why the difference exists. | |
| 14 | + | |
| 15 | +We focus on practical command examples here, leaving discussions of the | |
| 16 | +philosophical underpinnings drive these command differences to [another | |
| 17 | +document][fvg]. The [case studies](#cs1) do get a bit philosophical, but | |
| 18 | +it is with the aim of illustrating how these Fossil design differences | |
| 19 | +cause Fossil to behave materially differently from Git in everyday | |
| 20 | +operation. | |
| 14 | 21 | |
| 15 | 22 | We present this from the perspective of Git users moving to Fossil, but |
| 16 | 23 | it is also possible to read this document as a Fossil user who speaks |
| 17 | 24 | only pidgin Git, who may often have questions of the form, “Now how do I |
| 18 | 25 | do X in Git again?” |
| @@ -26,14 +33,12 @@ | ||
| 26 | 33 | While we do try to explain Fossil-specific terminology inline here |
| 27 | 34 | as-needed, you may find it helpful to skim [the Fossil glossary][gloss]. |
| 28 | 35 | It will give you another take on our definitions here, and it may help |
| 29 | 36 | you to understand some of the other Fossil docs better. |
| 30 | 37 | |
| 31 | -We focus more on practical command examples here than on [the | |
| 32 | -philosophical underpinnings][fvg] that drive these differences. | |
| 33 | - | |
| 34 | -[bis]: /help?cmd=bisect | |
| 38 | +[fbis]: /help?cmd=bisect | |
| 39 | +[gbis]: https://git-scm.com/docs/git-bisect | |
| 35 | 40 | [ffor]: https://fossil-scm.org/forum |
| 36 | 41 | [fvg]: ./fossil-v-git.wiki |
| 37 | 42 | |
| 38 | 43 | |
| 39 | 44 | <a id="mwd"></a> |
| 40 | 45 |
| --- www/gitusers.md | |
| +++ www/gitusers.md | |
| @@ -1,18 +1,25 @@ | |
| 1 | # Git to Fossil Translation Guide |
| 2 | |
| 3 | ## Introduction |
| 4 | |
| 5 | This document attempts to provide equivalents for common Git commands |
| 6 | and workflows where possible, and where not, to explain those cases. |
| 7 | |
| 8 | Although Fossil shares many similarities with Git, there are enough |
| 9 | differences that we can’t provide a simple “translation dictionary” for |
| 10 | some commands. This document is more concerned with those cases than the |
| 11 | simple 1:1 mappings, which you can likely find on your own. In many |
| 12 | cases, the sub-commands are identical: [`fossil bisect`][bis] does essentially |
| 13 | the same thing as `git bisect`, for example. |
| 14 | |
| 15 | We present this from the perspective of Git users moving to Fossil, but |
| 16 | it is also possible to read this document as a Fossil user who speaks |
| 17 | only pidgin Git, who may often have questions of the form, “Now how do I |
| 18 | do X in Git again?” |
| @@ -26,14 +33,12 @@ | |
| 26 | While we do try to explain Fossil-specific terminology inline here |
| 27 | as-needed, you may find it helpful to skim [the Fossil glossary][gloss]. |
| 28 | It will give you another take on our definitions here, and it may help |
| 29 | you to understand some of the other Fossil docs better. |
| 30 | |
| 31 | We focus more on practical command examples here than on [the |
| 32 | philosophical underpinnings][fvg] that drive these differences. |
| 33 | |
| 34 | [bis]: /help?cmd=bisect |
| 35 | [ffor]: https://fossil-scm.org/forum |
| 36 | [fvg]: ./fossil-v-git.wiki |
| 37 | |
| 38 | |
| 39 | <a id="mwd"></a> |
| 40 |
| --- www/gitusers.md | |
| +++ www/gitusers.md | |
| @@ -1,18 +1,25 @@ | |
| 1 | # Git to Fossil Translation Guide |
| 2 | |
| 3 | ## Introduction |
| 4 | |
| 5 | Fossil shares many similarities with Git. In many cases, the |
| 6 | sub-commands are identical: [`fossil bisect`][fbis] does essentially the |
| 7 | same thing as [`git bisect`][gbis], for example. |
| 8 | |
| 9 | This document covers the cases where there is no simple 1:1 mapping, |
| 10 | usually because of intentional design differences in Fossil that prevent |
| 11 | it from working exactly like Git. We choose to explain these differences |
| 12 | rather than provide a simple “translation dictionary,” since to |
| 13 | understand the conversion, you need to know why the difference exists. |
| 14 | |
| 15 | We focus on practical command examples here, leaving discussions of the |
| 16 | philosophical underpinnings drive these command differences to [another |
| 17 | document][fvg]. The [case studies](#cs1) do get a bit philosophical, but |
| 18 | it is with the aim of illustrating how these Fossil design differences |
| 19 | cause Fossil to behave materially differently from Git in everyday |
| 20 | operation. |
| 21 | |
| 22 | We present this from the perspective of Git users moving to Fossil, but |
| 23 | it is also possible to read this document as a Fossil user who speaks |
| 24 | only pidgin Git, who may often have questions of the form, “Now how do I |
| 25 | do X in Git again?” |
| @@ -26,14 +33,12 @@ | |
| 33 | While we do try to explain Fossil-specific terminology inline here |
| 34 | as-needed, you may find it helpful to skim [the Fossil glossary][gloss]. |
| 35 | It will give you another take on our definitions here, and it may help |
| 36 | you to understand some of the other Fossil docs better. |
| 37 | |
| 38 | [fbis]: /help?cmd=bisect |
| 39 | [gbis]: https://git-scm.com/docs/git-bisect |
| 40 | [ffor]: https://fossil-scm.org/forum |
| 41 | [fvg]: ./fossil-v-git.wiki |
| 42 | |
| 43 | |
| 44 | <a id="mwd"></a> |
| 45 |