delta/git.git/Documentation/tutorial.txt, branch jk/diff-funcname-cpp-regex

Documentation: convert tutorials to man pages

2008-05-25T05:28:16+00:00

This patch renames the following documents and at the same time converts
them to the man page format:

cvs-migration.txt -> gitcvs-migration.txt
tutorial.txt      -> gittutorial.txt
tutorial-2.txt    -> gittutorial-2.txt

These new man pages are put in section 7, and other documents that reference
the above ones are change accordingly.

[jc: with help from Nanako to clean things up]

Signed-off-by: Christian Couder 
Signed-off-by: Junio C Hamano

Documentation: rename gitlink macro to linkgit

2008-01-07T02:41:44+00:00

Between AsciiDoc 8.2.2 and 8.2.3, the following change was made to the stock
Asciidoc configuration:

@@ -149,7 +153,10 @@
 # Inline macros.
 # Backslash prefix required for escape processing.
 # (?s) re flag for line spanning.
-(?su)[\\]?(?P\w(\w|-)*?):(?P\S*?)(\[(?P.*?)\])=
+
+# Explicit so they can be nested.
+(?su)[\\]?(?P(http|https|ftp|file|mailto|callto|image|link)):(?P\S*?)(\[(?P.*?)\])=
+
 # Anchor: [[[id]]]. Bibliographic anchor.
 (?su)[\\]?\[\[\[(?P[\w][\w-]*?)\]\]\]=anchor3
 # Anchor: [[id,xreflabel]]

This default regex now matches explicit values, and unfortunately in this
case gitlink was being matched by just 'link', causing the wrong inline
macro template to be applied. By renaming the macro, we can avoid being
matched by the wrong regex.

Signed-off-by: Dan McGee 
Signed-off-by: Junio C Hamano

Documentation: Correct various misspellings and typos.

2007-08-25T01:54:37+00:00

Fix minor typos throughout the documentation.

Signed-off-by: Brian Hetro 
Signed-off-by: Junio C Hamano

Merge branch 'maint'

2007-07-09T01:28:31+00:00

* maint:
  user-manual: fix directory name in git-archive example
  user-manual: more explanation of push and pull usage
  tutorial: Fix typo
  user-manual: grammar and style fixes

tutorial: Fix typo

2007-07-08T22:02:16+00:00

"You" should be "Alice" here.

Signed-off-by: "J. Bruce Fields"

fix remote.origin.url in tutorial.txt

2007-07-06T05:44:26+00:00

Bob cloned from Alice.
The origin url is actually Alice's repo.

Signed-off-by: Alecs King 
Signed-off-by: Junio C Hamano

tutorial: use "project history" instead of "changelog" in header

2007-06-10T20:46:17+00:00

The word "changelog" seems a little too much like jargon to me, and beginners
must understand section headers so they know where to look for help.

Signed-off-by: "J. Bruce Fields"

tutorial: revise index introduction

2007-05-19T05:00:27+00:00

The embarassing history of this tutorial is that I started it without
really understanding the index well, so I avoided mentioning it.

And we all got the idea that "index" was a word to avoid using around
newbies, but it was reluctantly mentioned that *something* had to be
said.  The result is a little awkward: the discussion of the index never
actually uses that word, and isn't well-integrated into the surrounding
material.

Let's just go ahead and use the word "index" from the very start, and
try to demonstrate its use with a minimum of lecturing.

Also, remove discussion of using git-commit with explicit filenames.
We're already a bit slow here to get people to their first commit, and
I'm not convinced this is really so important.

Signed-off-by: "J. Bruce Fields"

tutorials: add user-manual links

2007-05-19T04:57:19+00:00

Mention the user manual, especially as an alternative introduction for
user's mainly interested in read-only operations.

And fix a typo while we're there.

Signed-off-by: "J. Bruce Fields"

Mention version 1.5.1 in tutorial and user-manual

2007-05-04T23:58:03+00:00

Most other documentation will frequently be read from an installation
of git so will naturally be associated with the installed version.
But these two documents in particular are often read from web pages
while users are still exploring git. It's important to mention
version 1.5.1 since these documents provide example commands that
won't work with previous versions of git.

Signed-off-by: Junio C Hamano