git: a1f28ec729f7 - main - unzip: Document optional member list

From: Yoshihiro Takahashi <nyan_at_FreeBSD.org>
Date: Mon, 02 Jan 2023 04:20:35 UTC
The branch main has been updated by nyan:

URL: https://cgit.FreeBSD.org/src/commit/?id=a1f28ec729f7491da8607e8eeaee1b0f547c60d0

commit a1f28ec729f7491da8607e8eeaee1b0f547c60d0
Author:     Yoshihiro Takahashi <nyan@FreeBSD.org>
AuthorDate: 2023-01-02 04:17:27 +0000
Commit:     Yoshihiro Takahashi <nyan@FreeBSD.org>
CommitDate: 2023-01-02 04:17:27 +0000

    unzip: Document optional member list
    
    Submitted by:   Pat Maddox (man page)
    PR:             267426
    MFC after:      2 weeks
---
 usr.bin/unzip/unzip.1 | 8 +++++++-
 usr.bin/unzip/unzip.c | 5 +++--
 2 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/usr.bin/unzip/unzip.1 b/usr.bin/unzip/unzip.1
index bb43abf43a85..82e2c3a60ea0 100644
--- a/usr.bin/unzip/unzip.1
+++ b/usr.bin/unzip/unzip.1
@@ -25,7 +25,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd September 25, 2021
+.Dd January 2, 2023
 .Dt UNZIP 1
 .Os
 .Sh NAME
@@ -38,6 +38,7 @@
 .Op Fl x Ar pattern
 .Op Fl P Ar password
 .Ar zipfile
+.Op Ar member ...
 .Sh DESCRIPTION
 .\" ...
 The following options are available:
@@ -120,6 +121,11 @@ mode changes the way in which additional arguments are parsed.
 Currently only
 .Xr zipinfo 1L
 mode 1 is supported, which lists the file names one per line.
+.It Ar [member ...]
+Optional list of members to extract from the zipfile.
+Can include patterns, e.g.
+.Ar 'memberdir/*'
+will extract all files and dirs below memberdir.
 .El
 .Pp
 Note that only one of
diff --git a/usr.bin/unzip/unzip.c b/usr.bin/unzip/unzip.c
index 0b564b0f08ec..78731555eadc 100644
--- a/usr.bin/unzip/unzip.c
+++ b/usr.bin/unzip/unzip.c
@@ -998,8 +998,9 @@ static void
 usage(void)
 {
 
-	fprintf(stderr, "Usage: unzip [-aCcfjLlnopqtuvyZ1] [-d dir] "
-		"[-x pattern] [-P password] zipfile\n");
+	fprintf(stderr,
+"Usage: unzip [-aCcfjLlnopqtuvyZ1] [-d dir] [-x pattern] [-P password] zipfile\n"
+"             [member ...]\n");
 	exit(EXIT_FAILURE);
 }