{"thread":{"id":"9004","subject":"[PATCH] Documentation for git-log --follow","startedAt":"2007-07-12T14:52:30Z","lastAt":"2007-07-13T14:47:19Z","messageCount":3,"participants":["Steven Walter","Linus Torvalds","Johannes Schindelin"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"47167","messageId":"20070712145230.GA21590@dervierte","threadId":"9004","inReplyTo":null,"subject":"[PATCH] Documentation for git-log --follow","fromName":"Steven Walter","fromEmail":"stevenrwalter@gmail.com","sentAt":"2007-07-12T14:52:30Z","receivedAt":"2007-07-12T14:52:30Z","isPatch":true,"sender":{"key":"stevenrwalter@gmail.com","avatar":"https://avatars.githubusercontent.com/u/79127?v=4"},"body":"After vainly searching the Documentation for how to follow renames, I\nfinally broke down and grepped the source.  It would appear that Linus\ndidn't add write and docs for this feature when he wrote it.  The\nfollowing patch rectifies that, hopefully sparing future users from\nresorting to the source code.\n\nSigned-off-by: Steven Walter <stevenrwalter@gmail.com>\n---\n Documentation/git-log.txt |    9 +++++++++\n 1 files changed, 9 insertions(+), 0 deletions(-)\n\ndiff --git a/Documentation/git-log.txt b/Documentation/git-log.txt\nindex 7adcdef..63c1dbe 100644\n--- a/Documentation/git-log.txt\n+++ b/Documentation/git-log.txt\n@@ -61,6 +61,9 @@ include::pretty-options.txt[]\n \tthe specified paths; this means that \"<paths>...\" limits only\n \tcommits, and doesn't limit diff for those commits.\n \n+--follow::\n+\tContinue listing the history of a file beyond renames.\n+\n <paths>...::\n \tShow only commits that affect the specified paths.\n \n@@ -91,6 +94,12 @@ git log -r --name-status release..test::\n \tin the \"release\" branch, along with the list of paths\n \teach commit modifies.\n \n+git log --follow builtin-rev-list.c::\n+\n+\tShows the commits that changed builtin-rev-list.c, including\n+\tthose commits that occurred before the file was given its\n+\tpresent name.\n+\n Discussion\n ----------\n \n-- \n1.5.3.rc0\n"},{"id":"47192","messageId":"alpine.LFD.0.999.0707121147050.20061@woody.linux-foundation.org","threadId":"9004","inReplyTo":"20070712145230.GA21590@dervierte","subject":"Re: [PATCH] Documentation for git-log --follow","fromName":"Linus Torvalds","fromEmail":"torvalds@linux-foundation.org","sentAt":"2007-07-12T18:48:35Z","receivedAt":"2007-07-12T18:48:35Z","isPatch":true,"sender":{"key":"torvalds@linux-foundation.org","avatar":"https://avatars.githubusercontent.com/u/1024025?v=4"},"body":"\n\nOn Thu, 12 Jul 2007, Steven Walter wrote:\n>\n> It would appear that Linus didn't add write and docs for this feature \n> when he wrote it.\n\nI am shocked. *Shocked* I say.\n\nOh, actually, no I'm not. Par for the course for me. Sorry.\n\nIt might be worth documenting that unline all the other log commands, \n--follow requires exactly one pathname. Maybe it's obvious.\n\n\t\tLinus\n"},{"id":"47268","messageId":"Pine.LNX.4.64.0707131540490.14781@racer.site","threadId":"9004","inReplyTo":"20070712145230.GA21590@dervierte","subject":"Re: [PATCH] Documentation for git-log --follow","fromName":"Johannes Schindelin","fromEmail":"johannes.schindelin@gmx.de","sentAt":"2007-07-13T14:47:19Z","receivedAt":"2007-07-13T14:47:19Z","isPatch":true,"sender":{"key":"johannes.schindelin@gmx.de","avatar":"https://avatars.githubusercontent.com/u/127790?v=4"},"body":"Hi,\n\nOn Thu, 12 Jul 2007, Steven Walter wrote:\n\n> +--follow::\n> +\tContinue listing the history of a file beyond renames.\n> +\n\nMaybe say \"Follow the history of a file beyond renames\"?\n\n> @@ -91,6 +94,12 @@ git log -r --name-status release..test::\n>  \tin the \"release\" branch, along with the list of paths\n>  \teach commit modifies.\n>  \n> +git log --follow builtin-rev-list.c::\n> +\n> +\tShows the commits that changed builtin-rev-list.c, including\n> +\tthose commits that occurred before the file was given its\n> +\tpresent name.\n> +\n\nThis is not particularly clear IMHO.  Probably it would be a good thing to \ncontrast vs no-follow:\n\n\tThe output of \"git log builtin-rev-list.c\" stops with commit \n\t\"v1.4.0-rc1~126\", as if the file was created there.\n\n\tWith \"--follow\", git will detect that this file was renamed \n\tfrom \"rev-list.c\" and minimally modified in that commit.  After \n\tthis, it will continue with the log, using the file name \n\t\"rev-list.c\".\n\nCiao,\nDscho\n"}]}