From nobody@localhost Wed Jul 1 08:46:56 2020 X-MailPP-UID: :1593593217-17069-30-sparky.zia.io From: Online Help Subject: Cone mail client Mime-Version: 1.0 Content-Type: text/html; charset=utf-8

# Cone mail client

# Introduction

Cone is a screen-oriented E-mail/News reader and writer. If you are reading this documentation from within Cone, you are actually reading the simplified HTML version of Cone's documentation that's formatted as a folder of E-mail messages. Each online tutorial chapter appears as a separate message. Use PgUp and PgDn to read each chapter. Press N and P to move to the next/previous chapter.

Pressing Q on most screens exits Cone. Cone tries to gracefully log out and shut down all server connections. If Cone cannot log out of a remote server because the remote server is down, press CTRL-C (after Q to terminate Cone).

Use CTRL-Z to temporarily suspend Cone and drop back to the shell prompt. Cone remains suspended in the background, and may be restarted by using the shell's fg command.

### Note

Connections to remote mail servers may be disconnected for inactivity if Cone remains suspended for a prolonged period of time. When suspended, Cone cannot maintain any active connections to remote mail servers.

It might be more convenient to browse the full HTML documentation using your favorite web browser, at http://www.courier-mta.org/cone/cone00index.html. When Cone starts for the first time, it automatically creates a fake mail account called “Online Tutorial”. This fake mail account contains a stripped-down HTML version of the online documentation, which you are reading now. The terminal display must be at least 80 characters wide in order to be able to read “Online Tutorial”.

The “Online Tutorial” mail account can always be removed, but it might be convenient to keep it around for a quick consultation, from time to time, even though the full HTML version is a bit easier on the eyes.

#### Overview

Cone is a powerful, yet simple, text-based mail reader. Cone seamlessly handles multiple mail accounts simultaneously. Cone is capable of using the following kinds of mail accounts:

- Local mail folders, or maildirs.

- Remote POP3 and IMAP mail server accounts.

- A simple newsgroup reader. Cone doesn't have sophisticated features found in dedicated newsreaders, and may be a bit slow and memory hungry when reading large Usenet newsgroups. However, Cone will prove to be an excellent, fast, reader of internal local newsgroups, accessible via a remote login.

- Experimental SMAP mail server accounts.

Cone contains an experimental implementation of a new remote mail access protocol, “SMAP”. At this time, SMAP is implemented by the Courier-IMAP server. SMAP offers several improvements over traditional IMAP-based mail accounts, namely:

- Names of SMAP folders may use the full UTF-8 character set. Most IMAP servers restrict certain characters from appearing in names of folders, due to their special meaning in the IMAP folder hierarchy.

- Faster downloading of binary attachments. SMAP requires approximately 25% less bandwidth to download binary attachments.

- Consolidated mail transmission. IMAP clients usually need to transmit a message twice, when mailing it. An IMAP client must first save the message in the IMAP server's “Sent Mail” folder. Afterwards, the IMAP client needs to send a second copy of the message, using SMTP, in order to deliver it to the listed recipients. When using SMAP, Cone transmits the message only one time; the server saves it to the “Sent Mail” folder, then mails it to its designated recipients.

  Of course, Cone is fully capable of using traditional SMTP, or running the local sendmail command.

Other features of Cone:

- Full SSL/TLS support with IMAP, POP3, NNTP, SMTP, and SMAP. SASL CRAM-MD5/CRAM-SHA1 authentication (except for NNTP).

- Built-in editor for creating messages.

- Full UTF-8 support (requires the wide-character version of the Curses library).

- Spell checker.

- Local and remote (IMAP or SMAP-based) addressbooks.

- Remote configuration (share a common configuration between different instances of Cone).

- Cone tries to automatically customize itself to user's preferences, without requiring explicit configuration. Cone remembers the sorting order of each opened folder's index. When a folder is reopened, Cone sorts the folder using the same sort order used when the folder was opened last. Similarly, Cone memorizes user-configured mail headers. `From:`, and several other, mail headers are freely editable, and default to their contents the last time a new message was sent by replying to a message in the folder, or which was created while that folder was opened. A “power user” can easily use multiple mail accounts with Cone, and Cone will select the appropriate mail headers when replying to messages from each mail account.

>
From nobody@localhost Wed Jul 1 08:46:56 2020 X-MailPP-UID: :1593593217-17069-31-sparky.zia.io From: Online Help Subject: Folder Listing Mime-Version: 1.0 Content-Type: text/html; charset=utf-8

## Folder Listing

This is the first screen that comes up after starting Cone. This screen lists all configured mail accounts. After starting, Cone automatically opens the first configured mail account, prompting for a password if necessary. Cone is capable of handling multiple mail accounts, and any additional configured mail accounts are initially closed. To open one of the other mail account, highlight it with the cursor and press ENTER.

When a mail account is opened, Cone lists the default set of folders in the mail account. Folders that contain other subfolders, instead of messages, are prefixed by a “`+`”, or a “`→`” (depending on the display). Certain mail servers may have folders that contain both messages and subfolders. Those so-called “hybrid” folders are prefixed by a “`*`”, or a “`•`” (depending on the display).

