threads / patch / 16755

patchgit-daemon documentation: use {tilde}

Subject: [PATCH] git-daemon documentation: use {tilde}

## tl;dr

5 messages between Dec 16, 2008 and Dec 17, 2008. Diffs are folded; open one to read it.

replies: 4people: 3as markdown or json

Miklos Vajna· Dec 16, 2008, 15:48 UTC · lore

Use '{tilde}' instead of '~', becase the later does not appear in the manpage version, just in the HTML one.

Noticed by gonzzor on IRC.

Signed-off-by: Miklos Vajna <vmiklos@frugalware.org>
---
 Documentation/git-daemon.txt |    4 ++--
 1 files changed, 2 insertions(+), 2 deletions(-)

Show changes to Documentation/git-daemon.txt +2 −2

diff --git a/Documentation/git-daemon.txt b/Documentation/git-daemon.txt
index f1a570a..36f00ae 100644
--- a/Documentation/git-daemon.txt
+++ b/Documentation/git-daemon.txt
@@ -110,9 +110,9 @@ OPTIONS
 
 --user-path::
 --user-path=path::
-	Allow ~user notation to be used in requests.  When
+	Allow {tilde}user notation to be used in requests.  When
 	specified with no parameter, requests to
-	git://host/~alice/foo is taken as a request to access
+	git://host/{tilde}alice/foo is taken as a request to access
 	'foo' repository in the home directory of user `alice`.
 	If `--user-path=path` is specified, the same request is
 	taken as a request to access `path/foo` repository in

-- 
1.6.1.rc1.35.gae26e.dirty

Michael J Gruber· Dec 16, 2008, 17:38 UTC · re: Miklos Vajna · lore

Re: [PATCH] git-daemon documentation: use {tilde}

Miklos Vajna venit, vidit, dixit 16.12.2008 16:48:

> Use '{tilde}' instead of '~', becase the later does not appear in the
> manpage version, just in the HTML one.

Curiously, "git help daemon" (which execs "man git-daemon") displays the tilde but "man git-daemon" does not (nor does "konqueror man:git-daemon"). Humh?

Michael

Miklos Vajna· Dec 16, 2008, 17:50 UTC · re: Michael J Gruber · lore

Re: [PATCH] git-daemon documentation: use {tilde}

On Tue, Dec 16, 2008 at 06:38:57PM +0100, Michael J Gruber <git@drmicha.warpmail.net> wrote:

> Curiously, "git help daemon" (which execs "man git-daemon") displays the
> tilde but "man git-daemon" does not (nor does "konqueror
> man:git-daemon"). Humh?

'git help daemon' is wrong for me - without the patch - as well.

(Though I never use the git help foo form.)

Matthieu Moy· Dec 16, 2008, 18:05 UTC · re: Michael J Gruber · lore

Re: [PATCH] git-daemon documentation: use {tilde}

Michael J Gruber <git@drmicha.warpmail.net> writes:

Show 7 quoted lines

> Miklos Vajna venit, vidit, dixit 16.12.2008 16:48:
>> Use '{tilde}' instead of '~', becase the later does not appear in the
>> manpage version, just in the HTML one.
>
> Curiously, "git help daemon" (which execs "man git-daemon") displays the
> tilde but "man git-daemon" does not (nor does "konqueror
> man:git-daemon"). Humh?

You probably have two manpages because of two git installations. "man" will take the one in your manpath, and git will try to find the one corresponding to the version of git you actually launched.

-- 
Matthieu

Michael J Gruber· Dec 17, 2008, 09:07 UTC · re: Matthieu Moy · lore

Re: [PATCH] git-daemon documentation: use {tilde}

Matthieu Moy venit, vidit, dixit 16.12.2008 19:05:

Show 12 quoted lines

> Michael J Gruber <git@drmicha.warpmail.net> writes:
> 
>> Miklos Vajna venit, vidit, dixit 16.12.2008 16:48:
>>> Use '{tilde}' instead of '~', becase the later does not appear in the
>>> manpage version, just in the HTML one.
>> Curiously, "git help daemon" (which execs "man git-daemon") displays the
>> tilde but "man git-daemon" does not (nor does "konqueror
>> man:git-daemon"). Humh?
> 
> You probably have two manpages because of two git installations. "man"
> will take the one in your manpath, and git will try to find the one
> corresponding to the version of git you actually launched.

You're right! I have current pages in ~/share/man/man? and older ones in ~/man/man?. I guess the latter is in the standard search path (I don't have MANPATH set) but the former is not. I probably dumped a man-tarball in the standard place back when I didn't know about quick-install-doc. Now I'm just wondering why ~/share/man is the standard target for git and ~/man in the standard man path, at least on (K)Ubuntu 7.10 at my workplace.

Michael