Commit f430ed8b authored by John Keeping's avatar John Keeping Committed by Junio C Hamano

Documentation: don't link to example mail addresses

Email addresses in documentation are converted into mailto: hyperlinks
in the HTML output and footnotes in man pages.  This isn't desirable for
cases where the address is used as an example and is not valid.

Particularly annoying is the example "[email protected](none)" which appears
in git-shortlog(1) as "[email protected][1].(none)", with note 1 saying:

	1. [email protected]
	   mailto:[email protected]

Fix this by escaping these email addresses with a leading backslash, to
prevent Asciidoc expanding them as inline macros.

In the case of mailmap.txt, render the address monospaced so that it
matches the block examples surrounding that paragraph.
Helped-by: default avatarJeff King <[email protected]>
Signed-off-by: John Keeping's avatarJohn Keeping <[email protected]>
Signed-off-by: default avatarJunio C Hamano <[email protected]>
parent bdd478d6
......@@ -427,7 +427,7 @@ they made it.
Here `<name>` is the person's display name (for example
``Com M Itter'') and `<email>` is the person's email address
(``[email protected]''). `LT` and `GT` are the literal less-than (\x3c)
(``\[email protected]''). `LT` and `GT` are the literal less-than (\x3c)
and greater-than (\x3e) symbols. These are required to delimit
the email address from the other fields in the line. Note that
`<name>` and `<email>` are free-form and may contain any sequence
......@@ -129,7 +129,7 @@ This option is only applicable when listing tags without annotation lines.
By default, 'git tag' in sign-with-default mode (-s) will use your
committer identity (of the form "Your Name <[email protected]>") to
committer identity (of the form "Your Name <\[email protected]>") to
find a key. If you want to use a different default key, you can specify
it in the repository configuration as follows:
......@@ -46,7 +46,7 @@ Jane Doe <[email protected](none)>
Joe R. Developer <[email protected]>
Note how there is no need for an entry for <[email protected](none)>, because the
Note how there is no need for an entry for `<[email protected](none)>`, because the
real name of that author is already correct.
Example 2: Your repository contains commits from the following
Markdown is supported
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment