[2nd attempt : ISP troubles]
This has grown like topsy from a little two patch series that tried to
name the 2-dots notation [1] into this extended set of tweaks.
As documentation can be rather personal, I've split out each small change
so each can be individually justified.
Since V4, I've confirmed that the format breaking issue is that we cannot
quote code in headings in the man page layout - ultimately it's a docbook
decision, and follows the line of analysis Peff identified (see commentary
in the patch).
In addition the multi-parent notations have been clarified and extended.
Thus the old patch 4 has been split into three. The first three patches are
unchanged. The following 4 patches are also unchanged.
Finally, at the end an extra 2 patches are added to build up the examples by
including details of the notation expansions.
This updates po/range-doc (2016-07-20) 8 commits.
Hopefully my updated workflow will get the right patches to the right people.
[1] https://public-inbox.org/git/0648000B273C412AB7140AE959EBC99A%40PhilipOakley/
Philip Oakley (12):
doc: use 'symmetric difference' consistently
doc: revisions - name the left and right sides
doc: show the actual left, right, and boundary marks
doc: revisions: give headings for the two and three dot notations
doc: revisions: extra clarification of <rev>^! notation effects
doc: revisions: single vs multi-parent notation comparison
doc: gitrevisions - use 'reachable' in page description
doc: gitrevisions - clarify 'latter case' is revision walk
doc: revisions - define `reachable`
doc: revisions - clarify reachability examples
doc: revisions: show revision expansion in examples
doc: revisions: sort examples and fix alignment of the unchanged
Documentation/gitk.txt | 2 +-
Documentation/gitrevisions.txt | 6 +-
Documentation/pretty-formats.txt | 2 +-
Documentation/rev-list-options.txt | 4 +-
Documentation/revisions.txt | 121 +++++++++++++++++++++++--------------
5 files changed, 84 insertions(+), 51 deletions(-)
--
2.9.0.windows.1