Как установить справочные страницы Git на OS X?

Question

Я установил Git по ссылке Mac OS X здесь http://git -scm.com / download

После установки я пробую в терминале следующее:

$ git help fetch
$ git help remote
$ man git
$ man git-fetch

Однако я получаю сообщение No manual entry for git-<subcommand>.Как установить справочные страницы для Git?У меня та же проблема, что и , объясненная здесь , но kernel.org не работает, поэтому он мало помогает.

Answer 1

Нашел.

$ cd /usr/local/git/share/man
$ sudo git clone http://git.kernel.org/pub/scm/git/git-manpages.git

Затем в .bash_profile добавьте следующую строку:

export MANPATH="${MANPATH}:/usr/local/git/share/man/git-manpages"

Answer 2

Не устанавливайте переменную MANPATH в OS X ... это сломает man!
Эти инструкции будут работать, ничего не сломают, и вы можете автоматизировать с помощью скрипта.

1) естьисходный файл для man-страницы, которую вы хотите установить (т.е. документ, отформатированный с помощью groff).Если исходный файл представляет собой простой текст, вы можете использовать такой инструмент, как txt2man, чтобы преобразовать его, или вы можете изучить синтаксис groff и отформатировать его вручную.Я нашел хороший способ создания правильно отформатированных man-страниц здесь .

2) Назовите файл после команды, которую он документирует, с суффиксом того, к какому разделу он принадлежит. Большинствоman-страницы находятся в man1, поэтому, если у вас есть исходный файл git man, назовите его «git.1», если он еще не назван правильно.

3) предоставьте исходному файлу правильные разрешения:
sudo chown root: admin git.1
sudo chmod 444 git.1

4) заархивируйте исходный файл (Iиспользуйте tar):
sudo tar -czf git.1.gz git.1

5) переместите файл с архивом в нужное место (используйте аргумент -n, чтобы предотвратить запись поверх существующей страницы man)
sudo mv -n git.1.gz / usr / share / man / man1 /

все готово.

man git

Answer 3

Кроме того, вместо:

$ help git fetch

Вы бы хотели:

$ git help fetch

Answer 4

Я использую этот скрипт (с верхнего уровня моего локального репозитория исходного кода git), чтобы обновить мою установку git, собрать ее, обновить ветку документации и установить страницы руководства

git checkout master;  # Makes sure I am on the master branch
git pull; # pull the changes down
make prefix=/usr/local/git all; # configure my local installation directory
sudo make prefix=/usr/local/git install; # Make and install the git binaries
sudo git clean -dxf; # clear out the intermediate files created during compilation
git checkout html; # checkout my local html which tracks origin/html
git pull; # Pull the changes down. I leave the repo with this branch so I can see all the documentation
git archive origin/man | tar xvC /usr/local/share/man; # Install the manpages.

Последняя строкатот, который распаковывает и устанавливает страницы руководства.Он создает zip-архив man-страниц в хранилище, но вместо того, чтобы записывать их в файл, направляет его в каталог управления.

Answer 5

Вы хотите попробовать:

git fetch --help

Answer 6

Добавьте /usr/local/git/share/man к переменной окружения MANPATH вашей оболочки.