From 82835c508d14e1a4a0d0a3781af43b7ad288bf8b Mon Sep 17 00:00:00 2001
From: Bobbi Webber-Manners <bobbi.manners@gmail.com>
Date: Sun, 13 Jun 2021 18:22:18 -0400
Subject: [PATCH] Updated docs to include PRINT65.

---
 README-print65.md | 43 +++++++++++++++++++++++++++++++++++++++++++
 README.md         |  2 ++
 2 files changed, 45 insertions(+)
 create mode 100644 README-print65.md

diff --git a/README-print65.md b/README-print65.md
new file mode 100644
index 0000000..904b709
--- /dev/null
+++ b/README-print65.md
@@ -0,0 +1,43 @@
+# Apple II Email and Usenet News Suite
+
+<p align="center"><img src="img/emailler-logo.png" alt="emai//er-logo" height="200px"></p>
+
+[Back to Main emai//er Docs](README.md#detailed-documentation-for-email-functions)
+
+## `PRINT65.SYSTEM`
+
+<!-- <p align="center"><img src="img/SMTP65.jpg" alt="SMTP65" height="400px"></p> -->
+
+`PRINT65.SYSTEM` is a utility for printing to a network-connected printer using the Hewlett Packard Jetdirect protocol.  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.
+
+Before running `PRINT65.SYSTEM` for the first time, use `EDIT.SYSTEM` to create a configuration file called `PRINT.CFG`.  This file consists of a single line specifying the IP address of the network printer to use, optionally followed by a colon and a port number.  If the port number is omitted it defaults to 9100.  For example:
+
+```
+192.168.10.4:9100
+```
+
+`PRINT65.SYSTEM` performs the following tasks:
+
+ - If no filename was provided on the command line, prompt for the filename to print
+ - Detect Uthernet-II
+ - Obtain IP address using DHCP
+ - Connect to Jetdirect printer
+ - Open file
+ - Send file contents to printer over TCP/IP
+ - Close file
+ - Disconnect
+
+### Using Command Line Argument to Specify the File to Print
+
+`PRINT65.SYSTEM` supports command line arguments in a way that is compatible with the Davex shell (and possibily other environments.)  In Davex you can print a file as follows:
+
+```
+print65.system /path/to/my/file
+```
+
+### HP Jetdirect
+
+Most HP printers support Jetdirect.  I am using an HP Photosmart 7520 which supports the Jetdirect protocol on port 9100 over it's wifi connection.  Jetdirect defaults to a simple plain text mode, which we exploit here to print in 80 column text mode.
+
+[Back to Main emai//er Docs](README.md#detailed-documentation-for-email-functions)
+
diff --git a/README.md b/README.md
index abf3a94..bc5ccb5 100644
--- a/README.md
+++ b/README.md
@@ -31,6 +31,7 @@ Emai//er is implemented as a number of ProDOS executables, each of which perform
  - `ATTACHER.SYSTEM` is used for creating multi-part MIME messages with attached files.
  - `REBUILD.SYSTEM` is a utility for rebuilding mailbox databases, should they become corrupted.  This can also be used for bulk import of messages.
  - `DATE65.SYSTEM` is a Network Time Protocol (NTP) client which can be used for setting the system time and date if you do not have a real time clock.
+ - `PRINT65.SYSTEM` allows text file to be printed to a network-attached printer that supports the Hewlett Packard Jetdirect protocol.
 
 The following diagram shows the various executables that form the emai//er suite and how they execute one another.  Note how `EMAIL.SYSTEM` serves as the hub from which all the other programs may be invoked.
 
@@ -105,6 +106,7 @@ Please refer to the linked documents for detailed instructions on how to configu
  - [Receiving Email with `POP65.SYSTEM`](README-pop65.md)
  - [Sending Email with `SMTP65.SYSTEM`](README-smtp65.md)
  - [Rebuilding Mailboxes with `REBUILD.SYSTEM`](README-rebuild.md)
+ - [Printing Files with `PRINT65.SYSTEM`](README-print65.md)
 
 ## Detailed Documentation for Usenet Functions