From: Jari Aalto <jari.aalto@cante.net>
Date: Mon, 31 Aug 2009 07:46:06 GMT
Subject: Re: [PATCH] Documentation/git-add.txt: Explain --patch option in layman terms
Message-ID: <87y6p08lz5.fsf@jondo.cante.net>
In-Reply-To: <7vbplw28js.fsf@alter.siamese.dyndns.org>

Junio C Hamano <gitster@pobox.com> writes:

I apologize if you though I did not read. I did, but I the separate
paragraph order did not meet here as you might have intended.

To recap, your suggestion, if read correct:

    --patch:
    -p::
        Review the difference between the index and the work tree, and add
        modified contents to the index interactively by choosing which
        patch hunks to use.

        Run ``add --interactive``, but bypass the initial command menu and
        directly jump to `patch` subcommand.  See ``Interactive mode'' for
        details.

For more direct first line, howabout:

    --patch:
    -p::
        In a modified work tree, choose interactively which patch hunks to
        add. This gives a change to review the difference between the
        index and the work before adding modified contents to the index.

        This effectively runs ``add --interactive``, but bypass the
        initial command menu and directly jump to `patch` subcommand.
        See ``Interactive mode'' for details.

Jari