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 <20160630202509.4472-1-philipoakley@xxxxxxx> -- To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html