Index: utils/ofarc/Makefile ================================================================== --- utils/ofarc/Makefile +++ utils/ofarc/Makefile @@ -7,10 +7,11 @@ TarArchive.m \ ZIPArchive.m \ ZooArchive.m DATA = localization/de.json \ localization/localizations.json +MAN = ofarc.1 include ../../buildsys.mk PACKAGE_NAME = ofarc ADDED utils/ofarc/ofarc.1 Index: utils/ofarc/ofarc.1 ================================================================== --- /dev/null +++ utils/ofarc/ofarc.1 @@ -0,0 +1,89 @@ +.\" +.\" Copyright (c) 2008-2024 Jonathan Schleifer +.\" +.\" All rights reserved. +.\" +.\" This program is free software: you can redistribute it and/or modify it +.\" under the terms of the GNU Lesser General Public License version 3.0 only, +.\" as published by the Free Software Foundation. +.\" +.\" This program is distributed in the hope that it will be useful, but WITHOUT +.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License +.\" version 3.0 for more details. +.\" +.\" You should have received a copy of the GNU Lesser General Public License +.\" version 3.0 along with this program. If not, see +.\" . +.\" +.TH OFARC 1 +.SH NAME +ofarc - list, extract, create and append to archives +.SH SYNOPSIS +.B ofarc +[\fBoptions\fR] \fIarchive\fR [\fIfile1\fR \fIfile2\fR ...] +.SH DESCRIPTION +.B ofarc +is a program to list, extract, create and append to archives. +.SH OPTIONS +.TP +.BR \fB\-a\fR ", " \fB\-\-append\fR +Append to archive. +.TP +.BR \fB\-\-archive\-comment=\fIcomment\fR +Archive comment to use when creating or appending. +.TP +.BR \fB\-c\fR ", " \fB\-\-create\fR +Create archive. +.TP +.BR \fB\-C\fR " " \fIdirectory\fR ", " \fB\-\-directory=\fIdirectory\fR +Extract into the specified directory. +.TP +.BR \fB\-E\fR " " \fIencoding\fR ", " \fB\-\-encoding=\fIencoding\fR +The encoding used by the archive (only tar, lha and zoo files). +.TP +.BR \fB\-f\fR ", " \fB\-\-force\fR +Force / overwrite files. +.TP +.BR \fB\-h\fR ", " \fB\-\-help\fR +Show the help. +.TP +.BR \fB\-\-iri\fR +Use an IRI to access the archive. +.TP +.BR \fB\-l\fR ", " \fB\-\-list\fR +List all files in the archive. +.TP +.BR \fB\-n\fR ", " \fB\-\-no\-clobber\fR +Never overwrite files. +.TP +.BR \fB\-p\fR ", " \fB\-\-print\fR +Print one or more files from the archive. +.TP +.BR \fB\-q\fR ", " \fB\-\-quiet\fR +Quiet mode (no outputu, except errors). +.TP +.BR \fB\-t\fR " " \fItype\fR ", " \fB\-\-type=\fItype\fR +Archive type (gz, lha, tar, tgz, zip, zoo). +.TP +.BR \fB\-v\fR ", " \fB\-\-verbose\fR +Verbose output for file list. +.TP +.BR \fB\-x\fR ", " \fB\-\-extract\fR +Extract files. +.SH EXAMPLES +Extract all files in an archive: +.PP + ofarc -x archive.tar.gz +.PP +Create a new archive with the directory \fBfoo\fR and all its files: +.PP + ofarc -c foo.zip foo +.PP +List all files in an archive without downloading it: +.PP + ofarc --iri -l https://example.com/archive.lha +.PP +Print file \fBREADME\fR in \fBarchive.tar.gz\fR: +.PP + ofarc -p archive.tar.gz README