[kde-doc-english] [kdepim] doc/kmail: REVIEW: 111039
Yuri Chornoivan
yurchor at ukr.net
Sun Jun 16 14:22:28 UTC 2013
Git commit 545b261c06bc6c0d5c0089eba26a711c9bda54b5 by Yuri Chornoivan, on behalf of Scarlett Clark.
Committed on 16/06/2013 at 16:22.
Pushed by yurchor into branch 'master'.
REVIEW: 111039
Added composer print features, EBN error fixes, added missing tags.
M +46 -45 doc/kmail/using-kmail.docbook
http://commits.kde.org/kdepim/545b261c06bc6c0d5c0089eba26a711c9bda54b5
diff --git a/doc/kmail/using-kmail.docbook b/doc/kmail/using-kmail.docbook
index 5f8a8b7..e656ace 100644
--- a/doc/kmail/using-kmail.docbook
+++ b/doc/kmail/using-kmail.docbook
@@ -6,7 +6,7 @@
<firstname>Daniel</firstname>
<surname>Naber</surname>
<affiliation><address>
-<email>daniel.naber at t-online.de</email>
++&Daniel.Naber.mail;
</address></affiliation>
</author>
<author>
@@ -18,8 +18,8 @@
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
-<date>2011-07-16</date>
-<releaseinfo>2.1.96 (&kde; 4.7)</releaseinfo>
+<date>2013-06-14</date>
+<releaseinfo>4.10.60 (&kde; 4.11)</releaseinfo>
</chapterinfo>
<title>Using &kmail;</title>
@@ -236,12 +236,10 @@ You may need to specify fully qualified addresses
(&ie; <userinput>user at example.com</userinput>) even for local
users, depending on your system configuration.</para>
-<para>When you are finished with your
-message, click the <guiicon>Send</guiicon> icon (the envelope) to send
-the message now, or click the <guiicon>Queue</guiicon> icon to put
-the message in the outbox. If your message is not finished yet, select
-<menuchoice><guimenu>Message</guimenu><guimenuitem>Save as Draft</guimenuitem></menuchoice>.
-</para></sect2>
+<para>When you are finished with your message, you click the <guiicon>Send</guiicon> icon (the envelope) to send the message now, or click the <guiicon>Queue</guiicon> icon to put the message in the outbox.
+If your message is not finished yet, select <menuchoice><guimenu>Message</guimenu><guimenuitem>Save as Draft</guimenuitem></menuchoice> to save for later editing.
+ If you would like to print your message, select <menuchoice><guimenu>Message</guimenu><guimenuitem>Print Preview</guimenuitem></menuchoice> to preview the message, and
+ <menuchoice><guimenu>Message</guimenu><guimenuitem>Print</guimenuitem></menuchoice> to print it.</para></sect2>
<sect2 id="encrypt-sign">
<title>Signing and Encrypting Messages</title>
@@ -261,20 +259,20 @@ installed encryption programs you can choose between:
<listitem>
<para>&kmail; will use a format which is understood by all recipients of the
message. The preferred format of the recipients can be specified in the
-KDE Address Book.</para></listitem>
+&kde; Address Book.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Inline OpenPGP (deprecated)</guilabel></term>
<listitem>
<para>This format is outdated. If you use this format then only the
message text will be signed and/or encrypted. <emphasis>Attachments will
-neither be signed nor encrypted.</emphasis> HTML messages cannot be signed
+neither be signed nor encrypted.</emphasis> &HTML; messages cannot be signed
with this format. You should only use this format
if necessary, &ie; if you send messages to users of email clients that cannot
handle the more advanced formats.</para></listitem>
</varlistentry>
<varlistentry>
-<term><guilabel>OpenPGP/MIME</guilabel></term>
+<term><guilabel>OpenPGP/&MIME;</guilabel></term>
<listitem>
<para>This format is the successor of the inline OpenPGP format. If you
use this format then the message text and all attachments will be signed
@@ -282,17 +280,17 @@ and/or encrypted (at least by default). This is the recommended format if you
use OpenPGP.</para></listitem>
</varlistentry>
<varlistentry>
-<term><guilabel>S/MIME</guilabel></term>
+<term><guilabel>S/&MIME;</guilabel></term>
<listitem>
-<para>This format is an alternative format to OpenPGP/MIME. If you
+<para>This format is an alternative format to OpenPGP/&MIME;. If you
use this format then the message text and all attachments will be signed
and/or encrypted (at least by default). This format is mostly used by
corporations.</para></listitem>
</varlistentry>
<varlistentry>
-<term><guilabel>S/MIME opaque</guilabel></term>
+<term><guilabel>S/&MIME; opaque</guilabel></term>
<listitem>
-<para>This format is a variant of the S/MIME format. It should only be
+<para>This format is a variant of the S/&MIME; format. It should only be
used if necessary.</para></listitem>
</varlistentry>
</variablelist>
@@ -300,15 +298,15 @@ used if necessary.</para></listitem>
</sect2>
<sect2 id="html-mails">
-<title>Creating HTML Messages</title>
+<title>Creating &HTML; Messages</title>
-<para>Note that HTML messages are often regarded as an annoyance; therefore,
-you should avoid sending HTML messages if possible. Particularly, you should never
-send HTML messages to a mailing list unless HTML messages are explicitly
+<para>Note that &HTML; messages are often regarded as an annoyance; therefore,
+you should avoid sending &HTML; messages if possible. Particularly, you should never
+send &HTML; messages to a mailing list unless &HTML; messages are explicitly
allowed.</para>
-<para>In order to be able to create HTML messages you first have to enable
-the markup tools. To do this enable <guimenuitem>Formatting (HTML)</guimenuitem> in the <menuchoice><guimenu>Options</guimenu></menuchoice> menu.
+<para>In order to be able to create &HTML; messages you first have to enable
+the markup tools. To do this enable <guimenuitem>Formatting (&HTML;)</guimenuitem> in the <menuchoice><guimenu>Options</guimenu></menuchoice> menu.
A toolbar with several tools to
format the message will appear. Via the drop down box you can select between
standard text and six different types of lists (three bulleted lists with
@@ -344,6 +342,9 @@ window -- that message will then be attached;</para>
<para>Select one of the options in the
<menuchoice><guimenu>Attach</guimenu></menuchoice> menu.</para>
</listitem>
+<listitem>
+ <para> Select <menuchoice><guimenu>Message</guimenu><guimenuitem>Insert Recent text file</guimenuitem></menuchoice>.</para>
+</listitem>
</itemizedlist>
<para>Once a file is attached to your message, it appears in the attachments
@@ -373,7 +374,7 @@ key attachments are handled like file attachments.</para>
<title>Checking the Spelling of your Message</title>
<para>&kmail; will automatically check the spelling of your message (in
-HTML mode this currently does not work)
+&HTML; mode this currently does not work)
and display unknown words using red color. If there are too many
unknown words &kmail; will disable its checking. To select the language
used for checking, select <menuchoice><guimenu>View</guimenu>
@@ -407,7 +408,7 @@ Snippets can be grouped together as well by creating groups and adding snippets
<para>The <guilabel>Snippets</guilabel> tool allows for a variable text in predefined places any time you insert a snippet into a file. To accomplish this <guilabel>Snippets</guilabel> provides its own variables mechanism. You can insert variables in the snippet text itself by using separators ( $ ) that enclose the variable names. For example: $variablename$, $invoicenumber$, $weekno$.
</para>
<para>
-The variable separator can be changed to another character by changing "snippetDelimiter" in the [SnippetPart] section in the Text Snippet configuration file, which can be found at $KDEHOME/share/config/kmailsnippetrc .
+ The variable separator can be changed to another character by changing <varname>snippetDelimiter</varname> in the [SnippetPart] section in the Text Snippet configuration file, which can be found at $KDEHOME/share/config/kmailsnippetrc .
<programlisting>
snippetDelimiter=$
</programlisting>
@@ -421,8 +422,8 @@ snippetDelimiter=$
<menuchoice><guimenu>View</guimenu><guimenuitem>Translator</guimenuitem></menuchoice> from the
menubar. A new panel will appear at the bottom of the composer.</para>
<para> To translate a section of text, first select the text you would like translated to the
- box with the <quote>Drag text...</quote>. Select the language it currently is, in the <guilabel>From:</guilabel> drop down box.
- Select the language you would like to translate to in the <guilabel>To:</guilabel> drop down box, and click the <guibutton>Translate</guibutton> button.
+ box with the <guilabel>Drag text...</guilabel>. Select the language it currently is, in the <guilabel>From:</guilabel> dropdown box.
+ Select the language you would like to translate to in the <guilabel>To:</guilabel> dropdown box, and click the <guibutton>Translate</guibutton> button.
Your translated text will appear in the next box. If you need to translate
in the other direction you can just click the <guibutton>Invert</guibutton> button.
To clear all text, click the <guibutton>Clear</guibutton> button. </para>
@@ -632,7 +633,7 @@ You can choose between:</para>
<para>
This address is used for subscribing to the mailing
list. This can be an email address or the address of a
- webpage.
+ web page.
</para>
</listitem>
</varlistentry>
@@ -644,7 +645,7 @@ You can choose between:</para>
<para>
This address is used for unsubscribing from the
mailing list. This can be an email address or the
- address of a webpage.
+ address of a web page.
</para>
</listitem>
</varlistentry>
@@ -655,7 +656,7 @@ You can choose between:</para>
<listitem>
<para>
This is the address of the archive of the mailing
- list. This is usually the address of a webpage.
+ list. This is usually the address of a web page.
</para>
</listitem>
</varlistentry>
@@ -673,7 +674,7 @@ You can choose between:</para>
</variablelist>
<para>After selecting the appropriate <guilabel>Address type</guilabel> you
-enter the email address or the address of the webpage and then click on
+enter the email address or the address of the web page and then click on
<guilabel>Add</guilabel>. With <guilabel>Remove</guilabel> you can remove
addresses.</para>
@@ -681,11 +682,11 @@ addresses.</para>
go to the list archives, by selecting the appropriate
<guilabel>Address type</guilabel> and then clicking on
<guilabel>Invoke Handler</guilabel>. If there is an email address and an
-address of a webpage for the desired action then you will have to select
+address of a web page for the desired action then you will have to select
the <guilabel>Preferred handler</guilabel> prior to clicking on
-<guilabel>Invoke Handler</guilabel>. Select <guilabel>KMail;</guilabel> if you
+<guilabel>Invoke Handler</guilabel>. Select <guilabel>KMail</guilabel> if you
want to send a message to the email address and select
-<guilabel>Browser</guilabel> if you want to go to the webpage.</para>
+<guilabel>Browser</guilabel> if you want to go to the web page.</para>
<para>Alternatively to invoking the handler for
<guilabel>Post to List</guilabel> you can send a new message to the
@@ -1384,7 +1385,7 @@ receipt) to the sender of the message.</para>
<varlistentry>
<term><guilabel>Set Transport To</guilabel></term>
<listitem>
-<para>This will set the method of transport (⪚ <acronym>SMTP</acronym>)
+<para>This will set the method of transport (⪚ <acronym>&SMTP;</acronym>)
that will be used if you reply to the message.</para>
</listitem>
</varlistentry>
@@ -1535,16 +1536,16 @@ list.</para>
in Headers</guilabel> and <guilabel>contains</guilabel> from the drop down boxes and type
<userinput>Priority</userinput> in the text field. Select the same criteria
in the next line and type <userinput>urgent</userinput> in the
-text field of the second drop-down box.</para>
+text field of the second drop down box.</para>
<para>So your filter will match all messages containing a
<quote>Priority: urgent</quote> header field.</para>
</step>
<step>
<para>Skip down to the <guilabel>Filter Actions</guilabel> area.
-Select <guilabel>Mark As</guilabel> from the first drop-down box.
-A new drop-down box containing a list of marker flags is shown
+Select <guilabel>Mark As</guilabel> from the first drop down box.
+A new drop down box containing a list of marker flags is shown
to the right. Select <guilabel>Important</guilabel> from the
-drop-down box.</para>
+drop down box.</para>
</step>
<step>
<para>Since you want this filter to <emphasis>not</emphasis>
@@ -1605,7 +1606,7 @@ field.</para>
</step>
<step>
<para>Skip down to the <guilabel>Filter Actions</guilabel> section. Select <guilabel>Move Into
-Folder</guilabel> from the first drop-down box. Click on the folder icon and a window
+Folder</guilabel> from the first drop down box. Click on the folder icon and a window
containing a list of folders will appear. Select the folder that you
want the filtered messages to be transferred to. For this example, you would select
<guilabel>KDE-General</guilabel>.</para>
@@ -1760,7 +1761,7 @@ about how to sign/encrypt messages, but the details, especially those of
the configuration, will differ.</para></note>
-->
<para>This is a short introduction on how to setup &kmail;'s
-<application>GnuPG</application> (<application>GNU Privacy Guard</application>) support;
+<application>GnuPG</application> (<application>&GNU; Privacy Guard</application>) support;
it gives some hints on the use of
<application>GnuPG</application> too. It is written for people who are beginners in
this area; if you are familiar with the use of <application>GnuPG</application>, you can
@@ -1789,7 +1790,7 @@ necessary to have <application>GnuPG</application> installed and set up
properly; of course, we cannot give you a full introduction of
<application>GnuPG</application> here. We will only mention the steps you have to
do to get <application>GnuPG</application> going. For details you should have a look at
-the <ulink url="http://www.gnupg.org/docs.html#guides">The GNU Privacy Handbook</ulink>.</para>
+the <ulink url="http://www.gnupg.org/docs.html#guides">The &GNU; Privacy Handbook</ulink>.</para>
<para>It is certainly a good idea to study this documentation as well as an
introduction into public key cryptography: there you can learn a lot about
@@ -1900,7 +1901,7 @@ preferences.</para>
<varlistentry>
<term><guilabel>Automatically encrypt messages whenever possible</guilabel></term>
<listitem><para>If this option is on, &kmail; will automatically encrypt messages
-with the built-in OpenPGP support or the PGP/MIME-Plugin provided that,
+with the built-in OpenPGP support or the PGP/&MIME;-Plugin provided that,
for every recipient, a trusted PGP key is found in your keyring and
you did not tell &kmail; not to encrypt messages sent to
certain recipients. If in doubt, &kmail; will ask whether the message
@@ -2137,7 +2138,7 @@ to be used by &kmail; to detect spam. Of course, you
can close the wizard, install a new tool, and restart the wizard again.
</para>
-<para>If you have marked at least one tool, KMail is able to provide filters
+<para>If you have marked at least one tool, &kmail; is able to provide filters
which allow the classification of the messages as spam or not spam. It will
also provide actions to let you manually classify messages. These actions will
be available via the menu and toolbar icons.
@@ -2173,7 +2174,7 @@ selected the appropriate option.
<title>Some More Details for Experts</title>
<para>The wizard uses information stored in a special configuration file named
-<filename>kmail.antispamrc</filename> (stored in the global or local KDE
+<filename>kmail.antispamrc</filename> (stored in the global or local &kde;
config directory). It will first check the global config file and then the local
config file: if the local config file contains entries with higher (newer)
version numbers per-tool the configuration data from the local file for that
@@ -2277,7 +2278,7 @@ may want to inspect the result of this process in the
<title>Details</title>
<para>The wizard uses information stored in a special configuration file named
-<filename>kmail.antivirusrc</filename> (stored in the global or local KDE
+<filename>kmail.antivirusrc</filename> (stored in the global or local &kde;
config directory). It will first check the global config file and then the local
config file: if the local config file contains entries with higher (newer)
version numbers per-tool the configuration data from the local file for that
More information about the kde-doc-english
mailing list