help.c 4.68 KB
Newer Older
1 2 3 4 5 6 7 8 9
/*
 * builtin-help.c
 *
 * Builtin help-related commands (help, usage, version)
 */
#include "cache.h"
#include "builtin.h"
#include "exec_cmd.h"
#include "common-cmds.h"
10
#include <sys/ioctl.h>
11

12
/* most GUI terminals set COLUMNS (although some don't export it) */
13 14 15
static int term_columns(void)
{
	char *col_string = getenv("COLUMNS");
16
	int n_cols;
17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50

	if (col_string && (n_cols = atoi(col_string)) > 0)
		return n_cols;

#ifdef TIOCGWINSZ
	{
		struct winsize ws;
		if (!ioctl(1, TIOCGWINSZ, &ws)) {
			if (ws.ws_col)
				return ws.ws_col;
		}
	}
#endif

	return 80;
}

static inline void mput_char(char c, unsigned int num)
{
	while(num--)
		putchar(c);
}

static struct cmdname {
	size_t len;
	char name[1];
} **cmdname;
static int cmdname_alloc, cmdname_cnt;

static void add_cmdname(const char *name, int len)
{
	struct cmdname *ent;
	if (cmdname_alloc <= cmdname_cnt) {
		cmdname_alloc = cmdname_alloc + 200;
James Bowes's avatar
James Bowes committed
51
		cmdname = xrealloc(cmdname, cmdname_alloc * sizeof(*cmdname));
52
	}
53
	ent = xmalloc(sizeof(*ent) + len);
54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95
	ent->len = len;
	memcpy(ent->name, name, len);
	ent->name[len] = 0;
	cmdname[cmdname_cnt++] = ent;
}

static int cmdname_compare(const void *a_, const void *b_)
{
	struct cmdname *a = *(struct cmdname **)a_;
	struct cmdname *b = *(struct cmdname **)b_;
	return strcmp(a->name, b->name);
}

static void pretty_print_string_list(struct cmdname **cmdname, int longest)
{
	int cols = 1, rows;
	int space = longest + 1; /* min 1 SP between words */
	int max_cols = term_columns() - 1; /* don't print *on* the edge */
	int i, j;

	if (space < max_cols)
		cols = max_cols / space;
	rows = (cmdname_cnt + cols - 1) / cols;

	qsort(cmdname, cmdname_cnt, sizeof(*cmdname), cmdname_compare);

	for (i = 0; i < rows; i++) {
		printf("  ");

		for (j = 0; j < cols; j++) {
			int n = j * rows + i;
			int size = space;
			if (n >= cmdname_cnt)
				break;
			if (j == cols-1 || n + rows >= cmdname_cnt)
				size = 1;
			printf("%-*s", size, cmdname[n]->name);
		}
		putchar('\n');
	}
}

96
static void list_commands(const char *exec_path)
97 98 99
{
	unsigned int longest = 0;
	char path[PATH_MAX];
100 101
	const char *prefix = "git-";
	int prefix_len = strlen(prefix);
102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124
	int dirlen;
	DIR *dir = opendir(exec_path);
	struct dirent *de;

	if (!dir) {
		fprintf(stderr, "git: '%s': %s\n", exec_path, strerror(errno));
		exit(1);
	}

	dirlen = strlen(exec_path);
	if (PATH_MAX - 20 < dirlen) {
		fprintf(stderr, "git: insanely long exec-path '%s'\n",
			exec_path);
		exit(1);
	}

	memcpy(path, exec_path, dirlen);
	path[dirlen++] = '/';

	while ((de = readdir(dir)) != NULL) {
		struct stat st;
		int entlen;

125
		if (prefixcmp(de->d_name, prefix))
126 127 128 129 130 131 132
			continue;
		strcpy(path+dirlen, de->d_name);
		if (stat(path, &st) || /* stat, not lstat */
		    !S_ISREG(st.st_mode) ||
		    !(st.st_mode & S_IXUSR))
			continue;

133
		entlen = strlen(de->d_name) - prefix_len;
134
		if (has_extension(de->d_name, ".exe"))
135 136 137 138 139
			entlen -= 4;

		if (longest < entlen)
			longest = entlen;

140
		add_cmdname(de->d_name + prefix_len, entlen);
141 142 143 144 145 146 147
	}
	closedir(dir);

	printf("git commands available in '%s'\n", exec_path);
	printf("----------------------------");
	mput_char('-', strlen(exec_path));
	putchar('\n');
148
	pretty_print_string_list(cmdname, longest);
149 150 151
	putchar('\n');
}

152
void list_common_cmds_help(void)
153 154 155 156 157 158 159 160 161 162
{
	int i, longest = 0;

	for (i = 0; i < ARRAY_SIZE(common_cmds); i++) {
		if (longest < strlen(common_cmds[i].name))
			longest = strlen(common_cmds[i].name);
	}

	puts("The most commonly used git commands are:");
	for (i = 0; i < ARRAY_SIZE(common_cmds); i++) {
163 164
		printf("   %s   ", common_cmds[i].name);
		mput_char(' ', longest - strlen(common_cmds[i].name));
165 166 167 168 169 170 171 172 173
		puts(common_cmds[i].help);
	}
	puts("(use 'git help -a' to get a list of all installed git commands)");
}

static void show_man_page(const char *git_cmd)
{
	const char *page;

174
	if (!prefixcmp(git_cmd, "git"))
175 176 177
		page = git_cmd;
	else {
		int page_len = strlen(git_cmd) + 4;
178
		char *p = xmalloc(page_len + 1);
179 180 181 182 183 184 185 186 187
		strcpy(p, "git-");
		strcpy(p + 4, git_cmd);
		p[page_len] = 0;
		page = p;
	}

	execlp("man", "man", page, NULL);
}

188 189
void help_unknown_cmd(const char *cmd)
{
190
	fprintf(stderr, "git: '%s' is not a git-command. See 'git --help'.\n", cmd);
191 192 193
	exit(1);
}

194
int cmd_version(int argc, const char **argv, const char *prefix)
195 196 197 198 199
{
	printf("git version %s\n", git_version_string);
	return 0;
}

200
int cmd_help(int argc, const char **argv, const char *prefix)
201
{
202
	const char *help_cmd = argc > 1 ? argv[1] : NULL;
203 204 205 206 207
	const char *exec_path = git_exec_path();

	if (!help_cmd) {
		printf("usage: %s\n\n", git_usage_string);
		list_common_cmds_help();
208
		exit(0);
209 210 211 212 213
	}

	else if (!strcmp(help_cmd, "--all") || !strcmp(help_cmd, "-a")) {
		printf("usage: %s\n\n", git_usage_string);
		if(exec_path)
214
			list_commands(exec_path);
215
		exit(0);
216 217
	}

218 219
	else
		show_man_page(help_cmd);
220

221 222
	return 0;
}