🌐 AI搜索 & 代理 主页
Google Git
Sign in
chromium / external / github.com / git / git / refs/tags/v1.6.4-rc1 / . / commit.h
blob: ba9f63813eba004ae409eba8741266a074161239 [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;
31 char name[1];
32};
33
Jason McMullan5d6ccf52005-06-03 15:05:39[diff] [blame]34struct commit *lookup_commit(const unsigned char *sha1);
35struct commit *lookup_commit_reference(const unsigned char *sha1);
Junio C Hamanof76412e2005-08-21 09:51:10[diff] [blame]36struct commit *lookup_commit_reference_gently(const unsigned char *sha1,
37 int quiet);
Daniel Barkalow6eb8ae02005-04-18 18:39:48[diff] [blame]38
Nicolas Pitrebd2c39f2005-05-06 17:48:34[diff] [blame]39int parse_commit_buffer(struct commit *item, void *buffer, unsigned long size);
40
Daniel Barkalow6eb8ae02005-04-18 18:39:48[diff] [blame]41int parse_commit(struct commit *item);
42
Linus Torvaldsac5155e2005-05-31 01:44:02[diff] [blame]43struct commit_list * commit_list_insert(struct commit *item, struct commit_list **list_p);
Miklos Vajna65319472008-06-27 16:21:55[diff] [blame]44unsigned commit_list_count(const struct commit_list *l);
Linus Torvaldsf7554942005-07-06 16:31:17[diff] [blame]45struct commit_list * insert_by_date(struct commit *item, struct commit_list **list);
Daniel Barkalowdd97f852005-04-24 01:47:23[diff] [blame]46
Daniel Barkalow6eb8ae02005-04-18 18:39:48[diff] [blame]47void free_commit_list(struct commit_list *list);
48
Daniel Barkalowdd97f852005-04-24 01:47:23[diff] [blame]49void sort_by_date(struct commit_list **list);
50
Linus Torvalds000182e2005-06-05 16:02:03[diff] [blame]51/* Commit formats */
52enum cmit_fmt {
53 CMIT_FMT_RAW,
54 CMIT_FMT_MEDIUM,
55 CMIT_FMT_DEFAULT = CMIT_FMT_MEDIUM,
Linus Torvalds9b66ec02005-06-27 00:50:46[diff] [blame]56 CMIT_FMT_SHORT,
57 CMIT_FMT_FULL,
Junio C Hamanoff56fe12005-11-10 06:15:27[diff] [blame]58 CMIT_FMT_FULLER,
Junio C Hamanod87449c2005-08-09 05:15:40[diff] [blame]59 CMIT_FMT_ONELINE,
Junio C Hamano3eefc182006-04-18 23:45:27[diff] [blame]60 CMIT_FMT_EMAIL,
Johannes Schindeline52a5de2007-02-23 00:35:03[diff] [blame]61 CMIT_FMT_USERFORMAT,
Junio C Hamano6b9c58f2006-04-16 06:46:36[diff] [blame]62
63 CMIT_FMT_UNSPECIFIED,
Linus Torvalds000182e2005-06-05 16:02:03[diff] [blame]64};
65
Junio C Hamano4593fb82007-10-31 21:55:17[diff] [blame]66extern int non_ascii(int);
Junio C Hamano4da45be2008-04-08 00:11:34[diff] [blame]67struct rev_info; /* in revision.h, it circularly uses enum cmit_fmt */
Alexander Gavrilov69cd8f62008-10-21 20:55:57[diff] [blame]68extern char *reencode_commit_message(const struct commit *commit,
69 const char **encoding_p);
Junio C Hamano4da45be2008-04-08 00:11:34[diff] [blame]70extern void get_commit_format(const char *arg, struct rev_info *);
Pierre Habouzit674d1722007-09-10 10:35:06[diff] [blame]71extern void format_commit_message(const struct commit *commit,
Jeff Kingd36f8672008-08-29 00:54:59[diff] [blame]72 const void *format, struct strbuf *sb,
73 enum date_mode dmode);
Pierre Habouzit674d1722007-09-10 10:35:06[diff] [blame]74extern void pretty_print_commit(enum cmit_fmt fmt, const struct commit*,
75 struct strbuf *,
76 int abbrev, const char *subject,
Junio C Hamano4593fb82007-10-31 21:55:17[diff] [blame]77 const char *after_subject, enum date_mode,
Junio C Hamano6bf4f1b2008-03-15 00:10:09[diff] [blame]78 int need_8bit_cte);
Daniel Barkalowb02bd652008-02-19 03:56:08[diff] [blame]79void pp_user_info(const char *what, enum cmit_fmt fmt, struct strbuf *sb,
80 const char *line, enum date_mode dmode,
81 const char *encoding);
82void pp_title_line(enum cmit_fmt fmt,
83 const char **msg_p,
84 struct strbuf *sb,
85 const char *subject,
86 const char *after_subject,
87 const char *encoding,
Junio C Hamano267123b2008-03-15 07:09:20[diff] [blame]88 int need_8bit_cte);
Daniel Barkalowb02bd652008-02-19 03:56:08[diff] [blame]89void pp_remainder(enum cmit_fmt fmt,
90 const char **msg_p,
91 struct strbuf *sb,
92 int indent);
93
Linus Torvaldse3bc7a32005-06-01 15:34:23[diff] [blame]94
Daniel Barkalowdd97f852005-04-24 01:47:23[diff] [blame]95/** Removes the first commit from a list sorted by date, and adds all
96 * of its parents.
97 **/
Junio C Hamanoa6080a02007-06-07 07:04:01[diff] [blame]98struct commit *pop_most_recent_commit(struct commit_list **list,
Daniel Barkalow58e28af2005-04-24 03:29:22[diff] [blame]99 unsigned int mark);
Daniel Barkalowdd97f852005-04-24 01:47:23[diff] [blame]100
jon@blackcubes.dyndns.orga3437b82005-06-06 15:39:40[diff] [blame]101struct commit *pop_commit(struct commit_list **stack);
102
Junio C Hamanof8f9c732006-01-08 02:52:42[diff] [blame]103void clear_commit_marks(struct commit *commit, unsigned int mark);
104
Jon Seymourab580ac2005-07-06 16:39:34[diff] [blame]105/*
106 * Performs an in-place topological sort of list supplied.
107 *
Jon Seymourab580ac2005-07-06 16:39:34[diff] [blame]108 * invariant of resulting list is:
109 * a reachable from b => ord(b) < ord(a)
Junio C Hamano4c8725f2006-02-16 06:05:33[diff] [blame]110 * in addition, when lifo == 0, commits on parallel tracks are
111 * sorted in the dates order.
Jon Seymourab580ac2005-07-06 16:39:34[diff] [blame]112 */
Junio C Hamano4c8725f2006-02-16 06:05:33[diff] [blame]113void sort_in_topological_order(struct commit_list ** list, int lifo);
Junio C Hamano5040f172006-04-07 06:58:51[diff] [blame]114
115struct commit_graft {
116 unsigned char sha1[20];
Johannes Schindelined09aef2006-10-30 19:09:06[diff] [blame]117 int nr_parent; /* < 0 if shallow commit */
Junio C Hamano5040f172006-04-07 06:58:51[diff] [blame]118 unsigned char parent[FLEX_ARRAY][20]; /* more */
119};
120
121struct commit_graft *read_graft_line(char *buf, int len);
122int register_commit_graft(struct commit_graft *, int);
Martin Koegler45163382008-02-25 21:46:07[diff] [blame]123struct commit_graft *lookup_commit_graft(const unsigned char *sha1);
Junio C Hamano5040f172006-04-07 06:58:51[diff] [blame]124
Rene Scharfec0fa8252006-07-02 09:49:38[diff] [blame]125extern struct commit_list *get_merge_bases(struct commit *rev1, struct commit *rev2, int cleanup);
Christian Couder53eda892008-07-30 05:04:14[diff] [blame]126extern 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]127extern struct commit_list *get_octopus_merge_bases(struct commit_list *in);
Johannes Schindelin7c6f8aa2006-06-29 13:17:32[diff] [blame]128
Johannes Schindelined09aef2006-10-30 19:09:06[diff] [blame]129extern int register_shallow(const unsigned char *sha1);
Johannes Schindelinf53514b2006-10-30 19:09:53[diff] [blame]130extern int unregister_shallow(const unsigned char *sha1);
Johannes Schindelined09aef2006-10-30 19:09:06[diff] [blame]131extern int write_shallow_commits(int fd, int use_pack_protocol);
Junio C Hamanof43117a2007-01-22 06:22:23[diff] [blame]132extern int is_repository_shallow(void);
Johannes Schindelined09aef2006-10-30 19:09:06[diff] [blame]133extern struct commit_list *get_shallow_commits(struct object_array *heads,
Johannes Schindelinf53514b2006-10-30 19:09:53[diff] [blame]134 int depth, int shallow_flag, int not_shallow_flag);
Johannes Schindelined09aef2006-10-30 19:09:06[diff] [blame]135
Jake Goulding7fcdb362009-01-26 14:13:24[diff] [blame]136int is_descendant_of(struct commit *, struct commit_list *);
Junio C Hamano03840fc2007-01-09 07:22:31[diff] [blame]137int in_merge_bases(struct commit *, struct commit **, int);
Kristian Høgsberg58680162007-09-18 00:06:44[diff] [blame]138
Junio C Hamano3f061882007-11-25 18:10:10[diff] [blame]139extern int interactive_add(int argc, const char **argv, const char *prefix);
Kristian Høgsberg58680162007-09-18 00:06:44[diff] [blame]140
Linus Torvalds53b2c822007-11-05 21:22:34[diff] [blame]141static inline int single_parent(struct commit *commit)
142{
143 return commit->parents && !commit->parents->next;
144}
145
Junio C Hamano98cf9c32008-06-27 16:22:03[diff] [blame]146struct commit_list *reduce_heads(struct commit_list *heads);
147
Daniel Barkalow6eb8ae02005-04-18 18:39:48[diff] [blame]148#endif /* COMMIT_H */