'\" t
.\"     Title: \fBark\fR
.\"    Author: Lauri Watts <lauri@kde.org>
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: 2009-09-10
.\"    Manual: KDE User's Manual
.\"    Source: K Desktop Environment 2.13 (KDE 4.3.1)
.\"  Language: English
.\"
.TH "\FBARK\FR" "1" "2009\-09\-10" "K Desktop Environment 2.13 (KD" "KDE 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\-c\fR] [\fB\-f\fR\fI
suffix\fR] [\fB\-p\fR] [\fB\-t\fR\fI
file\fR] [\fB\-d\fR] [\fB\-o\fR\fI
directory\fR] [KDE\ 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\-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
\fBb, \-\-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
.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 "AUTHORS"
.PP
Ark
is currently maintained by
Harald Hvaal
haraldhv@stud\&.ntnu\&.no
and
Raphael Kubo da Costa
kubito@gmail\&.com\&.
.PP
This man page was first written by
Lauri Watts
lauri@kde\&.org
in 2005 for
KDE
3\&.4, and was later updated in 2009 by
Raphael Kubo da Costa
kubito@gmail\&.com\&.
.SH "AUTHORS"
.PP
\fBLauri Watts\fR <\&lauri@kde\&.org\&>
.RS 4
Author.
.RE
.PP
\fBRaphael Kubo da Costa\fR <\&kubito@gmail\&.com\&>
.RS 4
Author.
.RE
