Hi,

Osamu Aoki <os...@debian.org> wrote:
> But why git-svn?
> 
> manpage of git-svn has:
> 
> | NAME
> |        git-svn - Bidirectional operation between a Subversion repository and
> |        Git
> | 
> | SYNOPSIS
> |        git svn <command> [options] [arguments]
> 
> See no hyphen.
> 
> The "git" command invokes command git-foo if invoked as "git foo".  That is 
> the command design.
> 
> Did you see anything recommending otherwise?

Hmm, apparently I got confused somehow.

It seems you are right, but:

1. "man git" (at least under Wheezy) lists all git commands in the form
"git-add" (with hyphen).
2. the 'table 10.13. List of git related packages and commands' in DR also
has all the entries in the column "command" with hyphens.

Looks like there is a difference between the "command I call" and the
"command that gets invoked".
Additionally there are also many notations in the DR and in all other
git docu, where "git-add" (with hyphen) is correct: 
- when mentioning a git-related manpage, it's "git-add(1)" (with hyphen)
- when mentioning the package name, it's "git-svn" (with hyphen)
- when mentioning a file path, it's "/usr/share/doc/git-doc/user-manual.html"
(with hyphen)

All together a big potential to confuse users - and translators ;-)

I found there is already a paragraph on this:
"Invoking a <literal>git</literal> subcommand directly as \"<literal>git-xyz</"
"literal>\" from the command line has been deprecated since early 2006."

Probably this could be enhanced somehow?

"Please note that there are several mentions of git commands in the form
»git-add« in git docs (for example when referring to a manpage), but when 
invoking the corresponding command you will have to omit the hyphen and use 
"git add". 
Invoking a <literal>git</literal> subcommand directly as \"<literal>git-xyz</
"literal>\" from the command line has been deprecated since early 2006."



Thanks
Greetings
Holger


-- 
Holger Wansing <hwans...@mailbox.org>


--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org

Reply via email to