GNOME.org
 

[geary/mjog/docs-update: 4/4] Update archive, shortcuts and composer manual pages

commit f307722c1d2631120af18e1637e4a66615bec1ec
Author: Michael Gratton <mike vee net>
Date:   Mon Nov 18 18:33:10 2019 +1100

    Update archive, shortcuts and composer manual pages
    
    Update pages to be consistent with how the app currently works. Mention
    undo for both archiving and sending/saving/dicarding composers. Update
    compser page to mention features added over the last few releases.

 help/C/archive.page   |  52 ++++++++-----
 help/C/shortcuts.page |   3 +-
 help/C/write.page     | 202 +++++++++++++++++++++++++++++++++++++-------------
 3 files changed, 187 insertions(+), 70 deletions(-)
---
diff --git a/help/C/archive.page b/help/C/archive.page
index 4787e001..1d6a2fe6 100644
--- a/help/C/archive.page
+++ b/help/C/archive.page
@@ -1,25 +1,43 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="guide"
       id="archive">
+  <info>
+    <link type="guide" xref="index#overview"/>
+    <link type="next" xref="shortcuts"/>
+  </info>
+  <title>Archive, trash and delete messages</title>
 
-    <info>
-        <link type="guide" xref="index#overview"/>
-        
-        <link type="next" xref="shortcuts"/>
-    </info>
-       <title>Delete or archive a message</title>
+  <p>Geary lets you archive messages if your server supports
+  it. Clicking the <gui style="button">Archive</gui> toolbar button
+  moves the conversation from the current folder to the
+  <gui>Archive</gui> folder for most email services, or to <gui>All
+  Mail</gui> for GMail. Archiving helps keep your email organised by
+  moving old and replied-to email out of the way.</p>
 
-       <p>When you use Geary with a Gmail account, Geary lets you <em>archive</em> messages.
-       The <gui>Archive</gui> toolbar button archives the selected conversation(s).
-       Archived messages appear in the <gui>All Mail</gui> folder.</p>
+  <p>To move conversations to the <gui>Trash</gui> folder, select them
+  and click the <gui style="button">Trash</gui> toolbar button. To
+  permanently delete conversations, hold down <key>Shift</key> and
+  click the <gui style="button">Delete</gui> button that appears in
+  place of the <gui>Trash</gui> button, or open the conversation in
+  the <gui>Trash</gui> folder and click <gui
+  style="button">Delete</gui> there.</p>
 
-       <p>With other mail servers, you can trash or delete, but not archive, messages.  To move
-       one or more conversations to the <gui>Trash</gui> folder, select them and press the <gui>Trash</gui>
-       button on the toolbar.  To permanently delete the conversations, hold down <key>Shift</key> and press
-       the <gui>Delete</gui> button that appears in place of the <gui>Trash</gui> button.</p>
+  <note style="tip">
+    <title>Undoing changes</title>
+    <p>Note that you can always undo archiving or trashing a message
+    if you change your mind. Click <gui style="button">Undo</gui> on
+    the pop-up notification that appears, or type
+    <keyseq><key>Ctrl</key><key>Z</key></keyseq>, or open the folder,
+    find the message, then move it back to your <gui>Inbox</gui></p>
+  </note>
 
-       <p>Delete is not available from every folder, such as Search.  Delete is also unavailable for Gmail.
-       For Gmail, <gui>Trash</gui> will move messages to the Trash folder on the server, where the user can
-       then manually delete them.  The server will automatically remove trashed messages after 30 days.</p>
-</page>
+  <p>While both <gui style="button">Archive</gui> and <gui
+  style="button">Trash</gui> removes conversations from your
+  <gui>Inbox</gui> folder, there is an important difference. Clicking
+  <gui style="button">Archive</gui> will ensure your conversations are
+  kept so you can find them again later. Clicking <gui
+  style="button">Trash</gui> will cause conversations to be hidden
+  from <link xref="search"/>, and they will likely be deleted in the
+  future.</p>
 
+</page>
diff --git a/help/C/shortcuts.page b/help/C/shortcuts.page
index 21f1e3d6..e1b8cec4 100644
--- a/help/C/shortcuts.page
+++ b/help/C/shortcuts.page
@@ -25,8 +25,7 @@
     <tr>
       <td><p>Display all keyboard shortcuts</p></td>
       <td><p>
-        <keyseq><key>Ctrl</key><key>?</key></keyseq> or
-        <keyseq><key>Ctrl</key><key>F1</key></keyseq>
+        <keyseq><key>Ctrl</key><key>?</key></keyseq>
       </p></td>
     </tr>
   </table>
