Re: [PATCH] Documentation: don't link to example mail addresses

2012-12-17 Thread John Keeping
On Sun, Dec 16, 2012 at 09:29:24PM -0800, Junio C Hamano wrote: > John Keeping writes: >> Here `` is the person's display name (for example >> ``Com M Itter'') and `` is the person's email address >> -(``c...@example.com''). `LT` and `GT` are the literal less-than (\x3c) >> +(``$$c...@example.c

Re: [PATCH] Documentation: don't link to example mail addresses

2012-12-16 Thread Junio C Hamano
John Keeping writes: > I can't see any other uses of the "$$" quote in the documentation, so > it's probably worth noting that I've tested this with Asciidoc 8.6.8, > although I can't see anything in the changelog to indicate that > Asciidoc's treatment of it has changed recently. Thanks. > Do

Re: [PATCH] Documentation: don't link to example mail addresses

2012-12-16 Thread Jeff King
On Sat, Dec 15, 2012 at 06:24:09PM +, John Keeping wrote: > > I think I'd just render them monospace everywhere. We are very > > inconsistent about which form of quotes we use in the documentation (I > > think because most of the developers read the source directly and not > > the rendered asc

Re: [PATCH] Documentation: don't link to example mail addresses

2012-12-15 Thread John Keeping
On Sat, Dec 15, 2012 at 12:20:18PM -0500, Jeff King wrote: > On Sat, Dec 15, 2012 at 03:03:15PM +, John Keeping wrote: >> Mail 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

Re: [PATCH] Documentation: don't link to example mail addresses

2012-12-15 Thread Junio C Hamano
Jeff King writes: > I think I'd just render them monospace everywhere. We are very > inconsistent about which form of quotes we use in the documentation (I > think because most of the developers read the source directly and not > the rendered asciidoc). And then we don't have to worry about the "

Re: [PATCH] Documentation: don't link to example mail addresses

2012-12-15 Thread Jeff King
On Sat, Dec 15, 2012 at 03:03:15PM +, John Keeping wrote: > Mail 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 annoy

[PATCH] Documentation: don't link to example mail addresses

2012-12-15 Thread John Keeping
Mail 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 "jane@laptop.(none)" which appears in git-shortlog(1)