From 2a25921515a5736b40b2bb7096339a0e912328e6 Mon Sep 17 00:00:00 2001
From: Wayne Parham <wayne@parhamdata.com>
Date: Mon, 7 Jun 2021 20:00:18 -0500
Subject: [PATCH] Sym-1 documentation updates

---
 doc/sym1.sgml | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/doc/sym1.sgml b/doc/sym1.sgml
index 59d1db3b7..d2e5f09fd 100644
--- a/doc/sym1.sgml
+++ b/doc/sym1.sgml
@@ -21,11 +21,11 @@ Please note that Sym-1 specific functions are just mentioned here, they are desc
 
 <sect>Binary format<p>
 
-The standard binary output format generated by the linker for the Sym-1 target is a 4 kbyte machine language program.  It is, of course, possible to change this behavior by using one of the different linker configs.
+The output format generated by the linker for the Sym-1 target is a raw binary BIN file, which is essentially a memory image.  You can convert this to a HEX file using BIN2HEX, which is a popular open-source conversion utility program.  A HEX file has ASCII representations of the hexadecimal byte values of the machine-language program.
 
 <p>
 
-Included with this distribution is a 4k configuration file and a 32k config file.  The Sym-1 on-board memory is limited to 4k but system memory can be increased to 32 kbytes of contiguous RAM with aftermarket add-on boards.  So choose the config file that matches your system configuration before compiling and linking user programs.
+Included with this distribution is a 4k configuration file and a 32k config file.  The Sym-1 on-board memory is limited to 4 kbytes but system memory can be increased to 32 kbytes of contiguous RAM with aftermarket add-on boards.  So choose the config file that matches your system configuration before compiling and linking user programs.
 
 <sect>Memory layout<p>
 
@@ -41,8 +41,7 @@ Special locations:
   The C runtime stack is located at &dollar;0FFF on 4KB Syms, or at &dollar;7FFFfor 32KB systems.  The stack always grows downwards. 
 
   <tag/Heap/
-  The C heap is located at the end of the program and grows towards the C
-  runtime stack.
+  The C heap is located at the end of the program and grows towards the C runtime stack.
 
 </descrip><p>
 
@@ -52,7 +51,7 @@ Programs containing Sym-1 code may use the <tt/sym1.h/ header file.  See the hea
 
 <sect1>Hardware access<p>
 
-The following pseudo variables declared in the <tt/sym1.inc/ include file allow access to hardware located in the address space.  See the include file for more information.
+The pseudo variables declared in the <tt/sym1.inc/ include file allow access to hardware located in the address space.  See the include file for more information.
 
 <sect>Loadable drivers<p>
 
@@ -103,7 +102,7 @@ As stated earlier, there are config files for 4KB and 32KB systems.  If you have
 
 <sect3>Sample programs<p>
 
-All the samples will run on the &quot;stock&quot; 4k Sym-1, except for symio.c, which requires 8k.  Information on building and running it is in the samples/tutorial/sym1 directory.
+All the samples will run on the &quot;stock&quot; 4KB Sym-1, except for symIO and symNotepad, which require 32KB.  Information on building and running the sample programs are in the targettest/sym1 directory.
 
 <itemize>
 <item>helloworld is the traditional &quot;Hello World!&quot; program, using printf().</item>