]>
Commit | Line | Data |
---|---|---|
1 | /* | |
2 | * Copyright (C) 2005 Junio C Hamano | |
3 | */ | |
4 | #ifndef DIFF_H | |
5 | #define DIFF_H | |
6 | ||
7 | #include "tree-walk.h" | |
8 | #include "pathspec.h" | |
9 | #include "object.h" | |
10 | ||
11 | struct rev_info; | |
12 | struct diff_options; | |
13 | struct diff_queue_struct; | |
14 | struct strbuf; | |
15 | struct diff_filespec; | |
16 | struct userdiff_driver; | |
17 | struct sha1_array; | |
18 | struct commit; | |
19 | struct combine_diff_path; | |
20 | ||
21 | typedef int (*pathchange_fn_t)(struct diff_options *options, | |
22 | struct combine_diff_path *path); | |
23 | ||
24 | typedef void (*change_fn_t)(struct diff_options *options, | |
25 | unsigned old_mode, unsigned new_mode, | |
26 | const unsigned char *old_sha1, | |
27 | const unsigned char *new_sha1, | |
28 | int old_sha1_valid, int new_sha1_valid, | |
29 | const char *fullpath, | |
30 | unsigned old_dirty_submodule, unsigned new_dirty_submodule); | |
31 | ||
32 | typedef void (*add_remove_fn_t)(struct diff_options *options, | |
33 | int addremove, unsigned mode, | |
34 | const unsigned char *sha1, | |
35 | int sha1_valid, | |
36 | const char *fullpath, unsigned dirty_submodule); | |
37 | ||
38 | typedef void (*diff_format_fn_t)(struct diff_queue_struct *q, | |
39 | struct diff_options *options, void *data); | |
40 | ||
41 | typedef struct strbuf *(*diff_prefix_fn_t)(struct diff_options *opt, void *data); | |
42 | ||
43 | #define DIFF_FORMAT_RAW 0x0001 | |
44 | #define DIFF_FORMAT_DIFFSTAT 0x0002 | |
45 | #define DIFF_FORMAT_NUMSTAT 0x0004 | |
46 | #define DIFF_FORMAT_SUMMARY 0x0008 | |
47 | #define DIFF_FORMAT_PATCH 0x0010 | |
48 | #define DIFF_FORMAT_SHORTSTAT 0x0020 | |
49 | #define DIFF_FORMAT_DIRSTAT 0x0040 | |
50 | ||
51 | /* These override all above */ | |
52 | #define DIFF_FORMAT_NAME 0x0100 | |
53 | #define DIFF_FORMAT_NAME_STATUS 0x0200 | |
54 | #define DIFF_FORMAT_CHECKDIFF 0x0400 | |
55 | ||
56 | /* Same as output_format = 0 but we know that -s flag was given | |
57 | * and we should not give default value to output_format. | |
58 | */ | |
59 | #define DIFF_FORMAT_NO_OUTPUT 0x0800 | |
60 | ||
61 | #define DIFF_FORMAT_CALLBACK 0x1000 | |
62 | ||
63 | #define DIFF_OPT_RECURSIVE (1 << 0) | |
64 | #define DIFF_OPT_TREE_IN_RECURSIVE (1 << 1) | |
65 | #define DIFF_OPT_BINARY (1 << 2) | |
66 | #define DIFF_OPT_TEXT (1 << 3) | |
67 | #define DIFF_OPT_FULL_INDEX (1 << 4) | |
68 | #define DIFF_OPT_SILENT_ON_REMOVE (1 << 5) | |
69 | #define DIFF_OPT_FIND_COPIES_HARDER (1 << 6) | |
70 | #define DIFF_OPT_FOLLOW_RENAMES (1 << 7) | |
71 | #define DIFF_OPT_RENAME_EMPTY (1 << 8) | |
72 | /* (1 << 9) unused */ | |
73 | #define DIFF_OPT_HAS_CHANGES (1 << 10) | |
74 | #define DIFF_OPT_QUICK (1 << 11) | |
75 | #define DIFF_OPT_NO_INDEX (1 << 12) | |
76 | #define DIFF_OPT_ALLOW_EXTERNAL (1 << 13) | |
77 | #define DIFF_OPT_EXIT_WITH_STATUS (1 << 14) | |
78 | #define DIFF_OPT_REVERSE_DIFF (1 << 15) | |
79 | #define DIFF_OPT_CHECK_FAILED (1 << 16) | |
80 | #define DIFF_OPT_RELATIVE_NAME (1 << 17) | |
81 | #define DIFF_OPT_IGNORE_SUBMODULES (1 << 18) | |
82 | #define DIFF_OPT_DIRSTAT_CUMULATIVE (1 << 19) | |
83 | #define DIFF_OPT_DIRSTAT_BY_FILE (1 << 20) | |
84 | #define DIFF_OPT_ALLOW_TEXTCONV (1 << 21) | |
85 | #define DIFF_OPT_DIFF_FROM_CONTENTS (1 << 22) | |
86 | #define DIFF_OPT_SUBMODULE_LOG (1 << 23) | |
87 | #define DIFF_OPT_DIRTY_SUBMODULES (1 << 24) | |
88 | #define DIFF_OPT_IGNORE_UNTRACKED_IN_SUBMODULES (1 << 25) | |
89 | #define DIFF_OPT_IGNORE_DIRTY_SUBMODULES (1 << 26) | |
90 | #define DIFF_OPT_OVERRIDE_SUBMODULE_CONFIG (1 << 27) | |
91 | #define DIFF_OPT_DIRSTAT_BY_LINE (1 << 28) | |
92 | #define DIFF_OPT_FUNCCONTEXT (1 << 29) | |
93 | #define DIFF_OPT_PICKAXE_IGNORE_CASE (1 << 30) | |
94 | ||
95 | #define DIFF_OPT_TST(opts, flag) ((opts)->flags & DIFF_OPT_##flag) | |
96 | #define DIFF_OPT_TOUCHED(opts, flag) ((opts)->touched_flags & DIFF_OPT_##flag) | |
97 | #define DIFF_OPT_SET(opts, flag) (((opts)->flags |= DIFF_OPT_##flag),((opts)->touched_flags |= DIFF_OPT_##flag)) | |
98 | #define DIFF_OPT_CLR(opts, flag) (((opts)->flags &= ~DIFF_OPT_##flag),((opts)->touched_flags |= DIFF_OPT_##flag)) | |
99 | #define DIFF_XDL_TST(opts, flag) ((opts)->xdl_opts & XDF_##flag) | |
100 | #define DIFF_XDL_SET(opts, flag) ((opts)->xdl_opts |= XDF_##flag) | |
101 | #define DIFF_XDL_CLR(opts, flag) ((opts)->xdl_opts &= ~XDF_##flag) | |
102 | ||
103 | #define DIFF_WITH_ALG(opts, flag) (((opts)->xdl_opts & ~XDF_DIFF_ALGORITHM_MASK) | XDF_##flag) | |
104 | ||
105 | enum diff_words_type { | |
106 | DIFF_WORDS_NONE = 0, | |
107 | DIFF_WORDS_PORCELAIN, | |
108 | DIFF_WORDS_PLAIN, | |
109 | DIFF_WORDS_COLOR | |
110 | }; | |
111 | ||
112 | struct diff_options { | |
113 | const char *orderfile; | |
114 | const char *pickaxe; | |
115 | const char *single_follow; | |
116 | const char *a_prefix, *b_prefix; | |
117 | unsigned flags; | |
118 | unsigned touched_flags; | |
119 | ||
120 | /* diff-filter bits */ | |
121 | unsigned int filter; | |
122 | ||
123 | int use_color; | |
124 | int context; | |
125 | int interhunkcontext; | |
126 | int break_opt; | |
127 | int detect_rename; | |
128 | int irreversible_delete; | |
129 | int skip_stat_unmatch; | |
130 | int line_termination; | |
131 | int output_format; | |
132 | int pickaxe_opts; | |
133 | int rename_score; | |
134 | int rename_limit; | |
135 | int needed_rename_limit; | |
136 | int degraded_cc_to_c; | |
137 | int show_rename_progress; | |
138 | int dirstat_permille; | |
139 | int setup; | |
140 | int abbrev; | |
141 | const char *prefix; | |
142 | int prefix_length; | |
143 | const char *stat_sep; | |
144 | long xdl_opts; | |
145 | ||
146 | int stat_width; | |
147 | int stat_name_width; | |
148 | int stat_graph_width; | |
149 | int stat_count; | |
150 | const char *word_regex; | |
151 | enum diff_words_type word_diff; | |
152 | ||
153 | /* this is set by diffcore for DIFF_FORMAT_PATCH */ | |
154 | int found_changes; | |
155 | ||
156 | /* to support internal diff recursion by --follow hack*/ | |
157 | int found_follow; | |
158 | ||
159 | void (*set_default)(struct diff_options *); | |
160 | ||
161 | FILE *file; | |
162 | int close_file; | |
163 | ||
164 | struct pathspec pathspec; | |
165 | pathchange_fn_t pathchange; | |
166 | change_fn_t change; | |
167 | add_remove_fn_t add_remove; | |
168 | diff_format_fn_t format_callback; | |
169 | void *format_callback_data; | |
170 | diff_prefix_fn_t output_prefix; | |
171 | int output_prefix_length; | |
172 | void *output_prefix_data; | |
173 | ||
174 | int diff_path_counter; | |
175 | }; | |
176 | ||
177 | enum color_diff { | |
178 | DIFF_RESET = 0, | |
179 | DIFF_PLAIN = 1, | |
180 | DIFF_METAINFO = 2, | |
181 | DIFF_FRAGINFO = 3, | |
182 | DIFF_FILE_OLD = 4, | |
183 | DIFF_FILE_NEW = 5, | |
184 | DIFF_COMMIT = 6, | |
185 | DIFF_WHITESPACE = 7, | |
186 | DIFF_FUNCINFO = 8 | |
187 | }; | |
188 | const char *diff_get_color(int diff_use_color, enum color_diff ix); | |
189 | #define diff_get_color_opt(o, ix) \ | |
190 | diff_get_color((o)->use_color, ix) | |
191 | ||
192 | ||
193 | const char *diff_line_prefix(struct diff_options *); | |
194 | ||
195 | ||
196 | extern const char mime_boundary_leader[]; | |
197 | ||
198 | extern struct combine_diff_path *diff_tree_paths( | |
199 | struct combine_diff_path *p, const unsigned char *sha1, | |
200 | const unsigned char **parent_sha1, int nparent, | |
201 | struct strbuf *base, struct diff_options *opt); | |
202 | extern int diff_tree_sha1(const unsigned char *old, const unsigned char *new, | |
203 | const char *base, struct diff_options *opt); | |
204 | extern int diff_root_tree_sha1(const unsigned char *new, const char *base, | |
205 | struct diff_options *opt); | |
206 | ||
207 | struct combine_diff_path { | |
208 | struct combine_diff_path *next; | |
209 | char *path; | |
210 | unsigned int mode; | |
211 | struct object_id oid; | |
212 | struct combine_diff_parent { | |
213 | char status; | |
214 | unsigned int mode; | |
215 | struct object_id oid; | |
216 | } parent[FLEX_ARRAY]; | |
217 | }; | |
218 | #define combine_diff_path_size(n, l) \ | |
219 | (sizeof(struct combine_diff_path) + \ | |
220 | sizeof(struct combine_diff_parent) * (n) + (l) + 1) | |
221 | ||
222 | extern void show_combined_diff(struct combine_diff_path *elem, int num_parent, | |
223 | int dense, struct rev_info *); | |
224 | ||
225 | extern void diff_tree_combined(const unsigned char *sha1, const struct sha1_array *parents, int dense, struct rev_info *rev); | |
226 | ||
227 | extern void diff_tree_combined_merge(const struct commit *commit, int dense, struct rev_info *rev); | |
228 | ||
229 | void diff_set_mnemonic_prefix(struct diff_options *options, const char *a, const char *b); | |
230 | ||
231 | extern int diff_can_quit_early(struct diff_options *); | |
232 | ||
233 | extern void diff_addremove(struct diff_options *, | |
234 | int addremove, | |
235 | unsigned mode, | |
236 | const unsigned char *sha1, | |
237 | int sha1_valid, | |
238 | const char *fullpath, unsigned dirty_submodule); | |
239 | ||
240 | extern void diff_change(struct diff_options *, | |
241 | unsigned mode1, unsigned mode2, | |
242 | const unsigned char *sha1, | |
243 | const unsigned char *sha2, | |
244 | int sha1_valid, | |
245 | int sha2_valid, | |
246 | const char *fullpath, | |
247 | unsigned dirty_submodule1, unsigned dirty_submodule2); | |
248 | ||
249 | extern struct diff_filepair *diff_unmerge(struct diff_options *, const char *path); | |
250 | ||
251 | #define DIFF_SETUP_REVERSE 1 | |
252 | #define DIFF_SETUP_USE_CACHE 2 | |
253 | #define DIFF_SETUP_USE_SIZE_CACHE 4 | |
254 | ||
255 | /* | |
256 | * Poor man's alternative to parse-option, to allow both stuck form | |
257 | * (--option=value) and separate form (--option value). | |
258 | */ | |
259 | extern int parse_long_opt(const char *opt, const char **argv, | |
260 | const char **optarg); | |
261 | ||
262 | extern int git_diff_basic_config(const char *var, const char *value, void *cb); | |
263 | extern int git_diff_ui_config(const char *var, const char *value, void *cb); | |
264 | extern void diff_setup(struct diff_options *); | |
265 | extern int diff_opt_parse(struct diff_options *, const char **, int); | |
266 | extern void diff_setup_done(struct diff_options *); | |
267 | ||
268 | #define DIFF_DETECT_RENAME 1 | |
269 | #define DIFF_DETECT_COPY 2 | |
270 | ||
271 | #define DIFF_PICKAXE_ALL 1 | |
272 | #define DIFF_PICKAXE_REGEX 2 | |
273 | ||
274 | #define DIFF_PICKAXE_KIND_S 4 /* traditional plumbing counter */ | |
275 | #define DIFF_PICKAXE_KIND_G 8 /* grep in the patch */ | |
276 | ||
277 | extern void diffcore_std(struct diff_options *); | |
278 | extern void diffcore_fix_diff_index(struct diff_options *); | |
279 | ||
280 | #define COMMON_DIFF_OPTIONS_HELP \ | |
281 | "\ncommon diff options:\n" \ | |
282 | " -z output diff-raw with lines terminated with NUL.\n" \ | |
283 | " -p output patch format.\n" \ | |
284 | " -u synonym for -p.\n" \ | |
285 | " --patch-with-raw\n" \ | |
286 | " output both a patch and the diff-raw format.\n" \ | |
287 | " --stat show diffstat instead of patch.\n" \ | |
288 | " --numstat show numeric diffstat instead of patch.\n" \ | |
289 | " --patch-with-stat\n" \ | |
290 | " output a patch and prepend its diffstat.\n" \ | |
291 | " --name-only show only names of changed files.\n" \ | |
292 | " --name-status show names and status of changed files.\n" \ | |
293 | " --full-index show full object name on index lines.\n" \ | |
294 | " --abbrev=<n> abbreviate object names in diff-tree header and diff-raw.\n" \ | |
295 | " -R swap input file pairs.\n" \ | |
296 | " -B detect complete rewrites.\n" \ | |
297 | " -M detect renames.\n" \ | |
298 | " -C detect copies.\n" \ | |
299 | " --find-copies-harder\n" \ | |
300 | " try unchanged files as candidate for copy detection.\n" \ | |
301 | " -l<n> limit rename attempts up to <n> paths.\n" \ | |
302 | " -O<file> reorder diffs according to the <file>.\n" \ | |
303 | " -S<string> find filepair whose only one side contains the string.\n" \ | |
304 | " --pickaxe-all\n" \ | |
305 | " show all files diff when -S is used and hit is found.\n" \ | |
306 | " -a --text treat all files as text.\n" | |
307 | ||
308 | extern int diff_queue_is_empty(void); | |
309 | extern void diff_flush(struct diff_options*); | |
310 | extern void diff_warn_rename_limit(const char *varname, int needed, int degraded_cc); | |
311 | ||
312 | /* diff-raw status letters */ | |
313 | #define DIFF_STATUS_ADDED 'A' | |
314 | #define DIFF_STATUS_COPIED 'C' | |
315 | #define DIFF_STATUS_DELETED 'D' | |
316 | #define DIFF_STATUS_MODIFIED 'M' | |
317 | #define DIFF_STATUS_RENAMED 'R' | |
318 | #define DIFF_STATUS_TYPE_CHANGED 'T' | |
319 | #define DIFF_STATUS_UNKNOWN 'X' | |
320 | #define DIFF_STATUS_UNMERGED 'U' | |
321 | ||
322 | /* these are not diff-raw status letters proper, but used by | |
323 | * diffcore-filter insn to specify additional restrictions. | |
324 | */ | |
325 | #define DIFF_STATUS_FILTER_AON '*' | |
326 | #define DIFF_STATUS_FILTER_BROKEN 'B' | |
327 | ||
328 | extern const char *diff_unique_abbrev(const unsigned char *, int); | |
329 | ||
330 | /* do not report anything on removed paths */ | |
331 | #define DIFF_SILENT_ON_REMOVED 01 | |
332 | /* report racily-clean paths as modified */ | |
333 | #define DIFF_RACY_IS_MODIFIED 02 | |
334 | extern int run_diff_files(struct rev_info *revs, unsigned int option); | |
335 | extern int run_diff_index(struct rev_info *revs, int cached); | |
336 | ||
337 | extern int do_diff_cache(const unsigned char *, struct diff_options *); | |
338 | extern int diff_flush_patch_id(struct diff_options *, unsigned char *); | |
339 | ||
340 | extern int diff_result_code(struct diff_options *, int); | |
341 | ||
342 | extern void diff_no_index(struct rev_info *, int, const char **, const char *); | |
343 | ||
344 | extern int index_differs_from(const char *def, int diff_flags); | |
345 | ||
346 | extern size_t fill_textconv(struct userdiff_driver *driver, | |
347 | struct diff_filespec *df, | |
348 | char **outbuf); | |
349 | ||
350 | extern struct userdiff_driver *get_textconv(struct diff_filespec *one); | |
351 | ||
352 | extern int parse_rename_score(const char **cp_p); | |
353 | ||
354 | extern long parse_algorithm_value(const char *value); | |
355 | ||
356 | extern int print_stat_summary(FILE *fp, int files, | |
357 | int insertions, int deletions); | |
358 | extern void setup_diff_pager(struct diff_options *); | |
359 | ||
360 | #endif /* DIFF_H */ |