Jeff King wrote:

> Originally we had a single function for reading packetized
> data: packet_read_line. Commit 46284dd grew a more "gentle"
> form that would return an error instead of dying upon
> reading a truncated input stream. However:

In other words:

        Based on the names of two functions "packet_read" and
        "packet_read_line", it is not obvious which to use and what the
        ramifications of that choice are.

        Rename packet_read to packet_read_line_gently and add a comment
        explaining that the latter is a "gentler" form that returns an
        error instead of dying upon reading a truncated input stream.

        While at it:

         * Rename the internal argument triggering the gentle mode to
           "gentle" instead of "return_line_fail".

         * Drop the redundant "return_line_fail &&" in checks like
           "if (return_line_fail && ret < 0)".  safe_read() never
           returns an error when !gentle.

        No functional change intended.

FWIW, the patch itself is
Reviewed-by: Jonathan Nieder <jrnie...@gmail.com>
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Reply via email to