From f307722c1d2631120af18e1637e4a66615bec1ec Mon Sep 17 00:00:00 2001 From: Michael Gratton Date: Mon, 18 Nov 2019 18:33:10 +1100 Subject: [PATCH] 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 @@ + + + + + Archive, trash and delete messages - - - - - - Delete or archive a message +

Geary lets you archive messages if your server supports + it. Clicking the Archive toolbar button + moves the conversation from the current folder to the + Archive folder for most email services, or to All + Mail for GMail. Archiving helps keep your email organised by + moving old and replied-to email out of the way.

-

When you use Geary with a Gmail account, Geary lets you archive messages. - The Archive toolbar button archives the selected conversation(s). - Archived messages appear in the All Mail folder.

+

To move conversations to the Trash folder, select them + and click the Trash toolbar button. To + permanently delete conversations, hold down Shift and + click the Delete button that appears in + place of the Trash button, or open the conversation in + the Trash folder and click Delete there.

-

With other mail servers, you can trash or delete, but not archive, messages. To move - one or more conversations to the Trash folder, select them and press the Trash - button on the toolbar. To permanently delete the conversations, hold down Shift and press - the Delete button that appears in place of the Trash button.

+ + Undoing changes +

Note that you can always undo archiving or trashing a message + if you change your mind. Click Undo on + the pop-up notification that appears, or type + CtrlZ, or open the folder, + find the message, then move it back to your Inbox

+ + +

While both Archive and Trash removes conversations from your + Inbox folder, there is an important difference. Clicking + Archive will ensure your conversations are + kept so you can find them again later. Clicking Trash will cause conversations to be hidden + from , and they will likely be deleted in the + future.

-

Delete is not available from every folder, such as Search. Delete is also unavailable for Gmail. - For Gmail, Trash 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.

 - 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 @@

Display all keyboard shortcuts

- Ctrl? or - CtrlF1 + Ctrl?

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 @@ + + + + Writing new email and replying + +
+ Composing and replying + +

To start a new email conversation, click the Compose button on the toolbar. Type the email + address of the people to receive the message in the To text field, and a subject line in the Subject field. You can then type your message + in the text area below these. Once the message is read to send, + click Send or type + CtrlEnter to send the + message.

+ + + Undoing sending +

When sending an email, Geary will wait 5 seconds before + delivering the message. During this time, you will be able to + click Undo on the pop-up notification + that appears or type + CtrlZ to re-open the + email, and make more changes to it.

+ + +

When entering an email address in the To and Cc 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, Bcc and Reply-to + fields can be shown by selecting Show extended + fields from the formatting toolbar menu.

+ +

To reply to the currently selected conversation, click one of + the Reply, Reply + All or Forward toolbar + buttons. This will open a new reply or forwarded email composer + for the latest message in the conversation.

+ +

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 + Backspace. Alternatively, text can be selectively + quoted by selecting the desired text in a message and clicking + Reply or Reply + All, only the selected text will be quoted.

+ +

To reply to a specific email message, open the message menu in the + top corner of the message and choose Reply, Reply + All or Forward.

+
+ +
+ Text formatting, images and attachments + +

Geary's email composer lets you use text styles such as + bold and italic, indent text to quote it and + links to web pages. Simply select the text and click the + appropriate button on the formatting toolbar.

+ +

Bulleted and numbered lists can be inserted or removed by + clicking the Bulleted list and Numbered list buttons on the formatting + toolbar. The level of indentation of list items can be adjusted + using the Indent and Un-indent formatting toolbar buttons.

+ +

Images can be inserted into rich text messages by clicking the + Insert Image button on the formatting + toolbar and selecting the image to attach, by dragging an image + from the Files application into the email body and then + dropping it, or by pasting an image that has been copied to the + clipboard from another application.

+ +

Documents, music, videos, and other files can be attached to + the email by clicking the Attach File + button at the top of the composer window and selecting the + document to attach, or by dragging a file from the + Files 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.

+ +

A number of keyboard shortcuts are available in the composer; + see for details.

+ +

You may specify a signature to be inserted into the footer of + email in the composer via the dialog.

+
+ +
+ Checking spelling + +

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.

+ +

To select languages for spell-checking, click the Spell check 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 - 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 + + button to add it.

+
+ +
+ Saving drafts and restoring discarded messages + +

For mail servers that support drafts, Geary will automatically + save the message as you type on the server after a short + delay.

+ +

To edit an existing draft, select the Drafts folder + in the folder list, select the message, and click "Edit Draft" in + the conversation viewer.

+ +

Geary will delete the draft when you send the message.

+ + +

If you save or discard a composed email, you can re-open it + by clicking Undo on the pop-up + notification that appears or by typing + CtrlZ. 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 Drafts folder, if present.

+ +
+ +
+ Plain text messages + +

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. 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.

+ +

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.

+
- - - - - Write a message - -
- Composing and replying -

To compose a new message in Geary, press the New Message button - on the toolbar.

- -

To reply to a message, open the message menu in the upper right corner of the message and choose Reply, Reply All or Forward. You can also reply to the last message in a conversation via the Reply, Reply All or Forward buttons on the toolbar.

- -
- -
- Features - -

Geary's email composer lets you adjust the font, size and color of text. You can also insert hyperlinks into messages.

- -

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.

- -

You can attach a file to a message you're writing in either of these ways:

- -

Press the Attach File button at the lower left - of the composer window, then select a file to attach.

 -

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.

 - - -

A number of keyboard shortcuts are available in the composer; see for details.

- -

You may specify a signature to be inserted into the composer in the - dialog.

- -
-
- Drafts - -

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.

- -

To edit an existing draft, select the Drafts folder in the folder list, select the message, - and click "Edit Draft" in the message viewer.

- -

Geary deletes the draft when you send the message.

- -
- -