Move the cursor to highlight a folder and press ENTER to display its contents (either an index of messages in the folder; or a list of the folder's subfolders). Use + to display subfolders of a hybrid folder, use ENTER to display the index of messages in a hybrid folder.

Move the cursor to highlight a folder with displayed subfolders and press - to remove its subfolders from display.

Some mail accounts will display the number of messages in each folder, automatically. Sometimes the number of messages in a mail folder cannot be quickly determined, so Cone will not bother to show the folder's size. Message counts are automatically shown for:

- Mail stored in local maildir folders.

- Mail stored on most remote POP3 and IMAP servers.

Message counts are not automatically shown for:

- Mail stored in local mailbox files.

- Mail stored on some IMAP servers.

Sometimes Cone cannot correctly determine whether the IMAP server provides message counts quickly. Use the “`/slowstatus`” or the “`/faststatus`” flag when creating the new mail account to specify whether Cone should automatically show message counts for displayed folders.

When Cone runs for the very first time, Cone creates a mail account that contains local mail folders. Use the main menu screen to add additional mail accounts. Here's an example of the “Folder Listing” screen:

#### Folder Listing Screen

     FOLDERS                              CONE

        Main Account: Courier-IMAP server
          New Mail (5 messages)
          + Lists
            Courier-Users (1 messages)
            JunkFax-L
            System-Testers
            Release-Notice
            Sqwebmail
          + Folders

        account3@example.com: POP3 - Courier Mail Server
          Folder: 40 messages, 39 unread

        account4@example.com:

      LIST completed
     A Add          ^D Move down     M Main Menu     U Use special   W Write Msg
     D Delete        E Edit Acct     R Rename       ^U Move up

The bottom two lines of the screen lists the available “hotkeys”, and their corresponding actions. “`^`” indicates that CTRL should be held down while pressing the following key. On this screen, for example, press and hold CTRL, then press and release D to invoke the “Move down” action (described below).

Screens with more “hotkeys” that can fit on the screen will use CTRL-O to cycle through the complete “hotkey” listing.

As shown in the illustration above, Cone lists the hierarchy of available folders in a natural, tree-like format. The list of folders in each mail account begins with a list called “top-level folders”; the ENTER and + keys will then display the contents of each folder.

When a new mail account is configured, Cone creates a default list of “top-level folders”, as follows:

Local mail folders

  The default top-level folder list initially contains one entry, the name of the directory where local mail folders are kept, and a second, optional entry that represents the default system mailbox.

Local maildirs

  The default top-level folder list initially contains two entries: “INBOX” - messages; and “Folders” - folders (Cone implements the “Maildir++” folder extension, as implemented by the Courier Mail Server).

POP3 mailboxes

  A POP3 mailbox does not contain any folders. When opened, a POP3 mail account displays the number of messages in the POP3 mailbox where the top-level folder list is usually shown. Highlighting it and pressing ENTER will display the index of messages in the POP3 mailbox.

IMAP accounts

  The default top-level folder list initially contains “INBOX” (the default IMAP new mail folder), and any other default mail folder hierarchies, as announced by the IMAP server.

SMAP accounts

  The default top-level folder list is initialized by downloading the default folder list from the SMAP server.

NetNews (Usenet) accounts

  The default top-level folder list contains four entries, described below.

##### Reading Usenet Newsgroups

Opening a NetNews (Usenet) account displays four entries:

All Newsgroups

  This entry opens a hierarchical listing of all available newsgroups, subscribed and unsubscribed. Highlight a newsgroup with the cursor and press ENTER to subscribe and open the newsgroup for the first time.

Check for new newsgroups

  This entry opens a list of all recently created newsgroups.

Refresh newsgroup list

  Highlight this entry with the cursor and press ENTER to download and save the server's entire list of available newsgroups. This process may take a long time. On low bandwidth connections it may take 15-20 minutes, depending on the number of newsgroups carried by the server.

  Sometimes servers may not correctly report newly-created newsgroups, so using this option will be necessary in order to add the new groups to "All newsgroups". Additionally, this is the only way to remove newsgroups no longer carried by the server from "All newsgroups".

Subscribed newsgroups

  This entry contains a list of subscribed newsgroups. To subscribe to a newsgroup, find it under "All newsgroups" and open it. This action automatically subscribes the newsgroup. To unsubscribe a newsgroup, highlight it here, then press D (Delete).

  Another way to subscribe to a newsgroup is described in the following section.

##### Adding top-level folders

There are two ways to manually insert additional folders into the top-level list. The easiest way is to highlight an existing folder, then press U, then T. This folder is now included in the top-level folder list. It is important to note that the actual mail folder is not renamed, or otherwise moved in the mail account, it is only shown as part of the default top-level folder hierarchy. The top-level entry for this folder can be thought of as a “shortcut” to the folder. If the original folder is located deep in the mail account's folder hierarchy, it is no longer necessary to dive deep into the hierarchy each time the mail account is opened, in order to reach the folder; it's going to be right there, in the top-level folder hierarchy.

Top-level folders do no appear in their original location in the mail account's folder hierarchy. When the folder is first added to the top-level folder list it momentarily appears twice: in its actual location, on the screen, and at the topmost level. After its original hierarchy folder level is closed, it will no longer appear. As noted above, the folder is still there, it just appears as a shortcut at the topmost level. When the shortcut is removed (see the next section), the folder reappears in its place.

The second way to create top-level folder shortcuts is to highlight the name of the mail account with the cursor, then press A (Add). Cone shows the following prompt: “`Add folder/directory in` `account`”. Enter the complete folder name, as used by the mail account's server. This method for adding top-level folders requires some knowledge of the folder's location on the mail server. However it can be used to add folders that are outside of the currently-configured folder hierarchies (which is sometimes the case with IMAP servers), as follows:

IMAP folders

  The folder name is used as is. This means that folders whose names contain characters that are not in the application's character set, or do not follow the IMAP modified `UTF-7` folder name encoding, cannot be entered.

SMAP folders

  Specify the complete folder path name. Use the forward slash character, “`/`” to separate names of individual folders in the `SMAP` folder hierarchy. Unicode/ISO-10646 characters that cannot be represented in the application's character set may be specified as “`%``n``;`”, where `n` is a decimal Unicode value. Use “`\/`” to specify a forward slash character in the folder name, “`\\`” to specify a backslash character, and “`\%`” to specify the “%” character.

Usenet (NetNews) newsgroups

  Usenet accounts already have a dedicated link to subscribed newsgroups. For Usenet accounts, this process is used to subscribe to a new newsgroup which does not appear under "All newsgroups".

  It is not possible for NetNews (Usenet) readers to maintain a correct, accurate list of available newsgroups. Usenet readers must download a list of available newsgroups, which can be quite large and require a significant time to download. It's not feasible to do this every time. As such, Usenet readers keep a saved copy of the download newsgroup list. Upon request, the newsgroup list may be downloaded again, and the locally saved list is brought up to date. This is what "Refresh newsgroup list" does.

  "Check for new newsgroups" is a partial solution that's supported by most Usenet news servers, and can usually do the trick and download recently added newsgroups. There's no way to remove newsgroups no longer carried by the server, except by using "Refresh newsgroup list", but at least "Check for new newsgroups" will do the trick and include new groups under "All newsgroups", so that they can be subscribed to.

  However, sometimes "Refresh newsgroup list" might not work with some oddball news server, or the news server can accidentally lose its wits and "forget" which new newsgroups were added, recently. In any case, use the process for creating a top-level folder in order to manually subscribe to a newsgroup. Type in the newsgroup's name, carefully checking for the correct spelling. After creating a link, open it and the newsgroup will now be subscribed to, and it will now appear under "Subscribed newsgroups".

Local mbox-type mail folders and maildirs

  Specify the complete folder path name, relative to main folder directory. For example, if this mail account is configured as a local mbox mail account in `$HOME/Mail`, use “`foo/bar`” to specify `$HOME/Mail/foo/bar`. Use the forward slash character, “`/`” to separate names of individual folders in the local mail folder hierarchy. The actual folder names use the modified `UTF-7` character set, and the entered folder name is automatically converted from the application's character set to modified `UTF-7`. This is needed for compatibility reasons (making it possible to access local mail folders both directly, and using IMAP or SMAP).

  Unicode/ISO-10646 characters that cannot be represented in the application's character set may be specified as “`%``n``;`”, where `n` is a decimal Unicode value. Use “`\\`” to specify a backslash character, and “`\%`” to specify the “%” character.

##### Removing top-level folders

Highlight a top-level folder with the cursor, and press D to remove it. The folder is not actually deleted from the mail account, it is only removed from its top-level placement, and it will now appear in its real location in the mail account's folder hierarchy.

##### Removing memorized headers

Cone memorizes custom mail headers in sent messages. When replying to a message in a folder, or creating a new message when the folder's contents are shown, the memorized content are used to set up the initial default values of custom headers. Different mail folders may have different defaults memorized. Additionally, each mail account has a global set of memorized default headers, which are used when replying or writing a message for the first time in a new folder.

### Note

At encryption key used for signing messages is handled just like a custom header, and a different encryption key may be set as a default for each folder.

Highlight a folder and press CTRL-R to remove all memorized header defaults for the highlighted folder. The initial header values for this folder will now default to the global account defaults.

##### Renaming folders

Highlight an existing mail folder and press R to rename it. This option does not work when a top-level folder is highlighted. A top-level folder is, essentially, a shortcut to an existing folder. Remove the top-level folder shortcut, find the original folder in its regular position in the folder hierarchy, then rename it.

##### Creating new folders

To create a new folder, highlight its parent folder directory, then press A (Add). Cone responds with the following prompt: “`Create new folder in` `parent`”. Enter the name of a new folder, and press ENTER.

Press CTRL-D before ENTER in order to create a folder directory, instead of a regular folder. A folder directory contains other subfolders, instead of messages. Some IMAP and SMAP mail servers can create so-called “hybrid” folders -- folders that contain both messages and other subfolders. Repeat this process twice to create a hybrid folder. Enter the same name both times; first to create a folder, then a folder directory with the same name.

Local mbox-type mail accounts cannot have hybrid folders. Hybrid folders are available with local maildir accounts.

Do not create a folder directory without creating at least one subfolder immediately afterwards. When a parent directory is shown, some mail accounts may not display a folder directory that does not have at least one subfolder. For best results: after creating a new folder directory, make sure that its name is highlighted, then use this command to create its first subfolder.

##### Deleting folders

Highlight the name of a folder with a cursor then press D (Delete) to remove it. The folder, and its contents, will be deleted. Use the same process to remove a folder directory. When trying to remove a hybrid folder, Cone will prompt to choose to remove either the subfolders, or the messages in the hybrid folder.

Some mail accounts may require that all messages in a folder be manually removed first, and will not remove a folder until it's completely empty.

Some mail accounts may require that all subfolders in a folder directory be manually removed first, and will not remove a folder directory until it's completely empty.

Note: highlighting a top-level folder and pressing D removes only the top-level shortcut, and does not remove the actual folder.

##### Editing folder permissions

Highlight a folder, then press P to view or edit folder permissions. Folder permissions determine whether other IMAP mail accounts may view, or change the contents of the folder. This option is only available for folders on IMAP mail servers that implement access control lists (access control lists are an optional IMAP protocol feature that is implemented by many IMAP servers). Attempting to use this option on a folder that's not an IMAP folder, or if the IMAP server does not implement access control lists, will result in an error.

Pressing P shows a submenu with two options:

View permissions

  Press V to display your permissions are on the given folder.

Edit permissions

  Press E to display all permissions for the given folder; this option may also be used to modify or adjust them.

  This option is available only if “View permissions” shows that you have the “Administrator” permission for the folder. Otherwise selecting this option results in an error.

  The “Edit permissions” screen is designed to be self-explanatory. Folder permissions, or “access control list” as its called, consists of a list of identifier/rights pairs. “identifier” designates the entity with the associated rights.

Not all servers support every one of the following access control list identifiers. See the server's documentation to check which access control list identifiers are implemented by the server:

“`anonymous`”, or “`anyone`”

  This identifier refers to universal access rights given to everyone, including anonymous users (if supported by server).

“`authuser`”

  Same as “anyone”, except for anonymous users. If the server does not implement anonymous access, then “anonymous”, “anyone”, and “authuser” are equivalent.

“`owner`”

  The owner of the mailbox that contains the folder.

“`administrators`”

  Any member of a group that's defined as an administrator group, in an implementation-defined way.

“`user=``username`”

  A single system user, identified by `username`.

“`group=``groupname`”

  Any system user that's part of a group identified by `groupname`. Groups are created and managed by IMAP server-specific tools. See the server's documentation for information on creating and managing groups (if the groups are even implemented by the server in the first place).

“-`identifier`”

  An access control list identifier may be prefixed by a “-”, which refers to a “negative right”. Negative rights explicitly revoke the associated access rights from the `identifier` instead of granting the right.

  Negative rights are not implemented by all servers. See the server's documentation to check if the server implements negative access rights.

Highlight an identifier with the cursor and press Enter to modify the identifier's rights. To delete an identifier, and its associated rights, highlight it with the cursor and press D. Press A to add an identifier. Use the next submenu to select the new identifier (“`owner`”, “`user`”, etc...), then specify the new identifier's rights.

### Note

Not all servers support every kind of an access control list identifier. Additionally, some IMAP servers are limited in the combination of access rights that may be given to an identifier. For example, IMAP servers that implement version 1 of the access control list protocol can only assign the “Delete/undelete messages”, “Expunge deleted messages”, and “Delete folder” together as a group. Either all three access rights must be given to an identifier, or none of them. An attempt to add only one or two of these access rights will be rejected by the server.

Other IMAP servers may have other restrictions on which combination of access rights are valid, or not. Depending on the server, the error message which rejects an invalid access rights combination may or may not be informative. Check the IMAP server's documentation for more information.

##### Installing filters

Highlighting a folder and pressing F opens a screen where the folder's filters may be entered or modified. This is an advanced topic. See “Mail Filters” for more information.

##### Removing mail accounts

Highlight the mail account's name with the cursor, and press D to remove it. This action logs out and removes the mail account. New mail accounts are added from the main menu.

##### Rearranging accounts and top-level folders

The order in which mail accounts, and their top-level folders, are listed may be adjusted by highlighting a mail account, or a top-level folder, and then using CTRL-U or CTRL-D.

CTRL-U moves the highlighted mail account, or folder, one position upwards, CTRL-D moves it one position downwards.

CTRL-U and CTRL-D only work when a mail account, or a top-level folder, is highlighted. Other folders are always shown in alphabetical order.

##### Defining special folders

Cone needs to assign folders for certain tasks. Highlighting a folder, and pressing U (Use special) brings up the following prompt, which designates the highlighted folder as follows:

A - address book

  Cone can save its simple E-mail address book on a remote server, in addition to its local address book. POP3 mail folders cannot be used as remote address books, only IMAP or SMAP folders can do that. To create a new address book on a remote server, create a new IMAP or SMAP folder, highlight it with a cursor, and use this option.

  This option adds a new remote address book. Cone can handle more than one address book, and E-mail addresses are looked up in each configured address book, sequentially, until the address is found.

  Cone can also search LDAP server-based address books. LDAP address books are added by choosing the “Address Book” option from the Main Menu.

D - draft

  The draft folder is where new, unfinished messages, that have not been sent yet, are saved. Only one draft folder may be defined; selecting a new draft folder automatically unselects the previous draft folder.

S - sent mail

  This special folder contains saved copies of sent messages. Each time a message is sent, a copy is automatically placed into this folder, by default.

  This option adds a new sent mail folder. Cone can handle more than one sent mail folder. When writing a new message, a sent mail folder may be selected where a copy of this message will be saved, after it is sent.

R - remote configuration

  Enables remote configuration and uses this folder to save the configuration data. See “Remote Configuration” for more information.

T - top level folder

  This option was already discussed previously.

IMPORTANT: a POP3 folder cannot be used as a special folder. Only IMAP, SMAP, or a local mail folder may be used as a special folder.

IMPORTANT: do not delete a mail folder, or a mail account, that contains a special folder. Remove an existing address book using the “Address Book” selection from Cone's main menu. Remove an existing draft folder first by selecting a draft folder on a different mail account. Remove an existing sent-mail folder by choosing the “Setup” selection from Cone's main menu. Then, the folder or the account containing a special folder can be deleted.

IMPORTANT: Do not open an address book folder, or a remote configuration folder manually, unless the remote IMAP/SMAP server allows concurrent access to the same folder. Cone opens and closes these folders automatically, when needed. If the remote IMAP/SMAP server does not allow the same folder opened more than once, opening the folder manually will result in unpredictable errors.

##### Reconfiguring an account

Use the cursor to highlight the name of a mail account, and press E to edit the mail account's configuration. This is primarily useful with remote mail accounts. There isn't much to do with local mail accounts. Just remove an existing local mail account, then add a new account that points to a different mail folder directory.

More details about the process of configuring a mail account can be found in the section that describes the process of adding a new mail account.

##### Other commands

M

  Pressing M closes this screen, and opens the “Main Menu” screen.

W

  Pressing W opens the “Write Message” screen. This is the screen where a new message can be typed, and sent. Cone checks for any unfinished messages in the Draft folder, before opening this screen. If the Draft folder contains any messages, Cone offers an option to resume writing an unfinished message, instead of starting a new message. Cone automatically saves a backup copy of the current message being edited, at regular intervals, so that a backup copy can be recovered in the event that Cone is interrupted, or terminated, in a middle of editing a new message. If a backup copy exists, Cone announces the existence of an interrupted message, and prompts to resume writing the interrupted message. An interrupted message must be opened and either: sent, explicitly cancelled, or saved in the Draft folder; before another message can be written.

>
From nobody@localhost Wed Jul 1 08:46:56 2020 X-MailPP-UID: :1593593217-17069-32-sparky.zia.io From: Online Help Subject: Folder Index Mime-Version: 1.0 Content-Type: text/html; charset=utf-8

## Folder Index

Highlighting a folder on the folder listing screen and pressing ENTER shows an index of messages in the folder. Cone shows the following information for each message:

- The message number, starting from 1 and counting upwards. New messages (unread messages), are prefixed with by “`N`”. Messages marked for deletion are prefixed by “`D`”. On some terminals, new messages are prefixed by a little diamond symbol, and messages are marked for deletion by a crosscheck symbol. Messages that have been replied to are prefixed by “`R`”.

  Cone can process groups of messages at once (for example: deleting or moving a group of messages to another folder). This is done by “flagging” each message, individually, then executing the command. Each flagged message is marked with an asterisk, “`*`”. On some displays, flagged messages are identified by a checkmark symbol, instead of the asterisk.

- The date or time when the message was sent or received. Only the date is shown for messages sent or received over a week ago. More recent messages have their day and time shown.

- The sender's or recipient's name. Messages sent to multiple people have only the first recipient shown.

- The approximate size of the message.

- The message's subject. There's not a lot of room to show the message's subject; Cone shows as much of a subject as possible.

  Messages that belong to a watched thread, or a subthread, have the “`≡`” “`•`” character shown, in reverse colors, in front of the message's subject. Terminals that cannot display these symbols will use the “o” and “*” characters instead. See “Watching Threads”, below, for more information.

#### Folder Index Screen

     New Mail: 7 messages                 CONE
      1  29-Jul-2002 Jack Jones              (2 Kb) IMAP server bug
      2  08-Aug-2002 Support                 (3 Kb) New security features
      3  25-Feb-2003 Sam Smith               (3 Kb) news.pl
      4  05-Mar-2003 Bill Black              (4 Kb) Re: IMAP server bug
      5  27-Mar-2003 Bill@example.com        (3 Kb) Suggested changes to README
    N 6 Mon 06:39 PM Joseph_Brown@computer  (54 Kb) Re: your request for a copy
    N 7 Wed 10:55 AM Dr. Gary Green          (2 Kb) Spec file for release 1.7.1,

      New Mail: 7 messages
     ; Search            A wAtch/Unwatch     C Copy              E Extern cmd
     $ Sort folder       B Blind Fwd         D Delete           ^O mOre

The highlighted message on this screen marks the current message. Move the cursor using the cursor up/down keys, PgUp, and PgDn. The cursor left/right keys move the cursor to the previous/next flagged message. After running a search with the ; command (see below), use the cursor left/right keys to locate the messages found by the search.

L or the < returns to the folder listing screen, or use the following keys:

ENTER

  Display the current message.

;

  Search messages, flag them, then do something to all flagged messages, at once. Additional options will be shown to enter the search criteria, described below.

$

  Change the order the messages are shown on this screen. Initially, the messages are shown in the order they were added to the folder. Use this option to set the available sorting order: A - in the order they were added to the folder (default); D - order by each message's sent date; N - order messages by sender's (or the recipient's) name; S - order messages by their subject; T - order messages by threads.

  The threaded view works best on UTF-8 consoles. It is also not very well suited for machines with limited resources. Computing a threaded view is expensive, and the threaded view needs to be recomputed whenever messages are added or removed from the folder. Machines with limited resources should use a subject-based sort, which is much faster, and gives similar results.

A

  Watch replies to this message, or stop watching replies to this message. See “Watching Threads”, below, for more information.

B

  “Blindly” forward the current message. The message is resent without adding any additional comments, or changing the sender's name. Cone prompt for the recipient's name, or names, and send the messages without changing the message's headers in any way (additional headers may be added by the mail server, of course).

C

  Copy the current message to another folder. Cone temporarily goes back to the folder listing screen. Highlight the destination folder with the cursor and press ENTER.

D

  Mark the current message for deletion. The message is not actually deleted. It is marked for deletion by the “expunge” command.

E

  Assign an external command to a function key, or remove an existing external command function key assignment. See “External commands”, below.

F`n`

  Run the external command assigned to the given function key. The external command receives a copy of the current message on its standard input. See “External commands”, below.

F

  Forwards the current message. Cone opens a screen where a new message may be written. The current message is either saved as an attachment to the new message, or is quoted in the new message's text (Cone prompts to choose one or the other before opening the new message screen).

J

  Jump elsewhere in this folder. Scrolling through a large folder may be a tedious process. This option prompts for a message number, and moves the cursor to that message, scrolling the display, if necessary.

L, or <

  This option closes the folder index screen, and returns to the folder listing screen.

M

  Pressing M closes this screen, and opens the “Main Menu” screen.

O

  Move the current message to another folder. This is similar to the “Copy” command, except that the message is removed from the current folder after it's succesfully copied to the destination folder.

R

  This option creates a reply to the current message. Cone may ask a few questions before creating a reply. Cone knows how to format replies in three different ways. Not every format reply is available with every message. No questions are asked when only one reply format is possible for the message. Cone asks when more than one reply format is available.

  Proper selection of a reply format is only possible when the main menu's setup screen is initialized with all applicable E-mail addresses. The available reply formats are:

  Reply to a mailing list

    If one or more of the recipients of the original message are mailing list addresses, the reply is addressed to the mailing list addresses only, ignoring any sender or carbon-copy addresses.

  Reply to all

    If the message is addressed to or from more than one address, excluding the user's address, the reply is addressed to all original senders and recipients, except for the user's address.

  Reply

    The reply is addressed to the sending party.

S

  Many mailing lists have “[subject]” automatically inserted into the subject line of all mailing list messages. Press “S” to hide/show the so-called “blobs” from the subject line of messages shown on the folder index screen. The subject line has limited display real estate, and removing the [blob] allows more of the meaningful subject to be viewed on this screen.

SPACE

  The space bar is an alternative way to flag or flag individual messages without using the ; command. SPACE flags or unflags the current message. It is still necessary to use ; in order to actually do something to all flagged messages.

T

  T opens a submenu where a message may be “tagged”. Tagged messages are shown with a different background color. This is merely a visual aid for highlighting selected messages, and nothing more. A color-capable display is necessary for showing tagged messages.

  The submenu lists nine available tags, selected by pressing a digit 1 through 9. 0 removes the existing tag on the current message. The colors for the tags are selected from those available on the current display. Some tags will share the same color if the current display has less than nine available colors, in addition to the default text color.

  The names of each tag may be set by choosing the “Setup” selection from Cone's main menu. The default names of the first five tags are the same as message labels used by the Mozilla mail client. With most IMAP servers Cone and Mozilla will see each other's tagged/labeled messages (however Cone's colors are determined by the console's color palette, and may not necessary match the ones Mozilla uses for the same label). This requires additional IMAP server functionality that may not be implemented by some IMAP servers.

U

  The opposite of the D command - removes the deleted mark from the current message.

V

  This command opens the screen with a list of attachments to the current message. This is the “View Attachment” screen. It is a very simple screen: each attachment is listed, giving its MIME type (the type of the attachment), its approximate size, and the attachments's description, if provided.

  Plain text attachments may be viewed individually, by pressing ENTER. Press S to download and save the highlighted attachment. Use I to return to the folder index screen, L to return to the folder listing screen, and M to go back to the main menu screen.

  After downloading an attachment it may be optionally deleted, or removed from the message. Press D to delete the highlighted attachment. Pressing D does not delete the attachment immediately, it only marks the attachment for deletion. More than one attachment may be marked for deletion at the same time. Press X to permanently remove all attachments that are marked for deletion. Beforing pressing X, a marked attachment can be unmarked by pressing U. Once X is pressed all the deleted attachments are gone for good, and cannot be undeleted.

  ### Note

  Only messages in local mail folders, IMAP folders, and POP3 maildrop folders may have their attachments removed. Messages in POP3 folders and NetNews folders cannot have their attachments removed.

  When GnuPG is installed, highlighting an attachment that contains GPG/PGP keys and pressing ENTER imports the keys. Cone prompts for a confirmation, then runs GnuPG to import the attached keys. Some versions of Gnu require a special procedure for importing private keys. Cone's prompt has an explicit private key export option. With other versions of GnuPG this option doesn't matter. Selecting the default import option will import whatever keys were attached, public or private.

  When running in an X-terminal, highlighting an image attachment and pressing ENTER displays the image in a separate window. This is done by running either Gnome's eog, or KDE's kview image viewer. Cone's manual page contains instructions for installing hooks for viewing other kinds of attachments, or using a different image viewer.

W

  Pressing W opens the “Write Message” screen. This is the screen where a new message can be typed, and sent. Cone checks for any unfinished messages in the Draft folder, before opening this screen. If the Draft folder contains any messages, Cone offers an option to resume writing an unfinished message, instead of starting a new message. Cone automatically saves a backup copy of the current message being edited, at regular intervals, so that a backup copy can be recovered in the event that Cone is interrupted, or terminated, in a middle of editing a new message. If a backup copy exists, Cone announces the existence of an interrupted message, and prompts to resume writing the interrupted message. An interrupted message must be opened and either: sent, explicitly cancelled, or saved in the Draft folder; before another message can be written.

X

  This is the “Expunge” command. All messages marked for deletion are permanently removed from the folder.

##### External commands

An external command is any arbitrary command that Cone runs as a child process. The external command reads a copy of an email message on its standard input. The external command may take any arbitrary action with this email message, Cone doesn't care. This is a mechanism for integrating Cone with some custom mail processing code. Cone takes care of downloading an email message from a mailbox, and delivers it to an external command.

### Note

The external command must consume and read the email message from its standard input. If Cone detects that the external command did not read the entire message before it terminates, Cone assumes that the external command crashed, and reports an error. Note that the message is sent via a pipe, and Cone may not reliably detect a premature external command termination when the email message is small and fits into the internal pipe buffer.

An external command may be assigned to any available keyboard function key. Different commands may be assigned to different function keys. Press E then a function key. If the function key is already assigned to an external command, Cone asks for a confirmation to remove the existing assignment. Otherwise, Cone asks for a short 1-2 word command name. This is a descriptive label that gets shown at the bottom of the screen, next to the function key name, together with all other “hotkeys”. Press Enter after typing in the label, then type out the external command. Cone passes the entered command, verbatim, to the system shell to execute.

### Note

Some environments and desktops may reserve certain function keys for their own use. The Gnome desktop, for example, uses F1 as an application help function. Reserved function keys are not available to Cone, however there's no way for Cone to know whether or not a given function key is available for its use. When Cone may be used in multiple environments or desktops, care should be taken to assign external commands to function keys that are available in all environments.

Cone expects the external command to read its email message from standard input, finish up whatever it does with this message, and promptly terminate. Cone stops and waits for the external command to terminate, before it proceeds. Cone stops responding to any user input until the external command terminates. However, Cone still remains in control of the display. The external command should have its standard output and standard error redirected, otherwise its output will corrupt the terminal display.

##### Searching messages

Pressing ; on the folder index screen brings up an extensive sequence of options to enter a criteria that's used to search messages. After the search criteria is specified, messages that meet the search criteria are shown as flagged (highlighted, and preceded by a “`*`” or a checkmark). Messages that meet the search criteria can be quickly located by pressing the cursor left/right keys, which move the cursor to the previous or the next flagged message.

Requesting a search when some messages are already flagged shows an additional prompt:

B - Broaden search

  Searches the remaining messages that are not already flagged. Any messages that meet the search criteria are also flagged. Existing messages that are already flagged remain flagged. The final result is that messages which meet both the new search criteria and the previous search criteria(s) are flagged.

N - Narrow search

  Searches only messages that are already flagged. Flagged messages that meet the search criteria remain flagged. Messages that don't are unflagged.

F`n`

  Run an external command assigned to the given function key. See “External commands” for more information. The external command gets invoked once for each flagged message, so if ten messages are flagged, the external command gets invoked ten times in a row, once for each flagged message.

C - Copy flagged

  Copy flagged messages to another folder. Cone temporarily goes back to the folder listing screen. Highlight the destination folder with the cursor and press ENTER.

D - Delete selected

  No more searching is done. All flagged messages are marked as deleted (but not actually removed, use the eX command to do that).

O - Move flagged

  Moves flagged messages to another folder. This is similar to the “Copy” command, except that the messages are removed from the current folder after they're succesfully copied to the destination folder.

R - Reset selected

  No more searching is done. All flagged messages are unflagged.

U - Undelete selected

  No more searching is done. All flagged messages that are marked as deleted have the deleted mark removed.

###### Search criteria

A - select all

  Press A to select all available messages.

! - not

  Press ! to logically reverse the following search criteria. Thus, if the entered search criteria was “Search the `From` header for `troll@example.com`” the actual search will find messages where the `From` header does NOT contain this text.

D - search by date

  A date-related search. Additional prompts follow, described below.

S - search by status

  A status-related search. Each message has several status flags that define whether the message is a new message, a deleted message, a replied message, and so on. Selecting a status search shows three options: “Deleted”, “Unread”, and “Replied”, to search for all deleted, unread, or replied messages, respectively.

T - search by text

  A text-based search, search for messages that contain (or don't contain) a given text string. Additional prompts follow, that further refine what kind of text to search for.

Z - search by size

  Search for messages that are bigger or smaller than a certain size. Select “Larger than” or “Smaller than” at the next prompt, then enter the target message size, in bytes, and press ENTER to search.

###### Date-based searches

A date-based search brings up additional prompts that specify the nature of the search. There are two dates that are associated with every message: the “sent” date, when the message was sent; and the “received” date, when the message was received.

The sent date is obtained from the message's `Date:` header. The received date is obtained from the mail server (or from the timestamp on the local mailbox).

The first prompt enters which date is searched for:

1. Messages that were sent before the given date.

2. Messages that were the sent on the given date.

3. Messages that were the sent since (on, or after) the given date.

4. Messages that were received before the given date.

5. Messages that were the received on the given date.

6. Messages that were the received since (on, or after) the given date.

The actual date is entered interactively. It starts with today's date. Press + or - to advance the shown date to the next or the following date. Press [ or ] to advance the shown date by a month. Press < or > to advance the shown date by a month. Press the space bar to accept the shown date, and search for messages.

### Note

Date-based searches are not currently implemented for NetNews newsgroups.

###### Text-based searches

Selecting a text-based search shows a wealth of options:

S - subject

  Search the contents of the `Subject:` header.

F - from

  Search the contents of the `From:` header.

T - to

  Search the contents of the `To:` header.

C - cc

  Search the contents of the `Cc:` header.

B - bcc

  Search the contents of the `Bcc:` header.

H - specific header

  Searches for the given text in some other header. The next prompt asks for the header's name.

O - contents

  Search the contents of the message for the given text.

A - anywhere

  Search the given text anywhere - headers or contents.

Enter the text to search for after selecting one of these options, and press ENTER to perform the search.

### Note

Efficient searching is implemented for local mail, and IMAP/SMAP mailboxes only. NetNews servers' searching capabilities are very limited, and POP3 servers have no search facilities whatsoever. In all cases, searching for message status flags is supported, since message status flags are always cached locally.

Only message headers of NetNews folders may be searched, and only English characters can be used as a search string. Some older NetNews servers may not have any searching ability whatsoever. Searching of message contents is not supported. Searching by message size, or message's date is not supported either.

Searching of POP3 folders is also not very efficient, although the search text is not limited to English characters only. POP3 folder search is accomplished by downloading the complete headers of each message, and searching it manually. Downloaded headers are not cached. The headers are also downloaded when searching by message's date. Searching by message size, or message's date is not supported for POP3 folders.

##### Watching Threads

Pressing A displays the following prompt: “Watch thread up to `A` days, `B`-deep replies? (Y/N).” The initial values for `A` and `B` are taken from the setup screen. Press D or R to adjust the defaults, if desired.

Answering the prompt with Y will “watch” the currently highlighted message, and any new replies to it. The highlighted message's subject will be shown with a highly-visible “`≡`” character (or the “o” character on some terminals). New replies to the watched message will also be automatically marked in the same fashion.

### Note

Any existing replies to the watched message are not automatically marked. Only future replies to the message will be automatically marked for watching.

Thread-watching is mostly useful with large NetNews newsgroups. A single, watched, conversation thread can be easily identified even in a very active newsgroup; however thread-watching can also be used with regular mail folders (with some limitations as noted below).

NetNews threads are famous for quickly diverging off-topic, so Cone's thread-watching future quietly turns itself off, after a while. There's very little uses in continuing to monitor a thread that began talking about the merits of organic food, but then ended up becoming a heated discussion about psychological problems of the Hollywood elite.

The initial default settings will watch for replies for up to fourteen days, or five levels of follow-ups, whichever comes first. That meaning that a reply to a reply to a reply to a reply to a reply of a watched message will still be shown as part of a watched thread, but its own reply will not be. There is no limit on the number of watched replies to the initial message, or to any of the five subsequent levels of follow-ups, as long as they arrive within the time-enforced limit.

### Note

After coming back from a 15-day vacation, and opening a folder which used to have watched threads, none of the new messages will be marked for watching, even though they arrived before the 14-days were up. Well, you just had a nice 15-day vacation, why do you care about some stale flame war that started more than two weeks ago?

The last level of watched followups will be marked with a different character, a “`•`” (or “`*`” as shown by some terminals), instead of the “`≡`” character. This is a visual cue to evaluate whether this subthread is still worth following. If so, the message can be manually re-watched. Highlighting the message and choosing this option will “renew” the interest in this thread for another round of followups (however other branches of the original thread will still expire as usual, unless they are also renewed).

Selecting this option again on a message that's already being watched will prompt to turn off watching for more replies. The message will no longer appear watched, and any future replies to the message will not be watched.

### Note

Any existing replies that are watched will continue to be watched, even though the original message is no longer being watched.

###### Watching E-mail threads

Thread watching is designed primarily to be used with NetNews newsgroups. The mechanism by which replies are selected for watching is quick, and simple. NetNews messages typically carry robust threading metadata, and even if there's a NetNews hiccup, and messages come in out of order, all eligible replies should still be correctly selected for watching. There is a very small chance that a very severe NetNews disruption will result in a failure to catch watched replies. However, messages would probably come in so wildly out of sequence that the thread is not likely to remain readable even if all watched replies were properly tagged, whenever they arrive.

Thread watching is not limited to NetNews newsgroups. E-mail threads may also be selected for watching. However, E-mail messages tend to have far less threading metadata than their NetNews counterparts. A disruption in incoming E-mail is more likely to result in missed replies, than a NetNews disruption. However, E-mail disruptions, on average, tend to occur far less often than NetNews disruptions, so everything tends to come out even.

Additionally, many modern E-mail clients now include the same full threading metadata as NetNews clients (Cone always includes complete threading metadata with every outgoing message, NetNews or E-mail). This issue continues to be less and less relevant, as time goes on.

##### Checking for new mail

The semantics of checking for new mail varies slightly, depending on the mail account. With SMAP-based mail account, and with most IMAP mail accounts, new mail in the current folder is shown immediately. If messages in the folder are shown in the order they were added to the folder, new mail will naturally appear at the end of folder. If messages are shown in a different sorting order, new messages will be shown wherever they should appear in accordance with the current sort order. Most IMAP mail accounts show new mail as soon as it is received. Some IMAP mail accounts do not report new mail immediately after it is delivered to the mail folder (this depends on the IMAP server software). Cone checks for new mail at regular intervals, and new received messages will show up after the next check for new mail.

New mail delivered to a local mbox folder will usually be shown when Cone checks for new mail, at regularly-scheduled intervals. New mail delivered to a local maildir will also usually appear only after Cone checks for new mail. On most Linux and SGI systems, and on any other system that has the File Access Monitor daemon running, new mail will be reported immediately.

In all cases, move to the last message in the folder, and use the cursor down key to have Cone explicitly checks for new mail. New mail in a POP3 folder will only be shown after an explicit new mail check (Cone does not check for new mail in POP3 folders by itself).

> ### Note

> There's a bug in INN 2.5, which should be fixed in 2.5.3. The affected versions of INN are 2.5.0 through 2.5.2. Any new messages in NetNews newsgroups will come up with a blank sender and subject.

> Do not use the cursor down key to check for new messages in NetNews newsgroups, if the server is running the affected version of INN

In all cases, new mail will not be immediately shown after the folder index screen is closed. When the folder index screen is closed, the mail folder still remains “opened” until Cone opens another folder in the same mail account. Cone still regularly checks for new mail when the folder index screen is not being shown (except for POP3 accounts). New mail will be reported only when Cone checks for new mail, or when the folder index screen is reopened.

##### Concurrent changes to the current folder's contents

Most mail accounts allow the same folder to be opened by multiple applications. When Cone has a folder opened, another application might also have the same folder opened, and another application may be making changes to the folder, at the same time.

Generally speaking, new mail delivered to the folder, while it's opened by Cone, is one example of concurrent changes to the contents of the folder while it is opened. Other applications may make other kinds of changes to the folder's contents: changing a message's status (whether the message is unread, deleted, replied, tagged, and/or flagged); or removing a message from the folder. In general, changes by other applications are reported in the same manner that Cone reports new mail. If Cone reports new mail as soon as it is received, Cone will also report other kinds of changes to the folder's contents as soon as they occur. Otherwise, changes to the folder's contents are reported the next time Cone checks for new mail. An attempt to access a message that was removed by another application, but not yet reported, usually results in an error.

>
From nobody@localhost Wed Jul 1 08:46:56 2020 X-MailPP-UID: :1593593217-17069-33-sparky.zia.io From: Online Help Subject: Message View Screen Mime-Version: 1.0 Content-Type: text/html; charset=utf-8

## Message View Screen

Highlighting a message in the folder index screen and pressing ENTER displays the contents of the message. Cursor up/down keys, PgUp and PgDn scroll the message vertically.

#### Message View Screen

     INBOX: 30 of 42  (NEW)               CONE
           From: customer_service@domain.com
             To: jack@example.com
        Subject: bw1234567
     Message-ID: <1234567.1043529357882.JavaMail.cservice@entp.domain.com>
           Date: Sat, 25 Jan 2003 16:15:57 -0500
    ----------------------------------------------------------------------------
    As a valued customer, your needs are always our first priority. Thank you
    for contacting Domain.com regarding our customer communication efforts. We
    have processed your request to remove you from future communications. Please
    note that this may take up to 45 days to complete.

    Please understand that not all advertisements appearing on or delivered to
    your e-mail address, mobile phone, or device are authorized by Domain.com.
    You may resume the receipt of solicitations at anytime by visiting our Web
    site using the links provided above.

    For Domain.com customers:
    For Consumer Accounts, go to domain.com/privacy/consumer_opt.jhtml
    For Business Accounts, go to domain.com/privacy/business_opt.jhtml

     / Search        D Delete        H Full Hdrs     L Folder List   N Next
     B Blind Fwd     F Fwd           I Index         M Main Menu    ^O mOre

The following keys are available from this screen:

|

  This option is usually used as a rough mechanism for printing a message. It runs an external command, and supplies the formatted version of the message to the external command, as standard input. Pressing | prompts for the command to invoke, which defaults to “lpr”. The command is started, and the formatted version of the currently displayed message is provided to the external command on standard input.

/

  This option Prompts for search text, then searches the currently shown message for the first occurence of the entered text. The search begins starting with the first line shown on the screen. To search the entire message, make sure that the beginning of the message is shown on the screen.

B

  “Blindly” forward the current message. The message is resent without adding any additional comments, or changing the sender's name. Cone prompt for the recipient's name, or names, and send the messages without changing the message's headers in any way (additional headers may be added by the mail server, of course).

S

  Save the message's contents into a file. Pressing S prompts for a filename where the message's raw, unformatted contents are saved.

D

  Mark this message as deleted, then advance to the next message in the folder.

F

  Forwards the current message. Cone opens a screen where a new message may be written. The current message is either saved as an attachment to the new message, or is quoted in the new message's text (Cone prompts to choose one or the other before opening the new message screen).

F`n`

  Run the external command that's assigned to this function key. The external command receives a copy of the shown message on its standard input. An external command must be previously assigned to this function key on the Folder Index screen, where this is described in greater detail, in the “External commands” section.

H

  Toggle between displaying abbreviated mail headers, and all mail headers.

I or <

  Return to the folder index screen.

L

  This option closes the folder index screen, and returns to the folder listing screen.

M

  Pressing M closes this screen, and opens the “Main Menu” screen.

N

  Advance to the next message in the folder.

P

  Advance to the previous message in the folder.

R

  This option creates a reply to the current message. Cone may ask a few questions before creating a reply. Cone knows how to format replies in three different ways. Not every format reply is available with every message. No questions are asked when only one reply format is possible for the message. Cone asks when more than one reply format is available.

  Proper selection of a reply format is only possible when the main menu's setup screen is initialized with all applicable E-mail addresses. The available reply formats are:

  Reply to a mailing list

    If one or more of the recipients of the original message are mailing list addresses, the reply is addressed to the mailing list addresses only, ignoring any sender or carbon-copy addresses.

  Reply to all

    If the message is addressed to or from more than one address, excluding the user's address, the reply is addressed to all original senders and recipients, except for the user's address.

  Reply

    The reply is addressed to the sending party.

SPACE

  Show the next page, like PgDn. If the last page is already shown, advance to the next unread message in the folder.

Enter

  When Cone displays an HTML message with external links, and one or more links are visible, the cursor is turned on and placed on the first shown link. Cursor up/down keys advances the cursor to the previos/next HTML link, and Enter activates the link.

  ### Note

  Cone knows how process “mailto:”, “http:”, and “https:” URLs. See the cone(1) manual page for more information.

  Cone also tries to detect links in plain, non-HTML, mail. Cone's ability to correctly detect the start and the end of a link may not work 100% of the time with non-HTML mail.

  ### Note

  Many mailing lists add links to various administrative functions (such as unsubscribing or searching the list's archives) to the headers of the mailing list's messages. Press H to display full message headers and access those links.

T

  This options shows a list of E-mail addresses from the message, and offers a quick option to add the addresses to the addressbook.

U

  Remove the deleted mark from this message, then advance to the next message in the folder.

V

  This command opens the screen with a list of attachments to the current message. This is the “View Attachment” screen. It is a very simple screen: each attachment is listed, giving its MIME type (the type of the attachment), its approximate size, and the attachments's description, if provided.

  Plain text attachments may be viewed individually, by pressing ENTER. Press S to download and save the highlighted attachment. Use I to return to the folder index screen, L to return to the folder listing screen, and M to go back to the main menu screen.

  After downloading an attachment it may be optionally deleted, or removed from the message. Press D to delete the highlighted attachment. Pressing D does not delete the attachment immediately, it only marks the attachment for deletion. More than one attachment may be marked for deletion at the same time. Press X to permanently remove all attachments that are marked for deletion. Beforing pressing X, a marked attachment can be unmarked by pressing U. Once X is pressed all the deleted attachments are gone for good, and cannot be undeleted.

  ### Note

  Only messages in local mail folders, IMAP folders, and POP3 maildrop folders may have their attachments removed. Messages in POP3 folders and NetNews folders cannot have their attachments removed.

  When GnuPG is installed, highlighting an attachment that contains GPG/PGP keys and pressing ENTER imports the keys. Cone prompts for a confirmation, then runs GnuPG to import the attached keys. Some versions of Gnu require a special procedure for importing private keys. Cone's prompt has an explicit private key export option. With other versions of GnuPG this option doesn't matter. Selecting the default import option will import whatever keys were attached, public or private.

  When running in an X-terminal, highlighting an image attachment and pressing ENTER displays the image in a separate window. This is done by running either Gnome's eog, or KDE's kview image viewer. Cone's manual page contains instructions for installing hooks for viewing other kinds of attachments, or using a different image viewer.

W

  Pressing W opens the “Write Message” screen. This is the screen where a new message can be typed, and sent. Cone checks for any unfinished messages in the Draft folder, before opening this screen. If the Draft folder contains any messages, Cone offers an option to resume writing an unfinished message, instead of starting a new message. Cone automatically saves a backup copy of the current message being edited, at regular intervals, so that a backup copy can be recovered in the event that Cone is interrupted, or terminated, in a middle of editing a new message. If a backup copy exists, Cone announces the existence of an interrupted message, and prompts to resume writing the interrupted message. An interrupted message must be opened and either: sent, explicitly cancelled, or saved in the Draft folder; before another message can be written.

>
From nobody@localhost Wed Jul 1 08:46:56 2020 X-MailPP-UID: :1593593217-17069-34-sparky.zia.io From: Online Help Subject: Write Message Screen Mime-Version: 1.0 Content-Type: text/html; charset=utf-8

## Write Message Screen

Pressing W opens the “Write Message” screen. This is the screen where a new message can be typed, and sent. Cone checks for any unfinished messages in the Draft folder, before opening this screen. If the Draft folder contains any messages, Cone offers an option to resume writing an unfinished message, instead of starting a new message. Cone automatically saves a backup copy of the current message being edited, at regular intervals, so that a backup copy can be recovered in the event that Cone is interrupted, or terminated, in a middle of editing a new message. If a backup copy exists, Cone announces the existence of an interrupted message, and prompts to resume writing the interrupted message. An interrupted message must be opened and either: sent, explicitly cancelled, or saved in the Draft folder; before another message can be written.

#### Write Message Screen

     EDIT MESSAGE                         CONE
                 To: John Smith <jsmith@domain.com>
                 Cc:
            Subject: Re: Patch for filtering module
        Attachments:
    ----------------------------------------------------------------------------
    Jeff Williams writes:

    > This patch puts the user lookups into their own functions. Means that
    > the config files are only read if the user is not found be an earlier
    > lookup. It would also make it easier to add support to control the
    > type/order of lookups at runtime, rather than always looking for the
    > search modules in their built-in order.
    >
    > --
    > Regards,
    >
    > John Smith

    ^  Mark         ^F Full Hdrs    ^J Justify      ^P Postpone     ^S Search
    ^D Dict Spell   ^G Insert File  ^K Line Clear   ^R Srch/Rplce   ^O mOre

The following keys are available from this screen:

CTRL-SPACE, CTRL-W, CTRL-Y

  CTRL-SPACE marks the starting position of a range of text. To delete a block of text: move the cursor to the beginning of the block of text, press CTRL-SPACE, move the cursor to the end of text, press CTRL-W. To re-insert this text someplace else, move the cursor to the insertion point and press CTRL-Y (yank).

CTRL-C

  Cancel composition of the current message. Everything is thrown away, and this screen is closed.

CTRL-D

  Starts the spell checker (dictionary lookup). Text starting with the cursor position, and until the end of the message, is spell-checked. Words that are not found in the dictionary are highlighted, and the status line lists up to ten suggested replacement words. To replace the highlighted word with one of the suggestions, press the number corresponding to the suggested replacement, or: press I to ignore this occurence of the misspelled word; press A to ignore all occurencer of the misspelled word, press R to replace the misspelled word with a manually-entered replacement.

  Note: quoted text in replies (lines that begin with the “>” character), are not spell-checked.

CTRL-F

  Turn display of full headers on/off. Initially, only the “To:”, “Cc:”, and “Subject:” headers are shown. CTRL-F shows additional headers: “From:”, “Reply-To:”, “Bcc:”, and “Fcc:”.

  The “Fcc:” header specifies the folder where a copy of the message is saved, after it's sent. One of the defined “Sent Mail” special folders is listed in this header. Highlight this header with the cursor, and press ENTER to cycle through the list of available “Sent Mail” special folders.

CTRL-G

  This key (“get”) inserts a file into the current text document, at the current cursor position.

CTRL-J

  Re-justifies the current paragraph. Cone uses “lazy” word-wrapping. Cone word-wraps long lines when new text is being added; however when deleting text short lines are not re-wrapped. Pressing this key re-formats the current paragraph to the optimal line length, taking into account all previous editing.

  Cone will not re-justify quoted text in replies. Remove the leading quote characters, “>”, justify, then re-insert the quote characters, if necessary.

  Technical note: messages composed in Cone are marked as “flowed-text” MIME plain text. This format uses invisible trailing whitespace to tag paragraph breaks. Mail readers that support “flowed-text” format (of which Cone is one), are capable of automatically reformatting flowed text into a variable-width display. When composing new text, Cone automatically inserts the appropriate invisible whitespace characters, as needed. Extensive editing may inadvertently delete the flowed-text “watermarks”, resulting in a line, or two, not wrapping properly on the expected margin break. CTRL-J reformats the current paragraph, and makes sure that everything is in proper order, automatically restoring any deleted flowed-text trailing whitespace.

  Liberal use of CTRL-J during editing is highly encouraged. Not only does this make written text look good, it makes new text look extra-good, in modern mail clients that know how to read flowed-text formatted messages.

CTRL-K

  Delete text between the current cursor position, and the end of the line.

CTRL-S, CTRL-R

  Search for a text string starting at the current cursor position, or search and replace text.

CTRL-N

  Define a new macro. First, define a text range using CTRL-SPACE and cursor keys. With the text range highlighted, press CTRL-N, type in a short abbreviation, then press ENTER.

  The text range will be memorized, and from this point on, typing the abbreviation will automatically insert the memorized range.

  ### Note

  The abbreviation cannot contain spaces or tabs (the text range itself may contain anything, only the abbreviation cannot have spaces).

  The memorized text range is inserted verbatim, without reformatting. If memorized text is inserted in a middle of a line, it may be necessary to use CTRL-J to re-justify the text.

  If the keyboard has function keys, it is possible to press a function key instead of entering an abbreviation; and use the same function key to insert the memorized text.

  ### Note

  Not all function keys may be available in every situation. gnome-terminal, for example, appropriates F1 for its own online help pages; so F1 is not available to applications running in a gnome-terminal window.

  To re-define a macro, highlight another text range, press CTRL-N, then enter the same abbreviation, or press the same function key.

  Macros can be deleted from the main setup screen in Cone.

CTRL-T

  Highlight the “Attachments:” header and press CTRL-T to create an attachment by picking a file from an interactive dialog that shows all files in the current directory. Move the cursor to highlight a subdirectory, or the parent directory, and press ENTER to switch to a different directory. Highlight a file to read the file and attach it to the current message.

  The attachment filename may also be typed directly into the file selection dialog. The attachment filename, relative to the home directory, may also be typed directly into the “Attachments:” header, instead of pressing CTRL-T.

  On most systems it is possible to attach multiple files at the same time by entering a filename pattern, such as “*.txt” - which selects all files that end in “.txt”.

CTRL-U

  Runs an external editor application, to edit the contents of this message. An external editor must be previously configured by choosing the “Setup” selection from Cone's main menu.

CTRL-X

  When all is said and done, CTRL-X sends the message. One, final chance, is offered to cancel, and change one's mind. If the mail server supports Delivery Status Notifications, press D to select delivery notifications options. Where available, press E to encrypt the message, and/or press S to sign the message, using GnuPG.

  Encryption/signing options, if available, must be selected before setting any delivery status notification options.

>
From nobody@localhost Wed Jul 1 08:46:56 2020 X-MailPP-UID: :1593593217-17069-35-sparky.zia.io From: Online Help Subject: Setup Screen Mime-Version: 1.0 Content-Type: text/html; charset=utf-8

## Setup Screen

This screen is used to enter various configuration settings. After making any changes on this screen, highlight “SAVE” and press ENTER.

#### Setup Screen

     SETUP                                CONE

            Your E-mail addresses: _____________________________________
                                   [ sam@example.com ]

                                   [ Minimum rich text de-moronization ]

      Your mailing list addresses: _____________________________________
                                   [ announcements@domain.com ]
                                   [ sysadmin@domain.com ]
                                   [ everyone@domain.com ]
                                   [ testers-list@domain.com ]
                                   [ users@domain.com ]
                                   [ reports@domain.com ]
                                   [ webmail@domain.com ]

         Custom sent mail folders:
                                   [ Outbox ]

              Spelling dictionary: _____________________________________

     ^C Cancel
    DEL Delete address/folder

Use this screen to configure the following settings:

Your E-mail addresses

  This is a list of E-mail addresses that are recognized as the user's E-mail addresses. New replies are formatted accordingly. Add an E-mail address by typing it into a field, then pressing ENTER. Highlight an existing address with a cursor, and use DEL to remove it.

Your mailing list addresses

  This is a list of E-mail addresses that are recognized as mailing list addresses. New replies are formatted accordingly. Add an E-mail address by typing it into a field, then pressing ENTER. Highlight an existing address with a cursor, and use DEL to remove it.

Spelling dictionary

  Name of the dictionary used for spell checking. A blank setting uses the default configured system dictionary. Names of available dictionaries is system specific. Different systems will have different dictionaries installed.

Custom sent mail folders

  This is a list of currently-configured folders where copies of sent messages are automatically saved. Highlight an existing folder with a cursor, and use DEL to remove it. Add new folders from the Folder Listing screen.

New custom header

  This advanced option adds a new, editable, vanity or custom header to all new messages. The new header is displayed alongside the standard headers (`From`, `To`, `Subject`, and the rest). Names of vanity headers may only include English letters, digits, and “-”. After entering the header name choose whether the vanity header is always displayed on the “Write Messages” screen, or if it is hidden by default, and only shown with the full set of headers.

Outgoing SMTP server

  This setting specifies the name of the SMTP server used for sending mail. If not specified, Cone uses the local sendmail command.

SMTP SSL certificate (optional)

  This setting enables SMTP authentication using an SSL certificate. This setting appears with a button that reads “Use certificate”. The setting and the button appears only if at least one SSL certificate is already imported (see Certificates). Choosing this button pops up a dialog with a list of available certificates. Selecting a certificate from the list changes this button to read “Remove certificate”, and selecting it again removes the certificate selection. When using certificates, the SMTP userid, below, may be left blank. If provided, and the server does not support authentication using SSL certificates, the traditional userid/password authentication is an automatic fallback.

SMTP userid

  If this setting is provided, Cone will use authenticate via ESMTP with the specified SMTP server.

Do not send SMTP password in clear text

  If this setting is enabled, Cone will only authenticate via ESMTP if encrypted authentication is available. Cone will not authenticate if the SMTP server supports authentication, but only by sending the password in clear text.

Send mail via main acct (if available)

  This setting is only available if the primary mail account -- the first mail account listed on the folder listing screen -- uses the experimental SMAP protocol. If enabled, Cone lets the SMAP server take care of sending the message (which saves time since the message doesn't need to be transmitted a second time, using SMTP, after it is saved in the sent mail folder).

NetNews posting command

  This optional setting specifies a command for posting NetNews messages. If this setting is left empty, NetNews messages are sent directly to the server. This setting allows NetNews messages to be posted via some other mechanism; perhaps a `mail2news` gateway. Cone runs the command and provides the text of the NetNews message on standard input. Example: “sendmail mail2news@example.com” - runs sendmail to mail the message to <mail2news@example.com>.

  ### Note

  If set, all NetNews messages are posted by running this command.

CTRL-Z command

  Specifies the program to run when CTRL-Z (the suspend key) is pressed. If this setting is not empty, pressing CTRL-Z will run the indicated command instead of suspending Cone and going back to the shell prompt.

External Editor (^U)

  Specifies the program to run when CTRL-U is pressed while editing the message. The program receives the name of the temporary file with the message's contents. When the program terminates, the contents of the file are re-read.

  This setting allows any plain text editor to be used for editing messages, instead of Cone's builtin editor.

"Smart" keyboard shortcuts

  If this option is enabled, Cone's built-in editor will automatically replace certain combination of characters with a single character from an extended character set. For example, typing “1/2 ” verbatim (note the trailing space character), inserts the ½ character, instead. Same goes for “1/4 ”, and “3/4 ”.

  Other available shortcuts (depending on the display terminal's capabilities) are:

  - Two apostrophes, or two backticks, are replaced by “smart quotes”.

  - (C), (R), and [tm].

  - +/-, <-, ->, and <-> (replaced by the mathematical +/- character, and various horizontal arrows, respectively).

  - The three character sequence `[space]*[space]` is replaced by the • symbol (a black bullet).

  - Three consecutive periods are replaced by a single “…” character.

  - Two consecutive typed hyphens are replaced by a single “–” (`EN DASH`) character, and three consecutive hyphens are replaced by a single “—” (`EM DASH`) character, when there's a space before and after the dashes. Cone manually displays `EN DASH` as a double-dash, and an `EM DASH` as a triple-dash, even though the terminal console font uses a single-width horizontal line for both. Also, Cone uses a modified Unicode linebreaking algorithm that disallows linebreaks before and after EN or EM dashes. Cone expects EN and EM dashes preceded and followed by spaces, and justifies typed text accordingly.

'Q' quits without prompting

  If this option is enabled, pressing Q terminates Cone without a confirmation request.

Autosave (minutes)

  Specifies the frequency, in minutes, of automatic backups when writing a new message.

Extra GnuPG encrypt/sign options

  Extra options passed to GnuPG when signing or encrypting a message. See “Encryption And Signatures”.

Extra GnuPG decrypt/verify options

  Extra options passed to GnuPG when decrypting or checking a message's signature. See “Encryption And Signatures”.

Tag names

  Specifies names of custom tags that may be used to label messages. These are arbitrary labels that are shown as different background colors on the folder index screen. Press ENTER to cycle through the list of available colors (only applicable with color-capable terminal displays). See “Folder Index” for more information.

  ### Note

  The default names of the first five tags will be the same as the message labels used by Mozilla's mail client. With most IMAP servers, Mozilla and Cone will see messages tagged/labeled by each other (although Cone may not actually use the same colors as Mozilla, since they depend on the display terminal's colors).

Colors

  The next group of fields set the shown colors for other display elements.

Turn off remote configuration

  Disables remote configuration. See “Remote Configuration” for more information on remote configuration.

Currently defined macros

  This is a list of all currently defined macros. See “Write Message Screen” for more information. To remove a macro, highlight it with the cursor and press DEL. New macros are defined on the Write Message Screen. To re-define an existing macro just follow the same procedure as for defining a new macro, and enter the same macro name (or a function key).

>
From nobody@localhost Wed Jul 1 08:46:56 2020 X-MailPP-UID: :1593593217-17069-36-sparky.zia.io From: Online Help Subject: New Account Mime-Version: 1.0 Content-Type: text/html; charset=utf-8

## New Account

The “New Account” option off the Main Menu adds a new account to the Folder Listing screen. Selecting this option results in a prompt to select the mail account type:

I

  Adds an IMAP, or an SMAP account.

P

  Adds a POP3 account.

M

  Adds a “POP3 maildrop” account. With the regular POP3 account, the messages in the POP3 mailbox remain on the server, and Cone reads the contents of the messages on as-needed basis. With a POP3 maildrop account, all messages from the POP3 mailbox are immediately downloaded, then removed from the POP3 mailbox. Each time new mail is found, the new messages are downloaded, then removed from the server.

  Some very old POP3 servers may only work in POP3 maildrop mode with Cone; they do not implement the “UIDL” POP3 protocol command which is necessary in order to keep the messages stored on the POP3 server. If an attempt to create a regular POP3 account fails because the server does not implement the “UIDL” command, create a POP3 maildrop account instead.

N

  Adds a NetNews (Usenet) newsgroup account.

S

  Creates a local mail account that includes the default system mailbox. On system that use maildirs, this option sets up a mail account for `$HOME/Maildir`, the maildir where incoming mail is delivered by default.

  On systems that do not use maildirs, this option finds the local mailbox file in `/var/spool/mail`, or the location specified by the `MAIL` environment variable. Cone also prompts for the name of a directory where mail folders should be created, relative to the home directory.

  In all cases, Cone also asks for the account's name, which goes on the Folder Listing screen.

O

  Creates an extra mail account for local mail that's not tied to the default system maildirs. Cone prompts for the name of a directory where mail folders should be stored, then the account's name, which goes on the Folder Listing screen.

Selecting the option to create a new IMAP, POP3, or NetNews account displays the following screen. This screen also comes up after choosing to edit an existing IMAP/POP3/News account, from the Folder Listing screen:

#### New/Edit Account Screen

     ADD ACCOUNT                          CONE

                                    Add IMAP Account

                    Account name: ______________________________________
                          Server: ______________________________________
                           Login: ______________________________________
                        Password: ______________________________________

                                  [ ] Do not send password in clear text

                                  [ ] Use an encrypted connection

                                  [ Use certificate ]

                                  [ LOGIN ]

                                  [ CANCEL ]

When editing an existing account, the following fields will be initialized to contain the current account setting. When adding a new account, the following fields will be blank:

Account name

  The name of the account, as shown on the Folder Listing screen.

Server

  The name of the mail server. Optionally, add a colon, “:”, and a decimal port number to specify a non-default port.

Login

  The account's login ID. Leave this field blank for NetNews servers that do not require passwords.

Password

  The login password. Leave this field blank for NetNews servers that do not require passwords.

Do not send password in clear text

  If enabled, this setting prevents the password from being sent in the clear over the network. The mail server must be able to support secure password authentication, where the password is transmitted in an encrypted or scrambled form.

  This field is not yet implemented for NetNews accounts.

Use an encrypted connection

  Select this option to enable encryption.

Use certificate

  This button enables authentication using an SSL certificate. This button appears only if at least one SSL certificate is already imported (see Certificates). Choosing this button pops up a dialog with a list of available certificates. Selecting a certificate from the list changes this button to read “Remove certificate”, and selecting it again removes the certificate selection. When using certificates, the login and the password fields may be left blank. If provided, and the server does not support authentication using SSL certificates, the traditional userid/password authentication is an automatic fallback.

  ### Note

  SSL certificate authentication is implemented with IMAP and POP3 accounts only. It is not implemented for News accounts.

[ LOGIN ]

  Highlight this button, and press ENTER to open the mail account.

[ CANCEL ]

  Close this screen without adding or changing the account.

##### Options

The server's name may be followed by one or more options of the following options, each one preceded with a slash:

`/imap`

  Use IMAP only, do not use SMAP. SMAP is an experimental protocol, currently implemented in the Courier mail server that offers some additional bells and whistles over IMAP. A mail account on Courier is set up as a normal IMAP account; after connecting Cone would normally select and use SMAP automatically. This option disables SMAP, and falls back to the IMAP protocol.

`/nossl`

  Disable encryption. Many mail servers have the ability to upgrade a plain text login to an encrypted connection. Even if “Use an encrypted connection” is not selected, Cone will upgrade an unencrypted connection to an encrypted connection, if the mail server supports this capability. This option disables the upgrade, and is mostly useful for debugging.

`/novalidate-cert`

  Do not validate the server's SSL certificate when using an encrypted connection. Normally the mail server's SSL certificate must be validate when using an encrypted connection. The certificate's name must match the server's name, and the certificate must be signed by a trusted certificate authority.

  The encrypted connection normally fails if the certificate cannot be validate. Validation requires that a list of trusted certificate authorities must be known and configured. It's simply impossible to know which certificate authorities are valid without an explicit list of valid, known, trusted, certificate authorities. If a trusted authority list is not configured, no certificate can be validated. If the server's certificate is a self-signed certificate (this is often used for testing purposes), or if it's not signed by a known authority, the encrypted connection fails.

  This `/novalidate-cert` option disables certificate validation. The encrypted connection will be established even if the server's certificate would otherwise be rejected.

  ### Note

  This option is applicable even when an encrypted IMAP or POP3 connection is not explicitly requested. Many mail servers are capable of automatically upgrading unencrypted connections to a fully-encrypted connection. If a mail server claims to be able to use encryption, then there's no reason not to use it. The result is that all encryption certification requirements still apply even when encryption is not explicitly requested.

`/debugio`

  This debugging option logs network traffic for this account to the standard error stream. Used for debugging only, when standard error is redirected to a file.

`/timeout=``N`

  Close the connection if the IMAP/SMAP, POP3, or NNTP server does not respond to a command in `N` seconds (default: 60).

`/noop=``N`

  Check for new messages in the currently open IMAP/SMAP folder every `N` seconds (default: 600).

  ### Note

  Most IMAP servers implement a protocol extension that reports new messages (and other changes to the folder's contents) immediately, without waiting for an explicit request to check for new mail.

  This option is also used by POP3 folders, where it defaults to 60 seconds. POP3 does not provide for new mail notification; the option's only purpose is to prevent the POP3 server from disconnecting due to inactivity.

`/autologout=``N`

  Automatically close an NNTP connection after `N` seconds of inactivty (default: 300). The connection will be automatically reestablished, when necessary.

>
From nobody@localhost Wed Jul 1 08:46:56 2020 X-MailPP-UID: :1593593217-17069-37-sparky.zia.io From: Online Help Subject: Remote Configuration Mime-Version: 1.0 Content-Type: text/html; charset=utf-8

## Remote Configuration

This is an advanced feature. When “Remote Configuration” is enabled, an IMAP or an SMAP folder on a remote folder keeps a copy of Cone's configuration. This allows Cone's configuration to be accessed from multiple systems. An otherwise empty IMAP/SMAP folder must be reserved for this purpose. Highlight the folder with the cursor on the folder listing screen, then press U then R.

Answer N to the “Import remote configuration” question, and Cone will save its configuration to the remote folder, and automatically update the saved configuration, when needed.

Repeat the process by running Cone on another system, and answer Y to this question to import the previously saved configuration in this folder. Cone imports and reads the saved configuration, and will also automatically udpate the saved copy, when needed.

Although this feature allows the same configuration to be accessed from multiple locations, only one instance of Cone should be running at any given time and using the same remote configuration folder. Random errors will be reported if multiple instances of Cone try to open the same remote configuration folder, and the IMAP/SMAP server does not allow the same folder to be opened by two or more clients. Even if the server allows multiple access, Cone configuration will keep getting overwritten by the other Cone's saved configuration, leading to unpredictable results.

#### Saved settings

Not all configuration information will be saved remotely. When remote configuration is enabled, the following configuration will be saved in the remote configuration folder:

- Location and login information for remote accounts (IMAP, POP3, SMTP, and NetNews). Location of local mail accounts is not saved. It doesn't make much sense to share location of local mailboxes between different systems.

- Customized headers, E-mail addresses, special folders, and folder sort order.

The following configuration information will not be saved remotely:

- Location of local mail accounts.

- Cached data, including newsgroup subscription information. The configuration and login information of NetNews accounts is saved remotely, however the available newsgroup list, subscription information, and list of read and unread articles is not saved. The `newsrc` configuration file, which contains all that, can be quite big, and its not feasible to save it remotely.

##### Disabling remote configuration

To disable remote configuration, open the setup screen from the main menu, highlight “Turn off remote configuration”, and press ENTER.

>
From nobody@localhost Wed Jul 1 08:46:56 2020 X-MailPP-UID: :1593593217-17069-38-sparky.zia.io From: Online Help Subject: Encryption And Signatures Mime-Version: 1.0 Content-Type: text/html; charset=utf-8

## Encryption And Signatures

Cone includes supports for encryption and digital signatures. GnuPG (http://www.gnupg.org) must be installed in order to use encryption and digital signatures.

### Note

Cone uses a newer MIME-based format for encrypted and signed messages. Cone does not recognize or use the older “inline-formatted” messages (this is where the text messages contain keywords like “BEGIN PGP SIGNED MESSAGE”).

#### MIME encryption and digital signatures

At this time Cone provides basic encryption, decryption, signature creation, and signature verification functionality. Key management (like creating and signing keys) must still be done with GnuPG.

##### Signing and encrypting messages

When GnuPG is installed, two additional options become available after pressing CTRL-X to send a message:

Sign

  Pressing S displays a list of all available secret keys. Highlight the key and press Enter to select a key for signing the message. The list of keys is shown at the bottom of the screen. The top of the screen shows additional information about the currently highlighted key.

Encrypt

  Pressing E displays a list of all known public keys. More than one public key may be selected. All public keys whose addresses match any recipient address, or the sender's address, are selected by default. The message is encrypted by all chosen public keys. Highlight each key and press SPACE to select a public key encryption. Press Enter after selecting all public keys. A checkmark (or an asterisk, depending on the console display) is placed next to each selected key. Press SPACE again in order to un-select a selected key.

The original prompt is updated accordingly, after selecting either of these two options (the original “Send message?” prompt changes to a “Sign, then send message?”, or some other appropriate variant). The key used for signing a message is memorized like any other custom message header, and is automatically selected by default when sending the next message. Choose “Sign” again to un-select the key. A separate default signing key exists for every account Cone is logged on to, and a default signing key is memorized for every open folder. It is possible to memorize a different key for signing replies to messages in different folders. However that may prove to be a bit cumbersome. Each time a message in a different folder is replied to, Cone will prompt whether to set that folder's key (or any other custom header) as the default for the entire mail account. This feature is probably convenient when most replies are to messages from the same folder, and messages from other folders are accessed infrequently.

### Note

The “Sign” and/or the “Encrypt” option must be used before selecting “Delivery notifications”. After selecting “Delivery notifications”, the only remaining options shown are the various delivery notifications options, and Y, which sends the message.

### Note

Copies of encrypted sent messages are saved in their encrypted form. Unless the sender's public key is also selected for encryption, the sender will not be able to read a copy of the sender's own message!

##### Passphrases

Cone supports passphrase-protected keys. Cone prompts for a passphrase before it signs a message. Press Enter without entering anything if the key does not have a passphrase.

Cone remembers the passphrase, and will not ask for it again. When a master single-signon password is installed (see “Master Passwords”), passphrase passwords are also saved together with all other account passwords. Cone does not automatically know when, and if, the key's passphrase is changed. When message signing fails, Cone automatically removes the saved passphrase. Simply try again to sign the same message, and Cone will prompt for the new passphrase.

##### Decrypting messages, and verifying signatures

Pressing Y (as in “decrYt”) attempts to decrypt or verify the signature of a currently opened message. The message must be opened before it can be decrypted. A signed message must also be opened, before its signature can be verified.

An encrypted message will initially be empty, naturally, except for a single attachment that contains the encrypted content. The contents of a signed message are displayed normally. The presence of an additional attachment, that contains the message's signature, indicates that the message is signed. After a message is succesfully decrypted, or its signature is verified, the message's contents are shown together with the diagnostic messages from GnuPG which contain additional information on the message's encryption status.

Forwarding or replying to a message always ends up forwarding or replying whatever's currently shown on the screen. If the message is decrypted, the decrypted contents are forwarded. If the message is not decrypted, its original encrypted version is forwarded.

##### Decrypting messages with a passphrase-protected key

Before decrypting a message, Cone prompts for a passphrase. The passphrase is memorized just like passphrases are memorized after a message is signed, and Cone will not ask for a passphrase again. Just like when signing, when a master single-signon password is installed, the passphrase is saved together with all other account passwords.

At this time, Cone is not smart enough to known which private key was used for encrypting a message. Therefore if multiple private keys are present, they all should have the same passphrase. Otherwise, each time an attempt is made to decrypt a message that's encrypted by different key, the attempt will fail because the wrong passphrase was memorized. Each time an attempt to decrypt a message fails, Cone automatically forgets the saved passphrase, so that the attempt to decrypt the message can be tried again, this time entering the correct passphrase (which will now be memorized and used as a default decrypting passphrase from now on).

>
From nobody@localhost Wed Jul 1 08:46:56 2020 X-MailPP-UID: :1593593217-17069-39-sparky.zia.io From: Online Help Subject: Master Passwords Mime-Version: 1.0 Content-Type: text/html; charset=utf-8

## Master Passwords

Passwords for remote mail accounts are not usually saved, and they must be entered every time when opening the account. The “Master Password” option on the main menu replaces all remote account passwords with a single master password. The master password must still be entered every time when starting Cone. However, all other remote mail account passwords are saved, and used automatically. The master password encrypts the file where remote mail account passwords are saved. The master password also encrypts imported SSL certificates (they are saved together with remote mail account passwords).

The master password may be changed at any time, by selecting this option from the main menu. Answering “Y” to “Remove master password?” deletes all saved passwords, and mail account passwords must, once again, be entered each time when opening remote mail accounts.

A master password cannot be recovered, once forgotten. The only available option is to remove the master password. All saved passwords will be lost.

>
From nobody@localhost Wed Jul 1 08:46:56 2020 X-MailPP-UID: :1593593217-17069-40-sparky.zia.io From: Online Help Subject: Certificates Mime-Version: 1.0 Content-Type: text/html; charset=utf-8

## Certificates

Cone can use SSL certificate authentication, in lieu of a userid and a password, for logging into a POP3 or an IMAP mailbox, or for sending mail using authenticated SMTP, if this functionality is supported by the server.

A master password must be set up before installing SSL certificates. See Master Passwords. Setting up SSL certificates is a two-step process. First, the SSL certificte must be imported into Cone. Then, the mail account is configured to use SSL certificate authentication.

Pressing C from the main menu opens the certificate import screen. Press I to import a certificate, then choose the filename using the following dialogs.

The file with the SSL certificate must be a PEM-formatted certificate file that holds both the certificate and the corresponding key. The file should have a “`BEGIN CERTIFICATE`” section followed by a “`BEGIN RSA PRIVATE KEY`” section (or a “`BEGIN DH PRIVATE KEY`” section). Passphrase-protected keys are not supported by Cone. If the SSL certificate is signed by an intermediate certificate authority, the authority's certificate should follow the private key section.

The certificate screen shows a list of all imported certificates. A default name is initially given to an imported certificate, based on its subject. Press R to rename a certificate. Press D to delete a certificate.

Importing at least one certificate activates an account option for choosing an SSL certificate. The new button appears on the New Account (and the Edit Account) screen. The button also appears on the main Setup screen, below the SMTP server's name. Choosing the button pops up a list of imported SSL certificates to choose from.

#### Renewing SSL certificates

An additional prompt is issued when importing a certificate with a name matching the name of one of the existing certificates. Confirm the prompt to replace the existing certificate with the new one. All accounts that use that certificate for authenticating are automatically updated.

To effectively renew a certificate in this manner, the new certificate's name must match the name of an existing certificate, exactly.

>
From nobody@localhost Wed Jul 1 08:46:56 2020 X-MailPP-UID: :1593593217-17069-41-sparky.zia.io From: Online Help Subject: Encryption Menu Mime-Version: 1.0 Content-Type: text/html; charset=utf-8

## Encryption Menu

Choosing “Encryption Menu” from Cone's main menu (which is available if GnuPG is installed) opens a menu with the following selections:

New encryption key

  This selection creates a pair of public and private keys, which may be used for signing and encryption. Fill in the fields on the next screen with the appropriate information: the name, the E-mail address, and the comment associated with the keypair; how big the encryption keys should be (a different length may be chosen for creating signed content, and for creating encrypted content); whether the keys have an expiration date; and the passphrase, or a password, for the private key. The passphrase must be entered twice, in both fields, and both fields must match. Leave both passphrase fields empty to create a private key without a passphrase.

Delete key

  This selection deletes an existing key. Public and private keys are deleted separately. All installed keys are displayed in a vertical list. Highlight a key with the cursor, and press ENTER to delete it.

  The top half of the screen shows detailed information about the current key that's highlighted by the cursor. Due to limited amount of available space, keys with more than one signatures may not have all signatures shown.

Sign key

  This selection signs an existing public key with one of the private keys. The public key, and the private key are selected one at a time. All installed keys are displayed in a vertical list. Highlight a key with the cursor, and press ENTER to select it.

  The top half of the screen shows detailed information about the current key that's highlighted by the cursor. Due to limited amount of available space, keys with more than one signatures may not have all signatures shown.

  After selecting the public key, and then the private key, the last prompt asks for the signature's trust level, which is used by GnuPG to calculate the key's trustworthiness.

Edit key

  This last selection provides a convenient means for accessing advanced key management features through the GnuPG application which are not directly implemented in Cone. Selecting “Edit key” shows a list of all available keys. Highlight an available key with the cursor, and press ENTER. Cone then runs GnuPG and opens GnuPG key management menu that provides access to additional key management features, such as advanced signature and passphrase management. After GnuPG exits Cone resumes running automatically.

  ### Note

  Cone does not run while GnuPG is running, and it waits for GnuPG to finish before resuming. If GnuPG runs for an extended period of time, Cone's connections to remote mail server may be terminated due to inactivity.

>
From nobody@localhost Wed Jul 1 08:46:56 2020 X-MailPP-UID: :1593593217-17069-42-sparky.zia.io From: Online Help Subject: Mail Filters Mime-Version: 1.0 Content-Type: text/html; charset=utf-8

## Mail Filters

This is a simple, automatic mail processing function. In this context, “mail filtering” means the ability to move, automatically delete, or automatically flag all messages that match a specific search criteria.

Where possible, it is always more efficient to have the mail server filter messages, instead of a mail client like Cone. Cone mail filters may prove to be sufficient if the mail server does not mail filtering abilities. In situations where the mail server is capable of filtering, the mail server's filters will usually be faster and more efficient.

Mail filters may be used with any IMAP, SMAP, or a local mail account. Mail filters may also be used with POP3 accounts, but they'll be slow, and they'll have certain limitations. Cone will have to download a copy of every message in the POP3 mailbox, in order to check it against the searching criteria, for every mail filter search. This is not needed with IMAP/SMAP accounts, where the search request is processed by the mail server.

Mail filters may also be used in limited ways with Usenet newsgroups. Only limited forms of searching are available: only Usenet message headers may be searched, and the searching criteria may only include English characters. All other search requests can only be met by downloading a copy of every message from the newsgroup, which is not going to work very well, for obvious reasons.

The best use for mail filters with a Usenet newsgroup is as a simple killfile: “Search From: contains troll@example.com”, followed by “Delete and Expunge”.

A mail filter may be installed for any folder. Each folder has its own mail filters. The folder's mail filter is automatically processed by Cone whenever:

- The folder is opened for the first time, or reopened after another folder was opened.

- New messages are added to the folder.

All messages in the folder are processed by the mail filters when the folder is opened. When new messages are added to the folder, only the new messages will be processed by the mail filters. Existing messages will be ignored.

#### Mail Filter Entry Screen

    INBOX - FILTERS                      CONE

      Current Filters:

        Search Subject: contains RFC
        Move to internet-drafts
        Search From: contains boss@domain.com
        Mark
        [ Add new filter ]

        [ Save Filters ]

     ^C Cancel     DEL Delete
     ^D Move down   ^U Move up

This screen is accessed by highlighting a folder on the Folder Listing screen, then pressing F. Each mail filter consists of one or more “steps”. There are two kinds of steps: a “select” step compiles a list of messages that match a certain search criteria; the selection step is followed by one or more steps that apply a particular “action” against all messages that were selected. More than one action step may follow a selection step; messages are processed by each action step in sequence, until another selection step, which searches the remaining messages again, and compiles a different list of selected messages.

Some actions cannot be naturally followed by any other action, and can only be followed by another selection step. Consider, for example, “Delete And Expunge” or “Move to another folder” filtering step: at the conclusion the selected messages are obviously removed, and nothing else can be done with them, any more.

This screen initially shows any existing filtering steps defined for the folder. All filtering steps are processed in the order shown. Highlighting an existing filtering step and pressing CTRL-U, or CTRL-D, moves the filtering step higher or lower, thus changing its relative order in the mail filter. DEL removes the existing filtering step. The folder's mail filter is removed by highlighting each step and pressing DEL, then highlighting “Save Filters” and pressing ENTER.

All changes made on this screen are temporary. “Save Filters” must be selected in order for any changes made on this screen to take effect. CTRL-C closes this screen without changing the folder's existing filter, throwing out all the temporary changes.

Highlighting “Add new filter” and pressing ENTER adds a new filtering step to the end of the mail filter. A sub-menu is shown to define the new filtering step:

S - select

  Enters a new searching criteria which will be used to select messages for the following action steps. See “Search criteria”, below, for more information.

D - mark deleted

  Marks all selected messages as deleted. The messages are not removed from the folder, but only marked as deleted.

U - unmark deleted

  Removes the “deleted” mark from the selected messages. The selected messages are no longer marked as deleted.

X - delete and expunge

  The selected messages are removed from the folder.

R - mark each message as tagged

  Marks, or highlights the selected messages on the folder index screen. Tagged messages are shown as highlighted on the folder index screen, preceded by “`*`”. On some displays, tagged messages are flagged by a checkmark symbol instead of the “`*`”.

K - unmark, or untag the messages

  Removes the highlighting mark from the selected messages.

W - watch thread

  Watch the selected message's replies/subthreads (unless the message is already a part of a watched thread). See “Watching Threads” in the “Folder Index” chapter for more information on thread watching.

A - unwatch thread

  Stops watching the message, and its replies/subthreads.

M - move messages

  Move the selected messages to another folder. Selecting this option reopens the folder index screen. Highlight the folder where the messages can be moved to, and press ENTER.

  ### Note

  Messages can be moved only to folders in the same mail account. Messages cannot be moved to a folder in another mail account.

  This means that this option is not available with POP3 accounts, which naturally have only one folder.

C - copy messages

  Copies the selected messages to another folder. This is very similar to the move command, except copies of the selected messages remain in the original folder.

  ### Note

  This mail filter will be processed every time a folder is opened. Therefore, the selected messages will be copied to another folder every time this folder is opened. This Copy filtering step should be followed by another filtering step, such as Move, or Delete/Expunge, that removes all selected messages. Otherwise the results could be quite amusing

##### Search criteria

A - select all

  Press A to select all available messages.

! - not

  Press ! to logically reverse the following search criteria. Thus, if the entered search criteria was “Search the `From` header for `troll@example.com`” the actual search will find messages where the `From` header does NOT contain this text.

D - search by date

  A date-related search. Additional prompts follow, described below.

S - search by status

  A status-related search. Each message has several status flags that define whether the message is a new message, a deleted message, a replied message, and so on. Selecting a status search shows three options: “Deleted”, “Unread”, and “Replied”, to search for all deleted, unread, or replied messages, respectively.

T - search by text

  A text-based search, search for messages that contain (or don't contain) a given text string. Additional prompts follow, that further refine what kind of text to search for.

Z - search by size

  Search for messages that are bigger or smaller than a certain size. Select “Larger than” or “Smaller than” at the next prompt, then enter the target message size, in bytes, and press ENTER to search.

###### Date-based searches

A date-based search brings up additional prompts that specify the nature of the search. There are two dates that are associated with every message: the “sent” date, when the message was sent; and the “received” date, when the message was received.

The sent date is obtained from the message's `Date:` header. The received date is obtained from the mail server (or from the timestamp on the local mailbox).

The first prompt enters which date is searched for:

1. Messages that were sent before the given date.

2. Messages that were the sent on the given date.

3. Messages that were the sent since (on, or after) the given date.

4. Messages that were received before the given date.

5. Messages that were the received on the given date.

6. Messages that were the received since (on, or after) the given date.

The actual date is entered interactively. It starts with today's date. Press + or - to advance the shown date to the next or the following date. Press [ or ] to advance the shown date by a month. Press < or > to advance the shown date by a month. Press the space bar to accept the shown date, and search for messages.

### Note

Date-based searches are not currently implemented for NetNews newsgroups.

###### Text-based searches

Selecting a text-based search shows a wealth of options:

S - subject

  Search the contents of the `Subject:` header.

F - from

  Search the contents of the `From:` header.

T - to

  Search the contents of the `To:` header.

C - cc

  Search the contents of the `Cc:` header.

B - bcc

  Search the contents of the `Bcc:` header.

H - specific header

  Searches for the given text in some other header. The next prompt asks for the header's name.

O - contents

  Search the contents of the message for the given text.

A - anywhere

  Search the given text anywhere - headers or contents.

Enter the text to search for after selecting one of these options, and press ENTER to perform the search.

### Note

Efficient searching is implemented for local mail, and IMAP/SMAP mailboxes only. NetNews servers' searching capabilities are very limited, and POP3 servers have no search facilities whatsoever. In all cases, searching for message status flags is supported, since message status flags are always cached locally.

Only message headers of NetNews folders may be searched, and only English characters can be used as a search string. Some older NetNews servers may not have any searching ability whatsoever. Searching of message contents is not supported. Searching by message size, or message's date is not supported either.

Searching of POP3 folders is also not very efficient, although the search text is not limited to English characters only. POP3 folder search is accomplished by downloading the complete headers of each message, and searching it manually. Downloaded headers are not cached. The headers are also downloaded when searching by message's date. Searching by message size, or message's date is not supported for POP3 folders.

>
From nobody@localhost Wed Jul 1 08:46:56 2020 X-MailPP-UID: :1593593217-17069-43-sparky.zia.io From: Online Help Subject: Address Book Mime-Version: 1.0 Content-Type: text/html; charset=utf-8

## Address Book

When writing a new message, Cone looks up addresses in the defined address books automatically. The “Address Book” option off the Main Menu accesses various address book-related maintenance functions.

The “Address Book” option first lists all defined address books. Normally there's only one: “Local Address Book” - a simple, private, address book maintained by Cone.

Cone can use a folder on a remote IMAP or SMAP server as an address book, permitting the address book to be shared between multiple account. When compiled with LDAP support, Cone can also use an LDAP server-based address book.

All known address book are listed on this screen. Press A to add a new LDAP server-based address book (IMAP and SMAP server-based address books are added directly from the “Folder Listing” screen, by highlighting the IMAP or SMAP folder, then pressing Use Aaddressbook). Highlighting the name of the address book, and hitting Enter displays all the entries in the address book (except for LDAP address books, which cannot be browsed or modified).

A

  Manually add an entry to the address book.

D

  Delete the address book entry.

E

  Export the contents of the address book to a file. See below for more information.

I

  Import the contents of the address book from a file. See below for more information.

Enter

  Press Enter to edit the contents of an address book entry.

R

  Rename the address book entry (change the entry's nickname).

#### Import/Export address book

The contents of the address book can be imported or exported to a file. The address book is exported one address book entry per line:

nickname: "Name" <user@domain>

>
From nobody@localhost Wed Jul 1 08:46:57 2020 X-MailPP-UID: :1593593217-17069-44-sparky.zia.io From: Online Help Subject: LDAP Address Books Mime-Version: 1.0 Content-Type: text/html; charset=utf-8

## LDAP Address Books

Cone optionally supports searching LDAP directories for E-mail addresses. If this option is available, pressing A from the main Address Book screen displays the following screen:

#### Add LDAP Address Book screen

     LDAP ADDRESSBOOK ADD                 CONE

                                   Add LDAP directory

                             Directory name: ____________________
                       LDAP server hostname: ____________________
                           LDAP suffix/root: ____________________

                                             [ SAVE ]

                                             [ CANCEL ]

     L Folder List   Q Quit
     M Main Menu     W Write Msg

Directory name

  Enter a nickname of this LDAP-based address book. This address book appears under this name on the Address Book screen.

LDAP server hostname

  Enter the name of the machine that's running the LDAP server.

LDAP suffix/root

  This setting specifies the suffix, or the root node, of the LDAP E-mail directory, such as "`dc=example, dc=com`", and depends on how the LDAP directory is configured. Contact the LDAP server administrator to get the correct LDAP suffix/root setting.

The directory and the server hostname are required, the LDAP root/suffix is optional (depending on the LDAP server's configuration). Highlight “Save” and press Enter to add this LDAP server to the list of address books that are automatically looked up, or “Cancel” to abort.

>