Fossil SCM

Tightened the intro section of gitusers.md

wyoung 2020-11-01 18:40 trunk

Commit dad5ce51090420523f006f29ca7bd6798a7d50b61759b347b18955466eeab9c3

Parent 8a0ea9b6c0ce04e…

1 file changed +25 -27

M www/gitusers.md

+25 -27

		--- www/gitusers.md
		+++ www/gitusers.md
		@@ -1,39 +1,36 @@
1		-# Hints For Users With Prior Git Experience
2		-
3		-This document is a semi-random collection of hints intended to help
4		-new users of Fossil who have had prior exposure to Git. In other words,
5		-this document tries to describe the differences in how Fossil works
6		-from the perspective of Git users.
7		-
8		-
9		-## Help Improve This Document
10		-
11		-If you have a lot of prior Git experience, and you are new to Fossil
12		-and are struggling with some concepts, please ask for help on the
13		-[Fossil Forum][1]. The people who write this document are intimately
14		-familiar with Fossil and less familiar with Git. It is difficult for
15		-us to anticipate the perspective of people who are initimately familiar
16		-with Git and less familiar with Fossil. Asking questions on the Forum
17		-will help us to improve the document.
18		-
19		-[1]: https://fossil-scm.org/forum
20		-
21		-Specific suggestions on how to improve this document are also welcomed,
22		-of course.
23		-
24		-
25		-
26		-## <a id="term"></a> Terminology
	1	+# Git 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` 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?”
	19	+
	20	+This document’s authors are intimately familiar with Fossil, so it is
	21	+difficult for us to anticipate the perspective of people who are
	22	+initimately familiar with Git. If you have a lot of prior Git
	23	+experience, we welcome your contributions and questions on the [Fossil
	24	+Forum][ffor].
27	25
28	26	While we do try to explain Fossil-specific terminology inline here
29	27	as-needed, you may find it helpful to skim [the Fossil glossary][gloss].
30	28	It will give you another take on our definitions here, and it may help
31	29	you to understand some of the other Fossil docs better.
32	30
33		-
		-----
	31	+[ffor]: https://fossil-scm.org/forum
34	32
35	33
36	34	<a id="mwd"></a>
37	35	## Repositories And Checkouts Are Distinct
38	36
39	37

	--- www/gitusers.md
	+++ www/gitusers.md
	@@ -1,39 +1,36 @@
1	# Hints For Users With Prior Git Experience
2
3	This document is a semi-random collection of hints intended to help
4	new users of Fossil who have had prior exposure to Git. In other words,
5	this document tries to describe the differences in how Fossil works
6	from the perspective of Git users.
7
8
9	## Help Improve This Document
10
11	If you have a lot of prior Git experience, and you are new to Fossil
12	and are struggling with some concepts, please ask for help on the
13	[Fossil Forum][1]. The people who write this document are intimately
14	familiar with Fossil and less familiar with Git. It is difficult for
15	us to anticipate the perspective of people who are initimately familiar
16	with Git and less familiar with Fossil. Asking questions on the Forum
17	will help us to improve the document.
18
19	[1]: https://fossil-scm.org/forum
20
21	Specific suggestions on how to improve this document are also welcomed,
22	of course.
23
24
25
26	## <a id="term"></a> Terminology
27
28	While we do try to explain Fossil-specific terminology inline here
29	as-needed, you may find it helpful to skim [the Fossil glossary][gloss].
30	It will give you another take on our definitions here, and it may help
31	you to understand some of the other Fossil docs better.
32
33
	-----

34
35
36	<a id="mwd"></a>
37	## Repositories And Checkouts Are Distinct
38
39

	--- www/gitusers.md
	+++ www/gitusers.md
	@@ -1,39 +1,36 @@
1	# Git 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` 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?”
19
20	This document’s authors are intimately familiar with Fossil, so it is
21	difficult for us to anticipate the perspective of people who are
22	initimately familiar with Git. If you have a lot of prior Git
23	experience, we welcome your contributions and questions on the [Fossil
24	Forum][ffor].


25
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	[ffor]: https://fossil-scm.org/forum
32
33
34	<a id="mwd"></a>
35	## Repositories And Checkouts Are Distinct
36
37

Fossil SCM

Keyboard Shortcuts