Git commit f33ba21736232d5bd5958152a2bbefb49f7fd623 by Burkhard Lück.
Committed on 03/12/2016 at 20:26.
Pushed by lueck into branch 'master'.

update partitionsmanager docbooks to kf5

bump fate + release info
proofread/update
remove unused entities
remove appendix.docbook
REVIEW:129597

D  +0    -156  doc/appendix.docbook
M  +0    -3    doc/faq.docbook
M  +29   -1    doc/glossary.docbook
M  +2    -24   doc/index.docbook
M  +1    -1    doc/introduction.docbook
M  +135  -76   doc/referencemanual.docbook
M  +4    -4    doc/usermanual.docbook

https://commits.kde.org/partitionmanager/f33ba21736232d5bd5958152a2bbefb49f7fd623

diff --git a/doc/appendix.docbook b/doc/appendix.docbook
deleted file mode 100644
index 5882aa3..0000000
--- a/doc/appendix.docbook
+++ /dev/null
@@ -1,156 +0,0 @@
-<appendix id="installation">
-       <title>Installation</title>
-
-       <sect1 id="obtaining">
-               <title>How to obtain &partman;</title>
-
-               <para>
-                       The main website for &partman; is <ulink 
url="http://www.partitionmanager.org";>www.partitionmanager.org</ulink>. For
-                       the most current version, this is the place to go.
-               </para>
-       </sect1>
-
-       <sect1 id="requirements">
-               <title>Requirements</title>
-
-               <para>
-                       In order to successfully use &partman;, you need &kde; 
4.2 or later and &Qt; 4.4.0 or later. You do however not need to be logged into 
&kde; to use it: &partman; will run just fine under any other desktop 
environment as long as you have the basic &kde; libraries installed.
-               </para>
-
-               <para>
-                       For a large part of its basic functionality &partman; 
relies on <ulink 
url="http://www.gnu.org/software/parted/index.shtml";>libparted</ulink>. To 
generate UUIDs for copied file systems, it uses libuuid, which is part of 
<ulink url="http://e2fsprogs.sourceforge.net";>e2fsprogs</ulink>. It also uses 
the <ulink url="http://userweb.kernel.org/~kzak/util-linux-ng/";>libblkid 
library from the util-linux-ng project</ulink> to obtain information about 
partitions and file systems. All of these are required to build or run 
&partman;.
-               </para>
-
-               <para>
-                       &partman; makes extensive use of external tools to 
support a wide range of file systems. A specific tool is only required if you 
need the support for an operation it provides for a certain file system. For 
example, if you have no need to resize NTFS file systems you do not require to 
have <quote>ntfsresize</quote> installed. None of these tools are required to 
build &partman; from sources.
-               </para>
-
-               <para>
-                       Here is a list of all external tools &partman; can make 
use of:
-               </para>
-
-               <itemizedlist>
-                       <listitem>
-                               <para>
-                                       &debugfsreiser4;: Reads usage 
information and file system labels for reiser4 file systems. Part of the 
reiser4progs utility suite that can be downloaded from <ulink 
url="http://www.kernel.org/pub/linux/utils/fs/reiser4/reiser4progs/"/>.
-                               </para>
-                       </listitem>
-
-                       <listitem>
-                               <para>
-                                       &debugreiserfs;: Reads usage 
information and file system labels for reiserfs file systems. Part of the 
reiserfsprogs utility suite that can be downloaded from <ulink 
url="http://www.kernel.org/pub/linux/utils/fs/reiserfs/"/>.
-                               </para>
-                       </listitem>
-
-                       <listitem>
-                               <para>
-                                       &dumpe2fs;: Reads usage information for 
ext2/ext3/ext4 file systems. Part of the e2fsprogs utility suite that can be 
downloaded from <ulink url="http://e2fsprogs.sourceforge.net/"/>.
-                               </para>
-                       </listitem>
-
-                       <listitem>
-                               <para>
-                                       &e2label;: Reads and writes file system 
labels for ext2/ext3/ext4 file systems. Part of the e2fsprogs utility suite 
that can be downloaded from <ulink url="http://e2fsprogs.sourceforge.net/"/>.
-                               </para>
-                       </listitem>
-
-                       <listitem>
-                               <para>
-                                       &fsckmsdos;: Reads usage information 
and checks FAT16 and FAT32 file systems. Part of the dosfstools utility suite 
that can be downloaded from <ulink 
url="http://www.daniel-baumann.ch/software/dosfstools/"/>.
-                               </para>
-                       </listitem>
-
-                       <listitem>
-                               <para>
-                                       &hfsck;: Reads file system labels and 
checks HFS file systems. Part of the hfsutils utility suite that can be 
downloaded from <ulink url="http://www.mars.org/home/rob/proj/hfs/"/>.
-                               </para>
-                       </listitem>
-
-                       <listitem>
-                               <para>
-                                       &hpfsck;: Checks HFS+ file systems. 
Part of the hfsplusutils utility suite that can be downloaded from <ulink 
url="http://www.penguinppc.org/historical/hfsplus/"/>.
-                               </para>
-                       </listitem>
-
-                       <listitem>
-                               <para>
-                                       &jfsdebugfs;: Reads usage information 
for JFS file systems. Part of the jfsutils utility suite that can be downloaded 
from <ulink url="http://jfs.sourceforge.net/"/>.
-                               </para>
-                       </listitem>
-
-                       <listitem>
-                               <para>
-                                       &jfstune;: Reads and writes file system 
labels for JFS file systems. Part of the jfsutils utility suite that can be 
downloaded from <ulink url="http://jfs.sourceforge.net/"/>.
-                               </para>
-                       </listitem>
-
-                       <listitem>
-                               <para>
-                                       &ntfslabel;:  Reads and writes file 
system labels for NTFS file systems. Part of the ntfsprogs utility suite that 
can be downloaded from <ulink url="http://www.linux-ntfs.org/"/>.
-                               </para>
-                       </listitem>
-
-                       <listitem>
-                               <para>
-                                       &ntfsresize;: Reads usage information, 
checks and resizes NTFS file systems. Part of the ntfsprogs utility suite that 
can be downloaded from <ulink url="http://www.linux-ntfs.org/"/>.
-                               </para>
-                       </listitem>
-
-                       <listitem>
-                               <para>
-                                       &swapoff;: Deactivates swap file 
systems. Part of the util-linux-ng utility suite that can be downloaded from 
<ulink url="ftp://ftp.us.kernel.org/pub/linux/utils/util-linux-ng/"/>.
-                               </para>
-                       </listitem>
-
-                       <listitem>
-                               <para>
-                                       &swapon;: Activates swap file systems. 
Part of the util-linux-ng utility suite that can be downloaded from <ulink 
url="ftp://ftp.us.kernel.org/pub/linux/utils/util-linux-ng/"/>.
-                               </para>
-                       </listitem>
-
-                       <listitem>
-                               <para>
-                                       &volid;: Reads file system labels for 
linuxswap file systems. Part of udev that can be downloaded from <ulink 
url="http://www.us.kernel.org/pub/linux/utils/kernel/hotplug/"/>.
-                               </para>
-                       </listitem>
-
-                       <listitem>
-                               <para>
-                                       &xfsdb;: Reads usage information and 
reads and writes file system labels for XFS file systems. Part of the xfsprogs 
utility suite that can be downloaded from <ulink 
url="ftp://oss.sgi.com/projects/xfs/cmd_tars/"/>.
-                               </para>
-                       </listitem>
-               </itemizedlist>
-       </sect1>
-
-       <sect1 id="compilation">
-               <title>Compilation and Installation</title>
-               &install.compile.documentation;
-       </sect1>
-
-       <sect1 id="furtherreading">
-               <title>Further Reading</title>
-
-               <itemizedlist>
-                       <listitem>
-                               <para>
-                                       <ulink url="http://www.linfo.org/";>The 
Linux Information Project</ulink> has a ton of information on many aspects of 
Linux. Their article on <ulink 
url="http://www.linfo.org/partition.html";>partitions</ulink> is very 
informative. But also see their entries on <ulink 
url="http://www.linfo.org/partition_table.html";>partition tables</ulink>, 
<ulink url="http://www.linfo.org/hdd.html";>hard disk devices</ulink> and <ulink 
url="http://www.linfo.org/filesystem.html";>file systems</ulink>.
-                               </para>
-                       </listitem>
-
-                       <listitem>
-                               <para>
-                                       The <ulink 
url="http://tldp.org/HOWTO/Partition/index.html";>Linux Partition HOWTO</ulink> 
is a basic overview of handling and partitioning disk devices on Linux and the 
native Linux file systems. It also covers swap partitions.
-                               </para>
-                       </listitem>
-
-                       <listitem>
-                               <para>
-                                       <ulink 
url="http://www.wikipedia.org";>Wikipedia</ulink> has an entry on <ulink 
url="http://en.wikipedia.org/wiki/Disk_partitioning";>disk partitioning</ulink>.
-                               </para>
-                       </listitem>
-                       
-               </itemizedlist>
-               
-       </sect1>
-       
-</appendix>
diff --git a/doc/faq.docbook b/doc/faq.docbook
index 625b2fc..b4e6149 100644
--- a/doc/faq.docbook
+++ b/doc/faq.docbook
@@ -1,9 +1,6 @@
 <chapter id="faq">
        <title>Questions and Answers</title>
 
