[PATCH 1/7] pack-protocol.txt: Add warning about protocol inaccuracies
- From
Dave Borowitz <dborowitz@google.com>
- Date
- Jul 1, 2015, 18:08 UTC
- Message-ID
- <1435774099-21260-2-git-send-email-dborowitz@google.com>
- In-Reply-To
- <1435774099-21260-1-git-send-email-dborowitz@google.com>
We want to fix such inaccuracies, but there are a lot and there is no guarantee at any particular point in time that this document will be error-free.
Signed-off-by: Dave Borowitz <dborowitz@google.com> --- Documentation/technical/pack-protocol.txt | 11 +++++++++++ 1 file changed, 11 insertions(+)
diff --git a/Documentation/technical/pack-protocol.txt b/Documentation/technical/pack-protocol.txt index 4064fc7..66d2d95 100644 --- a/Documentation/technical/pack-protocol.txt +++ b/Documentation/technical/pack-protocol.txt @@ -14,6 +14,17 @@ data. The protocol functions to have a server tell a client what is currently on the server, then for the two to negotiate the smallest amount of data to send in order to fully update one or the other. +Notes to Implementors +--------------------- + +WARNING: This document is a work in progress. Some of the protocol +specifications below may be incomplete or inaccurate. When in doubt, +refer to the C code. + +One particular example is that many of the LFs referenced in the +specifications are optional, but may (yet) not be marked as such. If not +explicitly marked one way or the other, double-check with the C code. + Transports ---------- There are three transports over which the packfile protocol is
-- 2.4.3.573.g4eafbef