source: general/prog/git.xml@ adf6dd9a

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since adf6dd9a was 35943a41, checked in by Igor Živković <igor@…>, 11 years ago

update to git-1.8.4.1

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@11921 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 14.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY git-download-http "http://git-core.googlecode.com/files/git-&git-version;.tar.gz">
8 <!ENTITY git-download-ftp " ">
9 <!ENTITY git-md5sum "5d8c89ad312ca0b0e603259c9357e6b8">
10 <!ENTITY git-size "4.5 MB">
11 <!ENTITY git-buildsize "233 MB">
12 <!ENTITY git-time "0.7 SBU (additional 2.8 SBU for tests)">
13]>
14
15<sect1 id="git" xreflabel="git-&git-version;">
16 <?dbhtml filename="git.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Git-&git-version;</title>
24
25 <indexterm zone="git">
26 <primary sortas="a-Git">Git</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Git</title>
31
32 <para>
33 <application>Git</application> is a free and open source, distributed
34 version control system designed to handle everything from small to very
35 large projects with speed and efficiency. Every
36 <application>Git</application> clone is a full-fledged repository with
37 complete history and full revision tracking capabilities, not dependent on
38 network access or a central server. Branching and merging are fast and easy
39 to do. <application>Git</application> is used for version control of files,
40 much like tools such as <application>Mercurial</application>,
41 <application>Bazaar</application>, <xref linkend="subversion"/>,
42 <xref linkend="cvs"/>, <application>Perforce</application>, and
43 <application>Team Foundation Server</application>.
44 </para>
45
46 &lfs74_checked;
47
48 <bridgehead renderas="sect3">Package Information</bridgehead>
49 <itemizedlist spacing="compact">
50 <listitem>
51 <para>
52 Download (HTTP): <ulink url="&git-download-http;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download (FTP): <ulink url="&git-download-ftp;"/>
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download MD5 sum: &git-md5sum;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Download size: &git-size;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated disk space required: &git-buildsize;
73 </para>
74 </listitem>
75 <listitem>
76 <para>
77 Estimated build time: &git-time;
78 </para>
79 </listitem>
80 </itemizedlist>
81
82 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
83 <itemizedlist spacing="compact">
84 <listitem>
85 <para>
86 <ulink url="http://git-core.googlecode.com/files/git-manpages-&git-version;.tar.gz">
87 http://git-core.googlecode.com/files/git-manpages-&git-version;.tar.gz</ulink>
88 (only needed if you've not installed asciidoc and xmlto)
89 </para>
90 </listitem>
91 <listitem>
92 <para>
93 <ulink url="http://git-core.googlecode.com/files/git-htmldocs-&git-version;.tar.gz">
94 http://git-core.googlecode.com/files/git-htmldocs-&git-version;.tar.gz</ulink>
95 and other docs (only needed if you've not installed asciidoc).
96 </para>
97 </listitem>
98 </itemizedlist>
99
100 <bridgehead renderas="sect3">Git Dependencies</bridgehead>
101
102 <bridgehead renderas="sect4">Recommended</bridgehead>
103 <para role="recommended">
104 <xref linkend="curl"/> (needed to use <application>Git</application> over http,
105 https, ftp or ftps),
106 <xref linkend="expat"/>,
107 <xref linkend="openssl"/> and
108 <xref linkend="python2"/>
109 </para>
110
111 <bridgehead renderas="sect4">Optional</bridgehead>
112 <para role="optional">
113 <xref linkend="pcre"/>,
114 <xref linkend="subversion"/> with Perl bindings (for <command>git svn</command>), and
115 <xref linkend="tk"/> (gitk, a simple <application>Git</application>
116 repository viewer, uses <application>Tk</application> at runtime)
117 </para>
118
119 <bridgehead renderas="sect4">Optional (to create the man pages and html docs)</bridgehead>
120 <para>
121 <ulink url="http://www.methods.co.nz/asciidoc/">AsciiDoc</ulink> and
122 <xref linkend="xmlto"/>
123 </para>
124
125 <para condition="html" role="usernotes">User Notes:
126 <ulink url="&blfs-wiki;/git"/>
127 </para>
128 </sect2>
129
130 <sect2 role="installation">
131 <title>Installation of Git</title>
132
133 <para>
134 Install <application>Git</application> by running the following
135 commands:
136 </para>
137
138<screen><userinput>./configure --prefix=/usr \
139 --libexecdir=/usr/lib \
140 --with-gitconfig=/etc/gitconfig &amp;&amp;
141make</userinput></screen>
142
143 <para>
144 If you have installed <ulink
145 url="http://www.methods.co.nz/asciidoc/">AsciiDoc</ulink> you can
146 create the html version of the man pages and other docs:
147 </para>
148
149<screen><userinput>make html</userinput></screen>
150
151 <para>
152 If you have installed <ulink
153 url="http://www.methods.co.nz/asciidoc/">AsciiDoc</ulink> and
154 <xref linkend="xmlto"/> you can create the man pages:
155 </para>
156
157<screen><userinput>make man</userinput></screen>
158
159 <para>
160 To check the results, issue: <command>make test</command>.
161 </para>
162
163 <para>
164 Now, as the <systemitem class="username">root</systemitem>
165 user:
166 </para>
167
168<screen role="root"><userinput>make install</userinput></screen>
169
170 <para>
171 If you created the man pages, install them as the
172 <systemitem class="username">root</systemitem> user:
173 </para>
174
175<screen role="root"><userinput>make install-man</userinput></screen>
176
177 <para>
178 If you created the html docs, install them as the
179 <systemitem class="username">root</systemitem> user:
180 </para>
181
182<screen role="root"><userinput>make htmldir=/usr/share/doc/git-&git-version; install-html &amp;&amp;
183mkdir -p /usr/share/doc/git-&git-version;/man-pages/{html,text} &amp;&amp;
184mv /usr/share/doc/git-&git-version;/{git*.txt,man-pages/text} &amp;&amp;
185mv /usr/share/doc/git-&git-version;/{git*.,index.,man-pages/}html &amp;&amp;
186mkdir /usr/share/doc/git-&git-version;/technical/{html,text} &amp;&amp;
187mv /usr/share/doc/git-&git-version;/technical/{*.txt,text} &amp;&amp;
188mv /usr/share/doc/git-&git-version;/technical/{*.,}html &amp;&amp;
189mkdir /usr/share/doc/git-&git-version;/howto/{html,text} &amp;&amp;
190mv /usr/share/doc/git-&git-version;/howto/{*.txt,text} &amp;&amp;
191mv /usr/share/doc/git-&git-version;/howto/{*.,}html</userinput></screen>
192
193 <para>
194 Alternatively, If you downloaded the man pages untar them as the
195 <systemitem class="username">root</systemitem> user:
196 </para>
197
198<screen role="root"><userinput>tar -xf ../git-manpages-&git-version;.tar.gz -C /usr/share/man --no-same-owner --no-overwrite-dir</userinput></screen>
199
200 <para>
201 If you downloaded the html docs untar them as the
202 <systemitem class="username">root</systemitem> user:
203 </para>
204
205<screen role="root"><userinput>mkdir -p /usr/share/doc/git-&git-version;/man-pages/{html,text} &amp;&amp;
206
207tar -xf ../git-htmldocs-&git-version;.tar.gz \
208 -C /usr/share/doc/git-&git-version; --no-same-owner --no-overwrite-dir &amp;&amp;
209
210find /usr/share/doc/git-&git-version; -type d -exec chmod 755 {} \; &amp;&amp;
211find /usr/share/doc/git-&git-version; -type f -exec chmod 644 {} \; &amp;&amp;
212
213mv /usr/share/doc/git-&git-version;/{git*.txt,man-pages/text} &amp;&amp;
214mv /usr/share/doc/git-&git-version;/{git*.,index.,man-pages/}html &amp;&amp;
215mkdir /usr/share/doc/git-&git-version;/technical/{html,text} &amp;&amp;
216mv /usr/share/doc/git-&git-version;/technical/{*.txt,text} &amp;&amp;
217mv /usr/share/doc/git-&git-version;/technical/{*.,}html &amp;&amp;
218mkdir /usr/share/doc/git-&git-version;/howto/{html,text} &amp;&amp;
219mv /usr/share/doc/git-&git-version;/howto/{*.txt,text} &amp;&amp;
220mv /usr/share/doc/git-&git-version;/howto/{*.,}html</userinput></screen>
221
222 </sect2>
223
224 <sect2 role="commands">
225 <title>Command Explanations</title>
226
227 <para>
228 <parameter>--with-gitconfig=/etc/gitconfig</parameter>: This sets
229 <filename>/etc/gitconfig</filename> as the file that stores
230 the default, system wide, <application>Git</application>
231 settings.
232 </para>
233
234 <para>
235 <option>--without-python</option>: Use this switch if
236 <application>Python</application> is not installed.
237 </para>
238
239 <para>
240 <option>--with-libpcre</option>: Use this switch if
241 <application>PCRE</application> is installed.
242 </para>
243
244 <para>
245 <command>tar -xf ../git-manpages-&git-version;.tar.gz -C
246 /usr/share/man --no-same-owner</command>: This untars
247 <filename>git-manpages-&git-version;.tar.gz</filename>. The
248 <option>-C</option> option makes tar change directory to
249 <filename class="directory">/usr/share/man</filename> before
250 it starts to decompress the docs. The <option>--no-same-owner</option>
251 option stops tar from preserving the user and group details of the
252 files. This is useful as that user or group may not exist on your
253 system; this could (potentially) be a security risk.
254 </para>
255
256 <para>
257 <command>mv /usr/share/doc/git-&git-version; ...</command>: These
258 commands move some of the files into subfolders to make it easier to sort
259 through the docs and find what you're looking for.
260 </para>
261
262 <para>
263 <command>find ... chmod ...</command>: These commands correct the
264 permissions in the shipped documentation tar file.
265 </para>
266
267 </sect2>
268
269 <sect2 role="configuration">
270 <title>Configuring Git</title>
271
272 <sect3 id="git-config">
273 <title>Config Files</title>
274 <para>
275 <filename>~/.gitconfig</filename> and
276 <filename>/etc/gitconfig</filename>
277 </para>
278
279 <indexterm zone="git git-config">
280 <primary sortas="e-AA.gitconfig">~/.gitconfig</primary>
281 </indexterm>
282
283 <indexterm zone="git git-config">
284 <primary sortas="e-etc-gitconfig">/etc/gitconfig</primary>
285 </indexterm>
286
287 </sect3>
288
289 </sect2>
290
291 <sect2 role="content">
292 <title>Contents</title>
293
294 <segmentedlist>
295 <segtitle>Installed Programs</segtitle>
296 <segtitle>Installed Libraries</segtitle>
297 <segtitle>Installed Directories</segtitle>
298
299 <seglistitem>
300 <seg>
301 git, git-cvsserver, gitk, git-receive-pack, git-shell,
302 git-upload-archive and git-upload-pack
303 </seg>
304 <seg>
305 None
306 </seg>
307 <seg>
308 /usr/lib/git-core,
309 /usr/share/doc/git-&git-version;,
310 /usr/share/git-core,
311 /usr/share/git-gui,
312 /usr/share/gitk and
313 /usr/share/gitweb
314 </seg>
315 </seglistitem>
316 </segmentedlist>
317
318 <variablelist>
319 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
320 <?dbfo list-presentation="list"?>
321 <?dbhtml list-presentation="table"?>
322
323 <varlistentry id="git-prog">
324 <term><command>git</command></term>
325 <listitem>
326 <para>
327 is the stupid content tracker.
328 </para>
329 <indexterm zone="git git-prog">
330 <primary sortas="b-git">git</primary>
331 </indexterm>
332 </listitem>
333 </varlistentry>
334
335 <varlistentry id="git-cvsserver">
336 <term><command>git-cvsserver</command></term>
337 <listitem>
338 <para>
339 is a CVS server emulator for <application>Git</application>.
340 </para>
341 <indexterm zone="git git-cvsserver">
342 <primary sortas="b-git-cvsserver">git-cvsserver</primary>
343 </indexterm>
344 </listitem>
345 </varlistentry>
346
347 <varlistentry id="gitk">
348 <term><command>gitk</command></term>
349 <listitem>
350 <para>
351 is a graphical <application>Git</application> repository browser
352 (needs <xref linkend="tk"/>).
353 </para>
354 <indexterm zone="git gitk">
355 <primary sortas="b-gitk">gitk</primary>
356 </indexterm>
357 </listitem>
358 </varlistentry>
359
360 <varlistentry id="git-receive-pack">
361 <term><command>git-receive-pack</command></term>
362 <listitem>
363 <para>
364 is invoked by <command>git send-pack</command> and updates the
365 repository with the information fed from the remote end.
366 </para>
367 <indexterm zone="git git-receive-pack">
368 <primary sortas="b-git-receive-pack">git-receive-pack</primary>
369 </indexterm>
370 </listitem>
371 </varlistentry>
372
373 <varlistentry id="git-shell">
374 <term><command>git-shell</command></term>
375 <listitem>
376 <para>
377 is a login shell for SSH accounts to provide restricted Git
378 access.
379 </para>
380 <indexterm zone="git git-shell">
381 <primary sortas="b-git-shell">git-shell</primary>
382 </indexterm>
383 </listitem>
384 </varlistentry>
385
386 <varlistentry id="git-upload-archive">
387 <term><command>git-upload-archive</command></term>
388 <listitem>
389 <para>
390 is invoked by <command>git archive --remote</command> and sends
391 a generated archive to the other end over the git protocol.
392 </para>
393 <indexterm zone="git git-upload-archive">
394 <primary sortas="b-git-upload-archive">git-upload-archive</primary>
395 </indexterm>
396 </listitem>
397 </varlistentry>
398
399 <varlistentry id="git-upload-pack">
400 <term><command>git-upload-pack</command></term>
401 <listitem>
402 <para>
403 is invoked by <command>git fetch-pack</command>, it discovers
404 what objects the other side is missing, and sends them after
405 packing.
406 </para>
407 <indexterm zone="git git-upload-pack">
408 <primary sortas="b-git-upload-pack">git-upload-pack</primary>
409 </indexterm>
410 </listitem>
411 </varlistentry>
412
413 </variablelist>
414
415 </sect2>
416
417</sect1>
Note: See TracBrowser for help on using the repository browser.