git: 143e70f094b0 - main - archivers/7-zip: add man page

From: Max Brazhnikov <makc_at_FreeBSD.org>
Date: Mon, 14 Feb 2022 22:00:47 UTC
The branch main has been updated by makc:

URL: https://cgit.FreeBSD.org/ports/commit/?id=143e70f094b0cd7d0d37c331b4b52b54f6dc13aa

commit 143e70f094b0cd7d0d37c331b4b52b54f6dc13aa
Author:     Max Brazhnikov <makc@FreeBSD.org>
AuthorDate: 2022-02-14 21:59:33 +0000
Commit:     Max Brazhnikov <makc@FreeBSD.org>
CommitDate: 2022-02-14 21:59:33 +0000

    archivers/7-zip: add man page
---
 archivers/7-zip/Makefile    |   5 +-
 archivers/7-zip/files/7zz.1 | 215 ++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 219 insertions(+), 1 deletion(-)

diff --git a/archivers/7-zip/Makefile b/archivers/7-zip/Makefile
index eb16a7051cae..549bd0fb3868 100644
--- a/archivers/7-zip/Makefile
+++ b/archivers/7-zip/Makefile
@@ -1,5 +1,6 @@
 PORTNAME=	7-zip
 DISTVERSION=	21.07
+PORTREVISION=	1
 CATEGORIES=	archivers
 MASTER_SITES=	https://www.7-zip.org/a/
 DISTNAME=	7z${DISTVERSION:S/.//}-src
@@ -33,7 +34,8 @@ DOS2UNIX_FILES=	C/CpuArch.c \
 		CPP/7zip/var_gcc.mak \
 		CPP/Windows/SystemInfo.cpp
 
-PLIST_FILES=	bin/7zz
+PLIST_FILES=	bin/7zz \
+		share/man/man1/7zz.1.gz
 PORTDOCS=	7zC.txt 7zFormat.txt License.txt Methods.txt \
 		lzma.txt readme.txt src-history.txt
 
@@ -44,6 +46,7 @@ post-patch:
 
 do-install:
 	${INSTALL_PROGRAM} ${BUILD_WRKSRC}/b/c/7zz ${STAGEDIR}/${PREFIX}/bin
+	${INSTALL_MAN} ${FILESDIR}/7zz.1 ${STAGEDIR}/${PREFIX}/share/man/man1
 
 do-install-DOCS-on:
 	${MKDIR} ${STAGEDIR}${DOCSDIR} && \
diff --git a/archivers/7-zip/files/7zz.1 b/archivers/7-zip/files/7zz.1
new file mode 100644
index 000000000000..2e159bd94bb4
--- /dev/null
+++ b/archivers/7-zip/files/7zz.1
@@ -0,0 +1,215 @@
+.TH 7ZZ "1" "February 14, 2022"
+.SH NAME
+7zz \- Standalone console version of the 7-Zip file archiver
+.SH SYNOPSIS
+.B 7zz
+.\" \fI\,<command> \/[\fI\,<switch>\/...] \fI\,<archive_name> \/[\fI\,<file_names>\/...] [\fI\,@list_file\/]
+.BR <command>
+.BR [<switch>...]
+.BR <archive_name>
+.BR [<file_names>]
+.BR [@listfile]
+.SH DESCRIPTION
+7\-Zip is a file archiver with a high compression ratio. Supported formats:
+.IP
+Packing and unpacking: 7z, XZ, BZIP2, GZIP, TAR, ZIP and WIM.
+.IP
+Unpacking only: AR, ARJ, CAB, CHM, CPIO, CramFS, DMG, EXT, FAT, GPT, HFS, IHEX, ISO, LZH, LZMA, MBR, MSI, NSIS, NTFS, QCOW2, RAR, RPM, SquashFS, UDF, UEFI, VDI, VHD, VHDX, VMDK, WIM, XAR and Z.
+.SH Commands
+.TP
+.BR a
+Add files to archive
+.TP
+.BR b
+Benchmark
+.TP
+.BR d
+Delete files from archive
+.TP
+.BR e
+Extract files from archive (without using directory names)
+.TP
+.BR h
+Calculate hash values for files
+.TP
+.BR i
+Show information about supported formats
+.TP
+.BR l
+List contents of archive
+.TP
+.BR rn
+Rename files in archive
+.TP
+.BR t
+Test integrity of archive
+.TP
+.BR u
+Update files to archive
+.TP
+.BR x
+Extract files with full paths
+.SH Switches
+.TP
+.BR \-\-
+Stop switches and @listfile parsing
+.TP
+.BR \-ai[r[\-|0]]{@listfile|!wildcard}
+Include archives
+.TP
+.BR \-ax[r[\-|0]]{@listfile|!wildcard}
+Exclude archives
+.TP
+.BR \-ao{a|s|t|u}
+Set Overwrite mode
+.TP
+.BR \-an
+Disable archive_name field
+.TP
+.BR \-bb[0\-3]
+Set output log level
+.TP
+.BR \-bd
+Disable progress indicator
+.TP
+.BR \-bs{o|e|p}{0|1|2}
+Set output stream for output/error/progress line
+.TP
+.BR \-bt
+show execution time statistics
+.TP
+.BR \-i[r[\-|0]]{@listfile|!wildcard}
+Include filenames
+.TP
+.BR \-m{Parameters}
+Set compression Method
+.TP
+.BR \-mmt[N]
+Set number of CPU threads
+.TP
+.BR \-mx[N]
+Set compression level: \-mx1 (fastest) ... \-mx9 (ultra)
+.TP
+.BR \-o{Directory}
+Set Output directory
+.TP
+.BR \-p{Password}
+Set Password
+.TP
+.BR \-r[\-|0]
+Recurse subdirectories for name search
+.TP
+.BR \-sa{a|e|s}
+Set Archive name mode
+.TP
+.BR \-scc{UTF\-8|WIN|DOS}
+Set charset for for console input/output
+.TP
+.BR \-scs{UTF\-8|UTF\-16LE|UTF\-16BE|WIN|DOS|{id}}
+Set charset for list files
+.TP
+.BR \-scrc[CRC32|CRC64|SHA1|SHA256|*]
+Set hash function for x, e, h commands
+.TP
+.BR \-sdel
+Delete files after compression
+.TP
+.BR \-seml[.]
+Send archive by email
+.TP
+.BR \-sfx[{name}]
+Create SFX archive
+.TP
+.BR \-si[{name}]
+Read data from stdin
+.TP
+.BR \-slp
+Set Large Pages mode
+.TP
+.BR \-slt
+Show technical information for l (List) command
+.TP
+.BR \-snh
+Store hard links as links
+.TP
+.BR \-snl
+Store symbolic links as links
+.TP
+.BR \-sni
+Store NT security information
+.TP
+.BR \-sns[\-]
+Store NTFS alternate streams
+.TP
+.BR \-so
+Write data to stdout
+.TP
+.BR \-spd
+Disable wildcard matching for file names
+.TP
+.BR \-spe
+Eliminate duplication of root folder for extract command
+.TP
+.BR \-spf
+Use fully qualified file paths
+.TP
+.BR \-ssc[\-]
+Set sensitive case mode
+.TP
+.BR \-sse
+Stop archive creating, if it can't open some input file
+.TP
+.BR \-ssp
+Do not change Last Access Time of source files while archiving
+.TP
+.BR \-ssw
+Compress shared files
+.TP
+.BR \-stl
+Set archive timestamp from the most recently modified file
+.TP
+.BR \-stm{HexMask}
+Set CPU thread affinity mask (hexadecimal number)
+.TP
+.BR \-stx{Type}
+Exclude archive type
+.TP
+.BR \-t{Type}
+Set type of archive
+.TP
+.BR \-u[\-][p#][q#][r#][x#][y#][z#][!newArchiveName]
+Update options
+.TP
+.BR \-v{Size}[b|k|m|g]
+Create volumes
+.TP
+.BR \-w[{path}]
+Set working directory. Empty path means a temporary directory
+.TP
+.BR \-x[r[\-|0]]{@listfile|!wildcard}
+Exclude filenames
+.TP
+.BR \-y
+Assume Yes on all queries
+.SH Listfile
+You can supply one or more filenames or wildcards for special list files (files containing lists of files). The filenames in such list file must be separated by new line symbol(s). For list files, 7\-Zip uses UTF\-8 encoding by default. You can change encoding using
+.BR \-scs
+switch. Multiple list files are supported.
+.PP
+For example, if the file "listfile.txt" contains the following:
+.IP
+My programs\\*.cpp
+.br
+Src\\*.cpp
+.PP
+then the command
+.IP
+.B 7z a \-tzip archive.zip @listfile.txt
+.PP
+adds to the archive "archive.zip" all "*.cpp" files from directories "My programs" and "Src".
+.SH "SEE ALSO"
+.BR xz (1)
+.br
+Frequently Asked Questions: <https://www.7-zip.org/faq.html>
+.br
+Recover corrupted 7z archive: <https://www.7-zip.org/recover.html>