This is the re-roll of the po/range-doc (2016-07-01) 3 commits and its
follow on patch.
The series has gained additional patches following the discussions
($gmane/298790).
The original first 3 patches are unchanged, though 2/8 has been inserted
to name the Left and Right ranges.
The extra four patches carefully tease out the clarification of
reachability. Reachability is defined relative the ancestry chain thus
(hopefully) avoiding misunderstandings.
The final patch updates the summary examples, and the tricky (for the
untutored reader) two dots case of a linear development where r1..r2
excludes r1 itself.
The patches can be squashed together if required.
Original discussion starts at: $gmane/297908
V1 patch series $gmane/298223
V2 patch series $gmane/298689
Philip Oakley (8):
doc: use 'symmetric difference' consistently
doc: revisions - name the Left and Right sides
doc: show the actual left, right, and boundary marks
doc: give headings for the two and three dot notations
doc: gitrevisions - use 'reachable' in page description
doc: gitrevisions - clarify 'latter case' is revision walk
doc: revisions - define `reachable`
doc: revisions - clarify reachability examples
Documentation/gitk.txt | 2 +-
Documentation/gitrevisions.txt | 6 ++---
Documentation/pretty-formats.txt | 2 +-
Documentation/rev-list-options.txt | 4 +--
Documentation/revisions.txt | 50 ++++++++++++++++++++++++++------------
5 files changed, 41 insertions(+), 23 deletions(-)
--
2.8.4.windows.1.3.ge328a54
follows from msg-ID [ref]