diff --git a/README-emailler.md b/README-emailler.md index 2ac9ea8..e5519b2 100644 --- a/README-emailler.md +++ b/README-emailler.md @@ -207,16 +207,6 @@ Main menu commands: By using the `Open Apple`+`R` command to retrieve messages and the `Open Apple`-`S` command to transmit messages to the server, it is possible to retreive, review, respond, compose and transmit messages all without leaving the `EMAIL.SYSTEM` environment. -#### Plain Text View `T)op` -

Email Pager

- -#### Headers View `H)drs` -

Email Pager

- -#### MIME View `M)IME` -

Email Pager -

- ### Mail Pager Pressing space or return will open the currently-selected message in the mail pager. The mail pager provides a comfortable interface for reading email, allowing rapid forwards and backwards paging through the email body. This is done by saving the formatted email text to a `SCROLLBACK` file in the email root directory. @@ -238,6 +228,32 @@ There are three separate viewing modes: Long lines are word-wrapped at 80 columns in all three views. +#### Plain Text View `T)op` + +Here the selected message is shown in plain text. This is the default view mode, when selecting a message from the email summary with `RET`. In this particular case, we can see that the email is encoded in *Quoted-Printable* format (the `=` signs at the end of each line are a give away). + +

Page 1 Plain Text

+ +Here is the next page of plain text. The *Quoted-Printable* formatting is even more obvious now: + +

Page 2 Plain Text

+ +#### MIME View `M)IME` + +Hitting the `M` key switches to MIME mode which will decode the *Quoted-Printable* text. If there are MIME attachements, MIME mode will offer to decode them and save them to file. + +

Page 1 MIME

+ +Here is the second page, decoded: + +

Page 2 MIME

+ +#### Headers View `H)drs` + +The third view mode is 'headers' mode which shows all email header fields. Hitting the `H` key shows the headers for this message: + +

Email Headers

+ ### MIME Support

Downloading Attachment

@@ -401,7 +417,37 @@ If you use this tool for bulk import, be sure that all the `EMAIL.nnn` files are ### Configuration File -... +The news configuration file is called `NEWS.CFG`. It is a straightforward ProDOS text file, with one parameter per line. You may edit this file using the provided editor, `EDIT.SYSTEM` (or any other ProDOS text editor). When editing the file be careful not to add or delete any lines - this file has no grammar and the lines *must* appear in the expected order. + +To edit the file using `EDIT.SYSTEM`: + + - Run `EDIT.SYSTEM` using Bitsy Bye or your usual ProDOS launcher. + - Press Open Apple-O to open a file, then enter `NEWS.CFG` at the prompt, followed by return. + - Editing is fairly intuitive. Use the arrow keys to move around and type to insert text. Open Apple-Delete deletes to the right. + - When you are satisfied, save the file using Open Apple-S. + - Quit the editor using Open Apple-Q. + +All three of the programs that handle news: `EMAIL.SYSTEM`, `NNTP65.SYSTEM` and `NNTP65UP.SYSTEM` share this configuration file. + +Here is an example config file (with passwords replaced with `****` for obvious reasons): + +``` +144.76.35.198:119 +Bobbi +**** +/H1/IP65 +/DATA/EMAIL +bobbi.8bit@gmail.com +``` + +The lines are as follows, in order: + + 1) IP address of the NNTP server, optionally followed by a colon and then the TCP port number. If the colon and port number are omitted, port 119 is the default. + 2) Username to use when connecting to NNTP. + 3) Password to use when connecting to NNTP. + 4) ProDOS path of the directory where the email executables are installed. + 5) ProDOS path to the root of the email folder tree. Mailboxes will be created and managed under this root path. + 6) Your email address. Used as the sender's address in outgoing messages. ### Creating Directories diff --git a/img/email-headers.png b/img/email-headers.png new file mode 100644 index 0000000..9fe1234 Binary files /dev/null and b/img/email-headers.png differ diff --git a/img/email-mime-1.png b/img/email-mime-1.png new file mode 100644 index 0000000..f7fbca8 Binary files /dev/null and b/img/email-mime-1.png differ diff --git a/img/email-mime-2.png b/img/email-mime-2.png new file mode 100644 index 0000000..c4c44e4 Binary files /dev/null and b/img/email-mime-2.png differ diff --git a/img/email-plain-1.png b/img/email-plain-1.png new file mode 100644 index 0000000..47e5cae Binary files /dev/null and b/img/email-plain-1.png differ diff --git a/img/email-plain-2.png b/img/email-plain-2.png new file mode 100644 index 0000000..24d0487 Binary files /dev/null and b/img/email-plain-2.png differ diff --git a/img/headers-view.png b/img/headers-view.png deleted file mode 100644 index fe8997c..0000000 Binary files a/img/headers-view.png and /dev/null differ diff --git a/img/mime-view.png b/img/mime-view.png deleted file mode 100644 index 8610c34..0000000 Binary files a/img/mime-view.png and /dev/null differ diff --git a/img/raw-text.png b/img/raw-text.png deleted file mode 100644 index 6546d4b..0000000 Binary files a/img/raw-text.png and /dev/null differ