Warning, /utilities/krusader/doc/handbook/archives.docbook is written in an unsupported language. File is not indexed.

0001 <!--
0002     SPDX-FileCopyrightText: 2000-2003 Shie Erlich <erlich@users.sourceforge.net>
0003     SPDX-FileCopyrightText: 2000-2003 Rafi Yanai <yanai@users.sourceforge.net>
0004     SPDX-FileCopyrightText: 2004-2010 Frank Schoolmeesters <codeknight@users.sourceforge.net>
0005     SPDX-FileCopyrightText: 2000-2022 Krusader Krew <https://krusader.org>
0006 -->
0007 <sect1 id="archives">
0008   <title>Archive Handling</title>
0009   <indexterm>
0010     <primary>Archives</primary>
0011   </indexterm>
0012   <sect2 id="browsing-archives">
0013     <title>Browsing Archives</title>
0014     <para>The <link linkend="vfs">Virtual file systems (VFS)</link> allows you to browse archives as
0015     if it was a folder. Currently &krusader; supports
0016     the following archives types: ace, arj, bzip2, deb, gzip, iso,
0017     lha, rar, rpm, tar, xz, zip, and 7-zip and supports the following
0018     passworded archives: arj, ace, rar and zip. Passwords can be
0019     stored in <application>KWallet</application>. Please note that the archive
0020     support first needs to be properly 
0021     <link linkend="konfig-archives">configured</link> in
0022     Konfigurator. To open the archive, use &Enter; key,
0023     (double-)click or the &Right; key. &krusader; supports
0024     also 
0025     <emphasis role="bold">hidden archives</emphasis>, these are
0026     renamed archives with a *wrong* extension, &eg;
0027     <trademark class="registered">OpenOffice</trademark> uses zip archives with the following
0028     extensions: <literal role="extension">.odt</literal>,
0029     <literal role="extension">.sxw</literal> and <literal role="extension">.odw</literal>.
0030     &Enter; will open the
0031     <trademark class="registered">OpenOffice</trademark> document and the 
0032     &Right; key will open the archive. Another
0033     example is J2EE, where the <literal role="extension">.jar</literal> extension means a zip archive.
0034     Since &krusader; auto-detects the supported archive
0035     types, it will open with 
0036     &Right; key even if it has another &MIME; type.
0037     Please note that browsing archives has a few limitations: 
0038     <itemizedlist>
0039       <listitem>
0040         <para>Not all functions are supported by all archive types.
0041         (&ie;: you can not delete files in ace or rar
0042         archives)</para>
0043       </listitem>
0044       <listitem>
0045         <para>The permissions you have inside the archive are the
0046         same as the permissions you have for the archive.</para>
0047       </listitem>
0048       <listitem>
0049         <para>The command line (if visible) will not follow you
0050         inside the archive but will point to the archive
0051         folder.</para>
0052       </listitem>
0053       <listitem>
0054         <para>Before any action is performed on files/folders
0055         inside the archive, they must be extracted. The archive
0056         will be repacked when you leave it or when
0057         &krusader; detects that extracted files have
0058         changed.</para>
0059       </listitem>
0060       <listitem>
0061         <para>Packing and un-packing are <quote>blocking operations</quote> that
0062         display a progress dialog. However, this might change in
0063         the future since we are planning to create more background
0064         operations.</para>
0065       </listitem>
0066     </itemizedlist></para>
0067   </sect2>
0068   <sect2 id="unpacking-archives">
0069     <title>Unpack Files</title>
0070     <para>There are 2 ways to extract files from archives:</para>
0071     <para>If you want to unpack a whole archive(s), browse to the
0072     archive location, select the archive(s) and select 
0073       <menuchoice>
0074         <guimenu>File</guimenu>
0075         <guimenuitem>Unpack</guimenuitem>
0076       </menuchoice>
0077     or 
0078     <keycombo action="simul">&Alt;&Shift;
0079     <keycap>U</keycap></keycombo>. &krusader; will ask
0080     you where to put the extracted files. The default location is
0081     the inactive panel folder. If you do not cancel the
0082     operation, &krusader; will try to unpack all the
0083     selected files in the inactive panel.</para>
0084     <para>If you only want to extract a part of the archive, then 
0085     <link linkend="browsing-archives">browse</link> the archive and
0086     copy the files you want to extract to their new location just
0087     as you would copy <quote>normal</quote> files. Note that unpacking from a
0088     browsed archive takes more time (file by file unpack) compared
0089     to unpacking a whole archive with the first method.
0090     The unpack operation can be put in a <link linkend="queue">queue</link>.</para>
0091   </sect2>
0092   <sect2 id="pack-archive">
0093     <title>Packing Files</title>
0094     <para>If you want to create a new archive, begin by selecting
0095     the elements you want to pack in the active panel and select 
0096       <menuchoice>
0097         <guimenu>File</guimenu>
0098         <guimenuitem>Pack...</guimenuitem>
0099       </menuchoice>
0100     or 
0101     <keycombo action="simul">&Alt;&Shift;
0102     <keycap>P</keycap></keycombo>. A dialog will pop-up prompting
0103     you to select the archive name and location. Select the packer
0104     from one of the 
0105     <link linkend="konfig-archives">supported file name
0106     extensions</link>.</para>
0107     <para>To add files to an existing archive(s), open the archive
0108     in one panel and the files to be copied in the other panel,
0109     then simply copy the files into the archive in exactly the same
0110     way you copy files into a <quote>normal</quote> folder.
0111     The pack operation can be put in a <link linkend="queue">queue</link>.</para>
0112   </sect2>
0113   <sect2 id="test-archive">
0114     <title>Testing Archives</title>
0115     <para>&krusader; will not handle corrupted archives since it may
0116     result in data loss. If you receive an error message when
0117     opening an archive, or if you suspect that there is something
0118     wrong with the archive, you should test it before use. To test
0119     an archive, browse (navigate) to the archive location and
0120     select the archive. Next select 
0121       <menuchoice>
0122         <guimenu>File</guimenu>
0123         <guimenuitem>Test Archive</guimenuitem>
0124       </menuchoice>
0125     or 
0126     <keycombo action="simul">&Alt;
0127     <keycap>E</keycap></keycombo>. &krusader; will test
0128     the archive file and inform you whether the archive passed or
0129     failed the file integrity test.</para>
0130   </sect2>
0131 </sect1>