Package: libzip-dev
Version: 0.10.1-1.1
Severity: minor

I was looking at the zip_add(3) manpage, and read in the SYNOPSIS:

       zip_int64_t zip_add(struct zip *archive,  const  char  *name); "struct
       zip_source *source"

which makes no sense.  Looking at the source, I see that it is an mdoc
file with:

.Ft zip_int64_t
.Fn zip_add "struct zip *archive" "const char *name" \
"struct zip_source *source"

which makes a lot more sense, and there is clearly a bug in the
conversion from the mdoc to the man format.

The conversion, done upstream, used a program called "mdoc2man".  I
have been able to locate one similar script in the Debian archive, in
autogen, but that does not perform anything like the same conversion
that the upstream's version does.  I've found a few variants of an
mdoc2man script online, but none does the same conversion, and none
handles the escapes correctly.

   Julian


-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org

Reply via email to