diff --git a/help/C/write.page b/help/C/write.page
index efb55ade..5718e978 100644
--- a/help/C/write.page
+++ b/help/C/write.page
@@ -1,56 +1,156 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="guide"
       id="write">
+  <info>
+    <link type="guide" xref="index#overview"/>
+  </info>
+  <title>Writing new email and replying</title>
 
-    <info>
-        <link type="guide" xref="index#overview"/>
-        
-    </info>
-       <title>Write a message</title>
-       
-       <section id="overview">
-       <title>Composing and replying</title>
-       <p>To compose a new message in Geary, press the <gui>New Message</gui> button
-       on the toolbar.</p>
-       
-       <p>To reply to a message, open the message menu in the upper right corner of the message and choose 
<gui>Reply</gui>, <gui>Reply All</gui> or <gui>Forward</gui>. You can also reply to the last message in a 
conversation via the <gui>Reply</gui>, <gui>Reply All</gui> or <gui>Forward</gui> buttons on the toolbar. </p>
-       
-       </section>
-       
-       <section id="features">
-       <title>Features</title>
-       
-       <p>Geary's email composer lets you adjust the font, size and color of text. You can also insert 
hyperlinks into messages.</p>
-       
-       <p>Geary can also send plain text messages.  In the drop-down menu, check or uncheck "Rich Text"
-       to toggle between plain text and rich text mode.</p>
-       
-       <p>You can attach a file to a message you're writing in either of these ways:</p>
-       <list>
-       <item><p>Press the <gui>Attach File</gui>       button at the lower left
-       of the composer window, then select a file to attach.</p></item>
-       <item><p>Drag the file from the Nautilus file manager to the composer window, and drop it
-       either on the text fields at the top of the window or on the toolbar at the bottom.</p></item>
-       </list>
-       
-       <p>A number of keyboard shortcuts are available in the composer; see <link xref="shortcuts"/> for 
details.</p>
-       
-       <p>You may specify a signature to be inserted into the composer in the <link xref="accounts" />
-       dialog.</p>
-       
-       </section>
-       <section id="drafts">
-       <title>Drafts</title>
-       
-       <p>For mail servers that support drafts, Geary will automatically save the message as you type.
-       If you close the composer without sending, Geary will prompt you to keep the draft or to discard 
it.</p>
-       
-       <p>To edit an existing draft, select the Drafts folder in the folder list, select the message,
-       and click "Edit Draft" in the message viewer.</p>
-       
-       <p>Geary deletes the draft when you send the message.</p>
-       
-       </section>
-       
-</page>
+  <section id="overview">
+    <title>Composing and replying</title>
+
+    <p>To start a new email conversation, click the <gui
+    style="button">Compose</gui> button on the toolbar. Type the email
+    address of the people to receive the message in the <gui
+    style="input">To</gui> text field, and a subject line in the <gui
+    style="input">Subject</gui> field. You can then type your message
+    in the text area below these. Once the message is read to send,
+    click <gui style="button">Send</gui> or type
+    <keyseq><key>Ctrl</key><key>Enter</key></keyseq> to send the
+    message.</p>
+
+    <note style="tip">
+      <title>Undoing sending</title>
+      <p>When sending an email, Geary will wait 5 seconds before
+      delivering the message. During this time, you will be able to
+      click <gui style="button">Undo</gui> on the pop-up notification
+      that appears or type
+      <keyseq><key>Ctrl</key><key>Z</key></keyseq> to re-open the
+      email, and make more changes to it.</p>
+    </note>
+
+    <p>When entering an email address in the <gui
+    style="input">To</gui> and <gui style="input">Cc</gui> fields,
+    Geary will provide suggestions from your desktop address book and
+    from previously sent and received email messages. To choose one of
+    these suggestions, simply click on it. In addition, <gui
+    style="input">Bcc</gui> and <gui style="input">Reply-to</gui>
+    fields can be shown by selecting <gui style="menu">Show extended
+    fields</gui> from the formatting toolbar menu.</p>
+
+    <p>To reply to the currently selected conversation, click one of
+    the <gui style="button">Reply</gui>, <gui style="button">Reply
+    All</gui> or <gui style="button">Forward</gui> toolbar
+    buttons. This will open a new reply or forwarded email composer
+    for the latest message in the conversation.</p>
+
+    <p>When replying, the message being replied to will be quoted and
+    copied into the footer of the new reply. This can be deleted
+    before typing a reply by pressing
+    <key>Backspace</key>. Alternatively, text can be selectively
+    quoted by selecting the desired text in a message and clicking
+    <gui style="button">Reply</gui> or <gui style="button">Reply
+    All</gui>, only the selected text will be quoted.</p>
+
+    <p>To reply to a specific email message, open the message menu in the
+    top corner of the message and choose <gui>Reply</gui>, <gui>Reply
+    All</gui> or <gui>Forward</gui>.</p>
+  </section>
+
+  <section id="features">
+    <title>Text formatting, images and attachments</title>
+
+    <p>Geary's email composer lets you use text styles such as
+    <em>bold</em> and <em>italic</em>, indent text to quote it and
+    links to web pages. Simply select the text and click the
+    appropriate button on the formatting toolbar.</p>
+
+    <p>Bulleted and numbered lists can be inserted or removed by
+    clicking the <gui style="button">Bulleted list</gui> and <gui
+    style="button">Numbered list</gui> buttons on the formatting
+    toolbar. The level of indentation of list items can be adjusted
+    using the <gui style="button">Indent</gui> and <gui
+    style="button">Un-indent</gui> formatting toolbar buttons.</p>
+
+    <p>Images can be inserted into rich text messages by clicking the
+    <gui style="button">Insert Image</gui> button on the formatting
+    toolbar and selecting the image to attach, by dragging an image
+    from the <gui>Files</gui> application into the email body and then
+    dropping it, or by pasting an image that has been copied to the
+    clipboard from another application.</p>
+
+    <p>Documents, music, videos, and other files can be attached to
+    the email by clicking the <gui style="button">Attach File</gui>
+    button at the top of the composer window and selecting the
+    document to attach, or by dragging a file from the
+    <gui>Files</gui> application to the composer window, and dropping
+    it either on the text fields at the top of the window or on the
+    toolbar at the bottom.</p>
+
+    <p>A number of keyboard shortcuts are available in the composer;
+    see <link xref="shortcuts"/> for details.</p>
 
