allegro Systemhandbuch V26 
 
Anhang D : Texteditor X  [Achtung: Nicht ab Win'7/64bit; empfohlen wird dann WinVi]
 
`Das Wichtigste in Kürze`  `Beispiel` 
 
Empfehlung: 
	Benutzen Sie im DOS-Fenster das Programm X.EXE, wenn Sie an keinen anderen Texteditor gewöhnt sind. Sonst nehmen Sie den, mit dem Sie vorzugsweise arbeiten. (Einbau in die "Vorgabendatei" CP.OPT: siehe Befehl E, -Ø` 0.11.6 und in die INI-Datei, Befehl "Editor=..."). Es muß ein DOS-ASCII-Editor sein, also z.B. nicht WordPad oder NotePad, denn diese arbeiten mit Windows-Zeichencodes. Die Umlaute etc. erscheinen dann hinterher falsch. 
NEU ab V25: 
	Textdateien können auch im `aresqa-Fenster` bearbeitet werden. Das ist eine gute Alternative, wenn man nur kleinere Änderungen an einer Datei zu machen hat. 
 
Anwendung: 
	Bearbeitung von "normalen" Textdateien, auch "ASCII-Dateien" genannt 
	= Dateien, die aus schlichtem Text bestehen (nur druckbare Zeichen), wobei die Zeilen durch die Steuerzeichen "Carriage Return / Line Feed" (Codes 13 10) getrennt sind 
	Darunter fallen die Parameterdateien (.APR, .APT, .API und .AIM), ferner die .CFG-Dateien, auch UIF- und H-Dateien sowie die CockPit-Vorgaben CP.OPT,  
	ABER NICHT Datenbank- und Indexdateien (Typen .ALG, .ALD, .ADX, .TBL, .STL, .LOG)!  
	Editor X wird vom CockPit automatisch aufgerufen, wenn eine Datei zu bearbeiten ist. Sie können aber mit dem E-Befehl in der Datei CP.OPT auch einen anderen Editor verlangen (-Ø`Kap.0.11.6). 
 
Installation: 
	X ist im "Gesamtpaket" und wird bei der Installation automatisch auf Ihr Programmverzeichnis kopiert. Die Dateien X.EXE und X.MAC (=`Funktionstasten-Belegung, Farbeinstellungen) gehören zusammen. 
 
Aufruf:			x dateiname 
	z.B. 			x cat.api 
 
	Dann erscheint der Anfang der Datei (22 Zeilen). Wenn sie nicht existiert, wird sie am Ende beim Speicherbefehl (siehe unten: Befehl Quit mit s) neu angelegt. 
 
Zustand und Hilfe: 
	Der Editor befindet sich nach dem Start im Befehlszustand. 
	Hilfe: Oben steht eine Liste von Befehlen, die man gerade geben kann. Wenn man die Leertaste ("space") drückt, kommt die Liste der restlichen Befehle. 
	Von jedem Befehl gibt man nur den Anfangsbuchstabe ein (siehe unten). Im Befehlszustand kann man auch den Cursor bewegen, aber nicht schreiben. Druck auf 'x' schaltet den Schreibzustand ein. 
 
Die wichtigsten Handgriffe 
Zwei Minuten, die sich lohnen 
Die folgenden drei Sätze erklären schon alles, was Sie für normale Bearbeitungen an den ASCII-Dateien (Parameter, Konfiguration, Stapel-, Hilfedateien u.v.m.) brauchen.     
Sie können das auch sofort `ausprobieren` 
Hinweis: Wenn dann ein schwarzes, leeres Fenster erscheint: Bild rauf / Bild runter drücken, dann sehen Sie was.

1.	Wenn die Datei im DOS-Fenster erscheint: mit dem Cursor an die zu bearbeitende Stelle fahren. (Bei großen Dateien ist der find-Befehl dabei hilfreich :  f  tippen, Suchwort eingeben, Enter-Taste 
	(siehe auch unten bei F ). 
 
2.	[Einfg] : Schreibzustand einschalten. Oben links steht "Insert", man ist also im Einfügemodus.  
	Mit der Taste [Einfg] kann man ständig zwischen Einfüge- und Überschreibmodus (= "Exchange") umschalten, wie bei Textprogrammen üblich. 
 
3.	[Esc] : Schreibzustand verlassen, Befehlszustand wird wieder eingeschaltet, 
	Dann zuerst 
	q : Quit-Befehl zum Beenden der Bearbeitung,  
	    dann gibt es 2 Möglichkeiten: 
		s : Save-Befehl zum Speichern 
		e : Ende ohne Speichern, d.h. die ausgeführten Änderungen werden ignoriert. (Bestätigen mit y) 
	Zum Beenden mit Speichern also dieses:  Esc q s 
	Beenden ohne Speichern:   Esc q e y     (y nur nötig, wenn man Änderungen gemacht hatte) 
 
Es folgt trotzdem eine vollständige Beschreibung aller Funktionen des Editors.  
Besonders wichtige Befehle: find und  buffer, copy und delete. 
 
Schreibzustand: 
 
	Im Befehlszustand  'x'  drücken, dann ist man im Überschreibmodus,  
	mit <Einfg> im Einfügemodus. 
 
	Die Funktionstasten haben in jedem Zustand folgende Wirkungen:  
 
 	<Cursortasten> und <Bild­>/<Bild¯>:  normale Wirkung, wie Sie es erwarten. 
 
	<Pos1> 		Sprung an den Zeilenanfang. Zweimal <Pos1> : Sprung an den Bildschirmanfang. 
 
	<Strg>+<Pos1>	Sprung an den Textanfang. 
 
	<Ende> 		Sprung ans Zeilenende. Zweimal <Ende> : Sprung an den Anfang der letzten Bildschirmzeile. 
 
	<Strg>+<Ende> 	Sprung an das Textende. 
 
	<Entf> 
	<Rücktaste> 		normale Wirkung wie in anderen Programmen 
 	<Einfg> 
 
	<Esc>			Sprung in den Befehlszustand, siehe oben, mögliche Befehle siehe unten. 
 
	<Enter>		oder <RETURN> : Zeile wird an der Stelle, wo sich der Cursor befindet, geteilt. (Passiert nicht im Befehlszustand.) 
				Der hintere Teil wird eine Zeile tiefer gesetzt. 
				Wenn man das nicht bewußt machen will, sondern einfach nur an den Anfang der nächsten Zeile gehen will: <Home> und <Cursor down> statt <Enter> geben. 
 
Befehle 
 
Hier die Liste der Befehle und ihrer Wirkungen: 
Auslösung jeweils durch den Anfangsbuchstaben - klein oder groß. 
Wenn Befehlszustand nicht eingeschaltet: vorher <Esc> drücken! 
 
Hilfe: 	Oben steht eine Liste von Befehlen, die man gerade geben kann. Wenn man die Leertaste ("space") drückt, kommt die Liste der restlichen Befehle. 
 
Again	ein vorher gegebener Befehl, z.B. ein Suchbefehl (f oder -) oder ein Ersetzungsbefehl (r) wird wiederholt. Gibt man vorher eine Zahl, wird entsprechend oft wiederholt: z.B. 100 a um 100 mal zu wiederholen (ohne <Enter> dazwischen). 
 
Buffer	Die Cursorposition wird markiert. Man fährt dann mit dem Cursor (dabei sind auch Bild­ und Bild¯ sowie Find-Befehl erlaubt) an eine beliebige andere Stelle weiter unten in der Datei und drückt abermals b . Von der vorher markierten Stelle bis zu dieser Endposition wird alles in einen "Pufferspeicher" kopiert. Sodann: 
 
Copy	Der Inhalt des Pufferspeichers (siehe Buffer, Delete und F3) wird an der Stelle eingefügt, wo der Cursor gerade steht. Wiederholbar! 

Delete	Wie Buffer, nur wird beim zweiten Druck auf d  der markierte Bereich gelöscht. Wenn man gleich danach c  drückt, wird das rückgängig gemacht. Sonst kann man den gelöschten Teil auch woanders wieder einfügen. Auch mehrmals an verschiedenen Stellen. Beim nächsten b- oder d-Befehl oder F3 wird der Pufferspeicher durch einen neuen Inhalt ersetzt, d.h. sein Inhalt ist dann verloren. 
 
Find	man gibt danach eine beliebige Zeichenkette und dann <Enter>. Falls die Zeichenkette im Text (ab Cursorposition nach unten) vorkommt, landet der Cursor sofort genau dahinter. 
	Tip: Will man etwas finden, was am Zeilenanfang vorkommt: Strg+j vor dem Suchwort eingeben. 
Für gezieltes Suchen mit Groß-/Kleinschreibung: siehe Befehl Set. Normalerweise ist die Schreibung nicht von Belang. 
		Wiederholung der Suche mit a , beliebig oft. 
 
-   (Minus)	dasselbe, nur rückwärts, d.h. von der Cursorposition nach oben. 
 
Get	Einen anderen Text, dessen Name dann abgefragt wird, laden und an der Cursorposition in den aktuellen Text einkopieren. Der andere Text kann z.B. einer sein, den man vorher mit dem Put-Befehl in eine Datei geschrieben hat. 
 
Insert	Übergang in den Schreibzustand (siehe unten), wobei die eingegebenen Zeichen an der Cursorposition eingesetzt werden (= Einfügemodus). Wechsel in den normalen Überschreibmodus und zurück: jeweils mit der <Einfg>-Taste (=`<Ins>-Taste). 
 
Jump	Zu einer vorher gesetzten Marke (a,b,c,d) springen: dazu gibt man nach dem j einen dieser Buchstaben   (siehe  Tag). 
 
Macro	Einschalten der Makro-Prozedur: sie dient zur Belegung der Funktionstasten mit beliebigen Tastenfolgen. Es erscheint oben ein Untermenü  
		Delete  Load  Record  Save 
	Man gibt einen der Anfangsbuchstaben; die Wirkung ist: 
 
		d: 	ein vorher mit r  gespeichertes Makro wird gelöscht 
 
		l: 	eine vorher gespeicherte Funktionstastenbelegung wird geladen 
 
		r:	Makro aufzeichnen: danach gibt man eine der Tasten F1 - F8. Auf dieser Taste soll die nachfolgende Tastensequenz gespeichert werden. Man gibt nun beliebige Befehle oder auch Text ein, geht dann wieder in den Befehlszustand (Esc) und drückt abermals m . Damit ist die gewählte Funktionstaste mit der eingegebenen Tastenfolge belegt. Beispiel siehe unten. 
 
		s:	die zuvor gespeicherten Makros werden als Datei  x.mac   gespeichert und bei erneutem Aufruf von x automatisch  geladen. 
 
\  (Backslash)		Eingabe von Sonderzeichen, die sonst per Tastatur nicht eingegeben werden können. Es erscheint oben die Frage  Literal: , die man mit dem ASCII-Zahlenwert des gewünschten Zeichens beantwortet. An der Cursorposition erscheint dann dieses Zeichens. (Die Eingabe mittels <Alt>-Taste und Ziffern funktioniert nicht mit allen Zeichen.)  
			Will man z.B. das Teilfeld-Trennzeichen ? auf die Taste F2 legen, kann man folgendes Makro dafür definieren (Tasten genau in dieser Reihenfolge drücken): 
			<Esc> m r F2 \ 31 <Enter> m m s 
			(Durch m s am Ende dieser Folge werden die aktuellen Makros für später gesichert.) 

Other	Ein zweiter Text kann zusätzlich geladen werden.  
	Zwischen beiden schaltet man anschließend nach Belieben durch Druck auf o  hin und her und bearbeitet sie unabhängig voneinander. Jedoch: 
	Teile, die man in dem einen Text mit b  markiert oder mit d   gelöscht hat, kann man mit c  in den anderen einkopieren! 
	Tip: Weil das Hin- und Her-Schalten sehr schnell geht, kann man diese Funktion auch benutzen, um zwei Dateien visuell zu vergleichen. 
	Hat man an beiden Texten Veränderungen gemacht, muß beim Quit-Befehl für jeden einzeln entschieden werden, ob er zu speichern ist oder nicht. 
 
Put	Ausschnitt abspeichern : Textbereich wird zunächst markiert wie bei b. Nach dem zweiten p wird aber nach einem Namen gefragt. Unter diesem Namen wird dann der markierte Bereich als Datei gespeichert. So kann man leicht Teile aus Dateien kopieren, die man später separat verwenden will. Mit dem Befehl G kann man einen solchen Abschnitt jederzeit an anderer Stelle wieder einfügen. 
		Gibt man PRN als Dateiname, wo wird der Textausschnitt sofort gedruckt. 
 
Quit	Ausstieg aus dem Editor. Es erscheint ein Untermenü: 
 
		Backup   Exit  Initialize  Save-Exit  Update  Write 
 
	Die wichtigsten Unterfunktionen sind hier  s  und  e : 
 
		s : 	der Text wird in der bearbeiteten Form neu abgespeichert, die alte Form ist verloren. Das ist der Normalfall.  
			Text speichern: 
			Man gibt also normalerweise, um  eine Bearbeitung abzuschließen, hintereinander   <Esc> q s. 
 
		b : 	dasselbe, aber die alte Form wird umbenannt (Typ .BAK)  und bleibt somit erhalten. 
 
		e :	die Bearbeitung wird ergebnislos abgebrochen, d.h. die Datei bleibt unverändert erhalten. Wenn man Änderungen am Text vorgenommen hat, wird man noch gefragt, ob man  wirklich die Änderungen ignorieren will. Man bestätigt mit y oder geht mit n <Esc> zurück in die Bearbeitung. 
  
		w : 	der Text kann in eine andere Datei geschrieben werden. Der Name wird dann abgefragt. Die andere Datei wird kommentarlos überschrieben, wenn sie existiert! 
 
Replace	Wie bei Find wird nach einer zu suchenden Zeichenkette gefragt. Dann wird nach einer dafür einzusetzenden Ersatzzeichenfolge gefragt. Nach <Enter> wird die Ersetzung, falls möglich, ausgeführt. 
	Wiederholung mit a . 
	Mehrfachausführung: vor r  eine Zahl eingeben! 
	enn man z.B. eingibt: 999 r xyz <Enter> abc <Enter> 
	(hinter der Zahl kein <Enter>, sondern sofort r !) 
	werden die nächsten 999 vorkommenden xyz jeweils durch abc ersetzt. 

Set	Settings ändern. Verschiedene Optionen können gesetzt werden. 
	Am wichtigsten:  Case  
	Wenn man nach s  hintereinander c  und y  gibt, wird die Groß-Klein-Unterscheidung eingeschaltet. Sonst wirken die Befehle f s und r  nämlich unterschiedslos auf groß und klein geschriebene Buchstaben. 
	Farbsetzungen: s p f <Ziffer> für Zeichenfarbe, s p b <Ziffer> für Hintergrundfarbe. 
	(0=schwarz, 1=blau, 2=grün, 3=cyan, 4=rot, 5=magenta, 6=orange, 7=weiß. Auf die Vordergrundfarbe kann man 8 addieren, dann wird sie heller.)  Mit m s macht man die Farbeinstellungen permanent, also auch für nachfolgende Sitzungen. 
 
Tag	Sprungmarke setzen. Danach drückt man  a , b , c oder d.  
	Damit hat man die Cursorposition (unsichtbar) markiert. Also kann man bis zu vier Stellen in der Datei gleichzeitig markieren. 
	Mit j  (siehe dort) kann man diese Stellen jederzeit wieder anspringen. 
	Die Marken bleiben bei Abspeicherung nicht erhalten! 
 
Xchange	Vom Befehlszustand geht man mit x  in den Überschreibmodus, 
	d.h. in den "normalen" Schreibzustand. Aus diesem geht man mit <Esc> wieder in den Befehlszustand. 
 
#	Die Nummer der aktuellen Zeile wird angezeigt. 
	Sprung auf eine bestimmte Zeile: 
	im Befehlsmodus die Nummer der Zeile eingeben (sie erscheint dann oben links), dann '#' (ohne <Enter> vorher oder hinterher!) 

Funktionstasten 
 
	Jeder kann sie selbst belegen: siehe oben Befehl m und Beispiel unter \ (Backslash). Die Datei x.mac, die automatisch jedesmal geladen wird, enthält bei Lieferung diese Belegungen: 
 
	F3 :	Zeile löschen, in der sich der Cursor befindet. 
		Anschließend kann man die Zeile woanders einkopieren, indem man den Cursor dorthin bewegt und Befehl c  gibt. Die gelöschte Zeile wandert also zunächst in den Pufferspeicher (siehe Befehle b  und d ). 
 
	F4 :	Vor die Zeile, in der sich der Cursor befindet, eine Leerzeile einfügen. Wenn man vorher (im Befehlszustand!) eine Zahl eingibt, werden entsprechend viele Leerzeilen eingesetzt.  Also z.B.  7 F4   (kein <Enter> hinter der 7 !) um 7 Zeilen einzufügen. 
 
	F5 :	Zeilenende (ab Cursor) löschen. Der gelöschte Teil geht in den Pufferspeicher und kann mit c  woanders wieder einkopiert werden. 
 
	F8 :	Wenn der Cursor gerade auf einem der Klammerzeichen ([{ }]) steht, dann springt er vor bzw. zurück zur dazugehörigen schließenden bzw. öffnenden Klammer. (Unschätzbar mindestens für den C-Programmierer) 
 
	F9 :	Exkursion: Bearbeitung kurzfristig unterbrechen. Anschließend kann man jeden MS-DOS-Befehl ausführen und dann mit dem Befehl EXIT in den Editor zurückkehren - an die vorher verlassene Stelle! 
 
	D.h. F1, F2, F6 und F7 sind frei für eigene Belegung (siehe Befehl M). F10 ist nicht belegbar. 
 
?Das Wichtigste in Kürze=h =Zwei Minuten 
?Beispiel=x get env comspec\ins #uwC\var #uwC " /c " P "x " P "help\\x.txt"\call 
?ausprobieren=x get env comspec\ins #uwC\var #uwC " /c " P "x " P "help\\x.txt"\Call 
?aresqa-Fenster=h aq