5 #include "string-list.h"
14 CMIT_FMT_DEFAULT = CMIT_FMT_MEDIUM,
26 struct pretty_print_describe_status {
27 unsigned int max_invocations;
30 struct pretty_print_context {
32 * Callers should tweak these to change the behavior of pp_* functions.
36 const char *after_subject;
38 struct date_mode date_mode;
39 unsigned date_mode_explicit:1;
40 int print_email_subject;
41 int expand_tabs_in_log;
44 struct reflog_walk_info *reflog_info;
46 const char *output_encoding;
47 struct string_list *mailmap;
49 struct ident_split *from_ident;
50 unsigned encode_email_headers:1;
51 struct pretty_print_describe_status *describe_status;
54 * Fields below here are manipulated internally by pp_* functions and
55 * should not be counted on by callers.
57 struct string_list in_body_headers;
61 /* Check whether commit format is mail. */
62 static inline int cmit_fmt_is_mail(enum cmit_fmt fmt)
64 return (fmt == CMIT_FMT_EMAIL || fmt == CMIT_FMT_MBOXRD);
67 struct userformat_want {
72 /* Set the flag "w->notes" if there is placeholder %N in "fmt". */
73 void userformat_find_requirements(const char *fmt, struct userformat_want *w);
76 * Shortcut for invoking pretty_print_commit if we do not have any context.
77 * Context would be set empty except "fmt".
79 void pp_commit_easy(enum cmit_fmt fmt, const struct commit *commit,
83 * Get information about user and date from "line", format it and
85 * Format of "line" must be readable for split_ident_line function.
86 * The resulting format is "what: name <email> date".
88 void pp_user_info(struct pretty_print_context *pp, const char *what,
89 struct strbuf *sb, const char *line,
90 const char *encoding);
93 * Format title line of commit message taken from "msg_p" and
95 * First line of "msg_p" is also affected.
97 void pp_title_line(struct pretty_print_context *pp, const char **msg_p,
98 struct strbuf *sb, const char *encoding,
102 * Get current state of commit message from "msg_p" and continue formatting
103 * by adding indentation and '>' signs. Put result into "sb".
105 void pp_remainder(struct pretty_print_context *pp, const char **msg_p,
106 struct strbuf *sb, int indent);
109 * Create a text message about commit using given "format" and "context".
110 * Put the result to "sb".
111 * Please use this function for custom formats.
113 void repo_format_commit_message(struct repository *r,
114 const struct commit *commit,
115 const char *format, struct strbuf *sb,
116 const struct pretty_print_context *context);
117 #ifndef NO_THE_REPOSITORY_COMPATIBILITY_MACROS
118 #define format_commit_message(c, f, s, con) \
119 repo_format_commit_message(the_repository, c, f, s, con)
123 * Parse given arguments from "arg", check it for correctness and
124 * fill struct rev_info.
126 void get_commit_format(const char *arg, struct rev_info *);
129 * Make a commit message with all rules from given "pp"
130 * and put it into "sb".
131 * Please use this function if you have a context (candidate for "pp").
133 void pretty_print_commit(struct pretty_print_context *pp,
134 const struct commit *commit,
138 * Change line breaks in "msg" to "line_separator" and put it into "sb".
139 * Return "msg" itself.
141 const char *format_subject(struct strbuf *sb, const char *msg,
142 const char *line_separator);
144 /* Check if "cmit_fmt" will produce an empty output. */
145 int commit_format_is_empty(enum cmit_fmt);
147 /* Make subject of commit message suitable for filename */
148 void format_sanitized_subject(struct strbuf *sb, const char *msg, size_t len);
150 #endif /* PRETTY_H */