Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- z9001:software:prettyc [2025/03/25 14:18] – angelegt volkerp
+++ z9001:software:prettyc [2025/07/07 11:01] (aktuell) – [Internes] volkerp
@@ Zeile 6: / Zeile 6: @@
 Pretty C ist ein kleiner Einpass-C-Compiler zum Lernen der Sprache C (K&R-Syntax!). Er wurde speziell für Kleincomputer und Kassetten-Rekorder als Massenspeicher entwickelt.
+{{:z9001:software:prettyc.gif?340|}} {{:z9001:software:schaukel.gif?340|Beispiel Schaukel}}
 Vor Nutzung des Compilers ist es erforderlich, das Handbuch zu lesen!
@@ Zeile 22: / Zeile 24: @@
 ===== Downloads =====
+{{ :z9001:software:prettyc.zip |}}
   * Handbuch Version 1.0 incl. Ergänzung Version 1.1 (digitalisiert U. Zander)
+  * Beschreibung K&R C (Aus: Kernighan/Ritchie, The C Programming language, 1978, Anhang C). In Englisch!
   * Softwarepaket (PRETTYC.COM, INSTALL.COM, Bibliotheken CEXT,CLIB,CLIBM,DEBUG, Beispiele HELLO, SCHAUKEL, SIEB)
+  * mein Patch
 ===== Hinweise =====
@@ Zeile 30: / Zeile 36: @@
 Die originale Version lässt nur mit Kassettenrekorder nutzen! Meine gepatchte Version arbeitet auch mit USB und SD-Karten.
-**Achtung**: Es darf kein [[z9001:cpm:schaltrom|]] zum Einsatz kommen! Der Compiler macht Schreibzugriffe auf 0FFFEh und weitere Adressen, die zum Abschalten eines Schalt-ROMs führen!
+:!: Bei "filename" darf **keine Endung** angegeben werden, nur max. 8 Zeichen für den Dateinamen. Die Originalversion ignoriert einen Dateityp; die gepatchte Version erwartet keinen Dateityp. Der Filename muss bei USB/SD in **Großbuchstaben** eingegeben werden (FAT-Filesystem)!
+:!: Es darf kein [[z9001:cpm:schaltrom|]] zum Einsatz kommen! Der Compiler macht Schreibzugriffe auf 0FFFEh und weitere Adressen, die zum Abschalten eines Schalt-ROMs führen!
+Auf der Tastatur nicht vorhandene Zeichen wie [,{,~  können aus vorhandenen Zeichen
+durch nachfolgendes Drücken von '@' dargestellt werden (s. Handbuch Abschnitt 2.3.1, Sondertasten).
 <code>
@@ Zeile 46: / Zeile 57: @@
 compiliert ist.
->EC CLIBM/CR
+>EC CLIBM/CR			Textpuffer CLIBM anlegen
-*
+*				Leerzeile
-*STRG-C
+*STRG-C				Insert-Mode beenden
-ESC+R,CLIBM
+ESC+R,CLIBM			Datei CLIBM einlesen
-ESC+E
+ESC+E				Editor Ende
->EC CMD/CR
+>EC CMD/CR			Textpuffer CMD anlegen
 *CC MAIN/BP:0/LI:0
 *CC CLIBM/CN
-STRG-C
+*STRG-C				Insert-Mode beenden
-ESC+E
+ESC+E				Editor Ende
-EC MAIN/CR
+EC MAIN/CR			Textpuffer MAIN anlegen
-*main(){}
+*				Leerzeile
 *STRG-C
-ESC+E
+ESC+E				Editor Ende
 Speicherabzug CLIBM+CMD+MAIN auf Band sichern, dann spart man sich diese Schritte,
 sondern lädt einfach im OS.
-( prettyc muss aber vorab init werden, dazu einfach einmal CC )
+( prettyc muss aber vorab init werden, dazu einfach einmal CC ausführen )
->EC /DI
+>EC /DI				alle Textpuffer auflisten
 8E8F CLIBM
 902A CMD
 9217 MAIN
->SAVE 8000 921F FFFF
+>SAVE 8000 921F FFFF		OS-Kommando SAVE
 filename: EC_CLIB.COM
@@ Zeile 82: / Zeile 93: @@
 </code>
+===== Bedienung =====
+<code>
+EC /DI		Directory
+EC TEST/CR	legt Puffer mit Namen TEXT an
+Cursor runter/cursor hoch	- durch die Zeilen blättern
+ESC+T	Pufferfanang
+ESC+B	Pufferende
+* kennzeichnet Insertmodus (neue Zeilen)
+es muss mindestens eine Zeile da sein, also mindestens 1x Enter drücken
+^C -> _ (Kommandomode)
+^D	Zeile löschen
+^E	Insertmodus
+ESC+W WRITE:
+Ausgabe des gesamten Puffers auf Magnetband
+ESC+R READ:
+Lesen eines Files von Magnetband, Anhängen an das
+Pufferende. WIRD STATT DES Filenamens nur 'ENTER' gegeben, so wird
+dieser Vergleich unterdrückt
+ESC+C	Großbuchstaben nutzen
+ESC+E 	end
+Textpuffer mit dem Namen CMD schreiben.
+OS-Kommando
+C@
+arbeitet seine Zeilen nacheinander ab.
+CC CQ/BP:2/LI:1/AS:100
+CC debug/BP:0/LI:0/CN
+CC printf/CN
+</code>
+===== Internes =====
+Es wird reservierter Systemspeicher genutzt. Auch die RST-Adressen werden verwendet. Das muss bei anderen Erweiterungen (z.B. Mega-Flash) beachtet werden!
+<code>
+- 18F Stack für Syntaxanalyse (nur Compiler)
+- 2FF interne Puffer (Compiler + Laufzeit)
+- 4F00 Pretty C mit Arbeitszellen
+...
+</code>
+JKCEMU: C@ schreibt auf Adresse FFFE/FFFD und deaktiviert dadurch den ROM des Mega-Flash. Stattdessen wird das normale BASIC eingeblendet.
+Nach dem Kompilieren muss man daher erst mal Reset drücken (und ggf. den Massenspeicher-Treiber neu laden), ehe man wieder mit ED korrekt editieren und vor allem speichern kann!
+--> [[..:cpm:schaltrom|]]
+Mit einem Schreibzugriff auf Adresse FC00h wird der ROM abgeschaltet. („LD (0FC00h),A“)
+Mit einem Schreibzugriff auf Adresse F800h wird der ROM zugeschaltet. („LD (0F800h),A“) )