-       &reporting.bugs;
-       &updating.documentation;
-
        <qandaset id="faqlist">
                <qandaentry>
                        <question>
diff --git a/doc/glossary.docbook b/doc/glossary.docbook
index 7637d3e..c4cc4fd 100644
--- a/doc/glossary.docbook
+++ b/doc/glossary.docbook
@@ -102,6 +102,14 @@
                <glosssee otherterm="glossary-partitionflag"/>
        </glossentry>
        
+       <glossentry>
+               <glossterm>GPT</glossterm>
+               <glossdef>
+                       <para>A modern partition table format supported by most 
modern computers and operating systems. It supports more than 4 <link 
linkend="glossary-primarypartition">primary partitions</link> unlike older 
MS-DOS partition table.
+                       </para>
+               </glossdef>
+       </glossentry>
+
        <glossentry id="glossary-head">
                <glossterm>Head</glossterm>
                <glossdef>
@@ -124,7 +132,7 @@
                </glossdef>
        </glossentry>
 
-       <glossentry>
+       <glossentry id="glossary-label">
                <glossterm>Label</glossterm>
                <glossdef>
                        <para>
@@ -146,6 +154,26 @@
                </glossdef>
        </glossentry>
 
+       <glossentry id="glossary-luks">
+               <glossterm>LUKS</glossterm>
+               <glossdef>
+                       <para>Linux Unified Key Setup is the standard 
encryption format for Linux.
+                       </para>
+               </glossdef>
+       </glossentry>
+
+       <glossentry id="glossary-lvm">
+               <glossterm>LVM</glossterm>
+               <glossdef>
+                       <para>LVM is a system for managing logical partitions 
that is more flexible than normal partitions. It consists of three main 
components:</para>
+                       <simplelist>
+                       <member>LVM physical volumes are partitions on the disk 
whose space is managed by LVM.</member>
+                       <member>LVM volume group is a collection of LVM 
physical volumes that can be partitioned into logical partitions. It might be 
used to create file systems spanning over multiple devices or to split 
encrypted <link linkend="glossary-luks">LUKS</link> volume into smaller 
partitions.</member>
+                       <member>LVM logical volumes are similar to normal 
partitions except that they reside on LVM volume group. Also, the location of 
LVM logical partitions does not matter and they do not have to be physically 
contiguous. Therefore, &partman; does not allow to move LVM logical volumes and 
displays the remaining free space at the end of the device.</member>
+                       </simplelist>
+               </glossdef>
+       </glossentry>
+
        <glossentry id="glossary-operation">
                <glossterm>Operation</glossterm>
                <glossdef>
