1#ifndef REVISION_H
2#define REVISION_H
3
4#include "parse-options.h"
5#include "grep.h"
6#include "notes.h"
7
8#define SEEN (1u<<0)
9#define UNINTERESTING (1u<<1)
10#define TREESAME (1u<<2)
11#define SHOWN (1u<<3)
12#define TMP_MARK (1u<<4) /* for isolated cases; clean after use */
13#define BOUNDARY (1u<<5)
14#define CHILD_SHOWN (1u<<6)
15#define ADDED (1u<<7) /* Parents already parsed and added? */
16#define SYMMETRIC_LEFT (1u<<8)
17#define PATCHSAME (1u<<9)
18#define ALL_REV_FLAGS ((1u<<10)-1)
19
20#define DECORATE_SHORT_REFS 1
21#define DECORATE_FULL_REFS 2
22
23struct rev_info;
24struct log_info;
25struct string_list;
26
27struct rev_info {
28 /* Starting list */
29 struct commit_list *commits;
30 struct object_array pending;
31
32 /* Parents of shown commits */
33 struct object_array boundary_commits;
34
35 /* Basic information */
36 const char *prefix;
37 const char *def;
38 struct pathspec prune_data;
39 unsigned int early_output:1,
40 ignore_missing:1;
41
42 /* Traversal flags */
43 unsigned int dense:1,
44 prune:1,
45 no_walk:1,
46 show_all:1,
47 remove_empty_trees:1,
48 simplify_history:1,
49 lifo:1,
50 topo_order:1,
51 simplify_merges:1,
52 simplify_by_decoration:1,
53 tag_objects:1,
54 tree_objects:1,
55 blob_objects:1,
56 verify_objects:1,
57 edge_hint:1,
58 limited:1,
59 unpacked:1,
60 boundary:2,
61 count:1,
62 left_right:1,
63 left_only:1,
64 right_only:1,
65 rewrite_parents:1,
66 print_parents:1,
67 show_source:1,
68 show_decorations:1,
69 reverse:1,
70 reverse_output_stage:1,
71 cherry_pick:1,
72 cherry_mark:1,
73 bisect:1,
74 ancestry_path:1,
75 first_parent_only:1;
76
77 /* Diff flags */
78 unsigned int diff:1,
79 full_diff:1,
80 show_root_diff:1,
81 no_commit_id:1,
82 verbose_header:1,
83 ignore_merges:1,
84 combine_merges:1,
85 dense_combined_merges:1,
86 always_show_header:1;
87
88 /* Format info */
89 unsigned int shown_one:1,
90 show_merge:1,
91 show_notes:1,
92 show_notes_given:1,
93 pretty_given:1,
94 abbrev_commit:1,
95 abbrev_commit_given:1,
96 use_terminator:1,
97 missing_newline:1,
98 date_mode_explicit:1,
99 preserve_subject:1;
100 unsigned int disable_stdin:1;
101
102 enum date_mode date_mode;
103
104 unsigned int abbrev;
105 enum cmit_fmt commit_format;
106 struct log_info *loginfo;
107 int nr, total;
108 const char *mime_boundary;
109 const char *patch_suffix;
110 int numbered_files;
111 char *message_id;
112 struct string_list *ref_message_ids;
113 const char *add_signoff;
114 const char *extra_headers;
115 const char *log_reencode;
116 const char *subject_prefix;
117 int no_inline;
118 int show_log_size;
119
120 /* Filter by commit log message */
121 struct grep_opt grep_filter;
122
123 /* Display history graph */
124 struct git_graph *graph;
125
126 /* special limits */
127 int skip_count;
128 int max_count;
129 unsigned long max_age;
130 unsigned long min_age;
131 int min_parents;
132 int max_parents;
133
134 /* diff info for patches and for paths limiting */
135 struct diff_options diffopt;
136 struct diff_options pruning;
137
138 struct reflog_walk_info *reflog_info;
139 struct decoration children;
140 struct decoration merge_simplification;
141
142 /* notes-specific options: which refs to show */
143 struct display_notes_opt notes_opt;
144
145 /* commit counts */
146 int count_left;
147 int count_right;
148 int count_same;
149};
150
151#define REV_TREE_SAME 0
152#define REV_TREE_NEW 1 /* Only new files */
153#define REV_TREE_OLD 2 /* Only files removed */
154#define REV_TREE_DIFFERENT 3 /* Mixed changes */
155
156/* revision.c */
157typedef void (*show_early_output_fn_t)(struct rev_info *, struct commit_list *);
158extern volatile show_early_output_fn_t show_early_output;
159
160struct setup_revision_opt {
161 const char *def;
162 void (*tweak)(struct rev_info *, struct setup_revision_opt *);
163 const char *submodule;
164};
165
166extern void init_revisions(struct rev_info *revs, const char *prefix);
167extern int setup_revisions(int argc, const char **argv, struct rev_info *revs, struct setup_revision_opt *);
168extern void parse_revision_opt(struct rev_info *revs, struct parse_opt_ctx_t *ctx,
169 const struct option *options,
170 const char * const usagestr[]);
171extern int handle_revision_arg(const char *arg, struct rev_info *revs,int flags,int cant_be_filename);
172
173extern int prepare_revision_walk(struct rev_info *revs);
174extern struct commit *get_revision(struct rev_info *revs);
175extern char *get_revision_mark(const struct rev_info *revs, const struct commit *commit);
176extern void put_revision_mark(const struct rev_info *revs, const struct commit *commit);
177
178extern void mark_parents_uninteresting(struct commit *commit);
179extern void mark_tree_uninteresting(struct tree *tree);
180
181struct name_path {
182 struct name_path *up;
183 int elem_len;
184 const char *elem;
185};
186
187char *path_name(const struct name_path *path, const char *name);
188
189extern void show_object_with_name(FILE *, struct object *, const struct name_path *, const char *);
190
191extern void add_object(struct object *obj,
192 struct object_array *p,
193 struct name_path *path,
194 const char *name);
195
196extern void add_pending_object(struct rev_info *revs, struct object *obj, const char *name);
197
198extern void add_head_to_pending(struct rev_info *);
199
200enum commit_action {
201 commit_ignore,
202 commit_show,
203 commit_error
204};
205
206extern enum commit_action get_commit_action(struct rev_info *revs, struct commit *commit);
207extern enum commit_action simplify_commit(struct rev_info *revs, struct commit *commit);
208
209#endif