severity 669204 normal
quit
Hi Ian,
Ian Zimmerman wrote:
> What is the behavior of git fetch with no arguments? The manpage
> doesn't say
Good catch.
Confusingly enough, this stuff is documented in git-pull(1) but
not git-fetch(1)!
Default values for <repository> and <branch> are read from the
"remote" and "merge" configuration for the current branch as set
by git-branch --track.
Do you think this wording should be included in the git-fetch(1)
page, too? Where should it go? Could it use any tweaks for clarity?
> (of course you need to parse the manpage carefully to
> determine that, grr)
Hm, do you mean that the structure of the manpage is confusing?
Suggestions for improving that would be very welcome, too. Proposals
in patch form are even more welcome. ;-) (The source for manpages is
in the Documentation/ directory of the source tree and at
/usr/share/doc/git/html/git-fetch.txt in the git-doc binary package.
To test-build a change, one can install asciidoc and run "make -C
Documentation git-fetch.html" or install asciidoc and docbook-xsl and
run "make -C Documentation git-fetch.1".
> and neither is this covered by the other
> documentation out there like the Git Community Book.
In my humble opinion, the Git Community Book is a confusing
abomination that should never have been written. Good diagrams,
though. Its source material (the Git User Manual) and successor (the
Pro Git book) are better in pretty much every way.
Thanks much,
Jonathan
--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
