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

From: Junio C Hamano <[email-masked]>
Date: Wed, 16 Oct 2013 14:40:18 -0700

Sitaram Chamarty <[email-masked]> writes:

>   - describe when it is still applicable
>   - tell people where to go for most normal cases
>
> Signed-off-by: Sitaram Chamarty <[email-masked]>
> ---
>
> 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.