Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Git man page seems incorrect

I'm new to git, so please excuse me if this is a dumb question.

I have installed git 1.7.7.4 from source on SLES Linux, and all looks good. I have added the following to $MANPATH:

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

When I do man git, I'm presented with

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

NAME
       Git - Perl interface to the Git version control system

SYNOPSIS
...

This doesn't look like a man page for the git command I use from the command line. Or is it? Sounds like something for perl, obviously. Here is an online version of the full man page I'm seeing.

If this is not the correct man pages, where can I find them? I can give a directory listing of my git install if needed. Thanks.

like image 733
Banjer Avatar asked Nov 23 '11 14:11

Banjer


3 Answers

You can build the man pages from the source package with make man && make install-man. Manual pages are not built by default, see git's INSTALL file:

To build and install documentation suite, you need to have the asciidoc/xmlto toolchain. Because not many people are inclined to install the tools, the default build target ("make all") does not build them.

"make doc" builds documentation in man and html formats; there are also "make man", "make html" and "make info". Note that "make html" requires asciidoc, but not xmlto. "make man" (and thus make doc) requires both.

like image 141
u-punkt Avatar answered Oct 08 '22 01:10

u-punkt


You are getting the incorrect section of the man pages for git. The information you want is in section 1. Use man 1 git to get correct manual section.

You can see list of available manual sections here.

like image 36
Roger Lindsjö Avatar answered Oct 08 '22 01:10

Roger Lindsjö


Update git 2.8 (March 2016)

The installation from sources mentions, in order to build the doc and man pages:

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

I confirm a man git will directly get you man (1) git.
It content differs from the git README which just lost the snarky "stupid content tracker" (said README is now a markdown-enabled README.md!)

README.md: don't call git stupid in the title

"the stupid content tracker" was true in the early days of Git, but hardly applicable these days.
"fast, scalable, distributed" describes Git more accurately.

Also, "stupid" can be seen as offensive by some people. Let's not use it in the very first words of the README.

The man page should soon follow suit.

like image 33
VonC Avatar answered Oct 08 '22 01:10

VonC