On Tue, Oct 03, 2006 at 11:19:20AM +0200, Stefan Richter wrote:
> Junio C Hamano wrote:
> > It's a bit sad that asciidoc's nicer quoting features
> > are not backward compatible.
>
> Yes, this is awkward. Here comes the next candidate for quoting.
> In pull-fetch-param.txt:
>
> ----8<----
> <refspec>::
> The canonical format of a <refspec> parameter is
> `+?<src>:<dst>`; that is, an optional plus `+`, followed
> by the source ref, followed by a colon `:`, followed by
> the destination ref.
> +
> The remote ref that matches <src>
> is fetched, and if <dst> is not empty string, the local
> ref that matches it is fast forwarded using <src>.
> Again, if the optional plus `+` is used, the local ref
> ---->8----
>
> "man git-fetch" and "man git-pull" show:
> ----8<----
> <refspec>
> The canonical format of a <refspec> parameter is ?<src>:<dst>;
> that is, an optional plus, followed by the source ref, followed
> by a colon :, followed by the destination ref.
>
> The remote ref that matches <src> is fetched, and if <dst> is
> not empty string, the local ref that matches it is fast for-
> warded using <src>. Again, if the optional plus + is used, the
> ---->8----
Hi, this still is a problem, at least on Debian/unstable; with asciidoc
8.2.1, the git-push(1) and git-fetch(1) man pages have this 'broken'
refspec description[0].
Additionally there're problems with callouts, whereever <n> is used to
refer to a callout list, it renders broken man pages[1], e.g.:
$ man git-reset
[...]
EXAMPLES
Undo a commit and redo
$ git commit ...
$ git reset --soft HEAD^ \fB(1)\fR
$ edit \fB(2)\fR
$ git commit -a -c ORIG_HEAD \fB(3)\fR
.sp \fB1. \fRThis is most often done when you remembered what you
just committed is incomplete, or you misspelled your commit
message, or both. Leaves working tree as it was before "reset".
.br \fB2. \fRmake corrections to working tree files.
.br \fB3. \fR"reset" copies the old head to .git/ORIG_HEAD; redo
the commit by starting with its log message. If you do not need to
edit the message further, you can give -C option instead.
See also the --amend option to git-commit(1).
.br
Undo commits permanently
$ git commit ...
$ git reset --hard HEAD~3 \fB(1)\fR
.sp \fB1. \fRThe last three commits (HEAD, HEAD^, and HEAD~2) were
bad and you do not want to ever see them again. Do not do this if
you have already given these commits to somebody else.
.br
Undo a commit, making it a topic branch
[...]
Regards, Gerrit.
[0] http://bugs.debian.org/432560
[1] http://bugs.debian.org/420114
-
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
