Re: [PATCH] warn about http server document being too old

From: Junio C Hamano <gitster@pobox.com>
Date: Oct 16, 2013, 21:40 UTC
Message-ID: <xmqqli1s51z1.fsf@gitster.dls.corp.google.com>
In-Reply-To: <523D030A.6080309@gmail.com>

Sitaram Chamarty <sitaramc@gmail.com> writes:

Show 27 quoted lines

>   - describe when it is still applicable
>   - tell people where to go for most normal cases
>
> Signed-off-by: Sitaram Chamarty <sitaram@atc.tcs.com>
> ---
>
> ref: http://thread.gmane.org/gmane.comp.version-control.git/159633.  Yes
> it's very old but better late than never.
>
>  Documentation/howto/setup-git-server-over-http.txt | 5 +++++
>  1 file changed, 5 insertions(+)
>
> diff --git a/Documentation/howto/setup-git-server-over-http.txt b/Documentation/howto/setup-git-server-over-http.txt
> index 7f4943e..90b19a0 100644
> --- a/Documentation/howto/setup-git-server-over-http.txt
> +++ b/Documentation/howto/setup-git-server-over-http.txt
> @@ -3,6 +3,11 @@ Subject: Setting up a Git repository which can be pushed into and pulled from ov
>  Date: Thu, 10 Aug 2006 22:00:26 +0200
>  Content-type: text/asciidoc
>
> +NOTE: This document is from 2006.  A lot has happened since then, and this
> +document is now relevant mainly if your web host is not CGI capable.
> +
> +Almost everyone else should instead look at linkgit:git-http-backend[1].
> +
>  How to setup Git server over http
>  =================================

I tend to agree that it is a good idea to have this kind of phrase somewhere in the document, but you cannot place the material above the top-level title. AsciiDoc does not seem to like it.