Git手冊頁似乎不正確

Question

我是git的新手，所以請原諒我這是一個愚蠢的問題。

我在SLES Linux上從源代碼安裝了git 1.7.7.4，看起來都不錯。 我在$ 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
...

這看起來不像我在命令行中使用的git命令的手冊頁。 或者是嗎？ 聽起來像perl的東西，顯然。 這是我看到的完整手冊頁的在線版本 。

如果這不是正確的手冊頁，我在哪里可以找到它們？ 如果需要，我可以給我的git安裝目錄列表。 謝謝。

Answer 1

您可以使用make man && make install-man從源包構建手冊頁。 默認情況下不構建手冊頁，請參閱git的INSTALL文件：

要構建和安裝文檔套件，您需要具有asciidoc / xmlto工具鏈。 因為沒有多少人傾向於安裝工具，默認的構建目標（“讓所有”） 不建立他們。

“make doc”以man和html格式構建文檔; 還有“make man”，“make html”和“make info”。 請注意，“make html”需要asciidoc，而不是xmlto。 “制造男人”（因此制造醫生）需要兩者兼而有之。

Answer 2

您正在獲取git手冊頁的錯誤部分。 您需要的信息在第1部分中。使用man 1 git獲取正確的手冊部分。

您可以在此處查看可用手冊部分的列表。

Answer 3

更新git 2。8（2016年3月）

從源代碼中提及安裝 ，以構建doc和man頁面：

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

我確認一個man git會直接找你man (1) git 。
它的內容不同於git README ，它剛剛失去了愚蠢的“愚蠢的內容跟蹤器” （說README現在是一個支持降價的README.md ！）

README.md ：不要在標題中調用git stupid

“愚蠢的內容跟蹤器”在Git的早期就是如此，但這些日子幾乎不適用。
“快速，可擴展，分布式”更准確地描述了Git。

此外，“愚蠢”可能會被一些人視為冒犯。 我們不要在README第一句話中使用它。

該手冊頁應該很快就會效仿。

Answer 4

做他們（其他答案）說的話，如果你仍然遇到同樣的問題（或其他任何人），請確保你沒有設置MANSECT環境變量，這也會導致這個問題。 它是一個以冒號分隔的要檢查的部分列表，按降序排列（第一部分嘗試在列表的開頭，最后一部分在結尾）。 如果我MANSECT = 3，我可以復制你的問題，但是根據你的用戶的經驗，這似乎是一個顯而易見的事情。 最后但並非最不重要的是，確保沒有設置別名，函數（bash）或攔截'man'命令的腳本（因為man -section將明確告訴man要搜索哪個部分，格式與MANSECT相同） man，since --Section覆蓋MANSECT變量。 當你在它的時候檢查MANOPT變量是否有' - section 3'或'-s3'標志（但你可能已經注意到了它，因為它會破壞許多查詢）。 確保導出MANPATH，如果它只是在本地聲明，它沒有任何好處（與其他變量相同）。 最后，如果所有其他方法都失敗了，你可以自己手動安裝頁面，這不是太難，除非你嚴格限制你所允許對你正在使用的系統做什么（我曾經工作的地方有一個規則，沒有人被允許改變任何默認值，即使他們有權這樣做，因為沒有經驗的人做出了不好的改變）。 需要注意的另一件事是符號鏈接（即/ etc / alternative），它現在又一次變得無關聯，但人們通常會警告你。

Answer 5

你可能想要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>]

...

Answer 6

git的源代碼不包含文檔。 嘗試：

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

在git的git工作目錄中安裝在/ usr / local / share中。