diff --git a/doc/index.docbook b/doc/index.docbook
index 79d7af6..fbfc427 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -2,7 +2,6 @@
 
 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" 
"dtd/kdedbx45.dtd" [
 
-        <!ENTITY partman "<application>KDE Partition Manager</application>"> 
<!--remove this entity later, it is also in lang/user.entities to make it 
translatable-->
        <!ENTITY partman-introduction SYSTEM "introduction.docbook">
        <!ENTITY partman-usermanual SYSTEM "usermanual.docbook">
        <!ENTITY partman-resizehowto SYSTEM "resizehowto.docbook">
@@ -11,27 +10,8 @@
        <!ENTITY partman-referencemanual SYSTEM "referencemanual.docbook">
        <!ENTITY partman-faq SYSTEM "faq.docbook">
        <!ENTITY partman-credits SYSTEM "credits.docbook">
-       <!ENTITY partman-appendix SYSTEM "appendix.docbook">
        <!ENTITY partman-glossary SYSTEM "glossary.docbook">
 
-       <!ENTITY debugfsreiser4 "<application>debugfs.reiser4</application>">
-       <!ENTITY debugreiserfs "<application>debugreiserfs</application>">
-       <!ENTITY dumpe2fs "<application>dumpe2fs</application>">
-       <!ENTITY e2label "<application>e2label</application>">
-       <!ENTITY fsckmsdos "<application>fsck.msdos</application>">
-       <!ENTITY hfsck "<application>hfsck</application>">
-       <!ENTITY hpfsck "<application>hpfsck</application>">
-       <!ENTITY jfsdebugfs "<application>jfs_debugfs</application>">
-       <!ENTITY jfstune "<application>jfs_tune</application>">
-       <!ENTITY ntfslabel "<application>ntfslabel</application>">
-       <!ENTITY ntfsresize "<application>ntfsresize</application>">
-       <!ENTITY swapoff "<application>swapoff</application>">
-       <!ENTITY swapon "<application>swapon</application>">
-       <!ENTITY volid "<application>vol_id</application>">
-       <!ENTITY xfsdb "<application>xfs_db</application>">
-
-       <!ENTITY kappname "&partman;">
-       <!ENTITY package "extragear">
        <!ENTITY % addindex "IGNORE">
        <!ENTITY % English "INCLUDE">
 ]>
