summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBurkhard Lück <lueck@hube-lueck.de>2016-08-11 13:32:09 (GMT)
committerBurkhard Lück <lueck@hube-lueck.de>2016-08-11 13:32:09 (GMT)
commit4171721497331a20bf17f7bcd294123be52bfac0 (patch)
tree1cbe1b9d6d73082b901e41ce02728addd89db79b
parent14a4666635e4485327bff76a1ccb96ac29534223 (diff)
Update Ark documentation to 16.08
man page proofread, bump date + releaseinfo, add "See Also" with info about more qt + kf5 options handbook proofread, bump date + releaseinfo add features integrity test, compression and multi-volume update / add screenshot content + pngs from https://rthomsen6.wordpress.com/2016/08/01/ark-improvements-in-16-08/ REVIEW:128645
-rw-r--r--doc/create-archive.pngbin0 -> 25773 bytes
-rw-r--r--doc/create-protected-archive.pngbin21168 -> 45505 bytes
-rw-r--r--doc/index.docbook51
-rw-r--r--doc/man-ark.1.docbook19
4 files changed, 64 insertions, 6 deletions
diff --git a/doc/create-archive.png b/doc/create-archive.png
new file mode 100644
index 0000000..40a6bf5
--- /dev/null
+++ b/doc/create-archive.png
Binary files differ
diff --git a/doc/create-protected-archive.png b/doc/create-protected-archive.png
index 686d701..cf3d5f2 100644
--- a/doc/create-protected-archive.png
+++ b/doc/create-protected-archive.png
Binary files differ
diff --git a/doc/index.docbook b/doc/index.docbook
index da20381..6b17457 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -44,7 +44,7 @@
<legalnotice>&FDLNotice;</legalnotice>
-<date>2016-05-05</date>
+<date>2016-08-09</date>
<releaseinfo>Applications 16.08</releaseinfo>
<abstract>
@@ -73,7 +73,8 @@ archives.
<command>tar</command>, <command>gzip</command>,
<command>bzip2</command>, <command>zip</command>, <command>rar</command>,
<command>7zip</command>, <command>xz</command>, <command>rpm</command>,
-<command>cab</command> and <command>deb</command> (support for certain archive formats depends on
+<command>cab</command>, <command>deb</command>, <command>xar</command>
+and <command>AppImage</command> (support for certain archive formats depends on
the appropriate command-line programs being installed).</para>
<mediaobject>
@@ -120,6 +121,10 @@ For example, you can save the archive with a different name using <guimenuitem>S
Archive properties such as type, size and MD5 hash can be viewed using the
<guimenuitem>Properties</guimenuitem> item.</para>
+<para>&ark; has the ability to test archives for integrity. This functionality is currently available for
+<command>zip</command>, <command>rar</command> and <command>7z</command> archives.
+The test action can be found in the <guimenu>Archive</guimenu> menu.</para>
+
</sect2>
<sect2 id="ark-archive-comments">
@@ -262,11 +267,20 @@ archive.</para>
<guimenuitem>New</guimenuitem> (<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>)
from the <guimenu>Archive</guimenu> menu.</para>
+<mediaobject>
+<imageobject>
+<imagedata fileref="create-archive.png" format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>Create an archive</phrase>
+</textobject>
+</mediaobject>
+
<para>You can then type the name of the archive, with the appropriate
extension (<literal role="extension">tar.gz</literal>, <literal
role="extension">zip</literal>, <literal role="extension">7z</literal>,
&etc;) or select a supported format in the <guilabel>Filter</guilabel> combo box
-and check the <guilabel>Automatically select filename extension</guilabel> option.</para>
+and check the <guilabel>Automatically add <replaceable>filename extension</replaceable></guilabel> option.</para>
<para>To add files or folders to the new archive, choose <guimenuitem>Add
File...</guimenuitem> or <guimenuitem>Add
@@ -277,6 +291,17 @@ from e.g. &dolphin; into the main &ark; window, and it will
be added to the current archive. Note that files added in this way will always be added
to the root directory of the archive.</para>
+<para>Additional options are presented in collapsible groups at the bottom of the dialog.
+</para>
+
+<sect2 id="ark-compression">
+<title>Compression</title>
+<para>A higher value generates smaller archives, but results in longer compression and decompression times.
+The default compression level proposed by &ark; is usually a good compromise between size and (de)compression speed.
+For most formats the minimum compression level is equivalent to just storing the files, &ie; applying no compression.
+</para>
+</sect2>
+
<sect2 id="ark-password-protection">
<title>Password Protection</title>
<para>If you create a <literal role="extension">zip</literal>, <literal
@@ -297,8 +322,28 @@ This is called header encryption and is available only with the
<literal role="extension">rar</literal> and <literal role="extension">7zip</literal>
formats. Header encryption is enabled by default (when available), in order to offer
the maximum protection for novice users.</para>
+</sect2>
+<sect2 id="ark-multi-volume">
+<title>Multi-volume Archive</title>
+<para>With the <literal role="extension">zip</literal>, <literal role="extension">rar</literal>
+and <literal role="extension">7z</literal> formats you can create multi-volume archives, also
+known as multi-part or split archives.</para>
+<para>A multi-volume archive is one big compressed archive split into several files. This feature
+is useful if the maximum file size is limited, &eg; by the capacity of a storage medium
+or the maximal size of an email with attachments.</para>
+<para>To create a multi-volume archive, check the <guilabel>Create multi-volume archive</guilabel>
+checkbox and set a maximum <guilabel>Volume size</guilabel> in the dialog. Then add all files to
+the archive and &ark; will automatically generate the required number of archive volumes.
+Depending on the selected format the files have an extension with consecutively numbering
+scheme &eg; <filename>xxx.7z.001</filename>, <filename>xxx.7z.002</filename> or
+<filename>xxx.zip.001</filename>, <filename>xxx.zip.002</filename> or <filename>xxx.part1.rar</filename>,
+<filename>xxx.part2.rar</filename> &etc;.</para>
+<para>To extract a multi-volume archive, put all archive files into one folder and open the file
+with the lowest extension number in &ark; and all other parts of the split archive
+will be opened automatically.</para>
</sect2>
+
</sect1>
</chapter>
diff --git a/doc/man-ark.1.docbook b/doc/man-ark.1.docbook
index 9786bca..b98cb54 100644
--- a/doc/man-ark.1.docbook
+++ b/doc/man-ark.1.docbook
@@ -19,8 +19,8 @@
<contrib>Update of &ark; man page in 2015 and 2016.</contrib>
<email>rthomsen6@gmail.com</email></author>
-<date>2016-03-19</date><!--Update only when changing/reviewing this man page-->
-<releaseinfo>16.04</releaseinfo><!--Update only when changing/reviewing this man page-->
+<date>2016-08-09</date><!--Update only when changing/reviewing this man page-->
+<releaseinfo>16.08</releaseinfo><!--Update only when changing/reviewing this man page-->
<productname>KDE Applications</productname>
</refentryinfo>
@@ -50,7 +50,7 @@ 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">&kf5; Generic Options</arg>
<arg choice="opt">&Qt; Generic Options</arg>
</cmdsynopsis>
</refsynopsisdiv>
@@ -175,6 +175,19 @@ a subfolder by the name of the archive will be created.</para>
</refsect1>
<refsect1>
+<title>See Also</title>
+<simplelist>
+<member>More detailed user documentation is available from <ulink
+url="help:/ark">help:/ark</ulink>
+(either enter this &URL; into &konqueror;, or run
+<userinput><command>khelpcenter</command>
+<parameter>help:/ark</parameter></userinput>).</member>
+<member>kf5options(7)</member>
+<member>qt5options(7)</member>
+</simplelist>
+</refsect1>
+
+<refsect1>
<title>Examples</title>
<variablelist>