builtin-log.c 31.7 KB
Newer Older
1 2 3 4 5 6 7
/*
 * Builtin "git log" and related commands (show, whatchanged)
 *
 * (C) Copyright 2006 Linus Torvalds
 *		 2006 Junio Hamano
 */
#include "cache.h"
8
#include "color.h"
9 10 11 12
#include "commit.h"
#include "diff.h"
#include "revision.h"
#include "log-tree.h"
13
#include "builtin.h"
14
#include "tag.h"
L
Linus Torvalds 已提交
15
#include "reflog-walk.h"
16
#include "patch-ids.h"
17
#include "run-command.h"
18
#include "shortlog.h"
19
#include "remote.h"
20
#include "string-list.h"
21

H
Heikki Orsila 已提交
22 23 24
/* Set a default date-time format for git log ("log.date" config variable) */
static const char *default_date_mode = NULL;

25
static int default_show_root = 1;
26
static const char *fmt_patch_subject_prefix = "PATCH";
27
static const char *fmt_pretty;
28

29
static void cmd_log_init(int argc, const char **argv, const char *prefix,
30 31
		      struct rev_info *rev)
{
J
Junio C Hamano 已提交
32 33
	int i;

34 35
	rev->abbrev = DEFAULT_ABBREV;
	rev->commit_format = CMIT_FMT_DEFAULT;
36
	if (fmt_pretty)
37
		get_commit_format(fmt_pretty, rev);
38
	rev->verbose_header = 1;
39
	DIFF_OPT_SET(&rev->diffopt, RECURSIVE);
40
	rev->show_root_diff = default_show_root;
41
	rev->subject_prefix = fmt_patch_subject_prefix;
J
Jeff King 已提交
42
	DIFF_OPT_SET(&rev->diffopt, ALLOW_TEXTCONV);
H
Heikki Orsila 已提交
43 44 45 46

	if (default_date_mode)
		rev->date_mode = parse_date_format(default_date_mode);

47
	argc = setup_revisions(argc, argv, rev, "HEAD");
H
Heikki Orsila 已提交
48

49 50
	if (rev->diffopt.pickaxe || rev->diffopt.filter)
		rev->always_show_header = 0;
51
	if (DIFF_OPT_TST(&rev->diffopt, FOLLOW_RENAMES)) {
52 53 54 55
		rev->always_show_header = 0;
		if (rev->diffopt.nr_paths != 1)
			usage("git logs can only follow renames on one pathname at a time");
	}
J
Junio C Hamano 已提交
56 57
	for (i = 1; i < argc; i++) {
		const char *arg = argv[i];
58
		if (!strcmp(arg, "--decorate")) {
R
René Scharfe 已提交
59
			load_ref_decorations();
60
			rev->show_decorations = 1;
61 62
		} else if (!strcmp(arg, "--source")) {
			rev->show_source = 1;
63
		} else
J
Junio C Hamano 已提交
64 65
			die("unrecognized argument: %s", arg);
	}
66 67
}

L
Linus Torvalds 已提交
68 69 70 71 72 73 74 75 76 77 78 79
/*
 * This gives a rough estimate for how many commits we
 * will print out in the list.
 */
static int estimate_commit_count(struct rev_info *rev, struct commit_list *list)
{
	int n = 0;

	while (list) {
		struct commit *commit = list->item;
		unsigned int flags = commit->object.flags;
		list = list->next;
80
		if (!(flags & (TREESAME | UNINTERESTING)))
L
Linus Torvalds 已提交
81
			n++;
L
Linus Torvalds 已提交
82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97
	}
	return n;
}

static void show_early_header(struct rev_info *rev, const char *stage, int nr)
{
	if (rev->shown_one) {
		rev->shown_one = 0;
		if (rev->commit_format != CMIT_FMT_ONELINE)
			putchar(rev->diffopt.line_termination);
	}
	printf("Final output: %d %s\n", nr, stage);
}

struct itimerval early_output_timer;

98 99 100
static void log_show_early(struct rev_info *revs, struct commit_list *list)
{
	int i = revs->early_output;
L
Linus Torvalds 已提交
101
	int show_header = 1;
102 103 104 105

	sort_in_topological_order(&list, revs->lifo);
	while (list && i) {
		struct commit *commit = list->item;
L
Linus Torvalds 已提交
106 107 108 109 110 111 112 113 114 115 116 117 118 119 120
		switch (simplify_commit(revs, commit)) {
		case commit_show:
			if (show_header) {
				int n = estimate_commit_count(revs, list);
				show_early_header(revs, "incomplete", n);
				show_header = 0;
			}
			log_tree_commit(revs, commit);
			i--;
			break;
		case commit_ignore:
			break;
		case commit_error:
			return;
		}
121 122
		list = list->next;
	}
L
Linus Torvalds 已提交
123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140

	/* Did we already get enough commits for the early output? */
	if (!i)
		return;

	/*
	 * ..if no, then repeat it twice a second until we
	 * do.
	 *
	 * NOTE! We don't use "it_interval", because if the
	 * reader isn't listening, we want our output to be
	 * throttled by the writing, and not have the timer
	 * trigger every second even if we're blocked on a
	 * reader!
	 */
	early_output_timer.it_value.tv_sec = 0;
	early_output_timer.it_value.tv_usec = 500000;
	setitimer(ITIMER_REAL, &early_output_timer, NULL);
141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171
}

static void early_output(int signal)
{
	show_early_output = log_show_early;
}

static void setup_early_output(struct rev_info *rev)
{
	struct sigaction sa;

	/*
	 * Set up the signal handler, minimally intrusively:
	 * we only set a single volatile integer word (not
	 * using sigatomic_t - trying to avoid unnecessary
	 * system dependencies and headers), and using
	 * SA_RESTART.
	 */
	memset(&sa, 0, sizeof(sa));
	sa.sa_handler = early_output;
	sigemptyset(&sa.sa_mask);
	sa.sa_flags = SA_RESTART;
	sigaction(SIGALRM, &sa, NULL);

	/*
	 * If we can get the whole output in less than a
	 * tenth of a second, don't even bother doing the
	 * early-output thing..
	 *
	 * This is a one-time-only trigger.
	 */
L
Linus Torvalds 已提交
172 173 174
	early_output_timer.it_value.tv_sec = 0;
	early_output_timer.it_value.tv_usec = 100000;
	setitimer(ITIMER_REAL, &early_output_timer, NULL);
175 176 177 178
}

static void finish_early_output(struct rev_info *rev)
{
L
Linus Torvalds 已提交
179
	int n = estimate_commit_count(rev, rev->commits);
180
	signal(SIGALRM, SIG_IGN);
L
Linus Torvalds 已提交
181
	show_early_header(rev, "done", n);
182 183
}

184 185 186
static int cmd_log_walk(struct rev_info *rev)
{
	struct commit *commit;
187

188 189 190
	if (rev->early_output)
		setup_early_output(rev);

191 192
	if (prepare_revision_walk(rev))
		die("revision walk setup failed");
193 194 195 196

	if (rev->early_output)
		finish_early_output(rev);

197
	/*
198 199 200
	 * For --check and --exit-code, the exit code is based on CHECK_FAILED
	 * and HAS_CHANGES being accumulated in rev->diffopt, so be careful to
	 * retain that state information if replacing rev->diffopt in this loop
201
	 */
202 203
	while ((commit = get_revision(rev)) != NULL) {
		log_tree_commit(rev, commit);
204 205 206 207 208
		if (!rev->reflog_info) {
			/* we allow cycles in reflog ancestry */
			free(commit->buffer);
			commit->buffer = NULL;
		}
L
Linus Torvalds 已提交
209 210
		free_commit_list(commit->parents);
		commit->parents = NULL;
211
	}
212 213 214 215
	if (rev->diffopt.output_format & DIFF_FORMAT_CHECKDIFF &&
	    DIFF_OPT_TST(&rev->diffopt, CHECK_FAILED)) {
		return 02;
	}
216
	return diff_result_code(&rev->diffopt, 0);
217 218
}

219
static int git_log_config(const char *var, const char *value, void *cb)
220
{
221 222
	if (!strcmp(var, "format.pretty"))
		return git_config_string(&fmt_pretty, var, value);
223 224
	if (!strcmp(var, "format.subjectprefix"))
		return git_config_string(&fmt_patch_subject_prefix, var, value);
H
Heikki Orsila 已提交
225 226
	if (!strcmp(var, "log.date"))
		return git_config_string(&default_date_mode, var, value);
227 228 229 230
	if (!strcmp(var, "log.showroot")) {
		default_show_root = git_config_bool(var, value);
		return 0;
	}
231
	return git_diff_ui_config(var, value, cb);
232 233
}

234
int cmd_whatchanged(int argc, const char **argv, const char *prefix)
235 236 237
{
	struct rev_info rev;

238
	git_config(git_log_config, NULL);
239 240 241 242

	if (diff_use_color_default == -1)
		diff_use_color_default = git_use_color_default;

243
	init_revisions(&rev, prefix);
244
	rev.diff = 1;
L
Linus Torvalds 已提交
245
	rev.simplify_history = 0;
246
	cmd_log_init(argc, argv, prefix, &rev);
247 248 249
	if (!rev.diffopt.output_format)
		rev.diffopt.output_format = DIFF_FORMAT_RAW;
	return cmd_log_walk(&rev);
250 251
}

252 253
static void show_tagger(char *buf, int len, struct rev_info *rev)
{
254
	struct strbuf out = STRBUF_INIT;
255

256 257 258 259 260
	pp_user_info("Tagger", rev->commit_format, &out, buf, rev->date_mode,
		git_log_output_encoding ?
		git_log_output_encoding: git_commit_encoding);
	printf("%s\n", out.buf);
	strbuf_release(&out);
261 262 263 264
}

static int show_object(const unsigned char *sha1, int show_tag_object,
	struct rev_info *rev)
265 266
{
	unsigned long size;
267 268
	enum object_type type;
	char *buf = read_sha1_file(sha1, &type, &size);
269 270 271 272 273
	int offset = 0;

	if (!buf)
		return error("Could not read object %s", sha1_to_hex(sha1));

274 275 276
	if (show_tag_object)
		while (offset < size && buf[offset] != '\n') {
			int new_offset = offset + 1;
277 278
			while (new_offset < size && buf[new_offset++] != '\n')
				; /* do nothing */
279 280 281
			if (!prefixcmp(buf + offset, "tagger "))
				show_tagger(buf + offset + 7,
					    new_offset - offset - 7, rev);
282 283 284 285 286 287 288 289 290 291 292
			offset = new_offset;
		}

	if (offset < size)
		fwrite(buf + offset, size - offset, 1, stdout);
	free(buf);
	return 0;
}

static int show_tree_object(const unsigned char *sha1,
		const char *base, int baselen,
293
		const char *pathname, unsigned mode, int stage, void *context)
294 295 296 297 298
{
	printf("%s%s\n", pathname, S_ISDIR(mode) ? "/" : "");
	return 0;
}

