<feed xmlns='http://www.w3.org/2005/Atom'>
<title>git/Documentation/technical/http-protocol.txt, branch v2.22.2</title>
<subtitle>Mirror of https://git.kernel.org/pub/scm/git/git.git/
</subtitle>
<id>https://git.shady.money/git/atom?h=v2.22.2</id>
<link rel='self' href='https://git.shady.money/git/atom?h=v2.22.2'/>
<link rel='alternate' type='text/html' href='https://git.shady.money/git/'/>
<updated>2018-07-30T18:25:20Z</updated>
<entry>
<title>doc: fix want-capability separator</title>
<updated>2018-07-30T18:25:20Z</updated>
<author>
<name>Masaya Suzuki</name>
<email>draftcode@gmail.com</email>
</author>
<published>2018-07-28T21:16:30Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/git/commit/?id=742587662fbdf487eb85e847f6253a4f5dcf18fa'/>
<id>urn:sha1:742587662fbdf487eb85e847f6253a4f5dcf18fa</id>
<content type='text'>
Unlike ref advertisement, client capabilities and the first want are
separated by SP, not NUL, in the implementation. Fix the documentation
to align with the implementation. pack-protocol.txt is already fixed.

Signed-off-by: Masaya Suzuki &lt;masayasuzuki@google.com&gt;
Signed-off-by: Junio C Hamano &lt;gitster@pobox.com&gt;
</content>
</entry>
<entry>
<title>smart-http: document flush after "# service" line</title>
<updated>2018-03-05T19:05:19Z</updated>
<author>
<name>Jeff King</name>
<email>peff@peff.net</email>
</author>
<published>2018-03-03T05:27:08Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/git/commit/?id=0aa7a780995d3bbef4524a2cdc2e5d33cca56fa9'/>
<id>urn:sha1:0aa7a780995d3bbef4524a2cdc2e5d33cca56fa9</id>
<content type='text'>
The http-protocol.txt spec fails to mention that a flush packet
comes in the smart server response after sending the "service"
header.

Technically the client code is actually ready to receive an
arbitrary number of headers here, but since we haven't
introduced any other headers in the past decade (and the
client would just throw them away), let's not mention it in
the spec.

This fixes both BNF and the example. While we're fixing the
latter, let's also add the missing flush after the ref list.

Reported-by: Dorian Taylor &lt;dorian.taylor.lists@gmail.com&gt;
Signed-off-by: Jeff King &lt;peff@peff.net&gt;
Signed-off-by: Junio C Hamano &lt;gitster@pobox.com&gt;
</content>
</entry>
<entry>
<title>Documentation: document Extra Parameters</title>
<updated>2017-10-17T01:51:30Z</updated>
<author>
<name>Jonathan Tan</name>
<email>jonathantanmy@google.com</email>
</author>
<published>2017-10-16T17:55:32Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/git/commit/?id=6464679d9620d91b639e2681b9cc6473f3856d09'/>
<id>urn:sha1:6464679d9620d91b639e2681b9cc6473f3856d09</id>
<content type='text'>
Document the server support for Extra Parameters, additional information
that the client can send in its first message to the server during a
Git client-server interaction.

Signed-off-by: Jonathan Tan &lt;jonathantanmy@google.com&gt;
Signed-off-by: Brandon Williams &lt;bmwill@google.com&gt;
Signed-off-by: Junio C Hamano &lt;gitster@pobox.com&gt;
</content>
</entry>
<entry>
<title>upload-pack: optionally allow fetching reachable sha1</title>
<updated>2015-05-23T01:25:36Z</updated>
<author>
<name>Fredrik Medley</name>
<email>fredrik.medley@gmail.com</email>
</author>
<published>2015-05-21T20:23:39Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/git/commit/?id=68ee628932c2196742b77d2961c5e16360734a62'/>
<id>urn:sha1:68ee628932c2196742b77d2961c5e16360734a62</id>
<content type='text'>
With uploadpack.allowReachableSHA1InWant configuration option set on the
server side, "git fetch" can make a request with a "want" line that names
an object that has not been advertised (likely to have been obtained out
of band or from a submodule pointer). Only objects reachable from the
branch tips, i.e. the union of advertised branches and branches hidden by
transfer.hideRefs, will be processed. Note that there is an associated
cost of having to walk back the history to check the reachability.

This feature can be used when obtaining the content of a certain commit,
for which the sha1 is known, without the need of cloning the whole
repository, especially if a shallow fetch is used. Useful cases are e.g.
repositories containing large files in the history, fetching only the
needed data for a submodule checkout, when sharing a sha1 without telling
which exact branch it belongs to and in Gerrit, if you think in terms of
commits instead of change numbers. (The Gerrit case has already been
solved through allowTipSHA1InWant as every Gerrit change has a ref.)

Signed-off-by: Fredrik Medley &lt;fredrik.medley@gmail.com&gt;
Signed-off-by: Junio C Hamano &lt;gitster@pobox.com&gt;
</content>
</entry>
<entry>
<title>Merge branch 'ye/doc-http-proto'</title>
<updated>2014-06-25T19:23:52Z</updated>
<author>
<name>Junio C Hamano</name>
<email>gitster@pobox.com</email>
</author>
<published>2014-06-25T19:23:52Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/git/commit/?id=ccca6b6523d7071cd0ee09fd00ea3e05d4b8e3eb'/>
<id>urn:sha1:ccca6b6523d7071cd0ee09fd00ea3e05d4b8e3eb</id>
<content type='text'>
* ye/doc-http-proto:
  http-protocol.txt: Basic Auth is defined in RFC 2617, not RFC 2616
