Clarify Pexec return value

Fixes #176.

Author: mikrosk

gemdos/prozess/pexec.ui

@@ -5,7 +5,7 @@
 !begin_node Pexec
 (!begin_liste) [Availability]
 !item [Name:]
-¯Program execution® - Load and execute a program.
+�Program execution� - Load and execute a program.
 
 !item [Opcode:]
 75
@@ -168,9 +168,10 @@ Command lines are passed as a (!I)Pascal format(!i) string, i.e. the first
 byte contains the length of the line (maximum 124 characters).
 
 !item [(!nolink [Return]) value:]
-(!B)Return value:(!b) The function returns the exit code of the child
-process. If an overlay was loaded, the result contains the basepage of the
-overlay. With a negative result, an error has arisen.
+(!B)Return value:(!b) The return value is either a negative 32-bit value
+(if an error occurred within Pexec) or a 16-bit value (the value returned by
+the executed program using Pterm, Ptermres, or PtermO). If an overlay was
+loaded, the result contains the basepage of the overlay.
 
 !item [Availability:]
 All (!nolink [GEMDOS]) versions.
@@ -212,7 +213,7 @@ Adresse%=Gemdos(&H4B,W:mode%,L:name%,L:cmdline%,L:env)
 !begin_node Pexec
 (!begin_liste) [Beschreibung]
 !item [Name:]
-¯program execution® - Programm laden und ausfhren.
+�program execution� - Programm laden und ausf�hren.
 
 !item [Gemdosnummer:]
 75
@@ -221,17 +222,17 @@ Adresse%=Gemdos(&H4B,W:mode%,L:name%,L:cmdline%,L:env)
 int32_t Pexec ( uint16_t mode, ... );
 
 !item [Beschreibung:]
-Die Funktion l„dt und startet ein Programm. šber den Parameter (!I)mode(!i)
-lassen sich verschiedene Varianten ausw„hlen:
+Die Funktion l�dt und startet ein Programm. �ber den Parameter (!I)mode(!i)
+lassen sich verschiedene Varianten ausw�hlen:
 !begin_xlist [mode]
 !item [mode]
 Bedeutung
 
 !item [0]
 int32_t Pexec (0, int8_t *name, int8_t *cmdline, int8_t *env);
 
-(!B)Load and go:(!b) L„dt und startet das in (!I)name(!i) angegebene
-Programm, und bergibt die Kommandozeile (!I)cmdline(!i). Fr den Parameter
+(!B)Load and go:(!b) L�dt und startet das in (!I)name(!i) angegebene
+Programm, und �bergibt die Kommandozeile (!I)cmdline(!i). F�r den Parameter
 (!I)env(!i) gilt:
 !begin_xlist !compressed [NULL]
 !item [-1]
@@ -246,13 +247,13 @@ Jeder andere Wert ist ein Zeiger auf das zu vererbene Environment.
 
 (!B)Load, don't go:(!b) wird meist zum Starten von Overlays oder zum Laden
 von Programmen in einem Debugger benutzt. Entspricht (!I)mode(!i) 0, mit dem
-Unterschied, daž das Programm nicht sofort gestartet wird, sondern ein
-Zeiger auf die Basepage als LONG zurckgeliefert wird. Der Parent ist der
-Eigentmer des Speichers, den die Basepage und das Environment des Childs
-belegen und muž ihn freigeben, wenn das Child sich beendet hat. (!nl)
-(!B)Achtung:(!b) Der Aufrufer ist dafr verantwortlich, Daten- und Instruktions-caches
-ungltig zu machen, auch fr den Fall, daž das Overlay anschliessend mit Pexec Mode 4
-ausgefhrt werden soll.
+Unterschied, da� das Programm nicht sofort gestartet wird, sondern ein
+Zeiger auf die Basepage als LONG zur�ckgeliefert wird. Der Parent ist der
+Eigent�mer des Speichers, den die Basepage und das Environment des Childs
+belegen und mu� ihn freigeben, wenn das Child sich beendet hat. (!nl)
+(!B)Achtung:(!b) Der Aufrufer ist daf�r verantwortlich, Daten- und Instruktions-caches
+ung�ltig zu machen, auch f�r den Fall, da� das Overlay anschliessend mit Pexec Mode 4
+ausgef�hrt werden soll.
 
 !item [4]
 int32_t Pexec (4, 0L, PD *basepage, 0L); (!nl)
