diff options
| author | Tay Ray Chuan <rctay89@gmail.com> | 2013-09-11 01:07:57 +0800 |
|---|---|---|
| committer | Junio C Hamano <gitster@pobox.com> | 2013-09-11 14:07:15 -0700 |
| commit | d0edb1a8bd90dfd1d2c51dd396773453f7d8508d (patch) | |
| tree | 5f1a22441c24cc76d0a7aab77a73a9682d8487b5 | |
| parent | a9537587adbdffdaf15874f5ec6ffde6cdf58ebe (diff) | |
| download | git-d0edb1a8bd90dfd1d2c51dd396773453f7d8508d.tar.gz | |
shift dumb server response details
Shift details like ABNF from the client section to server section. This
is in line with the smart analogue.
Signed-off-by: Tay Ray Chuan <rctay89@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
| -rw-r--r-- | Documentation/technical/http-protocol.txt | 49 |
1 files changed, 23 insertions, 26 deletions
diff --git a/Documentation/technical/http-protocol.txt b/Documentation/technical/http-protocol.txt index 63a089aaae..3098aa494b 100644 --- a/Documentation/technical/http-protocol.txt +++ b/Documentation/technical/http-protocol.txt @@ -162,30 +162,6 @@ without any search/query parameters. E.g. S: 2cb58b79488a98d2721cea644875a8dd0026b115 refs/tags/v1.0\n S: a3c2e2402b99163d1d59756e5f207ae21cccba4c refs/tags/v1.0^{}\n -The Content-Type of the returned info/refs entity SHOULD be -"text/plain; charset=utf-8", but MAY be any content type. -Clients MUST NOT attempt to validate the returned Content-Type. -Dumb servers MUST NOT return a return type starting with -"application/x-git-". - -Cache-Control headers MAY be returned to disable caching of the -returned entity. - -When examining the response clients SHOULD only examine the HTTP -status code. Valid responses are '200 OK', or '304 Not Modified'. - -The returned content is a UNIX formatted text file describing -each ref and its known value. The file SHOULD be sorted by name -according to the C locale ordering. The file SHOULD NOT include -the default ref named 'HEAD'. - - info_refs = *( ref_record ) - ref_record = any_ref / peeled_ref - - any_ref = obj-id HTAB refname LF - peeled_ref = obj-id HTAB refname LF - obj-id HTAB refname "^{}" LF - Smart Clients ~~~~~~~~~~~~~ @@ -229,8 +205,29 @@ Dumb Server Response ^^^^^^^^^^^^^^^^^^^^ Dumb servers MUST respond with the dumb server reply format. -See the prior section under dumb clients for a more detailed -description of the dumb server response. +The Content-Type of the returned info/refs entity SHOULD be +"text/plain; charset=utf-8", but MAY be any content type. +Clients MUST NOT attempt to validate the returned Content-Type. +Dumb servers MUST NOT return a return type starting with +"application/x-git-". + +Cache-Control headers MAY be returned to disable caching of the +returned entity. + +When examining the response clients SHOULD only examine the HTTP +status code. Valid responses are '200 OK', or '304 Not Modified'. + +The returned content is a UNIX formatted text file describing +each ref and its known value. The file SHOULD be sorted by name +according to the C locale ordering. The file SHOULD NOT include +the default ref named 'HEAD'. + + info_refs = *( ref_record ) + ref_record = any_ref / peeled_ref + + any_ref = obj-id HTAB refname LF + peeled_ref = obj-id HTAB refname LF + obj-id HTAB refname "^{}" LF Smart Server Response ^^^^^^^^^^^^^^^^^^^^^ |