Note that there are some explanatory texts on larger screens.

plurals
  1. PO
    primarykey
    data
    text
    <p>I recently installed git-1.6.4.2 on CentOS 5.3. Building git was no trouble, but attempting to install the accompanying docs produced pain at every step. The versions of <code>xmlto</code> and <code>asciidoc</code> from the yum repos were old, so I built them from source. Then <code>xmlto</code> (by way of <code>xmllint</code>) complained about missing DocBook 4.5, and I finally managed to get those in manually.</p> <p>Getting this far, the doc build trundles happily along until</p> <pre> DB2TEXI user-manual.texi /bin/sh: line 1: docbook2x-texi: command not found make[1]: *** [user-manual.texi] Error 127</pre> <p>But docbook2x is installed! Ah, the command is different:</p> <pre>$ rpm -q --filesbypkg docbook2x | grep bin.\*texi docbook2x /usr/bin/db2x_docbook2texi docbook2x /usr/bin/db2x_texixml</pre> <p>Even trying to run it manually, I still find no joy:</p> <pre>$ db2x_docbook2texi user-manual.xml --encoding=UTF-8 --to-stdout >user-manual.texi++ docbook2texi:/book: no description for directory entry /usr/bin/db2x_texixml:-::node: fatal error: node belongs to a different file Died at /usr/bin/db2x_texixml line 959.</pre> <p>The bottom of <a href="http://git.kernel.org/?p=git/git.git;a=blob;f=INSTALL;h=ae7f7508f8e8cffeb930c820e068ba70dabff7bd;hb=82c3e210002d452867a46a9d8806a8aee82ae9d0" rel="noreferrer">INSTALL</a> mentions a couple of handy <code>make</code> targets: quick-install-man and quick-install-html. It turns, for example, out that</p> <p><code>$ make prefix=/usr/local quick-install-man</code></p> <p>is equivalent to</p> <p><code>$ ./Documentation/install-doc-quick.sh origin/man /usr/local/share/man</code></p> <p>That has a couple of problems: we need a git repo to use these targets, and the heads of the <code>man</code> and <code>html</code> branches may not correspond to the version you're installing.</p> <p>So, a quick-and-dirty bootstrap:</p> <pre>tar xfz git-1.6.4.2.tar.gz cd git-1.6.4.2 make prefix=/usr/local all sudo make prefix=/usr/local install # (1) cd .. git clone git://git.kernel.org/pub/scm/git/git.git cd git git checkout v1.6.4.2 # (2) # (3) ./Documentation/install-doc-quick.sh \ c8b9e605d51dd2f0c7ce6a363df31171af16534c \ /usr/local/share/man # (4) ./Documentation/install-doc-quick.sh \ 35b47ca5285a4059792ba937f8e09b2ab4a7adf4 \ /usr/local/share/doc/git-doc git init --help # (5)</pre> <p>Notes:</p> <ol> <li>At this point, git will live in <code>/usr/local/bin</code>.</li> <li>Now you'll have the same tree as the previous step on a <a href="http://www.kernel.org/pub/software/scm/git/docs/user-manual.html#detached-head" rel="noreferrer">detached head</a>.</li> <li>The SHA-1 comes from the last 1.6.4.2 commit in <code>git log origin/man</code>.</li> <li>Same as above, except from <code>origin/html</code>.</li> <li>Profit!</li> </ol>
    singulars
    1. This table or related slice is empty.
    plurals
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. VO
      singulars
      1. This table or related slice is empty.
    2. VO
      singulars
      1. This table or related slice is empty.
    3. VO
      singulars
      1. This table or related slice is empty.
    1. This table or related slice is empty.
 

Querying!

 
Guidance

SQuiL has stopped working due to an internal error.

If you are curious you may find further information in the browser console, which is accessible through the devtools (F12).

Reload