dbk2man.py generates incorrect man pages #56
Comments
Mno-hime
added a commit
to Mno-hime/oi-userland
that referenced
this issue
Aug 3, 2018
There two ways to generate zziplib man pages and both have their distinct problems. Man page generation via xmlto gets correct man pages (with a docbook-xsl fix) but some man pages are not being generated, plus xmlto way is to be deprecated in the future anyway. The other method is via dbk2man.py but it generates correct amount of man pages but they are broken in the same way xmlto-generated man pages are without the docbook-xsl fix (filed gdraheim/zziplib#56). So, disable `xmlto` and manually fix incorrect man pages via `sed`.
Mno-hime
added a commit
to Mno-hime/oi-userland
that referenced
this issue
Aug 3, 2018
There two ways to generate zziplib man pages and both have their distinct problems. Man page generation via xmlto gets correct man pages (with a docbook-xsl fix) but some man pages are not being generated, plus xmlto way is to be deprecated in the future anyway. The other method is via dbk2man.py but it generates correct amount of man pages but they are broken in the same way xmlto-generated man pages are without the docbook-xsl fix (filed gdraheim/zziplib#56). So, disable `xmlto` and manually fix incorrect man pages via `sed`.
Closed
|
A change to dbk2man.py generates ".so man3/xx" pages. It should work as expected now. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
I build man pages from zziplib 0.13.69 release via
dbk2man.pyon OpenIndiana and some of the generated man pages are incorrect. E.g.zzip_disk_buffer.3's content isbut should be
man zzip_disk_bufferfor the generated man pages says just:See the file zzip_disk_mmap.3.I believe we are using OpenBSD's mandoc asman(1).xmltois generating man pages correctly.The text was updated successfully, but these errors were encountered: