Страница руководства Git кажется неверной - PullRequest
5 голосов
/ 23 ноября 2011

Я новичок в Git, поэтому, пожалуйста, извините, если это глупый вопрос.

Я установил git 1.7.7.4 из исходного кода на SLES Linux, и все выглядит хорошо. Я добавил следующее к $ MANPATH:

/usr/local/git-1.7.7.4/share/man

Когда я делаю man git, мне преподносят

Git(3)         User Contributed Perl Documentation         Git(3)

NAME
       Git - Perl interface to the Git version control system

SYNOPSIS
...

Это не похоже на man-страницу для команды git, которую я использую из командной строки. Либо это? Звучит как что-то для Perl, очевидно. Вот онлайн-версия полной справочной страницы, которую я вижу.

Если это неправильные справочные страницы, где я могу их найти? Я могу дать список каталогов моей установки git, если это необходимо. Спасибо.

Ответы [ 6 ]

8 голосов
/ 23 ноября 2011

Вы можете создавать справочные страницы из исходного пакета с помощью make man && make install-man.Страницы руководства не создаются по умолчанию, см. Файл git INSTALL:

Чтобы собрать и установить пакет документации, вам необходим набор инструментов asciidoc / xmlto.Поскольку не многие люди склонны устанавливать инструменты, цель сборки по умолчанию («make all») делает , а не их сборку.

«make doc» создает документацию в форматах man и html;есть также «make man», «make html» и «make info».Обратите внимание, что для "make html" требуется asciidoc, но не xmlto."сделать человека" (и, следовательно, сделать док) требует обоих.

6 голосов
/ 23 ноября 2011

Вы получаете неправильный раздел справочных страниц для git.Требуемая информация находится в разделе 1. Используйте man 1 git, чтобы получить правильный раздел руководства.

Список доступных разделов руководства можно посмотреть здесь .

2 голосов
/ 27 февраля 2016

Обновление git 2.8 (март 2016 г.)

Установка из источников упоминает, чтобы создать документацию и справочные страницы:

$ make all doc info
$ sudo make install install-doc install-html install-info

Подтверждаюman git напрямую получит вас man (1) git.
Это содержимое отличается от git README, который только что потерял злобный "тупой трекер контента" (сказал, что README теперь markdown-enabled README.md!)

README.md: не называйте git глупым в заголовке

«Отслеживание глупого контента» было верно в началедни Git, но вряд ли применимы в наши дни.
"быстрый, масштабируемый, распределенный" описывает Git более точно.

Кроме того, некоторые люди считают "глупым" оскорбительным.Давайте не будем использовать его в самых первых словах README.

. Справочная страница должна вскоре последовать ее примеру.

0 голосов
/ 09 декабря 2013

Делайте то, что сказали они (другие ответчики), и, если у вас все еще есть та же проблема (или кто-либо другой), убедитесь, что у вас не установлена ​​переменная среды MANSECT, что также может привести к возникновению этой проблемы.Это список разделенных двоеточиями разделов для проверки в порядке убывания (первый раздел пробуется в начале списка, последний - в конце).Если я MANSECT = 3, я могу продублировать вашу проблему, однако, в зависимости от того, насколько вы опытный пользователь, это может показаться очевидной вещью.И последнее, но не менее важное: убедитесь, что не заданы псевдонимы, функции (bash) или сценарии, которые пересекают команду 'man' (потому что man --section явно сообщит man, какой раздел искать в том же формате, что и MANSECT) дляman, так как --Section переопределяет переменную MANSECT.В то время как вы проверяете переменную MANOPT на наличие флагов «--section 3» или «-s3» (но вы, вероятно, уже заметили это, поскольку это может нарушить многие запросы).Также убедитесь, что MANPATH экспортирован, он не принесет пользы, если он будет объявлен только локально (то же самое с другими переменными).Наконец, если ничего не помогает, вы можете вручную установить страницы самостоятельно, что не так уж сложно, если только вы не будете строго ограничены тем, что вам разрешено делать с системой, которую вы используете (в месте, где я работал, было правило, что никтобыло разрешено изменять ЛЮБЫЕ настройки по умолчанию, даже если у них был доступ для этого из-за неопытных людей, делающих плохие изменения).Еще одна вещь, на которую стоит обратить внимание, это символические ссылки (т.е. / etc / alternatives), которые время от времени становятся несвязанными, однако человек обычно предупреждает вас об этом.

0 голосов
/ 23 ноября 2011

Источник для git не включает документацию.Попробуйте:

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

в рабочем каталоге git для установки в /usr/local/share.

0 голосов
/ 23 ноября 2011

Вы, вероятно, хотите man 1 git:

$ man 1 git

GIT(1)                              Git Manual                             GIT(1)

NAME
       git - the stupid content tracker

SYNOPSIS
       git [--version] [--exec-path[=<path>]] [--html-path]
           [-p|--paginate|--no-pager] [--no-replace-objects]
           [--bare] [--git-dir=<path>] [--work-tree=<path>]
           [-c <name>=<value>]
           [--help] <command> [<args>]

...
...