🌐 AI搜索 & 代理 主页
Google Git
Sign in
chromium / external / github.com / git / git / refs/tags/v1.7.4-rc0 / . / commit.h
blob: eb6c5af1f6b18546b3b3f1683142b15bb0ae9e34 [file] [log] [blame]
Daniel Barkalow6eb8ae02005-04-18 18:39:48[diff] [blame]1#ifndef COMMIT_H
2#define COMMIT_H
3
4#include "object.h"
5#include "tree.h"
Pierre Habouzit674d1722007-09-10 10:35:06[diff] [blame]6#include "strbuf.h"
Linus Torvaldsca135e72007-04-16 23:05:10[diff] [blame]7#include "decorate.h"
Daniel Barkalow6eb8ae02005-04-18 18:39:48[diff] [blame]8
9struct commit_list {
10 struct commit *item;
11 struct commit_list *next;
12};
13
14struct commit {
15 struct object object;
Linus Torvaldsd3ff6f52006-06-18 01:26:18[diff] [blame]16 void *util;
Linus Torvalds23c17d42007-11-02 20:32:58[diff] [blame]17 unsigned int indegree;
Daniel Barkalow6eb8ae02005-04-18 18:39:48[diff] [blame]18 unsigned long date;
19 struct commit_list *parents;
20 struct tree *tree;
Linus Torvaldsbd1e17e2005-05-26 02:26:28[diff] [blame]21 char *buffer;
Daniel Barkalow6eb8ae02005-04-18 18:39:48[diff] [blame]22};
23
Linus Torvalds60ab26d2005-09-15 21:43:17[diff] [blame]24extern int save_commit_buffer;
Daniel Barkalow6eb8ae02005-04-18 18:39:48[diff] [blame]25extern const char *commit_type;
26
Linus Torvaldsca135e72007-04-16 23:05:10[diff] [blame]27/* While we can decorate any object with a name, it's only used for commits.. */
28extern struct decoration name_decoration;
29struct name_decoration {
30 struct name_decoration *next;
Nazri Ramliyeb3005e2010-06-19 01:37:33[diff] [blame]31 int type;
Linus Torvaldsca135e72007-04-16 23:05:10[diff] [blame]32 char name[1];
33};
34
Jason McMullan5d6ccf52005-06-03 15:05:39[diff] [blame]35struct commit *lookup_commit(const unsigned char *sha1);
36struct commit *lookup_commit_reference(const unsigned char *sha1);
Junio C Hamanof76412e2005-08-21 09:51:10[diff] [blame]37struct commit *lookup_commit_reference_gently(const unsigned char *sha1,
38 int quiet);
Pat Notza6fa5992010-11-02 19:59:07[diff] [blame]39struct commit *lookup_commit_reference_by_name(const char *name);
Daniel Barkalow6eb8ae02005-04-18 18:39:48[diff] [blame]40
Nicolas Pitrebd2c39f2005-05-06 17:48:34[diff] [blame]41int parse_commit_buffer(struct commit *item, void *buffer, unsigned long size);
Daniel Barkalow6eb8ae02005-04-18 18:39:48[diff] [blame]42int parse_commit(struct commit *item);
43
Christian Couder11af2aa2010-07-22 13:18:30[diff] [blame]44/* Find beginning and length of commit subject. */
45int find_commit_subject(const char *commit_buffer, const char **subject);
46
Thiago Farina47e44ed2010-11-27 01:58:14[diff] [blame]47struct commit_list *commit_list_insert(struct commit *item,
48 struct commit_list **list);
Miklos Vajna65319472008-06-27 16:21:55[diff] [blame]49unsigned commit_list_count(const struct commit_list *l);
Thiago Farina47e44ed2010-11-27 01:58:14[diff] [blame]50struct commit_list *commit_list_insert_by_date(struct commit *item,
51 struct commit_list **list);
52void commit_list_sort_by_date(struct commit_list **list);
Daniel Barkalowdd97f852005-04-24 01:47:23[diff] [blame]53
Daniel Barkalow6eb8ae02005-04-18 18:39:48[diff] [blame]54void free_commit_list(struct commit_list *list);
55
Linus Torvalds000182e2005-06-05 16:02:03[diff] [blame]56/* Commit formats */
57enum cmit_fmt {
58 CMIT_FMT_RAW,
59 CMIT_FMT_MEDIUM,
60 CMIT_FMT_DEFAULT = CMIT_FMT_MEDIUM,
Linus Torvalds9b66ec02005-06-27 00:50:46[diff] [blame]61 CMIT_FMT_SHORT,
62 CMIT_FMT_FULL,
Junio C Hamanoff56fe12005-11-10 06:15:27[diff] [blame]63 CMIT_FMT_FULLER,
Junio C Hamanod87449c2005-08-09 05:15:40[diff] [blame]64 CMIT_FMT_ONELINE,
Junio C Hamano3eefc182006-04-18 23:45:27[diff] [blame]65 CMIT_FMT_EMAIL,
Johannes Schindeline52a5de2007-02-23 00:35:03[diff] [blame]66 CMIT_FMT_USERFORMAT,
Junio C Hamano6b9c58f2006-04-16 06:46:36[diff] [blame]67
Gary V. Vaughan4b055482010-05-14 09:31:35[diff] [blame]68 CMIT_FMT_UNSPECIFIED
Linus Torvalds000182e2005-06-05 16:02:03[diff] [blame]69};
70
Thomas Rastdd2e7942009-10-19 15:48:08[diff] [blame]71struct pretty_print_context
72{
73 int abbrev;
74 const char *subject;
75 const char *after_subject;
76 enum date_mode date_mode;
77 int need_8bit_cte;
Junio C Hamano66b2ed02010-01-20 21:59:36[diff] [blame]78 int show_notes;
Thomas Rast8f8f5472009-10-19 15:48:10[diff] [blame]79 struct reflog_walk_info *reflog_info;
Pat Notz177b29d2010-11-02 19:59:08[diff] [blame]80 const char *output_encoding;
Thomas Rastdd2e7942009-10-19 15:48:08[diff] [blame]81};
82
Johannes Gilger5b163602010-04-13 20:31:12[diff] [blame]83struct userformat_want {
84 unsigned notes:1;
85};
86
Johannes Schindelin28e9cf62009-08-10 16:22:18[diff] [blame]87extern int has_non_ascii(const char *text);
Junio C Hamano4da45be2008-04-08 00:11:34[diff] [blame]88struct rev_info; /* in revision.h, it circularly uses enum cmit_fmt */
Pat Notz177b29d2010-11-02 19:59:08[diff] [blame]89extern char *logmsg_reencode(const struct commit *commit,
90 const char *output_encoding);
Alexander Gavrilov69cd8f62008-10-21 20:55:57[diff] [blame]91extern char *reencode_commit_message(const struct commit *commit,
92 const char **encoding_p);
Junio C Hamano4da45be2008-04-08 00:11:34[diff] [blame]93extern void get_commit_format(const char *arg, struct rev_info *);
Johannes Gilger5b163602010-04-13 20:31:12[diff] [blame]94extern void userformat_find_requirements(const char *fmt, struct userformat_want *w);
Pierre Habouzit674d1722007-09-10 10:35:06[diff] [blame]95extern void format_commit_message(const struct commit *commit,
Junio C Hamano7f98ebc2009-10-16 05:59:41[diff] [blame]96 const char *format, struct strbuf *sb,
Thomas Rastdd2e7942009-10-19 15:48:08[diff] [blame]97 const struct pretty_print_context *context);
98extern void pretty_print_commit(enum cmit_fmt fmt, const struct commit *commit,
99 struct strbuf *sb,
100 const struct pretty_print_context *context);
Daniel Barkalowb02bd652008-02-19 03:56:08[diff] [blame]101void pp_user_info(const char *what, enum cmit_fmt fmt, struct strbuf *sb,
102 const char *line, enum date_mode dmode,
103 const char *encoding);
104void pp_title_line(enum cmit_fmt fmt,
105 const char **msg_p,
106 struct strbuf *sb,
107 const char *subject,
108 const char *after_subject,
109 const char *encoding,
Junio C Hamano267123b2008-03-15 07:09:20[diff] [blame]110 int need_8bit_cte);
Daniel Barkalowb02bd652008-02-19 03:56:08[diff] [blame]111void pp_remainder(enum cmit_fmt fmt,
112 const char **msg_p,
113 struct strbuf *sb,
114 int indent);
115
Linus Torvaldse3bc7a32005-06-01 15:34:23[diff] [blame]116
Daniel Barkalowdd97f852005-04-24 01:47:23[diff] [blame]117/** Removes the first commit from a list sorted by date, and adds all
118 * of its parents.
119 **/
Junio C Hamanoa6080a02007-06-07 07:04:01[diff] [blame]120struct commit *pop_most_recent_commit(struct commit_list **list,
Daniel Barkalow58e28af2005-04-24 03:29:22[diff] [blame]121 unsigned int mark);
Daniel Barkalowdd97f852005-04-24 01:47:23[diff] [blame]122
jon@blackcubes.dyndns.orga3437b82005-06-06 15:39:40[diff] [blame]123struct commit *pop_commit(struct commit_list **stack);
124
Junio C Hamanof8f9c732006-01-08 02:52:42[diff] [blame]125void clear_commit_marks(struct commit *commit, unsigned int mark);
126
Jon Seymourab580ac2005-07-06 16:39:34[diff] [blame]127/*
128 * Performs an in-place topological sort of list supplied.
129 *
Jon Seymourab580ac2005-07-06 16:39:34[diff] [blame]130 * invariant of resulting list is:
131 * a reachable from b => ord(b) < ord(a)
Junio C Hamano4c8725f2006-02-16 06:05:33[diff] [blame]132 * in addition, when lifo == 0, commits on parallel tracks are
133 * sorted in the dates order.
Jon Seymourab580ac2005-07-06 16:39:34[diff] [blame]134 */
Junio C Hamano4c8725f2006-02-16 06:05:33[diff] [blame]135void sort_in_topological_order(struct commit_list ** list, int lifo);
Junio C Hamano5040f172006-04-07 06:58:51[diff] [blame]136
137struct commit_graft {
138 unsigned char sha1[20];
Johannes Schindelined09aef2006-10-30 19:09:06[diff] [blame]139 int nr_parent; /* < 0 if shallow commit */
Junio C Hamano5040f172006-04-07 06:58:51[diff] [blame]140 unsigned char parent[FLEX_ARRAY][20]; /* more */
141};
142
143struct commit_graft *read_graft_line(char *buf, int len);
144int register_commit_graft(struct commit_graft *, int);
Martin Koegler45163382008-02-25 21:46:07[diff] [blame]145struct commit_graft *lookup_commit_graft(const unsigned char *sha1);
Junio C Hamano5040f172006-04-07 06:58:51[diff] [blame]146
Christian Couder68095572009-01-23 09:06:53[diff] [blame]147const unsigned char *lookup_replace_object(const unsigned char *sha1);
148
Rene Scharfec0fa8252006-07-02 09:49:38[diff] [blame]149extern struct commit_list *get_merge_bases(struct commit *rev1, struct commit *rev2, int cleanup);
Christian Couder53eda892008-07-30 05:04:14[diff] [blame]150extern struct commit_list *get_merge_bases_many(struct commit *one, int n, struct commit **twos, int cleanup);
Miklos Vajna5240c9d2008-06-27 16:22:00[diff] [blame]151extern struct commit_list *get_octopus_merge_bases(struct commit_list *in);
Johannes Schindelin7c6f8aa2006-06-29 13:17:32[diff] [blame]152
Johannes Schindelined09aef2006-10-30 19:09:06[diff] [blame]153extern int register_shallow(const unsigned char *sha1);
Johannes Schindelinf53514b2006-10-30 19:09:53[diff] [blame]154extern int unregister_shallow(const unsigned char *sha1);
Shawn O. Pearceedace6f2009-10-31 00:47:23[diff] [blame]155extern int write_shallow_commits(struct strbuf *out, int use_pack_protocol);
Junio C Hamanof43117a2007-01-22 06:22:23[diff] [blame]156extern int is_repository_shallow(void);
Johannes Schindelined09aef2006-10-30 19:09:06[diff] [blame]157extern struct commit_list *get_shallow_commits(struct object_array *heads,
Johannes Schindelinf53514b2006-10-30 19:09:53[diff] [blame]158 int depth, int shallow_flag, int not_shallow_flag);
Johannes Schindelined09aef2006-10-30 19:09:06[diff] [blame]159
Jake Goulding7fcdb362009-01-26 14:13:24[diff] [blame]160int is_descendant_of(struct commit *, struct commit_list *);
Junio C Hamano03840fc2007-01-09 07:22:31[diff] [blame]161int in_merge_bases(struct commit *, struct commit **, int);
Kristian Høgsberg58680162007-09-18 00:06:44[diff] [blame]162
Junio C Hamano3f061882007-11-25 18:10:10[diff] [blame]163extern int interactive_add(int argc, const char **argv, const char *prefix);
Thomas Rast46b51392009-08-13 12:29:41[diff] [blame]164extern int run_add_interactive(const char *revision, const char *patch_mode,
165 const char **pathspec);
Kristian Høgsberg58680162007-09-18 00:06:44[diff] [blame]166
Linus Torvalds53b2c822007-11-05 21:22:34[diff] [blame]167static inline int single_parent(struct commit *commit)
168{
169 return commit->parents && !commit->parents->next;
170}
171
Junio C Hamano98cf9c32008-06-27 16:22:03[diff] [blame]172struct commit_list *reduce_heads(struct commit_list *heads);
173
Jeff King40d52ff2010-04-02 00:05:23[diff] [blame]174extern int commit_tree(const char *msg, unsigned char *tree,
175 struct commit_list *parents, unsigned char *ret,
176 const char *author);
177
Daniel Barkalow6eb8ae02005-04-18 18:39:48[diff] [blame]178#endif /* COMMIT_H */