Asciidoc 8.2.3+ breaks git manpages

Asciidoc 8.2.3+ breaks git manpages

[Alexey Borzenkov]

Hi everyone,

I wonder if nobody noticed this yet, but since Asciidoc 8.2.3 git manpages are
broken in regard that gitlink macro is not handled correctly, and what you see
when issuing git --help is a lot of [1], [2], [3], etc that are completely
unreadable. I found this offending line in asciidoc.conf:

# Explicit so they can be nested.
(?su)[\\]?(?P<name>(http|....|link)):(?P<target>\S*?)(\[(?P<attrlist>.*?)\])=

If you add \b in front on (http|....|link) the macro then behaves correctly
(because it will match only when link is not preceded with other letters). This
is upstream bug and I wonder who is at fault here (git or asciidoc?).


--
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple
Problem reports:       http://cygwin.com/problems.html
Documentation:         http://cygwin.com/docs.html
FAQ:                   http://cygwin.com/faq/

Re: Asciidoc 8.2.3+ breaks git manpages

[Eric Blake]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

According to Alexey Borzenkov on 12/25/2007 5:20 AM:
| Hi everyone,
|
| I wonder if nobody noticed this yet, but since Asciidoc 8.2.3 git
manpages are
| broken in regard that gitlink macro is not handled correctly, and what
you see
| when issuing git --help is a lot of [1], [2], [3], etc that are completely
| unreadable.

Oh, it's been noticed, and I have been bothered by it as well, without
knowing what to do about it.  Fortunately, I also noticed this today in
the upstream news, for the upcoming git 1.5.4 release (now at rc2):

~ * Recent versions of AsciiDoc 8 has a change to break our
~   documentation; a workaround has been implemented.

- --
Don't work too hard, make some time for fun as well!

Eric Blake             ebb9@byu.net
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.5 (Cygwin)
Comment: Public key at home.comcast.net/~ericblake/eblake.gpg
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFHgvX884KuGfSFAYARAr5VAKCifs/5oX0jrtMYziSmvhvJK+ClJgCeKGUe
iXpEc0lea1R6Vttfa+4Ms3E=
=QwZa
-----END PGP SIGNATURE-----

--
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple
Problem reports:       http://cygwin.com/problems.html
Documentation:         http://cygwin.com/docs.html
FAQ:                   http://cygwin.com/faq/