Imported Upstream version 1.9.0
[platform/upstream/libzip.git] / man / zip_open.mdoc
index c7df355..84c0af8 100644 (file)
@@ -1,5 +1,5 @@
 .\" zip_open.mdoc -- open zip archive
-.\" Copyright (C) 2003-2014 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2003-2022 Dieter Baron and Thomas Klausner
 .\"
 .\" This file is part of libzip, a library to manipulate ZIP archives.
 .\" The authors can be contacted at <libzip@nih.at>
@@ -29,7 +29,7 @@
 .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
 .\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd November 9, 2014
+.Dd June 18, 2022
 .Dt ZIP_OPEN 3
 .Os
 .Sh NAME
@@ -153,11 +153,22 @@ The file specified by
 .Ar path
 does not allow seeks.
 .El
+For newly created archives,
+.Fn zip_open
+does not try to create the file; this is done when calling
+.Xr zip_close 3
+and any errors, like missing write permissions, will
+be reported then.
 .Sh SEE ALSO
 .Xr libzip 3 ,
 .Xr zip_close 3 ,
-.Xr zip_error_to_str 3 ,
+.Xr zip_error_strerror 3 ,
 .Xr zip_fdopen 3
+.Sh HISTORY
+.Fn zip_open
+and
+.Fn zip_open_from_source
+were added in libzip 1.0.
 .Sh AUTHORS
 .An -nosplit
 .An Dieter Baron Aq Mt dillo@nih.at