@@ -263,9 +264,9 @@ mit mode 3 oder 5 erzeugt worden sein.
 !item [5]
 (!nolink [PD]) *Pexec (5, 0L, int8_t *cmdline, int8_t *env); (!nl)
 
-(!B)Create Basepage:(!b) Zun„chst legt GEMDOS ein neues Environment an. Dann
-wird der gr”žte zusammenh„ngende Speicherblock alloziert und in den ersten
-256 Byte eine Basepage angelegt. Fr den Parameter (!I)env(!i) gilt:
+(!B)Create Basepage:(!b) Zun�chst legt GEMDOS ein neues Environment an. Dann
+wird der gr��te zusammenh�ngende Speicherblock alloziert und in den ersten
+256 Byte eine Basepage angelegt. F�r den Parameter (!I)env(!i) gilt:
 !begin_xlist !compressed [NULL]
 !item [-1]
 =  kein Environment anlegen.
@@ -281,28 +282,28 @@ einen Aufruf von Pvfork ohne Blockieren des parent zu emulieren.
 int32_t Pexec (6, 0L, PD *basepage, 0L); (!nl)
 
 (!B)Just go, then free:(!b) Entspricht (!I)mode(!i) 4, mit dem Unterschied,
-daž allozierter Speicher dem gestarteten Prozess und nicht dem Starter
-geh”rt, so daž der Speicher, den die Basepage belegt, automatisch
+da� allozierter Speicher dem gestarteten Prozess und nicht dem Starter
+geh�rt, so da� der Speicher, den die Basepage belegt, automatisch
 freigegeben wird, wenn das Child mit Pterm terminiert. Zusammen mit Modus 3
 kann damit der gleiche Effekt erzielt werden, wie durch Modus 0. Dieser
-Modus steht erst ab (!nolink [GEMDOS])-Version 0.15 zur Verfgung.
+Modus steht erst ab (!nolink [GEMDOS])-Version 0.15 zur Verf�gung.
 
 !item [7]
 PD *Pexec (7, uint32_t prgflags, int8_t *cmdline, int8_t *env);
 
 (!B)Create Basepage, respecting prgflags:(!b) Analog (!I)mode(!i) 5, nur
 kann in (!I)prgflags(!i) die gleiche Information wie im Feld ph_prgflags des
-Programm-Headers bergeben werden. Dieser Modus wird vom BIOS des TT
+Programm-Headers �bergeben werden. Dieser Modus wird vom BIOS des TT
 benutzt, um GEM zu starten, und steht erst ab GEMDOS Version 0.19 zur
-Verfgung.
+Verf�gung.
 
 !item [100]
 int32_t Pexec (100, int8_t *name, int8_t *cmdline, int8_t *env);
 
 (!B)Load, go, don't wait:(!b) Analog (!I)mode(!i) 0, nur wartet der
 Aufrufer nicht, bis das gestartete Programm beendet wird, d.h. die Funktion
-kehrt sofort zum Parent Prozess zurck, w„hrend das Child startet. Der
-Rckgabewert ist ein negativer Fehlercode oder die positive PID des Childs.
+kehrt sofort zum Parent Prozess zur�ck, w�hrend das Child startet. Der
+R�ckgabewert ist ein negativer Fehlercode oder die positive PID des Childs.
 
 !item [101]
 da dieser Modus nur MagiC-intern zum Vererben von Pfad- und Dateihandles
@@ -319,13 +320,13 @@ int32_t Pexec (104, int8_t *name, PD *basepage, 0L); (!nl)
 (!B)Just go, don't wait:(!b) Analog (!I)mode(!i) 4, nur wartet der Aufrufer
 nicht, bis das gestartete Programm beendet wird. Es wird ein Prozess
 gestartet, dessen Basepage vorher durch einen Modus von 3, 5 oder 7 gesetzt
