[kde-doc-english] [kdepim] doc/kmail: REVIEW:111377
Scarlett Clark
scarlett at scarlettgatelyclark.com
Wed Jul 3 13:22:38 UTC 2013
Git commit 0653a596718625b97d8ae71f32ed0c816fd2ef03 by Scarlett Clark.
Committed on 03/07/2013 at 13:21.
Pushed by scarlettclark into branch 'master'.
REVIEW:111377
M +173 -178 doc/kmail/menus.docbook
http://commits.kde.org/kdepim/0653a596718625b97d8ae71f32ed0c816fd2ef03
diff --git a/doc/kmail/menus.docbook b/doc/kmail/menus.docbook
index 3a3c151..088ae43 100644
--- a/doc/kmail/menus.docbook
+++ b/doc/kmail/menus.docbook
@@ -245,185 +245,180 @@ performs a menu item function, the default shortcut is listed with the menu item
<sect2 id="reader-view-menu">
-<title><guimenu>View</guimenu> Menu</title>
+<title>View Menu</title>
<variablelist>
-<!--
-<varlistentry>
-<term>
-<menuchoice>
-<guimenu>View</guimenu>
-<guimenuitem>Message List</guimenuitem>
-</menuchoice>
-</term>
-<listitem>
-<para></para>
-</listitem>
-</varlistentry>
--->
-<varlistentry>
-<term>
-<menuchoice>
-<guimenu>View</guimenu>
-<guimenuitem>Headers</guimenuitem>
-</menuchoice>
-</term>
-<listitem>
-<para>Changes the format of the message header in the <guilabel>Message pane</guilabel>.</para>
-</listitem>
-</varlistentry>
-
-<varlistentry>
-<term>
-<menuchoice>
-<guimenu>View</guimenu>
-<guimenuitem>Attachments</guimenuitem>
-</menuchoice>
-</term>
-<listitem>
-<para>Changes the way attachments appear in the <guilabel>Message
-pane</guilabel> (independent of the &MIME; Tree). With <guimenuitem>As Icons</guimenuitem>
-all attachments appear as icons at the bottom of the message.
-<guimenuitem>Smart</guimenuitem> will show attachments as
-icons, unless the message suggests that they should be displayed inline.
-You can suggest that certain attachments should be shown inline
-in your own messages when you select <guilabel>Suggest automatic display</guilabel>
-in the attachment's properties dialog.
-<guimenuitem>Inline</guimenuitem> shows the contents of the attachments
-at the bottom of the message. Attachments that cannot be displayed, ⪚
-compressed files, will still be shown as an icon.
-<guimenuitem>Hide</guimenuitem> will not show attachments.
-</para>
-</listitem>
-</varlistentry>
-
-<varlistentry>
-<term>
-<menuchoice>
-<shortcut><keycap>.</keycap></shortcut>
-<guimenu>View</guimenu>
-<guimenuitem>Expand Thread</guimenuitem>
-</menuchoice>
-</term>
-<listitem>
-<para>This will display the thread of the current message, &ie;
-all messages that are replies to the current message.</para>
-</listitem>
-</varlistentry>
-
-<varlistentry>
-<term>
-<menuchoice>
-<shortcut><keycap>,</keycap></shortcut>
-<guimenu>View</guimenu>
-<guimenuitem>Collapse Thread</guimenuitem>
-</menuchoice>
-</term>
-<listitem>
-<para>This will hide the thread of the current message, &ie;
-it will hide all messages that are replies to the current message.</para>
-</listitem>
-</varlistentry>
-
-<varlistentry>
-<term>
-<menuchoice>
-<shortcut><keycombo action="simul">&Ctrl;<keycap>.</keycap></keycombo></shortcut>
-<guimenu>View</guimenu>
-<guimenuitem>Expand All Threads</guimenuitem>
-</menuchoice>
-</term>
-<listitem>
-<para>Expands all threads in the current folder.</para>
-</listitem>
-</varlistentry>
-
-<varlistentry>
-<term>
-<menuchoice>
-<shortcut><keycombo action="simul">&Ctrl;<keycap>,</keycap></keycombo></shortcut>
-<guimenu>View</guimenu>
-<guimenuitem>Collapse All Threads</guimenuitem>
-</menuchoice>
-</term>
-<listitem>
-<para>Collapses all threads in the current folder.</para>
-</listitem>
-</varlistentry>
-
-<varlistentry>
-<term>
-<menuchoice>
-<shortcut><keycap>V</keycap></shortcut>
-<guimenu>View</guimenu>
-<guimenuitem>View Source</guimenuitem>
-</menuchoice>
-</term>
-<listitem>
-<para>Shows the message and its complete headers in plain text format in a new
-window. This can be useful to find out the origin of a mail. You should know
-that it is easy to fake the <literal>From:</literal> header of a mail, but
-one can still find out which mail servers have been used to send the message by looking
-at the <literal>Received:</literal> lines in the header.</para>
-</listitem>
-</varlistentry>
-
-<varlistentry>
-<term>
-<menuchoice>
-<guimenu>View</guimenu>
-<guimenuitem>Show Message Structure</guimenuitem>
-</menuchoice>
-</term>
-<listitem>
-<para> Display the structure viewer, which is a part of the main window that
-lets you access all parts of a message.</para>
-</listitem>
-</varlistentry>
-
-<varlistentry>
-<term>
-<menuchoice>
-<shortcut><keycap>X</keycap></shortcut>
-<guimenu>View</guimenu>
-<guimenuitem>Use Fixed Font</guimenuitem>
-</menuchoice>
-</term>
-<listitem>
-<para>Uses a fixed width (monospaced) font to display the messages
-in the current folder. The font to be used can be configured in the
-<guilabel>Appearance</guilabel> section of &kmail;'s configuration
-dialog.</para>
-</listitem>
-</varlistentry>
-
-<varlistentry>
-<term>
-<menuchoice>
-<guimenu>View</guimenu>
-<guisubmenu>Set Encoding</guisubmenu>
-</menuchoice>
-</term>
-<listitem>
-<para>Lets you choose the character encoding to be used in the Message
-Pane. The default, <guilabel>Auto</guilabel>, should work in almost all cases.</para>
-</listitem>
-</varlistentry>
-
-
-<varlistentry>
-<term>
-<menuchoice>
-<guimenu>View</guimenu>
-<guisubmenu>Zoom</guisubmenu>
-</menuchoice>
-</term>
-<listitem>
-<para>Allows to zoom message in the Message Pane.</para>
-</listitem>
-</varlistentry>
-
-
+ <varlistentry><term><menuchoice><guimenu>View</guimenu><guisubmenu>Message List</guisubmenu></menuchoice></term>
+ <listitem>
+ <para>This menu has the following options to change the view of your message list.</para>
+ <variablelist>
+ <varlistentry><term><menuchoice><guimenu>Message List</guimenu><guisubmenu>Sorting</guisubmenu></menuchoice></term>
+ <listitem>
+ <para>Contains options to customize your sort order as follows:</para>
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Message Sort Order</guilabel> has several options, most are self explanatory. The following options may not be immediately obvious,
+ therefore deserve an explanation.</para>
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Smart Sender/Receiver</guilabel> will display the sender when you are reading in your outbox folder/template folder, and display the receiver when you are
+ in your inbox/inbox subfolders.</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>By Action Item Status</guilabel> and <guilabel>By Important Status</guilabel> need to be set before
+ they can be sorted. Please see <link linkend="mark-messages">Mark Messages</link> for more information on marking your messages.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para><guilabel>Message Sort Direction</guilabel> and <guilabel>Group Sort Direction</guilabel> allow you to
+ change the direction of your message/group sort respectively.</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Folder always Uses this Sort Order</guilabel> allows you to keep your sort settings per folder.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term><menuchoice><guimenu>Message List</guimenu><guisubmenu>Aggregation</guisubmenu></menuchoice></term>
+ <listitem>
+ <para>Allows you to set your aggregation view.</para>
+ <para><guilabel>Configure...</guilabel> Allows you to configure aggregation, please see <ulink url="help:/kmail/configure-appearance.html#configure-appearance-message-list">Configure Appearance Message List</ulink> for more information on aggregation.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term><menuchoice><guimenu>Message List</guimenu><guisubmenu>Theme</guisubmenu></menuchoice></term>
+ <listitem>
+ <para>Allows you to select a theme.</para>
+ <para><guilabel>Configure...</guilabel> Allows you to configure themes, please see <ulink url="help:/kmail/configure-appearance.html#configure-appearance-message-list">Configure Appearance Message List</ulink> for more information on themes.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>T</keycap></keycombo></shortcut><guimenu>Message List</guimenu><guisubmenu>Create New Tab</guisubmenu></menuchoice></term>
+ <listitem>
+ <para>Allows you to create a tab, then select the folder you would like to display in the tab.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>W</keycap></keycombo></shortcut><guimenu>Message List</guimenu><guisubmenu>Close Tab</guisubmenu></menuchoice></term>
+ <listitem><para> closes the currently selected tab.</para></listitem>
+ </varlistentry>
+ </variablelist>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="view-headers"><term><menuchoice><guimenu>View</guimenu><guisubmenu>Headers</guisubmenu></menuchoice></term>
+ <listitem>
+ <para>This allows you to select your headers view. your choices are as follows:</para>
+ <itemizedlist>
+ <listitem><para><guilabel>Enterprise Headers</guilabel>
+ A minimal header with title, From, and To, with a graphical design.</para>
+ </listitem>
+ <listitem><para><guilabel>Fancy Headers</guilabel>
+ Minimal header with a spam status notification.</para>
+ </listitem>
+ <listitem><para><guilabel>Brief Headers</guilabel>
+ Title, and in parentheses you will find From and the date.</para>
+ </listitem>
+ <listitem><para><guilabel>Standard Headers</guilabel>
+ Title, From, and To.</para>
+ </listitem>
+ <listitem><para><guilabel>Long Headers</guilabel>
+ Title, Date, From, and To.</para>
+ </listitem>
+ <listitem><para><guilabel>All Headers</guilabel>
+ List everything you ever wanted to know about the email, including every server it went through, virus/spam scanners it went through &etc;</para>
+ </listitem>
+ <listitem><para><guilabel>Custom Headers</guilabel>
+ You must configure custom headers first here: <menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure &kmail;...</guisubmenu></menuchoice> and select the <guiicon>Appearance</guiicon> icon. From there
+ you want the <guilabel>Message Window</guilabel> tab, and you will find the settings at the bottom with the label <guilabel>Headers:</guilabel>. See
+ <link linkend="configure-appearance-message-window">Message Window configuration</link> for more information.</para>
+ </listitem>
+ <listitem><para><guilabel>Example</guilabel>
+ An example header from the <guilabel>Download New Themes</guilabel></para>
+ </listitem>
+ <listitem><para><guilabel>Example Fancy</guilabel>
+ An example fancy header from the <guilabel>Download New Themes</guilabel></para>
+ </listitem>
+ <listitem><para><guilabel>Download New Themes</guilabel>
+ Allows you to download custom themes created by other &kmail; users.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="view-attachments"><term><menuchoice><guimenu>View</guimenu><guimenuitem>Attachments</guimenuitem></menuchoice></term>
+ <listitem>
+ <para>Changes the way attachments appear in the <guilabel>Message Preview Pane</guilabel>
+ (independent of the &MIME; Tree) as follows:</para>
+ <itemizedlist>
+ <listitem><para><guimenuitem>As Icons</guimenuitem>, all attachments appear as icons at the bottom of the message.</para></listitem>
+ <listitem><para><guimenuitem>Smart</guimenuitem> will show attachments as icons, unless the message suggests that they should be displayed inline.
+ You can suggest that certain attachments should be shown inline in your own messages when you select <guilabel>Suggest automatic display</guilabel>
+ in the attachment's properties dialog.</para>
+ </listitem>
+ <listitem><para><guimenuitem>Inline</guimenuitem> shows the contents of the attachments
+ at the bottom of the message. Attachments that cannot be displayed, ⪚ compressed files, will still be shown as an icon.</para>
+ </listitem>
+ <listitem><para><guimenuitem>Hide</guimenuitem> will not show attachments.</para></listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term><menuchoice><shortcut><keycap>.</keycap></shortcut><guimenu>View</guimenu>
+ <guimenuitem>Expand Thread / Group</guimenuitem></menuchoice></term>
+ <listitem>
+ <para>This will display the thread of the current message, &ie;
+ all messages that are replies to the current message.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term><menuchoice><shortcut><keycap>,</keycap></shortcut><guimenu>View</guimenu><guimenuitem>Collapse Thread / Group</guimenuitem></menuchoice></term>
+ <listitem><para>This will hide the thread of the current message, &ie; it will hide all messages that are replies to the current message.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>.</keycap></keycombo></shortcut><guimenu>View</guimenu>
+ <guimenuitem>Expand All Threads</guimenuitem></menuchoice></term>
+ <listitem>
+ <para>Expands all threads in the current folder.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>,</keycap></keycombo></shortcut>
+ <guimenu>View</guimenu><guimenuitem>Collapse All Threads</guimenuitem></menuchoice></term>
+ <listitem>
+ <para>Collapses all threads in the current folder.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term><menuchoice><shortcut><keycap>V</keycap></shortcut><guimenu>View</guimenu>
+ <guimenuitem>View Source</guimenuitem></menuchoice></term>
+ <listitem>
+ <para>Shows the message and its complete headers in plain text format in a new
+ window. This can be useful to find out the origin of a mail. You should know
+ that it is easy to fake the <literal>From:</literal> header of a mail, but
+ one can still find out which mail servers have been used to send the message by looking
+ at the <literal>Received:</literal> lines in the header.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term><menuchoice><guimenu>View</guimenu>
+ <guimenuitem>Show Message Structure</guimenuitem></menuchoice></term>
+ <listitem>
+ <para> Display the structure viewer, which is a part of the main window that
+ lets you access all parts of a message.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term><menuchoice><shortcut><keycap>X</keycap></shortcut><guimenu>View</guimenu>
+ <guimenuitem>Use Fixed Font</guimenuitem></menuchoice></term>
+ <listitem>
+ <para>Uses a fixed width (Monospace) font to display the messages
+ in the current folder. The font to be used can be configured in the
+ <guilabel>Appearance</guilabel>/<guilabel>Fonts</guilabel> in the <menuchoice>
+ <guimenu>Settings</guimenu><guimenuitem>Configure &kmail;...</guimenuitem></menuchoice> dialog.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term><menuchoice><guimenu>View</guimenu><guisubmenu>Set Encoding</guisubmenu></menuchoice></term>
+ <listitem>
+ <para>Lets you choose the character encoding to be used in the Message Pane.
+ The default, <guilabel>Auto</guilabel>, should work in almost all cases.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry><term><menuchoice><guimenu>View</guimenu><guisubmenu>Zoom</guisubmenu></menuchoice></term>
+ <listitem>
+ <para>Allows to zoom message in the Message Pane.</para>
+ </listitem>
+ </varlistentry>
</variablelist>
</sect2>
@@ -962,7 +957,7 @@ precisely, for messages which have the <guilabel>sent</guilabel> status.</para>
</listitem>
</varlistentry>
-<varlistentry>
+<varlistentry id="mark-messages">
<term>
<menuchoice>
<guimenu>Message</guimenu>
More information about the kde-doc-english
mailing list