Установка мерзавца на OS X

Винсент Колайута поддерживает очень полезную базу знаний на wincent.com/wiki , которая является отличным источником информации на git ] в Mac OS X.

В частности, см. эти две статьи:

• Настройка цепочки сборки документации Git в Mac OS X Leopard
• Установка предварительно созданной документации Git из репозитория Git

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 xmlto and asciidoc from the yum repos were old, so I built them from source. Then xmlto (by way of xmllint) complained about missing DocBook 4.5, and I finally managed to get those in manually.

Getting this far, the doc build trundles happily along until

    DB2TEXI user-manual.texi
/bin/sh: line 1: docbook2x-texi: command not found
make[1]: *** [user-manual.texi] Error 127

But docbook2x is installed! Ah, the command is different:

$ rpm -q --filesbypkg docbook2x | grep bin.\*texi
docbook2x                 /usr/bin/db2x_docbook2texi
docbook2x                 /usr/bin/db2x_texixml

Even trying to run it manually, I still find no joy:

$ 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.

The bottom of INSTALL mentions a couple of handy make targets: quick-install-man and quick-install-html. It turns, for example, out that

$ make prefix=/usr/local quick-install-man

is equivalent to

$ ./Documentation/install-doc-quick.sh origin/man /usr/local/share/man

That has a couple of problems: we need a git repo to use these targets, and the heads of the man and html branches may not correspond to the version you're installing.

So, a quick-and-dirty bootstrap:

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)

Notes:

1. At this point, git will live in /usr/local/bin.
2. Now you'll have the same tree as the previous step on a detached head.
3. The SHA-1 comes from the last 1.6.4.2 commit in git log origin/man.
4. Same as above, except from origin/html.
5. Profit!

Случайная мысль; где установлены ваши справочные страницы Git? Я предполагаю в / usr / local / git / man . Если да, убедитесь, что это находится в вашем $ MANPATH:

echo $MANPATH

. Если у вас там нет git manpath,

Я только что нашел этот приятный раствор для цепной задачи Git Ampages на OS X . Для удобства здесь есть (заменить: git-manpages-1.6.6.tar.bz2 с вашей версией Git, а / usr / local / туда везде, где ваш git установлен ):

$ curl -O http://kernel.org/pub/software/scm/git/git-manpages-1.6.6.tar.bz2
$ sudo tar xvf git-manpages-1.6.6.tar.bz2 -C /usr/local/man

тогда, (как указывает BOBLET), проверьте для Git Manath:

echo $MANPATH

и настроить при необходимости:

Если вы работаете с клоном репозитория исходного кода git, вы можете сделать что-то вроде этого:

git archive origin/man | sudo tar -x -C /usr/local/share/man

Найдено на http://johnreilly.tumblr.com/post/41241198/installing-git-man-pages - Я использую его уже некоторое время, и он просто работает очень хорошо.

У меня была аналогичная проблема при сборке Cygwin ранее на этой неделе (сбой при попытке загрузить сетевой объект), и, немного поглянув, я обнаружил, что проблема заключалась в отсутствии xml-каталога. В Cygwin есть сценарий с именем build-docbook-catalog . Инструмент, вероятно, пытался запустить автоматически, но когда я запускал его вручную, он не удался из-за отсутствия каталога / etc / xml .

Источник build-docbook-catalog , вероятно, здесь , но я не могу подтвердить это прямо сейчас, поскольку у меня нет Windows или Cygwin.

Я понимаю, что на этот вопрос давно уже дан ответ, но я наткнулся на эту страницу, когда искал ответ на свою проблему, так что, надеюсь, это сэкономит время для кого-то еще.