git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] Add --info-path and --man-path options to git.

From
Junio C Hamano <gitster@pobox.com>
Date
May 2, 2011, 00:02 UTC
Message-ID
<7v62puq8a5.fsf@alter.siamese.dyndns.org>
In-Reply-To
<20110501234833.GC11550@elie>
Jonathan Nieder <jrnieder@gmail.com> writes:
Show 9 quoted lines
> By contrast, man and info typically use standard search mechanisms:
> man using $MANPATH and info using the dir.info file.  The usual
> interface to git's documentation through a man browser is not
>
> 	man /usr/share/man/man1/git-add.1.gz
>
> but
>
> 	man git-add;	# or "man git add" if your man viewer supports it

I think you are forgetting the case where the git-man-path the user uses to install git may be outside /usr/share/man (e.g. $HOME/share/man). In such an installation, by setting $PATH to include your installed git binary (e.g. $HOME/bin), you should be able to say "git help -m git" to tell help.c to internally prepend $HOME/share/man to the $MANPATH before it kicks "man". Does "man git-add" work without you knowing where that directory is (iow, without having $HOME/share/man on $MANPATH)? And if it does not, how would you learn what directory to add to your $MANPATH?

Isn't that what this patch is solving? I am not sure where the similarity with the html documentation breaks donw. The same thing for info.

Previous: Jonathan NiederNext: Jon Seymour
Message 6 of 14 in “Add --info-path and --man-path options to git.”
  1. Add --info-path and --man-path options to git.Jon Seymour, May 1, 2011
  2. Junio C HamanoMay 1, 2011
  3. Jon SeymourMay 1, 2011
  4. Jonathan NiederMay 1, 2011
  5. Jonathan NiederMay 1, 2011
  6. Junio C HamanoMay 2, 2011
  7. Jon SeymourMay 2, 2011
  8. Jon SeymourMay 2, 2011
  9. Jonathan NiederMay 2, 2011
  10. Junio C HamanoMay 2, 2011
  11. Jonathan NiederMay 2, 2011
  12. Documentation: clarify meaning of --html-path, --man-path, and --info-pathJonathan Nieder, May 2, 2011
  13. Jon SeymourMay 2, 2011
  14. Junio C HamanoMay 2, 2011

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.