* mandoc -Tman bugs
@ 2013-04-08 9:27 Thomas Klausner
0 siblings, 0 replies; only message in thread
From: Thomas Klausner @ 2013-04-08 9:27 UTC (permalink / raw)
To: discuss
Hi!
I've run mandoc -Tman over the man pages in libzip.
hg clone http://hg.nih.at/libzip/
cd libzip/man
mkdir mandoc
for i in *.mdoc; do j=${i%%mdoc}man; mandoc -Tman $i > mandoc/$j; done
Then I looked at the output. I found two repeating problems:
1) Lots of pages spew stuff like:
zip_errors.man:92: warning: numeric expression expected (got `X')
The line here is .TP XZIPXERXCOMPNOTSUPPXX
2) In the SYNOPSIS, there are no parentheses around the function
arguments, and no ';' at the end. For example, the mdoc code (in
zip_close.mdoc):
.Ft int
.Fn zip_close "struct zip *archive"
which is usually printed as
int
zip_close(struct zip *archive);
is converted to the following man code:
int
zip_close struct zip *archive
Other than that, the output looks very good!
Thomas
--
To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv
^ permalink raw reply [flat|nested] only message in thread
only message in thread, other threads:[~2013-04-08 9:27 UTC | newest]
Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2013-04-08 9:27 mandoc -Tman bugs Thomas Klausner
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).