299
int cmd_show(int argc, const char **argv, const char *prefix)
300 301
{
	struct rev_info rev;
302 303
	struct object_array_entry *objects;
	int i, count, ret = 0;
304

305
	git_config(git_log_config, NULL);
306 307 308 309

	if (diff_use_color_default == -1)
		diff_use_color_default = git_use_color_default;

310
	init_revisions(&rev, prefix);
311 312 313 314 315 316
	rev.diff = 1;
	rev.combine_merges = 1;
	rev.dense_combined_merges = 1;
	rev.always_show_header = 1;
	rev.ignore_merges = 0;
	rev.no_walk = 1;
317
	cmd_log_init(argc, argv, prefix, &rev);
318 319 320 321 322 323 324 325

	count = rev.pending.nr;
	objects = rev.pending.objects;
	for (i = 0; i < count && !ret; i++) {
		struct object *o = objects[i].item;
		const char *name = objects[i].name;
		switch (o->type) {
		case OBJ_BLOB:
326
			ret = show_object(o->sha1, 0, NULL);
327 328 329 330
			break;
		case OBJ_TAG: {
			struct tag *t = (struct tag *)o;

331
			printf("%stag %s%s\n",
332
					diff_get_color_opt(&rev.diffopt, DIFF_COMMIT),
333
					t->tag,
334
					diff_get_color_opt(&rev.diffopt, DIFF_RESET));
335
			ret = show_object(o->sha1, 1, &rev);
336 337 338 339 340 341 342
			if (ret)
				break;
			o = parse_object(t->tagged->sha1);
			if (!o)
				ret = error("Could not read object %s",
					    sha1_to_hex(t->tagged->sha1));
			objects[i].item = o;
343 344 345 346 347
			i--;
			break;
		}
		case OBJ_TREE:
			printf("%stree %s%s\n\n",
348
					diff_get_color_opt(&rev.diffopt, DIFF_COMMIT),
349
					name,
350
					diff_get_color_opt(&rev.diffopt, DIFF_RESET));
351
			read_tree_recursive((struct tree *)o, "", 0, 0, NULL,
352
					show_tree_object, NULL);
353 354 355 356 357 358 359 360 361 362 363 364 365
			break;
		case OBJ_COMMIT:
			rev.pending.nr = rev.pending.alloc = 0;
			rev.pending.objects = NULL;
			add_object_array(o, name, &rev.pending);
			ret = cmd_log_walk(&rev);
			break;
		default:
			ret = error("Unknown type: %d", o->type);
		}
	}
	free(objects);
	return ret;
366 367
}

L
Linus Torvalds 已提交
368 369 370 371 372 373 374
/*
 * This is equivalent to "git log -g --abbrev-commit --pretty=oneline"
 */
int cmd_log_reflog(int argc, const char **argv, const char *prefix)
{
	struct rev_info rev;

375
	git_config(git_log_config, NULL);
376 377 378 379

	if (diff_use_color_default == -1)
		diff_use_color_default = git_use_color_default;

L
Linus Torvalds 已提交
380 381 382 383 384 385 386 387 388 389 390 391
	init_revisions(&rev, prefix);
	init_reflog_walk(&rev.reflog_info);
	rev.abbrev_commit = 1;
	rev.verbose_header = 1;
	cmd_log_init(argc, argv, prefix, &rev);

	/*
	 * This means that we override whatever commit format the user gave
	 * on the cmd line.  Sad, but cmd_log_init() currently doesn't
	 * allow us to set a different default.
	 */
	rev.commit_format = CMIT_FMT_ONELINE;
392
	rev.use_terminator = 1;
L
Linus Torvalds 已提交
393 394 395 396 397 398 399 400 401 402 403
	rev.always_show_header = 1;

	/*
	 * We get called through "git reflog", so unlike the other log
	 * routines, we need to set up our pager manually..
	 */
	setup_pager();

	return cmd_log_walk(&rev);
}

404
int cmd_log(int argc, const char **argv, const char *prefix)
405 406 407
{
	struct rev_info rev;

408
	git_config(git_log_config, NULL);
409 410 411 412

	if (diff_use_color_default == -1)
		diff_use_color_default = git_use_color_default;

413
	init_revisions(&rev, prefix);
414
	rev.always_show_header = 1;
415
	cmd_log_init(argc, argv, prefix, &rev);
416
	return cmd_log_walk(&rev);
417
}
418

419 420 421
/* format-patch */
#define FORMAT_PATCH_NAME_MAX 64

