<?xml version="1.0" ?> <!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY kappname "&ark;"> <!ENTITY % English "INCLUDE"> ]> <refentry lang="&language;"> <refentryinfo> <title>&kde; User's Manual</title> <author>&Lauri.Watts;&Lauri.Watts.mail;</author> <author>&Raphael.Kubo.da.Costa; &Raphael.Kubo.da.Costa.mail;</author> <date>2009-09-10</date> <releaseinfo>2.13 (&kde; 4.3.1)</releaseinfo> <productname>K Desktop Environment</productname> </refentryinfo> <refmeta> <refentrytitle><command>ark</command></refentrytitle> <manvolnum>1</manvolnum> </refmeta> <refnamediv> <refname><command>ark</command></refname> <refpurpose>&kde; archiving tool</refpurpose> </refnamediv> <refsynopsisdiv> <cmdsynopsis> <command>ark</command> <group choice="opt"><option>-b</option></group> <group choice="opt"><option>-a</option></group> <group choice="opt"><option>-e</option></group> <group choice="opt"><option>-c</option></group> <group choice="opt"><option>-f</option> <replaceable> suffix</replaceable></group> <group choice="opt"><option>-p</option></group> <group choice="opt"><option>-t</option> <replaceable> file</replaceable></group> <group choice="opt"><option>-d</option></group> <group choice="opt"><option>-o</option> <replaceable> directory</replaceable></group> <arg choice="opt">&kde; Generic Options</arg> <arg choice="opt">&Qt; Generic Options</arg> </cmdsynopsis> </refsynopsisdiv> <refsect1> <title>Description</title> <para>&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 <application>tar</application>, <application>gzip</application>, <application>bzip2</application>, <application>zip</application>, <application>rar</application> (when the appropriate libraries or command-line programs are installed).</para> </refsect1> <refsect1> <title>Operation modes</title> <para>&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.</para> <para>If invoked without the -b (--batch) or -c (--add) options, &ark; is started as a normal &GUI; program.</para> <para>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;.</para> <para>When the -c (--add) option is used, &ark; prompts for files that should be added to a new archive or to an existing archive.</para> <para></para> <para></para> </refsect1> <refsect1> <title>Options</title> <variablelist> <varlistentry> <term><option>-d, --dialog</option></term> <listitem> <para>Show a dialog for specifying the options for a batch or add operation.</para> </listitem> </varlistentry> <varlistentry> <term><option>-o, --destination <replaceable>directory</replaceable></option></term> <listitem><para>Default the extraction directory to <replaceable>directory</replaceable>. If not passed, the current path is used.</para> </listitem> </varlistentry> </variablelist> <refsect2> <title>Options for adding files</title> <variablelist> <varlistentry> <term><option>-c, --add</option></term> <listitem> <para>Query the user for an archive filename and add specified files to it. Quit when finished.</para> </listitem> </varlistentry> <varlistentry> <term><option>-t, --add-to <replaceable>filename</replaceable></option></term> <listitem> <para>Add the specified files to <replaceable>filename</replaceable>. Create archive if it does not exist. Quit when finished.</para> </listitem> </varlistentry> <varlistentry> <term><option>-p, --changetofirstpath</option></term> <listitem> <para>Change the current directory to the first entry and add all other entries relative to this one.</para> </listitem> </varlistentry> <varlistentry> <term><option>-f, --autofilename <replaceable>suffix</replaceable></option></term> <listitem> <para>Automatically choose a filename, with the selected <replaceable>suffix</replaceable> (for example rar, tar.gz, zip or any other supported types).</para> </listitem> </varlistentry> </variablelist> </refsect2> <refsect2> <title>Options for batch extraction</title> <variablelist> <varlistentry> <term><option>b, --batch</option></term> <listitem> <para>Use the batch interface instead of the usual dialog. This option is implied if more than one url is specified.</para> </listitem> </varlistentry> <varlistentry> <term><option>-e, --autodestination</option></term> <listitem> <para>The destination argument will be set to the path of the first file supplied.</para> </listitem> </varlistentry> <varlistentry> <term><option>-a, --autosubfolder</option></term> <listitem> <para>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.</para> </listitem> </varlistentry> </variablelist> </refsect2> </refsect1> <refsect1> <title>Examples</title> <variablelist> <varlistentry> <term><userinput><command>ark</command> <option>--batch</option> <replaceable>archive.tar.bz2</replaceable></userinput></term> <listitem> <para>Will extract <replaceable>archive.tar.bz2</replaceable> into the current directory without showing any &GUI;. </para> </listitem> </varlistentry> <varlistentry> <term><userinput><command>ark</command> <option>-b</option> <option>-d</option> <replaceable>archive.tar.bz2</replaceable> <replaceable>archive2.zip</replaceable></userinput></term> <listitem> <para>Will first show an extraction options dialog and then extract both <replaceable>archive.tar.bz2</replaceable> and <replaceable>archive2.zip</replaceable> into the directory chosen in the dialog.</para> </listitem> </varlistentry> <varlistentry> <term><userinput><command>ark</command> <option>--add-to</option> <replaceable>my-archive.zip</replaceable> <replaceable>photo1.jpg</replaceable> <replaceable>text.txt</replaceable></userinput></term> <listitem> <para>Will create <replaceable>my-archive.zip</replaceable> if does not exist and then add <replaceable>photo1.jpg</replaceable> and <replaceable>text.txt</replaceable> to it. </para> </listitem> </varlistentry> </variablelist> </refsect1> <refsect1> <title>Authors</title> <para>&ark; is currently maintained by &Harald.Hvaal; &Harald.Hvaal.mail; and &Raphael.Kubo.da.Costa; &Raphael.Kubo.da.Costa.mail;.</para> <para>This man page was first written by &Lauri.Watts; &Lauri.Watts.mail; in 2005 for &kde; 3.4, and was later updated in 2009 by &Raphael.Kubo.da.Costa; &Raphael.Kubo.da.Costa.mail;.</para> </refsect1> </refentry>