Apple-2-SW/emailler
1
0
Fork 0
mirror of https://github.com/bobbimanners/emailler.git synced 2024-06-24 11:29:30 +00:00
Code Issues Projects Releases Wiki Activity

Docs

Browse Source
This commit is contained in:
Bobbi Webber-Manners 2020-10-29 18:32:23 -04:00
parent d71f0988ee
commit 33fb31353c
5 changed files with 19 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
README-emailler.md
View File

@ -60,9 +60,11 @@ The minimum system requirements are as follows:
- Uthernet-II ethernet card
- Mass storage device such as CFFA3000, MicroDrive/Turbo or BOOTI
A CPU accelerator is recommended if you plan to handle large volumes of email or Usenet messages.
Recommended optional hardware:
If using an Apple //e, a real time clock such as No Slot Clock (NSC) or Thunderclock is recommended. The Apple IIgs has a built in real time clock. If no RTC is available, `DATE65.SYSTEM` may be used to set the ProDOS date and time.
- A CPU accelerator is recommended if you plan to handle large volumes of email or Usenet messages.
- If using an Apple //e, a real time clock such as No Slot Clock (NSC) or Thunderclock is recommended. The Apple IIgs has a built in real time clock. If no RTC is available, `DATE65.SYSTEM` may be used to set the ProDOS date and time.
- If using an Apple //e, adding a RamWorks style memory expansion will allow `EDIT.SYSTEM` to open many files simultaneously and also to handle very large files. Without the RamWorks expansion, `EDIT.SYSTEM` can handle a maximum file size of around 46KB.
emai//er has been extensively tested using ProDOS 2.4.2. However, it should not be a problem to run it under other versions of ProDOS.

2
README-pop65.md
View File

@ -12,7 +12,7 @@
POP65 is a Post Office Protocol v3 (POP3) client for the Apple II. It requires an Uthernet-II ethernet card and will not work with other interfaces without modification, because it uses the W5100 hardware TCP/IP stack. POP65 is used to download new email messages from a POP3 email server. (I use Dovecot on the Raspberry Pi as my POP3 server, but other POP3 servers should work too.)
Before running `POP65.SYSTEM` for the first time, be sure you have created the email root directory and the `SPOOL` directory, as described above. POP3 will initialize the `INBOX` mailbox, creating `NEXT.EMAIL` and `EMAIL.DB` files if they do not exist.
Before running `POP65.SYSTEM` for the first time, be sure you have created the email root directory and the `SPOOL` directory, as described [here](README-emailler-setup.md). POP3 will initialize the `INBOX` mailbox, creating `NEXT.EMAIL` and `EMAIL.DB` files if they do not exist.
POP65 runs without any user interaction and performs the following tasks:

2
README-smtp65.md
View File

@ -12,7 +12,7 @@
SMTP65 is a Simple Mail Transport Protocol (SMTP65) client for the Apple II. It requires an Uthernet-II ethernet card and will not work with other interfaces without modification, because it uses the W5100 hardware TCP/IP stack. POP65 is used to send outgoing email messages to an SMTP email server. (I use Postfix on the Raspberry Pi as my SMTP server, but other SMTP servers should work too.)
Before running SMTP65 for the first time, be sure to have created the `SENT` mailbox. This must be a 'proper' mailbox, not just a directory. You may create a mailbox using the `N)ew` command in `EMAIL.SYSTEM`.
Before running SMTP65 for the first time, be sure to have created the `SENT` mailbox. This must be a 'proper' mailbox, not just a directory. You may create a mailbox using the `N` (new mailbox) command in `EMAIL.SYSTEM`.
SMTP65 performs the following tasks:

2
README-usenet-setup.md
View File

@ -77,7 +77,7 @@ You can create these directories in ProDOS `BASIC.SYSTEM` as follows:
You must set up a `NEWS.SENT` mailbox, otherwise `NNTP65UP.SYSTEM` will be unable to complete the sending of messages and will give an error. You will also need to create a mailbox for each newsgroup you wish to subscribe to. The name of the newsgroup mailboxes must match that given in `NEWSGROUPS.CFG` or `NNTP65.SYSTEM` will give an error when downloading news articles.
To create these mailboxes, run `EMAIL.SYSTEM` and press `N` for N)ew mailbox. At the prompt, enter the name of the mailbox to be created: `NEWS.SENT`, and press return. Repeat this to create a mailbox for each newsgroup you are subscribed to (matching the values in the `NEWSGROUPS.CFG` file.)
To create these mailboxes, run `EMAIL.SYSTEM` and press `N` for new mailbox. At the prompt, enter the name of the mailbox to be created: `NEWS.SENT`, and press return. Repeat this to create a mailbox for each newsgroup you are subscribed to (matching the values in the `NEWSGROUPS.CFG` file.)
[Back to Main emai//er Docs](README-emailler.md#detailed-documentation-for-usenet-functions)

15
README-usenet-subscribe.md
View File

@ -6,10 +6,19 @@
## Subscribing to a Newsgroup
Suppose you want to subscribe to newsgroup `comp.sys.pdp11`.
This section outlines the steps for subscribing to a newsgroup.
1) Add a new line to `/H1/DOCUMENTS/EMAIL/NEWSGROUPS.CFG` as follows: `alt.sys.pdp11 ASP11 0`
2) Run `EMAIL.SYSTEM` and using `N)ew` command to create mailbox `ASP11`, matching the line in `NEWSGROUPS.CFG`. You may use any name you choose.
For example, suppose you want to subscribe to newsgroup `comp.sys.pdp11`.
1) The first step is to add a new line to `NEWSGROUPS.CFG` for the newgroup subscription. `NEWSGROUPS.CFG` is found in the email root directory (`/H1/DOCUMENTS/EMAIL` using the example settings.) Start `EDIT.SYSTEM` and use the `Open Apple`-`O` command to open the file `/H1/DOCUMENTS/EMAIL/NEWSGROUPS.CFG`.
2) Using `EDIT.SYSTEM` add a line to the file consisting of the newsgroup name, a space, the name of the mailbox you want to use to store messages, another space, and finally the digit zero. For example, we may decide to use mailbox name `ASP11` for this newsgroup:
```
alt.sys.pdp11 ASP11 0
```
3) Save the file with `Open Apple`-`S` and quit `EDIT.SYSTEM` with `Open Apple`-`Q`.
4) Run `EMAIL.SYSTEM` and use the `N` (new mailbox) command to create the mailbox your chose in step 2 above (`ASP11` in this case.)
3) Use the `Closed Apple`-`R` command to run `NNTP65.SYSTEM` and retreive messages from the newly-subscribed newsgroup.
When the 'last message' field of the newgroup is zero, `NNTP65.SYSTEM` will download the most recent 100 articles from the newsgroup. It will then set the most recent article counter in `NEWSGROUPS.CFG` so that subsequent runs will retrieve new messages only.