Bug 267426 - unzip(1): Document optional member list
Summary: unzip(1): Document optional member list
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: Yoshihiro Takahashi
URL:
Keywords: easy
Depends on:
Blocks:
 
Reported: 2022-10-30 01:19 UTC by Pat Maddox
Modified: 2023-01-22 10:52 UTC (History)
2 users (show)

See Also:


Attachments
git format-patch of the added member documentation (980 bytes, patch)
2022-10-30 01:19 UTC, Pat Maddox
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Pat Maddox 2022-10-30 01:19:28 UTC
Created attachment 237714 [details]
git format-patch of the added member documentation

I found that `unzip` takes an optional member list, but it wasn't in the man page. The attached patch adds it.
Comment 1 Pat Maddox 2022-10-30 01:21:20 UTC
I attached a patch file, but here it is in text form:

diff --git a/usr.bin/unzip/unzip.1 b/usr.bin/unzip/unzip.1
index bb43abf43a85..bae7b3a21028 100644
--- a/usr.bin/unzip/unzip.1
+++ b/usr.bin/unzip/unzip.1
@@ -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
Comment 2 Yoshihiro Takahashi freebsd_committer freebsd_triage 2023-01-02 04:14:58 UTC
I'll take.
Comment 3 commit-hook freebsd_committer freebsd_triage 2023-01-02 04:21:37 UTC
A commit in branch main references this bug:

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(-)
Comment 4 commit-hook freebsd_committer freebsd_triage 2023-01-22 10:48:12 UTC
A commit in branch stable/13 references this bug:

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

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

    unzip: Document optional member list

    Submitted by:   Pat Maddox (man page)
    PR:             267426

    (cherry picked from commit a1f28ec729f7491da8607e8eeaee1b0f547c60d0)

 usr.bin/unzip/unzip.1 | 8 +++++++-
 usr.bin/unzip/unzip.c | 5 +++--
 2 files changed, 10 insertions(+), 3 deletions(-)
Comment 5 commit-hook freebsd_committer freebsd_triage 2023-01-22 10:50:14 UTC
A commit in branch stable/12 references this bug:

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

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

    unzip: Document optional member list

    Submitted by:   Pat Maddox (man page)
    PR:             267426

    (cherry picked from commit a1f28ec729f7491da8607e8eeaee1b0f547c60d0)

 usr.bin/unzip/unzip.1 | 8 +++++++-
 usr.bin/unzip/unzip.c | 5 +++--
 2 files changed, 10 insertions(+), 3 deletions(-)
Comment 6 Yoshihiro Takahashi freebsd_committer freebsd_triage 2023-01-22 10:52:21 UTC
Fixed.