@@ -54,8 +34,8 @@
 
                <legalnotice>&FDLNotice;</legalnotice>
 
-               <date>2010-01-08</date>
-               <releaseinfo>1.00.00</releaseinfo>
+               <date>2016-12-01</date>
+               <releaseinfo>&partman; 3.0.0</releaseinfo>
 
                <abstract>
                        <para>Manage your disks, partitions and file 
systems.</para>
@@ -82,8 +62,6 @@
        &partman-faq;
 
        &partman-credits;
-       
-       &partman-appendix;
 
        &partman-glossary;
 
diff --git a/doc/introduction.docbook b/doc/introduction.docbook
index a0361b1..7d6ed13 100644
--- a/doc/introduction.docbook
+++ b/doc/introduction.docbook
@@ -8,7 +8,7 @@
        </para>
 
        <para>
-               To get its job done efficiently &partman; makes use of external 
tools to support a long list of file systems. See <xref 
linkend="requirements"/> for details about that. You will probably have the 
required tools for the file systems on your computer installed already.
+               To get its job done efficiently &partman; makes use of external 
tools to support a long list of file systems. You will probably have the 
required tools for the file systems on your computer installed already.
        </para>
 
        <warning>
diff --git a/doc/referencemanual.docbook b/doc/referencemanual.docbook
index f427d7c..d2da79d 100644
--- a/doc/referencemanual.docbook
+++ b/doc/referencemanual.docbook
@@ -4,10 +4,9 @@
        <sect1 id="reference-overview">
                <title>Overview</title>
                <para>This chapter gives detailed explanations of all commands 
available in &partman;. It is intended as a reference to accompany the 
information given in <xref linkend="usermanual"/>.</para>
-       </sect1>
-       
-       <sect1 id="menu-file">
-               <title>The <guimenu>File</guimenu> Menu</title>
+
+       <sect2 id="menu-file">
+               <title>The File Menu</title>
                <para>
                        <variablelist>
                                <varlistentry id="menu-file-quit">