-wurde. Zu beachten ist, daž das Environment und die Basepage des Childs sich
-auch im Besitz des Parents befinden (tats„chlich erbt der Child allen
+wurde. Zu beachten ist, da� das Environment und die Basepage des Childs sich
+auch im Besitz des Parents befinden (tats�chlich erbt der Child allen
 Speicher, der sich im Besitz des Parents befindet). Der Parameter
 (!I)name(!i) ist ein Zeiger auf einen String, der den Namen des neuen
 Prozesses beschreibt; bei einem NULL-Wert wird der Name des Parent-Prozesses
 benutzt. Die Funktion liefert einen negativen Fehlercode, oder die positive
-PID des Childs zurck.
+PID des Childs zur�ck.
 
 !item [106]
 int32_t Pexec (106, int8_t *name, PD *basepage, 0L); (!nl)
@@ -335,10 +336,10 @@ befinden sich Environment und Basepage des Childs (!I)nicht(!i) im Besitz
 des Parents, und der Child hat keinen Zugriff auf Speicher, welcher dem
 Parent-Prozess zugeteilt wurde. Beim Beenden des Childs wird dessen
 Speicherplatz wieder freigegeben. In Verbindung mit Modus 3 entspricht Pexec
-(106, ...) daher dem Modus 100 (w„hrend Modus 3 gefolgt von Modus 6 einem
+(106, ...) daher dem Modus 100 (w�hrend Modus 3 gefolgt von Modus 6 einem
 Aufruf von Pexec (0, ...) entspricht).
 (!nl)
-Wird ab MagiC 2.0 nicht mehr untersttzt.
+Wird ab MagiC 2.0 nicht mehr unterst�tzt.
 
 !item [107]
 entspricht im wesentlichen (!I)mode(!i) 7, und wird intern von MagiC seit Version 2.10
@@ -347,15 +348,15 @@ verwendet. Auf die genaue Syntax wird daher an dieser Stelle verzichtet.
 !item [108]
 wird von (!nolink [MagiC]) seit Version 2.10 intern zum Starten eines Accessories verwendet.
 Da die genaue Syntax offiziell nicht dokumentiert ist, sollten eigene
-Programme besser auf shel_write zurckgreifen.
+Programme besser auf shel_write zur�ckgreifen.
 
 !item [200]
 int32_t Pexec (200, int8_t *name, int8_t *cmdline, int8_t *env);
 
-(!B)Replace program and go:(!b) Analog (!I)mode(!i) 100, jedoch berschreibt der neue
-Prozess den alten vollst„ndig. Der alte Prozess beh„lt zwar seine PID und
+(!B)Replace program and go:(!b) Analog (!I)mode(!i) 100, jedoch �berschreibt der neue
+Prozess den alten vollst�ndig. Der alte Prozess beh�lt zwar seine PID und
 die meisten seiner Attribute, aber sein gesamter Speicherplatz wird
-freigegeben. W„hrend Pexec (0, ...) als Unterprogrammaufruf (call...return)
+freigegeben. W�hrend Pexec (0, ...) als Unterprogrammaufruf (call...return)
 angesehen werden kann, wirkt dieser Modus eher wie ein 'goto'.
 
 !item [300]
@@ -367,31 +368,31 @@ verzichtet.
 
 !end_xlist
 (!B)Hinweis:(!b) Nicht alle Modi sind unter allen Betriebssystemvarianten
-verfgbar; deshalb sollte der Rckgabewert der Funktion beachtet werden.
-Unbekannte Modi sorgen fr ein Funktionsergebnis von EINVFN.
+verf�gbar; deshalb sollte der R�ckgabewert der Funktion beachtet werden.
+Unbekannte Modi sorgen f�r ein Funktionsergebnis von EINVFN.
 
-Kommandozeilen werden als String im (!I)Pascal-Format(!i) bergeben, d.h. im
-ersten Byte befindet sich die L„nge der Zeile (maximal 124 Zeichen).
+Kommandozeilen werden als String im (!I)Pascal-Format(!i) �bergeben, d.h. im
+ersten Byte befindet sich die L�nge der Zeile (maximal 124 Zeichen).
 
 !item [Ergebnis:]
-Die Funktion liefert als Ergebnis den Abschlužcode des Child-Prozesses. Wenn
-ein Overlay geladen wurde, enth„lt das Ergebnis die Basepage des Overlays.
+Die Funktion liefert als Ergebnis den Abschlu�code des Child-Prozesses. Wenn
+ein Overlay geladen wurde, enth�lt das Ergebnis die Basepage des Overlays.
 Bei einem negativen Resultat ist ein Fehler aufgetreten.
 
 
-!item [Verfgbar:]
+!item [Verf�gbar:]
 Alle GEMDOS Versionen.
 
 !item [Gruppe:]
 Prozessfunktionen
 
 !item [Querverweis:]
-(!link [Binding] [Bindings fr Pexec]) ~ shel_write ~
+(!link [Binding] [Bindings f�r Pexec]) ~ shel_write ~
 (!link [Programmflags][Die Programmflags]) ~ ARGV-Verfahren
 (!ende_liste)
 
 
-!begin_node Bindings fr Pexec
+!begin_node Bindings f�r Pexec
 !ignore_index
 (!begin_liste) [Assembler:]
 !item [C:]