422 423 424 425 426 427
static int istitlechar(char c)
{
	return (c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z') ||
		(c >= '0' && c <= '9') || c == '.' || c == '_';
}

428
static const char *fmt_patch_suffix = ".patch";
429
static int numbered = 0;
430
static int auto_number = 1;
431

432 433
static char *default_attach = NULL;

D
Daniel Barkalow 已提交
434 435 436 437 438 439 440 441 442 443 444 445 446 447 448
static char **extra_hdr;
static int extra_hdr_nr;
static int extra_hdr_alloc;

static char **extra_to;
static int extra_to_nr;
static int extra_to_alloc;

static char **extra_cc;
static int extra_cc_nr;
static int extra_cc_alloc;

static void add_header(const char *value)
{
	int len = strlen(value);
449
	while (len && value[len - 1] == '\n')
D
Daniel Barkalow 已提交
450 451 452 453 454 455 456 457 458 459 460 461 462 463 464
		len--;
	if (!strncasecmp(value, "to: ", 4)) {
		ALLOC_GROW(extra_to, extra_to_nr + 1, extra_to_alloc);
		extra_to[extra_to_nr++] = xstrndup(value + 4, len - 4);
		return;
	}
	if (!strncasecmp(value, "cc: ", 4)) {
		ALLOC_GROW(extra_cc, extra_cc_nr + 1, extra_cc_alloc);
		extra_cc[extra_cc_nr++] = xstrndup(value + 4, len - 4);
		return;
	}
	ALLOC_GROW(extra_hdr, extra_hdr_nr + 1, extra_hdr_alloc);
	extra_hdr[extra_hdr_nr++] = xstrndup(value, len);
}

465 466 467 468
#define THREAD_SHALLOW 1
#define THREAD_DEEP 2
static int thread = 0;

469
static int git_format_config(const char *var, const char *value, void *cb)
470 471
{
	if (!strcmp(var, "format.headers")) {
472 473
		if (!value)
			die("format.headers without value");
D
Daniel Barkalow 已提交
474
		add_header(value);
475 476
		return 0;
	}
477 478
	if (!strcmp(var, "format.suffix"))
		return git_config_string(&fmt_patch_suffix, var, value);
479 480 481 482 483 484 485
	if (!strcmp(var, "format.cc")) {
		if (!value)
			return config_error_nonbool(var);
		ALLOC_GROW(extra_cc, extra_cc_nr + 1, extra_cc_alloc);
		extra_cc[extra_cc_nr++] = xstrdup(value);
		return 0;
	}
486
	if (!strcmp(var, "diff.color") || !strcmp(var, "color.diff")) {
487 488
		return 0;
	}
489
	if (!strcmp(var, "format.numbered")) {
490
		if (value && !strcasecmp(value, "auto")) {
491 492 493 494
			auto_number = 1;
			return 0;
		}
		numbered = git_config_bool(var, value);
495
		auto_number = auto_number && numbered;
496 497
		return 0;
	}
498 499 500 501 502 503 504
	if (!strcmp(var, "format.attach")) {
		if (value && *value)
			default_attach = xstrdup(value);
		else
			default_attach = xstrdup(git_version_string);
		return 0;
	}
505 506 507 508 509 510 511 512 513 514 515 516
	if (!strcmp(var, "format.thread")) {
		if (value && !strcasecmp(value, "deep")) {
			thread = THREAD_DEEP;
			return 0;
		}
		if (value && !strcasecmp(value, "shallow")) {
			thread = THREAD_SHALLOW;
			return 0;
		}
		thread = git_config_bool(var, value) && THREAD_SHALLOW;
		return 0;
	}
517

518
	return git_log_config(var, value, cb);
519 520 521
}


522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571
static const char *get_oneline_for_filename(struct commit *commit,
					    int keep_subject)
{
	static char filename[PATH_MAX];
	char *sol;
	int len = 0;
	int suffix_len = strlen(fmt_patch_suffix) + 1;

	sol = strstr(commit->buffer, "\n\n");
	if (!sol)
		filename[0] = '\0';
	else {
		int j, space = 0;

		sol += 2;
		/* strip [PATCH] or [PATCH blabla] */
		if (!keep_subject && !prefixcmp(sol, "[PATCH")) {
			char *eos = strchr(sol + 6, ']');
			if (eos) {
				while (isspace(*eos))
					eos++;
				sol = eos;
			}
		}

		for (j = 0;
		     j < FORMAT_PATCH_NAME_MAX - suffix_len - 5 &&
			     len < sizeof(filename) - suffix_len &&
			     sol[j] && sol[j] != '\n';
		     j++) {
			if (istitlechar(sol[j])) {
				if (space) {
					filename[len++] = '-';
					space = 0;
				}
				filename[len++] = sol[j];
				if (sol[j] == '.')
					while (sol[j + 1] == '.')
						j++;
			} else
				space = 1;
		}
		while (filename[len - 1] == '.'
		       || filename[len - 1] == '-')
			len--;
		filename[len] = '\0';
	}
	return filename;
}

572
static FILE *realstdout = NULL;
573
static const char *output_directory = NULL;
574
static int outdir_offset;
575

N
Nate Case 已提交
576
static int reopen_stdout(const char *oneline, int nr, struct rev_info *rev)
577
{
578
	char filename[PATH_MAX];
579
	int len = 0;
580
	int suffix_len = strlen(fmt_patch_suffix) + 1;
581

582
	if (output_directory) {
583 584 585
		len = snprintf(filename, sizeof(filename), "%s",
				output_directory);
		if (len >=
586 587
		    sizeof(filename) - FORMAT_PATCH_NAME_MAX - suffix_len)
			return error("name of output directory is too long");
588 589 590
		if (filename[len - 1] != '/')
			filename[len++] = '/';
	}
591

592 593 594 595 596 597
	if (!oneline)
		len += sprintf(filename + len, "%d", nr);
	else {
		len += sprintf(filename + len, "%04d-", nr);
		len += snprintf(filename + len, sizeof(filename) - len - 1
				- suffix_len, "%s", oneline);
598
		strcpy(filename + len, fmt_patch_suffix);
599
	}
600

N
Nate Case 已提交
601 602 603
	if (!DIFF_OPT_TST(&rev->diffopt, QUIET))
		fprintf(realstdout, "%s\n", filename + outdir_offset);

604 605 606
	if (freopen(filename, "w", stdout) == NULL)
		return error("Cannot open patch file %s",filename);

607
	return 0;
608 609
}

610
static void get_patch_ids(struct rev_info *rev, struct patch_ids *ids, const char *prefix)
611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627
{
	struct rev_info check_rev;
	struct commit *commit;
	struct object *o1, *o2;
	unsigned flags1, flags2;

	if (rev->pending.nr != 2)
		die("Need exactly one range.");

	o1 = rev->pending.objects[0].item;
	flags1 = o1->flags;
	o2 = rev->pending.objects[1].item;
	flags2 = o2->flags;

	if ((flags1 & UNINTERESTING) == (flags2 & UNINTERESTING))
		die("Not a range.");

628
	init_patch_ids(ids);
629 630

	/* given a range a..b get all patch ids for b..a */
631
	init_revisions(&check_rev, prefix);
632 633 634 635
	o1->flags ^= UNINTERESTING;
	o2->flags ^= UNINTERESTING;
	add_pending_object(&check_rev, o1, "o1");
	add_pending_object(&check_rev, o2, "o2");
636 637
	if (prepare_revision_walk(&check_rev))
		die("revision walk setup failed");
638 639 640 641 642 643

	while ((commit = get_revision(&check_rev)) != NULL) {
		/* ignore merges */
		if (commit->parents && commit->parents->next)
			continue;

644
		add_commit_patch_id(commit, ids);
645 646 647
	}

	/* reset for next revision walk */
648 649 650 651
	clear_commit_marks((struct commit *)o1,
			SEEN | UNINTERESTING | SHOWN | ADDED);
	clear_commit_marks((struct commit *)o2,
			SEEN | UNINTERESTING | SHOWN | ADDED);
652 653 654 655
	o1->flags = flags1;
	o2->flags = flags2;
}

656
static void gen_message_id(struct rev_info *info, char *base)
657
{
658
	const char *committer = git_committer_info(IDENT_WARN_ON_NO_NAME);
659 660
	const char *email_start = strrchr(committer, '<');
	const char *email_end = strrchr(committer, '>');
661
	struct strbuf buf = STRBUF_INIT;
662
	if (!email_start || !email_end || email_start > email_end - 1)
663
		die("Could not extract email from committer identity.");
664 665 666 667
	strbuf_addf(&buf, "%s.%lu.git.%.*s", base,
		    (unsigned long) time(NULL),
		    (int)(email_end - email_start - 1), email_start + 1);
	info->message_id = strbuf_detach(&buf, NULL);
668 669
}

670 671 672 673
static void make_cover_letter(struct rev_info *rev, int use_stdout,
			      int numbered, int numbered_files,
			      struct commit *origin,
			      int nr, struct commit **list, struct commit *head)
674 675
{
	const char *committer;
676
	char *head_sha1;
677 678 679 680
	const char *subject_start = NULL;
	const char *body = "*** SUBJECT HERE ***\n\n*** BLURB HERE ***\n";
	const char *msg;
	const char *extra_headers = rev->extra_headers;
681
	struct shortlog log;
682
	struct strbuf sb = STRBUF_INIT;
683
	int i;
684
	const char *encoding = "utf-8";
685
	struct diff_options opts;
J
Junio C Hamano 已提交
686
	int need_8bit_cte = 0;
687 688 689 690 691

	if (rev->commit_format != CMIT_FMT_EMAIL)
		die("Cover letter needs email format");

	if (!use_stdout && reopen_stdout(numbered_files ?
N
Nate Case 已提交
692
				NULL : "cover-letter", 0, rev))
693 694 695 696
		return;

	head_sha1 = sha1_to_hex(head->object.sha1);

J
Junio C Hamano 已提交
697 698
	log_write_email_headers(rev, head_sha1, &subject_start, &extra_headers,
				&need_8bit_cte);
699 700 701 702 703 704 705

	committer = git_committer_info(0);

	msg = body;
	pp_user_info(NULL, CMIT_FMT_EMAIL, &sb, committer, DATE_RFC2822,
		     encoding);
	pp_title_line(CMIT_FMT_EMAIL, &msg, &sb, subject_start, extra_headers,
J
Junio C Hamano 已提交
706
		      encoding, need_8bit_cte);
707 708 709 710 711
	pp_remainder(CMIT_FMT_EMAIL, &msg, &sb, 0);
	printf("%s\n", sb.buf);

	strbuf_release(&sb);

712
	shortlog_init(&log);
713 714 715 716
	log.wrap_lines = 1;
	log.wrap = 72;
	log.in1 = 2;
	log.in2 = 4;
717 718 719 720 721
	for (i = 0; i < nr; i++)
		shortlog_add_commit(&log, list[i]);

	shortlog_output(&log);

722
	/*
723
	 * We can only do diffstat with a unique reference point
724 725 726 727
	 */
	if (!origin)
		return;

728 729
	memcpy(&opts, &rev->diffopt, sizeof(opts));
	opts.output_format = DIFF_FORMAT_SUMMARY | DIFF_FORMAT_DIFFSTAT;
730

731 732 733 734 735 736 737
	diff_setup_done(&opts);

	diff_tree_sha1(origin->tree->object.sha1,
		       head->tree->object.sha1,
		       "", &opts);
	diffcore_std(&opts);
	diff_flush(&opts);
738 739

	printf("\n");
740 741
}

742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760
static const char *clean_message_id(const char *msg_id)
{
	char ch;
	const char *a, *z, *m;

	m = msg_id;
	while ((ch = *m) && (isspace(ch) || (ch == '<')))
		m++;
	a = m;
	z = NULL;
	while ((ch = *m)) {
		if (!isspace(ch) && (ch != '>'))
			z = m;
		m++;
	}
	if (!z)
		die("insane in-reply-to: %s", msg_id);
	if (++z == m)
		return a;
P
Pierre Habouzit 已提交
761
	return xmemdupz(a, z - a);
762 763
}

764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784
static const char *set_outdir(const char *prefix, const char *output_directory)
{
	if (output_directory && is_absolute_path(output_directory))
		return output_directory;

	if (!prefix || !*prefix) {
		if (output_directory)
			return output_directory;
		/* The user did not explicitly ask for "./" */
		outdir_offset = 2;
		return "./";
	}

	outdir_offset = strlen(prefix);
	if (!output_directory)
		return prefix;

	return xstrdup(prefix_filename(prefix, outdir_offset,
				       output_directory));
}

785
int cmd_format_patch(int argc, const char **argv, const char *prefix)
786 787 788 789
{
	struct commit *commit;
	struct commit **list = NULL;
	struct rev_info rev;
790
	int nr = 0, total, i, j;
791
	int use_stdout = 0;
792
	int start_number = -1;
793
	int keep_subject = 0;
794
	int numbered_files = 0;		/* _just_ numbers */
795
	int subject_prefix = 0;
796
	int ignore_if_in_upstream = 0;
797
	int cover_letter = 0;
798
	int boundary_count = 0;
799
	int no_binary_diff = 0;
800
	struct commit *origin = NULL, *head = NULL;
801
	const char *in_reply_to = NULL;
802
	struct patch_ids ids;
J
Junio C Hamano 已提交
803
	char *add_signoff = NULL;
804
	struct strbuf buf = STRBUF_INIT;
805

806
	git_config(git_format_config, NULL);
807
	init_revisions(&rev, prefix);
808 809 810 811 812
	rev.commit_format = CMIT_FMT_EMAIL;
	rev.verbose_header = 1;
	rev.diff = 1;
	rev.combine_merges = 0;
	rev.ignore_merges = 1;
813
	DIFF_OPT_SET(&rev.diffopt, RECURSIVE);
814

815
	rev.subject_prefix = fmt_patch_subject_prefix;
816

817 818 819 820 821
	if (default_attach) {
		rev.mime_boundary = default_attach;
		rev.no_inline = 1;
	}

822 823
	/*
	 * Parse the arguments before setup_revisions(), or something
824
	 * like "git format-patch -o a123 HEAD^.." may fail; a123 is
825 826 827 828
	 * possibly a valid SHA1.
	 */
	for (i = 1, j = 1; i < argc; i++) {
		if (!strcmp(argv[i], "--stdout"))
829
			use_stdout = 1;
830 831 832
		else if (!strcmp(argv[i], "-n") ||
				!strcmp(argv[i], "--numbered"))
			numbered = 1;
833 834 835 836 837
		else if (!strcmp(argv[i], "-N") ||
				!strcmp(argv[i], "--no-numbered")) {
			numbered = 0;
			auto_number = 0;
		}
838
		else if (!prefixcmp(argv[i], "--start-number="))
839
			start_number = strtol(argv[i] + 15, NULL, 10);
840 841
		else if (!strcmp(argv[i], "--numbered-files"))
			numbered_files = 1;
842 843 844 845 846
		else if (!strcmp(argv[i], "--start-number")) {
			i++;
			if (i == argc)
				die("Need a number for --start-number");
			start_number = strtol(argv[i], NULL, 10);
J
Junio C Hamano 已提交
847
		}
848 849 850 851
		else if (!prefixcmp(argv[i], "--cc=")) {
			ALLOC_GROW(extra_cc, extra_cc_nr + 1, extra_cc_alloc);
			extra_cc[extra_cc_nr++] = xstrdup(argv[i] + 5);
		}
J
Junio C Hamano 已提交
852
		else if (!strcmp(argv[i], "-k") ||
853 854 855
				!strcmp(argv[i], "--keep-subject")) {
			keep_subject = 1;
			rev.total = -1;
J
Junio C Hamano 已提交
856
		}
857 858
		else if (!strcmp(argv[i], "--output-directory") ||
			 !strcmp(argv[i], "-o")) {
859
			i++;
860 861 862 863 864
			if (argc <= i)
				die("Which directory?");
			if (output_directory)
				die("Two output directories?");
			output_directory = argv[i];
865
		}
J
Junio C Hamano 已提交
866 867
		else if (!strcmp(argv[i], "--signoff") ||
			 !strcmp(argv[i], "-s")) {
E
Eric W. Biederman 已提交
868 869
			const char *committer;
			const char *endpos;
870
			committer = git_committer_info(IDENT_ERROR_ON_NO_NAME);
E
Eric W. Biederman 已提交
871
			endpos = strchr(committer, '>');
J
Junio C Hamano 已提交
872
			if (!endpos)
873
				die("bogus committer info %s", committer);
P
Pierre Habouzit 已提交
874
			add_signoff = xmemdupz(committer, endpos - committer + 1);
J
Junio C Hamano 已提交
875
		}
876
		else if (!strcmp(argv[i], "--attach")) {
877
			rev.mime_boundary = git_version_string;
878 879 880 881 882 883
			rev.no_inline = 1;
		}
		else if (!prefixcmp(argv[i], "--attach=")) {
			rev.mime_boundary = argv[i] + 9;
			rev.no_inline = 1;
		}
884 885 886 887
		else if (!strcmp(argv[i], "--no-attach")) {
			rev.mime_boundary = NULL;
			rev.no_inline = 0;
		}
888 889 890 891 892
		else if (!strcmp(argv[i], "--inline")) {
			rev.mime_boundary = git_version_string;
			rev.no_inline = 0;
		}
		else if (!prefixcmp(argv[i], "--inline=")) {
893
			rev.mime_boundary = argv[i] + 9;
894 895
			rev.no_inline = 0;
		}
896 897
		else if (!strcmp(argv[i], "--ignore-if-in-upstream"))
			ignore_if_in_upstream = 1;
898 899 900 901 902 903 904
		else if (!strcmp(argv[i], "--thread")
			|| !strcmp(argv[i], "--thread=shallow"))
			thread = THREAD_SHALLOW;
		else if (!strcmp(argv[i], "--thread=deep"))
			thread = THREAD_DEEP;
		else if (!strcmp(argv[i], "--no-thread"))
			thread = 0;
905
		else if (!prefixcmp(argv[i], "--in-reply-to="))
906 907 908 909 910 911
			in_reply_to = argv[i] + 14;
		else if (!strcmp(argv[i], "--in-reply-to")) {
			i++;
			if (i == argc)
				die("Need a Message-Id for --in-reply-to");
			in_reply_to = argv[i];
912 913 914 915
		} else if (!prefixcmp(argv[i], "--subject-prefix=")) {
			subject_prefix = 1;
			rev.subject_prefix = argv[i] + 17;
		} else if (!prefixcmp(argv[i], "--suffix="))
916
			fmt_patch_suffix = argv[i] + 9;
917 918
		else if (!strcmp(argv[i], "--cover-letter"))
			cover_letter = 1;
919 920
		else if (!strcmp(argv[i], "--no-binary"))
			no_binary_diff = 1;
921 922
		else if (!prefixcmp(argv[i], "--add-header="))
			add_header(argv[i] + 13);
923
		else
924
			argv[j++] = argv[i];
925
	}
926 927
	argc = j;

D
Daniel Barkalow 已提交
928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956
	for (i = 0; i < extra_hdr_nr; i++) {
		strbuf_addstr(&buf, extra_hdr[i]);
		strbuf_addch(&buf, '\n');
	}

	if (extra_to_nr)
		strbuf_addstr(&buf, "To: ");
	for (i = 0; i < extra_to_nr; i++) {
		if (i)
			strbuf_addstr(&buf, "    ");
		strbuf_addstr(&buf, extra_to[i]);
		if (i + 1 < extra_to_nr)
			strbuf_addch(&buf, ',');
		strbuf_addch(&buf, '\n');
	}

	if (extra_cc_nr)
		strbuf_addstr(&buf, "Cc: ");
	for (i = 0; i < extra_cc_nr; i++) {
		if (i)
			strbuf_addstr(&buf, "    ");
		strbuf_addstr(&buf, extra_cc[i]);
		if (i + 1 < extra_cc_nr)
			strbuf_addch(&buf, ',');
		strbuf_addch(&buf, '\n');
	}

	rev.extra_headers = strbuf_detach(&buf, 0);

957
	if (start_number < 0)
958
		start_number = 1;
959
	if (numbered && keep_subject)
960
		die ("-n and -k are mutually exclusive.");
961 962
	if (keep_subject && subject_prefix)
		die ("--subject-prefix and -k are mutually exclusive.");
963

964 965 966
	argc = setup_revisions(argc, argv, &rev, "HEAD");
	if (argc > 1)
		die ("unrecognized argument: %s", argv[1]);
967

968 969
	if (!rev.diffopt.output_format
		|| rev.diffopt.output_format == DIFF_FORMAT_PATCH)
970
		rev.diffopt.output_format = DIFF_FORMAT_DIFFSTAT | DIFF_FORMAT_SUMMARY | DIFF_FORMAT_PATCH;
971

972
	if (!DIFF_OPT_TST(&rev.diffopt, TEXT) && !no_binary_diff)
973
		DIFF_OPT_SET(&rev.diffopt, BINARY);
974

975 976
	if (!use_stdout)
		output_directory = set_outdir(prefix, output_directory);
977

978 979 980 981 982 983 984 985
	if (output_directory) {
		if (use_stdout)
			die("standard output, or directory, which one?");
		if (mkdir(output_directory, 0777) < 0 && errno != EEXIST)
			die("Could not create directory %s",
			    output_directory);
	}

986
	if (rev.pending.nr == 1) {
987 988 989 990 991 992
		if (rev.max_count < 0 && !rev.show_root_diff) {
			/*
			 * This is traditional behaviour of "git format-patch
			 * origin" that prepares what the origin side still
			 * does not have.
			 */
J
Junio C Hamano 已提交
993
			rev.pending.objects[0].item->flags |= UNINTERESTING;
994
			add_head_to_pending(&rev);
J
Junio C Hamano 已提交
995
		}
996 997 998 999
		/*
		 * Otherwise, it is "format-patch -22 HEAD", and/or
		 * "format-patch --root HEAD".  The user wants
		 * get_revision() to do the usual traversal.
J
Junio C Hamano 已提交
1000
		 */
1001
	}
1002 1003 1004 1005 1006 1007 1008

	/*
	 * We cannot move this anywhere earlier because we do want to
	 * know if --root was given explicitly from the comand line.
	 */
	rev.show_root_diff = 1;

1009 1010 1011 1012 1013
	if (cover_letter) {
		/* remember the range */
		int i;
		for (i = 0; i < rev.pending.nr; i++) {
			struct object *o = rev.pending.objects[i].item;
1014
			if (!(o->flags & UNINTERESTING))
1015 1016 1017 1018 1019 1020
				head = (struct commit *)o;
		}
		/* We can't generate a cover letter without any patches */
		if (!head)
			return 0;
	}
1021

1022
	if (ignore_if_in_upstream)
1023
		get_patch_ids(&rev, &ids, prefix);
1024

1025
	if (!use_stdout)
1026
		realstdout = xfdopen(xdup(1), "w");
1027

1028 1029
	if (prepare_revision_walk(&rev))
		die("revision walk setup failed");
1030
	rev.boundary = 1;
1031
	while ((commit = get_revision(&rev)) != NULL) {
1032 1033 1034 1035 1036 1037
		if (commit->object.flags & BOUNDARY) {
			boundary_count++;
			origin = (boundary_count == 1) ? commit : NULL;
			continue;
		}

1038 1039 1040
		/* ignore merges */
		if (commit->parents && commit->parents->next)
			continue;
1041 1042

		if (ignore_if_in_upstream &&
1043
				has_commit_patch_id(commit, &ids))
1044 1045
			continue;

1046
		nr++;
J
Jonas Fonseca 已提交
1047
		list = xrealloc(list, nr * sizeof(list[0]));
1048 1049
		list[nr - 1] = commit;
	}
1050
	total = nr;
1051 1052
	if (!keep_subject && auto_number && total > 1)
		numbered = 1;
1053
	if (numbered)
1054
		rev.total = total + start_number - 1;
1055 1056 1057 1058 1059 1060
	if (in_reply_to || thread || cover_letter)
		rev.ref_message_ids = xcalloc(1, sizeof(struct string_list));
	if (in_reply_to) {
		const char *msgid = clean_message_id(in_reply_to);
		string_list_append(msgid, rev.ref_message_ids);
	}
1061 1062 1063 1064
	if (cover_letter) {
		if (thread)
			gen_message_id(&rev, "cover");
		make_cover_letter(&rev, use_stdout, numbered, numbered_files,
1065
				  origin, nr, list, head);
1066 1067 1068 1069
		total++;
		start_number--;
	}
	rev.add_signoff = add_signoff;
1070 1071 1072
	while (0 <= --nr) {
		int shown;
		commit = list[nr];
1073
		rev.nr = total - nr + (start_number - 1);
1074
		/* Make the second and subsequent mails replies to the first */
1075
		if (thread) {
1076
			/* Have we already had a message ID? */
1077
			if (rev.message_id) {
1078
				/*
1079 1080 1081 1082 1083 1084
				 * For deep threading: make every mail
				 * a reply to the previous one, no
				 * matter what other options are set.
				 *
				 * For shallow threading:
				 *
1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097
				 * Without --cover-letter and
				 * --in-reply-to, make every mail a
				 * reply to the one before.
				 *
				 * With --in-reply-to but no
				 * --cover-letter, make every mail a
				 * reply to the <reply-to>.
				 *
				 * With --cover-letter, make every
				 * mail but the cover letter a reply
				 * to the cover letter.  The cover
				 * letter is a reply to the
				 * --in-reply-to, if specified.
1098
				 */
1099 1100
				if (thread == THREAD_SHALLOW
				    && rev.ref_message_ids->nr > 0
1101
				    && (!cover_letter || rev.nr > 1))
1102 1103
					free(rev.message_id);
				else
1104 1105
					string_list_append(rev.message_id,
							   rev.ref_message_ids);
1106
			}
1107
			gen_message_id(&rev, sha1_to_hex(commit->object.sha1));
1108
		}
1109 1110
		if (!use_stdout && reopen_stdout(numbered_files ? NULL :
				get_oneline_for_filename(commit, keep_subject),
N
Nate Case 已提交
1111
				rev.nr, &rev))
1112
			die("Failed to create output files");
1113 1114 1115
		shown = log_tree_commit(&rev, commit);
		free(commit->buffer);
		commit->buffer = NULL;
1116 1117 1118 1119 1120 1121 1122 1123 1124

		/* We put one extra blank line between formatted
		 * patches and this flag is used by log-tree code
		 * to see if it needs to emit a LF before showing
		 * the log; when using one file per patch, we do
		 * not want the extra blank line.
		 */
		if (!use_stdout)
			rev.shown_one = 0;
1125 1126 1127 1128 1129 1130 1131 1132
		if (shown) {
			if (rev.mime_boundary)
				printf("\n--%s%s--\n\n\n",
				       mime_boundary_leader,
				       rev.mime_boundary);
			else
				printf("-- \n%s\n\n", git_version_string);
		}
1133 1134
		if (!use_stdout)
			fclose(stdout);
1135 1136
	}
	free(list);
1137 1138
	if (ignore_if_in_upstream)
		free_patch_ids(&ids);
1139 1140 1141
	return 0;
}

R
Rene Scharfe 已提交
1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156
static int add_pending_commit(const char *arg, struct rev_info *revs, int flags)
{
	unsigned char sha1[20];
	if (get_sha1(arg, sha1) == 0) {
		struct commit *commit = lookup_commit_reference(sha1);
		if (commit) {
			commit->object.flags |= flags;
			add_pending_object(revs, &commit->object, arg);
			return 0;
		}
	}
	return -1;
}

static const char cherry_usage[] =
1157
"git cherry [-v] [<upstream> [<head> [<limit>]]]";
R
Rene Scharfe 已提交
1158 1159 1160
int cmd_cherry(int argc, const char **argv, const char *prefix)
{
	struct rev_info revs;
1161
	struct patch_ids ids;
R
Rene Scharfe 已提交
1162 1163
	struct commit *commit;
	struct commit_list *list = NULL;
1164
	struct branch *current_branch;
R
Rene Scharfe 已提交
1165 1166 1167 1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186
	const char *upstream;
	const char *head = "HEAD";
	const char *limit = NULL;
	int verbose = 0;

	if (argc > 1 && !strcmp(argv[1], "-v")) {
		verbose = 1;
		argc--;
		argv++;
	}

	switch (argc) {
	case 4:
		limit = argv[3];
		/* FALLTHROUGH */
	case 3:
		head = argv[2];
		/* FALLTHROUGH */
	case 2:
		upstream = argv[1];
		break;
	default:
1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197
		current_branch = branch_get(NULL);
		if (!current_branch || !current_branch->merge
					|| !current_branch->merge[0]
					|| !current_branch->merge[0]->dst) {
			fprintf(stderr, "Could not find a tracked"
					" remote branch, please"
					" specify <upstream> manually.\n");
			usage(cherry_usage);
		}

		upstream = current_branch->merge[0]->dst;
R
Rene Scharfe 已提交
1198 1199 1200 1201 1202 1203
	}

	init_revisions(&revs, prefix);
	revs.diff = 1;
	revs.combine_merges = 0;
	revs.ignore_merges = 1;
1204
	DIFF_OPT_SET(&revs.diffopt, RECURSIVE);
R
Rene Scharfe 已提交
1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217

	if (add_pending_commit(head, &revs, 0))
		die("Unknown commit %s", head);
	if (add_pending_commit(upstream, &revs, UNINTERESTING))
		die("Unknown commit %s", upstream);

	/* Don't say anything if head and upstream are the same. */
	if (revs.pending.nr == 2) {
		struct object_array_entry *o = revs.pending.objects;
		if (hashcmp(o[0].item->sha1, o[1].item->sha1) == 0)
			return 0;
	}

1218
	get_patch_ids(&revs, &ids, prefix);
R
Rene Scharfe 已提交
1219 1220 1221 1222 1223

	if (limit && add_pending_commit(limit, &revs, UNINTERESTING))
		die("Unknown commit %s", limit);

	/* reverse the list of commits */
1224 1225
	if (prepare_revision_walk(&revs))
		die("revision walk setup failed");
R
Rene Scharfe 已提交
1226 1227 1228 1229 1230 1231 1232 1233 1234 1235 1236 1237
	while ((commit = get_revision(&revs)) != NULL) {
		/* ignore merges */
		if (commit->parents && commit->parents->next)
			continue;

		commit_list_insert(commit, &list);
	}

	while (list) {
		char sign = '+';

		commit = list->item;
1238
		if (has_commit_patch_id(commit, &ids))
R
Rene Scharfe 已提交
1239 1240 1241
			sign = '-';

		if (verbose) {
1242
			struct strbuf buf = STRBUF_INIT;
1243
			pretty_print_commit(CMIT_FMT_ONELINE, commit,
1244
			                    &buf, 0, NULL, NULL, 0, 0);
R
Rene Scharfe 已提交
1245
			printf("%c %s %s\n", sign,
1246 1247
			       sha1_to_hex(commit->object.sha1), buf.buf);
			strbuf_release(&buf);
R
Rene Scharfe 已提交
1248 1249 1250 1251 1252 1253 1254 1255 1256
		}
		else {
			printf("%c %s\n", sign,
			       sha1_to_hex(commit->object.sha1));
		}

		list = list->next;
	}

1257
	free_patch_ids(&ids);
R
Rene Scharfe 已提交
1258 1259
	return 0;
}