diff --git a/doc/funcref.sgml b/doc/funcref.sgml index 4dff14dd3..4571d34a3 100644 --- a/doc/funcref.sgml +++ b/doc/funcref.sgml @@ -754,6 +754,16 @@ communication, see also <tt>testcode/lib/ser-test.c</tt>. </itemize> +<sect1><tt/sym1.h/<label id="sym1.h"><p> + +<itemize> +<item><ref id="beep" name="beep"> +<item><ref id="fdisp" name="fdisp"> +<item><ref id="loadt" name="loadt"> +<item><ref id="dumpt" name="dumpt"> +</itemize> + + <sect1><tt/telestrat.h/<label id="telestrat.h"><p> <itemize> @@ -1669,6 +1679,27 @@ used in presence of a prototype. </quote> +<sect1>beep<label id="beep"><p> + +<quote> +<descrip> +<tag/Function/Beep sound. +<tag/Header/<tt/<ref id="sym1.h" name="sym1.h">/ +<tag/Declaration/<tt/void beep(void);/ +<tag/Description/<tt/beep/ makes a brief tone. +<tag/Notes/<itemize> +<item>The function is specific to the Sym-1. +</itemize> +<tag/Availability/cc65 +<tag/See also/ +<ref id="fdisp" name="fdisp">, +<ref id="loadt" name="loadt">, +<ref id="dumpt" name="dumpt">, +<tag/Example/None. +</descrip> +</quote> + + <sect1>bgcolor<label id="bgcolor"><p> <quote> @@ -3363,6 +3394,29 @@ int main(void) </quote> +<sect1>dumpt<label id="dumpt"><p> + +<quote> +<descrip> +<tag/Function/Dump memory to tape. +<tag/Header/<tt/<ref id="sym1.h" name="sym1.h">/ +<tag/Declaration/<tt/int __fastcall__ dumpt (unsigned char id, const void* start, const void* end);/ +<tag/Description/<tt/dumpt/ saves memory onto data tape. +<tag/Notes/<itemize> +<item>The function is specific to the Sym-1. +<item>The function is only available as fastcall function, so it may only +be used in presence of a prototype. +</itemize> +<tag/Availability/cc65 +<tag/See also/ +<ref id="fdisp" name="beep">, +<ref id="loadt" name="fdisp">, +<ref id="dumpt" name="loadt">, +<tag/Example/None. +</descrip> +</quote> + + <sect1>em_commit<label id="em_commit"><p> <quote> @@ -3721,6 +3775,28 @@ switching the CPU into double clock mode. </quote> +<sect1>fdisp<label id="fdisp"><p> + +<quote> +<descrip> +<tag/Function/Flash front-panel display. +<tag/Header/<tt/<ref id="sym1.h" name="sym1.h">/ +<tag/Declaration/<tt/void fdisp(void);/ +<tag/Description/<tt/fdisp/ flashes front-panel display. +<tag/Notes/<itemize> +<item>The function is specific to the Sym-1. +<item>The front-panel display buffer mut be loaded prior to calling fdisp. See the DISPLAY struct definition in sym1.h. +</itemize> +<tag/Availability/cc65 +<tag/See also/ +<ref id="fdisp" name="beep">, +<ref id="loadt" name="loadt">, +<ref id="dumpt" name="dumpt">, +<tag/Example/None. +</descrip> +</quote> + + <sect1>feof<label id="feof"><p> <quote> @@ -4961,6 +5037,30 @@ used in presence of a prototype. </quote> +<sect1>loadt<label id="loadt"><p> + +<quote> +<descrip> +<tag/Function/Load memory from tape. +<tag/Header/<tt/<ref id="sym1.h" name="sym1.h">/ +<tag/Declaration/<tt/int __fastcall__ loadt (unsigned char id);/ +<tag/Description/<tt/loadt/ loads memory from data tape. +<tag/Notes/<itemize> +<item>The function is specific to the Sym-1. +<item>The return value is status. Non-zero status indicates an error. +<item>The function is only available as fastcall function, so it may only +be used in presence of a prototype. +</itemize> +<tag/Availability/cc65 +<tag/See also/ +<ref id="fdisp" name="beep">, +<ref id="loadt" name="fdisp">, +<ref id="dumpt" name="dumpt">, +<tag/Example/None. +</descrip> +</quote> + + <sect1>ltoa<label id="ltoa"><p> <quote> diff --git a/doc/sym1.sgml b/doc/sym1.sgml index 60eb1c020..5961984bd 100644 --- a/doc/sym1.sgml +++ b/doc/sym1.sgml @@ -38,7 +38,7 @@ Special locations: Conio support is not currently available for the Sym-1. But stdio console functions are available. <tag/Stack/ - The C runtime stack is located at $0FFF on 4KB Syms, or at $7FFFfor 32KB systems. The stack always grows downwards. + The C runtime stack is located at $0FFF on 4KB Syms, or at $7FFF for 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. @@ -102,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 "stock" 4KB Sym-1, except for symIO and symNotepad, which require 32KB. These sample programs can be found in the targettest/sym1 directory: +All the samples will run on the "stock" 4KB Sym-1, except for symIO and symNotepad, which require 32KB. These sample programs can be found in the samples/sym1 directory: <itemize> <item>symHello prints "Hello World!" and then inputs characters, which are echoed on the screen. It also makes a "beep" sound.</item>