From: Stephan Mühlstrasser <stephan.muehlstrasser@web.de>
Date: Sun, 8 Feb 2015 14:46:33 +0000 (+0100)
Subject: Minor corrections.
X-Git-Tag: V2.15~22^2~14
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=a1cc85768e95cb6d775cb9003e30d5e027277946;p=cc65

Minor corrections.
---

diff --git a/doc/intro.sgml b/doc/intro.sgml
index 5ffef7e69..41f359278 100644
--- a/doc/intro.sgml
+++ b/doc/intro.sgml
@@ -520,24 +520,23 @@ Emulates the Ohio Scientific Challenger 1P computer in different configurations.
 The 32 kb RAM machine that must be used with the default compiler settings is
 <url url="http://www.pcjs.org/devices/c1p/machine/32kb/" name="here">.
 
-In addition the srec_cat program from the
+In addition to cc65 the srec_cat program from the
 <url url="http://srecord.sourceforge.net/" name="SRecord">
 tool collection must be installed. Some Linux distributions also provide the
-srecord package that can be installed directly from the distribution's
-repository.
+srecord package directly as an installable package.
 
-The osic1p runtime library directly returns to the boot prompt when the
+The osic1p runtime library returns to the boot prompt when the
 main() program exits. Therefore the C file in the tutorial must be slightly
 modified in order to see the results on the screen. Otherwise the program
 would print the text string and then jump to the boot prompt, making it
 impossible to see the results of running the tutorial program.
 
-In addition to that the cc65 target does not yet have support for stdio
+In addition to that the osic1p target does not yet have support for stdio
 functions. Only the functions from the conio library are available.
 
-Therefore modify the main() function in hello.c as follows:
+Therefore modify the hello.c source file as follows:
 
-<tscreen>
+<tscreen><code>
 #include <conio.h>
 #include <stdlib.h>
 
@@ -545,12 +544,12 @@ extern const char text[];       /* In text.s */
 
 int main (void)
 {
-    clrscr();
+    clrscr ();
     cprintf ("%s\r\nPress <RETURN>\r\n", text);
-    cgetc();
+    cgetc ();
     return EXIT_SUCCESS;
 }
-</tscreen>
+</code></tscreen>
 
 Compile the tutorial with
 
@@ -566,10 +565,10 @@ srec_cat hello -binary -offset 0x200 -o hello.c1p -Ohio_Scientific -execution-st
 </verb></tscreen>
 
 Open the URL <url url="http://www.pcjs.org/devices/c1p/machine/32kb/" name="http://www.pcjs.org/devices/c1p/machine/32kb/">
-in your browser and wait until the emulator is loaded. Click on the BREAK
-button to display the boot prompt, then press the M key to enter the
-65V PROM monitor. Press the "Choose File" button and select the hello.c1p
-that was created as the output of the above invocation of the srec_cat
+and wait until the emulator has been loaded. Click on the "BREAK"
+button to display the boot prompt, then press the "M" key to enter the
+65V PROM monitor. Click the "Choose File" button and select the file "hello.c1p"
+that was created as the output of the above invocation of the "srec_cat"
 command. Press the "Load" button. You should see the following text on the
 screen:
 
@@ -581,7 +580,8 @@ Press <RETURN>
 After hitting the RETURN key you should see the boot prompt again.
 
 The program can also be uploaded over the serial port to a real Challenger 1P
-computer.
+computer with 32 kB RAM. See the <url url="osi.html" name="Ohio Scientifc-specific documentation"> for instructions how to
+compile for other RAM sizes.
 
 <sect1>Contributions wanted<p>
 
diff --git a/doc/osi.sgml b/doc/osi.sgml
index 7152f2815..76c56fac7 100644
--- a/doc/osi.sgml
+++ b/doc/osi.sgml
@@ -85,10 +85,10 @@ Special locations:
 </descrip><p>
 
 Example for building a program with start address &dollar;0300, stack size
-&dollar;0200 and RAM size &dollar;0200:
+&dollar;0200 and RAM size &dollar;2000:
 
 <tscreen>
-cl65 --start-addr 0x300 -Wl -D,__HIMEM__=$2000,-D,__STACKSIZE__=$0300 -t osic1p hello.c
+cl65 --start-addr 0x300 -Wl -D,__HIMEM__=$2000,-D,__STACKSIZE__=$0200 -t osic1p hello.c
 </tscreen>
 
 <sect>Linker configurations<p>