Changeset 435934c


Ignore:
Timestamp:
02/23/2012 11:53:00 PM (12 years ago)
Author:
Andrew Benton <andy@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 7.10, 7.4, 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
Children:
f6f5b67
Parents:
bfe3828
Message:

added download links for the git man pages and html docs

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@9507 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • general/prog/git.xml

    rbfe3828 r435934c  
    6767    </itemizedlist>
    6868
     69    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
     70    <itemizedlist spacing="compact">
     71      <listitem>
     72        <para><ulink
     73        url="http://git-core.googlecode.com/files/git-manpages-&git-version;.2.tar.gz">Man
     74        Pages</ulink> (only needed if you've not installed asciidoc)</para>
     75      </listitem>
     76      <listitem>
     77        <para><ulink
     78        url="http://git-core.googlecode.com/files/git-htmldocs-&git-version;.2.tar.gz">Html
     79        version of the Man Pages</ulink> and other docs (only needed if you've
     80        not installed asciidoc and xmlto).</para>
     81      </listitem>
     82    </itemizedlist>
     83
    6984    <bridgehead renderas="sect3">Git Dependencies</bridgehead>
    7085
    … …  
    8297
    8398    <bridgehead renderas="sect4">Optional (to create the man
    84     pages)</bridgehead>
     99    pages and html docs)</bridgehead>
    85100    <para><ulink url="http://www.methods.co.nz/asciidoc/">AsciiDoc</ulink> and
    86101    <xref linkend="xmlto"/>.</para>
    … …  
    100115
    101116    <para>If you have installed <ulink
     117    url="http://www.methods.co.nz/asciidoc/">AsciiDoc</ulink> and you wish to
     118    create the man pages:</para>
     119
     120<screen><userinput>make man</userinput></screen>
     121
     122    <para>If you have installed <ulink
    102123    url="http://www.methods.co.nz/asciidoc/">AsciiDoc</ulink> and
    103     <xref linkend="xmlto"/> and you wish to create the man pages:</para>
    104 
    105 <screen><userinput>make man</userinput></screen>
     124    <xref linkend="xmlto"/> you can create the html version of the man
     125    pages and other docs:</para>
     126
     127<screen><userinput>make html</userinput></screen>
    106128
    107129    <para>To check the results, issue: <command>make test</command>.</para>
    … …  
    112134<screen role="root"><userinput>make install</userinput></screen>
    113135
    114     <para>If you created the man pages, install them:</para>
     136    <para>If you created the man pages, install them as the
     137    <systemitem class="username">root</systemitem> user:</para>
    115138
    116139<screen role="root"><userinput>make install-man</userinput></screen>
     140
     141    <para>If you created the html docs, install them as the
     142    <systemitem class="username">root</systemitem> user:</para>
     143
     144<screen role="root"><userinput>make htmldir=/usr/share/doc/git-&git-version; install-html &amp;&amp;
     145mkdir -p /usr/share/doc/git-&git-version;/man-pages/{html,text} &amp;&amp;
     146mv /usr/share/doc/git-&git-version;/{git*.txt,man-pages/text} &amp;&amp;
     147mv /usr/share/doc/git-&git-version;/{git*.,index.,man-pages/}html &amp;&amp;
     148mkdir /usr/share/doc/git-&git-version;/technical/{html,text} &amp;&amp;
     149mv /usr/share/doc/git-&git-version;/technical/{*.txt,text} &amp;&amp;
     150mv /usr/share/doc/git-&git-version;/technical/{*.,}html &amp;&amp;
     151mkdir /usr/share/doc/git-&git-version;/howto/{html,text} &amp;&amp;
     152mv /usr/share/doc/git-&git-version;/howto/{*.txt,text} &amp;&amp;
     153mv /usr/share/doc/git-&git-version;/howto/{*.,}html</userinput></screen>
     154
     155    <para>Alternatively, If you downloaded the man pages untar them as the
     156    <systemitem class="username">root</systemitem> user:</para>
     157
     158<screen role="root"><userinput>tar xf ../git-manpages-&git-version;.2.tar.gz -C /usr/share/man --no-same-owner</userinput></screen>
     159
     160    <para>If you downloaded the html docs untar them as the
     161    <systemitem class="username">root</systemitem> user:</para>
     162
     163<screen role="root"><userinput>mkdir -p /usr/share/doc/git-&git-version;/man-pages/{html,text} &amp;&amp;
     164tar -xf ../git-htmldocs-&git-version;.2.tar.gz \
     165  -C /usr/share/doc/git-&git-version; --no-same-owner &amp;&amp;
     166mv /usr/share/doc/git-&git-version;/{git*.txt,man-pages/text} &amp;&amp;
     167mv /usr/share/doc/git-&git-version;/{git*.,index.,man-pages/}html &amp;&amp;
     168mkdir /usr/share/doc/git-&git-version;/technical/{html,text} &amp;&amp;
     169mv /usr/share/doc/git-&git-version;/technical/{*.txt,text} &amp;&amp;
     170mv /usr/share/doc/git-&git-version;/technical/{*.,}html &amp;&amp;
     171mkdir /usr/share/doc/git-&git-version;/howto/{html,text} &amp;&amp;
     172mv /usr/share/doc/git-&git-version;/howto/{*.txt,text} &amp;&amp;
     173mv /usr/share/doc/git-&git-version;/howto/{*.,}html</userinput></screen>
    117174  </sect2>
    118175
    … …  
    123180    <filename>/etc/gitconfig</filename> as the file that stores the default,
    124181    system wide, <application>Git</application> settings.</para>
     182
     183    <para><command>tar xf ../git-manpages-&git-version;.2.tar.gz -C
     184    /usr/share/man --no-same-owner</command>: This untars
     185    <filename>git-manpages-&git-version;.2.tar.gz</filename>. The
     186    <option>-C</option> option makes tar change directory to
     187    <filename class="directory">/usr/share/man</filename> before it starts to
     188    decompress the docs. The <option>--no-same-owner</option> option stops tar
     189    from preserving the user and group details of the files. This is useful as
     190    that user or group may not exist on your system; this could
     191    (potentially) be a security risk.</para>
     192
     193    <para><command>mv /usr/share/doc/git-&git-version; ...</command>: These
     194    commands move some of the files into subfolders to make it easier to sort
     195    through the docs and find what you're looking for.</para>
    125196  </sect2>
    126197
    … …  
    166237        <seg>git, git-cvsserver, gitk, git-receive-pack, git-shell,
    167238        git-upload-archive and git-upload-pack.</seg>
    168         <seg>/usr/libexec/git-core, /usr/share/git-core, /usr/share/git-gui,
    169         /usr/share/gitk and /usr/share/gitweb</seg>
     239        <seg>/usr/libexec/git-core, /usr/share/git-&git-version;,
     240        /usr/share/git-core, /usr/share/git-gui, /usr/share/gitk and
     241        /usr/share/gitweb</seg>
    170242      </seglistitem>
    171243    </segmentedlist>
Note: See TracChangeset for help on using the changeset viewer.