{"thread":{"id":"706","subject":"[PATCH] Update git-diff-cache documentation.","startedAt":"2005-05-24T01:20:39Z","lastAt":"2005-05-24T01:20:39Z","messageCount":1,"participants":["Junio C Hamano"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"3830","messageId":"7vu0ktzafs.fsf@assigned-by-dhcp.cox.net","threadId":"706","inReplyTo":null,"subject":"[PATCH] Update git-diff-cache documentation.","fromName":"Junio C Hamano","fromEmail":"junkio@cox.net","sentAt":"2005-05-24T01:20:39Z","receivedAt":"2005-05-24T01:20:39Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"The recent diff updates gave diff-cache the same ability to\nfilter paths, which was not properly documented.\n\nSigned-off-by: Junio C Hamano <junkio@cox.net>\n---\n\nDocumentation/git-diff-cache.txt |   10 ++++++----\ndiff-cache.c                     |    2 +-\n2 files changed, 7 insertions(+), 5 deletions(-)\n\ndiff --git a/Documentation/git-diff-cache.txt b/Documentation/git-diff-cache.txt\n--- a/Documentation/git-diff-cache.txt\n+++ b/Documentation/git-diff-cache.txt\n@@ -9,13 +9,15 @@ git-diff-cache - Compares content and mo\n \n SYNOPSIS\n --------\n-'git-diff-cache' [-p] [-r] [-z] [-m] [-M] [-R] [-C] [-S<string>] [--cached] <tree-ish>\n+'git-diff-cache' [-p] [-r] [-z] [-m] [-M] [-R] [-C] [-S<string>] [--cached] <tree-ish> [<path>...]\n \n DESCRIPTION\n -----------\n-Compares the content and mode of the blobs found via a tree object\n-with the content of the current cache and, optionally ignoring the\n-stat state of the file on disk.\n+Compares the content and mode of the blobs found via a tree\n+object with the content of the current cache and, optionally\n+ignoring the stat state of the file on disk.  When paths are\n+specified, compares only those named paths.  Otherwise all\n+entries in the cache are compared.\n \n OPTIONS\n -------\ndiff --git a/diff-cache.c b/diff-cache.c\n--- a/diff-cache.c\n+++ b/diff-cache.c\n@@ -154,7 +154,7 @@ static void mark_merge_entries(void)\n }\n \n static char *diff_cache_usage =\n-\"git-diff-cache [-p] [-r] [-z] [-m] [-M] [-C] [-R] [-S<string>] [--cached] <tree-ish>\";\n+\"git-diff-cache [-p] [-r] [-z] [-m] [-M] [-C] [-R] [-S<string>] [--cached] <tree-ish> [<path>...]\";\n \n int main(int argc, const char **argv)\n {\n------------------------------------------------\n\n"}]}