</content>
</entry>
<entry>
<title>http-protocol.txt: Basic Auth is defined in RFC 2617, not RFC 2616</title>
<updated>2014-06-16T19:00:43Z</updated>
<author>
<name>Yi EungJun</name>
<email>eungjun.yi@navercorp.com</email>
</author>
<published>2014-06-14T19:09:29Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/git/commit/?id=04953bc888e648dc22c172ffa74de1b2a08a209a'/>
<id>urn:sha1:04953bc888e648dc22c172ffa74de1b2a08a209a</id>
<content type='text'>
Signed-off-by: Yi EungJun &lt;eungjun.yi@navercorp.com&gt;
Signed-off-by: Junio C Hamano &lt;gitster@pobox.com&gt;
</content>
</entry>
<entry>
<title>Documentation: use "command-line" when used as a compound adjective, and fix other minor grammatical issues</title>
<updated>2014-05-21T20:57:10Z</updated>
<author>
<name>Jason St. John</name>
<email>jstjohn@purdue.edu</email>
</author>
<published>2014-05-21T18:52:26Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/git/commit/?id=06ab60c06606613f238f3154cb27cb22d9723967'/>
<id>urn:sha1:06ab60c06606613f238f3154cb27cb22d9723967</id>
<content type='text'>
Signed-off-by: Jason St. John &lt;jstjohn@purdue.edu&gt;
Signed-off-by: Junio C Hamano &lt;gitster@pobox.com&gt;
</content>
</entry>
<entry>
<title>Documentation: fix documentation AsciiDoc links for external urls</title>
<updated>2014-02-20T22:14:58Z</updated>
<author>
<name>Roberto Tyley</name>
<email>roberto.tyley@gmail.com</email>
</author>
<published>2014-02-18T21:42:22Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/git/commit/?id=2df85669d16703714968572937ebb67a31241ca3'/>
<id>urn:sha1:2df85669d16703714968572937ebb67a31241ca3</id>
<content type='text'>
Turns out that putting 'link:' before the 'http' is actually superfluous
in AsciiDoc, as there's already a predefined macro to handle it.

"http, https, [etc] URLs are rendered using predefined inline macros."
http://www.methods.co.nz/asciidoc/userguide.html#_urls

"Hypertext links to files on the local file system are specified
using the link inline macro."
http://www.methods.co.nz/asciidoc/userguide.html#_linking_to_local_documents

Despite being superfluous, the reference implementation of AsciiDoc
tolerates the extra 'link:' and silently removes it, giving a functioning
link in the generated HTML. However, AsciiDoctor (the Ruby implementation
of AsciiDoc used to render the http://git-scm.com/ site) does /not/ have
this behaviour, and so generates broken links, as can be seen here:

http://git-scm.com/docs/git-cvsimport (links to cvs2git &amp; parsecvs)
http://git-scm.com/docs/git-filter-branch (link to The BFG)

It's worth noting that after this change, the html generated by 'make html'
in the git project is identical, and all links still work.

Signed-off-by: Roberto Tyley &lt;roberto.tyley@gmail.com&gt;
Signed-off-by: Junio C Hamano &lt;gitster@pobox.com&gt;
</content>
</entry>
<entry>
<title>http-protocol.txt: don't use uppercase for variable names in "The Negotiation Algorithm"</title>
<updated>2014-01-27T17:06:26Z</updated>
<author>
<name>Thomas Ackermann</name>
<email>th.acker@arcor.de</email>
</author>
<published>2014-01-26T12:56:17Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/git/commit/?id=9c96c7f3aa12afbc8e859b930bdb9d9b22080470'/>
<id>urn:sha1:9c96c7f3aa12afbc8e859b930bdb9d9b22080470</id>
<content type='text'>
Signed-off-by: Thomas Ackermann &lt;th.acker@arcor.de&gt;
Signed-off-by: Junio C Hamano &lt;gitster@pobox.com&gt;
</content>
</entry>
<entry>
<title>create HTML for http-protocol.txt</title>
<updated>2014-01-27T17:02:02Z</updated>
<author>
<name>Thomas Ackermann</name>
<email>th.acker@arcor.de</email>
</author>
<published>2014-01-26T12:57:19Z</published>
<link rel='alternate' type='text/html' href='https://git.shady.money/git/commit/?id=586aa7863141ad07fd6eb45349a3cb62fdcd28ea'/>
<id>urn:sha1:586aa7863141ad07fd6eb45349a3cb62fdcd28ea</id>
<content type='text'>
./Documentation/technical/http-protocol.txt was missing from TECH_DOCS in Makefile.
Add it and also improve HTML formatting while still retaining good readability of the ASCII text:
- Use monospace font instead of italicized or roman font for machine output and source text
- Use roman font for things which should be body text
- Use double quotes consistently for "want" and "have" commands
- Use uppercase "C" / "S" consistently for "client" / "server";
  also use "C:" / "S:" instead of "(C)" / "(S)" for consistency and
  to avoid having formatted "(C)" as copyright symbol in HTML
- Use only spaces and not a combination of tabs and spaces for whitespace

Signed-off-by: Thomas Ackermann &lt;th.acker@arcor.de&gt;
Signed-off-by: Junio C Hamano &lt;gitster@pobox.com&gt;
</content>
</entry>
</feed>
