tutorial: add discussion of index file, object database
[git.git] / revision.h
1 #ifndef REVISION_H
2 #define REVISION_H
3
4 #define SEEN            (1u<<0)
5 #define UNINTERESTING   (1u<<1)
6 #define TREECHANGE      (1u<<2)
7 #define SHOWN           (1u<<3)
8 #define TMP_MARK        (1u<<4) /* for isolated cases; clean after use */
9 #define BOUNDARY        (1u<<5)
10 #define BOUNDARY_SHOW   (1u<<6)
11 #define ADDED           (1u<<7) /* Parents already parsed and added? */
12
13 struct rev_info;
14 struct log_info;
15
16 typedef void (prune_fn_t)(struct rev_info *revs, struct commit *commit);
17
18 struct rev_info {
19         /* Starting list */
20         struct commit_list *commits;
21         struct object_list *pending_objects;
22
23         /* Basic information */
24         const char *prefix;
25         void *prune_data;
26         prune_fn_t *prune_fn;
27
28         /* Traversal flags */
29         unsigned int    dense:1,
30                         no_merges:1,
31                         no_walk:1,
32                         remove_empty_trees:1,
33                         lifo:1,
34                         topo_order:1,
35                         tag_objects:1,
36                         tree_objects:1,
37                         blob_objects:1,
38                         edge_hint:1,
39                         limited:1,
40                         unpacked:1,
41                         boundary:1,
42                         parents:1;
43
44         /* Diff flags */
45         unsigned int    diff:1,
46                         full_diff:1,
47                         show_root_diff:1,
48                         no_commit_id:1,
49                         verbose_header:1,
50                         ignore_merges:1,
51                         combine_merges:1,
52                         dense_combined_merges:1,
53                         always_show_header:1;
54
55         /* Format info */
56         unsigned int    shown_one:1,
57                         abbrev_commit:1;
58         unsigned int    abbrev;
59         enum cmit_fmt   commit_format;
60         struct log_info *loginfo;
61
62         /* special limits */
63         int max_count;
64         unsigned long max_age;
65         unsigned long min_age;
66
67         /* diff info for patches and for paths limiting */
68         struct diff_options diffopt;
69         struct diff_options pruning;
70
71         topo_sort_set_fn_t topo_setter;
72         topo_sort_get_fn_t topo_getter;
73 };
74
75 #define REV_TREE_SAME           0
76 #define REV_TREE_NEW            1
77 #define REV_TREE_DIFFERENT      2
78
79 /* revision.c */
80 extern int rev_same_tree_as_empty(struct rev_info *, struct tree *t1);
81 extern int rev_compare_tree(struct rev_info *, struct tree *t1, struct tree *t2);
82
83 extern void init_revisions(struct rev_info *revs);
84 extern int setup_revisions(int argc, const char **argv, struct rev_info *revs, const char *def);
85 extern void prepare_revision_walk(struct rev_info *revs);
86 extern struct commit *get_revision(struct rev_info *revs);
87
88 extern void mark_parents_uninteresting(struct commit *commit);
89 extern void mark_tree_uninteresting(struct tree *tree);
90
91 struct name_path {
92         struct name_path *up;
93         int elem_len;
94         const char *elem;
95 };
96
97 extern struct object_list **add_object(struct object *obj,
98                                        struct object_list **p,
99                                        struct name_path *path,
100                                        const char *name);
101
102 #endif