4 #include "parse-options.h"
9 #include "commit-slab-decl.h"
11 /* Remember to update object flag allocation in object.h */
13 #define UNINTERESTING (1u<<1)
14 #define TREESAME (1u<<2)
16 #define TMP_MARK (1u<<4) /* for isolated cases; clean after use */
17 #define BOUNDARY (1u<<5)
18 #define CHILD_SHOWN (1u<<6)
19 #define ADDED (1u<<7) /* Parents already parsed and added? */
20 #define SYMMETRIC_LEFT (1u<<8)
21 #define PATCHSAME (1u<<9)
22 #define BOTTOM (1u<<10)
24 * Indicates object was reached by traversal. i.e. not given by user on
25 * command-line or stdin.
26 * NEEDSWORK: NOT_USER_GIVEN doesn't apply to commits because we only support
27 * filtering trees and blobs, but it may be useful to support filtering commits
30 #define NOT_USER_GIVEN (1u<<25)
31 #define TRACK_LINEAR (1u<<26)
32 #define ALL_REV_FLAGS (((1u<<11)-1) | NOT_USER_GIVEN | TRACK_LINEAR)
34 #define DECORATE_SHORT_REFS 1
35 #define DECORATE_FULL_REFS 2
41 define_shared_commit_slab(revision_sources
, char *);
43 struct rev_cmdline_info
{
46 struct rev_cmdline_entry
{
61 #define REVISION_WALK_WALK 0
62 #define REVISION_WALK_NO_WALK_SORTED 1
63 #define REVISION_WALK_NO_WALK_UNSORTED 2
67 struct commit_list
*commits
;
68 struct object_array pending
;
70 /* Parents of shown commits */
71 struct object_array boundary_commits
;
73 /* The end-points specified by the end user */
74 struct rev_cmdline_info cmdline
;
76 /* excluding from --branches, --refs, etc. expansion */
77 struct string_list
*ref_excludes
;
79 /* Basic information */
82 struct pathspec prune_data
;
85 * Whether the arguments parsed by setup_revisions() included any
86 * "input" revisions that might still have yielded an empty pending
87 * list (e.g., patterns like "--all" or "--glob").
92 enum rev_sort_order sort_order
;
94 unsigned int early_output
;
96 unsigned int ignore_missing
:1,
97 ignore_missing_links
:1;
100 unsigned int dense
:1,
103 remove_empty_trees
:1,
107 simplify_by_decoration
:1,
114 edge_hint_aggressive
:1,
126 reverse_output_stage
:1,
132 line_level_traverse
:1,
133 tree_blobs_in_commit_order
:1,
136 * Blobs are shown without regard for their existence.
137 * But not so for trees: unless exclude_promisor_objects
138 * is set and the tree in question is a promisor object;
139 * OR ignore_missing_links is set, the revision walker
140 * dies with a "bad tree object HASH" message when
141 * encountering a missing tree. For callers that can
142 * handle missing trees and want them to be filterable
143 * and showable, set this to true. The revision walker
144 * will filter and show such a missing tree as usual,
145 * but will not attempt to recurse into this tree
148 do_not_die_on_missing_tree
:1,
150 /* for internal use only */
151 exclude_promisor_objects
:1;
161 dense_combined_merges
:1,
162 always_show_header
:1;
165 unsigned int shown_one
:1,
173 abbrev_commit_given
:1,
177 date_mode_explicit
:1,
179 unsigned int disable_stdin
:1;
180 /* --show-linear-break */
181 unsigned int track_linear
:1,
185 struct date_mode date_mode
;
186 int expand_tabs_in_log
; /* unset if negative */
187 int expand_tabs_in_log_default
;
190 enum cmit_fmt commit_format
;
191 struct log_info
*loginfo
;
193 const char *mime_boundary
;
194 const char *patch_suffix
;
198 struct ident_split from_ident
;
199 struct string_list
*ref_message_ids
;
201 const char *extra_headers
;
202 const char *log_reencode
;
203 const char *subject_prefix
;
206 struct string_list
*mailmap
;
208 /* Filter by commit log message */
209 struct grep_opt grep_filter
;
210 /* Negate the match of grep_filter */
213 /* Display history graph */
214 struct git_graph
*graph
;
223 int (*include_check
)(struct commit
*, void *);
224 void *include_check_data
;
226 /* diff info for patches and for paths limiting */
227 struct diff_options diffopt
;
228 struct diff_options pruning
;
230 struct reflog_walk_info
*reflog_info
;
231 struct decoration children
;
232 struct decoration merge_simplification
;
233 struct decoration treesame
;
235 /* notes-specific options: which refs to show */
236 struct display_notes_opt notes_opt
;
243 /* line level range that we are chasing */
244 struct decoration line_log_data
;
246 /* copies of the parent lists, for --full-diff display */
247 struct saved_parents
*saved_parents_slab
;
249 struct commit_list
*previous_parents
;
250 const char *break_bar
;
252 struct revision_sources
*sources
;
255 extern int ref_excluded(struct string_list
*, const char *path
);
256 void clear_ref_exclusion(struct string_list
**);
257 void add_ref_exclusion(struct string_list
**, const char *exclude
);
260 #define REV_TREE_SAME 0
261 #define REV_TREE_NEW 1 /* Only new files */
262 #define REV_TREE_OLD 2 /* Only files removed */
263 #define REV_TREE_DIFFERENT 3 /* Mixed changes */
266 typedef void (*show_early_output_fn_t
)(struct rev_info
*, struct commit_list
*);
267 extern volatile show_early_output_fn_t show_early_output
;
269 struct setup_revision_opt
{
271 void (*tweak
)(struct rev_info
*, struct setup_revision_opt
*);
272 const char *submodule
;
277 extern void init_revisions(struct rev_info
*revs
, const char *prefix
);
278 extern int setup_revisions(int argc
, const char **argv
, struct rev_info
*revs
,
279 struct setup_revision_opt
*);
280 extern void parse_revision_opt(struct rev_info
*revs
, struct parse_opt_ctx_t
*ctx
,
281 const struct option
*options
,
282 const char * const usagestr
[]);
283 #define REVARG_CANNOT_BE_FILENAME 01
284 #define REVARG_COMMITTISH 02
285 extern int handle_revision_arg(const char *arg
, struct rev_info
*revs
,
286 int flags
, unsigned revarg_opt
);
288 extern void reset_revision_walk(void);
289 extern int prepare_revision_walk(struct rev_info
*revs
);
290 extern struct commit
*get_revision(struct rev_info
*revs
);
291 extern char *get_revision_mark(const struct rev_info
*revs
,
292 const struct commit
*commit
);
293 extern void put_revision_mark(const struct rev_info
*revs
,
294 const struct commit
*commit
);
296 extern void mark_parents_uninteresting(struct commit
*commit
);
297 extern void mark_tree_uninteresting(struct tree
*tree
);
299 extern void show_object_with_name(FILE *, struct object
*, const char *);
301 extern void add_pending_object(struct rev_info
*revs
,
302 struct object
*obj
, const char *name
);
303 extern void add_pending_oid(struct rev_info
*revs
,
304 const char *name
, const struct object_id
*oid
,
307 extern void add_head_to_pending(struct rev_info
*);
308 extern void add_reflogs_to_pending(struct rev_info
*, unsigned int flags
);
309 extern void add_index_objects_to_pending(struct rev_info
*, unsigned int flags
);
317 extern enum commit_action
get_commit_action(struct rev_info
*revs
,
318 struct commit
*commit
);
319 extern enum commit_action
simplify_commit(struct rev_info
*revs
,
320 struct commit
*commit
);
322 enum rewrite_result
{
324 rewrite_one_noparents
,
328 typedef enum rewrite_result (*rewrite_parent_fn_t
)(struct rev_info
*revs
, struct commit
**pp
);
330 extern int rewrite_parents(struct rev_info
*revs
, struct commit
*commit
,
331 rewrite_parent_fn_t rewrite_parent
);
334 * The log machinery saves the original parent list so that
335 * get_saved_parents() can later tell what the real parents of the
336 * commits are, when commit->parents has been modified by history
339 * get_saved_parents() will transparently return commit->parents if
340 * history simplification is off.
342 extern struct commit_list
*get_saved_parents(struct rev_info
*revs
, const struct commit
*commit
);