@@ -26,10 +25,10 @@
                                </varlistentry>
                        </variablelist>
                </para>
-       </sect1>
+       </sect2>
 
-       <sect1 id="menu-edit">
-               <title>The <guimenu>Edit</guimenu> Menu</title>
+       <sect2 id="menu-edit">
+               <title>The Edit Menu</title>
                <para>
                        <variablelist>
                                <varlistentry id="menu-edit-undo">
@@ -83,68 +82,118 @@
                                </varlistentry>
                        </variablelist>
                </para>
-       </sect1>
+       </sect2>
 
-       <sect1 id="menu-view">
-               <title>The <guimenu>View</guimenu> Menu</title>
+       <sect2 id="menu-device">
+               <title>The Device Menu</title>
                <para>
                        <variablelist>
-                               <varlistentry id="menu-view-devices">
+                               <varlistentry 
id="menu-device-selectcurrentdevice">
                                        <term>
                                                <menuchoice>
-                                                       <guimenu>View</guimenu>
-                                                       
<guimenuitem>Devices</guimenuitem>
+                                                       
<guimenu>Device</guimenu>
+                                                       <guimenuitem>Select 
Current Device</guimenuitem>
                                                </menuchoice>
                                        </term>
                                        <listitem>
-                                               <para>
-                                                       <action>Toggles the 
Devices panel</action>: This command turns the display of the devices list on 
and off.
+                                               <para>Allows you to select a 
device from a submenu with all available devices of the system.
                                                </para>
                                        </listitem>
                                </varlistentry>
-                               <varlistentry id="menu-view-operations">
+                               <varlistentry 
id="menu-device-createpartitiontable">
                                        <term>
                                                <menuchoice>
-                                                       <guimenu>View</guimenu>
-                                                       <guimenuitem>Pending 
Operations</guimenuitem>
+                                                       <shortcut><keycombo 
action="simul">&Ctrl;&Shift;<keycap>N</keycap></keycombo></shortcut>
+                                                       
<guimenu>Device</guimenu>
+                                                       <guimenuitem>New 
Partition Table</guimenuitem>
                                                </menuchoice>
                                        </term>
                                        <listitem>
                                                <para>
-                                                       <action>Toggles the 
Pending Operations panel</action>: This command turns the display of the 
operation list on and off.
+                                                       <action>Creates a new 
partition table</action>: This command creates a new and empty GPT or MSDOS 
partition table on the currently selected device. This will delete all 
partitions on the device and all data on them, so you will want to be careful 
with this command.
+                                               </para>
+                                               <para>
+                                                       This command is only 
enabled if a device is selected and no partition on this device
+                                                       is currently mounted.
                                                </para>
                                        </listitem>
                                </varlistentry>
-                               <varlistentry id="menu-view-information">
+                               <varlistentry 
id="menu-device-exportpartitiontable">
                                        <term>
                                                <menuchoice>
-                                                       <guimenu>View</guimenu>
-                                                       
<guimenuitem>Information</guimenuitem>
+                                                       
<guimenu>Device</guimenu>
+                                                       <guimenuitem>Export 
Partition Table</guimenuitem>
                                                </menuchoice>
                                        </term>
                                        <listitem>
-                                               <para>
-                                                       <action>Toggles the 
Information panel</action>: This command turns the display of the information 
panel on and off. The information panel will either display details about the 
currently selected device or, if one is selected, the selected partition.
+                                               <para>Allows you to export a 
list of all partitions on the selected device into a file.
                                                </para>
                                        </listitem>
                                </varlistentry>
-                               <varlistentry id="menu-view-log">
+                               <varlistentry 
id="menu-device-importpartitiontable">
                                        <term>
                                                <menuchoice>
-                                                       <guimenu>View</guimenu>
-                                                       <guimenuitem>Log 
Output</guimenuitem>
+                                                       
<guimenu>Device</guimenu>
+                                                       <guimenuitem>Import 
Partition Table</guimenuitem>
                                                </menuchoice>
                                        </term>
                                        <listitem>
