Make Enter in the pager view always scroll
[tig] / tig.c
CommitLineData
4a2909a7
JF
1/* Copyright (c) 2006 Jonas Fonseca <fonseca@diku.dk>
2 * See license info at the bottom. */
b801d8b2
JF
3/**
4 * TIG(1)
5 * ======
6 *
7 * NAME
8 * ----
9 * tig - text-mode interface for git
10 *
11 * SYNOPSIS
12 * --------
13 * [verse]
03a93dbb
JF
14 * tig [options]
15 * tig [options] [--] [git log options]
b76c2afc
JF
16 * tig [options] log [git log options]
17 * tig [options] diff [git diff options]
8855ada4
JF
18 * tig [options] show [git show options]
19 * tig [options] < [git command output]
b801d8b2
JF
20 *
21 * DESCRIPTION
22 * -----------
6706b2ba
JF
23 * Browse changes in a git repository. Additionally, tig(1) can also act
24 * as a pager for output of various git commands.
25 *
57bdf034 26 * When browsing repositories, tig(1) uses the underlying git commands
468876c9
JF
27 * to present the user with various views, such as summarized commit log
28 * and showing the commit with the log message, diffstat, and the diff.
6706b2ba 29 *
468876c9
JF
30 * Using tig(1) as a pager, it will display input from stdin and try
31 * to colorize it.
b801d8b2
JF
32 **/
33
b76c2afc 34#ifndef VERSION
8c11094f 35#define VERSION "tig-0.3"
b76c2afc
JF
36#endif
37
8855ada4
JF
38#ifndef DEBUG
39#define NDEBUG
40#endif
41
22f66b0a 42#include <assert.h>
4c6fabc2 43#include <errno.h>
22f66b0a
JF
44#include <ctype.h>
45#include <signal.h>
b801d8b2 46#include <stdarg.h>
b801d8b2 47#include <stdio.h>
22f66b0a 48#include <stdlib.h>
b801d8b2 49#include <string.h>
6908bdbd 50#include <unistd.h>
b76c2afc 51#include <time.h>
b801d8b2
JF
52
53#include <curses.h>
b801d8b2
JF
54
55static void die(const char *err, ...);
56static void report(const char *msg, ...);
1ba2ae4b 57static void set_nonblocking_input(bool loading);
10e290ee 58static size_t utf8_length(const char *string, size_t max_width, int *coloffset, int *trimmed);
6b161b31
JF
59
60#define ABS(x) ((x) >= 0 ? (x) : -(x))
61#define MIN(x, y) ((x) < (y) ? (x) : (y))
62
63#define ARRAY_SIZE(x) (sizeof(x) / sizeof(x[0]))
64#define STRING_SIZE(x) (sizeof(x) - 1)
b76c2afc 65
2e8488b4
JF
66#define SIZEOF_REF 256 /* Size of symbolic or SHA1 ID. */
67#define SIZEOF_CMD 1024 /* Size of command buffer. */
b801d8b2 68
82e78006
JF
69/* This color name can be used to refer to the default term colors. */
70#define COLOR_DEFAULT (-1)
78c70acd 71
67e48ac5 72#define TIG_HELP "(d)iff, (l)og, (m)ain, (q)uit, (h)elp"
468876c9 73
82e78006 74/* The format and size of the date column in the main view. */
4c6fabc2 75#define DATE_FORMAT "%Y-%m-%d %H:%M"
6b161b31 76#define DATE_COLS STRING_SIZE("2006-04-29 14:21 ")
4c6fabc2 77
10e290ee
JF
78#define AUTHOR_COLS 20
79
a28bcc22 80/* The default interval between line numbers. */
4a2909a7 81#define NUMBER_INTERVAL 1
82e78006 82
6706b2ba
JF
83#define TABSIZE 8
84
a28bcc22
JF
85#define SCALE_SPLIT_VIEW(height) ((height) * 2 / 3)
86
8855ada4 87/* Some ascii-shorthands fitted into the ncurses namespace. */
a28bcc22
JF
88#define KEY_TAB '\t'
89#define KEY_RETURN '\r'
4a2909a7
JF
90#define KEY_ESC 27
91
6706b2ba 92
a28bcc22 93/* User action requests. */
4a2909a7 94enum request {
a28bcc22
JF
95 /* Offset all requests to avoid conflicts with ncurses getch values. */
96 REQ_OFFSET = KEY_MAX + 1,
97
4a2909a7 98 /* XXX: Keep the view request first and in sync with views[]. */
2e8488b4 99 REQ_VIEW_MAIN,
4a2909a7
JF
100 REQ_VIEW_DIFF,
101 REQ_VIEW_LOG,
2e8488b4 102 REQ_VIEW_HELP,
6908bdbd 103 REQ_VIEW_PAGER,
4a2909a7 104
6b161b31 105 REQ_ENTER,
03a93dbb
JF
106 REQ_QUIT,
107 REQ_PROMPT,
4a2909a7 108 REQ_SCREEN_REDRAW,
fac7db6c 109 REQ_SCREEN_RESIZE,
4a2909a7 110 REQ_SCREEN_UPDATE,
03a93dbb
JF
111 REQ_SHOW_VERSION,
112 REQ_STOP_LOADING,
4a2909a7 113 REQ_TOGGLE_LINE_NUMBERS,
03a93dbb 114 REQ_VIEW_NEXT,
4f9b667a 115 REQ_VIEW_CLOSE,
4a2909a7
JF
116
117 REQ_MOVE_UP,
6706b2ba 118 REQ_MOVE_UP_ENTER,
4a2909a7 119 REQ_MOVE_DOWN,
6706b2ba 120 REQ_MOVE_DOWN_ENTER,
4a2909a7
JF
121 REQ_MOVE_PAGE_UP,
122 REQ_MOVE_PAGE_DOWN,
123 REQ_MOVE_FIRST_LINE,
124 REQ_MOVE_LAST_LINE,
125
126 REQ_SCROLL_LINE_UP,
127 REQ_SCROLL_LINE_DOWN,
128 REQ_SCROLL_PAGE_UP,
129 REQ_SCROLL_PAGE_DOWN,
130};
131
c34d9c9f 132struct ref {
468876c9
JF
133 char *name; /* Ref name; tag or head names are shortened. */
134 char id[41]; /* Commit SHA1 ID */
135 unsigned int tag:1; /* Is it a tag? */
136 unsigned int next:1; /* For ref lists: are there more refs? */
c34d9c9f
JF
137};
138
4c6fabc2 139struct commit {
a28bcc22 140 char id[41]; /* SHA1 ID. */
6b161b31 141 char title[75]; /* The first line of the commit message. */
a28bcc22
JF
142 char author[75]; /* The author of the commit. */
143 struct tm time; /* Date from the author ident. */
c34d9c9f 144 struct ref **refs; /* Repository references; tags & branch heads. */
4c6fabc2
JF
145};
146
6706b2ba 147
03a93dbb
JF
148/*
149 * String helpers
150 */
78c70acd 151
82e78006 152static inline void
4685845e 153string_ncopy(char *dst, const char *src, int dstlen)
82e78006
JF
154{
155 strncpy(dst, src, dstlen - 1);
156 dst[dstlen - 1] = 0;
03a93dbb 157
82e78006
JF
158}
159
160/* Shorthand for safely copying into a fixed buffer. */
161#define string_copy(dst, src) \
162 string_ncopy(dst, src, sizeof(dst))
163
6706b2ba 164
03a93dbb
JF
165/* Shell quoting
166 *
167 * NOTE: The following is a slightly modified copy of the git project's shell
168 * quoting routines found in the quote.c file.
169 *
170 * Help to copy the thing properly quoted for the shell safety. any single
171 * quote is replaced with '\'', any exclamation point is replaced with '\!',
172 * and the whole thing is enclosed in a
173 *
174 * E.g.
175 * original sq_quote result
176 * name ==> name ==> 'name'
177 * a b ==> a b ==> 'a b'
178 * a'b ==> a'\''b ==> 'a'\''b'
179 * a!b ==> a'\!'b ==> 'a'\!'b'
180 */
181
182static size_t
183sq_quote(char buf[SIZEOF_CMD], size_t bufsize, const char *src)
184{
185 char c;
186
a9274b95 187#define BUFPUT(x) do { if (bufsize < SIZEOF_CMD) buf[bufsize++] = (x); } while (0)
03a93dbb
JF
188
189 BUFPUT('\'');
190 while ((c = *src++)) {
191 if (c == '\'' || c == '!') {
192 BUFPUT('\'');
193 BUFPUT('\\');
194 BUFPUT(c);
195 BUFPUT('\'');
196 } else {
197 BUFPUT(c);
198 }
199 }
200 BUFPUT('\'');
201
202 return bufsize;
203}
204
82e78006 205
b76c2afc
JF
206/**
207 * OPTIONS
208 * -------
209 **/
210
4b8c01a3
JF
211static const char usage[] =
212VERSION " (" __DATE__ ")\n"
213"\n"
214"Usage: tig [options]\n"
215" or: tig [options] [--] [git log options]\n"
216" or: tig [options] log [git log options]\n"
217" or: tig [options] diff [git diff options]\n"
218" or: tig [options] show [git show options]\n"
219" or: tig [options] < [git command output]\n"
220"\n"
221"Options:\n"
222" -l Start up in log view\n"
223" -d Start up in diff view\n"
224" -n[I], --line-number[=I] Show line numbers with given interval\n"
225" -t[N], --tab-size[=N] Set number of spaces for tab expansion\n"
226" -- Mark end of tig options\n"
227" -v, --version Show version and exit\n"
228" -h, --help Show help message and exit\n";
229
6706b2ba
JF
230/* Option and state variables. */
231static bool opt_line_number = FALSE;
2e8488b4 232static int opt_num_interval = NUMBER_INTERVAL;
6706b2ba 233static int opt_tab_size = TABSIZE;
6b161b31 234static enum request opt_request = REQ_VIEW_MAIN;
03a93dbb 235static char opt_cmd[SIZEOF_CMD] = "";
6908bdbd 236static FILE *opt_pipe = NULL;
b76c2afc 237
b76c2afc 238/* Returns the index of log or diff command or -1 to exit. */
8855ada4 239static bool
b76c2afc
JF
240parse_options(int argc, char *argv[])
241{
242 int i;
243
244 for (i = 1; i < argc; i++) {
245 char *opt = argv[i];
246
247 /**
b76c2afc 248 * -l::
1ba2ae4b 249 * Start up in log view using the internal log command.
b76c2afc 250 **/
6b161b31 251 if (!strcmp(opt, "-l")) {
4a2909a7 252 opt_request = REQ_VIEW_LOG;
6b161b31
JF
253 continue;
254 }
b76c2afc
JF
255
256 /**
257 * -d::
1ba2ae4b 258 * Start up in diff view using the internal diff command.
b76c2afc 259 **/
6b161b31 260 if (!strcmp(opt, "-d")) {
4a2909a7 261 opt_request = REQ_VIEW_DIFF;
6b161b31
JF
262 continue;
263 }
b76c2afc
JF
264
265 /**
2e8488b4 266 * -n[INTERVAL], --line-number[=INTERVAL]::
b76c2afc 267 * Prefix line numbers in log and diff view.
2e8488b4 268 * Optionally, with interval different than each line.
b76c2afc 269 **/
6b161b31 270 if (!strncmp(opt, "-n", 2) ||
8855ada4 271 !strncmp(opt, "--line-number", 13)) {
2e8488b4
JF
272 char *num = opt;
273
274 if (opt[1] == 'n') {
275 num = opt + 2;
276
277 } else if (opt[STRING_SIZE("--line-number")] == '=') {
278 num = opt + STRING_SIZE("--line-number=");
279 }
280
281 if (isdigit(*num))
282 opt_num_interval = atoi(num);
283
6b161b31
JF
284 opt_line_number = TRUE;
285 continue;
286 }
b76c2afc
JF
287
288 /**
6706b2ba
JF
289 * -t[NSPACES], --tab-size[=NSPACES]::
290 * Set the number of spaces tabs should be expanded to.
291 **/
292 if (!strncmp(opt, "-t", 2) ||
293 !strncmp(opt, "--tab-size", 10)) {
294 char *num = opt;
295
296 if (opt[1] == 't') {
297 num = opt + 2;
298
299 } else if (opt[STRING_SIZE("--tab-size")] == '=') {
300 num = opt + STRING_SIZE("--tab-size=");
301 }
302
303 if (isdigit(*num))
304 opt_tab_size = MIN(atoi(num), TABSIZE);
305 continue;
306 }
307
308 /**
b76c2afc
JF
309 * -v, --version::
310 * Show version and exit.
311 **/
6b161b31 312 if (!strcmp(opt, "-v") ||
8855ada4 313 !strcmp(opt, "--version")) {
b76c2afc 314 printf("tig version %s\n", VERSION);
8855ada4 315 return FALSE;
6b161b31 316 }
b76c2afc
JF
317
318 /**
4b8c01a3
JF
319 * -h, --help::
320 * Show help message and exit.
321 **/
322 if (!strcmp(opt, "-h") ||
323 !strcmp(opt, "--help")) {
324 printf(usage);
325 return FALSE;
326 }
327
328 /**
03a93dbb 329 * \--::
0721c53a 330 * End of tig(1) options. Useful when specifying command
d44f34bf 331 * options for the main view. Example:
03a93dbb 332 *
889cb462 333 * $ tig -- --since=1.month
b76c2afc 334 **/
6908bdbd
JF
335 if (!strcmp(opt, "--")) {
336 i++;
337 break;
338 }
03a93dbb 339
8855ada4 340 /**
d44f34bf 341 * log [git log options]::
8855ada4
JF
342 * Open log view using the given git log options.
343 *
d44f34bf 344 * diff [git diff options]::
8855ada4
JF
345 * Open diff view using the given git diff options.
346 *
d44f34bf 347 * show [git show options]::
8855ada4
JF
348 * Open diff view using the given git show options.
349 **/
350 if (!strcmp(opt, "log") ||
351 !strcmp(opt, "diff") ||
352 !strcmp(opt, "show")) {
353 opt_request = opt[0] == 'l'
354 ? REQ_VIEW_LOG : REQ_VIEW_DIFF;
355 break;
356 }
357
d44f34bf 358 /**
57bdf034 359 * [git log options]::
d44f34bf
JF
360 * tig(1) will stop the option parsing when the first
361 * command line parameter not starting with "-" is
57bdf034
JF
362 * encountered. All options including this one will be
363 * passed to git log when loading the main view.
364 * This makes it possible to say:
889cb462 365 *
03a93dbb 366 * $ tig tag-1.0..HEAD
d44f34bf 367 **/
03a93dbb 368 if (opt[0] && opt[0] != '-')
6908bdbd 369 break;
6b161b31
JF
370
371 die("unknown command '%s'", opt);
b76c2afc
JF
372 }
373
6908bdbd 374 if (!isatty(STDIN_FILENO)) {
8855ada4
JF
375 /**
376 * Pager mode
377 * ~~~~~~~~~~
378 * If stdin is a pipe, any log or diff options will be ignored and the
379 * pager view will be opened loading data from stdin. The pager mode
380 * can be used for colorizing output from various git commands.
381 *
382 * Example on how to colorize the output of git-show(1):
383 *
384 * $ git show | tig
385 **/
6908bdbd
JF
386 opt_request = REQ_VIEW_PAGER;
387 opt_pipe = stdin;
388
389 } else if (i < argc) {
390 size_t buf_size;
391
8855ada4
JF
392 /**
393 * Git command options
394 * ~~~~~~~~~~~~~~~~~~~
8855ada4
JF
395 * All git command options specified on the command line will
396 * be passed to the given command and all will be shell quoted
468876c9 397 * before they are passed to the shell.
8855ada4 398 *
468876c9
JF
399 * NOTE: If you specify options for the main view, you should
400 * not use the `--pretty` option as this option will be set
401 * automatically to the format expected by the main view.
8855ada4
JF
402 *
403 * Example on how to open the log view and show both author and
404 * committer information:
405 *
406 * $ tig log --pretty=fuller
468876c9 407 *
0721c53a
JF
408 * See the <<refspec, "Specifying revisions">> section below
409 * for an introduction to revision options supported by the git
410 * commands. For details on specific git command options, refer
411 * to the man page of the command in question.
8855ada4
JF
412 **/
413
6908bdbd 414 if (opt_request == REQ_VIEW_MAIN)
8855ada4
JF
415 /* XXX: This is vulnerable to the user overriding
416 * options required for the main view parser. */
6908bdbd
JF
417 string_copy(opt_cmd, "git log --stat --pretty=raw");
418 else
419 string_copy(opt_cmd, "git");
420 buf_size = strlen(opt_cmd);
421
422 while (buf_size < sizeof(opt_cmd) && i < argc) {
423 opt_cmd[buf_size++] = ' ';
424 buf_size = sq_quote(opt_cmd, buf_size, argv[i++]);
425 }
426
427 if (buf_size >= sizeof(opt_cmd))
428 die("command too long");
429
430 opt_cmd[buf_size] = 0;
431
432 }
433
8855ada4 434 return TRUE;
b76c2afc
JF
435}
436
437
438/*
439 * Line-oriented content detection.
6b161b31
JF
440 */
441
2e8488b4 442#define LINE_INFO \
6b161b31
JF
443/* Line type String to match Foreground Background Attributes
444 * --------- --------------- ---------- ---------- ---------- */ \
a28bcc22
JF
445/* Diff markup */ \
446LINE(DIFF, "diff --git ", COLOR_YELLOW, COLOR_DEFAULT, 0), \
8855ada4 447LINE(DIFF_INDEX, "index ", COLOR_BLUE, COLOR_DEFAULT, 0), \
a28bcc22
JF
448LINE(DIFF_CHUNK, "@@", COLOR_MAGENTA, COLOR_DEFAULT, 0), \
449LINE(DIFF_ADD, "+", COLOR_GREEN, COLOR_DEFAULT, 0), \
450LINE(DIFF_DEL, "-", COLOR_RED, COLOR_DEFAULT, 0), \
3af8774e
JF
451LINE(DIFF_OLDMODE, "old file mode ", COLOR_YELLOW, COLOR_DEFAULT, 0), \
452LINE(DIFF_NEWMODE, "new file mode ", COLOR_YELLOW, COLOR_DEFAULT, 0), \
a28bcc22
JF
453LINE(DIFF_COPY, "copy ", COLOR_YELLOW, COLOR_DEFAULT, 0), \
454LINE(DIFF_RENAME, "rename ", COLOR_YELLOW, COLOR_DEFAULT, 0), \
455LINE(DIFF_SIM, "similarity ", COLOR_YELLOW, COLOR_DEFAULT, 0), \
456LINE(DIFF_DISSIM, "dissimilarity ", COLOR_YELLOW, COLOR_DEFAULT, 0), \
457/* Pretty print commit header */ \
6908bdbd 458LINE(PP_AUTHOR, "Author: ", COLOR_CYAN, COLOR_DEFAULT, 0), \
8855ada4 459LINE(PP_COMMIT, "Commit: ", COLOR_MAGENTA, COLOR_DEFAULT, 0), \
6908bdbd
JF
460LINE(PP_MERGE, "Merge: ", COLOR_BLUE, COLOR_DEFAULT, 0), \
461LINE(PP_DATE, "Date: ", COLOR_YELLOW, COLOR_DEFAULT, 0), \
8855ada4
JF
462LINE(PP_ADATE, "AuthorDate: ", COLOR_YELLOW, COLOR_DEFAULT, 0), \
463LINE(PP_CDATE, "CommitDate: ", COLOR_YELLOW, COLOR_DEFAULT, 0), \
a28bcc22
JF
464/* Raw commit header */ \
465LINE(COMMIT, "commit ", COLOR_GREEN, COLOR_DEFAULT, 0), \
466LINE(PARENT, "parent ", COLOR_BLUE, COLOR_DEFAULT, 0), \
467LINE(TREE, "tree ", COLOR_BLUE, COLOR_DEFAULT, 0), \
8855ada4 468LINE(AUTHOR, "author ", COLOR_CYAN, COLOR_DEFAULT, 0), \
a28bcc22
JF
469LINE(COMMITTER, "committer ", COLOR_MAGENTA, COLOR_DEFAULT, 0), \
470/* Misc */ \
471LINE(DIFF_TREE, "diff-tree ", COLOR_BLUE, COLOR_DEFAULT, 0), \
472LINE(SIGNOFF, " Signed-off-by", COLOR_YELLOW, COLOR_DEFAULT, 0), \
473/* UI colors */ \
474LINE(DEFAULT, "", COLOR_DEFAULT, COLOR_DEFAULT, A_NORMAL), \
475LINE(CURSOR, "", COLOR_WHITE, COLOR_GREEN, A_BOLD), \
476LINE(STATUS, "", COLOR_GREEN, COLOR_DEFAULT, 0), \
6b161b31
JF
477LINE(TITLE_BLUR, "", COLOR_WHITE, COLOR_BLUE, 0), \
478LINE(TITLE_FOCUS, "", COLOR_WHITE, COLOR_BLUE, A_BOLD), \
a28bcc22
JF
479LINE(MAIN_DATE, "", COLOR_BLUE, COLOR_DEFAULT, 0), \
480LINE(MAIN_AUTHOR, "", COLOR_GREEN, COLOR_DEFAULT, 0), \
481LINE(MAIN_COMMIT, "", COLOR_DEFAULT, COLOR_DEFAULT, 0), \
c34d9c9f
JF
482LINE(MAIN_DELIM, "", COLOR_MAGENTA, COLOR_DEFAULT, 0), \
483LINE(MAIN_TAG, "", COLOR_MAGENTA, COLOR_DEFAULT, A_BOLD), \
484LINE(MAIN_REF, "", COLOR_CYAN, COLOR_DEFAULT, A_BOLD),
2e8488b4 485
78c70acd 486enum line_type {
2e8488b4
JF
487#define LINE(type, line, fg, bg, attr) \
488 LINE_##type
489 LINE_INFO
490#undef LINE
78c70acd
JF
491};
492
493struct line_info {
4685845e 494 const char *line; /* The start of line to match. */
2e8488b4
JF
495 int linelen; /* Size of string to match. */
496 int fg, bg, attr; /* Color and text attributes for the lines. */
78c70acd
JF
497};
498
2e8488b4 499static struct line_info line_info[] = {
78c70acd 500#define LINE(type, line, fg, bg, attr) \
a28bcc22 501 { (line), STRING_SIZE(line), (fg), (bg), (attr) }
2e8488b4
JF
502 LINE_INFO
503#undef LINE
78c70acd
JF
504};
505
2e8488b4
JF
506static enum line_type
507get_line_type(char *line)
78c70acd
JF
508{
509 int linelen = strlen(line);
a28bcc22 510 enum line_type type;
78c70acd 511
a28bcc22 512 for (type = 0; type < ARRAY_SIZE(line_info); type++)
2e8488b4 513 /* Case insensitive search matches Signed-off-by lines better. */
a28bcc22
JF
514 if (linelen >= line_info[type].linelen &&
515 !strncasecmp(line_info[type].line, line, line_info[type].linelen))
516 return type;
78c70acd 517
2e8488b4 518 return LINE_DEFAULT;
78c70acd
JF
519}
520
2e8488b4 521static inline int
78c70acd
JF
522get_line_attr(enum line_type type)
523{
2e8488b4
JF
524 assert(type < ARRAY_SIZE(line_info));
525 return COLOR_PAIR(type) | line_info[type].attr;
78c70acd
JF
526}
527
528static void
529init_colors(void)
530{
82e78006
JF
531 int default_bg = COLOR_BLACK;
532 int default_fg = COLOR_WHITE;
a28bcc22 533 enum line_type type;
78c70acd
JF
534
535 start_color();
536
537 if (use_default_colors() != ERR) {
82e78006
JF
538 default_bg = -1;
539 default_fg = -1;
78c70acd
JF
540 }
541
a28bcc22
JF
542 for (type = 0; type < ARRAY_SIZE(line_info); type++) {
543 struct line_info *info = &line_info[type];
82e78006
JF
544 int bg = info->bg == COLOR_DEFAULT ? default_bg : info->bg;
545 int fg = info->fg == COLOR_DEFAULT ? default_fg : info->fg;
78c70acd 546
a28bcc22 547 init_pair(type, fg, bg);
78c70acd
JF
548 }
549}
550
551
1ba2ae4b
JF
552/**
553 * ENVIRONMENT VARIABLES
554 * ---------------------
c34d9c9f
JF
555 * Several options related to the interface with git can be configured
556 * via environment options.
557 *
558 * Repository references
559 * ~~~~~~~~~~~~~~~~~~~~~
560 * Commits that are referenced by tags and branch heads will be marked
561 * by the reference name surrounded by '[' and ']':
562 *
468876c9 563 * 2006-03-26 19:42 Petr Baudis | [cogito-0.17.1] Cogito 0.17.1
c34d9c9f
JF
564 *
565 * If you want to filter out certain directories under `.git/refs/`, say
566 * `tmp` you can do it by setting the following variable:
567 *
6706b2ba 568 * $ TIG_LS_REMOTE="git ls-remote . | sed /\/tmp\//d" tig
c34d9c9f
JF
569 *
570 * Or set the variable permanently in your environment.
571 *
572 * TIG_LS_REMOTE::
6706b2ba
JF
573 * Set command for retrieving all repository references. The command
574 * should output data in the same format as git-ls-remote(1).
c34d9c9f
JF
575 **/
576
577#define TIG_LS_REMOTE \
1b4b0bd9 578 "git ls-remote . 2>/dev/null"
c34d9c9f
JF
579
580/**
0721c53a 581 * [[view-commands]]
c34d9c9f
JF
582 * View commands
583 * ~~~~~~~~~~~~~
1ba2ae4b 584 * It is possible to alter which commands are used for the different views.
6706b2ba
JF
585 * If for example you prefer commits in the main view to be sorted by date
586 * and only show 500 commits, use:
1ba2ae4b
JF
587 *
588 * $ TIG_MAIN_CMD="git log --date-order -n500 --pretty=raw %s" tig
589 *
590 * Or set the variable permanently in your environment.
591 *
592 * Notice, how `%s` is used to specify the commit reference. There can
593 * be a maximum of 5 `%s` ref specifications.
594 *
595 * TIG_DIFF_CMD::
596 * The command used for the diff view. By default, git show is used
597 * as a backend.
598 *
599 * TIG_LOG_CMD::
6706b2ba
JF
600 * The command used for the log view. If you prefer to have both
601 * author and committer shown in the log view be sure to pass
602 * `--pretty=fuller` to git log.
1ba2ae4b
JF
603 *
604 * TIG_MAIN_CMD::
605 * The command used for the main view. Note, you must always specify
606 * the option: `--pretty=raw` since the main view parser expects to
607 * read that format.
608 **/
609
610#define TIG_DIFF_CMD \
611 "git show --patch-with-stat --find-copies-harder -B -C %s"
612
613#define TIG_LOG_CMD \
614 "git log --cc --stat -n100 %s"
615
616#define TIG_MAIN_CMD \
617 "git log --topo-order --stat --pretty=raw %s"
618
0721c53a 619/* ... silently ignore that the following are also exported. */
1ba2ae4b
JF
620
621#define TIG_HELP_CMD \
1b4b0bd9 622 "man tig 2>/dev/null"
1ba2ae4b
JF
623
624#define TIG_PAGER_CMD \
625 ""
626
c2124ccd 627
468876c9
JF
628/**
629 * The viewer
630 * ----------
c2124ccd
JF
631 * The display consists of a status window on the last line of the screen and
632 * one or more views. The default is to only show one view at the time but it
633 * is possible to split both the main and log view to also show the commit
634 * diff.
468876c9 635 *
c2124ccd
JF
636 * If you are in the log view and press 'Enter' when the current line is a
637 * commit line, such as:
468876c9 638 *
c2124ccd 639 * commit 4d55caff4cc89335192f3e566004b4ceef572521
468876c9 640 *
c2124ccd
JF
641 * You will split the view so that the log view is displayed in the top window
642 * and the diff view in the bottom window. You can switch between the two
643 * views by pressing 'Tab'. To maximize the log view again, simply press 'l'.
644 **/
645
646struct view;
647
648/* The display array of active views and the index of the current view. */
649static struct view *display[2];
650static unsigned int current_view;
651
652#define foreach_view(view, i) \
653 for (i = 0; i < ARRAY_SIZE(display) && (view = display[i]); i++)
654
655
656/**
657 * Current head and commit ID
658 * ~~~~~~~~~~~~~~~~~~~~~~~~~~
659 * The viewer keeps track of both what head and commit ID you are currently
660 * viewing. The commit ID will follow the cursor line and change everytime time
661 * you highlight a different commit. Whenever you reopen the diff view it
662 * will be reloaded, if the commit ID changed.
468876c9 663 *
c2124ccd
JF
664 * The head ID is used when opening the main and log view to indicate from
665 * what revision to show history.
468876c9 666 **/
b801d8b2 667
c2124ccd
JF
668static char ref_commit[SIZEOF_REF] = "HEAD";
669static char ref_head[SIZEOF_REF] = "HEAD";
670
671
b801d8b2 672struct view {
03a93dbb 673 const char *name; /* View name */
4685845e
TH
674 const char *cmd_fmt; /* Default command line format */
675 const char *cmd_env; /* Command line set via environment */
676 const char *id; /* Points to either of ref_{head,commit} */
03a93dbb 677 size_t objsize; /* Size of objects in the line index */
6b161b31
JF
678
679 struct view_ops {
6734f6b9
JF
680 /* What type of content being displayed. Used in the
681 * title bar. */
4685845e 682 const char *type;
8855ada4 683 /* Draw one line; @lineno must be < view->height. */
6b161b31 684 bool (*draw)(struct view *view, unsigned int lineno);
8855ada4 685 /* Read one line; updates view->line. */
6b161b31 686 bool (*read)(struct view *view, char *line);
8855ada4 687 /* Depending on view, change display based on current line. */
6b161b31
JF
688 bool (*enter)(struct view *view);
689 } *ops;
22f66b0a 690
03a93dbb 691 char cmd[SIZEOF_CMD]; /* Command buffer */
49f2b43f
JF
692 char ref[SIZEOF_REF]; /* Hovered commit reference */
693 char vid[SIZEOF_REF]; /* View ID. Set to id member when updating. */
2e8488b4 694
8855ada4
JF
695 int height, width; /* The width and height of the main window */
696 WINDOW *win; /* The main window */
697 WINDOW *title; /* The title window living below the main window */
b801d8b2
JF
698
699 /* Navigation */
700 unsigned long offset; /* Offset of the window top */
701 unsigned long lineno; /* Current line number */
702
703 /* Buffering */
704 unsigned long lines; /* Total number of lines */
8855ada4
JF
705 void **line; /* Line index; each line contains user data */
706 unsigned int digits; /* Number of digits in the lines member. */
b801d8b2
JF
707
708 /* Loading */
709 FILE *pipe;
2e8488b4 710 time_t start_time;
b801d8b2
JF
711};
712
6b161b31
JF
713static struct view_ops pager_ops;
714static struct view_ops main_ops;
a28bcc22 715
1ba2ae4b
JF
716#define VIEW_STR(name, cmd, env, ref, objsize, ops) \
717 { name, cmd, #env, ref, objsize, ops }
718
719#define VIEW_(id, name, ops, ref, objsize) \
720 VIEW_STR(name, TIG_##id##_CMD, TIG_##id##_CMD, ref, objsize, ops)
721
c2124ccd
JF
722/**
723 * Views
724 * ~~~~~
725 * tig(1) presents various 'views' of a repository. Each view is based on output
726 * from an external command, most often 'git log', 'git diff', or 'git show'.
727 *
728 * The main view::
729 * Is the default view, and it shows a one line summary of each commit
730 * in the chosen list of revisions. The summary includes commit date,
731 * author, and the first line of the log message. Additionally, any
732 * repository references, such as tags, will be shown.
733 *
734 * The log view::
735 * Presents a more rich view of the revision log showing the whole log
736 * message and the diffstat.
737 *
738 * The diff view::
739 * Shows either the diff of the current working tree, that is, what
740 * has changed since the last commit, or the commit diff complete
741 * with log message, diffstat and diff.
742 *
743 * The pager view::
744 * Is used for displaying both input from stdin and output from git
745 * commands entered in the internal prompt.
746 *
747 * The help view::
748 * Displays the information from the tig(1) man page. For the help view
749 * to work you need to have the tig(1) man page installed.
750 **/
751
b801d8b2 752static struct view views[] = {
1ba2ae4b
JF
753 VIEW_(MAIN, "main", &main_ops, ref_head, sizeof(struct commit)),
754 VIEW_(DIFF, "diff", &pager_ops, ref_commit, sizeof(char)),
755 VIEW_(LOG, "log", &pager_ops, ref_head, sizeof(char)),
c2124ccd 756 VIEW_(HELP, "help", &pager_ops, "static", sizeof(char)),
1ba2ae4b 757 VIEW_(PAGER, "pager", &pager_ops, "static", sizeof(char)),
b801d8b2
JF
758};
759
a28bcc22
JF
760#define VIEW(req) (&views[(req) - REQ_OFFSET - 1])
761
4c6fabc2 762
b801d8b2 763static void
82e78006 764redraw_view_from(struct view *view, int lineno)
b801d8b2 765{
82e78006 766 assert(0 <= lineno && lineno < view->height);
b801d8b2 767
82e78006 768 for (; lineno < view->height; lineno++) {
6b161b31 769 if (!view->ops->draw(view, lineno))
fd85fef1 770 break;
b801d8b2
JF
771 }
772
773 redrawwin(view->win);
774 wrefresh(view->win);
775}
776
b76c2afc 777static void
82e78006
JF
778redraw_view(struct view *view)
779{
780 wclear(view->win);
781 redraw_view_from(view, 0);
782}
783
c2124ccd
JF
784
785/**
786 * Title windows
787 * ~~~~~~~~~~~~~
788 * Each view has a title window which shows the name of the view, current
789 * commit ID if available, and where the view is positioned:
790 *
791 * [main] c622eefaa485995320bc743431bae0d497b1d875 - commit 1 of 61 (1%)
792 *
793 * By default, the title of the current view is highlighted using bold font.
794 **/
795
6b161b31 796static void
81030ec8
JF
797update_view_title(struct view *view)
798{
799 if (view == display[current_view])
800 wbkgdset(view->title, get_line_attr(LINE_TITLE_FOCUS));
801 else
802 wbkgdset(view->title, get_line_attr(LINE_TITLE_BLUR));
803
804 werase(view->title);
805 wmove(view->title, 0, 0);
806
81030ec8
JF
807 if (*view->ref)
808 wprintw(view->title, "[%s] %s", view->name, view->ref);
809 else
810 wprintw(view->title, "[%s]", view->name);
811
812 if (view->lines) {
813 wprintw(view->title, " - %s %d of %d (%d%%)",
814 view->ops->type,
815 view->lineno + 1,
816 view->lines,
817 (view->lineno + 1) * 100 / view->lines);
818 }
819
820 wrefresh(view->title);
821}
822
823static void
6b161b31 824resize_display(void)
b76c2afc 825{
03a93dbb 826 int offset, i;
6b161b31
JF
827 struct view *base = display[0];
828 struct view *view = display[1] ? display[1] : display[0];
b76c2afc 829
6b161b31 830 /* Setup window dimensions */
b76c2afc 831
03a93dbb 832 getmaxyx(stdscr, base->height, base->width);
b76c2afc 833
6b161b31 834 /* Make room for the status window. */
03a93dbb 835 base->height -= 1;
6b161b31
JF
836
837 if (view != base) {
03a93dbb
JF
838 /* Horizontal split. */
839 view->width = base->width;
6b161b31
JF
840 view->height = SCALE_SPLIT_VIEW(base->height);
841 base->height -= view->height;
842
843 /* Make room for the title bar. */
844 view->height -= 1;
845 }
846
847 /* Make room for the title bar. */
848 base->height -= 1;
849
850 offset = 0;
851
852 foreach_view (view, i) {
4d55caff
JF
853 /* Keep the height of all view->win windows one larger than is
854 * required so that the cursor can wrap-around on the last line
855 * without scrolling the window. */
b76c2afc 856 if (!view->win) {
6706b2ba 857 view->win = newwin(view->height + 1, 0, offset, 0);
6b161b31
JF
858 if (!view->win)
859 die("Failed to create %s view", view->name);
860
861 scrollok(view->win, TRUE);
862
863 view->title = newwin(1, 0, offset + view->height, 0);
864 if (!view->title)
865 die("Failed to create title window");
866
867 } else {
6706b2ba 868 wresize(view->win, view->height + 1, view->width);
6b161b31
JF
869 mvwin(view->win, offset, 0);
870 mvwin(view->title, offset + view->height, 0);
871 wrefresh(view->win);
a28bcc22 872 }
a28bcc22 873
6b161b31 874 offset += view->height + 1;
b76c2afc 875 }
6b161b31 876}
b76c2afc 877
6b161b31 878static void
20bb5e18
JF
879redraw_display(void)
880{
881 struct view *view;
882 int i;
883
884 foreach_view (view, i) {
885 redraw_view(view);
886 update_view_title(view);
887 }
888}
889
890
2e8488b4
JF
891/*
892 * Navigation
893 */
894
4a2909a7 895/* Scrolling backend */
b801d8b2 896static void
4a2909a7 897do_scroll_view(struct view *view, int lines)
b801d8b2 898{
fd85fef1
JF
899 /* The rendering expects the new offset. */
900 view->offset += lines;
901
902 assert(0 <= view->offset && view->offset < view->lines);
903 assert(lines);
b801d8b2 904
82e78006 905 /* Redraw the whole screen if scrolling is pointless. */
4c6fabc2 906 if (view->height < ABS(lines)) {
b76c2afc
JF
907 redraw_view(view);
908
909 } else {
22f66b0a 910 int line = lines > 0 ? view->height - lines : 0;
82e78006 911 int end = line + ABS(lines);
fd85fef1
JF
912
913 wscrl(view->win, lines);
914
22f66b0a 915 for (; line < end; line++) {
6b161b31 916 if (!view->ops->draw(view, line))
fd85fef1
JF
917 break;
918 }
919 }
920
921 /* Move current line into the view. */
922 if (view->lineno < view->offset) {
923 view->lineno = view->offset;
6b161b31 924 view->ops->draw(view, 0);
fd85fef1
JF
925
926 } else if (view->lineno >= view->offset + view->height) {
6706b2ba
JF
927 if (view->lineno == view->offset + view->height) {
928 /* Clear the hidden line so it doesn't show if the view
929 * is scrolled up. */
930 wmove(view->win, view->height, 0);
931 wclrtoeol(view->win);
932 }
fd85fef1 933 view->lineno = view->offset + view->height - 1;
6b161b31 934 view->ops->draw(view, view->lineno - view->offset);
fd85fef1
JF
935 }
936
4c6fabc2 937 assert(view->offset <= view->lineno && view->lineno < view->lines);
fd85fef1
JF
938
939 redrawwin(view->win);
940 wrefresh(view->win);
9d3f5834 941 report("");
fd85fef1 942}
78c70acd 943
4a2909a7 944/* Scroll frontend */
fd85fef1 945static void
6b161b31 946scroll_view(struct view *view, enum request request)
fd85fef1
JF
947{
948 int lines = 1;
b801d8b2
JF
949
950 switch (request) {
4a2909a7 951 case REQ_SCROLL_PAGE_DOWN:
fd85fef1 952 lines = view->height;
4a2909a7 953 case REQ_SCROLL_LINE_DOWN:
b801d8b2 954 if (view->offset + lines > view->lines)
bde3653a 955 lines = view->lines - view->offset;
b801d8b2 956
fd85fef1 957 if (lines == 0 || view->offset + view->height >= view->lines) {
eb98559e 958 report("Cannot scroll beyond the last line");
b801d8b2
JF
959 return;
960 }
961 break;
962
4a2909a7 963 case REQ_SCROLL_PAGE_UP:
fd85fef1 964 lines = view->height;
4a2909a7 965 case REQ_SCROLL_LINE_UP:
b801d8b2
JF
966 if (lines > view->offset)
967 lines = view->offset;
968
969 if (lines == 0) {
eb98559e 970 report("Cannot scroll beyond the first line");
b801d8b2
JF
971 return;
972 }
973
fd85fef1 974 lines = -lines;
b801d8b2 975 break;
03a93dbb 976
6b161b31
JF
977 default:
978 die("request %d not handled in switch", request);
b801d8b2
JF
979 }
980
4a2909a7 981 do_scroll_view(view, lines);
fd85fef1 982}
b801d8b2 983
4a2909a7 984/* Cursor moving */
fd85fef1 985static void
6b161b31 986move_view(struct view *view, enum request request)
fd85fef1
JF
987{
988 int steps;
b801d8b2 989
fd85fef1 990 switch (request) {
4a2909a7 991 case REQ_MOVE_FIRST_LINE:
78c70acd
JF
992 steps = -view->lineno;
993 break;
994
4a2909a7 995 case REQ_MOVE_LAST_LINE:
78c70acd
JF
996 steps = view->lines - view->lineno - 1;
997 break;
998
4a2909a7 999 case REQ_MOVE_PAGE_UP:
78c70acd
JF
1000 steps = view->height > view->lineno
1001 ? -view->lineno : -view->height;
1002 break;
1003
4a2909a7 1004 case REQ_MOVE_PAGE_DOWN:
78c70acd
JF
1005 steps = view->lineno + view->height >= view->lines
1006 ? view->lines - view->lineno - 1 : view->height;
1007 break;
1008
4a2909a7 1009 case REQ_MOVE_UP:
6706b2ba 1010 case REQ_MOVE_UP_ENTER:
fd85fef1
JF
1011 steps = -1;
1012 break;
b801d8b2 1013
4a2909a7 1014 case REQ_MOVE_DOWN:
6706b2ba 1015 case REQ_MOVE_DOWN_ENTER:
fd85fef1
JF
1016 steps = 1;
1017 break;
6b161b31
JF
1018
1019 default:
1020 die("request %d not handled in switch", request);
78c70acd 1021 }
b801d8b2 1022
4c6fabc2 1023 if (steps <= 0 && view->lineno == 0) {
eb98559e 1024 report("Cannot move beyond the first line");
78c70acd 1025 return;
b801d8b2 1026
6908bdbd 1027 } else if (steps >= 0 && view->lineno + 1 >= view->lines) {
eb98559e 1028 report("Cannot move beyond the last line");
78c70acd 1029 return;
fd85fef1
JF
1030 }
1031
4c6fabc2 1032 /* Move the current line */
fd85fef1 1033 view->lineno += steps;
4c6fabc2
JF
1034 assert(0 <= view->lineno && view->lineno < view->lines);
1035
1036 /* Repaint the old "current" line if we be scrolling */
2e8488b4
JF
1037 if (ABS(steps) < view->height) {
1038 int prev_lineno = view->lineno - steps - view->offset;
1039
1040 wmove(view->win, prev_lineno, 0);
1041 wclrtoeol(view->win);
03a93dbb 1042 view->ops->draw(view, prev_lineno);
2e8488b4 1043 }
fd85fef1 1044
4c6fabc2 1045 /* Check whether the view needs to be scrolled */
fd85fef1
JF
1046 if (view->lineno < view->offset ||
1047 view->lineno >= view->offset + view->height) {
1048 if (steps < 0 && -steps > view->offset) {
1049 steps = -view->offset;
b76c2afc
JF
1050
1051 } else if (steps > 0) {
1052 if (view->lineno == view->lines - 1 &&
1053 view->lines > view->height) {
1054 steps = view->lines - view->offset - 1;
1055 if (steps >= view->height)
1056 steps -= view->height - 1;
1057 }
b801d8b2 1058 }
78c70acd 1059
4a2909a7 1060 do_scroll_view(view, steps);
fd85fef1 1061 return;
b801d8b2
JF
1062 }
1063
4c6fabc2 1064 /* Draw the current line */
6b161b31 1065 view->ops->draw(view, view->lineno - view->offset);
fd85fef1 1066
b801d8b2
JF
1067 redrawwin(view->win);
1068 wrefresh(view->win);
9d3f5834 1069 report("");
b801d8b2
JF
1070}
1071
b801d8b2 1072
2e8488b4
JF
1073/*
1074 * Incremental updating
1075 */
b801d8b2 1076
03a93dbb 1077static bool
b801d8b2
JF
1078begin_update(struct view *view)
1079{
4685845e 1080 const char *id = view->id;
fd85fef1 1081
03a93dbb
JF
1082 if (opt_cmd[0]) {
1083 string_copy(view->cmd, opt_cmd);
1084 opt_cmd[0] = 0;
8855ada4
JF
1085 /* When running random commands, the view ref could have become
1086 * invalid so clear it. */
1087 view->ref[0] = 0;
03a93dbb 1088 } else {
4685845e 1089 const char *format = view->cmd_env ? view->cmd_env : view->cmd_fmt;
1ba2ae4b
JF
1090
1091 if (snprintf(view->cmd, sizeof(view->cmd), format,
1092 id, id, id, id, id) >= sizeof(view->cmd))
03a93dbb
JF
1093 return FALSE;
1094 }
b801d8b2 1095
6908bdbd
JF
1096 /* Special case for the pager view. */
1097 if (opt_pipe) {
1098 view->pipe = opt_pipe;
1099 opt_pipe = NULL;
1100 } else {
1101 view->pipe = popen(view->cmd, "r");
1102 }
1103
2e8488b4
JF
1104 if (!view->pipe)
1105 return FALSE;
b801d8b2 1106
6b161b31 1107 set_nonblocking_input(TRUE);
b801d8b2
JF
1108
1109 view->offset = 0;
1110 view->lines = 0;
1111 view->lineno = 0;
49f2b43f 1112 string_copy(view->vid, id);
b801d8b2 1113
2e8488b4
JF
1114 if (view->line) {
1115 int i;
1116
1117 for (i = 0; i < view->lines; i++)
1118 if (view->line[i])
1119 free(view->line[i]);
1120
1121 free(view->line);
1122 view->line = NULL;
1123 }
1124
1125 view->start_time = time(NULL);
1126
b801d8b2
JF
1127 return TRUE;
1128}
1129
1130static void
1131end_update(struct view *view)
1132{
03a93dbb
JF
1133 if (!view->pipe)
1134 return;
6b161b31 1135 set_nonblocking_input(FALSE);
80ce96ea
JF
1136 if (view->pipe == stdin)
1137 fclose(view->pipe);
1138 else
1139 pclose(view->pipe);
2e8488b4 1140 view->pipe = NULL;
b801d8b2
JF
1141}
1142
03a93dbb 1143static bool
b801d8b2
JF
1144update_view(struct view *view)
1145{
1146 char buffer[BUFSIZ];
1147 char *line;
22f66b0a 1148 void **tmp;
82e78006
JF
1149 /* The number of lines to read. If too low it will cause too much
1150 * redrawing (and possible flickering), if too high responsiveness
1151 * will suffer. */
8855ada4 1152 unsigned long lines = view->height;
82e78006 1153 int redraw_from = -1;
b801d8b2
JF
1154
1155 if (!view->pipe)
1156 return TRUE;
1157
82e78006
JF
1158 /* Only redraw if lines are visible. */
1159 if (view->offset + view->height >= view->lines)
1160 redraw_from = view->lines - view->offset;
b801d8b2
JF
1161
1162 tmp = realloc(view->line, sizeof(*view->line) * (view->lines + lines));
1163 if (!tmp)
1164 goto alloc_error;
1165
1166 view->line = tmp;
1167
1168 while ((line = fgets(buffer, sizeof(buffer), view->pipe))) {
c34d9c9f 1169 int linelen = strlen(line);
b801d8b2 1170
b801d8b2
JF
1171 if (linelen)
1172 line[linelen - 1] = 0;
1173
6b161b31 1174 if (!view->ops->read(view, line))
b801d8b2 1175 goto alloc_error;
fd85fef1
JF
1176
1177 if (lines-- == 1)
1178 break;
b801d8b2
JF
1179 }
1180
8855ada4
JF
1181 {
1182 int digits;
1183
1184 lines = view->lines;
1185 for (digits = 0; lines; digits++)
1186 lines /= 10;
1187
1188 /* Keep the displayed view in sync with line number scaling. */
1189 if (digits != view->digits) {
1190 view->digits = digits;
1191 redraw_from = 0;
1192 }
1193 }
1194
82e78006
JF
1195 if (redraw_from >= 0) {
1196 /* If this is an incremental update, redraw the previous line
a28bcc22
JF
1197 * since for commits some members could have changed when
1198 * loading the main view. */
82e78006
JF
1199 if (redraw_from > 0)
1200 redraw_from--;
1201
1202 /* Incrementally draw avoids flickering. */
1203 redraw_view_from(view, redraw_from);
4c6fabc2 1204 }
b801d8b2 1205
eb98559e
JF
1206 /* Update the title _after_ the redraw so that if the redraw picks up a
1207 * commit reference in view->ref it'll be available here. */
1208 update_view_title(view);
1209
b801d8b2 1210 if (ferror(view->pipe)) {
03a93dbb 1211 report("Failed to read: %s", strerror(errno));
b801d8b2
JF
1212 goto end;
1213
1214 } else if (feof(view->pipe)) {
2e8488b4
JF
1215 time_t secs = time(NULL) - view->start_time;
1216
a28bcc22 1217 if (view == VIEW(REQ_VIEW_HELP)) {
4685845e 1218 const char *msg = TIG_HELP;
468876c9
JF
1219
1220 if (view->lines == 0) {
1221 /* Slightly ugly, but abusing view->ref keeps
1222 * the error message. */
1223 string_copy(view->ref, "No help available");
1224 msg = "The tig(1) manpage is not installed";
1225 }
1226
1227 report("%s", msg);
2e8488b4
JF
1228 goto end;
1229 }
1230
1231 report("Loaded %d lines in %ld second%s", view->lines, secs,
1232 secs == 1 ? "" : "s");
b801d8b2
JF
1233 goto end;
1234 }
1235
1236 return TRUE;
1237
1238alloc_error:
2e8488b4 1239 report("Allocation failure");
b801d8b2
JF
1240
1241end:
1242 end_update(view);
1243 return FALSE;
1244}
1245
49f2b43f
JF
1246enum open_flags {
1247 OPEN_DEFAULT = 0, /* Use default view switching. */
1248 OPEN_SPLIT = 1, /* Split current view. */
1249 OPEN_BACKGROUNDED = 2, /* Backgrounded. */
1250 OPEN_RELOAD = 4, /* Reload view even if it is the current. */
1251};
1252
6b161b31 1253static void
49f2b43f 1254open_view(struct view *prev, enum request request, enum open_flags flags)
b801d8b2 1255{
49f2b43f
JF
1256 bool backgrounded = !!(flags & OPEN_BACKGROUNDED);
1257 bool split = !!(flags & OPEN_SPLIT);
1258 bool reload = !!(flags & OPEN_RELOAD);
a28bcc22 1259 struct view *view = VIEW(request);
b801d8b2 1260 struct view *displayed;
6b161b31
JF
1261 int nviews;
1262
03a93dbb 1263 /* Cycle between displayed views and count the views. */
6b161b31 1264 foreach_view (displayed, nviews) {
03a93dbb
JF
1265 if (prev != view &&
1266 view == displayed &&
8855ada4 1267 !strcmp(view->vid, prev->vid)) {
6b161b31
JF
1268 current_view = nviews;
1269 /* Blur out the title of the previous view. */
1270 update_view_title(prev);
6734f6b9 1271 report("");
6b161b31 1272 return;
a28bcc22 1273 }
6b161b31 1274 }
b801d8b2 1275
49f2b43f 1276 if (view == prev && nviews == 1 && !reload) {
6b161b31
JF
1277 report("Already in %s view", view->name);
1278 return;
1279 }
b801d8b2 1280
8855ada4 1281 if ((reload || strcmp(view->vid, view->id)) &&
03a93dbb 1282 !begin_update(view)) {
6b161b31
JF
1283 report("Failed to load %s view", view->name);
1284 return;
1285 }
a28bcc22 1286
6b161b31
JF
1287 if (split) {
1288 display[current_view + 1] = view;
1289 if (!backgrounded)
a28bcc22 1290 current_view++;
6b161b31
JF
1291 } else {
1292 /* Maximize the current view. */
1293 memset(display, 0, sizeof(display));
1294 current_view = 0;
1295 display[current_view] = view;
a28bcc22 1296 }
b801d8b2 1297
6b161b31 1298 resize_display();
b801d8b2 1299
a8891802 1300 if (split && prev->lineno - prev->offset >= prev->height) {
03a93dbb 1301 /* Take the title line into account. */
eb98559e 1302 int lines = prev->lineno - prev->offset - prev->height + 1;
03a93dbb
JF
1303
1304 /* Scroll the view that was split if the current line is
1305 * outside the new limited view. */
1306 do_scroll_view(prev, lines);
1307 }
1308
6b161b31
JF
1309 if (prev && view != prev) {
1310 /* "Blur" the previous view. */
6706b2ba
JF
1311 if (!backgrounded)
1312 update_view_title(prev);
6b161b31
JF
1313
1314 /* Continue loading split views in the background. */
03a93dbb 1315 if (!split)
6b161b31 1316 end_update(prev);
b801d8b2
JF
1317 }
1318
03a93dbb
JF
1319 if (view->pipe) {
1320 /* Clear the old view and let the incremental updating refill
1321 * the screen. */
1322 wclear(view->win);
1323 report("Loading...");
1324 } else {
1325 redraw_view(view);
468876c9
JF
1326 if (view == VIEW(REQ_VIEW_HELP))
1327 report("%s", TIG_HELP);
1328 else
1329 report("");
03a93dbb 1330 }
6706b2ba
JF
1331
1332 /* If the view is backgrounded the above calls to report()
1333 * won't redraw the view title. */
1334 if (backgrounded)
1335 update_view_title(view);
b801d8b2
JF
1336}
1337
1338
6b161b31
JF
1339/*
1340 * User request switch noodle
1341 */
1342
b801d8b2 1343static int
6b161b31 1344view_driver(struct view *view, enum request request)
b801d8b2 1345{
b801d8b2
JF
1346 int i;
1347
1348 switch (request) {
4a2909a7
JF
1349 case REQ_MOVE_UP:
1350 case REQ_MOVE_DOWN:
1351 case REQ_MOVE_PAGE_UP:
1352 case REQ_MOVE_PAGE_DOWN:
1353 case REQ_MOVE_FIRST_LINE:
1354 case REQ_MOVE_LAST_LINE:
a28bcc22 1355 move_view(view, request);
fd85fef1
JF
1356 break;
1357
4a2909a7
JF
1358 case REQ_SCROLL_LINE_DOWN:
1359 case REQ_SCROLL_LINE_UP:
1360 case REQ_SCROLL_PAGE_DOWN:
1361 case REQ_SCROLL_PAGE_UP:
a28bcc22 1362 scroll_view(view, request);
b801d8b2
JF
1363 break;
1364
4a2909a7 1365 case REQ_VIEW_MAIN:
4a2909a7 1366 case REQ_VIEW_DIFF:
2e8488b4
JF
1367 case REQ_VIEW_LOG:
1368 case REQ_VIEW_HELP:
6908bdbd 1369 case REQ_VIEW_PAGER:
49f2b43f 1370 open_view(view, request, OPEN_DEFAULT);
b801d8b2
JF
1371 break;
1372
6706b2ba
JF
1373 case REQ_MOVE_UP_ENTER:
1374 case REQ_MOVE_DOWN_ENTER:
1375 move_view(view, request);
1376 /* Fall-through */
1377
6b161b31 1378 case REQ_ENTER:
6908bdbd
JF
1379 if (!view->lines) {
1380 report("Nothing to enter");
1381 break;
1382 }
6b161b31
JF
1383 return view->ops->enter(view);
1384
03a93dbb
JF
1385 case REQ_VIEW_NEXT:
1386 {
1387 int nviews = display[1] ? 2 : 1;
1388 int next_view = (current_view + 1) % nviews;
1389
1390 if (next_view == current_view) {
1391 report("Only one view is displayed");
1392 break;
1393 }
1394
1395 current_view = next_view;
1396 /* Blur out the title of the previous view. */
1397 update_view_title(view);
6734f6b9 1398 report("");
03a93dbb
JF
1399 break;
1400 }
4a2909a7 1401 case REQ_TOGGLE_LINE_NUMBERS:
b76c2afc 1402 opt_line_number = !opt_line_number;
20bb5e18 1403 redraw_display();
b801d8b2
JF
1404 break;
1405
03a93dbb 1406 case REQ_PROMPT:
8855ada4 1407 /* Always reload^Wrerun commands from the prompt. */
49f2b43f 1408 open_view(view, opt_request, OPEN_RELOAD);
03a93dbb
JF
1409 break;
1410
4a2909a7 1411 case REQ_STOP_LOADING:
03a93dbb 1412 foreach_view (view, i) {
2e8488b4 1413 if (view->pipe)
6706b2ba 1414 report("Stopped loaded the %s view", view->name),
03a93dbb
JF
1415 end_update(view);
1416 }
b801d8b2
JF
1417 break;
1418
4a2909a7 1419 case REQ_SHOW_VERSION:
6cb291b7 1420 report("%s (built %s)", VERSION, __DATE__);
b801d8b2
JF
1421 return TRUE;
1422
fac7db6c
JF
1423 case REQ_SCREEN_RESIZE:
1424 resize_display();
1425 /* Fall-through */
4a2909a7 1426 case REQ_SCREEN_REDRAW:
20bb5e18 1427 redraw_display();
4a2909a7
JF
1428 break;
1429
1430 case REQ_SCREEN_UPDATE:
b801d8b2
JF
1431 doupdate();
1432 return TRUE;
1433
4f9b667a
JF
1434 case REQ_VIEW_CLOSE:
1435 if (display[1]) {
1436 view = display[(current_view + 1) % ARRAY_SIZE(display)];
1437 memset(display, 0, sizeof(display));
1438 current_view = 0;
1439 display[current_view] = view;
1440 resize_display();
1441 redraw_display();
1442 break;
1443 }
1444 /* Fall-through */
b801d8b2
JF
1445 case REQ_QUIT:
1446 return FALSE;
1447
1448 default:
2e8488b4 1449 /* An unknown key will show most commonly used commands. */
468876c9 1450 report("Unknown key, press 'h' for help");
b801d8b2
JF
1451 return TRUE;
1452 }
1453
1454 return TRUE;
1455}
1456
1457
1458/*
6b161b31 1459 * View backend handlers
b801d8b2
JF
1460 */
1461
6b161b31 1462static bool
22f66b0a 1463pager_draw(struct view *view, unsigned int lineno)
b801d8b2 1464{
78c70acd 1465 enum line_type type;
b801d8b2 1466 char *line;
4c6fabc2 1467 int linelen;
78c70acd 1468 int attr;
b801d8b2 1469
fd85fef1
JF
1470 if (view->offset + lineno >= view->lines)
1471 return FALSE;
1472
b801d8b2 1473 line = view->line[view->offset + lineno];
78c70acd 1474 type = get_line_type(line);
b801d8b2 1475
6706b2ba
JF
1476 wmove(view->win, lineno, 0);
1477
fd85fef1 1478 if (view->offset + lineno == view->lineno) {
8855ada4 1479 if (type == LINE_COMMIT) {
03a93dbb
JF
1480 string_copy(view->ref, line + 7);
1481 string_copy(ref_commit, view->ref);
1482 }
8855ada4 1483
78c70acd 1484 type = LINE_CURSOR;
6706b2ba 1485 wchgat(view->win, -1, 0, type, NULL);
fd85fef1
JF
1486 }
1487
78c70acd 1488 attr = get_line_attr(type);
b801d8b2 1489 wattrset(view->win, attr);
b76c2afc 1490
4c6fabc2 1491 linelen = strlen(line);
4c6fabc2 1492
6706b2ba
JF
1493 if (opt_line_number || opt_tab_size < TABSIZE) {
1494 static char spaces[] = " ";
1495 int col_offset = 0, col = 0;
1496
1497 if (opt_line_number) {
1498 unsigned long real_lineno = view->offset + lineno + 1;
82e78006 1499
6706b2ba
JF
1500 if (real_lineno == 1 ||
1501 (real_lineno % opt_num_interval) == 0) {
1502 wprintw(view->win, "%.*d", view->digits, real_lineno);
8855ada4 1503
6706b2ba
JF
1504 } else {
1505 waddnstr(view->win, spaces,
1506 MIN(view->digits, STRING_SIZE(spaces)));
1507 }
1508 waddstr(view->win, ": ");
1509 col_offset = view->digits + 2;
1510 }
8855ada4 1511
6706b2ba
JF
1512 while (line && col_offset + col < view->width) {
1513 int cols_max = view->width - col_offset - col;
1514 char *text = line;
1515 int cols;
4c6fabc2 1516
b76c2afc 1517 if (*line == '\t') {
6706b2ba 1518 assert(sizeof(spaces) > TABSIZE);
b76c2afc 1519 line++;
6706b2ba
JF
1520 text = spaces;
1521 cols = opt_tab_size - (col % opt_tab_size);
82e78006 1522
b76c2afc 1523 } else {
6706b2ba
JF
1524 line = strchr(line, '\t');
1525 cols = line ? line - text : strlen(text);
b76c2afc 1526 }
6706b2ba
JF
1527
1528 waddnstr(view->win, text, MIN(cols, cols_max));
1529 col += cols;
b76c2afc 1530 }
b76c2afc
JF
1531
1532 } else {
6706b2ba 1533 int col = 0, pos = 0;
b801d8b2 1534
6706b2ba
JF
1535 for (; pos < linelen && col < view->width; pos++, col++)
1536 if (line[pos] == '\t')
1537 col += TABSIZE - (col % TABSIZE) - 1;
1538
1539 waddnstr(view->win, line, pos);
1540 }
2e8488b4 1541
b801d8b2
JF
1542 return TRUE;
1543}
1544
6b161b31 1545static bool
22f66b0a
JF
1546pager_read(struct view *view, char *line)
1547{
6706b2ba
JF
1548 /* Compress empty lines in the help view. */
1549 if (view == VIEW(REQ_VIEW_HELP) &&
1550 !*line &&
1551 view->lines &&
1552 !*((char *) view->line[view->lines - 1]))
1553 return TRUE;
1554
22f66b0a
JF
1555 view->line[view->lines] = strdup(line);
1556 if (!view->line[view->lines])
1557 return FALSE;
1558
1559 view->lines++;
1560 return TRUE;
1561}
1562
6b161b31
JF
1563static bool
1564pager_enter(struct view *view)
1565{
1566 char *line = view->line[view->lineno];
91e8e277 1567 int split = 0;
6b161b31 1568
91e8e277
JF
1569 if ((view == VIEW(REQ_VIEW_LOG) ||
1570 view == VIEW(REQ_VIEW_LOG)) &&
1571 get_line_type(line) == LINE_COMMIT) {
1572 open_view(view, REQ_VIEW_DIFF, OPEN_SPLIT);
1573 split = 1;
67e48ac5
JF
1574 }
1575
91e8e277
JF
1576 /* Always scroll the view even if it was split. That way
1577 * you can use Enter to scroll through the log view and
1578 * split open each commit diff. */
1579 scroll_view(view, REQ_SCROLL_LINE_DOWN);
1580
1581 /* FIXME: A minor workaround. Scrolling the view will call report("")
1582 * but if we are scolling a non-current view this won't properly update
1583 * the view title. */
1584 if (split)
1585 update_view_title(view);
6b161b31
JF
1586
1587 return TRUE;
1588}
1589
6b161b31 1590static struct view_ops pager_ops = {
6734f6b9 1591 "line",
6b161b31
JF
1592 pager_draw,
1593 pager_read,
1594 pager_enter,
1595};
1596
80ce96ea 1597
c34d9c9f
JF
1598static struct ref **get_refs(char *id);
1599
6b161b31 1600static bool
22f66b0a
JF
1601main_draw(struct view *view, unsigned int lineno)
1602{
2e8488b4 1603 char buf[DATE_COLS + 1];
22f66b0a 1604 struct commit *commit;
78c70acd 1605 enum line_type type;
6706b2ba 1606 int col = 0;
b76c2afc 1607 size_t timelen;
10e290ee
JF
1608 size_t authorlen;
1609 int trimmed;
22f66b0a
JF
1610
1611 if (view->offset + lineno >= view->lines)
1612 return FALSE;
1613
1614 commit = view->line[view->offset + lineno];
4c6fabc2
JF
1615 if (!*commit->author)
1616 return FALSE;
22f66b0a 1617
6706b2ba
JF
1618 wmove(view->win, lineno, col);
1619
22f66b0a 1620 if (view->offset + lineno == view->lineno) {
03a93dbb 1621 string_copy(view->ref, commit->id);
49f2b43f 1622 string_copy(ref_commit, view->ref);
78c70acd 1623 type = LINE_CURSOR;
6706b2ba
JF
1624 wattrset(view->win, get_line_attr(type));
1625 wchgat(view->win, -1, 0, type, NULL);
1626
78c70acd 1627 } else {
b76c2afc 1628 type = LINE_MAIN_COMMIT;
6706b2ba 1629 wattrset(view->win, get_line_attr(LINE_MAIN_DATE));
b76c2afc
JF
1630 }
1631
4c6fabc2 1632 timelen = strftime(buf, sizeof(buf), DATE_FORMAT, &commit->time);
b76c2afc 1633 waddnstr(view->win, buf, timelen);
4c6fabc2 1634 waddstr(view->win, " ");
b76c2afc 1635
6706b2ba
JF
1636 col += DATE_COLS;
1637 wmove(view->win, lineno, col);
1638 if (type != LINE_CURSOR)
1639 wattrset(view->win, get_line_attr(LINE_MAIN_AUTHOR));
b76c2afc 1640
10e290ee
JF
1641 /* FIXME: Make this optional, and add i18n.commitEncoding support. */
1642 authorlen = utf8_length(commit->author, AUTHOR_COLS - 2, &col, &trimmed);
1643
1644 if (trimmed) {
1645 waddnstr(view->win, commit->author, authorlen);
6706b2ba
JF
1646 if (type != LINE_CURSOR)
1647 wattrset(view->win, get_line_attr(LINE_MAIN_DELIM));
b76c2afc
JF
1648 waddch(view->win, '~');
1649 } else {
1650 waddstr(view->win, commit->author);
22f66b0a
JF
1651 }
1652
10e290ee 1653 col += AUTHOR_COLS;
6706b2ba
JF
1654 if (type != LINE_CURSOR)
1655 wattrset(view->win, A_NORMAL);
1656
1657 mvwaddch(view->win, lineno, col, ACS_LTEE);
1658 wmove(view->win, lineno, col + 2);
1659 col += 2;
c34d9c9f
JF
1660
1661 if (commit->refs) {
1662 size_t i = 0;
1663
1664 do {
6706b2ba
JF
1665 if (type == LINE_CURSOR)
1666 ;
1667 else if (commit->refs[i]->tag)
c34d9c9f
JF
1668 wattrset(view->win, get_line_attr(LINE_MAIN_TAG));
1669 else
1670 wattrset(view->win, get_line_attr(LINE_MAIN_REF));
1671 waddstr(view->win, "[");
1672 waddstr(view->win, commit->refs[i]->name);
1673 waddstr(view->win, "]");
6706b2ba
JF
1674 if (type != LINE_CURSOR)
1675 wattrset(view->win, A_NORMAL);
c34d9c9f 1676 waddstr(view->win, " ");
6706b2ba 1677 col += strlen(commit->refs[i]->name) + STRING_SIZE("[] ");
c34d9c9f
JF
1678 } while (commit->refs[i++]->next);
1679 }
1680
6706b2ba
JF
1681 if (type != LINE_CURSOR)
1682 wattrset(view->win, get_line_attr(type));
1683
1684 {
1685 int titlelen = strlen(commit->title);
1686
1687 if (col + titlelen > view->width)
1688 titlelen = view->width - col;
1689
1690 waddnstr(view->win, commit->title, titlelen);
1691 }
22f66b0a
JF
1692
1693 return TRUE;
1694}
1695
4c6fabc2 1696/* Reads git log --pretty=raw output and parses it into the commit struct. */
6b161b31 1697static bool
22f66b0a
JF
1698main_read(struct view *view, char *line)
1699{
78c70acd
JF
1700 enum line_type type = get_line_type(line);
1701 struct commit *commit;
22f66b0a 1702
78c70acd
JF
1703 switch (type) {
1704 case LINE_COMMIT:
22f66b0a
JF
1705 commit = calloc(1, sizeof(struct commit));
1706 if (!commit)
1707 return FALSE;
1708
4c6fabc2 1709 line += STRING_SIZE("commit ");
b76c2afc 1710
22f66b0a 1711 view->line[view->lines++] = commit;
82e78006 1712 string_copy(commit->id, line);
c34d9c9f 1713 commit->refs = get_refs(commit->id);
78c70acd 1714 break;
22f66b0a 1715
8855ada4 1716 case LINE_AUTHOR:
b76c2afc 1717 {
4c6fabc2 1718 char *ident = line + STRING_SIZE("author ");
b76c2afc
JF
1719 char *end = strchr(ident, '<');
1720
1721 if (end) {
1722 for (; end > ident && isspace(end[-1]); end--) ;
1723 *end = 0;
1724 }
1725
1726 commit = view->line[view->lines - 1];
82e78006 1727 string_copy(commit->author, ident);
b76c2afc 1728
4c6fabc2 1729 /* Parse epoch and timezone */
b76c2afc
JF
1730 if (end) {
1731 char *secs = strchr(end + 1, '>');
1732 char *zone;
1733 time_t time;
1734
1735 if (!secs || secs[1] != ' ')
1736 break;
1737
1738 secs += 2;
1739 time = (time_t) atol(secs);
1740 zone = strchr(secs, ' ');
4c6fabc2 1741 if (zone && strlen(zone) == STRING_SIZE(" +0700")) {
b76c2afc
JF
1742 long tz;
1743
1744 zone++;
1745 tz = ('0' - zone[1]) * 60 * 60 * 10;
1746 tz += ('0' - zone[2]) * 60 * 60;
1747 tz += ('0' - zone[3]) * 60;
1748 tz += ('0' - zone[4]) * 60;
1749
1750 if (zone[0] == '-')
1751 tz = -tz;
1752
1753 time -= tz;
1754 }
1755 gmtime_r(&time, &commit->time);
1756 }
1757 break;
1758 }
78c70acd 1759 default:
2e8488b4
JF
1760 /* We should only ever end up here if there has already been a
1761 * commit line, however, be safe. */
1762 if (view->lines == 0)
1763 break;
1764
1765 /* Fill in the commit title if it has not already been set. */
78c70acd 1766 commit = view->line[view->lines - 1];
2e8488b4
JF
1767 if (commit->title[0])
1768 break;
1769
1770 /* Require titles to start with a non-space character at the
1771 * offset used by git log. */
eb98559e
JF
1772 /* FIXME: More gracefull handling of titles; append "..." to
1773 * shortened titles, etc. */
2e8488b4 1774 if (strncmp(line, " ", 4) ||
eb98559e 1775 isspace(line[4]))
82e78006
JF
1776 break;
1777
1778 string_copy(commit->title, line + 4);
22f66b0a
JF
1779 }
1780
1781 return TRUE;
1782}
1783
6b161b31
JF
1784static bool
1785main_enter(struct view *view)
b801d8b2 1786{
89e4aafd 1787 open_view(view, REQ_VIEW_DIFF, OPEN_SPLIT);
6b161b31 1788 return TRUE;
b801d8b2
JF
1789}
1790
6b161b31 1791static struct view_ops main_ops = {
6734f6b9 1792 "commit",
6b161b31
JF
1793 main_draw,
1794 main_read,
1795 main_enter,
1796};
2e8488b4 1797
c34d9c9f 1798
468876c9
JF
1799/**
1800 * KEYS
1801 * ----
1802 * Below the default key bindings are shown.
1803 **/
1804
1805struct keymap {
1806 int alias;
1807 int request;
1808};
1809
3a91b75e 1810static struct keymap keymap[] = {
468876c9
JF
1811 /**
1812 * View switching
1813 * ~~~~~~~~~~~~~~
1814 * m::
1815 * Switch to main view.
1816 * d::
1817 * Switch to diff view.
1818 * l::
1819 * Switch to log view.
1820 * p::
1821 * Switch to pager view.
1822 * h::
1823 * Show man page.
4f9b667a
JF
1824 * q::
1825 * Close view if multiple views are open, else quit.
67e48ac5
JF
1826 * Enter::
1827 * This key is "context sensitive" depending on what view you are
1828 * currently in. When in log view on a commit line or in the main
1829 * view, split the view and show the commit diff. In the diff view
1830 * pressing Enter will simply scroll the view one line down.
468876c9
JF
1831 * Tab::
1832 * Switch to next view.
1833 **/
1834 { 'm', REQ_VIEW_MAIN },
1835 { 'd', REQ_VIEW_DIFF },
1836 { 'l', REQ_VIEW_LOG },
1837 { 'p', REQ_VIEW_PAGER },
1838 { 'h', REQ_VIEW_HELP },
1839
4f9b667a 1840 { 'q', REQ_VIEW_CLOSE },
468876c9
JF
1841 { KEY_TAB, REQ_VIEW_NEXT },
1842 { KEY_RETURN, REQ_ENTER },
1843
1844 /**
1845 * Cursor navigation
1846 * ~~~~~~~~~~~~~~~~~
1847 * Up::
57bdf034 1848 * Move cursor one line up.
468876c9
JF
1849 * Down::
1850 * Move cursor one line down.
1851 * k::
57bdf034 1852 * Move cursor one line up and enter. When used in the main view
468876c9
JF
1853 * this will always show the diff of the current commit in the
1854 * split diff view.
1855 * j::
1856 * Move cursor one line down and enter.
1857 * PgUp::
c622eefa 1858 * b::
0df811cb 1859 * -::
57bdf034 1860 * Move cursor one page up.
468876c9 1861 * PgDown::
c622eefa 1862 * Space::
468876c9
JF
1863 * Move cursor one page down.
1864 * Home::
1865 * Jump to first line.
1866 * End::
1867 * Jump to last line.
1868 **/
1869 { KEY_UP, REQ_MOVE_UP },
1870 { KEY_DOWN, REQ_MOVE_DOWN },
1871 { 'k', REQ_MOVE_UP_ENTER },
1872 { 'j', REQ_MOVE_DOWN_ENTER },
1873 { KEY_HOME, REQ_MOVE_FIRST_LINE },
1874 { KEY_END, REQ_MOVE_LAST_LINE },
1875 { KEY_NPAGE, REQ_MOVE_PAGE_DOWN },
c622eefa 1876 { ' ', REQ_MOVE_PAGE_DOWN },
468876c9 1877 { KEY_PPAGE, REQ_MOVE_PAGE_UP },
c622eefa 1878 { 'b', REQ_MOVE_PAGE_UP },
0df811cb 1879 { '-', REQ_MOVE_PAGE_UP },
468876c9
JF
1880
1881 /**
1882 * Scrolling
1883 * ~~~~~~~~~
1884 * Insert::
1885 * Scroll view one line up.
1886 * Delete::
1887 * Scroll view one line down.
1888 * w::
1889 * Scroll view one page up.
1890 * s::
1891 * Scroll view one page down.
1892 **/
1893 { KEY_IC, REQ_SCROLL_LINE_UP },
1894 { KEY_DC, REQ_SCROLL_LINE_DOWN },
1895 { 'w', REQ_SCROLL_PAGE_UP },
1896 { 's', REQ_SCROLL_PAGE_DOWN },
1897
1898 /**
1899 * Misc
1900 * ~~~~
d9d1c722
JF
1901 * Q::
1902 * Quit.
468876c9
JF
1903 * r::
1904 * Redraw screen.
1905 * z::
1906 * Stop all background loading. This can be useful if you use
1907 * tig(1) in a repository with a long history without limiting
0721c53a 1908 * the revision log.
468876c9
JF
1909 * v::
1910 * Show version.
1911 * n::
1912 * Toggle line numbers on/off.
1913 * ':'::
1914 * Open prompt. This allows you to specify what git command
1915 * to run. Example:
1916 *
1917 * :log -p
1918 **/
d9d1c722 1919 { 'Q', REQ_QUIT },
468876c9
JF
1920 { 'z', REQ_STOP_LOADING },
1921 { 'v', REQ_SHOW_VERSION },
1922 { 'r', REQ_SCREEN_REDRAW },
1923 { 'n', REQ_TOGGLE_LINE_NUMBERS },
1924 { ':', REQ_PROMPT },
1925
1926 /* wgetch() with nodelay() enabled returns ERR when there's no input. */
1927 { ERR, REQ_SCREEN_UPDATE },
1928
1929 /* Use the ncurses SIGWINCH handler. */
1930 { KEY_RESIZE, REQ_SCREEN_RESIZE },
1931};
1932
1933static enum request
1934get_request(int key)
1935{
1936 int i;
1937
1938 for (i = 0; i < ARRAY_SIZE(keymap); i++)
1939 if (keymap[i].alias == key)
1940 return keymap[i].request;
1941
1942 return (enum request) key;
1943}
1944
1945
6b161b31 1946/*
10e290ee
JF
1947 * Unicode / UTF-8 handling
1948 *
1949 * NOTE: Much of the following code for dealing with unicode is derived from
1950 * ELinks' UTF-8 code developed by Scrool <scroolik@gmail.com>. Origin file is
1951 * src/intl/charset.c from the utf8 branch commit elinks-0.11.0-g31f2c28.
1952 */
1953
1954/* I've (over)annotated a lot of code snippets because I am not entirely
1955 * confident that the approach taken by this small UTF-8 interface is correct.
1956 * --jonas */
1957
1958static inline int
1959unicode_width(unsigned long c)
1960{
1961 if (c >= 0x1100 &&
1962 (c <= 0x115f /* Hangul Jamo */
1963 || c == 0x2329
1964 || c == 0x232a
1965 || (c >= 0x2e80 && c <= 0xa4cf && c != 0x303f)
1966 /* CJK ... Yi */
1967 || (c >= 0xac00 && c <= 0xd7a3) /* Hangul Syllables */
1968 || (c >= 0xf900 && c <= 0xfaff) /* CJK Compatibility Ideographs */
1969 || (c >= 0xfe30 && c <= 0xfe6f) /* CJK Compatibility Forms */
1970 || (c >= 0xff00 && c <= 0xff60) /* Fullwidth Forms */
1971 || (c >= 0xffe0 && c <= 0xffe6)
1972 || (c >= 0x20000 && c <= 0x2fffd)
1973 || (c >= 0x30000 && c <= 0x3fffd)))
1974 return 2;
1975
1976 return 1;
1977}
1978
1979/* Number of bytes used for encoding a UTF-8 character indexed by first byte.
1980 * Illegal bytes are set one. */
1981static const unsigned char utf8_bytes[256] = {
1982 1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1,
1983 1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1,
1984 1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1,
1985 1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1,
1986 1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1,
1987 1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1,
1988 2,2,2,2,2,2,2,2, 2,2,2,2,2,2,2,2, 2,2,2,2,2,2,2,2, 2,2,2,2,2,2,2,2,
1989 3,3,3,3,3,3,3,3, 3,3,3,3,3,3,3,3, 4,4,4,4,4,4,4,4, 5,5,5,5,6,6,1,1,
1990};
1991
1992/* Decode UTF-8 multi-byte representation into a unicode character. */
1993static inline unsigned long
1994utf8_to_unicode(const char *string, size_t length)
1995{
1996 unsigned long unicode;
1997
1998 switch (length) {
1999 case 1:
2000 unicode = string[0];
2001 break;
2002 case 2:
2003 unicode = (string[0] & 0x1f) << 6;
2004 unicode += (string[1] & 0x3f);
2005 break;
2006 case 3:
2007 unicode = (string[0] & 0x0f) << 12;
2008 unicode += ((string[1] & 0x3f) << 6);
2009 unicode += (string[2] & 0x3f);
2010 break;
2011 case 4:
2012 unicode = (string[0] & 0x0f) << 18;
2013 unicode += ((string[1] & 0x3f) << 12);
2014 unicode += ((string[2] & 0x3f) << 6);
2015 unicode += (string[3] & 0x3f);
2016 break;
2017 case 5:
2018 unicode = (string[0] & 0x0f) << 24;
2019 unicode += ((string[1] & 0x3f) << 18);
2020 unicode += ((string[2] & 0x3f) << 12);
2021 unicode += ((string[3] & 0x3f) << 6);
2022 unicode += (string[4] & 0x3f);
2023 break;
68b6e0eb 2024 case 6:
10e290ee
JF
2025 unicode = (string[0] & 0x01) << 30;
2026 unicode += ((string[1] & 0x3f) << 24);
2027 unicode += ((string[2] & 0x3f) << 18);
2028 unicode += ((string[3] & 0x3f) << 12);
2029 unicode += ((string[4] & 0x3f) << 6);
2030 unicode += (string[5] & 0x3f);
2031 break;
2032 default:
2033 die("Invalid unicode length");
2034 }
2035
2036 /* Invalid characters could return the special 0xfffd value but NUL
2037 * should be just as good. */
2038 return unicode > 0xffff ? 0 : unicode;
2039}
2040
2041/* Calculates how much of string can be shown within the given maximum width
2042 * and sets trimmed parameter to non-zero value if all of string could not be
2043 * shown.
2044 *
2045 * Additionally, adds to coloffset how many many columns to move to align with
2046 * the expected position. Takes into account how multi-byte and double-width
2047 * characters will effect the cursor position.
2048 *
2049 * Returns the number of bytes to output from string to satisfy max_width. */
2050static size_t
2051utf8_length(const char *string, size_t max_width, int *coloffset, int *trimmed)
2052{
2053 const char *start = string;
2054 const char *end = strchr(string, '\0');
2055 size_t mbwidth = 0;
2056 size_t width = 0;
2057
2058 *trimmed = 0;
2059
2060 while (string < end) {
2061 int c = *(unsigned char *) string;
2062 unsigned char bytes = utf8_bytes[c];
2063 size_t ucwidth;
2064 unsigned long unicode;
2065
2066 if (string + bytes > end)
2067 break;
2068
2069 /* Change representation to figure out whether
2070 * it is a single- or double-width character. */
2071
2072 unicode = utf8_to_unicode(string, bytes);
2073 /* FIXME: Graceful handling of invalid unicode character. */
2074 if (!unicode)
2075 break;
2076
2077 ucwidth = unicode_width(unicode);
2078 width += ucwidth;
2079 if (width > max_width) {
2080 *trimmed = 1;
2081 break;
2082 }
2083
2084 /* The column offset collects the differences between the
2085 * number of bytes encoding a character and the number of
2086 * columns will be used for rendering said character.
2087 *
2088 * So if some character A is encoded in 2 bytes, but will be
2089 * represented on the screen using only 1 byte this will and up
2090 * adding 1 to the multi-byte column offset.
2091 *
2092 * Assumes that no double-width character can be encoding in
2093 * less than two bytes. */
2094 if (bytes > ucwidth)
2095 mbwidth += bytes - ucwidth;
2096
2097 string += bytes;
2098 }
2099
2100 *coloffset += mbwidth;
2101
2102 return string - start;
2103}
2104
2105
2106/*
6b161b31
JF
2107 * Status management
2108 */
2e8488b4 2109
8855ada4 2110/* Whether or not the curses interface has been initialized. */
68b6e0eb 2111static bool cursed = FALSE;
8855ada4 2112
6b161b31
JF
2113/* The status window is used for polling keystrokes. */
2114static WINDOW *status_win;
4a2909a7 2115
2e8488b4 2116/* Update status and title window. */
4a2909a7
JF
2117static void
2118report(const char *msg, ...)
2119{
6706b2ba
JF
2120 static bool empty = TRUE;
2121 struct view *view = display[current_view];
b76c2afc 2122
6706b2ba
JF
2123 if (!empty || *msg) {
2124 va_list args;
4a2909a7 2125
6706b2ba 2126 va_start(args, msg);
4b76734f 2127
6706b2ba
JF
2128 werase(status_win);
2129 wmove(status_win, 0, 0);
2130 if (*msg) {
2131 vwprintw(status_win, msg, args);
2132 empty = FALSE;
2133 } else {
2134 empty = TRUE;
2135 }
2136 wrefresh(status_win);
b801d8b2 2137
6706b2ba
JF
2138 va_end(args);
2139 }
2140
2141 update_view_title(view);
2142
2143 /* Move the cursor to the right-most column of the cursor line.
2144 *
2145 * XXX: This could turn out to be a bit expensive, but it ensures that
2146 * the cursor does not jump around. */
2147 if (view->lines) {
2148 wmove(view->win, view->lineno - view->offset, view->width - 1);
2149 wrefresh(view->win);
2150 }
b801d8b2
JF
2151}
2152
6b161b31
JF
2153/* Controls when nodelay should be in effect when polling user input. */
2154static void
1ba2ae4b 2155set_nonblocking_input(bool loading)
b801d8b2 2156{
6706b2ba 2157 static unsigned int loading_views;
b801d8b2 2158
6706b2ba
JF
2159 if ((loading == FALSE && loading_views-- == 1) ||
2160 (loading == TRUE && loading_views++ == 0))
1ba2ae4b 2161 nodelay(status_win, loading);
6b161b31
JF
2162}
2163
2164static void
2165init_display(void)
2166{
2167 int x, y;
b76c2afc 2168
6908bdbd
JF
2169 /* Initialize the curses library */
2170 if (isatty(STDIN_FILENO)) {
8855ada4 2171 cursed = !!initscr();
6908bdbd
JF
2172 } else {
2173 /* Leave stdin and stdout alone when acting as a pager. */
2174 FILE *io = fopen("/dev/tty", "r+");
2175
8855ada4 2176 cursed = !!newterm(NULL, io, io);
6908bdbd
JF
2177 }
2178
8855ada4
JF
2179 if (!cursed)
2180 die("Failed to initialize curses");
2181
2e8488b4
JF
2182 nonl(); /* Tell curses not to do NL->CR/NL on output */
2183 cbreak(); /* Take input chars one at a time, no wait for \n */
2184 noecho(); /* Don't echo input */
b801d8b2 2185 leaveok(stdscr, TRUE);
b801d8b2
JF
2186
2187 if (has_colors())
2188 init_colors();
2189
2190 getmaxyx(stdscr, y, x);
2191 status_win = newwin(1, 0, y - 1, 0);
2192 if (!status_win)
2193 die("Failed to create status window");
2194
2195 /* Enable keyboard mapping */
2196 keypad(status_win, TRUE);
78c70acd 2197 wbkgdset(status_win, get_line_attr(LINE_STATUS));
6b161b31
JF
2198}
2199
c34d9c9f
JF
2200
2201/*
2202 * Repository references
2203 */
2204
2205static struct ref *refs;
3a91b75e 2206static size_t refs_size;
c34d9c9f
JF
2207
2208static struct ref **
2209get_refs(char *id)
2210{
2211 struct ref **id_refs = NULL;
2212 size_t id_refs_size = 0;
2213 size_t i;
2214
2215 for (i = 0; i < refs_size; i++) {
2216 struct ref **tmp;
2217
2218 if (strcmp(id, refs[i].id))
2219 continue;
2220
2221 tmp = realloc(id_refs, (id_refs_size + 1) * sizeof(*id_refs));
2222 if (!tmp) {
2223 if (id_refs)
2224 free(id_refs);
2225 return NULL;
2226 }
2227
2228 id_refs = tmp;
3af8774e 2229 if (id_refs_size > 0)
c34d9c9f 2230 id_refs[id_refs_size - 1]->next = 1;
3af8774e
JF
2231 id_refs[id_refs_size] = &refs[i];
2232
2233 /* XXX: The properties of the commit chains ensures that we can
2234 * safely modify the shared ref. The repo references will
2235 * always be similar for the same id. */
2236 id_refs[id_refs_size]->next = 0;
2237 id_refs_size++;
c34d9c9f
JF
2238 }
2239
2240 return id_refs;
2241}
2242
2243static int
2244load_refs(void)
2245{
4685845e
TH
2246 const char *cmd_env = getenv("TIG_LS_REMOTE");
2247 const char *cmd = cmd_env && *cmd_env ? cmd_env : TIG_LS_REMOTE;
c34d9c9f
JF
2248 FILE *pipe = popen(cmd, "r");
2249 char buffer[BUFSIZ];
2250 char *line;
2251
2252 if (!pipe)
2253 return ERR;
2254
2255 while ((line = fgets(buffer, sizeof(buffer), pipe))) {
2256 char *name = strchr(line, '\t');
2257 struct ref *ref;
2258 int namelen;
2259 bool tag = FALSE;
6734f6b9 2260 bool tag_commit = FALSE;
c34d9c9f
JF
2261
2262 if (!name)
2263 continue;
2264
2265 *name++ = 0;
2266 namelen = strlen(name) - 1;
6706b2ba
JF
2267
2268 /* Commits referenced by tags has "^{}" appended. */
c34d9c9f
JF
2269 if (name[namelen - 1] == '}') {
2270 while (namelen > 0 && name[namelen] != '^')
2271 namelen--;
6734f6b9
JF
2272 if (namelen > 0)
2273 tag_commit = TRUE;
c34d9c9f
JF
2274 }
2275 name[namelen] = 0;
2276
2277 if (!strncmp(name, "refs/tags/", STRING_SIZE("refs/tags/"))) {
6734f6b9
JF
2278 if (!tag_commit)
2279 continue;
c34d9c9f
JF
2280 name += STRING_SIZE("refs/tags/");
2281 tag = TRUE;
3af8774e
JF
2282
2283 } else if (!strncmp(name, "refs/heads/", STRING_SIZE("refs/heads/"))) {
2284 name += STRING_SIZE("refs/heads/");
2285
2286 } else if (!strcmp(name, "HEAD")) {
2287 continue;
c34d9c9f
JF
2288 }
2289
2290 refs = realloc(refs, sizeof(*refs) * (refs_size + 1));
2291 if (!refs)
2292 return ERR;
2293
2294 ref = &refs[refs_size++];
2295 ref->tag = tag;
2296 ref->name = strdup(name);
2297 if (!ref->name)
2298 return ERR;
2299
2300 string_copy(ref->id, line);
2301 }
2302
2303 if (ferror(pipe))
2304 return ERR;
2305
2306 pclose(pipe);
2307
1b4b0bd9
JF
2308 if (refs_size == 0)
2309 die("Not a git repository");
2310
c34d9c9f
JF
2311 return OK;
2312}
2313
6b161b31
JF
2314/*
2315 * Main
2316 */
2317
b5c9e67f
TH
2318#if __GNUC__ >= 3
2319#define __NORETURN __attribute__((__noreturn__))
2320#else
2321#define __NORETURN
2322#endif
2323
2324static void __NORETURN
6b161b31
JF
2325quit(int sig)
2326{
8855ada4
JF
2327 /* XXX: Restore tty modes and let the OS cleanup the rest! */
2328 if (cursed)
2329 endwin();
6b161b31
JF
2330 exit(0);
2331}
2332
c6704a4e
JF
2333static void __NORETURN
2334die(const char *err, ...)
6b161b31
JF
2335{
2336 va_list args;
2337
2338 endwin();
2339
2340 va_start(args, err);
2341 fputs("tig: ", stderr);
2342 vfprintf(stderr, err, args);
2343 fputs("\n", stderr);
2344 va_end(args);
2345
2346 exit(1);
2347}
2348
2349int
2350main(int argc, char *argv[])
2351{
1ba2ae4b 2352 struct view *view;
6b161b31 2353 enum request request;
1ba2ae4b 2354 size_t i;
6b161b31
JF
2355
2356 signal(SIGINT, quit);
2357
8855ada4 2358 if (!parse_options(argc, argv))
6b161b31
JF
2359 return 0;
2360
c34d9c9f
JF
2361 if (load_refs() == ERR)
2362 die("Failed to load refs.");
2363
1ba2ae4b
JF
2364 for (i = 0; i < ARRAY_SIZE(views) && (view = &views[i]); i++)
2365 view->cmd_env = getenv(view->cmd_env);
2366
6b161b31
JF
2367 request = opt_request;
2368
2369 init_display();
b801d8b2
JF
2370
2371 while (view_driver(display[current_view], request)) {
6b161b31 2372 int key;
b801d8b2
JF
2373 int i;
2374
6b161b31
JF
2375 foreach_view (view, i)
2376 update_view(view);
b801d8b2
JF
2377
2378 /* Refresh, accept single keystroke of input */
6b161b31
JF
2379 key = wgetch(status_win);
2380 request = get_request(key);
03a93dbb 2381
6706b2ba 2382 /* Some low-level request handling. This keeps access to
fac7db6c
JF
2383 * status_win restricted. */
2384 switch (request) {
2385 case REQ_PROMPT:
6908bdbd
JF
2386 report(":");
2387 /* Temporarily switch to line-oriented and echoed
2388 * input. */
03a93dbb
JF
2389 nocbreak();
2390 echo();
49f2b43f
JF
2391
2392 if (wgetnstr(status_win, opt_cmd + 4, sizeof(opt_cmd) - 4) == OK) {
2393 memcpy(opt_cmd, "git ", 4);
2394 opt_request = REQ_VIEW_PAGER;
2395 } else {
2396 request = ERR;
2397 }
2398
6908bdbd
JF
2399 noecho();
2400 cbreak();
fac7db6c
JF
2401 break;
2402
2403 case REQ_SCREEN_RESIZE:
2404 {
2405 int height, width;
2406
2407 getmaxyx(stdscr, height, width);
2408
2409 /* Resize the status view and let the view driver take
2410 * care of resizing the displayed views. */
2411 wresize(status_win, 1, width);
2412 mvwin(status_win, height - 1, 0);
2413 wrefresh(status_win);
2414 break;
2415 }
2416 default:
2417 break;
03a93dbb 2418 }
b801d8b2
JF
2419 }
2420
2421 quit(0);
2422
2423 return 0;
2424}
2425
2426/**
0721c53a 2427 * [[refspec]]
3a11b38f
JF
2428 * Revision specification
2429 * ----------------------
0721c53a 2430 * This section describes various ways to specify what revisions to display
3a11b38f
JF
2431 * or otherwise limit the view to. tig(1) does not itself parse the described
2432 * revision options so refer to the relevant git man pages for futher
2433 * information. Relevant man pages besides git-log(1) are git-diff(1) and
2434 * git-rev-list(1).
468876c9 2435 *
3a11b38f
JF
2436 * You can tune the interaction with git by making use of the options
2437 * explained in this section. For example, by configuring the environment
2438 * variables described in the <<view-commands, "View commands">> section.
2439 *
2440 * Limit by path name
2441 * ~~~~~~~~~~~~~~~~~~
ab46037d
JF
2442 * If you are interested only in those revisions that made changes to a
2443 * specific file (or even several files) list the files like this:
2444 *
c760e6ba 2445 * $ tig log Makefile README
ab46037d
JF
2446 *
2447 * To avoid ambiguity with repository references such as tag name, be sure
2448 * to separate file names from other git options using "\--". So if you
2449 * have a file named 'master' it will clash with the reference named
2450 * 'master', and thus you will have to use:
2451 *
1b4b0bd9 2452 * $ tig log -- master
ab46037d
JF
2453 *
2454 * NOTE: For the main view, avoiding ambiguity will in some cases require
2455 * you to specify two "\--" options. The first will make tig(1) stop
2456 * option processing and the latter will be passed to git log.
2457 *
468876c9
JF
2458 * Limit by date or number
2459 * ~~~~~~~~~~~~~~~~~~~~~~~
2460 * To speed up interaction with git, you can limit the amount of commits
2461 * to show both for the log and main view. Either limit by date using
2462 * e.g. `--since=1.month` or limit by the number of commits using `-n400`.
2463 *
3a11b38f
JF
2464 * If you are only interested in changed that happened between two dates
2465 * you can use:
2466 *
c760e6ba 2467 * $ tig -- --after="May 5th" --before="2006-05-16 15:44"
468876c9 2468 *
c760e6ba
JF
2469 * NOTE: If you want to avoid having to quote dates containing spaces you
2470 * can use "." instead, e.g. `--after=May.5th`.
3a11b38f
JF
2471 *
2472 * Limiting by commit ranges
2473 * ~~~~~~~~~~~~~~~~~~~~~~~~~
468876c9
JF
2474 * Alternatively, commits can be limited to a specific range, such as
2475 * "all commits between 'tag-1.0' and 'tag-2.0'". For example:
2476 *
2477 * $ tig log tag-1.0..tag-2.0
2478 *
2479 * This way of commit limiting makes it trivial to only browse the commits
2480 * which haven't been pushed to a remote branch. Assuming 'origin' is your
2481 * upstream remote branch, using:
2482 *
2483 * $ tig log origin..HEAD
2484 *
2485 * will list what will be pushed to the remote branch. Optionally, the ending
2486 * 'HEAD' can be left out since it is implied.
2487 *
2488 * Limiting by reachability
2489 * ~~~~~~~~~~~~~~~~~~~~~~~~
2490 * Git interprets the range specifier "tag-1.0..tag-2.0" as
2491 * "all commits reachable from 'tag-2.0' but not from 'tag-1.0'".
3a11b38f
JF
2492 * Where reachability refers to what commits are ancestors (or part of the
2493 * history) of the branch or tagged revision in question.
2494 *
468876c9
JF
2495 * If you prefer to specify which commit to preview in this way use the
2496 * following:
2497 *
2498 * $ tig log tag-2.0 ^tag-1.0
2499 *
57bdf034
JF
2500 * You can think of '^' as a negation operator. Using this alternate syntax,
2501 * it is possible to further prune commits by specifying multiple branch
2502 * cut offs.
468876c9 2503 *
3a11b38f
JF
2504 * Combining revisions specification
2505 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
2506 * Revisions options can to some degree be combined, which makes it possible
2507 * to say "show at most 20 commits from within the last month that changed
2508 * files under the Documentation/ directory."
2509 *
2510 * $ tig -- --since=1.month -n20 -- Documentation/
2511 *
2512 * Examining all repository references
2513 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
2514 * In some cases, it can be useful to query changes across all references
2515 * in a repository. An example is to ask "did any line of development in
2516 * this repository change a particular file within the last week". This
2517 * can be accomplished using:
2518 *
2519 * $ tig -- --all --since=1.week -- Makefile
2520 *
6706b2ba
JF
2521 * BUGS
2522 * ----
2523 * Known bugs and problems:
2524 *
10e290ee
JF
2525 * - In it's current state tig is pretty much UTF-8 only.
2526 *
6706b2ba 2527 * - If the screen width is very small the main view can draw
468876c9
JF
2528 * outside the current view causing bad wrapping. Same goes
2529 * for title and status windows.
6706b2ba 2530 *
4c6fabc2
JF
2531 * TODO
2532 * ----
2533 * Features that should be explored.
2534 *
fac7db6c 2535 * - Searching.
4c6fabc2
JF
2536 *
2537 * - Locale support.
2538 *
b801d8b2
JF
2539 * COPYRIGHT
2540 * ---------
4a2909a7 2541 * Copyright (c) Jonas Fonseca <fonseca@diku.dk>, 2006
b801d8b2
JF
2542 *
2543 * This program is free software; you can redistribute it and/or modify
2544 * it under the terms of the GNU General Public License as published by
2545 * the Free Software Foundation; either version 2 of the License, or
2546 * (at your option) any later version.
2547 *
2548 * SEE ALSO
2549 * --------
4c6fabc2 2550 * [verse]
b801d8b2
JF
2551 * link:http://www.kernel.org/pub/software/scm/git/docs/[git(7)],
2552 * link:http://www.kernel.org/pub/software/scm/cogito/docs/[cogito(7)]
4c6fabc2 2553 * gitk(1): git repository browser written using tcl/tk,
c6704a4e 2554 * qgit(1): git repository browser written using c++/Qt,
4c6fabc2 2555 * gitview(1): git repository browser written using python/gtk.
b801d8b2 2556 **/