1
0
mirror of https://github.com/git/git.git synced 2024-10-22 17:09:18 +02:00
git/Documentation/technical
Jeff King 1c9b659d98 pack-protocol: clarify LF-handling in PKT-LINE()
The spec is very inconsistent about which PKT-LINE() parts
of the grammar include a LF. On top of that, the code is not
consistent, either (e.g., send-pack does not put newlines
into the ref-update commands it sends).

Let's make explicit the long-standing expectation that we
generally expect pkt-lines to end in a newline, but that
receivers should be lenient. This makes the spec consistent,
and matches what git already does (though it does not always
fulfill the SHOULD).

We do make an exception for the push-cert, where the
receiving code is currently a bit pickier. This is a
reasonable way to be, as the data needs to be byte-for-byte
compatible with what was signed. We _could_ make up some
rules about signing a canonicalized version including
newlines, but that would require a code change, and is out
of scope for this patch.

Signed-off-by: Jeff King <peff@peff.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2015-09-03 15:18:12 -07:00
..
.gitignore
api-allocation-growing.txt
api-argv-array.txt argv-array: implement argv_array_pushv() 2015-06-15 12:40:49 -07:00
api-builtin.txt
api-config.txt
api-credentials.txt
api-decorate.txt
api-diff.txt
api-directory-listing.txt
api-error-handling.txt
api-gitattributes.txt
api-grep.txt
api-hashmap.txt
api-history-graph.txt
api-in-core-index.txt
api-index-skel.txt
api-index.sh
api-merge.txt
api-object-access.txt
api-parse-options.txt Merge branch 'pt/pull-builtin' 2015-08-03 11:01:17 -07:00
api-quote.txt
api-ref-iteration.txt
api-remote.txt
api-revision-walking.txt
api-run-command.txt
api-setup.txt
api-sha1-array.txt
api-sigchain.txt
api-string-list.txt
api-submodule-config.txt submodule: use new config API for worktree configurations 2015-08-19 11:43:10 -07:00
api-trace.txt
api-tree-walking.txt
api-xdiff-interface.txt
bitmap-format.txt
http-protocol.txt
index-format.txt Merge branch 'ta/docfix-index-format-tech' 2015-08-17 15:07:52 -07:00
pack-format.txt
pack-heuristics.txt
pack-protocol.txt pack-protocol: clarify LF-handling in PKT-LINE() 2015-09-03 15:18:12 -07:00
protocol-capabilities.txt
protocol-common.txt pack-protocol: clarify LF-handling in PKT-LINE() 2015-09-03 15:18:12 -07:00
racy-git.txt Makefile / racy-git.txt: clarify USE_NSEC prerequisites 2015-07-01 14:54:42 -07:00
send-pack-pipeline.txt
shallow.txt
trivial-merge.txt