[RFH] 'man:' macro for asciidoc

From: Jakub Narebski <jnareb@gmail.com>
Date: Mar 3, 2012, 18:33 UTC
Message-ID: <m31up9v8jo.fsf_-_@localhost.localdomain>
In-Reply-To: <20120303174252.GC28602@sigill.intra.peff.net>

Jeff King <peff@peff.net> writes:

> On Sat, Mar 03, 2012 at 03:50:53PM +0100, Clemens Buchacher wrote:

Show 18 quoted lines

> >  http.proxy::
> > -	Override the HTTP proxy, normally configured using the 'http_proxy'
> > -	environment variable (see linkgit:curl[1]).  This can be overridden
> > -	on a per-remote basis; see remote.<name>.proxy
> > +	Override the HTTP proxy, normally configured using the 'http_proxy',
> > +	'https_proxy', and 'all_proxy' environment variables (see
> > +	linkgit:curl[1]).  This can be overridden on a per-remote basis; see
> > +	remote.<name>.proxy
> 
> Text looks OK. I think this linkgit:curl is wrong, though. In the
> manpages, it formats as simply curl(1), but in the HTML pages, it
> creates a link to curl.html, which does not exist. This is not a problem
> introduced by your patch, obviously, but maybe it is worth cleaning up.
> I think just using:
> 
>   `curl(1)`
> 
> might be sufficient.

BTW it wouldreally be nice be able to use simply man:curl[1] instead of worrying if it shoudl be `curl(1)`, or *curl*(1), or curl(1)

-- 
Jakub Narebski