-                                               <para>
-                                                       <action>Toggles the Log 
Output panel</action>: This command turns the display of the log output panel 
on and off.
-                                               </para>
+                                               <para>Allows you to import 
partition table from a previously exported file.</para>
+                                               <para>This will delete all 
partitions on the device and all data on them,
+                                               so you will want to be careful 
with this command.</para>
+                                               <para>This command is only 
enabled if a device is selected and no partition on this device is
+                                               currently mounted. Importing 
into logical devices such as LVM Volume Groups is currently not 
supported.</para>
+                                       </listitem>
+                               </varlistentry>
+                               <varlistentry id="menu-device-smartstatus">
+                                       <term>
+                                               <menuchoice>
+                                                       
<guimenu>Device</guimenu>
+                                                       <guimenuitem>SMART 
Status</guimenuitem>
+                                               </menuchoice>
+                                       </term>
+                                       <listitem>
+                                               <para>Shows a SMART report. 
SMART is a monitoring system included in hard disk and solid-state drives
+                                               that detects and reports on 
various indicators of drive reliability, with the intent of enabling the
+                                               anticipation of hardware 
failures.</para>
                                        </listitem>
                                </varlistentry>
-                               <varlistentry id="menu-view-filesystemsupport">
+                               <varlistentry id="menu-device-properties">
                                        <term>
                                                <menuchoice>
-                                                       <guimenu>View</guimenu>
+                                                       
<guimenu>Device</guimenu>
+                                                       
<guimenuitem>Properties</guimenuitem>
+                                               </menuchoice>
+                                       </term>
+                                       <listitem>
+                                               <para>Shows information about 
currently selected devices. In this dialog you can find capacity, sector sizes,
+                                               partition table type as well as 
used and maximum number of primary partitions.</para>
+                                       </listitem>
+                               </varlistentry>
+                       </variablelist>
+               </para>
+       </sect2>
+
+       <sect2 id="menu-tools">
+               <title>The Tools Menu</title>
+               <para>
+                       <variablelist>
+                               <varlistentry id="menu-tools-volumegroup">
+                                       <term>
+                                               <menuchoice>
+                                                       <shortcut><keycombo 
action="simul">&Ctrl;&Shift;<keycap>L</keycap></keycombo></shortcut>
+                                                       <guimenu>Tools</guimenu>
+                                                       <guimenuitem>New Volume 
Group</guimenuitem>
+                                               </menuchoice>
+                                       </term>
+                                       <listitem>
+                                               <para>Create a new logical 
device such as <link linkend="glossary-lvm">LVM</link> Volume Group.</para>
+                                       </listitem>
+                               </varlistentry>
+                               <varlistentry id="menu-tools-filesystemsupport">
+                                       <term>
+                                               <menuchoice>
+                                                       <guimenu>Tools</guimenu>
                                                        <guimenuitem>File 
System Support</guimenuitem>
                                                </menuchoice>
                                        </term>
@@ -169,16 +218,13 @@
                                                <para>
                                                        If you have installed 
new tools while &partman; is running click on <guibutton>Rescan 
Support</guibutton> to force a recheck of installed  file system support tools.
                                                </para>
-                                               <para>
-                                                       Also see <xref 
linkend="requirements"/> for which external tool is required for which 
operation.
-                                               </para>
                                        </listitem>
                                </varlistentry>
-                               <varlistentry id="menu-view-refresh">
+                               <varlistentry id="menu-tools-refresh">
                                        <term>
                                                <menuchoice>
                                                        
<shortcut><keycap>F5</keycap></shortcut>
-                                                       <guimenu>View</guimenu>
+                                                       <guimenu>Tools</guimenu>
                                                        <guimenuitem>Refresh 
Devices</guimenuitem>
                                                </menuchoice>
                                        </term>
@@ -190,36 +236,10 @@
                                </varlistentry>
                        </variablelist>
                </para>
-       </sect1>
+       </sect2>
 
