From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from danbala.ifoer.tuwien.ac.at (danbala.ifoer.tuwien.ac.at [128.130.168.64])
	by krisdoz.my.domain (8.14.5/8.14.5) with ESMTP id r389Rh1w014694
	for <discuss@mdocml.bsd.lv>; Mon, 8 Apr 2013 05:27:43 -0400 (EDT)
Received: by danbala.ifoer.tuwien.ac.at (Postfix, from userid 116)
	id 65FBD3902DA; Mon,  8 Apr 2013 11:27:43 +0200 (CEST)
Date: Mon, 8 Apr 2013 11:27:43 +0200
From: Thomas Klausner <wiz@NetBSD.org>
To: discuss@mdocml.bsd.lv
Subject: mandoc -Tman bugs
Message-ID: <20130408092743.GU18461@danbala.tuwien.ac.at>
X-Mailinglist: mdocml-discuss
Reply-To: discuss@mdocml.bsd.lv
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

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