discuss@mandoc.bsd.lv
 help / color / mirror / Atom feed
* 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).