-       <sect1 id="menu-device">
-               <title>The <guimenu>Device</guimenu> Menu</title>
-               <para>
-                       <variablelist>
-                               <varlistentry 
id="menu-device-createpartitiontable">
-                                       <term>
-                                               <menuchoice>
-                                                       <shortcut><keycombo 
action="simul">&Ctrl;&Shift;<keycap>N</keycap></keycombo></shortcut>
-                                                       
<guimenu>Device</guimenu>
-                                                       <guimenuitem>Create New 
Partition Table</guimenuitem>
-                                               </menuchoice>
-                                       </term>
-                                       <listitem>
-                                               <para>
-                                                       <action>Creates a new 
partition table</action>: This command creates a new and empty MSDOS partition 
table on the currently selected device. This will delete all partitions on the 
device and all data on them, so you will want to be careful with this command.
-                                               </para>
-                                               <para>
-                                                       This command is only 
enabled if a device is selected and no partition on this device
-                                                       is currently mounted.
-                                               </para>
-                                       </listitem>
-                               </varlistentry>
-                       </variablelist>
-               </para>
-       </sect1>
-
-       <sect1 id="menu-partition">
-               <title>The <guimenu>Partition</guimenu> Menu</title>
+       <sect2 id="menu-partition">
+               <title>The Partition Menu</title>
 
                <para>
                        <variablelist>
@@ -253,7 +273,7 @@
                                        </term>
                                        <listitem>
                                                <para>
-                                                       <action>Resizes or 
moves a partition</action>: Opens the dialog to resize or move an existing 
partition. Depending on the partition's file system and the external tools 
installed on your computer, not all three possible resize-related actions -- 
that is, moving the partition, making it smaller (<quote>shrinking</quote> it) 
or making it larger (<quote>growing</quote> it) -- may be available in this 
dialog. See <xref linkend="menu-view-filesystemsupport"/>.
+                                                       <action>Resizes or 
moves a partition</action>: Opens the dialog to resize or move an existing 
partition. Depending on the partition's file system and the external tools 
installed on your computer, not all three possible resize-related actions -- 
that is, moving the partition, making it smaller (<quote>shrinking</quote> it) 
or making it larger (<quote>growing</quote> it) -- may be available in this 
dialog. See <xref linkend="menu-tools-filesystemsupport"/>.
                                                </para>
                                                <para>
                                                        This command is only 
enabled if a partition is selected that is not currently mounted and whose file 
system can be shrunk, grown or moved. For an extended partition, it is only 
enabled if none of the logicals in the extended partition are mounted.
@@ -263,7 +283,7 @@
                                <varlistentry id="menu-partition-delete">
                                        <term>
                                                <menuchoice>
-                                                       
<shortcut><keycap>Del</keycap></shortcut>
+                                                       
<shortcut>&Del;</shortcut>
                                                        
<guimenu>Partition</guimenu>
                                                        
<guimenuitem>Delete</guimenuitem>
                                                </menuchoice>
@@ -281,6 +301,27 @@
                                                </warning>
                                        </listitem>
                                </varlistentry>
+                               <varlistentry id="menu-partition-shred">
+                                       <term>
+                                               <menuchoice>
+                                                       <shortcut><keycombo 
action="simul">&Ctrl;&Del;</keycombo></shortcut>
+                                                       
<guimenu>Partition</guimenu>
+                                                       
<guimenuitem>Shred</guimenuitem>
+                                               </menuchoice>
+                                       </term>
+                                       <listitem>
+                                               <para>
+                                                       <action>Shreds a 
partition</action>: This command shreds the currently selected partition.
+                                               </para>
+                                               <para>
+                                                       This command is only 
enabled if a partition is selected that is not currently mounted. For an 
extended partition, it is only enabled if it does not contain any logical 
partitions.
+                                               </para>
+                                               <warning>
+                                                       <title>Warning: Loss of 
data</title>
+                                                       <para>Shreding a 
partition means that all data on the partition is destroyed.</para>
+                                               </warning>
+                                       </listitem>
+                               </varlistentry>
                                <varlistentry id="menu-partition-copy">
                                        <term>
                                                <menuchoice>
@@ -338,6 +379,22 @@
                                                </para>
                                        </listitem>
                                </varlistentry>
