Improve description and markup; comment out empty sections.
--HG--
branch : HEAD
diff --git a/man/zip_open.mdoc b/man/zip_open.mdoc
index dce0654..1c896cb 100644
--- a/man/zip_open.mdoc
+++ b/man/zip_open.mdoc
@@ -1,4 +1,4 @@
-.\" $NiH: zip_open.mdoc,v 1.2 2003/10/02 14:13:34 dillo Exp $
+.\" $NiH: zip_open.mdoc,v 1.3 2003/10/02 14:20:52 dillo Exp $
.\"
.\" zip_open.mdoc -- open zip archive
.\" Copyright (C) 2003 Dieter Baron and Thomas Klausner
@@ -18,7 +18,7 @@
.\" 3. The names of the authors may not be used to endorse or promote
.\" products derived from this software without specific prior
.\" written permission.
-.\"
+.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
@@ -40,14 +40,20 @@
.Sh LIBRARY
.Lb libzip
.Sh SYNOPSIS
-.Fd #include \*[Lt]zip.h\*[Gt]
+.In zip.h
.Ft struct zip *
.Fn zip_open "const char *path" "int flags"
.Sh DESCRIPTION
+.Fn zip_open
+opens the zip file
+.Ar path
+and returns a
+.Ft struct zip
+for further use by the library.
The
.Fa flags
are specified by
-.Em or Ns 'ing
+.Em or Ns No 'ing
the following values, or 0 for none of them.
.Bl -tag -offset indent -width ZIP_CHECKCONS
.It Dv ZIP_CREATE
@@ -62,14 +68,14 @@
Upon successful completion
.Fn zip_open
returns a
-.Tn struct zip
+.Ft struct zip
pointer.
Otherwise,
.Dv NULL
is returned and the global variable
.Va zip_err
is set to indicate the error.
-.Sh ERRORS
+.\".Sh ERRORS
.\" XXX
-.Sh SEE ALSO
+.\".Sh SEE ALSO
.\" XXX
