[PATCH] warn about http server document being too old

[PATCH] warn about http server document being too old

[Sitaram Chamarty]

  - 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
 =================================

-- 
1.8.3.1

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

[Junio C Hamano]

Sitaram Chamarty <sitaramc@gmail.com> writes:

>   - 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.

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

[Junio C Hamano]

Junio C Hamano <gitster@pobox.com> writes:

> Sitaram Chamarty <sitaramc@gmail.com> writes:
>
>>   - 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.

I've amended this trivially, as follows.  Will advance it to 'next'.

Thanks.

-- >8 --
From: Sitaram Chamarty <sitaramc@gmail.com>
Date: Sat, 21 Sep 2013 07:53:06 +0530
Subject: [PATCH] doc/howto: warn about (dumb)http server document being too old

Describe when it is still applicable, and tell people where to go
for most normal cases.

Signed-off-by: Sitaram Chamarty <sitaram@atc.tcs.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
---
 Documentation/howto/setup-git-server-over-http.txt | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Documentation/howto/setup-git-server-over-http.txt b/Documentation/howto/setup-git-server-over-http.txt
index 7f4943e..c803649 100644
--- a/Documentation/howto/setup-git-server-over-http.txt
+++ b/Documentation/howto/setup-git-server-over-http.txt
@@ -6,6 +6,10 @@ Content-type: text/asciidoc
 How to setup Git server over http
 =================================
 
+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].
+
 Since Apache is one of those packages people like to compile
 themselves while others prefer the bureaucrat's dream Debian, it is
 impossible to give guidelines which will work for everyone. Just send
-- 
1.8.5-rc0-175-g776cf91