+                               <varlistentry id="menu-partition-edit-mount">
+                                       <term>
+                                               <menuchoice>
+                                                       
<guimenu>Partition</guimenu>
+                                                       <guimenuitem>Edit Mount 
Point</guimenuitem>
+                                               </menuchoice>
+                                       </term>
+                                       <listitem>
+                                               <para>
+                                                       <action>Opens a 
dialog</action> to edit the mount point and the mount options.
+                                               </para>
+                                               <para>
+                                                       This command is only 
enabled if a partition unmounted.
+                                               </para>
+                                       </listitem>
+                               </varlistentry>
                                <varlistentry id="menu-partition-check">
                                        <term>
                                                <menuchoice>
@@ -447,18 +504,20 @@
                                </varlistentry>
                        </variablelist>
                </para>
-       </sect1>
+       </sect2>
 
-       <sect1 id="menu-settings">
-               <title>The <guimenu>Settings</guimenu> Menu</title>
+       <sect2 id="menu-settings-help">
+               <title>The Settings and Help Menu</title>
 
                <para>
-                       This is the common <guimenu>Settings</guimenu> menu 
present in most &kde; applications. Please see the &kde; documentation for 
details on this menu.
+               &partman; has the common &kde; <ulink 
url="help:/fundamentals/ui.html#menus-settings">Settings</ulink> and
+               <ulink url="help:/fundamentals/ui.html#menus-help">Help</ulink> 
menu described in
+               the &kde; Fundamentals with an additional submenu 
<guisubmenu>Panels Shown</guisubmenu>,
+               where you can toggle the display of the 
<guimenuitem>Devices</guimenuitem>,
+                <guimenuitem>Pending Operations</guimenuitem>, 
<guimenuitem>Information</guimenuitem>
+                and panels <guimenuitem>Log Output</guimenuitem> on and off.
                </para>
+       </sect2>
        </sect1>
 
-       <sect1 id="menu-help">
-               <title>The <guimenu>Help</guimenu> Menu</title>
-               &help.menu.documentation;
-       </sect1>
 </chapter>
diff --git a/doc/usermanual.docbook b/doc/usermanual.docbook
index ba93988..39b69e4 100644
--- a/doc/usermanual.docbook
+++ b/doc/usermanual.docbook
@@ -7,7 +7,7 @@
                <para>
                        Besides the main view showing the currently selected 
device in a graphical and a tree view, &partman; uses &Qt;'s <quote>dock 
widgets</quote> or panels to display some information and allow selections. See 
the following screen shot for an overview of &partman;'s main window.
                </para>
-               
+
                <para>
                        <screenshot>
                                <screeninfo>&partman;'s main window</screeninfo>
@@ -25,10 +25,10 @@
                                </listitem>
                        
                                <listitem>
-                                       <para>Toolbar: &partman;'s tool bar is 
a &kde; 4 standard tool bar. It can be fully customized; for details see <xref 
linkend="menu-settings"/>.
+                                       <para>Toolbar: &partman;'s tool bar is 
a standard tool bar. It can be fully customized; for details see <xref 
linkend="menu-settings-help"/>.
                                        </para>
                                </listitem>
-                       
+
                                <listitem>
                                        <para>Devices Panel: This panel lists 
all <glossterm linkend="glossary-device">devices</glossterm> found on your 
computer that &partman; can handle. Select a device in this panel to view or 
modify it in the graphical device view or in the tree device view.</para>
                                </listitem>
@@ -44,7 +44,7 @@
                                                You can select a partition by 
clicking on it in the graphical device view. A double click opens <link 
linkend="menu-partition-properties">the partition's properties dialog</link>. A 
right click shows the partition context menu.
                                        </para>
                                </listitem>
-                               
+
                                <listitem>
                                        <para>
                                                Tree Device View: The tree 
device view shows extended information about each partition on the selected 
device. The currently selected partition is highlighted. Double-clicking a 
partition opens <link linkend="menu-partition-properties">the partition's 
properties dialog</link>. A right click shows the partition context menu.

Reply via email to