2005-04-26 16:25:05 +00:00
|
|
|
/*
|
|
|
|
* Copyright (C) 2005 Junio C Hamano
|
|
|
|
*/
|
2005-04-26 01:22:47 +00:00
|
|
|
#ifndef DIFF_H
|
|
|
|
#define DIFF_H
|
|
|
|
|
2006-03-30 06:55:43 +00:00
|
|
|
#include "tree-walk.h"
|
2006-01-31 22:10:56 +00:00
|
|
|
|
Log message printout cleanups
On Sun, 16 Apr 2006, Junio C Hamano wrote:
>
> In the mid-term, I am hoping we can drop the generate_header()
> callchain _and_ the custom code that formats commit log in-core,
> found in cmd_log_wc().
Ok, this was nastier than expected, just because the dependencies between
the different log-printing stuff were absolutely _everywhere_, but here's
a patch that does exactly that.
The patch is not very easy to read, and the "--patch-with-stat" thing is
still broken (it does not call the "show_log()" thing properly for
merges). That's not a new bug. In the new world order it _should_ do
something like
if (rev->logopt)
show_log(rev, rev->logopt, "---\n");
but it doesn't. I haven't looked at the --with-stat logic, so I left it
alone.
That said, this patch removes more lines than it adds, and in particular,
the "cmd_log_wc()" loop is now a very clean:
while ((commit = get_revision(rev)) != NULL) {
log_tree_commit(rev, commit);
free(commit->buffer);
commit->buffer = NULL;
}
so it doesn't get much prettier than this. All the complexity is entirely
hidden in log-tree.c, and any code that needs to flush the log literally
just needs to do the "if (rev->logopt) show_log(...)" incantation.
I had to make the combined_diff() logic take a "struct rev_info" instead
of just a "struct diff_options", but that part is pretty clean.
This does change "git whatchanged" from using "diff-tree" as the commit
descriptor to "commit", and I changed one of the tests to reflect that new
reality. Otherwise everything still passes, and my other tests look fine
too.
Signed-off-by: Linus Torvalds <torvalds@osdl.org>
Signed-off-by: Junio C Hamano <junkio@cox.net>
2006-04-17 18:59:32 +00:00
|
|
|
struct rev_info;
|
2005-10-21 04:05:05 +00:00
|
|
|
struct diff_options;
|
2006-09-07 06:35:42 +00:00
|
|
|
struct diff_queue_struct;
|
2005-10-21 04:05:05 +00:00
|
|
|
|
|
|
|
typedef void (*change_fn_t)(struct diff_options *options,
|
|
|
|
unsigned old_mode, unsigned new_mode,
|
|
|
|
const unsigned char *old_sha1,
|
|
|
|
const unsigned char *new_sha1,
|
2010-01-18 20:26:18 +00:00
|
|
|
const char *fullpath,
|
|
|
|
unsigned old_dirty_submodule, unsigned new_dirty_submodule);
|
2005-10-21 04:05:05 +00:00
|
|
|
|
|
|
|
typedef void (*add_remove_fn_t)(struct diff_options *options,
|
|
|
|
int addremove, unsigned mode,
|
|
|
|
const unsigned char *sha1,
|
2010-01-18 20:26:18 +00:00
|
|
|
const char *fullpath, unsigned dirty_submodule);
|
2005-10-21 04:05:05 +00:00
|
|
|
|
2006-09-07 06:35:42 +00:00
|
|
|
typedef void (*diff_format_fn_t)(struct diff_queue_struct *q,
|
|
|
|
struct diff_options *options, void *data);
|
|
|
|
|
2006-06-24 17:21:53 +00:00
|
|
|
#define DIFF_FORMAT_RAW 0x0001
|
|
|
|
#define DIFF_FORMAT_DIFFSTAT 0x0002
|
2006-10-12 10:01:00 +00:00
|
|
|
#define DIFF_FORMAT_NUMSTAT 0x0004
|
|
|
|
#define DIFF_FORMAT_SUMMARY 0x0008
|
|
|
|
#define DIFF_FORMAT_PATCH 0x0010
|
2006-12-15 04:15:44 +00:00
|
|
|
#define DIFF_FORMAT_SHORTSTAT 0x0020
|
Add "--dirstat" for some directory statistics
This adds a new form of overview diffstat output, doing something that I
have occasionally ended up doing manually (and badly, because it's
actually pretty nasty to do), and that I think is very useful for an
project like the kernel that has a fairly deep and well-separated
directory structure with semantic meaning.
What I mean by that is that it's often interesting to see exactly which
sub-directories are impacted by a patch, and to what degree - even if you
don't perhaps care so much about the individual files themselves.
What makes the concept more interesting is that the "impact" is often
hierarchical: in the kernel, for example, something could either have a
very localized impact to "fs/ext3/" and then it's interesting to see that
such a patch changes mostly that subdirectory, but you could have another
patch that changes some generic VFS-layer issue which affects _many_
subdirectories that are all under "fs/", but none - or perhaps just a
couple of them - of the individual filesystems are interesting in
themselves.
So what commonly happens is that you may have big changes in a specific
sub-subdirectory, but still also significant separate changes to the
subdirectory leading up to that - maybe you have significant VFS-level
changes, but *also* changes under that VFS layer in the NFS-specific
directories, for example. In that case, you do want the low-level parts
that are significant to show up, but then the insignificant ones should
show up as under the more generic top-level directory.
This patch shows all of that with "--dirstat". The output can be either
something simple like
commit 81772fe...
Author: Thomas Gleixner <tglx@linutronix.de>
Date: Sun Feb 10 23:57:36 2008 +0100
x86: remove over noisy debug printk
pageattr-test.c contains a noisy debug printk that people reported.
The condition under which it prints (randomly tapping into a mem_map[]
hole and not being able to c_p_a() there) is valid behavior and not
interesting to report.
Remove it.
Signed-off-by: Thomas Gleixner <tglx@linutronix.de>
Acked-by: Ingo Molnar <mingo@elte.hu>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
100.0% arch/x86/mm/
or something much more complex like
commit e231c2e...
Author: David Howells <dhowells@redhat.com>
Date: Thu Feb 7 00:15:26 2008 -0800
Convert ERR_PTR(PTR_ERR(p)) instances to ERR_CAST(p)
20.5% crypto/
7.6% fs/afs/
7.6% fs/fuse/
7.6% fs/gfs2/
5.1% fs/jffs2/
5.1% fs/nfs/
5.1% fs/nfsd/
7.6% fs/reiserfs/
15.3% fs/
7.6% net/rxrpc/
10.2% security/keys/
where that latter example is an example of significant work in some
individual fs/*/ subdirectories (like the patches to reiserfs accounting
for 7.6% of the whole), but then discounting those individual filesystems,
there's also 15.3% other "random" things that weren't worth reporting on
their oen left over under fs/ in general (either in that directory itself,
or in subdirectories of fs/ that didn't have enough changes to be reported
individually).
I'd like to stress that the "15.3% fs/" mentioned above is the stuff that
is under fs/ but that was _not_ significant enough to report on its own.
So the above does _not_ mean that 15.3% of the work was under fs/ per se,
because that 15.3% does *not* include the already-reported 7.6% of afs,
7.6% of fuse etc.
If you want to enable "cumulative" directory statistics, you can use the
"--cumulative" flag, which adds up percentages recursively even when
they have been already reported for a sub-directory. That cumulative
output is disabled if *all* of the changes in one subdirectory come from
a deeper subdirectory, to avoid repeating subdirectories all the way to
the root.
For an example of the cumulative reporting, the above commit becomes
commit e231c2e...
Author: David Howells <dhowells@redhat.com>
Date: Thu Feb 7 00:15:26 2008 -0800
Convert ERR_PTR(PTR_ERR(p)) instances to ERR_CAST(p)
20.5% crypto/
7.6% fs/afs/
7.6% fs/fuse/
7.6% fs/gfs2/
5.1% fs/jffs2/
5.1% fs/nfs/
5.1% fs/nfsd/
7.6% fs/reiserfs/
61.5% fs/
7.6% net/rxrpc/
10.2% security/keys/
in which the commit percentages now obviously add up to much more than
100%: now the changes that were already reported for the sub-directories
under fs/ are then cumulatively included in the whole percentage of fs/
(ie now shows 61.5% as opposed to the 15.3% without the cumulative
reporting).
The default reporting limit has been arbitrarily set at 3%, which seems
to be a pretty good cut-off, but you can specify the cut-off manually by
giving it as an option parameter (eg "--dirstat=5" makes the cut-off be
at 5% instead)
NOTE! The percentages are purely about the total lines added and removed,
not anything smarter (or dumber) than that. Also note that you should not
generally expect things to add up to 100%: not only does it round down, we
don't report leftover scraps (they add up to the top-level change count,
but we don't even bother reporting that, it only reports subdirectories).
Quite frankly, as a top-level manager this is really convenient for me,
but it's going to be very boring for git itself since there are few
subdirectories. Also, don't expect things to make tons of sense if you
combine this with "-M" and there are cross-directory renames etc.
But even for git itself, you can get some fun statistics. Try out
git log --dirstat
and see the occasional mentions of things like Documentation/, git-gui/,
gitweb/ and gitk-git/. Or try out something like
git diff --dirstat v1.5.0..v1.5.4
which does kind of git an overview that shows *something*. But in general,
the output is more exciting for big projects with deeper structure, and
doing a
git diff --dirstat v2.6.24..v2.6.25-rc1
on the kernel is what I actually wrote this for!
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2008-02-12 21:26:31 +00:00
|
|
|
#define DIFF_FORMAT_DIRSTAT 0x0040
|
2006-06-24 17:21:53 +00:00
|
|
|
|
|
|
|
/* These override all above */
|
2006-10-12 10:01:00 +00:00
|
|
|
#define DIFF_FORMAT_NAME 0x0100
|
|
|
|
#define DIFF_FORMAT_NAME_STATUS 0x0200
|
|
|
|
#define DIFF_FORMAT_CHECKDIFF 0x0400
|
2006-06-24 17:21:53 +00:00
|
|
|
|
|
|
|
/* Same as output_format = 0 but we know that -s flag was given
|
|
|
|
* and we should not give default value to output_format.
|
|
|
|
*/
|
2006-10-12 10:01:00 +00:00
|
|
|
#define DIFF_FORMAT_NO_OUTPUT 0x0800
|
2006-06-24 17:21:53 +00:00
|
|
|
|
2006-10-12 10:01:00 +00:00
|
|
|
#define DIFF_FORMAT_CALLBACK 0x1000
|
2006-09-07 06:35:42 +00:00
|
|
|
|
2007-11-10 19:05:14 +00:00
|
|
|
#define DIFF_OPT_RECURSIVE (1 << 0)
|
|
|
|
#define DIFF_OPT_TREE_IN_RECURSIVE (1 << 1)
|
|
|
|
#define DIFF_OPT_BINARY (1 << 2)
|
|
|
|
#define DIFF_OPT_TEXT (1 << 3)
|
|
|
|
#define DIFF_OPT_FULL_INDEX (1 << 4)
|
|
|
|
#define DIFF_OPT_SILENT_ON_REMOVE (1 << 5)
|
|
|
|
#define DIFF_OPT_FIND_COPIES_HARDER (1 << 6)
|
|
|
|
#define DIFF_OPT_FOLLOW_RENAMES (1 << 7)
|
|
|
|
#define DIFF_OPT_COLOR_DIFF (1 << 8)
|
2010-04-14 15:59:06 +00:00
|
|
|
/* (1 << 9) unused */
|
2007-11-10 19:05:14 +00:00
|
|
|
#define DIFF_OPT_HAS_CHANGES (1 << 10)
|
2009-05-23 08:15:35 +00:00
|
|
|
#define DIFF_OPT_QUICK (1 << 11)
|
2007-11-10 19:05:14 +00:00
|
|
|
#define DIFF_OPT_NO_INDEX (1 << 12)
|
|
|
|
#define DIFF_OPT_ALLOW_EXTERNAL (1 << 13)
|
|
|
|
#define DIFF_OPT_EXIT_WITH_STATUS (1 << 14)
|
|
|
|
#define DIFF_OPT_REVERSE_DIFF (1 << 15)
|
2007-12-13 20:24:52 +00:00
|
|
|
#define DIFF_OPT_CHECK_FAILED (1 << 16)
|
diff --relative: output paths as relative to the current subdirectory
This adds --relative option to the diff family. When you start
from a subdirectory:
$ git diff --relative
shows only the diff that is inside your current subdirectory,
and without $prefix part. People who usually live in
subdirectories may like it.
There are a few things I should also mention about the change:
- This works not just with diff but also works with the log
family of commands, but the history pruning is not affected.
In other words, if you go to a subdirectory, you can say:
$ git log --relative -p
but it will show the log message even for commits that do not
touch the current directory. You can limit it by giving
pathspec yourself:
$ git log --relative -p .
This originally was not a conscious design choice, but we
have a way to affect diff pathspec and pruning pathspec
independently. IOW "git log --full-diff -p ." tells it to
prune history to commits that affect the current subdirectory
but show the changes with full context. I think it makes
more sense to leave pruning independent from --relative than
the obvious alternative of always pruning with the current
subdirectory, which would break the symmetry.
- Because this works also with the log family, you could
format-patch a single change, limiting the effect to your
subdirectory, like so:
$ cd gitk-git
$ git format-patch -1 --relative 911f1eb
But because that is a special purpose usage, this option will
never become the default, with or without repository or user
preference configuration. The risk of producing a partial
patch and sending it out by mistake is too great if we did
so.
- This is inherently incompatible with --no-index, which is a
bolted-on hack that does not have much to do with git
itself. I didn't bother checking and erroring out on the
combined use of the options, but probably I should.
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2008-02-12 22:26:02 +00:00
|
|
|
#define DIFF_OPT_RELATIVE_NAME (1 << 17)
|
2008-05-14 17:03:31 +00:00
|
|
|
#define DIFF_OPT_IGNORE_SUBMODULES (1 << 18)
|
2008-09-03 00:28:59 +00:00
|
|
|
#define DIFF_OPT_DIRSTAT_CUMULATIVE (1 << 19)
|
2008-09-05 19:27:35 +00:00
|
|
|
#define DIFF_OPT_DIRSTAT_BY_FILE (1 << 20)
|
2008-10-26 04:45:55 +00:00
|
|
|
#define DIFF_OPT_ALLOW_TEXTCONV (1 << 21)
|
diff: change semantics of "ignore whitespace" options
Traditionally, the --ignore-whitespace* options have merely meant to tell
the diff output routine that some class of differences are not worth
showing in the textual diff output, so that the end user has easier time
to review the remaining (presumably more meaningful) changes. These
options never affected the outcome of the command, given as the exit
status when the --exit-code option was in effect (either directly or
indirectly).
When you have only whitespace changes, however, you might expect
git diff -b --exit-code
to report that there is _no_ change with zero exit status.
Change the semantics of --ignore-whitespace* options to mean more than
"omit showing the difference in text".
The exit status, when --exit-code is in effect, is computed by checking if
we found any differences at the path level, while diff frontends feed
filepairs to the diffcore engine. When "ignore whitespace" options are in
effect, we defer this determination until the very end of diffcore
transformation. We simply do not know until the textual diff is
generated, which comes very late in the pipeline.
When --quiet is in effect, various diff frontends optimize by breaking out
early from the loop that enumerates the filepairs, when we find the first
path level difference; when --ignore-whitespace* is used the above change
automatically disables this optimization.
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2009-05-22 19:45:29 +00:00
|
|
|
#define DIFF_OPT_DIFF_FROM_CONTENTS (1 << 22)
|
2009-10-19 12:38:32 +00:00
|
|
|
#define DIFF_OPT_SUBMODULE_LOG (1 << 23)
|
2010-03-08 12:53:19 +00:00
|
|
|
#define DIFF_OPT_DIRTY_SUBMODULES (1 << 24)
|
2010-03-13 22:00:27 +00:00
|
|
|
#define DIFF_OPT_IGNORE_UNTRACKED_IN_SUBMODULES (1 << 25)
|
2009-10-19 12:38:32 +00:00
|
|
|
|
2007-11-10 19:05:14 +00:00
|
|
|
#define DIFF_OPT_TST(opts, flag) ((opts)->flags & DIFF_OPT_##flag)
|
|
|
|
#define DIFF_OPT_SET(opts, flag) ((opts)->flags |= DIFF_OPT_##flag)
|
|
|
|
#define DIFF_OPT_CLR(opts, flag) ((opts)->flags &= ~DIFF_OPT_##flag)
|
2009-02-17 03:26:49 +00:00
|
|
|
#define DIFF_XDL_TST(opts, flag) ((opts)->xdl_opts & XDF_##flag)
|
|
|
|
#define DIFF_XDL_SET(opts, flag) ((opts)->xdl_opts |= XDF_##flag)
|
|
|
|
#define DIFF_XDL_CLR(opts, flag) ((opts)->xdl_opts &= ~XDF_##flag)
|
2007-11-10 19:05:14 +00:00
|
|
|
|
2010-04-14 15:59:06 +00:00
|
|
|
enum diff_words_type {
|
|
|
|
DIFF_WORDS_NONE = 0,
|
|
|
|
DIFF_WORDS_PORCELAIN,
|
|
|
|
DIFF_WORDS_PLAIN,
|
|
|
|
DIFF_WORDS_COLOR
|
|
|
|
};
|
|
|
|
|
2005-09-21 07:00:47 +00:00
|
|
|
struct diff_options {
|
|
|
|
const char *filter;
|
|
|
|
const char *orderfile;
|
|
|
|
const char *pickaxe;
|
2006-11-02 08:02:11 +00:00
|
|
|
const char *single_follow;
|
2007-12-18 19:32:14 +00:00
|
|
|
const char *a_prefix, *b_prefix;
|
2007-11-10 19:05:14 +00:00
|
|
|
unsigned flags;
|
2006-05-13 20:23:48 +00:00
|
|
|
int context;
|
2008-12-28 18:45:32 +00:00
|
|
|
int interhunkcontext;
|
2005-09-21 07:00:47 +00:00
|
|
|
int break_opt;
|
|
|
|
int detect_rename;
|
git-diff: squelch "empty" diffs
After starting to edit a working tree file but later when your edit ends
up identical to the original (this can also happen when you ran a
wholesale regexp replace with something like "perl -i" that does not
actually modify many of the paths), "git diff" between the index and the
working tree outputs many "empty" diffs that show "diff --git" headers
and nothing else, because these paths are stat-dirty. While it was a
way to warn the user that the earlier action of the user made the index
ineffective as an optimization mechanism, it was felt too loud for the
purpose of warning even to experienced users, and also resulted in
confusing people new to git.
This replaces the "empty" diffs with a single warning message at the
end. Having many such paths hurts performance, and you can run
"git-update-index --refresh" to update the lstat(2) information recorded
in the index in such a case. "git-status" does so as a side effect, and
that is more familiar to the end-user, so we recommend it to them.
The change affects only "git diff" that outputs patch text, because that
is where the annoyance of too many "empty" diff is most strongly felt,
and because the warning message can be safely ignored by downstream
tools without getting mistaken as part of the patch. For the low-level
"git diff-files" and "git diff-index", the traditional behaviour is
retained.
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2007-08-03 20:33:31 +00:00
|
|
|
int skip_stat_unmatch;
|
2005-09-21 07:00:47 +00:00
|
|
|
int line_termination;
|
|
|
|
int output_format;
|
|
|
|
int pickaxe_opts;
|
|
|
|
int rename_score;
|
2005-09-21 07:18:27 +00:00
|
|
|
int rename_limit;
|
2008-04-30 17:25:53 +00:00
|
|
|
int warn_on_too_large_rename;
|
Add "--dirstat" for some directory statistics
This adds a new form of overview diffstat output, doing something that I
have occasionally ended up doing manually (and badly, because it's
actually pretty nasty to do), and that I think is very useful for an
project like the kernel that has a fairly deep and well-separated
directory structure with semantic meaning.
What I mean by that is that it's often interesting to see exactly which
sub-directories are impacted by a patch, and to what degree - even if you
don't perhaps care so much about the individual files themselves.
What makes the concept more interesting is that the "impact" is often
hierarchical: in the kernel, for example, something could either have a
very localized impact to "fs/ext3/" and then it's interesting to see that
such a patch changes mostly that subdirectory, but you could have another
patch that changes some generic VFS-layer issue which affects _many_
subdirectories that are all under "fs/", but none - or perhaps just a
couple of them - of the individual filesystems are interesting in
themselves.
So what commonly happens is that you may have big changes in a specific
sub-subdirectory, but still also significant separate changes to the
subdirectory leading up to that - maybe you have significant VFS-level
changes, but *also* changes under that VFS layer in the NFS-specific
directories, for example. In that case, you do want the low-level parts
that are significant to show up, but then the insignificant ones should
show up as under the more generic top-level directory.
This patch shows all of that with "--dirstat". The output can be either
something simple like
commit 81772fe...
Author: Thomas Gleixner <tglx@linutronix.de>
Date: Sun Feb 10 23:57:36 2008 +0100
x86: remove over noisy debug printk
pageattr-test.c contains a noisy debug printk that people reported.
The condition under which it prints (randomly tapping into a mem_map[]
hole and not being able to c_p_a() there) is valid behavior and not
interesting to report.
Remove it.
Signed-off-by: Thomas Gleixner <tglx@linutronix.de>
Acked-by: Ingo Molnar <mingo@elte.hu>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
100.0% arch/x86/mm/
or something much more complex like
commit e231c2e...
Author: David Howells <dhowells@redhat.com>
Date: Thu Feb 7 00:15:26 2008 -0800
Convert ERR_PTR(PTR_ERR(p)) instances to ERR_CAST(p)
20.5% crypto/
7.6% fs/afs/
7.6% fs/fuse/
7.6% fs/gfs2/
5.1% fs/jffs2/
5.1% fs/nfs/
5.1% fs/nfsd/
7.6% fs/reiserfs/
15.3% fs/
7.6% net/rxrpc/
10.2% security/keys/
where that latter example is an example of significant work in some
individual fs/*/ subdirectories (like the patches to reiserfs accounting
for 7.6% of the whole), but then discounting those individual filesystems,
there's also 15.3% other "random" things that weren't worth reporting on
their oen left over under fs/ in general (either in that directory itself,
or in subdirectories of fs/ that didn't have enough changes to be reported
individually).
I'd like to stress that the "15.3% fs/" mentioned above is the stuff that
is under fs/ but that was _not_ significant enough to report on its own.
So the above does _not_ mean that 15.3% of the work was under fs/ per se,
because that 15.3% does *not* include the already-reported 7.6% of afs,
7.6% of fuse etc.
If you want to enable "cumulative" directory statistics, you can use the
"--cumulative" flag, which adds up percentages recursively even when
they have been already reported for a sub-directory. That cumulative
output is disabled if *all* of the changes in one subdirectory come from
a deeper subdirectory, to avoid repeating subdirectories all the way to
the root.
For an example of the cumulative reporting, the above commit becomes
commit e231c2e...
Author: David Howells <dhowells@redhat.com>
Date: Thu Feb 7 00:15:26 2008 -0800
Convert ERR_PTR(PTR_ERR(p)) instances to ERR_CAST(p)
20.5% crypto/
7.6% fs/afs/
7.6% fs/fuse/
7.6% fs/gfs2/
5.1% fs/jffs2/
5.1% fs/nfs/
5.1% fs/nfsd/
7.6% fs/reiserfs/
61.5% fs/
7.6% net/rxrpc/
10.2% security/keys/
in which the commit percentages now obviously add up to much more than
100%: now the changes that were already reported for the sub-directories
under fs/ are then cumulatively included in the whole percentage of fs/
(ie now shows 61.5% as opposed to the 15.3% without the cumulative
reporting).
The default reporting limit has been arbitrarily set at 3%, which seems
to be a pretty good cut-off, but you can specify the cut-off manually by
giving it as an option parameter (eg "--dirstat=5" makes the cut-off be
at 5% instead)
NOTE! The percentages are purely about the total lines added and removed,
not anything smarter (or dumber) than that. Also note that you should not
generally expect things to add up to 100%: not only does it round down, we
don't report leftover scraps (they add up to the top-level change count,
but we don't even bother reporting that, it only reports subdirectories).
Quite frankly, as a top-level manager this is really convenient for me,
but it's going to be very boring for git itself since there are few
subdirectories. Also, don't expect things to make tons of sense if you
combine this with "-M" and there are cross-directory renames etc.
But even for git itself, you can get some fun statistics. Try out
git log --dirstat
and see the occasional mentions of things like Documentation/, git-gui/,
gitweb/ and gitk-git/. Or try out something like
git diff --dirstat v1.5.0..v1.5.4
which does kind of git an overview that shows *something*. But in general,
the output is more exciting for big projects with deeper structure, and
doing a
git diff --dirstat v2.6.24..v2.6.25-rc1
on the kernel is what I actually wrote this for!
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2008-02-12 21:26:31 +00:00
|
|
|
int dirstat_percent;
|
2005-09-21 07:00:47 +00:00
|
|
|
int setup;
|
2005-12-14 01:21:41 +00:00
|
|
|
int abbrev;
|
diff --relative: output paths as relative to the current subdirectory
This adds --relative option to the diff family. When you start
from a subdirectory:
$ git diff --relative
shows only the diff that is inside your current subdirectory,
and without $prefix part. People who usually live in
subdirectories may like it.
There are a few things I should also mention about the change:
- This works not just with diff but also works with the log
family of commands, but the history pruning is not affected.
In other words, if you go to a subdirectory, you can say:
$ git log --relative -p
but it will show the log message even for commits that do not
touch the current directory. You can limit it by giving
pathspec yourself:
$ git log --relative -p .
This originally was not a conscious design choice, but we
have a way to affect diff pathspec and pruning pathspec
independently. IOW "git log --full-diff -p ." tells it to
prune history to commits that affect the current subdirectory
but show the changes with full context. I think it makes
more sense to leave pruning independent from --relative than
the obvious alternative of always pruning with the current
subdirectory, which would break the symmetry.
- Because this works also with the log family, you could
format-patch a single change, limiting the effect to your
subdirectory, like so:
$ cd gitk-git
$ git format-patch -1 --relative 911f1eb
But because that is a special purpose usage, this option will
never become the default, with or without repository or user
preference configuration. The risk of producing a partial
patch and sending it out by mistake is too great if we did
so.
- This is inherently incompatible with --no-index, which is a
bolted-on hack that does not have much to do with git
itself. I didn't bother checking and erroring out on the
combined use of the options, but probably I should.
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2008-02-12 22:26:02 +00:00
|
|
|
const char *prefix;
|
|
|
|
int prefix_length;
|
2006-05-20 13:40:29 +00:00
|
|
|
const char *stat_sep;
|
2006-06-14 15:40:23 +00:00
|
|
|
long xdl_opts;
|
2005-10-21 04:05:05 +00:00
|
|
|
|
2006-09-27 01:53:02 +00:00
|
|
|
int stat_width;
|
|
|
|
int stat_name_width;
|
2009-01-17 16:29:45 +00:00
|
|
|
const char *word_regex;
|
2010-04-14 15:59:06 +00:00
|
|
|
enum diff_words_type word_diff;
|
2006-09-27 01:53:02 +00:00
|
|
|
|
2007-02-25 22:34:54 +00:00
|
|
|
/* this is set by diffcore for DIFF_FORMAT_PATCH */
|
|
|
|
int found_changes;
|
|
|
|
|
2008-03-10 02:43:39 +00:00
|
|
|
FILE *file;
|
|
|
|
int close_file;
|
|
|
|
|
2006-04-10 23:39:11 +00:00
|
|
|
int nr_paths;
|
|
|
|
const char **paths;
|
|
|
|
int *pathlens;
|
2005-10-21 04:05:05 +00:00
|
|
|
change_fn_t change;
|
|
|
|
add_remove_fn_t add_remove;
|
2006-09-07 06:35:42 +00:00
|
|
|
diff_format_fn_t format_callback;
|
|
|
|
void *format_callback_data;
|
2005-09-21 07:00:47 +00:00
|
|
|
};
|
|
|
|
|
2006-07-23 09:24:18 +00:00
|
|
|
enum color_diff {
|
|
|
|
DIFF_RESET = 0,
|
|
|
|
DIFF_PLAIN = 1,
|
|
|
|
DIFF_METAINFO = 2,
|
|
|
|
DIFF_FRAGINFO = 3,
|
|
|
|
DIFF_FILE_OLD = 4,
|
|
|
|
DIFF_FILE_NEW = 5,
|
|
|
|
DIFF_COMMIT = 6,
|
2006-09-23 05:48:39 +00:00
|
|
|
DIFF_WHITESPACE = 7,
|
2009-11-27 06:55:18 +00:00
|
|
|
DIFF_FUNCINFO = 8,
|
2006-07-23 09:24:18 +00:00
|
|
|
};
|
|
|
|
const char *diff_get_color(int diff_use_color, enum color_diff ix);
|
2007-11-10 19:05:14 +00:00
|
|
|
#define diff_get_color_opt(o, ix) \
|
|
|
|
diff_get_color(DIFF_OPT_TST((o), COLOR_DIFF), ix)
|
|
|
|
|
2006-07-23 09:24:18 +00:00
|
|
|
|
2006-05-20 13:40:29 +00:00
|
|
|
extern const char mime_boundary_leader[];
|
|
|
|
|
2006-04-10 23:39:11 +00:00
|
|
|
extern void diff_tree_setup_paths(const char **paths, struct diff_options *);
|
|
|
|
extern void diff_tree_release_paths(struct diff_options *);
|
2005-10-21 04:05:05 +00:00
|
|
|
extern int diff_tree(struct tree_desc *t1, struct tree_desc *t2,
|
|
|
|
const char *base, struct diff_options *opt);
|
|
|
|
extern int diff_tree_sha1(const unsigned char *old, const unsigned char *new,
|
|
|
|
const char *base, struct diff_options *opt);
|
2006-10-26 16:52:39 +00:00
|
|
|
extern int diff_root_tree_sha1(const unsigned char *new, const char *base,
|
|
|
|
struct diff_options *opt);
|
2005-10-21 04:05:05 +00:00
|
|
|
|
2006-01-28 08:03:38 +00:00
|
|
|
struct combine_diff_path {
|
|
|
|
struct combine_diff_path *next;
|
|
|
|
int len;
|
|
|
|
char *path;
|
2006-02-06 20:53:07 +00:00
|
|
|
unsigned int mode;
|
2006-01-28 08:03:38 +00:00
|
|
|
unsigned char sha1[20];
|
2006-02-06 20:53:07 +00:00
|
|
|
struct combine_diff_parent {
|
2006-02-10 10:30:52 +00:00
|
|
|
char status;
|
2006-02-06 20:53:07 +00:00
|
|
|
unsigned int mode;
|
|
|
|
unsigned char sha1[20];
|
|
|
|
} parent[FLEX_ARRAY];
|
2006-01-28 08:03:38 +00:00
|
|
|
};
|
2006-02-06 20:53:07 +00:00
|
|
|
#define combine_diff_path_size(n, l) \
|
|
|
|
(sizeof(struct combine_diff_path) + \
|
|
|
|
sizeof(struct combine_diff_parent) * (n) + (l) + 1)
|
2006-01-28 08:03:38 +00:00
|
|
|
|
Log message printout cleanups
On Sun, 16 Apr 2006, Junio C Hamano wrote:
>
> In the mid-term, I am hoping we can drop the generate_header()
> callchain _and_ the custom code that formats commit log in-core,
> found in cmd_log_wc().
Ok, this was nastier than expected, just because the dependencies between
the different log-printing stuff were absolutely _everywhere_, but here's
a patch that does exactly that.
The patch is not very easy to read, and the "--patch-with-stat" thing is
still broken (it does not call the "show_log()" thing properly for
merges). That's not a new bug. In the new world order it _should_ do
something like
if (rev->logopt)
show_log(rev, rev->logopt, "---\n");
but it doesn't. I haven't looked at the --with-stat logic, so I left it
alone.
That said, this patch removes more lines than it adds, and in particular,
the "cmd_log_wc()" loop is now a very clean:
while ((commit = get_revision(rev)) != NULL) {
log_tree_commit(rev, commit);
free(commit->buffer);
commit->buffer = NULL;
}
so it doesn't get much prettier than this. All the complexity is entirely
hidden in log-tree.c, and any code that needs to flush the log literally
just needs to do the "if (rev->logopt) show_log(...)" incantation.
I had to make the combined_diff() logic take a "struct rev_info" instead
of just a "struct diff_options", but that part is pretty clean.
This does change "git whatchanged" from using "diff-tree" as the commit
descriptor to "commit", and I changed one of the tests to reflect that new
reality. Otherwise everything still passes, and my other tests look fine
too.
Signed-off-by: Linus Torvalds <torvalds@osdl.org>
Signed-off-by: Junio C Hamano <junkio@cox.net>
2006-04-17 18:59:32 +00:00
|
|
|
extern void show_combined_diff(struct combine_diff_path *elem, int num_parent,
|
|
|
|
int dense, struct rev_info *);
|
2006-01-28 08:03:38 +00:00
|
|
|
|
2006-04-29 08:24:49 +00:00
|
|
|
extern void diff_tree_combined(const unsigned char *sha1, const unsigned char parent[][20], int num_parent, int dense, struct rev_info *rev);
|
|
|
|
|
Log message printout cleanups
On Sun, 16 Apr 2006, Junio C Hamano wrote:
>
> In the mid-term, I am hoping we can drop the generate_header()
> callchain _and_ the custom code that formats commit log in-core,
> found in cmd_log_wc().
Ok, this was nastier than expected, just because the dependencies between
the different log-printing stuff were absolutely _everywhere_, but here's
a patch that does exactly that.
The patch is not very easy to read, and the "--patch-with-stat" thing is
still broken (it does not call the "show_log()" thing properly for
merges). That's not a new bug. In the new world order it _should_ do
something like
if (rev->logopt)
show_log(rev, rev->logopt, "---\n");
but it doesn't. I haven't looked at the --with-stat logic, so I left it
alone.
That said, this patch removes more lines than it adds, and in particular,
the "cmd_log_wc()" loop is now a very clean:
while ((commit = get_revision(rev)) != NULL) {
log_tree_commit(rev, commit);
free(commit->buffer);
commit->buffer = NULL;
}
so it doesn't get much prettier than this. All the complexity is entirely
hidden in log-tree.c, and any code that needs to flush the log literally
just needs to do the "if (rev->logopt) show_log(...)" incantation.
I had to make the combined_diff() logic take a "struct rev_info" instead
of just a "struct diff_options", but that part is pretty clean.
This does change "git whatchanged" from using "diff-tree" as the commit
descriptor to "commit", and I changed one of the tests to reflect that new
reality. Otherwise everything still passes, and my other tests look fine
too.
Signed-off-by: Linus Torvalds <torvalds@osdl.org>
Signed-off-by: Junio C Hamano <junkio@cox.net>
2006-04-17 18:59:32 +00:00
|
|
|
extern void diff_tree_combined_merge(const unsigned char *sha1, int, struct rev_info *);
|
diff-tree -c: show a merge commit a bit more sensibly.
A new option '-c' to diff-tree changes the way a merge commit is
displayed when generating a patch output. It shows a "combined
diff" (hence the option letter 'c'), which looks like this:
$ git-diff-tree --pretty -c -p fec9ebf1 | head -n 18
diff-tree fec9ebf... (from parents)
Merge: 0620db3... 8a263ae...
Author: Junio C Hamano <junkio@cox.net>
Date: Sun Jan 15 22:25:35 2006 -0800
Merge fixes up to GIT 1.1.3
diff --combined describe.c
@@@ +98,7 @@@
return (a_date > b_date) ? -1 : (a_date == b_date) ? 0 : 1;
}
- static void describe(char *arg)
- static void describe(struct commit *cmit, int last_one)
++ static void describe(char *arg, int last_one)
{
+ unsigned char sha1[20];
+ struct commit *cmit;
There are a few things to note about this feature:
- The '-c' option implies '-p'. It also implies '-m' halfway
in the sense that "interesting" merges are shown, but not all
merges.
- When a blob matches one of the parents, we do not show a diff
for that path at all. For a merge commit, this option shows
paths with real file-level merge (aka "interesting things").
- As a concequence of the above, an "uninteresting" merge is
not shown at all. You can use '-m' in addition to '-c' to
show the commit log for such a merge, but there will be no
combined diff output.
- Unlike "gitk", the output is monochrome.
A '-' character in the nth column means the line is from the nth
parent and does not appear in the merge result (i.e. removed
from that parent's version).
A '+' character in the nth column means the line appears in the
merge result, and the nth parent does not have that line
(i.e. added by the merge itself or inherited from another
parent).
The above example output shows that the function signature was
changed from either parents (hence two "-" lines and a "++"
line), and "unsigned char sha1[20]", prefixed by a " +", was
inherited from the first parent.
The code as sent to the list was buggy in few corner cases,
which I have fixed since then.
It does not bother to keep track of and show the line numbers
from parent commits, which it probably should.
Signed-off-by: Junio C Hamano <junkio@cox.net>
2006-01-24 09:22:04 +00:00
|
|
|
|
2008-08-19 03:08:09 +00:00
|
|
|
void diff_set_mnemonic_prefix(struct diff_options *options, const char *a, const char *b);
|
|
|
|
|
2005-09-21 07:00:47 +00:00
|
|
|
extern void diff_addremove(struct diff_options *,
|
|
|
|
int addremove,
|
2005-04-27 16:21:00 +00:00
|
|
|
unsigned mode,
|
|
|
|
const unsigned char *sha1,
|
2010-01-18 20:26:18 +00:00
|
|
|
const char *fullpath, unsigned dirty_submodule);
|
2005-04-27 16:21:00 +00:00
|
|
|
|
2005-09-21 07:00:47 +00:00
|
|
|
extern void diff_change(struct diff_options *,
|
|
|
|
unsigned mode1, unsigned mode2,
|
|
|
|
const unsigned char *sha1,
|
|
|
|
const unsigned char *sha2,
|
2010-01-18 20:26:18 +00:00
|
|
|
const char *fullpath,
|
|
|
|
unsigned dirty_submodule1, unsigned dirty_submodule2);
|
2005-04-27 16:21:00 +00:00
|
|
|
|
2005-09-21 07:00:47 +00:00
|
|
|
extern void diff_unmerge(struct diff_options *,
|
2007-01-05 09:25:18 +00:00
|
|
|
const char *path,
|
|
|
|
unsigned mode,
|
|
|
|
const unsigned char *sha1);
|
2005-04-27 16:21:00 +00:00
|
|
|
|
2005-05-27 22:54:37 +00:00
|
|
|
#define DIFF_SETUP_REVERSE 1
|
2005-05-27 22:56:38 +00:00
|
|
|
#define DIFF_SETUP_USE_CACHE 2
|
|
|
|
#define DIFF_SETUP_USE_SIZE_CACHE 4
|
2005-06-03 08:36:43 +00:00
|
|
|
|
2008-05-14 17:46:53 +00:00
|
|
|
extern int git_diff_basic_config(const char *var, const char *value, void *cb);
|
|
|
|
extern int git_diff_ui_config(const char *var, const char *value, void *cb);
|
2008-02-18 07:26:03 +00:00
|
|
|
extern int diff_use_color_default;
|
2005-09-21 07:00:47 +00:00
|
|
|
extern void diff_setup(struct diff_options *);
|
|
|
|
extern int diff_opt_parse(struct diff_options *, const char **, int);
|
|
|
|
extern int diff_setup_done(struct diff_options *);
|
2005-04-26 01:22:47 +00:00
|
|
|
|
2005-05-22 17:04:37 +00:00
|
|
|
#define DIFF_DETECT_RENAME 1
|
|
|
|
#define DIFF_DETECT_COPY 2
|
|
|
|
|
2005-05-27 22:55:28 +00:00
|
|
|
#define DIFF_PICKAXE_ALL 1
|
2006-03-29 00:16:33 +00:00
|
|
|
#define DIFF_PICKAXE_REGEX 2
|
[PATCH] Add -B flag to diff-* brothers.
A new diffcore transformation, diffcore-break.c, is introduced.
When the -B flag is given, a patch that represents a complete
rewrite is broken into a deletion followed by a creation. This
makes it easier to review such a complete rewrite patch.
The -B flag takes the same syntax as the -M and -C flags to
specify the minimum amount of non-source material the resulting
file needs to have to be considered a complete rewrite, and
defaults to 99% if not specified.
As the new test t4008-diff-break-rewrite.sh demonstrates, if a
file is a complete rewrite, it is broken into a delete/create
pair, which can further be subjected to the usual rename
detection if -M or -C is used. For example, if file0 gets
completely rewritten to make it as if it were rather based on
file1 which itself disappeared, the following happens:
The original change looks like this:
file0 --> file0' (quite different from file0)
file1 --> /dev/null
After diffcore-break runs, it would become this:
file0 --> /dev/null
/dev/null --> file0'
file1 --> /dev/null
Then diffcore-rename matches them up:
file1 --> file0'
The internal score values are finer grained now. Earlier
maximum of 10000 has been raised to 60000; there is no user
visible changes but there is no reason to waste available bits.
Signed-off-by: Junio C Hamano <junkio@cox.net>
Signed-off-by: Linus Torvalds <torvalds@osdl.org>
2005-05-30 07:08:37 +00:00
|
|
|
|
2005-09-21 07:00:47 +00:00
|
|
|
extern void diffcore_std(struct diff_options *);
|
unpack-trees.c: look ahead in the index
This makes the traversal of index be in sync with the tree traversal.
When unpack_callback() is fed a set of tree entries from trees, it
inspects the name of the entry and checks if the an index entry with
the same name could be hiding behind the current index entry, and
(1) if the name appears in the index as a leaf node, it is also
fed to the n_way_merge() callback function;
(2) if the name is a directory in the index, i.e. there are entries in
that are underneath it, then nothing is fed to the n_way_merge()
callback function;
(3) otherwise, if the name comes before the first eligible entry in the
index, the index entry is first unpacked alone.
When traverse_trees_recursive() descends into a subdirectory, the
cache_bottom pointer is moved to walk index entries within that directory.
All of these are omitted for diff-index, which does not even want to be
fed an index entry and a tree entry with D/F conflicts.
This fixes 3-way read-tree and exposes a bug in other parts of the system
in t6035, test #5. The test prepares these three trees:
O = HEAD^
100644 blob e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 a/b-2/c/d
100644 blob e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 a/b/c/d
100644 blob e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 a/x
A = HEAD
100644 blob e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 a/b-2/c/d
100644 blob e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 a/b/c/d
100644 blob 587be6b4c3f93f93c489c0111bba5596147a26cb a/x
B = master
120000 blob a36b77384451ea1de7bd340ffca868249626bc52 a/b
100644 blob e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 a/b-2/c/d
100644 blob e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 a/x
With a clean index that matches HEAD, running
git read-tree -m -u --aggressive $O $A $B
now yields
120000 a36b77384451ea1de7bd340ffca868249626bc52 3 a/b
100644 e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 0 a/b-2/c/d
100644 e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 1 a/b/c/d
100644 e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 2 a/b/c/d
100644 587be6b4c3f93f93c489c0111bba5596147a26cb 0 a/x
which is correct. "master" created "a/b" symlink that did not exist,
and removed "a/b/c/d" while HEAD did not do touch either path.
Before this series, read-tree did not notice the situation and resolved
addition of "a/b" and removal of "a/b/c/d" independently. If A = HEAD had
another path "a/b/c/e" added, this merge should conflict but instead it
silently resolved "a/b" and then immediately overwrote it to add
"a/b/c/e", which was quite bogus.
Tests in t1012 start to work with this.
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2009-09-20 07:03:39 +00:00
|
|
|
extern void diffcore_fix_diff_index(struct diff_options *);
|
2005-06-12 03:57:13 +00:00
|
|
|
|
2005-07-13 19:52:35 +00:00
|
|
|
#define COMMON_DIFF_OPTIONS_HELP \
|
|
|
|
"\ncommon diff options:\n" \
|
2005-09-21 07:18:27 +00:00
|
|
|
" -z output diff-raw with lines terminated with NUL.\n" \
|
|
|
|
" -p output patch format.\n" \
|
|
|
|
" -u synonym for -p.\n" \
|
2006-04-11 11:22:17 +00:00
|
|
|
" --patch-with-raw\n" \
|
|
|
|
" output both a patch and the diff-raw format.\n" \
|
2006-04-13 22:15:30 +00:00
|
|
|
" --stat show diffstat instead of patch.\n" \
|
2006-10-12 10:01:00 +00:00
|
|
|
" --numstat show numeric diffstat instead of patch.\n" \
|
2006-04-15 11:41:18 +00:00
|
|
|
" --patch-with-stat\n" \
|
|
|
|
" output a patch and prepend its diffstat.\n" \
|
2005-09-21 07:18:27 +00:00
|
|
|
" --name-only show only names of changed files.\n" \
|
2005-09-21 07:20:06 +00:00
|
|
|
" --name-status show names and status of changed files.\n" \
|
2005-12-14 01:21:41 +00:00
|
|
|
" --full-index show full object name on index lines.\n" \
|
2005-12-18 10:03:15 +00:00
|
|
|
" --abbrev=<n> abbreviate object names in diff-tree header and diff-raw.\n" \
|
2005-09-21 07:18:27 +00:00
|
|
|
" -R swap input file pairs.\n" \
|
|
|
|
" -B detect complete rewrites.\n" \
|
|
|
|
" -M detect renames.\n" \
|
|
|
|
" -C detect copies.\n" \
|
2005-07-13 19:52:35 +00:00
|
|
|
" --find-copies-harder\n" \
|
2005-09-21 07:18:27 +00:00
|
|
|
" try unchanged files as candidate for copy detection.\n" \
|
|
|
|
" -l<n> limit rename attempts up to <n> paths.\n" \
|
|
|
|
" -O<file> reorder diffs according to the <file>.\n" \
|
|
|
|
" -S<string> find filepair whose only one side contains the string.\n" \
|
2005-07-13 19:52:35 +00:00
|
|
|
" --pickaxe-all\n" \
|
2006-07-07 13:57:08 +00:00
|
|
|
" show all files diff when -S is used and hit is found.\n" \
|
|
|
|
" -a --text treat all files as text.\n"
|
2005-07-13 19:52:35 +00:00
|
|
|
|
2005-05-22 02:40:36 +00:00
|
|
|
extern int diff_queue_is_empty(void);
|
2005-09-21 07:00:47 +00:00
|
|
|
extern void diff_flush(struct diff_options*);
|
2005-04-26 01:22:47 +00:00
|
|
|
|
2005-07-25 20:05:44 +00:00
|
|
|
/* diff-raw status letters */
|
2005-07-25 21:31:19 +00:00
|
|
|
#define DIFF_STATUS_ADDED 'A'
|
2005-07-25 20:05:44 +00:00
|
|
|
#define DIFF_STATUS_COPIED 'C'
|
|
|
|
#define DIFF_STATUS_DELETED 'D'
|
|
|
|
#define DIFF_STATUS_MODIFIED 'M'
|
|
|
|
#define DIFF_STATUS_RENAMED 'R'
|
|
|
|
#define DIFF_STATUS_TYPE_CHANGED 'T'
|
|
|
|
#define DIFF_STATUS_UNKNOWN 'X'
|
|
|
|
#define DIFF_STATUS_UNMERGED 'U'
|
|
|
|
|
|
|
|
/* these are not diff-raw status letters proper, but used by
|
|
|
|
* diffcore-filter insn to specify additional restrictions.
|
|
|
|
*/
|
2005-10-05 00:44:17 +00:00
|
|
|
#define DIFF_STATUS_FILTER_AON '*'
|
2005-07-25 20:05:44 +00:00
|
|
|
#define DIFF_STATUS_FILTER_BROKEN 'B'
|
|
|
|
|
2005-12-14 01:21:41 +00:00
|
|
|
extern const char *diff_unique_abbrev(const unsigned char *, int);
|
|
|
|
|
2007-11-10 08:15:03 +00:00
|
|
|
/* do not report anything on removed paths */
|
|
|
|
#define DIFF_SILENT_ON_REMOVED 01
|
git-add: make the entry stat-clean after re-adding the same contents
Earlier in commit 0781b8a9b2fe760fc4ed519a3a26e4b9bd6ccffe
(add_file_to_index: skip rehashing if the cached stat already
matches), add_file_to_index() were taught not to re-add the path
if it already matches the index.
The change meant well, but was not executed quite right. It
used ie_modified() to see if the file on the work tree is really
different from the index, and skipped adding the contents if the
function says "not modified".
This was wrong. There are three possible comparison results
between the index and the file in the work tree:
- with lstat(2) we _know_ they are different. E.g. if the
length or the owner in the cached stat information is
different from the length we just obtained from lstat(2), we
can tell the file is modified without looking at the actual
contents.
- with lstat(2) we _know_ they are the same. The same length,
the same owner, the same everything (but this has a twist, as
described below).
- we cannot tell from lstat(2) information alone and need to go
to the filesystem to actually compare.
The last case arises from what we call 'racy git' situation,
that can be caused with this sequence:
$ echo hello >file
$ git add file
$ echo aeiou >file ;# the same length
If the second "echo" is done within the same filesystem
timestamp granularity as the first "echo", then the timestamp
recorded by "git add" and the timestamp we get from lstat(2)
will be the same, and we can mistakenly say the file is not
modified. The path is called 'racily clean'. We need to
reliably detect racily clean paths are in fact modified.
To solve this problem, when we write out the index, we mark the
index entry that has the same timestamp as the index file itself
(that is the time from the point of view of the filesystem) to
tell any later code that does the lstat(2) comparison not to
trust the cached stat info, and ie_modified() then actually goes
to the filesystem to compare the contents for such a path.
That's all good, but it should not be used for this "git add"
optimization, as the goal of "git add" is to actually update the
path in the index and make it stat-clean. With the false
optimization, we did _not_ cause any data loss (after all, what
we failed to do was only to update the cached stat information),
but it made the following sequence leave the file stat dirty:
$ echo hello >file
$ git add file
$ echo hello >file ;# the same contents
$ git add file
The solution is not to use ie_modified() which goes to the
filesystem to see if it is really clean, but instead use
ie_match_stat() with "assume racily clean paths are dirty"
option, to force re-adding of such a path.
There was another problem with "git add -u". The codepath
shares the same issue when adding the paths that are found to be
modified, but in addition, it asked "git diff-files" machinery
run_diff_files() function (which is "git diff-files") to list
the paths that are modified. But "git diff-files" machinery
uses the same ie_modified() call so that it does not report
racily clean _and_ actually clean paths as modified, which is
not what we want.
The patch allows the callers of run_diff_files() to pass the
same "assume racily clean paths are dirty" option, and makes
"git-add -u" codepath to use that option, to discover and re-add
racily clean _and_ actually clean paths.
We could further optimize on top of this patch to differentiate
the case where the path really needs re-adding (i.e. the content
of the racily clean entry was indeed different) and the case
where only the cached stat information needs to be refreshed
(i.e. the racily clean entry was actually clean), but I do not
think it is worth it.
This patch applies to maint and all the way up.
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2007-11-10 02:22:52 +00:00
|
|
|
/* report racily-clean paths as modified */
|
|
|
|
#define DIFF_RACY_IS_MODIFIED 02
|
2007-11-10 08:15:03 +00:00
|
|
|
extern int run_diff_files(struct rev_info *revs, unsigned int option);
|
2006-04-22 10:58:04 +00:00
|
|
|
extern int run_diff_index(struct rev_info *revs, int cached);
|
2006-04-22 09:43:00 +00:00
|
|
|
|
2007-01-30 09:11:08 +00:00
|
|
|
extern int do_diff_cache(const unsigned char *, struct diff_options *);
|
2006-06-25 01:51:08 +00:00
|
|
|
extern int diff_flush_patch_id(struct diff_options *, unsigned char *);
|
|
|
|
|
2007-12-14 07:40:27 +00:00
|
|
|
extern int diff_result_code(struct diff_options *, int);
|
|
|
|
|
2008-05-24 05:28:56 +00:00
|
|
|
extern void diff_no_index(struct rev_info *, int, const char **, int, const char *);
|
|
|
|
|
2009-02-10 14:30:35 +00:00
|
|
|
extern int index_differs_from(const char *def, int diff_flags);
|
|
|
|
|
2005-04-26 01:22:47 +00:00
|
|
|
#endif /* DIFF_H */
|