Re: [PATCH 3/3] api-credentials.txt: add "see also" section

From: Matthieu Moy <matthieu.moy@grenoble-inp.fr>
Date: Jun 5, 2012, 11:20 UTC
Message-ID: <vpqaa0ij98q.fsf@bauges.imag.fr>
In-Reply-To: <20120605073403.GC25809@sigill.intra.peff.net>

Jeff King <peff@peff.net> writes:

>> I wonder if we could even make asciidoc work to convert
>> linkgit:git-config[1] into the right path (i.e., to include the ".."
>> automatically) when we are in the subdir.

Why not. I don't really care about eye candiness in technical/, but it can make sense to make an effort at least for howto/ (which doesn't contain links as of now, though).

Show 17 quoted lines

> diff --git a/Documentation/Makefile b/Documentation/Makefile
> index 14286cb..b3693c8 100644
> --- a/Documentation/Makefile
> +++ b/Documentation/Makefile
> @@ -280,6 +280,7 @@ technical/api-index.txt: technical/api-index-skel.txt \
>  	technical/api-index.sh $(patsubst %,%.txt,$(API_DOCS))
>  	$(QUIET_GEN)cd technical && '$(SHELL_PATH_SQ)' ./api-index.sh
>  
> +technical/%.html: ASCIIDOC_EXTRA += -a git-relative-html-prefix=../
>  $(patsubst %,%.html,$(API_DOCS) technical/api-index): %.html : %.txt
>  	$(QUIET_ASCIIDOC)$(ASCIIDOC) -b xhtml11 -f asciidoc.conf \
>  		$(ASCIIDOC_EXTRA) -agit_version=$(GIT_VERSION) $*.txt
> @@ -333,6 +334,7 @@ $(patsubst %,%.html,$(ARTICLES)) : %.html : %.txt
>  
>  WEBDOC_DEST = /pub/software/scm/git/docs
>  
> +howto/%.html: ASCIIDOC_EXTRA += git-relative-html-prefix=../

Don't you miss a "-a" between += and git-relative-html-prefix?

-- 
Matthieu Moy
http://www-verimag.imag.fr/~moy/