'\" t
.\"     Title: \fBark\fR
.\"    Author: Lauri Watts <lauri@kde.org>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2018-08-08
.\"    Manual: Ark User's Manual
.\"    Source: KDE Applications 18.12
.\"  Language: English
.\"
.TH "\FBARK\FR" "1" "2018\-08\-08" "KDE Applications 18.12" "Ark User's Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ark \- KDE archiving tool
.SH "SYNOPSIS"
.HP \w'\fBark\fR\ 'u
\fBark\fR [\fB\-b\fR] [\fB\-a\fR] [\fB\-e\fR] [\fB\-O\fR] [\fB\-c\fR] [\fB\-f\fR\fI
suffix\fR] [\fB\-p\fR] [\fB\-t\fR\fI
file\fR] [\fB\-d\fR] [\fB\-m\fR] [\fB\-o\fR\fI
directory\fR] [KF5\ Generic\ Options] [Qt(TM)\ Generic\ Options]
.SH "DESCRIPTION"
.PP
Ark
is a program for managing various compressed file formats within
KDE\&. Archives can be viewed, extracted, created and modified with
Ark\&. The program can handle various formats such as
tar,
gzip,
bzip2,
zip,
rar
(when the appropriate libraries or command\-line programs are installed)\&.
.SH "OPERATION MODES"
.PP
Ark
can be used either as a stand\-alone
GUI
program as well as a command\-line program in order to perform some specific tasks\&.
.PP
If invoked without the \-b (\-\-batch) or \-c (\-\-add) options,
Ark
is started as a normal
GUI
program\&.
.PP
When the \-b (\-\-batch) option is used,
Ark
can be used to extract the contents of one or more files directly from the command\-line, without launching its
GUI\&.
.PP
When the \-c (\-\-add) option is used,
Ark
prompts for files that should be added to a new archive or to an existing archive\&.
.PP
.PP
.SH "OPTIONS"
.PP
\fB\-d, \-\-dialog\fR
.RS 4
Show a dialog for specifying the options for a batch or add operation\&.
.RE
.PP
\fB\-m, \-\-mimetypes\fR
.RS 4
List supported
MIME
types\&.
.RE
.PP
\fB\-o, \-\-destination \fR\fB\fIdirectory\fR\fR
.RS 4
Default the extraction directory to
\fIdirectory\fR\&. If not passed, the current path is used\&.
.RE
.SS "Options for adding files"
.PP
\fB\-c, \-\-add\fR
.RS 4
Query the user for an archive filename and add specified files to it\&. Quit when finished\&.
.RE
.PP
\fB\-t, \-\-add\-to \fR\fB\fIfilename\fR\fR
.RS 4
Add the specified files to
\fIfilename\fR\&. Create archive if it does not exist\&. Quit when finished\&.
.RE
.PP
\fB\-p, \-\-changetofirstpath\fR
.RS 4
Change the current directory to the first entry and add all other entries relative to this one\&.
.RE
.PP
\fB\-f, \-\-autofilename \fR\fB\fIsuffix\fR\fR
.RS 4
Automatically choose a filename, with the selected
\fIsuffix\fR
(for example rar, tar\&.gz, zip or any other supported types)\&.
.RE
.SS "Options for batch extraction"
.PP
\fB\-b, \-\-batch\fR
.RS 4
Use the batch interface instead of the usual dialog\&. This option is implied if more than one url is specified\&.
.RE
.PP
\fB\-e, \-\-autodestination\fR
.RS 4
The destination argument will be set to the path of the first file supplied\&.
.RE
.PP
\fB\-a, \-\-autosubfolder\fR
.RS 4
Archive contents will be read, and if detected to not be a single folder archive, a subfolder by the name of the archive will be created\&.
.RE
.PP
\fB\-O, \-\-opendestination\fR
.RS 4
Open the destination folder when the extraction is complete\&.
.RE
.SH "SEE ALSO"
.RS 4
More detailed user documentation is available from \m[blue]\fBhelp:/ark\fR\m[]
(either enter this URL into Konqueror, or run
\fB\fBkhelpcenter\fR\fR\fB
\fR\fB\fIhelp:/ark\fR\fR)\&.
.RE
.RS 4
kf5options(7)
.RE
.RS 4
qt5options(7)
.RE
.SH "EXAMPLES"
.PP
\fB\fBark\fR\fR\fB \fR\fB\fB\-\-batch\fR\fR\fB \fR\fB\fIarchive\&.tar\&.bz2\fR\fR
.RS 4
Will extract
\fIarchive\&.tar\&.bz2\fR
into the current directory without showing any
GUI\&.
.RE
.PP
\fB\fBark\fR\fR\fB \fR\fB\fB\-b\fR\fR\fB \fR\fB\fB\-d\fR\fR\fB \fR\fB\fIarchive\&.tar\&.bz2\fR\fR\fB \fR\fB\fIarchive2\&.zip\fR\fR
.RS 4
Will first show an extraction options dialog and then extract both
\fIarchive\&.tar\&.bz2\fR
and
\fIarchive2\&.zip\fR
into the directory chosen in the dialog\&.
.RE
.PP
\fB\fBark\fR\fR\fB \fR\fB\fB\-\-add\-to\fR\fR\fB \fR\fB\fImy\-archive\&.zip\fR\fR\fB \fR\fB\fIphoto1\&.jpg\fR\fR\fB \fR\fB\fItext\&.txt\fR\fR
.RS 4
Will create
\fImy\-archive\&.zip\fR
if does not exist and then add
\fIphoto1\&.jpg\fR
and
\fItext\&.txt\fR
to it\&.
.RE
.SH "MAINTAINERSHIP"
.PP
Ark
is currently maintained by
\fBElvis Angelaccio\fR
and
\fBRagnar Thomsen\fR\&.
.SH "AUTHORS"
.PP
\fBLauri Watts\fR <\&lauri@kde\&.org\&>
.RS 4
Initial version of Ark man page in 2005\&.
.RE
.PP
\fBRaphael Kubo da Costa\fR <\&rakuco@FreeBSD\&.org\&>
.RS 4
Update of Ark man page in 2009\&.
.RE
.PP
\fBRagnar Thomsen\fR <\&rthomsen6@gmail\&.com\&>
.RS 4
Update of Ark man page in 2015 and 2016\&.
.RE