Misc doc improvements
PATCH 1/1 Misc doc improvements
Signed-off-by Jonas Fonseca <[email protected]>
--- Documentation/git-apply.txt | 2 +- Documentation/git-shortlog.txt | 19 ++++++++++++++++--- Documentation/glossary.txt | 7 +++++++ 3 files changed, 24 insertions(+), 4 deletions(-)
Documentation/git-apply.txt +1 -1
@@ -76,7 +76,7 @@ OPTIONS -C<n>:: Ensure at least <n> lines of surrounding context match before and after each change. When fewer lines of surrounding - context exist they all most match. By default no context is + context exist they all must match. By default no context is ever ignored. --apply::
Documentation/git-shortlog.txt +16 -3
@@ -5,7 +5,6 @@ NAME ---- git-shortlog - Summarize 'git log' output - SYNOPSIS -------- git-log --pretty=short | 'git-shortlog'
@@ -13,8 +12,22 @@ git-log --pretty=short | 'git-shortlog' DESCRIPTION ----------- Summarizes 'git log' output in a format suitable for inclusion -in release announcements. - +in release announcements. Each commit will be grouped by author +the first line of the commit message will be shown. + +Additionally, "[PATCH]" will be stripped from the commit description. + +FILES +----- +'.mailcap':: + If this file exists, it will be used for mapping author email + addresses to a real author name. One mapping per line, first + the author name followed by the email address enclosed by + '<' and '>'. Use hash '#' for comments. Example: + + # Keep alphabetized + Adam Morrow <[email protected]> + Eve Jones <eve@laptop.(none)> Author ------
Documentation/glossary.txt +7 -0
@@ -109,6 +109,13 @@ file system:: git archive:: Synonym for repository (for arch people). +grafts:: + Grafts enables two otherwise different lines of development to be + joined together by recording fake ancestry information for commits. + This way you can make git pretend the set of parents a commit + has is different from what was recorded when the commit was created. + Configured via the `.git/info/grafts` file. + hash:: In git's context, synonym to object name.
Signature · 3 lines
1.4.0.rc1.gfd4c-dirty -- Jonas Fonseca
Documentation/glossary.txt file system:: · line 117
Quoted 6 lines · Jonas Fonseca
Documentation/glossary.txt +6
-0+grafts:: + Grafts enables two otherwise different lines of development to be + joined together by recording fake ancestry information for commits. + This way you can make git pretend the set of parents a commit + has is different from what was recorded when the commit was created. + Configured via the `.git/info/grafts` file.
Actually, grafts are used to "fake" (or change) parents (ancestry) of an existing commit. It can be used both to add parents (e.g. joining roots of "current" repository with historical one), or remove parents (e.g. to shorten (cauterize) history like in the "shalllow clone" idea).
Signature · 2 lines
Jakub Narebski Warsaw, Poland