+    <p>You may specify a signature to be inserted into the footer of
+    email in the composer via the <link xref="accounts"/> dialog.</p>
+  </section>
+
+  <section id="spellcheck">
+    <title>Checking spelling</title>
+
+    <p>Geary supports spell-checking your composed email in one or
+    more languages, as you type. To enable spell-checking, first
+    ensure your computer has spell-check dictionaries installed for
+    the desired languages. Consult your computer's help to determine
+    how to install dictionaries if not present.</p>
+
+    <p>To select languages for spell-checking, click the <gui
+    style="button">Spell check</gui> button on the formatting toolbar,
+    and the language selection popover will appear. Click on a
+    language in the list to toggle it on or off, and click the <gui
+    style="button">-</gui> button to remove it from the list. If a
+    language does not appear in the list, search for it by typing its
+    name in the search box, then click the <gui style="button">+</gui>
+    button to add it.</p>
+  </section>
+
+  <section id="drafts">
+    <title>Saving drafts and restoring discarded messages</title>
+
+    <p>For mail servers that support drafts, Geary will automatically
+    save the message as you type on the server after a short
+    delay.</p>
+
+    <p>To edit an existing draft, select the <gui>Drafts</gui> folder
+    in the folder list, select the message, and click "Edit Draft" in
+    the conversation viewer.</p>
+
+    <p>Geary will delete the draft when you send the message.</p>
+
+    <note style="tip">
+      <p>If you save or discard a composed email, you can re-open it
+      by clicking <gui style="button">Undo</gui> on the pop-up
+      notification that appears or by typing
+      <keyseq><key>Ctrl</key><key>Z</key></keyseq>. The ability to
+      restore a saved or discarded composer will be remain for up to
+      30 minutes. After that you will need to re-open the message via
+      the <gui>Drafts</gui> folder, if present.</p>
+    </note>
+  </section>
+
+  <section id="plain-text">
+    <title>Plain text messages</title>
+
+    <p>Geary can also send plain text messages. In the drop-down menu,
+    check or uncheck <gui style="menu">Rich Text</gui> to toggle
+    between plain text and rich text mode. Plain text mode is useful
+    when sending email to mailing lists that prohibit rich text (HTML)
+    messages, or when sending email to people that do no use modern
+    clients like Geary.</p>
+
+    <p>In plain text mode, text will be automatically wrapped using
+    soft line breaks so that it is no longer than 74 characters wide,
+    and indented text will be wrapped and quoted using a “>” character
+    for each level of quoting.</p>
+  </section>
+
+</page>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]