[pacman-dev] Building docs fails
Hi, Anybody an asciidoc expert around here. The upgrade from asciidoc-8.4.0 to 8.4.{1,2} causes building docs to fail for me (output below). Anybody want to look at this? Allan Making all in doc make[2]: Entering directory `/home/allan/code/makepkg/src/pacman/doc' a2x --no-xmllint -d manpage -f manpage --xsltproc-opts='-param man.endnotes.list.enabled 0' --xsltproc-opts='-param man.endnotes.are.numbered 0' --asciidoc-opts="-f asciidoc.conf -a pacman_version="3.2.2" -a pacman_date="`date +%Y-%m-%d`" -a sysconfdir=/etc" pacman.8.txt WARNING: [graphviz-block] missing template section WARNING: [graphviz-block] missing template section Note: Writing pacman.8 a2x --no-xmllint -d manpage -f manpage --xsltproc-opts='-param man.endnotes.list.enabled 0' --xsltproc-opts='-param man.endnotes.are.numbered 0' --asciidoc-opts="-f asciidoc.conf -a pacman_version="3.2.2" -a pacman_date="`date +%Y-%m-%d`" -a sysconfdir=/etc" makepkg.8.txt WARNING: [graphviz-block] missing template section WARNING: [graphviz-block] missing template section WARNING: makepkg.8.txt: line 46: nested inline passthrough Note: Writing makepkg.8 a2x --no-xmllint -d manpage -f manpage --xsltproc-opts='-param man.endnotes.list.enabled 0' --xsltproc-opts='-param man.endnotes.are.numbered 0' --asciidoc-opts="-f asciidoc.conf -a pacman_version="3.2.2" -a pacman_date="`date +%Y-%m-%d`" -a sysconfdir=/etc" repo-add.8.txt WARNING: [graphviz-block] missing template section WARNING: [graphviz-block] missing template section ERROR: repo-add.8.txt: line 8: malformed NAME section body a2x: failed: asciidoc --doctype=manpage -f asciidoc.conf -a pacman_version=3.2.2 -a pacman_date=2009-04-04 -a sysconfdir=/etc -d manpage -b docbook "repo-add.8.txt" make[2]: *** [repo-add.8] Error 1 make[2]: Leaving directory `/home/allan/code/makepkg/src/pacman/doc'
On Fri, Apr 3, 2009 at 9:18 AM, Allan McRae <allan@archlinux.org> wrote:
Hi,
Anybody an asciidoc expert around here. The upgrade from asciidoc-8.4.0 to 8.4.{1,2} causes building docs to fail for me (output below). Anybody want to look at this?
This is speaking quickly, but I noticed GIT just added a few things to their doc directory dealing with asciidoc- I don't know if this was for compatibility or what, but we may want to look into that. http://repo.or.cz/w/git.git?a=history;f=Documentation;hb=HEAD and http://repo.or.cz/w/git.git?a=history;f=Documentation/asciidoc.conf;h=dc76e7...
Making all in doc make[2]: Entering directory `/home/allan/code/makepkg/src/pacman/doc' a2x --no-xmllint -d manpage -f manpage --xsltproc-opts='-param man.endnotes.list.enabled 0' --xsltproc-opts='-param man.endnotes.are.numbered 0' --asciidoc-opts="-f asciidoc.conf -a pacman_version="3.2.2" -a pacman_date="`date +%Y-%m-%d`" -a sysconfdir=/etc" pacman.8.txt WARNING: [graphviz-block] missing template section WARNING: [graphviz-block] missing template section Note: Writing pacman.8 a2x --no-xmllint -d manpage -f manpage --xsltproc-opts='-param man.endnotes.list.enabled 0' --xsltproc-opts='-param man.endnotes.are.numbered 0' --asciidoc-opts="-f asciidoc.conf -a pacman_version="3.2.2" -a pacman_date="`date +%Y-%m-%d`" -a sysconfdir=/etc" makepkg.8.txt WARNING: [graphviz-block] missing template section WARNING: [graphviz-block] missing template section WARNING: makepkg.8.txt: line 46: nested inline passthrough Note: Writing makepkg.8 a2x --no-xmllint -d manpage -f manpage --xsltproc-opts='-param man.endnotes.list.enabled 0' --xsltproc-opts='-param man.endnotes.are.numbered 0' --asciidoc-opts="-f asciidoc.conf -a pacman_version="3.2.2" -a pacman_date="`date +%Y-%m-%d`" -a sysconfdir=/etc" repo-add.8.txt WARNING: [graphviz-block] missing template section WARNING: [graphviz-block] missing template section ERROR: repo-add.8.txt: line 8: malformed NAME section body a2x: failed: asciidoc --doctype=manpage -f asciidoc.conf -a pacman_version=3.2.2 -a pacman_date=2009-04-04 -a sysconfdir=/etc -d manpage -b docbook "repo-add.8.txt" make[2]: *** [repo-add.8] Error 1 make[2]: Leaving directory `/home/allan/code/makepkg/src/pacman/doc'
_______________________________________________ pacman-dev mailing list pacman-dev@archlinux.org http://www.archlinux.org/mailman/listinfo/pacman-dev
Allan McRae wrote:
Hi,
Anybody an asciidoc expert around here. The upgrade from asciidoc-8.4.0 to 8.4.{1,2} causes building docs to fail for me (output below). Anybody want to look at this?
This fixes the error, but there is still lots of warnings given: Name ---- +repo-add - package database maintenance utility //// * If we use this below line, the manpage name comes out all weird. We also * can't use two separate lines, which is quite annoying. * repo-add, repo-remove - package database maintenance utilities //// -repo-add - package database maintenance utility It appears that a comment straight after the Name line is "not good"... I haven't checked if the docs still look OK after fixing that. Some of the warnings are apparently a known bug in asciidoc: http://groups.google.com/group/asciidoc/browse_thread/thread/fd27add515597c0... Allan
On Fri, Apr 3, 2009 at 10:48 AM, Allan McRae <allan@archlinux.org> wrote:
Allan McRae wrote:
Hi,
Anybody an asciidoc expert around here. The upgrade from asciidoc-8.4.0 to 8.4.{1,2} causes building docs to fail for me (output below). Anybody want to look at this?
This fixes the error, but there is still lots of warnings given:
Name ---- +repo-add - package database maintenance utility //// * If we use this below line, the manpage name comes out all weird. We also * can't use two separate lines, which is quite annoying. * repo-add, repo-remove - package database maintenance utilities //// -repo-add - package database maintenance utility
It appears that a comment straight after the Name line is "not good"... I haven't checked if the docs still look OK after fixing that.
Some of the warnings are apparently a known bug in asciidoc: http://groups.google.com/group/asciidoc/browse_thread/thread/fd27add515597c0...
Do we have a decent fix for this then? I'll accept patches that help fix the build. -Dan
Dan McGee wrote:
On Fri, Apr 3, 2009 at 10:48 AM, Allan McRae <allan@archlinux.org> wrote:
Allan McRae wrote:
Hi,
Anybody an asciidoc expert around here. The upgrade from asciidoc-8.4.0 to 8.4.{1,2} causes building docs to fail for me (output below). Anybody want to look at this?
This fixes the error, but there is still lots of warnings given:
Name ---- +repo-add - package database maintenance utility //// * If we use this below line, the manpage name comes out all weird. We also * can't use two separate lines, which is quite annoying. * repo-add, repo-remove - package database maintenance utilities //// -repo-add - package database maintenance utility
It appears that a comment straight after the Name line is "not good"... I haven't checked if the docs still look OK after fixing that.
Some of the warnings are apparently a known bug in asciidoc: http://groups.google.com/group/asciidoc/browse_thread/thread/fd27add515597c0...
Do we have a decent fix for this then? I'll accept patches that help fix the build.
That patch I gave above is now on my working branch. After applying it, every man page gives a warning (WARNING: [graphviz-block] missing template section) during the build but this is apparently a bug in asciidoc. The PKGBUILD man page give: WARNING: PKGBUILD.5.txt: line 74: nested inline passthrough WARNING: PKGBUILD.5.txt: line 74: nested inline passthrough WARNING: PKGBUILD.5.txt: line 74: nested inline passthrough WARNING: PKGBUILD.5.txt: line 74: nested inline passthrough WARNING: PKGBUILD.5.txt: line 80: nested inline passthrough WARNING: PKGBUILD.5.txt: line 93: nested inline passthrough WARNING: PKGBUILD.5.txt: line 121: nested inline passthrough These are due to things like `$$license=('GPL' 'FDL')$$`. They look no different now than they did in the last pacman release so this seems fine. May be something that needs looked into though. Allan
participants (2)
-
Allan McRae
-
Dan McGee