Changeset View
Changeset View
Standalone View
Standalone View
doc/archives.docbook
Show All 22 Lines | 19 | <sect1 id="archives"> | |||
---|---|---|---|---|---|
23 | </indexterm> | 23 | </indexterm> | ||
24 | <sect2 id="browsing-archives"> | 24 | <sect2 id="browsing-archives"> | ||
25 | <title>Browsing Archives</title> | 25 | <title>Browsing Archives</title> | ||
26 | <para>The <link linkend="vfs">Virtual file systems (VFS)</link> allows you to browse archives as | 26 | <para>The <link linkend="vfs">Virtual file systems (VFS)</link> allows you to browse archives as | ||
27 | if it was a directory. Currently &krusader; supports | 27 | if it was a directory. Currently &krusader; supports | ||
28 | the following archives types: ace, arj, bzip2, deb, gzip, iso, | 28 | the following archives types: ace, arj, bzip2, deb, gzip, iso, | ||
29 | lha, rar, rpm, tar, xz, zip, and 7-zip and supports the following | 29 | lha, rar, rpm, tar, xz, zip, and 7-zip and supports the following | ||
30 | passworded archives: arj, ace, rar and zip. Passwords can be | 30 | passworded archives: arj, ace, rar and zip. Passwords can be | ||
31 | stored in <application>Kwallet</application>. Please note that the archive | 31 | stored in <application>KWallet</application>. Please note that the archive | ||
32 | support first needs to be properly | 32 | support first needs to be properly | ||
33 | <link linkend="konfig-archives">configured</link> in | 33 | <link linkend="konfig-archives">configured</link> in | ||
34 | Konfigurator. To open the archive, use &Enter;, | 34 | Konfigurator. To open the archive, use &Enter; key, | ||
35 | (double-)click or the | 35 | (double-)click or the &Right; key. &krusader; supports | ||
36 | <keycap>Right Arrow</keycap>. &krusader; supports | | |||
37 | also | 36 | also | ||
38 | <emphasis role="bold">hidden archives</emphasis>, these are | 37 | <emphasis role="bold">hidden archives</emphasis>, these are | ||
39 | renamed archives with a *wrong* extension, ⪚ | 38 | renamed archives with a *wrong* extension, ⪚ | ||
40 | <trademark class="registered">OpenOffice</trademark> uses zip archives with the following | 39 | <trademark class="registered">OpenOffice</trademark> uses zip archives with the following | ||
41 | extensions: <literal role="extension">.odt</literal>, | 40 | extensions: <literal role="extension">.odt</literal>, | ||
42 | <literal role="extension">.sxw</literal> and <literal role="extension">.odw</literal>. | 41 | <literal role="extension">.sxw</literal> and <literal role="extension">.odw</literal>. | ||
43 | &Enter; will open the | 42 | &Enter; will open the | ||
44 | <trademark class="registered">OpenOffice</trademark> document and the | 43 | <trademark class="registered">OpenOffice</trademark> document and the | ||
45 | <keycap>Right Arrow</keycap> will open the archive. Another | 44 | &Right; key will open the archive. Another | ||
46 | example is J2EE, where the <literal role="extension">.jar</literal> extension means a zip archive. | 45 | example is J2EE, where the <literal role="extension">.jar</literal> extension means a zip archive. | ||
47 | Since &krusader; auto-detects the supported archive | 46 | Since &krusader; auto-detects the supported archive | ||
48 | types, it will open with | 47 | types, it will open with | ||
49 | <keycap>Right Arrow</keycap> even if it has another MIME type. | 48 | &Right; key even if it has another &MIME; type. | ||
50 | Please note that browsing archives has a few limitations: | 49 | Please note that browsing archives has a few limitations: | ||
51 | <itemizedlist> | 50 | <itemizedlist> | ||
52 | <listitem> | 51 | <listitem> | ||
53 | <para>Not all functions are supported by all archive types. | 52 | <para>Not all functions are supported by all archive types. | ||
54 | (&ie;: you can not delete files in ace or rar | 53 | (&ie;: you can not delete files in ace or rar | ||
55 | archives)</para> | 54 | archives)</para> | ||
56 | </listitem> | 55 | </listitem> | ||
57 | <listitem> | 56 | <listitem> | ||
58 | <para>The permissions you have inside the archive are the | 57 | <para>The permissions you have inside the archive are the | ||
59 | same as the permissions you have for the archive.</para> | 58 | same as the permissions you have for the archive.</para> | ||
60 | </listitem> | 59 | </listitem> | ||
61 | <listitem> | 60 | <listitem> | ||
62 | <para>The command line (if visible) will not follow you | 61 | <para>The command line (if visible) will not follow you | ||
63 | inside the archive but will point to the archive | 62 | inside the archive but will point to the archive | ||
64 | directory.</para> | 63 | directory.</para> | ||
65 | </listitem> | 64 | </listitem> | ||
66 | <listitem> | 65 | <listitem> | ||
67 | <para>Before any action is performed on files/directories | 66 | <para>Before any action is performed on files/directories | ||
68 | inside the archive, they must be extracted. The archive | 67 | inside the archive, they must be extracted. The archive | ||
69 | will be repacked when you leave it or when | 68 | will be repacked when you leave it or when | ||
70 | &krusader; detects that extracted files have | 69 | &krusader; detects that extracted files have | ||
71 | changed.</para> | 70 | changed.</para> | ||
72 | </listitem> | 71 | </listitem> | ||
73 | <listitem> | 72 | <listitem> | ||
74 | <para>Packing and un-packing are "blocking operations" that | 73 | <para>Packing and un-packing are <quote>blocking operations</quote> that | ||
75 | display a progress dialog. However, this might change in | 74 | display a progress dialog. However, this might change in | ||
76 | the future since we are planning to create more background | 75 | the future since we are planning to create more background | ||
77 | operations.</para> | 76 | operations.</para> | ||
78 | </listitem> | 77 | </listitem> | ||
79 | </itemizedlist></para> | 78 | </itemizedlist></para> | ||
80 | </sect2> | 79 | </sect2> | ||
81 | <sect2 id="unpacking-archives"> | 80 | <sect2 id="unpacking-archives"> | ||
82 | <title>Unpack Files</title> | 81 | <title>Unpack Files</title> | ||
Show All 9 Lines | |||||
92 | <keycap>U</keycap></keycombo>. &krusader; will ask | 91 | <keycap>U</keycap></keycombo>. &krusader; will ask | ||
93 | you where to put the extracted files. The default location is | 92 | you where to put the extracted files. The default location is | ||
94 | the inactive panel directory. If you do not cancel the | 93 | the inactive panel directory. If you do not cancel the | ||
95 | operation, &krusader; will try to unpack all the | 94 | operation, &krusader; will try to unpack all the | ||
96 | selected files in the inactive panel.</para> | 95 | selected files in the inactive panel.</para> | ||
97 | <para>If you only want to extract a part of the archive, then | 96 | <para>If you only want to extract a part of the archive, then | ||
98 | <link linkend="browsing-archives">browse</link> the archive and | 97 | <link linkend="browsing-archives">browse</link> the archive and | ||
99 | copy the files you want to extract to their new location just | 98 | copy the files you want to extract to their new location just | ||
100 | as you would copy "normal" files. Note that unpacking from a | 99 | as you would copy <quote>normal</quote> files. Note that unpacking from a | ||
101 | browsed archive takes more time (file by file unpack) compared | 100 | browsed archive takes more time (file by file unpack) compared | ||
102 | to unpacking a whole archive with the first method. | 101 | to unpacking a whole archive with the first method. | ||
103 | The unpack operation can be put in a <link linkend="queue">queue</link>.</para> | 102 | The unpack operation can be put in a <link linkend="queue">queue</link>.</para> | ||
104 | </sect2> | 103 | </sect2> | ||
105 | <sect2 id="pack-archive"> | 104 | <sect2 id="pack-archive"> | ||
106 | <title>Packing Files</title> | 105 | <title>Packing Files</title> | ||
107 | <para>If you want to create a new archive, begin by selecting | 106 | <para>If you want to create a new archive, begin by selecting | ||
108 | the elements you want to pack in the active panel and select | 107 | the elements you want to pack in the active panel and select | ||
109 | <menuchoice> | 108 | <menuchoice> | ||
110 | <guimenu>File</guimenu> | 109 | <guimenu>File</guimenu> | ||
111 | <guimenuitem>Pack</guimenuitem> | 110 | <guimenuitem>Pack...</guimenuitem> | ||
112 | </menuchoice> | 111 | </menuchoice> | ||
113 | or | 112 | or | ||
114 | <keycombo action="simul">&Alt;&Shift; | 113 | <keycombo action="simul">&Alt;&Shift; | ||
115 | <keycap>P</keycap></keycombo>. A dialog will pop-up prompting | 114 | <keycap>P</keycap></keycombo>. A dialog will pop-up prompting | ||
116 | you to select the archive name and location. Select the packer | 115 | you to select the archive name and location. Select the packer | ||
117 | from one of the | 116 | from one of the | ||
118 | <link linkend="konfig-archives">supported file name | 117 | <link linkend="konfig-archives">supported file name | ||
119 | extensions</link>.</para> | 118 | extensions</link>.</para> | ||
120 | <para>To add files to an existing archive(s), open the archive | 119 | <para>To add files to an existing archive(s), open the archive | ||
121 | in one panel and the files to be copied in the other panel, | 120 | in one panel and the files to be copied in the other panel, | ||
122 | then simply copy the files into the archive in exactly the same | 121 | then simply copy the files into the archive in exactly the same | ||
123 | way you copy files into a "normal" directory. | 122 | way you copy files into a <quote>normal</quote> directory. | ||
124 | The pack operation can be put in a <link linkend="queue">queue</link>.</para> | 123 | The pack operation can be put in a <link linkend="queue">queue</link>.</para> | ||
125 | </sect2> | 124 | </sect2> | ||
126 | <sect2 id="test-archive"> | 125 | <sect2 id="test-archive"> | ||
127 | <title>Testing Archives</title> | 126 | <title>Testing Archives</title> | ||
128 | <para>&krusader; will not handle corrupted archives since it may | 127 | <para>&krusader; will not handle corrupted archives since it may | ||
129 | result in data loss. If you receive an error message when | 128 | result in data loss. If you receive an error message when | ||
130 | opening an archive, or if you suspect that there is something | 129 | opening an archive, or if you suspect that there is something | ||
131 | wrong with the archive, you should test it before use. To test | 130 | wrong with the archive, you should test it before use. To test | ||
Show All 13 Lines |