manbook 0.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/.document +5 -0
- data/Gemfile +15 -0
- data/Gemfile.lock +25 -0
- data/LICENSE.txt +20 -0
- data/README.md +105 -0
- data/Rakefile +46 -0
- data/TODO +2 -0
- data/VERSION +1 -0
- data/bin/manbook +89 -0
- data/bin/mktoc +157 -0
- data/lib/manbook.rb +30 -0
- data/lib/manbook/errors.rb +22 -0
- data/lib/manbook/formatter.rb +27 -0
- data/lib/manbook/html_formatter.rb +17 -0
- data/lib/manbook/log_formatter.rb +9 -0
- data/lib/manbook/parser.rb +32 -0
- data/templates/_page.html.erb +1 -0
- data/templates/about.html.erb +6 -0
- data/templates/application.html.erb +23 -0
- data/templates/index.html.erb +4 -0
- data/templates/library_books.jpg +0 -0
- data/templates/manbook.ncx.erb +28 -0
- data/templates/manbook.opf.erb +35 -0
- data/test/fixtures/bash.html +11352 -0
- data/test/fixtures/cat.html +195 -0
- data/test/fixtures/git.html +1882 -0
- data/test/fixtures/gunzip.html +595 -0
- data/test/fixtures/less.html +3554 -0
- data/test/fixtures/ls.html +818 -0
- data/test/fixtures/man.html +649 -0
- data/test/helper.rb +42 -0
- data/test/unit/test_manbook.rb +39 -0
- data/test/unit/test_mktoc.rb +215 -0
- metadata +189 -0
@@ -0,0 +1,195 @@
|
|
1
|
+
<!-- Creator : groff version 1.19.2 -->
|
2
|
+
<!-- CreationDate: Tue Nov 29 21:01:36 2011 -->
|
3
|
+
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
|
4
|
+
"http://www.w3.org/TR/html4/loose.dtd">
|
5
|
+
<html>
|
6
|
+
<head>
|
7
|
+
<meta name="generator" content="groff -Thtml, see www.gnu.org">
|
8
|
+
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
|
9
|
+
<meta name="Content-Style" content="text/css">
|
10
|
+
<style type="text/css">
|
11
|
+
p { margin-top: 0; margin-bottom: 0; }
|
12
|
+
pre { margin-top: 0; margin-bottom: 0; }
|
13
|
+
table { margin-top: 0; margin-bottom: 0; }
|
14
|
+
</style>
|
15
|
+
<title></title>
|
16
|
+
</head>
|
17
|
+
<body>
|
18
|
+
|
19
|
+
<hr>
|
20
|
+
|
21
|
+
|
22
|
+
<p valign="top">CAT(1) BSD General Commands Manual
|
23
|
+
CAT(1)</p>
|
24
|
+
|
25
|
+
<p style="margin-top: 1em" valign="top"><b>NAME</b></p>
|
26
|
+
|
27
|
+
<p style="margin-left:8%;"><b>cat</b> — concatenate
|
28
|
+
and print files</p>
|
29
|
+
|
30
|
+
|
31
|
+
<p style="margin-top: 1em" valign="top"><b>SYNOPSIS</b></p>
|
32
|
+
|
33
|
+
<p style="margin-left:14%;"><b>cat</b>
|
34
|
+
[<b>−benstuv</b>] [<i>file ...</i>]</p>
|
35
|
+
|
36
|
+
|
37
|
+
<p style="margin-top: 1em" valign="top"><b>DESCRIPTION</b></p>
|
38
|
+
|
39
|
+
<p style="margin-left:8%;">The <b>cat</b> utility reads
|
40
|
+
files sequentially, writing them to the standard output. The
|
41
|
+
<i>file</i> operands are processed in command-line order. If
|
42
|
+
<i>file</i> is a single dash (‘-’) or absent,
|
43
|
+
<b>cat</b> reads from the standard input. If <i>file</i> is
|
44
|
+
a UNIX domain socket, <b>cat</b> connects to it and then
|
45
|
+
reads it until EOF. This complements the UNIX domain binding
|
46
|
+
capability available in inetd(8).</p>
|
47
|
+
|
48
|
+
<p style="margin-left:8%; margin-top: 1em">The options are
|
49
|
+
as follows:</p>
|
50
|
+
|
51
|
+
|
52
|
+
<p style="margin-top: 1em" valign="top"><b>−b</b></p>
|
53
|
+
|
54
|
+
<p style="margin-left:20%; margin-top: 1em">Number the
|
55
|
+
non-blank output lines, starting at 1.</p>
|
56
|
+
|
57
|
+
|
58
|
+
<p style="margin-top: 1em" valign="top"><b>−e</b></p>
|
59
|
+
|
60
|
+
<p style="margin-left:20%; margin-top: 1em">Display
|
61
|
+
non-printing characters (see the <b>−v</b> option),
|
62
|
+
and display a dollar sign (‘$’) at the end of
|
63
|
+
each line.</p>
|
64
|
+
|
65
|
+
|
66
|
+
<p style="margin-top: 1em" valign="top"><b>−n</b></p>
|
67
|
+
|
68
|
+
<p style="margin-left:20%; margin-top: 1em">Number the
|
69
|
+
output lines, starting at 1.</p>
|
70
|
+
|
71
|
+
|
72
|
+
<p style="margin-top: 1em" valign="top"><b>−s</b></p>
|
73
|
+
|
74
|
+
<p style="margin-left:20%; margin-top: 1em">Squeeze
|
75
|
+
multiple adjacent empty lines, causing the output to be
|
76
|
+
single spaced.</p>
|
77
|
+
|
78
|
+
|
79
|
+
<p style="margin-top: 1em" valign="top"><b>−t</b></p>
|
80
|
+
|
81
|
+
<p style="margin-left:20%; margin-top: 1em">Display
|
82
|
+
non-printing characters (see the <b>−v</b> option),
|
83
|
+
and display tab characters as ‘^I’.</p>
|
84
|
+
|
85
|
+
|
86
|
+
<p style="margin-top: 1em" valign="top"><b>−u</b></p>
|
87
|
+
|
88
|
+
<p style="margin-left:20%; margin-top: 1em">Disable output
|
89
|
+
buffering.</p>
|
90
|
+
|
91
|
+
|
92
|
+
<p style="margin-top: 1em" valign="top"><b>−v</b></p>
|
93
|
+
|
94
|
+
<p style="margin-left:20%; margin-top: 1em">Display
|
95
|
+
non-printing characters so they are visible. Control
|
96
|
+
characters print as ‘^X’ for control-X; the
|
97
|
+
delete character (octal 0177) prints as ‘^?’.
|
98
|
+
Non-ASCII characters (with the high bit set) are printed as
|
99
|
+
‘M-’ (for meta) followed by the character for
|
100
|
+
the low 7 bits.</p>
|
101
|
+
|
102
|
+
<p style="margin-top: 1em" valign="top"><b>EXIT
|
103
|
+
STATUS</b></p>
|
104
|
+
|
105
|
+
<p style="margin-left:8%;">The <b>cat</b> utility
|
106
|
+
exits 0 on success, and >0 if an error
|
107
|
+
occurs.</p>
|
108
|
+
|
109
|
+
|
110
|
+
<p style="margin-top: 1em" valign="top"><b>EXAMPLES</b></p>
|
111
|
+
|
112
|
+
<p style="margin-left:8%;">The command:</p>
|
113
|
+
|
114
|
+
<p style="margin-left:17%; margin-top: 1em">cat file1</p>
|
115
|
+
|
116
|
+
<p style="margin-left:8%; margin-top: 1em">will print the
|
117
|
+
contents of <i>file1</i> to the standard output.</p>
|
118
|
+
|
119
|
+
<p style="margin-left:8%; margin-top: 1em">The command:</p>
|
120
|
+
|
121
|
+
<p style="margin-left:17%; margin-top: 1em">cat file1 file2
|
122
|
+
> file3</p>
|
123
|
+
|
124
|
+
<p style="margin-left:8%; margin-top: 1em">will
|
125
|
+
sequentially print the contents of <i>file1</i> and
|
126
|
+
<i>file2</i> to the file <i>file3</i>, truncating
|
127
|
+
<i>file3</i> if it already exists. See the manual page for
|
128
|
+
your shell (i.e., sh(1)) for more information on
|
129
|
+
redirection.</p>
|
130
|
+
|
131
|
+
<p style="margin-left:8%; margin-top: 1em">The command:</p>
|
132
|
+
|
133
|
+
<p style="margin-left:17%; margin-top: 1em">cat file1 -
|
134
|
+
file2 - file3</p>
|
135
|
+
|
136
|
+
<p style="margin-left:8%; margin-top: 1em">will print the
|
137
|
+
contents of <i>file1</i>, print data it receives from the
|
138
|
+
standard input until it receives an EOF (‘^D’)
|
139
|
+
character, print the contents of <i>file2</i>, read and
|
140
|
+
output contents of the standard input again, then finally
|
141
|
+
output the contents of <i>file3</i>. Note that if the
|
142
|
+
standard input referred to a file, the second dash on the
|
143
|
+
command-line would have no effect, since the entire contents
|
144
|
+
of the file would have already been read and printed by
|
145
|
+
<b>cat</b> when it encountered the first ‘-’
|
146
|
+
operand.</p>
|
147
|
+
|
148
|
+
<p style="margin-top: 1em" valign="top"><b>SEE ALSO</b></p>
|
149
|
+
|
150
|
+
<p style="margin-left:8%;">head(1), more(1), pr(1), sh(1),
|
151
|
+
tail(1), vis(1), zcat(1), setbuf(3)</p>
|
152
|
+
|
153
|
+
<p style="margin-top: 1em" valign="top">Rob Pike</p>
|
154
|
+
|
155
|
+
<p style="margin-left:8%;">, "</p>
|
156
|
+
|
157
|
+
<p valign="top">UNIX Style, or cat -v Considered Harmful
|
158
|
+
", <i><br>
|
159
|
+
USENIX Summer Conference Proceedings</i> , <br>
|
160
|
+
1983 .</p>
|
161
|
+
|
162
|
+
|
163
|
+
<p style="margin-top: 1em" valign="top"><b>STANDARDS</b></p>
|
164
|
+
|
165
|
+
<p style="margin-left:8%;">The <b>cat</b> utility is
|
166
|
+
compliant with the IEEE Std 1003.2-1992
|
167
|
+
(‘‘POSIX.2’’) specification.</p>
|
168
|
+
|
169
|
+
<p style="margin-left:8%; margin-top: 1em">The flags
|
170
|
+
[<b>−benstv</b>] are extensions to the
|
171
|
+
specification.</p>
|
172
|
+
|
173
|
+
<p style="margin-top: 1em" valign="top"><b>HISTORY</b></p>
|
174
|
+
|
175
|
+
<p style="margin-left:8%;">A <b>cat</b> utility appeared in
|
176
|
+
Version 1 AT&T UNIX. Dennis Ritchie designed and
|
177
|
+
wrote the first man page. It appears to have been
|
178
|
+
cat(1).</p>
|
179
|
+
|
180
|
+
<p style="margin-top: 1em" valign="top"><b>BUGS</b></p>
|
181
|
+
|
182
|
+
<p style="margin-left:8%;">Because of the shell language
|
183
|
+
mechanism used to perform output redirection, the command
|
184
|
+
‘‘cat file1 file2 > file1’’ will
|
185
|
+
cause the original data in file1 to be destroyed!</p>
|
186
|
+
|
187
|
+
<p style="margin-left:8%; margin-top: 1em">The <b>cat</b>
|
188
|
+
utility does not recognize multibyte characters when the
|
189
|
+
<b>−t</b> or <b>−v</b> option is in effect.</p>
|
190
|
+
|
191
|
+
<p style="margin-left:8%; margin-top: 1em">BSD
|
192
|
+
March 21, 2004 BSD</p>
|
193
|
+
<hr>
|
194
|
+
</body>
|
195
|
+
</html>
|
@@ -0,0 +1,1882 @@
|
|
1
|
+
<!-- Creator : groff version 1.19.2 -->
|
2
|
+
<!-- CreationDate: Tue Nov 29 21:01:36 2011 -->
|
3
|
+
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
|
4
|
+
"http://www.w3.org/TR/html4/loose.dtd">
|
5
|
+
<html>
|
6
|
+
<head>
|
7
|
+
<meta name="generator" content="groff -Thtml, see www.gnu.org">
|
8
|
+
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
|
9
|
+
<meta name="Content-Style" content="text/css">
|
10
|
+
<style type="text/css">
|
11
|
+
p { margin-top: 0; margin-bottom: 0; }
|
12
|
+
pre { margin-top: 0; margin-bottom: 0; }
|
13
|
+
table { margin-top: 0; margin-bottom: 0; }
|
14
|
+
</style>
|
15
|
+
<title>GIT</title>
|
16
|
+
|
17
|
+
</head>
|
18
|
+
<body>
|
19
|
+
|
20
|
+
<h1 align=center>GIT</h1>
|
21
|
+
|
22
|
+
<a href="#NAME">NAME</a><br>
|
23
|
+
<a href="#SYNOPSIS">SYNOPSIS</a><br>
|
24
|
+
<a href="#DESCRIPTION">DESCRIPTION</a><br>
|
25
|
+
<a href="#OPTIONS">OPTIONS</a><br>
|
26
|
+
<a href="#FURTHER DOCUMENTATION">FURTHER DOCUMENTATION</a><br>
|
27
|
+
<a href="#GIT COMMANDS">GIT COMMANDS</a><br>
|
28
|
+
<a href="#HIGH-LEVEL COMMANDS (PORCELAIN)">HIGH-LEVEL COMMANDS (PORCELAIN)</a><br>
|
29
|
+
<a href="#LOW-LEVEL COMMANDS (PLUMBING)">LOW-LEVEL COMMANDS (PLUMBING)</a><br>
|
30
|
+
<a href="#CONFIGURATION MECHANISM">CONFIGURATION MECHANISM</a><br>
|
31
|
+
<a href="#IDENTIFIER TERMINOLOGY">IDENTIFIER TERMINOLOGY</a><br>
|
32
|
+
<a href="#SYMBOLIC IDENTIFIERS">SYMBOLIC IDENTIFIERS</a><br>
|
33
|
+
<a href="#FILE/DIRECTORY STRUCTURE">FILE/DIRECTORY STRUCTURE</a><br>
|
34
|
+
<a href="#TERMINOLOGY">TERMINOLOGY</a><br>
|
35
|
+
<a href="#ENVIRONMENT VARIABLES">ENVIRONMENT VARIABLES</a><br>
|
36
|
+
<a href="#DISCUSSION">DISCUSSION</a><br>
|
37
|
+
<a href="#AUTHORS">AUTHORS</a><br>
|
38
|
+
<a href="#REPORTING BUGS">REPORTING BUGS</a><br>
|
39
|
+
<a href="#SEE ALSO">SEE ALSO</a><br>
|
40
|
+
<a href="#GIT">GIT</a><br>
|
41
|
+
<a href="#NOTES">NOTES</a><br>
|
42
|
+
|
43
|
+
<hr>
|
44
|
+
|
45
|
+
|
46
|
+
<a name="NAME"></a>
|
47
|
+
<h2>NAME</h2>
|
48
|
+
|
49
|
+
|
50
|
+
<p style="margin-left:11%; margin-top: 1em">git − the
|
51
|
+
stupid content tracker</p>
|
52
|
+
|
53
|
+
<a name="SYNOPSIS"></a>
|
54
|
+
<h2>SYNOPSIS</h2>
|
55
|
+
|
56
|
+
|
57
|
+
<p style="margin-left:11%; margin-top: 1em"><i>git</i>
|
58
|
+
[−−version]
|
59
|
+
[−−exec−path[=<path>]]
|
60
|
+
[−−html−path]
|
61
|
+
[−−man−path]
|
62
|
+
[−−info−path] <br>
|
63
|
+
|
64
|
+
[−p|−−paginate|−−no−pager]
|
65
|
+
[−−no−replace−objects] <br>
|
66
|
+
[−−bare]
|
67
|
+
[−−git−dir=<path>]
|
68
|
+
[−−work−tree=<path>] <br>
|
69
|
+
[−c <name>=<value>] <br>
|
70
|
+
[−−help] <command> [<args>]</p>
|
71
|
+
|
72
|
+
<a name="DESCRIPTION"></a>
|
73
|
+
<h2>DESCRIPTION</h2>
|
74
|
+
|
75
|
+
|
76
|
+
<p style="margin-left:11%; margin-top: 1em">Git is a fast,
|
77
|
+
scalable, distributed revision control system with an
|
78
|
+
unusually rich command set that provides both
|
79
|
+
high−level operations and full access to
|
80
|
+
internals.</p>
|
81
|
+
|
82
|
+
<p style="margin-left:11%; margin-top: 1em">See
|
83
|
+
<b>gittutorial</b>(7) to get started, then see
|
84
|
+
<b><font color="#0000FF">Everyday Git</font></b>
|
85
|
+
<small><font color="#000000">[1]</font></small>
|
86
|
+
<font color="#000000">for a useful minimum set of commands,
|
87
|
+
and "man git−commandname" for documentation
|
88
|
+
of each command. CVS users may also want to read
|
89
|
+
<b>gitcvs-migration</b>(7). See the</font>
|
90
|
+
<b><font color="#0000FF">Git User’s Manual</font></b>
|
91
|
+
<small><font color="#000000">[2]</font></small>
|
92
|
+
<font color="#000000">for a more in−depth
|
93
|
+
introduction.</font></p>
|
94
|
+
|
95
|
+
|
96
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">The
|
97
|
+
<i><command></i> is either a name of a Git command
|
98
|
+
(see below) or an alias as defined in the configuration file
|
99
|
+
(see <b>git-config</b>(1)).</font></p>
|
100
|
+
|
101
|
+
|
102
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">Formatted
|
103
|
+
and hyperlinked version of the latest git documentation can
|
104
|
+
be viewed at
|
105
|
+
http://www.kernel.org/pub/software/scm/git/docs/.</font></p>
|
106
|
+
|
107
|
+
<a name="OPTIONS"></a>
|
108
|
+
<h2>OPTIONS</h2>
|
109
|
+
|
110
|
+
|
111
|
+
|
112
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">−−version</font></p>
|
113
|
+
|
114
|
+
<p style="margin-left:17%;"><font color="#000000">Prints
|
115
|
+
the git suite version that the <i>git</i> program came
|
116
|
+
from.</font></p>
|
117
|
+
|
118
|
+
|
119
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">−−help</font></p>
|
120
|
+
|
121
|
+
<p style="margin-left:17%;"><font color="#000000">Prints
|
122
|
+
the synopsis and a list of the most commonly used commands.
|
123
|
+
If the option <i>−−all</i> or <i>−a</i> is
|
124
|
+
given then all available commands are printed. If a git
|
125
|
+
command is named this option will bring up the manual page
|
126
|
+
for that command.</font></p>
|
127
|
+
|
128
|
+
|
129
|
+
<p style="margin-left:17%; margin-top: 1em"><font color="#000000">Other
|
130
|
+
options are available to control how the manual page is
|
131
|
+
displayed. See <b>git-help</b>(1) for more information,
|
132
|
+
because git −−help ... is converted internally
|
133
|
+
into git help ....</font></p>
|
134
|
+
|
135
|
+
|
136
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">−c
|
137
|
+
<name>=<value></font></p>
|
138
|
+
|
139
|
+
<p style="margin-left:17%;"><font color="#000000">Pass a
|
140
|
+
configuration parameter to the command. The value given will
|
141
|
+
override values from configuration files. The <name>
|
142
|
+
is expected in the same format as listed by <i>git
|
143
|
+
config</i> (subkeys separated by dots).</font></p>
|
144
|
+
|
145
|
+
|
146
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">−−exec−path[=<path>]</font></p>
|
147
|
+
|
148
|
+
<p style="margin-left:17%;"><font color="#000000">Path to
|
149
|
+
wherever your core git programs are installed. This can also
|
150
|
+
be controlled by setting the GIT_EXEC_PATH environment
|
151
|
+
variable. If no path is given, <i>git</i> will print the
|
152
|
+
current setting and then exit.</font></p>
|
153
|
+
|
154
|
+
|
155
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">−−html−path</font></p>
|
156
|
+
|
157
|
+
<p style="margin-left:17%;"><font color="#000000">Print the
|
158
|
+
path, without trailing slash, where git’s HTML
|
159
|
+
documentation is installed and exit.</font></p>
|
160
|
+
|
161
|
+
|
162
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">−−man−path</font></p>
|
163
|
+
|
164
|
+
<p style="margin-left:17%;"><font color="#000000">Print the
|
165
|
+
manpath (see man(1)) for the man pages for this version of
|
166
|
+
git and exit.</font></p>
|
167
|
+
|
168
|
+
|
169
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">−−info−path</font></p>
|
170
|
+
|
171
|
+
<p style="margin-left:17%;"><font color="#000000">Print the
|
172
|
+
path where the Info files documenting this version of git
|
173
|
+
are installed and exit.</font></p>
|
174
|
+
|
175
|
+
|
176
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">−p,
|
177
|
+
−−paginate</font></p>
|
178
|
+
|
179
|
+
<p style="margin-left:17%;"><font color="#000000">Pipe all
|
180
|
+
output into <i>less</i> (or if set, $PAGER) if standard
|
181
|
+
output is a terminal. This overrides the pager.<cmd>
|
182
|
+
configuration options (see the "Configuration
|
183
|
+
Mechanism" section below).</font></p>
|
184
|
+
|
185
|
+
|
186
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">−−no−pager</font></p>
|
187
|
+
|
188
|
+
<p style="margin-left:17%;"><font color="#000000">Do not
|
189
|
+
pipe git output into a pager.</font></p>
|
190
|
+
|
191
|
+
|
192
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">−−git−dir=<path></font></p>
|
193
|
+
|
194
|
+
<p style="margin-left:17%;"><font color="#000000">Set the
|
195
|
+
path to the repository. This can also be controlled by
|
196
|
+
setting the GIT_DIR environment variable. It can be an
|
197
|
+
absolute path or relative path to current working
|
198
|
+
directory.</font></p>
|
199
|
+
|
200
|
+
|
201
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">−−work−tree=<path></font></p>
|
202
|
+
|
203
|
+
<p style="margin-left:17%;"><font color="#000000">Set the
|
204
|
+
path to the working tree. It can be an absolute path or a
|
205
|
+
path relative to the current working directory. This can
|
206
|
+
also be controlled by setting the GIT_WORK_TREE environment
|
207
|
+
variable and the core.worktree configuration variable (see
|
208
|
+
core.worktree in <b>git-config</b>(1) for a more detailed
|
209
|
+
discussion).</font></p>
|
210
|
+
|
211
|
+
|
212
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">−−bare</font></p>
|
213
|
+
|
214
|
+
<p style="margin-left:17%;"><font color="#000000">Treat the
|
215
|
+
repository as a bare repository. If GIT_DIR environment is
|
216
|
+
not set, it is set to the current working
|
217
|
+
directory.</font></p>
|
218
|
+
|
219
|
+
|
220
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">−−no−replace−objects</font></p>
|
221
|
+
|
222
|
+
<p style="margin-left:17%;"><font color="#000000">Do not
|
223
|
+
use replacement refs to replace git objects. See
|
224
|
+
<b>git-replace</b>(1) for more information.</font></p>
|
225
|
+
|
226
|
+
<a name="FURTHER DOCUMENTATION"></a>
|
227
|
+
<h2>FURTHER DOCUMENTATION</h2>
|
228
|
+
|
229
|
+
|
230
|
+
|
231
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">See
|
232
|
+
the references above to get started using git. The following
|
233
|
+
is probably more detail than necessary for a
|
234
|
+
first−time user.</font></p>
|
235
|
+
|
236
|
+
|
237
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">The</font>
|
238
|
+
<b><font color="#0000FF">git concepts chapter of the
|
239
|
+
user−manual</font></b>
|
240
|
+
<small><font color="#000000">[3]</font></small>
|
241
|
+
<font color="#000000">and <b>gitcore-tutorial</b>(7) both
|
242
|
+
provide introductions to the underlying git
|
243
|
+
architecture.</font></p>
|
244
|
+
|
245
|
+
|
246
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">See
|
247
|
+
<b>gitworkflows</b>(7) for an overview of recommended
|
248
|
+
workflows.</font></p>
|
249
|
+
|
250
|
+
|
251
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">See
|
252
|
+
also the</font> <b><font color="#0000FF">howto</font></b>
|
253
|
+
<small><font color="#000000">[4]</font></small>
|
254
|
+
<font color="#000000">documents for some useful
|
255
|
+
examples.</font></p>
|
256
|
+
|
257
|
+
|
258
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">The
|
259
|
+
internals are documented in the</font>
|
260
|
+
<b><font color="#0000FF">GIT API documentation</font></b>
|
261
|
+
<small><font color="#000000">[5]</font></small>
|
262
|
+
<font color="#000000">.</font></p>
|
263
|
+
|
264
|
+
<a name="GIT COMMANDS"></a>
|
265
|
+
<h2>GIT COMMANDS</h2>
|
266
|
+
|
267
|
+
|
268
|
+
|
269
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">We
|
270
|
+
divide git into high level ("porcelain") commands
|
271
|
+
and low level ("plumbing") commands.</font></p>
|
272
|
+
|
273
|
+
<a name="HIGH-LEVEL COMMANDS (PORCELAIN)"></a>
|
274
|
+
<h2>HIGH-LEVEL COMMANDS (PORCELAIN)</h2>
|
275
|
+
|
276
|
+
|
277
|
+
|
278
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">We
|
279
|
+
separate the porcelain commands into the main commands and
|
280
|
+
some ancillary user utilities.</font></p>
|
281
|
+
|
282
|
+
|
283
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>Main
|
284
|
+
porcelain commands <br>
|
285
|
+
git-add</b>(1)</font></p>
|
286
|
+
|
287
|
+
<p style="margin-left:17%;"><font color="#000000">Add file
|
288
|
+
contents to the index.</font></p>
|
289
|
+
|
290
|
+
|
291
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-am</b>(1)</font></p>
|
292
|
+
|
293
|
+
<p style="margin-left:17%;"><font color="#000000">Apply a
|
294
|
+
series of patches from a mailbox.</font></p>
|
295
|
+
|
296
|
+
|
297
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-archive</b>(1)</font></p>
|
298
|
+
|
299
|
+
<p style="margin-left:17%;"><font color="#000000">Create an
|
300
|
+
archive of files from a named tree.</font></p>
|
301
|
+
|
302
|
+
|
303
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-bisect</b>(1)</font></p>
|
304
|
+
|
305
|
+
<p style="margin-left:17%;"><font color="#000000">Find by
|
306
|
+
binary search the change that introduced a bug.</font></p>
|
307
|
+
|
308
|
+
|
309
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-branch</b>(1)</font></p>
|
310
|
+
|
311
|
+
<p style="margin-left:17%;"><font color="#000000">List,
|
312
|
+
create, or delete branches.</font></p>
|
313
|
+
|
314
|
+
|
315
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-bundle</b>(1)</font></p>
|
316
|
+
|
317
|
+
<p style="margin-left:17%;"><font color="#000000">Move
|
318
|
+
objects and refs by archive.</font></p>
|
319
|
+
|
320
|
+
|
321
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-checkout</b>(1)</font></p>
|
322
|
+
|
323
|
+
<p style="margin-left:17%;"><font color="#000000">Checkout
|
324
|
+
a branch or paths to the working tree.</font></p>
|
325
|
+
|
326
|
+
|
327
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-cherry-pick</b>(1)</font></p>
|
328
|
+
|
329
|
+
<p style="margin-left:17%;"><font color="#000000">Apply the
|
330
|
+
changes introduced by some existing commits.</font></p>
|
331
|
+
|
332
|
+
|
333
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-citool</b>(1)</font></p>
|
334
|
+
|
335
|
+
|
336
|
+
<p style="margin-left:17%;"><font color="#000000">Graphical
|
337
|
+
alternative to git−commit.</font></p>
|
338
|
+
|
339
|
+
|
340
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-clean</b>(1)</font></p>
|
341
|
+
|
342
|
+
<p style="margin-left:17%;"><font color="#000000">Remove
|
343
|
+
untracked files from the working tree.</font></p>
|
344
|
+
|
345
|
+
|
346
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-clone</b>(1)</font></p>
|
347
|
+
|
348
|
+
<p style="margin-left:17%;"><font color="#000000">Clone a
|
349
|
+
repository into a new directory.</font></p>
|
350
|
+
|
351
|
+
|
352
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-commit</b>(1)</font></p>
|
353
|
+
|
354
|
+
<p style="margin-left:17%;"><font color="#000000">Record
|
355
|
+
changes to the repository.</font></p>
|
356
|
+
|
357
|
+
|
358
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-describe</b>(1)</font></p>
|
359
|
+
|
360
|
+
<p style="margin-left:17%;"><font color="#000000">Show the
|
361
|
+
most recent tag that is reachable from a commit.</font></p>
|
362
|
+
|
363
|
+
|
364
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-diff</b>(1)</font></p>
|
365
|
+
|
366
|
+
<p style="margin-left:17%;"><font color="#000000">Show
|
367
|
+
changes between commits, commit and working tree,
|
368
|
+
etc.</font></p>
|
369
|
+
|
370
|
+
|
371
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-fetch</b>(1)</font></p>
|
372
|
+
|
373
|
+
<p style="margin-left:17%;"><font color="#000000">Download
|
374
|
+
objects and refs from another repository.</font></p>
|
375
|
+
|
376
|
+
|
377
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-format-patch</b>(1)</font></p>
|
378
|
+
|
379
|
+
<p style="margin-left:17%;"><font color="#000000">Prepare
|
380
|
+
patches for e−mail submission.</font></p>
|
381
|
+
|
382
|
+
|
383
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-gc</b>(1)</font></p>
|
384
|
+
|
385
|
+
<p style="margin-left:17%;"><font color="#000000">Cleanup
|
386
|
+
unnecessary files and optimize the local
|
387
|
+
repository.</font></p>
|
388
|
+
|
389
|
+
|
390
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-grep</b>(1)</font></p>
|
391
|
+
|
392
|
+
<p style="margin-left:17%;"><font color="#000000">Print
|
393
|
+
lines matching a pattern.</font></p>
|
394
|
+
|
395
|
+
|
396
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-gui</b>(1)</font></p>
|
397
|
+
|
398
|
+
<p style="margin-left:17%;"><font color="#000000">A
|
399
|
+
portable graphical interface to Git.</font></p>
|
400
|
+
|
401
|
+
|
402
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-init</b>(1)</font></p>
|
403
|
+
|
404
|
+
<p style="margin-left:17%;"><font color="#000000">Create an
|
405
|
+
empty git repository or reinitialize an existing
|
406
|
+
one.</font></p>
|
407
|
+
|
408
|
+
|
409
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-log</b>(1)</font></p>
|
410
|
+
|
411
|
+
<p style="margin-left:17%;"><font color="#000000">Show
|
412
|
+
commit logs.</font></p>
|
413
|
+
|
414
|
+
|
415
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-merge</b>(1)</font></p>
|
416
|
+
|
417
|
+
<p style="margin-left:17%;"><font color="#000000">Join two
|
418
|
+
or more development histories together.</font></p>
|
419
|
+
|
420
|
+
|
421
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-mv</b>(1)</font></p>
|
422
|
+
|
423
|
+
<p style="margin-left:17%;"><font color="#000000">Move or
|
424
|
+
rename a file, a directory, or a symlink.</font></p>
|
425
|
+
|
426
|
+
|
427
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-notes</b>(1)</font></p>
|
428
|
+
|
429
|
+
<p style="margin-left:17%;"><font color="#000000">Add or
|
430
|
+
inspect object notes.</font></p>
|
431
|
+
|
432
|
+
|
433
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-pull</b>(1)</font></p>
|
434
|
+
|
435
|
+
<p style="margin-left:17%;"><font color="#000000">Fetch
|
436
|
+
from and merge with another repository or a local
|
437
|
+
branch.</font></p>
|
438
|
+
|
439
|
+
|
440
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-push</b>(1)</font></p>
|
441
|
+
|
442
|
+
<p style="margin-left:17%;"><font color="#000000">Update
|
443
|
+
remote refs along with associated objects.</font></p>
|
444
|
+
|
445
|
+
|
446
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-rebase</b>(1)</font></p>
|
447
|
+
|
448
|
+
|
449
|
+
<p style="margin-left:17%;"><font color="#000000">Forward−port
|
450
|
+
local commits to the updated upstream head.</font></p>
|
451
|
+
|
452
|
+
|
453
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-reset</b>(1)</font></p>
|
454
|
+
|
455
|
+
<p style="margin-left:17%;"><font color="#000000">Reset
|
456
|
+
current HEAD to the specified state.</font></p>
|
457
|
+
|
458
|
+
|
459
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-revert</b>(1)</font></p>
|
460
|
+
|
461
|
+
<p style="margin-left:17%;"><font color="#000000">Revert
|
462
|
+
some existing commits.</font></p>
|
463
|
+
|
464
|
+
|
465
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-rm</b>(1)</font></p>
|
466
|
+
|
467
|
+
<p style="margin-left:17%;"><font color="#000000">Remove
|
468
|
+
files from the working tree and from the index.</font></p>
|
469
|
+
|
470
|
+
|
471
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-shortlog</b>(1)</font></p>
|
472
|
+
|
473
|
+
|
474
|
+
<p style="margin-left:17%;"><font color="#000000">Summarize
|
475
|
+
<i>git log</i> output.</font></p>
|
476
|
+
|
477
|
+
|
478
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-show</b>(1)</font></p>
|
479
|
+
|
480
|
+
<p style="margin-left:17%;"><font color="#000000">Show
|
481
|
+
various types of objects.</font></p>
|
482
|
+
|
483
|
+
|
484
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-stash</b>(1)</font></p>
|
485
|
+
|
486
|
+
<p style="margin-left:17%;"><font color="#000000">Stash the
|
487
|
+
changes in a dirty working directory away.</font></p>
|
488
|
+
|
489
|
+
|
490
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-status</b>(1)</font></p>
|
491
|
+
|
492
|
+
<p style="margin-left:17%;"><font color="#000000">Show the
|
493
|
+
working tree status.</font></p>
|
494
|
+
|
495
|
+
|
496
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-submodule</b>(1)</font></p>
|
497
|
+
|
498
|
+
|
499
|
+
<p style="margin-left:17%;"><font color="#000000">Initialize,
|
500
|
+
update or inspect submodules.</font></p>
|
501
|
+
|
502
|
+
|
503
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-tag</b>(1)</font></p>
|
504
|
+
|
505
|
+
<p style="margin-left:17%;"><font color="#000000">Create,
|
506
|
+
list, delete or verify a tag object signed with
|
507
|
+
GPG.</font></p>
|
508
|
+
|
509
|
+
|
510
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>gitk</b>(1)</font></p>
|
511
|
+
|
512
|
+
<p style="margin-left:17%;"><font color="#000000">The git
|
513
|
+
repository browser.</font></p>
|
514
|
+
|
515
|
+
|
516
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>Ancillary
|
517
|
+
Commands</b> <br>
|
518
|
+
Manipulators:</font></p>
|
519
|
+
|
520
|
+
|
521
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-config</b>(1)</font></p>
|
522
|
+
|
523
|
+
<p style="margin-left:17%;"><font color="#000000">Get and
|
524
|
+
set repository or global options.</font></p>
|
525
|
+
|
526
|
+
|
527
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-fast-export</b>(1)</font></p>
|
528
|
+
|
529
|
+
<p style="margin-left:17%;"><font color="#000000">Git data
|
530
|
+
exporter.</font></p>
|
531
|
+
|
532
|
+
|
533
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-fast-import</b>(1)</font></p>
|
534
|
+
|
535
|
+
<p style="margin-left:17%;"><font color="#000000">Backend
|
536
|
+
for fast Git data importers.</font></p>
|
537
|
+
|
538
|
+
|
539
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-filter-branch</b>(1)</font></p>
|
540
|
+
|
541
|
+
<p style="margin-left:17%;"><font color="#000000">Rewrite
|
542
|
+
branches.</font></p>
|
543
|
+
|
544
|
+
|
545
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-lost-found</b>(1)</font></p>
|
546
|
+
|
547
|
+
|
548
|
+
<p style="margin-left:17%;"><font color="#000000">(deprecated)
|
549
|
+
Recover lost refs that luckily have not yet been
|
550
|
+
pruned.</font></p>
|
551
|
+
|
552
|
+
|
553
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-mergetool</b>(1)</font></p>
|
554
|
+
|
555
|
+
<p style="margin-left:17%;"><font color="#000000">Run merge
|
556
|
+
conflict resolution tools to resolve merge
|
557
|
+
conflicts.</font></p>
|
558
|
+
|
559
|
+
|
560
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-pack-refs</b>(1)</font></p>
|
561
|
+
|
562
|
+
<p style="margin-left:17%;"><font color="#000000">Pack
|
563
|
+
heads and tags for efficient repository access.</font></p>
|
564
|
+
|
565
|
+
|
566
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-prune</b>(1)</font></p>
|
567
|
+
|
568
|
+
<p style="margin-left:17%;"><font color="#000000">Prune all
|
569
|
+
unreachable objects from the object database.</font></p>
|
570
|
+
|
571
|
+
|
572
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-reflog</b>(1)</font></p>
|
573
|
+
|
574
|
+
<p style="margin-left:17%;"><font color="#000000">Manage
|
575
|
+
reflog information.</font></p>
|
576
|
+
|
577
|
+
|
578
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-relink</b>(1)</font></p>
|
579
|
+
|
580
|
+
<p style="margin-left:17%;"><font color="#000000">Hardlink
|
581
|
+
common objects in local repositories.</font></p>
|
582
|
+
|
583
|
+
|
584
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-remote</b>(1)</font></p>
|
585
|
+
|
586
|
+
<p style="margin-left:17%;"><font color="#000000">manage
|
587
|
+
set of tracked repositories.</font></p>
|
588
|
+
|
589
|
+
|
590
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-repack</b>(1)</font></p>
|
591
|
+
|
592
|
+
<p style="margin-left:17%;"><font color="#000000">Pack
|
593
|
+
unpacked objects in a repository.</font></p>
|
594
|
+
|
595
|
+
|
596
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-replace</b>(1)</font></p>
|
597
|
+
|
598
|
+
<p style="margin-left:17%;"><font color="#000000">Create,
|
599
|
+
list, delete refs to replace objects.</font></p>
|
600
|
+
|
601
|
+
|
602
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-repo-config</b>(1)</font></p>
|
603
|
+
|
604
|
+
|
605
|
+
<p style="margin-left:17%;"><font color="#000000">(deprecated)
|
606
|
+
Get and set repository or global options.</font></p>
|
607
|
+
|
608
|
+
|
609
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">Interrogators:</font></p>
|
610
|
+
|
611
|
+
|
612
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-annotate</b>(1)</font></p>
|
613
|
+
|
614
|
+
<p style="margin-left:17%;"><font color="#000000">Annotate
|
615
|
+
file lines with commit information.</font></p>
|
616
|
+
|
617
|
+
|
618
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-blame</b>(1)</font></p>
|
619
|
+
|
620
|
+
<p style="margin-left:17%;"><font color="#000000">Show what
|
621
|
+
revision and author last modified each line of a
|
622
|
+
file.</font></p>
|
623
|
+
|
624
|
+
|
625
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-cherry</b>(1)</font></p>
|
626
|
+
|
627
|
+
<p style="margin-left:17%;"><font color="#000000">Find
|
628
|
+
commits not merged upstream.</font></p>
|
629
|
+
|
630
|
+
|
631
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-count-objects</b>(1)</font></p>
|
632
|
+
|
633
|
+
<p style="margin-left:17%;"><font color="#000000">Count
|
634
|
+
unpacked number of objects and their disk
|
635
|
+
consumption.</font></p>
|
636
|
+
|
637
|
+
|
638
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-difftool</b>(1)</font></p>
|
639
|
+
|
640
|
+
<p style="margin-left:17%;"><font color="#000000">Show
|
641
|
+
changes using common diff tools.</font></p>
|
642
|
+
|
643
|
+
|
644
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-fsck</b>(1)</font></p>
|
645
|
+
|
646
|
+
<p style="margin-left:17%;"><font color="#000000">Verifies
|
647
|
+
the connectivity and validity of the objects in the
|
648
|
+
database.</font></p>
|
649
|
+
|
650
|
+
|
651
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-get-tar-commit-id</b>(1)</font></p>
|
652
|
+
|
653
|
+
<p style="margin-left:17%;"><font color="#000000">Extract
|
654
|
+
commit ID from an archive created using
|
655
|
+
git−archive.</font></p>
|
656
|
+
|
657
|
+
|
658
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-help</b>(1)</font></p>
|
659
|
+
|
660
|
+
<p style="margin-left:17%;"><font color="#000000">display
|
661
|
+
help information about git.</font></p>
|
662
|
+
|
663
|
+
|
664
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-instaweb</b>(1)</font></p>
|
665
|
+
|
666
|
+
|
667
|
+
<p style="margin-left:17%;"><font color="#000000">Instantly
|
668
|
+
browse your working repository in gitweb.</font></p>
|
669
|
+
|
670
|
+
|
671
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-merge-tree</b>(1)</font></p>
|
672
|
+
|
673
|
+
<p style="margin-left:17%;"><font color="#000000">Show
|
674
|
+
three−way merge without touching index.</font></p>
|
675
|
+
|
676
|
+
|
677
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-rerere</b>(1)</font></p>
|
678
|
+
|
679
|
+
<p style="margin-left:17%;"><font color="#000000">Reuse
|
680
|
+
recorded resolution of conflicted merges.</font></p>
|
681
|
+
|
682
|
+
|
683
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-rev-parse</b>(1)</font></p>
|
684
|
+
|
685
|
+
<p style="margin-left:17%;"><font color="#000000">Pick out
|
686
|
+
and massage parameters.</font></p>
|
687
|
+
|
688
|
+
|
689
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-show-branch</b>(1)</font></p>
|
690
|
+
|
691
|
+
<p style="margin-left:17%;"><font color="#000000">Show
|
692
|
+
branches and their commits.</font></p>
|
693
|
+
|
694
|
+
|
695
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-verify-tag</b>(1)</font></p>
|
696
|
+
|
697
|
+
<p style="margin-left:17%;"><font color="#000000">Check the
|
698
|
+
GPG signature of tags.</font></p>
|
699
|
+
|
700
|
+
|
701
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-whatchanged</b>(1)</font></p>
|
702
|
+
|
703
|
+
<p style="margin-left:17%;"><font color="#000000">Show logs
|
704
|
+
with difference each commit introduces.</font></p>
|
705
|
+
|
706
|
+
|
707
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>Interacting
|
708
|
+
with Others</b> <br>
|
709
|
+
These commands are to interact with foreign SCM and with
|
710
|
+
other people via patch over e−mail.</font></p>
|
711
|
+
|
712
|
+
|
713
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-archimport</b>(1)</font></p>
|
714
|
+
|
715
|
+
<p style="margin-left:17%;"><font color="#000000">Import an
|
716
|
+
Arch repository into git.</font></p>
|
717
|
+
|
718
|
+
|
719
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-cvsexportcommit</b>(1)</font></p>
|
720
|
+
|
721
|
+
<p style="margin-left:17%;"><font color="#000000">Export a
|
722
|
+
single commit to a CVS checkout.</font></p>
|
723
|
+
|
724
|
+
|
725
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-cvsimport</b>(1)</font></p>
|
726
|
+
|
727
|
+
<p style="margin-left:17%;"><font color="#000000">Salvage
|
728
|
+
your data out of another SCM people love to hate.</font></p>
|
729
|
+
|
730
|
+
|
731
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-cvsserver</b>(1)</font></p>
|
732
|
+
|
733
|
+
<p style="margin-left:17%;"><font color="#000000">A CVS
|
734
|
+
server emulator for git.</font></p>
|
735
|
+
|
736
|
+
|
737
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-imap-send</b>(1)</font></p>
|
738
|
+
|
739
|
+
<p style="margin-left:17%;"><font color="#000000">Send a
|
740
|
+
collection of patches from stdin to an IMAP
|
741
|
+
folder.</font></p>
|
742
|
+
|
743
|
+
|
744
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-quiltimport</b>(1)</font></p>
|
745
|
+
|
746
|
+
<p style="margin-left:17%;"><font color="#000000">Applies a
|
747
|
+
quilt patchset onto the current branch.</font></p>
|
748
|
+
|
749
|
+
|
750
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-request-pull</b>(1)</font></p>
|
751
|
+
|
752
|
+
|
753
|
+
<p style="margin-left:17%;"><font color="#000000">Generates
|
754
|
+
a summary of pending changes.</font></p>
|
755
|
+
|
756
|
+
|
757
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-send-email</b>(1)</font></p>
|
758
|
+
|
759
|
+
<p style="margin-left:17%;"><font color="#000000">Send a
|
760
|
+
collection of patches as emails.</font></p>
|
761
|
+
|
762
|
+
|
763
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-svn</b>(1)</font></p>
|
764
|
+
|
765
|
+
|
766
|
+
<p style="margin-left:17%;"><font color="#000000">Bidirectional
|
767
|
+
operation between a Subversion repository and
|
768
|
+
git.</font></p>
|
769
|
+
|
770
|
+
<a name="LOW-LEVEL COMMANDS (PLUMBING)"></a>
|
771
|
+
<h2>LOW-LEVEL COMMANDS (PLUMBING)</h2>
|
772
|
+
|
773
|
+
|
774
|
+
|
775
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">Although
|
776
|
+
git includes its own porcelain layer, its low−level
|
777
|
+
commands are sufficient to support development of
|
778
|
+
alternative porcelains. Developers of such porcelains might
|
779
|
+
start by reading about <b>git-update-index</b>(1) and
|
780
|
+
<b>git-read-tree</b>(1).</font></p>
|
781
|
+
|
782
|
+
|
783
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">The
|
784
|
+
interface (input, output, set of options and the semantics)
|
785
|
+
to these low−level commands are meant to be a lot more
|
786
|
+
stable than Porcelain level commands, because these commands
|
787
|
+
are primarily for scripted use. The interface to Porcelain
|
788
|
+
commands on the other hand are subject to change in order to
|
789
|
+
improve the end user experience.</font></p>
|
790
|
+
|
791
|
+
|
792
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">The
|
793
|
+
following description divides the low−level commands
|
794
|
+
into commands that manipulate objects (in the repository,
|
795
|
+
index, and working tree), commands that interrogate and
|
796
|
+
compare objects, and commands that move objects and
|
797
|
+
references between repositories.</font></p>
|
798
|
+
|
799
|
+
|
800
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>Manipulation
|
801
|
+
commands <br>
|
802
|
+
git-apply</b>(1)</font></p>
|
803
|
+
|
804
|
+
<p style="margin-left:17%;"><font color="#000000">Apply a
|
805
|
+
patch to files and/or to the index.</font></p>
|
806
|
+
|
807
|
+
|
808
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-checkout-index</b>(1)</font></p>
|
809
|
+
|
810
|
+
<p style="margin-left:17%;"><font color="#000000">Copy
|
811
|
+
files from the index to the working tree.</font></p>
|
812
|
+
|
813
|
+
|
814
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-commit-tree</b>(1)</font></p>
|
815
|
+
|
816
|
+
<p style="margin-left:17%;"><font color="#000000">Create a
|
817
|
+
new commit object.</font></p>
|
818
|
+
|
819
|
+
|
820
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-hash-object</b>(1)</font></p>
|
821
|
+
|
822
|
+
<p style="margin-left:17%;"><font color="#000000">Compute
|
823
|
+
object ID and optionally creates a blob from a
|
824
|
+
file.</font></p>
|
825
|
+
|
826
|
+
|
827
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-index-pack</b>(1)</font></p>
|
828
|
+
|
829
|
+
<p style="margin-left:17%;"><font color="#000000">Build
|
830
|
+
pack index file for an existing packed archive.</font></p>
|
831
|
+
|
832
|
+
|
833
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-merge-file</b>(1)</font></p>
|
834
|
+
|
835
|
+
<p style="margin-left:17%;"><font color="#000000">Run a
|
836
|
+
three−way file merge.</font></p>
|
837
|
+
|
838
|
+
|
839
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-merge-index</b>(1)</font></p>
|
840
|
+
|
841
|
+
<p style="margin-left:17%;"><font color="#000000">Run a
|
842
|
+
merge for files needing merging.</font></p>
|
843
|
+
|
844
|
+
|
845
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-mktag</b>(1)</font></p>
|
846
|
+
|
847
|
+
<p style="margin-left:17%;"><font color="#000000">Creates a
|
848
|
+
tag object.</font></p>
|
849
|
+
|
850
|
+
|
851
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-mktree</b>(1)</font></p>
|
852
|
+
|
853
|
+
<p style="margin-left:17%;"><font color="#000000">Build a
|
854
|
+
tree−object from ls−tree formatted
|
855
|
+
text.</font></p>
|
856
|
+
|
857
|
+
|
858
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-pack-objects</b>(1)</font></p>
|
859
|
+
|
860
|
+
<p style="margin-left:17%;"><font color="#000000">Create a
|
861
|
+
packed archive of objects.</font></p>
|
862
|
+
|
863
|
+
|
864
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-prune-packed</b>(1)</font></p>
|
865
|
+
|
866
|
+
<p style="margin-left:17%;"><font color="#000000">Remove
|
867
|
+
extra objects that are already in pack files.</font></p>
|
868
|
+
|
869
|
+
|
870
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-read-tree</b>(1)</font></p>
|
871
|
+
|
872
|
+
<p style="margin-left:17%;"><font color="#000000">Reads
|
873
|
+
tree information into the index.</font></p>
|
874
|
+
|
875
|
+
|
876
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-symbolic-ref</b>(1)</font></p>
|
877
|
+
|
878
|
+
<p style="margin-left:17%;"><font color="#000000">Read and
|
879
|
+
modify symbolic refs.</font></p>
|
880
|
+
|
881
|
+
|
882
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-unpack-objects</b>(1)</font></p>
|
883
|
+
|
884
|
+
<p style="margin-left:17%;"><font color="#000000">Unpack
|
885
|
+
objects from a packed archive.</font></p>
|
886
|
+
|
887
|
+
|
888
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-update-index</b>(1)</font></p>
|
889
|
+
|
890
|
+
<p style="margin-left:17%;"><font color="#000000">Register
|
891
|
+
file contents in the working tree to the index.</font></p>
|
892
|
+
|
893
|
+
|
894
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-update-ref</b>(1)</font></p>
|
895
|
+
|
896
|
+
<p style="margin-left:17%;"><font color="#000000">Update
|
897
|
+
the object name stored in a ref safely.</font></p>
|
898
|
+
|
899
|
+
|
900
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-write-tree</b>(1)</font></p>
|
901
|
+
|
902
|
+
<p style="margin-left:17%;"><font color="#000000">Create a
|
903
|
+
tree object from the current index.</font></p>
|
904
|
+
|
905
|
+
|
906
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>Interrogation
|
907
|
+
commands <br>
|
908
|
+
git-cat-file</b>(1)</font></p>
|
909
|
+
|
910
|
+
<p style="margin-left:17%;"><font color="#000000">Provide
|
911
|
+
content or type and size information for repository
|
912
|
+
objects.</font></p>
|
913
|
+
|
914
|
+
|
915
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-diff-files</b>(1)</font></p>
|
916
|
+
|
917
|
+
<p style="margin-left:17%;"><font color="#000000">Compares
|
918
|
+
files in the working tree and the index.</font></p>
|
919
|
+
|
920
|
+
|
921
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-diff-index</b>(1)</font></p>
|
922
|
+
|
923
|
+
<p style="margin-left:17%;"><font color="#000000">Compares
|
924
|
+
content and mode of blobs between the index and
|
925
|
+
repository.</font></p>
|
926
|
+
|
927
|
+
|
928
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-diff-tree</b>(1)</font></p>
|
929
|
+
|
930
|
+
<p style="margin-left:17%;"><font color="#000000">Compares
|
931
|
+
the content and mode of blobs found via two tree
|
932
|
+
objects.</font></p>
|
933
|
+
|
934
|
+
|
935
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-for-each-ref</b>(1)</font></p>
|
936
|
+
|
937
|
+
<p style="margin-left:17%;"><font color="#000000">Output
|
938
|
+
information on each ref.</font></p>
|
939
|
+
|
940
|
+
|
941
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-ls-files</b>(1)</font></p>
|
942
|
+
|
943
|
+
<p style="margin-left:17%;"><font color="#000000">Show
|
944
|
+
information about files in the index and the working
|
945
|
+
tree.</font></p>
|
946
|
+
|
947
|
+
|
948
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-ls-remote</b>(1)</font></p>
|
949
|
+
|
950
|
+
<p style="margin-left:17%;"><font color="#000000">List
|
951
|
+
references in a remote repository.</font></p>
|
952
|
+
|
953
|
+
|
954
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-ls-tree</b>(1)</font></p>
|
955
|
+
|
956
|
+
<p style="margin-left:17%;"><font color="#000000">List the
|
957
|
+
contents of a tree object.</font></p>
|
958
|
+
|
959
|
+
|
960
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-merge-base</b>(1)</font></p>
|
961
|
+
|
962
|
+
<p style="margin-left:17%;"><font color="#000000">Find as
|
963
|
+
good common ancestors as possible for a merge.</font></p>
|
964
|
+
|
965
|
+
|
966
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-name-rev</b>(1)</font></p>
|
967
|
+
|
968
|
+
<p style="margin-left:17%;"><font color="#000000">Find
|
969
|
+
symbolic names for given revs.</font></p>
|
970
|
+
|
971
|
+
|
972
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-pack-redundant</b>(1)</font></p>
|
973
|
+
|
974
|
+
<p style="margin-left:17%;"><font color="#000000">Find
|
975
|
+
redundant pack files.</font></p>
|
976
|
+
|
977
|
+
|
978
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-rev-list</b>(1)</font></p>
|
979
|
+
|
980
|
+
<p style="margin-left:17%;"><font color="#000000">Lists
|
981
|
+
commit objects in reverse chronological order.</font></p>
|
982
|
+
|
983
|
+
|
984
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-show-index</b>(1)</font></p>
|
985
|
+
|
986
|
+
<p style="margin-left:17%;"><font color="#000000">Show
|
987
|
+
packed archive index.</font></p>
|
988
|
+
|
989
|
+
|
990
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-show-ref</b>(1)</font></p>
|
991
|
+
|
992
|
+
<p style="margin-left:17%;"><font color="#000000">List
|
993
|
+
references in a local repository.</font></p>
|
994
|
+
|
995
|
+
|
996
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-tar-tree</b>(1)</font></p>
|
997
|
+
|
998
|
+
|
999
|
+
<p style="margin-left:17%;"><font color="#000000">(deprecated)
|
1000
|
+
Create a tar archive of the files in the named tree
|
1001
|
+
object.</font></p>
|
1002
|
+
|
1003
|
+
|
1004
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-unpack-file</b>(1)</font></p>
|
1005
|
+
|
1006
|
+
<p style="margin-left:17%;"><font color="#000000">Creates a
|
1007
|
+
temporary file with a blob’s contents.</font></p>
|
1008
|
+
|
1009
|
+
|
1010
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-var</b>(1)</font></p>
|
1011
|
+
|
1012
|
+
<p style="margin-left:17%;"><font color="#000000">Show a
|
1013
|
+
git logical variable.</font></p>
|
1014
|
+
|
1015
|
+
|
1016
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-verify-pack</b>(1)</font></p>
|
1017
|
+
|
1018
|
+
<p style="margin-left:17%;"><font color="#000000">Validate
|
1019
|
+
packed git archive files.</font></p>
|
1020
|
+
|
1021
|
+
|
1022
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">In
|
1023
|
+
general, the interrogate commands do not touch the files in
|
1024
|
+
the working tree.</font></p>
|
1025
|
+
|
1026
|
+
|
1027
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>Synching
|
1028
|
+
repositories <br>
|
1029
|
+
git-daemon</b>(1)</font></p>
|
1030
|
+
|
1031
|
+
<p style="margin-left:17%;"><font color="#000000">A really
|
1032
|
+
simple server for git repositories.</font></p>
|
1033
|
+
|
1034
|
+
|
1035
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-fetch-pack</b>(1)</font></p>
|
1036
|
+
|
1037
|
+
<p style="margin-left:17%;"><font color="#000000">Receive
|
1038
|
+
missing objects from another repository.</font></p>
|
1039
|
+
|
1040
|
+
|
1041
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-http-backend</b>(1)</font></p>
|
1042
|
+
|
1043
|
+
<p style="margin-left:17%;"><font color="#000000">Server
|
1044
|
+
side implementation of Git over HTTP.</font></p>
|
1045
|
+
|
1046
|
+
|
1047
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-send-pack</b>(1)</font></p>
|
1048
|
+
|
1049
|
+
<p style="margin-left:17%;"><font color="#000000">Push
|
1050
|
+
objects over git protocol to another repository.</font></p>
|
1051
|
+
|
1052
|
+
|
1053
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-update-server-info</b>(1)</font></p>
|
1054
|
+
|
1055
|
+
<p style="margin-left:17%;"><font color="#000000">Update
|
1056
|
+
auxiliary info file to help dumb servers.</font></p>
|
1057
|
+
|
1058
|
+
|
1059
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">The
|
1060
|
+
following are helper commands used by the above; end users
|
1061
|
+
typically do not use them directly.</font></p>
|
1062
|
+
|
1063
|
+
|
1064
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-http-fetch</b>(1)</font></p>
|
1065
|
+
|
1066
|
+
<p style="margin-left:17%;"><font color="#000000">Download
|
1067
|
+
from a remote git repository via HTTP.</font></p>
|
1068
|
+
|
1069
|
+
|
1070
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-http-push</b>(1)</font></p>
|
1071
|
+
|
1072
|
+
<p style="margin-left:17%;"><font color="#000000">Push
|
1073
|
+
objects over HTTP/DAV to another repository.</font></p>
|
1074
|
+
|
1075
|
+
|
1076
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-parse-remote</b>(1)</font></p>
|
1077
|
+
|
1078
|
+
<p style="margin-left:17%;"><font color="#000000">Routines
|
1079
|
+
to help parsing remote repository access
|
1080
|
+
parameters.</font></p>
|
1081
|
+
|
1082
|
+
|
1083
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-receive-pack</b>(1)</font></p>
|
1084
|
+
|
1085
|
+
<p style="margin-left:17%;"><font color="#000000">Receive
|
1086
|
+
what is pushed into the repository.</font></p>
|
1087
|
+
|
1088
|
+
|
1089
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-shell</b>(1)</font></p>
|
1090
|
+
|
1091
|
+
|
1092
|
+
<p style="margin-left:17%;"><font color="#000000">Restricted
|
1093
|
+
login shell for Git−only SSH access.</font></p>
|
1094
|
+
|
1095
|
+
|
1096
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-upload-archive</b>(1)</font></p>
|
1097
|
+
|
1098
|
+
<p style="margin-left:17%;"><font color="#000000">Send
|
1099
|
+
archive back to git−archive.</font></p>
|
1100
|
+
|
1101
|
+
|
1102
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-upload-pack</b>(1)</font></p>
|
1103
|
+
|
1104
|
+
<p style="margin-left:17%;"><font color="#000000">Send
|
1105
|
+
objects packed back to
|
1106
|
+
git−fetch−pack.</font></p>
|
1107
|
+
|
1108
|
+
|
1109
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>Internal
|
1110
|
+
helper commands</b> <br>
|
1111
|
+
These are internal helper commands used by other commands;
|
1112
|
+
end users typically do not use them directly.</font></p>
|
1113
|
+
|
1114
|
+
|
1115
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-check-attr</b>(1)</font></p>
|
1116
|
+
|
1117
|
+
<p style="margin-left:17%;"><font color="#000000">Display
|
1118
|
+
gitattributes information.</font></p>
|
1119
|
+
|
1120
|
+
|
1121
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-check-ref-format</b>(1)</font></p>
|
1122
|
+
|
1123
|
+
<p style="margin-left:17%;"><font color="#000000">Ensures
|
1124
|
+
that a reference name is well formed.</font></p>
|
1125
|
+
|
1126
|
+
|
1127
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-fmt-merge-msg</b>(1)</font></p>
|
1128
|
+
|
1129
|
+
<p style="margin-left:17%;"><font color="#000000">Produce a
|
1130
|
+
merge commit message.</font></p>
|
1131
|
+
|
1132
|
+
|
1133
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-mailinfo</b>(1)</font></p>
|
1134
|
+
|
1135
|
+
<p style="margin-left:17%;"><font color="#000000">Extracts
|
1136
|
+
patch and authorship from a single e−mail
|
1137
|
+
message.</font></p>
|
1138
|
+
|
1139
|
+
|
1140
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-mailsplit</b>(1)</font></p>
|
1141
|
+
|
1142
|
+
<p style="margin-left:17%;"><font color="#000000">Simple
|
1143
|
+
UNIX mbox splitter program.</font></p>
|
1144
|
+
|
1145
|
+
|
1146
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-merge-one-file</b>(1)</font></p>
|
1147
|
+
|
1148
|
+
<p style="margin-left:17%;"><font color="#000000">The
|
1149
|
+
standard helper program to use with
|
1150
|
+
git−merge−index.</font></p>
|
1151
|
+
|
1152
|
+
|
1153
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-patch-id</b>(1)</font></p>
|
1154
|
+
|
1155
|
+
<p style="margin-left:17%;"><font color="#000000">Compute
|
1156
|
+
unique ID for a patch.</font></p>
|
1157
|
+
|
1158
|
+
|
1159
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-peek-remote</b>(1)</font></p>
|
1160
|
+
|
1161
|
+
|
1162
|
+
<p style="margin-left:17%;"><font color="#000000">(deprecated)
|
1163
|
+
List the references in a remote repository.</font></p>
|
1164
|
+
|
1165
|
+
|
1166
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-sh-setup</b>(1)</font></p>
|
1167
|
+
|
1168
|
+
<p style="margin-left:17%;"><font color="#000000">Common
|
1169
|
+
git shell script setup code.</font></p>
|
1170
|
+
|
1171
|
+
|
1172
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git-stripspace</b>(1)</font></p>
|
1173
|
+
|
1174
|
+
<p style="margin-left:17%;"><font color="#000000">Filter
|
1175
|
+
out empty lines.</font></p>
|
1176
|
+
|
1177
|
+
<a name="CONFIGURATION MECHANISM"></a>
|
1178
|
+
<h2>CONFIGURATION MECHANISM</h2>
|
1179
|
+
|
1180
|
+
|
1181
|
+
|
1182
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">Starting
|
1183
|
+
from 0.99.9 (actually mid 0.99.8.GIT), .git/config file is
|
1184
|
+
used to hold per−repository configuration options. It
|
1185
|
+
is a simple text file modeled after .ini format familiar to
|
1186
|
+
some people. Here is an example:</font></p>
|
1187
|
+
|
1188
|
+
|
1189
|
+
<p style="margin-left:17%; margin-top: 1em"><font color="#000000">#
|
1190
|
+
<br>
|
1191
|
+
# A '#' or ';' character indicates a comment. <br>
|
1192
|
+
#</font></p>
|
1193
|
+
|
1194
|
+
|
1195
|
+
<p style="margin-left:17%; margin-top: 1em"><font color="#000000">;
|
1196
|
+
core variables <br>
|
1197
|
+
[core] <br>
|
1198
|
+
; Don't trust file modes <br>
|
1199
|
+
filemode = false</font></p>
|
1200
|
+
|
1201
|
+
|
1202
|
+
<p style="margin-left:17%; margin-top: 1em"><font color="#000000">;
|
1203
|
+
user identity <br>
|
1204
|
+
[user] <br>
|
1205
|
+
name = "Junio C Hamano" <br>
|
1206
|
+
email = "junkio@twinsun.com"</font></p>
|
1207
|
+
|
1208
|
+
|
1209
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">Various
|
1210
|
+
commands read from the configuration file and adjust their
|
1211
|
+
operation accordingly. See <b>git-config</b>(1) for a
|
1212
|
+
list.</font></p>
|
1213
|
+
|
1214
|
+
<a name="IDENTIFIER TERMINOLOGY"></a>
|
1215
|
+
<h2>IDENTIFIER TERMINOLOGY</h2>
|
1216
|
+
|
1217
|
+
|
1218
|
+
|
1219
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><object></font></p>
|
1220
|
+
|
1221
|
+
|
1222
|
+
<p style="margin-left:17%;"><font color="#000000">Indicates
|
1223
|
+
the object name for any type of object.</font></p>
|
1224
|
+
|
1225
|
+
|
1226
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><blob></font></p>
|
1227
|
+
|
1228
|
+
|
1229
|
+
<p style="margin-left:17%;"><font color="#000000">Indicates
|
1230
|
+
a blob object name.</font></p>
|
1231
|
+
|
1232
|
+
|
1233
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><tree></font></p>
|
1234
|
+
|
1235
|
+
|
1236
|
+
<p style="margin-left:17%;"><font color="#000000">Indicates
|
1237
|
+
a tree object name.</font></p>
|
1238
|
+
|
1239
|
+
|
1240
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><commit></font></p>
|
1241
|
+
|
1242
|
+
|
1243
|
+
<p style="margin-left:17%;"><font color="#000000">Indicates
|
1244
|
+
a commit object name.</font></p>
|
1245
|
+
|
1246
|
+
|
1247
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><tree−ish></font></p>
|
1248
|
+
|
1249
|
+
|
1250
|
+
<p style="margin-left:17%;"><font color="#000000">Indicates
|
1251
|
+
a tree, commit or tag object name. A command that takes a
|
1252
|
+
<tree−ish> argument ultimately wants to operate
|
1253
|
+
on a <tree> object but automatically dereferences
|
1254
|
+
<commit> and <tag> objects that point at a
|
1255
|
+
<tree>.</font></p>
|
1256
|
+
|
1257
|
+
|
1258
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><commit−ish></font></p>
|
1259
|
+
|
1260
|
+
|
1261
|
+
<p style="margin-left:17%;"><font color="#000000">Indicates
|
1262
|
+
a commit or tag object name. A command that takes a
|
1263
|
+
<commit−ish> argument ultimately wants to
|
1264
|
+
operate on a <commit> object but automatically
|
1265
|
+
dereferences <tag> objects that point at a
|
1266
|
+
<commit>.</font></p>
|
1267
|
+
|
1268
|
+
|
1269
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><type></font></p>
|
1270
|
+
|
1271
|
+
|
1272
|
+
<p style="margin-left:17%;"><font color="#000000">Indicates
|
1273
|
+
that an object type is required. Currently one of: blob,
|
1274
|
+
tree, commit, or tag.</font></p>
|
1275
|
+
|
1276
|
+
|
1277
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><file></font></p>
|
1278
|
+
|
1279
|
+
|
1280
|
+
<p style="margin-left:17%;"><font color="#000000">Indicates
|
1281
|
+
a filename − almost always relative to the root of the
|
1282
|
+
tree structure GIT_INDEX_FILE describes.</font></p>
|
1283
|
+
|
1284
|
+
<a name="SYMBOLIC IDENTIFIERS"></a>
|
1285
|
+
<h2>SYMBOLIC IDENTIFIERS</h2>
|
1286
|
+
|
1287
|
+
|
1288
|
+
|
1289
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">Any
|
1290
|
+
git command accepting any <object> can also use the
|
1291
|
+
following symbolic notation:</font></p>
|
1292
|
+
|
1293
|
+
|
1294
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">HEAD</font></p>
|
1295
|
+
|
1296
|
+
|
1297
|
+
<p style="margin-left:17%;"><font color="#000000">indicates
|
1298
|
+
the head of the current branch (i.e. the contents of
|
1299
|
+
$GIT_DIR/HEAD).</font></p>
|
1300
|
+
|
1301
|
+
|
1302
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><tag></font></p>
|
1303
|
+
|
1304
|
+
<p style="margin-left:17%;"><font color="#000000">a valid
|
1305
|
+
tag <i>name</i> (i.e. the contents of
|
1306
|
+
$GIT_DIR/refs/tags/<tag>).</font></p>
|
1307
|
+
|
1308
|
+
|
1309
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><head></font></p>
|
1310
|
+
|
1311
|
+
<p style="margin-left:17%;"><font color="#000000">a valid
|
1312
|
+
head <i>name</i> (i.e. the contents of
|
1313
|
+
$GIT_DIR/refs/heads/<head>).</font></p>
|
1314
|
+
|
1315
|
+
|
1316
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">For
|
1317
|
+
a more complete list of ways to spell object names, see
|
1318
|
+
"SPECIFYING REVISIONS" section in
|
1319
|
+
<b>gitrevisions</b>(7).</font></p>
|
1320
|
+
|
1321
|
+
<a name="FILE/DIRECTORY STRUCTURE"></a>
|
1322
|
+
<h2>FILE/DIRECTORY STRUCTURE</h2>
|
1323
|
+
|
1324
|
+
|
1325
|
+
|
1326
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">Please
|
1327
|
+
see the <b>gitrepository-layout</b>(5) document.</font></p>
|
1328
|
+
|
1329
|
+
|
1330
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">Read
|
1331
|
+
<b>githooks</b>(5) for more details about each
|
1332
|
+
hook.</font></p>
|
1333
|
+
|
1334
|
+
|
1335
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">Higher
|
1336
|
+
level SCMs may provide and manage additional information in
|
1337
|
+
the $GIT_DIR.</font></p>
|
1338
|
+
|
1339
|
+
<a name="TERMINOLOGY"></a>
|
1340
|
+
<h2>TERMINOLOGY</h2>
|
1341
|
+
|
1342
|
+
|
1343
|
+
|
1344
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">Please
|
1345
|
+
see <b>gitglossary</b>(7).</font></p>
|
1346
|
+
|
1347
|
+
<a name="ENVIRONMENT VARIABLES"></a>
|
1348
|
+
<h2>ENVIRONMENT VARIABLES</h2>
|
1349
|
+
|
1350
|
+
|
1351
|
+
|
1352
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">Various
|
1353
|
+
git commands use the following environment
|
1354
|
+
variables:</font></p>
|
1355
|
+
|
1356
|
+
|
1357
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>The
|
1358
|
+
git Repository</b> <br>
|
1359
|
+
These environment variables apply to <i>all</i> core git
|
1360
|
+
commands. Nb: it is worth noting that they may be
|
1361
|
+
used/overridden by SCMS sitting above git so take care if
|
1362
|
+
using Cogito etc.</font></p>
|
1363
|
+
|
1364
|
+
|
1365
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><i>GIT_INDEX_FILE</i></font></p>
|
1366
|
+
|
1367
|
+
<p style="margin-left:17%;"><font color="#000000">This
|
1368
|
+
environment allows the specification of an alternate index
|
1369
|
+
file. If not specified, the default of $GIT_DIR/index is
|
1370
|
+
used.</font></p>
|
1371
|
+
|
1372
|
+
|
1373
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><i>GIT_OBJECT_DIRECTORY</i></font></p>
|
1374
|
+
|
1375
|
+
<p style="margin-left:17%;"><font color="#000000">If the
|
1376
|
+
object storage directory is specified via this environment
|
1377
|
+
variable then the sha1 directories are created underneath
|
1378
|
+
− otherwise the default $GIT_DIR/objects directory is
|
1379
|
+
used.</font></p>
|
1380
|
+
|
1381
|
+
|
1382
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><i>GIT_ALTERNATE_OBJECT_DIRECTORIES</i></font></p>
|
1383
|
+
|
1384
|
+
<p style="margin-left:17%;"><font color="#000000">Due to
|
1385
|
+
the immutable nature of git objects, old objects can be
|
1386
|
+
archived into shared, read−only directories. This
|
1387
|
+
variable specifies a ":" separated (on Windows
|
1388
|
+
";" separated) list of git object directories
|
1389
|
+
which can be used to search for git objects. New objects
|
1390
|
+
will not be written to these directories.</font></p>
|
1391
|
+
|
1392
|
+
|
1393
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><i>GIT_DIR</i></font></p>
|
1394
|
+
|
1395
|
+
<p style="margin-left:17%;"><font color="#000000">If the
|
1396
|
+
<i>GIT_DIR</i> environment variable is set then it specifies
|
1397
|
+
a path to use instead of the default .git for the base of
|
1398
|
+
the repository.</font></p>
|
1399
|
+
|
1400
|
+
|
1401
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><i>GIT_WORK_TREE</i></font></p>
|
1402
|
+
|
1403
|
+
<p style="margin-left:17%;"><font color="#000000">Set the
|
1404
|
+
path to the working tree. The value will not be used in
|
1405
|
+
combination with repositories found automatically in a .git
|
1406
|
+
directory (i.e. $GIT_DIR is not set). This can also be
|
1407
|
+
controlled by the <i>−−work−tree</i>
|
1408
|
+
command line option and the core.worktree configuration
|
1409
|
+
variable.</font></p>
|
1410
|
+
|
1411
|
+
|
1412
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><i>GIT_CEILING_DIRECTORIES</i></font></p>
|
1413
|
+
|
1414
|
+
<p style="margin-left:17%;"><font color="#000000">This
|
1415
|
+
should be a colon−separated list of absolute paths. If
|
1416
|
+
set, it is a list of directories that git should not chdir
|
1417
|
+
up into while looking for a repository directory. It will
|
1418
|
+
not exclude the current working directory or a GIT_DIR set
|
1419
|
+
on the command line or in the environment. (Useful for
|
1420
|
+
excluding slow−loading network
|
1421
|
+
directories.)</font></p>
|
1422
|
+
|
1423
|
+
|
1424
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><i>GIT_DISCOVERY_ACROSS_FILESYSTEM</i></font></p>
|
1425
|
+
|
1426
|
+
<p style="margin-left:17%;"><font color="#000000">When run
|
1427
|
+
in a directory that does not have ".git"
|
1428
|
+
repository directory, git tries to find such a directory in
|
1429
|
+
the parent directories to find the top of the working tree,
|
1430
|
+
but by default it does not cross filesystem boundaries. This
|
1431
|
+
environment variable can be set to true to tell git not to
|
1432
|
+
stop at filesystem boundaries. Like
|
1433
|
+
<i>GIT_CEILING_DIRECTORIES</i>, this will not affect an
|
1434
|
+
explicit repository directory set via <i>GIT_DIR</i> or on
|
1435
|
+
the command line.</font></p>
|
1436
|
+
|
1437
|
+
|
1438
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git
|
1439
|
+
Commits</b> <i><br>
|
1440
|
+
GIT_AUTHOR_NAME</i>, <i>GIT_AUTHOR_EMAIL</i>,
|
1441
|
+
<i>GIT_AUTHOR_DATE</i>, <i>GIT_COMMITTER_NAME</i>,
|
1442
|
+
<i>GIT_COMMITTER_EMAIL</i>, <i>GIT_COMMITTER_DATE</i>,
|
1443
|
+
<i>EMAIL</i></font></p>
|
1444
|
+
|
1445
|
+
<p style="margin-left:17%;"><font color="#000000">see
|
1446
|
+
<b>git-commit-tree</b>(1)</font></p>
|
1447
|
+
|
1448
|
+
|
1449
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>git
|
1450
|
+
Diffs</b> <i><br>
|
1451
|
+
GIT_DIFF_OPTS</i></font></p>
|
1452
|
+
|
1453
|
+
<p style="margin-left:17%;"><font color="#000000">Only
|
1454
|
+
valid setting is "−−unified=??" or
|
1455
|
+
"−u??" to set the number of context lines
|
1456
|
+
shown when a unified diff is created. This takes precedence
|
1457
|
+
over any "−U" or
|
1458
|
+
"−−unified" option value passed on the
|
1459
|
+
git diff command line.</font></p>
|
1460
|
+
|
1461
|
+
|
1462
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><i>GIT_EXTERNAL_DIFF</i></font></p>
|
1463
|
+
|
1464
|
+
<p style="margin-left:17%;"><font color="#000000">When the
|
1465
|
+
environment variable <i>GIT_EXTERNAL_DIFF</i> is set, the
|
1466
|
+
program named by it is called, instead of the diff
|
1467
|
+
invocation described above. For a path that is added,
|
1468
|
+
removed, or modified, <i>GIT_EXTERNAL_DIFF</i> is called
|
1469
|
+
with 7 parameters:</font></p>
|
1470
|
+
|
1471
|
+
|
1472
|
+
<p style="margin-left:23%; margin-top: 1em"><font color="#000000">path
|
1473
|
+
old−file old−hex old−mode new−file
|
1474
|
+
new−hex new−mode</font></p>
|
1475
|
+
|
1476
|
+
|
1477
|
+
<p style="margin-left:17%; margin-top: 1em"><font color="#000000">where:</font></p>
|
1478
|
+
|
1479
|
+
|
1480
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><old|new>−file</font></p>
|
1481
|
+
|
1482
|
+
<p style="margin-left:17%;"><font color="#000000">are files
|
1483
|
+
GIT_EXTERNAL_DIFF can use to read the contents of
|
1484
|
+
<old|new>,</font></p>
|
1485
|
+
|
1486
|
+
|
1487
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><old|new>−hex</font></p>
|
1488
|
+
|
1489
|
+
<p style="margin-left:17%;"><font color="#000000">are the
|
1490
|
+
40−hexdigit SHA1 hashes,</font></p>
|
1491
|
+
|
1492
|
+
|
1493
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><old|new>−mode</font></p>
|
1494
|
+
|
1495
|
+
<p style="margin-left:17%;"><font color="#000000">are the
|
1496
|
+
octal representation of the file modes.</font></p>
|
1497
|
+
|
1498
|
+
|
1499
|
+
<p style="margin-left:17%; margin-top: 1em"><font color="#000000">The
|
1500
|
+
file parameters can point at the user’s working file
|
1501
|
+
(e.g. new−file in
|
1502
|
+
"git−diff−files"), /dev/null (e.g.
|
1503
|
+
old−file when a new file is added), or a temporary
|
1504
|
+
file (e.g. old−file in the index).
|
1505
|
+
<i>GIT_EXTERNAL_DIFF</i> should not worry about unlinking
|
1506
|
+
the temporary file −−− it is removed when
|
1507
|
+
<i>GIT_EXTERNAL_DIFF</i> exits.</font></p>
|
1508
|
+
|
1509
|
+
|
1510
|
+
<p style="margin-left:17%; margin-top: 1em"><font color="#000000">For
|
1511
|
+
a path that is unmerged, <i>GIT_EXTERNAL_DIFF</i> is called
|
1512
|
+
with 1 parameter, <path>.</font></p>
|
1513
|
+
|
1514
|
+
|
1515
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>other</b>
|
1516
|
+
<i><br>
|
1517
|
+
GIT_MERGE_VERBOSITY</i></font></p>
|
1518
|
+
|
1519
|
+
<p style="margin-left:17%;"><font color="#000000">A number
|
1520
|
+
controlling the amount of output shown by the recursive
|
1521
|
+
merge strategy. Overrides merge.verbosity. See
|
1522
|
+
<b>git-merge</b>(1)</font></p>
|
1523
|
+
|
1524
|
+
|
1525
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><i>GIT_PAGER</i></font></p>
|
1526
|
+
|
1527
|
+
<p style="margin-left:17%;"><font color="#000000">This
|
1528
|
+
environment variable overrides $PAGER. If it is set to an
|
1529
|
+
empty string or to the value "cat", git will not
|
1530
|
+
launch a pager. See also the core.pager option in
|
1531
|
+
<b>git-config</b>(1).</font></p>
|
1532
|
+
|
1533
|
+
|
1534
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><i>GIT_SSH</i></font></p>
|
1535
|
+
|
1536
|
+
<p style="margin-left:17%;"><font color="#000000">If this
|
1537
|
+
environment variable is set then <i>git fetch</i> and <i>git
|
1538
|
+
push</i> will use this command instead of <i>ssh</i> when
|
1539
|
+
they need to connect to a remote system. The <i>$GIT_SSH</i>
|
1540
|
+
command will be given exactly two arguments: the
|
1541
|
+
<i>username@host</i> (or just <i>host</i>) from the URL and
|
1542
|
+
the shell command to execute on that remote
|
1543
|
+
system.</font></p>
|
1544
|
+
|
1545
|
+
|
1546
|
+
<p style="margin-left:17%; margin-top: 1em"><font color="#000000">To
|
1547
|
+
pass options to the program that you want to list in GIT_SSH
|
1548
|
+
you will need to wrap the program and options into a shell
|
1549
|
+
script, then set GIT_SSH to refer to the shell
|
1550
|
+
script.</font></p>
|
1551
|
+
|
1552
|
+
|
1553
|
+
<p style="margin-left:17%; margin-top: 1em"><font color="#000000">Usually
|
1554
|
+
it is easier to configure any desired options through your
|
1555
|
+
personal .ssh/config file. Please consult your ssh
|
1556
|
+
documentation for further details.</font></p>
|
1557
|
+
|
1558
|
+
|
1559
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><i>GIT_ASKPASS</i></font></p>
|
1560
|
+
|
1561
|
+
<p style="margin-left:17%;"><font color="#000000">If this
|
1562
|
+
environment variable is set, then git commands which need to
|
1563
|
+
acquire passwords or passphrases (e.g. for HTTP or IMAP
|
1564
|
+
authentication) will call this program with a suitable
|
1565
|
+
prompt as command line argument and read the password from
|
1566
|
+
its STDOUT. See also the <i>core.askpass</i> option in
|
1567
|
+
<b>git-config</b>(1).</font></p>
|
1568
|
+
|
1569
|
+
|
1570
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><i>GIT_FLUSH</i></font></p>
|
1571
|
+
|
1572
|
+
<p style="margin-left:17%;"><font color="#000000">If this
|
1573
|
+
environment variable is set to "1", then commands
|
1574
|
+
such as <i>git blame</i> (in incremental mode), <i>git
|
1575
|
+
rev−list</i>, <i>git log</i>, and <i>git
|
1576
|
+
whatchanged</i> will force a flush of the output stream
|
1577
|
+
after each commit−oriented record have been flushed.
|
1578
|
+
If this variable is set to "0", the output of
|
1579
|
+
these commands will be done using completely buffered I/O.
|
1580
|
+
If this environment variable is not set, git will choose
|
1581
|
+
buffered or record−oriented flushing based on whether
|
1582
|
+
stdout appears to be redirected to a file or not.</font></p>
|
1583
|
+
|
1584
|
+
|
1585
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><i>GIT_TRACE</i></font></p>
|
1586
|
+
|
1587
|
+
<p style="margin-left:17%;"><font color="#000000">If this
|
1588
|
+
variable is set to "1", "2" or
|
1589
|
+
"true" (comparison is case insensitive), git will
|
1590
|
+
print trace: messages on stderr telling about alias
|
1591
|
+
expansion, built−in command execution and external
|
1592
|
+
command execution. If this variable is set to an integer
|
1593
|
+
value greater than 1 and lower than 10 (strictly) then git
|
1594
|
+
will interpret this value as an open file descriptor and
|
1595
|
+
will try to write the trace messages into this file
|
1596
|
+
descriptor. Alternatively, if this variable is set to an
|
1597
|
+
absolute path (starting with a <i>/</i> character), git will
|
1598
|
+
interpret this as a file path and will try to write the
|
1599
|
+
trace messages into it.</font></p>
|
1600
|
+
|
1601
|
+
<a name="DISCUSSION"></a>
|
1602
|
+
<h2>DISCUSSION</h2>
|
1603
|
+
|
1604
|
+
|
1605
|
+
|
1606
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">More
|
1607
|
+
detail on the following is available from the</font>
|
1608
|
+
<b><font color="#0000FF">git concepts chapter of the
|
1609
|
+
user−manual</font></b>
|
1610
|
+
<small><font color="#000000">[3]</font></small>
|
1611
|
+
<font color="#000000">and
|
1612
|
+
<b>gitcore-tutorial</b>(7).</font></p>
|
1613
|
+
|
1614
|
+
|
1615
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">A
|
1616
|
+
git project normally consists of a working directory with a
|
1617
|
+
".git" subdirectory at the top level. The .git
|
1618
|
+
directory contains, among other things, a compressed object
|
1619
|
+
database representing the complete history of the project,
|
1620
|
+
an "index" file which links that history to the
|
1621
|
+
current contents of the working tree, and named pointers
|
1622
|
+
into that history such as tags and branch heads.</font></p>
|
1623
|
+
|
1624
|
+
|
1625
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">The
|
1626
|
+
object database contains objects of three main types: blobs,
|
1627
|
+
which hold file data; trees, which point to blobs and other
|
1628
|
+
trees to build up directory hierarchies; and commits, which
|
1629
|
+
each reference a single tree and some number of parent
|
1630
|
+
commits.</font></p>
|
1631
|
+
|
1632
|
+
|
1633
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">The
|
1634
|
+
commit, equivalent to what other systems call a
|
1635
|
+
"changeset" or "version", represents a
|
1636
|
+
step in the project’s history, and each parent
|
1637
|
+
represents an immediately preceding step. Commits with more
|
1638
|
+
than one parent represent merges of independent lines of
|
1639
|
+
development.</font></p>
|
1640
|
+
|
1641
|
+
|
1642
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">All
|
1643
|
+
objects are named by the SHA1 hash of their contents,
|
1644
|
+
normally written as a string of 40 hex digits. Such names
|
1645
|
+
are globally unique. The entire history leading up to a
|
1646
|
+
commit can be vouched for by signing just that commit. A
|
1647
|
+
fourth object type, the tag, is provided for this
|
1648
|
+
purpose.</font></p>
|
1649
|
+
|
1650
|
+
|
1651
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">When
|
1652
|
+
first created, objects are stored in individual files, but
|
1653
|
+
for efficiency may later be compressed together into
|
1654
|
+
"pack files".</font></p>
|
1655
|
+
|
1656
|
+
|
1657
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">Named
|
1658
|
+
pointers called refs mark interesting points in history. A
|
1659
|
+
ref may contain the SHA1 name of an object or the name of
|
1660
|
+
another ref. Refs with names beginning ref/head/ contain the
|
1661
|
+
SHA1 name of the most recent commit (or "head") of
|
1662
|
+
a branch under development. SHA1 names of tags of interest
|
1663
|
+
are stored under ref/tags/. A special ref named HEAD
|
1664
|
+
contains the name of the currently checked−out
|
1665
|
+
branch.</font></p>
|
1666
|
+
|
1667
|
+
|
1668
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">The
|
1669
|
+
index file is initialized with a list of all paths and, for
|
1670
|
+
each path, a blob object and a set of attributes. The blob
|
1671
|
+
object represents the contents of the file as of the head of
|
1672
|
+
the current branch. The attributes (last modified time,
|
1673
|
+
size, etc.) are taken from the corresponding file in the
|
1674
|
+
working tree. Subsequent changes to the working tree can be
|
1675
|
+
found by comparing these attributes. The index may be
|
1676
|
+
updated with new content, and new commits may be created
|
1677
|
+
from the content stored in the index.</font></p>
|
1678
|
+
|
1679
|
+
|
1680
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">The
|
1681
|
+
index is also capable of storing multiple entries (called
|
1682
|
+
"stages") for a given pathname. These stages are
|
1683
|
+
used to hold the various unmerged version of a file when a
|
1684
|
+
merge is in progress.</font></p>
|
1685
|
+
|
1686
|
+
<a name="AUTHORS"></a>
|
1687
|
+
<h2>AUTHORS</h2>
|
1688
|
+
|
1689
|
+
|
1690
|
+
|
1691
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">Git
|
1692
|
+
was started by Linus Torvalds, and is currently maintained
|
1693
|
+
by Junio C Hamano. Numerous contributions have come from the
|
1694
|
+
git mailing list
|
1695
|
+
<</font><b><font color="#0000FF">git@vger.kernel.org</font></b>
|
1696
|
+
<small><font color="#000000">[6]</font></small>
|
1697
|
+
<font color="#000000">>. For a more complete list of
|
1698
|
+
contributors, see</font>
|
1699
|
+
<b><font color="#0000FF">http://git−scm.com/about</font></b><font color="#000000">.
|
1700
|
+
If you have a clone of git.git itself, the output of
|
1701
|
+
<b>git-shortlog</b>(1) and <b>git-blame</b>(1) can show you
|
1702
|
+
the authors for specific parts of the project.</font></p>
|
1703
|
+
|
1704
|
+
<a name="REPORTING BUGS"></a>
|
1705
|
+
<h2>REPORTING BUGS</h2>
|
1706
|
+
|
1707
|
+
|
1708
|
+
|
1709
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">Report
|
1710
|
+
bugs to the Git mailing list
|
1711
|
+
<</font><b><font color="#0000FF">git@vger.kernel.org</font></b>
|
1712
|
+
<small><font color="#000000">[6]</font></small>
|
1713
|
+
<font color="#000000">> where the development and
|
1714
|
+
maintenance is primarily done. You do not have to be
|
1715
|
+
subscribed to the list to send a message there.</font></p>
|
1716
|
+
|
1717
|
+
<a name="SEE ALSO"></a>
|
1718
|
+
<h2>SEE ALSO</h2>
|
1719
|
+
|
1720
|
+
|
1721
|
+
|
1722
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000"><b>gittutorial</b>(7),
|
1723
|
+
<b>gittutorial-2</b>(7),</font>
|
1724
|
+
<b><font color="#0000FF">Everyday Git</font></b>
|
1725
|
+
<small><font color="#000000">[1]</font></small>
|
1726
|
+
<font color="#000000">, <b>gitcvs-migration</b>(7),
|
1727
|
+
<b>gitglossary</b>(7), <b>gitcore-tutorial</b>(7),
|
1728
|
+
<b>gitcli</b>(7),</font> <b><font color="#0000FF">The Git
|
1729
|
+
User’s Manual</font></b>
|
1730
|
+
<small><font color="#000000">[2]</font></small>
|
1731
|
+
<font color="#000000">, <b>gitworkflows</b>(7)</font></p>
|
1732
|
+
|
1733
|
+
<a name="GIT"></a>
|
1734
|
+
<h2>GIT</h2>
|
1735
|
+
|
1736
|
+
|
1737
|
+
|
1738
|
+
<p style="margin-left:11%; margin-top: 1em"><font color="#000000">Part
|
1739
|
+
of the <b>git</b>(1) suite</font></p>
|
1740
|
+
|
1741
|
+
<a name="NOTES"></a>
|
1742
|
+
<h2>NOTES</h2>
|
1743
|
+
|
1744
|
+
|
1745
|
+
<table width="100%" border=0 rules="none" frame="void"
|
1746
|
+
cellspacing="0" cellpadding="0">
|
1747
|
+
<tr valign="top" align="left">
|
1748
|
+
<td width="12%"></td>
|
1749
|
+
<td width="3%">
|
1750
|
+
|
1751
|
+
|
1752
|
+
|
1753
|
+
<p style="margin-top: 1em" valign="top"><font color="#000000">1.</font></p> </td>
|
1754
|
+
<td width="2%"></td>
|
1755
|
+
<td width="18%">
|
1756
|
+
|
1757
|
+
|
1758
|
+
|
1759
|
+
<p style="margin-top: 1em" valign="top"><font color="#000000">Everyday
|
1760
|
+
Git</font></p> </td>
|
1761
|
+
<td width="65%">
|
1762
|
+
</td>
|
1763
|
+
</table>
|
1764
|
+
|
1765
|
+
|
1766
|
+
<p style="margin-left:17%;"><font color="#000000">http://www.kernel.org/pub/software/scm/git/docs/everyday.html</font></p>
|
1767
|
+
|
1768
|
+
<table width="100%" border=0 rules="none" frame="void"
|
1769
|
+
cellspacing="0" cellpadding="0">
|
1770
|
+
<tr valign="top" align="left">
|
1771
|
+
<td width="12%"></td>
|
1772
|
+
<td width="3%">
|
1773
|
+
|
1774
|
+
|
1775
|
+
|
1776
|
+
<p style="margin-top: 1em" valign="top"><font color="#000000">2.</font></p> </td>
|
1777
|
+
<td width="2%"></td>
|
1778
|
+
<td width="26%">
|
1779
|
+
|
1780
|
+
|
1781
|
+
|
1782
|
+
<p style="margin-top: 1em" valign="top"><font color="#000000">Git
|
1783
|
+
User’s Manual</font></p></td>
|
1784
|
+
<td width="57%">
|
1785
|
+
</td>
|
1786
|
+
</table>
|
1787
|
+
|
1788
|
+
|
1789
|
+
<p style="margin-left:17%;"><font color="#000000">http://www.kernel.org/pub/software/scm/git/docs/user-manual.html</font></p>
|
1790
|
+
|
1791
|
+
<table width="100%" border=0 rules="none" frame="void"
|
1792
|
+
cellspacing="0" cellpadding="0">
|
1793
|
+
<tr valign="top" align="left">
|
1794
|
+
<td width="12%"></td>
|
1795
|
+
<td width="3%">
|
1796
|
+
|
1797
|
+
|
1798
|
+
|
1799
|
+
<p style="margin-top: 1em" valign="top"><font color="#000000">3.</font></p> </td>
|
1800
|
+
<td width="2%"></td>
|
1801
|
+
<td width="60%">
|
1802
|
+
|
1803
|
+
|
1804
|
+
|
1805
|
+
<p style="margin-top: 1em" valign="top"><font color="#000000">git
|
1806
|
+
concepts chapter of the user-manual</font></p></td>
|
1807
|
+
<td width="23%">
|
1808
|
+
</td>
|
1809
|
+
</table>
|
1810
|
+
|
1811
|
+
|
1812
|
+
<p style="margin-left:17%;"><font color="#000000">http://www.kernel.org/pub/software/scm/git/docs/user-manual.html#git-concepts</font></p>
|
1813
|
+
|
1814
|
+
<table width="100%" border=0 rules="none" frame="void"
|
1815
|
+
cellspacing="0" cellpadding="0">
|
1816
|
+
<tr valign="top" align="left">
|
1817
|
+
<td width="12%"></td>
|
1818
|
+
<td width="3%">
|
1819
|
+
|
1820
|
+
|
1821
|
+
|
1822
|
+
<p style="margin-top: 1em" valign="top"><font color="#000000">4.</font></p> </td>
|
1823
|
+
<td width="2%"></td>
|
1824
|
+
<td width="8%">
|
1825
|
+
|
1826
|
+
|
1827
|
+
|
1828
|
+
<p style="margin-top: 1em" valign="top"><font color="#000000">howto</font></p> </td>
|
1829
|
+
<td width="75%">
|
1830
|
+
</td>
|
1831
|
+
</table>
|
1832
|
+
|
1833
|
+
|
1834
|
+
<p style="margin-left:17%;"><font color="#000000">http://www.kernel.org/pub/software/scm/git/docs/howto-index.html</font></p>
|
1835
|
+
|
1836
|
+
<table width="100%" border=0 rules="none" frame="void"
|
1837
|
+
cellspacing="0" cellpadding="0">
|
1838
|
+
<tr valign="top" align="left">
|
1839
|
+
<td width="12%"></td>
|
1840
|
+
<td width="3%">
|
1841
|
+
|
1842
|
+
|
1843
|
+
|
1844
|
+
<p style="margin-top: 1em" valign="top"><font color="#000000">5.</font></p> </td>
|
1845
|
+
<td width="2%"></td>
|
1846
|
+
<td width="32%">
|
1847
|
+
|
1848
|
+
|
1849
|
+
|
1850
|
+
<p style="margin-top: 1em" valign="top"><font color="#000000">GIT
|
1851
|
+
API documentation</font></p></td>
|
1852
|
+
<td width="51%">
|
1853
|
+
</td>
|
1854
|
+
</table>
|
1855
|
+
|
1856
|
+
|
1857
|
+
<p style="margin-left:17%;"><font color="#000000">http://www.kernel.org/pub/software/scm/git/docs/technical/api-index.html</font></p>
|
1858
|
+
|
1859
|
+
<table width="100%" border=0 rules="none" frame="void"
|
1860
|
+
cellspacing="0" cellpadding="0">
|
1861
|
+
<tr valign="top" align="left">
|
1862
|
+
<td width="12%"></td>
|
1863
|
+
<td width="3%">
|
1864
|
+
|
1865
|
+
|
1866
|
+
|
1867
|
+
<p style="margin-top: 1em" valign="top"><font color="#000000">6.</font></p> </td>
|
1868
|
+
<td width="2%"></td>
|
1869
|
+
<td width="29%">
|
1870
|
+
|
1871
|
+
|
1872
|
+
|
1873
|
+
<p style="margin-top: 1em" valign="top"><font color="#000000">git@vger.kernel.org</font></p> </td>
|
1874
|
+
<td width="54%">
|
1875
|
+
</td>
|
1876
|
+
</table>
|
1877
|
+
|
1878
|
+
|
1879
|
+
<p style="margin-left:17%;"><font color="#000000">mailto:git@vger.kernel.org</font></p>
|
1880
|
+
<hr>
|
1881
|
+
</body>
|
1882
|
+
</html>
|