Documentation: clarify meaning of --html-path, --man-path, and --info-path

These options tell UI programs where git put its documentation, so
"Help" actions can show the documentation for *this* version of git
without regard to how MANPATH and INFOPATH are set up.  Details:

. Each variable tells where documentation is expected to be.  They do
  not indicate whether documentation was actually installed.

. The output of "git --html-path" is an absolute path and can be used
  in "file://$(git --html-path)/git-add.html" to name the HTML file
  documenting a particular command.

. --man-path names a manual page hierarchy (e.g.,
  /home/user/share/man).  Its output can be passed to "man -M" or put
  at the beginning of $MANPATH.

. --info-path names a directory with info files (e.g.,
  /home/user/share/info).  Its output is suitable as an argument to
  "info -d" or for inclusion in $INFOPATH.

Helped-by: Junio C Hamano <gitster@pobox.com>
Signed-off-by: Jonathan Nieder <jrnieder@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
Jonathan Nieder 2011-05-02 01:07:45 -05:00 коммит произвёл Junio C Hamano
Родитель f2dd8c3799
Коммит 239b5ed9c9
1 изменённых файлов: 6 добавлений и 6 удалений

Просмотреть файл

@ -287,16 +287,16 @@ help ...`.
the current setting and then exit. the current setting and then exit.
--html-path:: --html-path::
Print the path to wherever your git HTML documentation is installed Print the path, without trailing slash, where git's HTML
and exit. documentation is installed and exit.
--man-path:: --man-path::
Print the path to wherever your git man pages are installed Print the manpath (see `man(1)`) for the man pages for
and exit. this version of git and exit.
--info-path:: --info-path::
Print the path to wherever your git Info files are installed Print the path where the Info files documenting this
and exit. version of git are installed and exit.
-p:: -p::
--paginate:: --paginate::