# [PATCH 2/2] Document "git log --simplify-by-decoration" 2 messages from 2008-11-10 to 2008-11-10. Participants: Nanako Shiraishi, Santi Béjar. Thread: https://gitlist.dev/t/16246 ## Nanako Shiraishi, 2008-11-10 09:58 Subject: [PATCH 2/2] Document "git log --simplify-by-decoration" Message-ID: <20081110185817.6117@nanako3.lavabit.com> URL: https://gitlist.dev/e/20081110185817.6117%40nanako3.lavabit.com ``` Signed-off-by: Nanako Shiraishi --- Documentation/rev-list-options.txt | 7 +++++++ 1 files changed, 7 insertions(+), 0 deletions(-) diff --git a/Documentation/rev-list-options.txt b/Documentation/rev-list-options.txt index 966276b..977290c 100644 --- a/Documentation/rev-list-options.txt +++ b/Documentation/rev-list-options.txt @@ -456,6 +456,13 @@ Note the major differences in `N` and `P` over '\--full-history': removed completely, because it had one parent and is TREESAME. -- +The '\--simplify-by-decoration' option can be used to treat commits that +are not referenced by tags as TREESAME, and treat commits that are tagged +as !TREESAME (even when they have exactly the same tree as their parents). +This can be used when you are only interested in the big picture of the +topology of the history. + + ifdef::git-rev-list[] Bisection Helpers ~~~~~~~~~~~~~~~~~ -- 1.6.0.2 -- Nanako Shiraishi http://ivory.ap.teacup.com/nanako3/ ``` ## Santi Béjar, 2008-11-10 10:47 Subject: Re: [PATCH 2/2] Document "git log --simplify-by-decoration" Message-ID: URL: https://gitlist.dev/e/adf1fd3d0811100247n18d54644h9a0238832d22be7c%40mail.gmail.com In-Reply-To: <20081110185817.6117@nanako3.lavabit.com> ``` On Mon, Nov 10, 2008 at 10:58 AM, Nanako Shiraishi wrote: > Signed-off-by: Nanako Shiraishi > --- > Documentation/rev-list-options.txt | 7 +++++++ > 1 files changed, 7 insertions(+), 0 deletions(-) > > diff --git a/Documentation/rev-list-options.txt b/Documentation/rev-list-options.txt > index 966276b..977290c 100644 > --- a/Documentation/rev-list-options.txt > +++ b/Documentation/rev-list-options.txt > @@ -456,6 +456,13 @@ Note the major differences in `N` and `P` over '\--full-history': > removed completely, because it had one parent and is TREESAME. > -- > > +The '\--simplify-by-decoration' option can be used to treat commits that > +are not referenced by tags as TREESAME, and treat commits that are tagged > +as !TREESAME (even when they have exactly the same tree as their parents). > +This can be used when you are only interested in the big picture of the > +topology of the history. > + > + I prefer the other way around, first what it does, and then how it does it (but it is a general comment about the help in "History Simplification", at least when viewing the help for "git log"). And you should rewrite the line 416: Finally, there is a fourth simplification mode available as it is no longer "Finally". Santi ```