home *** CD-ROM | disk | FTP | other *** search
/ TopWare Tools / TOOLS.iso / tools / top1028 / gepackt.exe / HELP / HELP.TXT < prev    next >
Encoding:
Text File  |  1992-06-09  |  13.2 KB  |  644 lines
  1.  
  2. VERZEICHNIS help
  3.  
  4. : hauptmenü
  5. CLR 
  6. RÜCKSPRUNG exit
  7. ; 9;
  8. {                Anleitung - TWG
  9.                 -----------------
  10.  
  11.             1.    Eine kleine Einleitung
  12.  
  13.             2.    Über die Entstehung
  14.  
  15.             3.    Die Instalation von TWG
  16.  
  17.             4.    Wie funktioniert TWG ?
  18.  
  19.             5.    Compiler- Befehle und Syntax
  20.  
  21.             6.    Shareware - Hinweise
  22. }
  23. DEFGOS '1' einleitung
  24. DEFGOS '2' geschichte
  25. DEFGOS '3' install
  26. DEFGOS '4' funktion
  27. DEFGOS '5' compiler
  28. DEFGOS '6' shareware
  29. TEXTAUSGABE 
  30. CLR 
  31. SPRUNG 
  32. GOTO hauptmenü
  33. ; 9;
  34.  
  35. : exit
  36. RÜCKSPRUNG hauptmenü
  37. {
  38.  
  39.  
  40.     Wollen Sie das Programm wirklich beenden ? (Ja/Nein)
  41. }
  42. DEF 'j' ende
  43. DEF 'n' hauptmenü
  44. TEXTAUSGABE 
  45. CLR 
  46. SPRUNG 
  47. ; 9;
  48.  
  49. : ende
  50. EXIT 
  51. ; 9;
  52.  
  53. : install
  54. LOAD install
  55. TEXTAUSGABE 
  56. SPRUNG 
  57.  
  58. : geschichte
  59. LOAD geschich
  60. TEXTAUSGABE 
  61. SPRUNG 
  62. ; 9;
  63.  
  64. : einleitung
  65. LOAD einleit
  66. TEXTAUSGABE 
  67. SPRUNG 
  68. ; 9;
  69.  
  70. : funktion
  71. LOAD funktion
  72. TEXTAUSGABE 
  73. SPRUNG 
  74. ; 9;
  75.  
  76. : shareware
  77. {
  78.             S H A R E W A R E - H I N W E I S E
  79.             -----------------------------------
  80.  
  81.  
  82.                 1.    Sharewarehinweise
  83.  
  84.  
  85.                 2.    Registrierungsformular
  86.  
  87.  
  88. Dieses Programm wird nach dem Sharewareprinzip vertrieben. Bitte seien Sie ehrlich genug, und lassen Sie sich registrieren.
  89. }
  90. DEFGOS '1' share
  91. DEFGOS '2' regist
  92. TEXTAUSGABE 
  93. SPRUNG 
  94. GOTO shareware
  95.  
  96. : share
  97. LOAD share
  98. DEFGOS 's' regist
  99. TEXTAUSGABE 
  100. SPRUNG 
  101. GOTO share
  102. ; 9;
  103.  
  104. : regist
  105. LOAD regist
  106. TEXTAUSGABE 
  107. SPRUNG 
  108.  
  109. : compiler
  110. {                Die Compilersprache von TWG
  111.  
  112.  
  113.                 1.  Die Syntax
  114.  
  115.                 2.  Die Befehle
  116.  
  117.                 3.  Das Programm CODE
  118.  
  119.                 4.  Das Programm TWG
  120.  
  121.                 5.  Ein Beispiel : Diese Hilfe
  122. }
  123. DEFGOS '1' syntax
  124. DEFGOS '2' befehle
  125. DEFGOS '3' code
  126. DEFGOS '4' twg
  127. DEFGOS '5' hilfe!
  128. TEXTAUSGABE 
  129. SPRUNG 
  130. GOTO compiler
  131.  
  132. : hilfe!
  133. LOAD help.txt
  134. TEXTAUSGABE 
  135. SPRUNG 
  136.  
  137. : syntax
  138. LOAD syntax
  139. TEXTAUSGABE 
  140. SPRUNG 
  141. ; 9;
  142.  
  143. : code
  144. LOAD code
  145. TEXTAUSGABE 
  146. SPRUNG 
  147. ; 9;
  148.  
  149. : twg
  150. LOAD twg
  151. TEXTAUSGABE 
  152. SPRUNG 
  153.  
  154. : befehle
  155. {                    Befehlsliste
  156.  
  157.  
  158.     a.    BEMERKUNG (;)            b.    CLR
  159.     c.    DEF                    d.    DEFGOS
  160.     d.    GOTO                    e.    GOSUB
  161.     f.    LOAD                    g.    RETURN
  162.     h.    RÜCKSPRUNG            i.    SPRUNG
  163.     j.    TEXTANFANG ({)            k.    TEXTAUSGABE
  164.     l.    ÜBERSCHRIFT            m.    VERZEICHNIS
  165.     n.    EXIT                    o.    : (Label)
  166. }
  167. DEFGOS 'a' bemerkung
  168. DEFGOS 'b' clr
  169. DEFGOS 'c' def
  170. DEFGOS 'd' goto
  171. DEFGOS 'e' gosub
  172. DEFGOS 'f' load
  173. DEFGOS 'g' return
  174. DEFGOS 'h' rücksprung
  175. DEFGOS 'i' sprung
  176. DEFGOS 'j' textanfang
  177. DEFGOS 'k' textausgabe
  178. DEFGOS 'l' überschrift
  179. DEFGOS 'm' verzeichnis
  180. DEFGOS 'n' Exit1
  181. DEFGOS 'o' zeile
  182. TEXTAUSGABE 
  183. CLR 
  184. SPRUNG 
  185. GOTO befehle
  186.  
  187. : bemerkung
  188. {                Bemerkungen und Kommentare
  189.  
  190.  
  191. Befehl : BEMERKUNG        Abkürzung : B oder ;
  192.  
  193. Der reine Programmcode ist oft schwer lesbar. Darum ist es empfehlenswert, das Programm zu dokumentieren, damit man es auch später noch lesen kann, und weiß, warum welcher Befehl wo steht. Darum können in den Befehlstext Kommentare eingefügt werden. Dabei muß vor jeder Kommentarzeile ein ; stehen.
  194.  
  195. Beispiel :
  196.  
  197. ;    Dies ist ein
  198. ;    Beispiel
  199. }
  200. TEXTAUSGABE 
  201. SPRUNG 
  202.  
  203. : clr
  204. {            Clr - Befehl
  205.  
  206.  
  207. Befehl : CLEAR            Abkürzung : C
  208.  
  209. Mit den Befehlen DEF und DEFGOS können Tasten einem Sprunglabel zugeordnet werden. Dabei wird die Textausgabe beim Betätigen einer definierten Taste abgebrochen, und das Steuerprogramm fortgesetzt.
  210.  
  211.  
  212. Die mit DEF und DEFGOS definierten Tastendefinitionen werden mit clr gelöscht.
  213. Beispiel :
  214.  
  215. load text
  216. def 'a' test_label
  217. textausgabe
  218. clr
  219. ; alle Tastendefinitionen werden gelöscht
  220. sprung
  221. .
  222. .
  223. Querverweise :
  224.  
  225.     Def        defGos
  226.  
  227. }
  228. DEF 'd' def
  229. DEF 'g' defgos
  230. TEXTAUSGABE 
  231. CLR 
  232. SPRUNG 
  233.  
  234. : def
  235. {        Tastendefintionen mit absolutem Sprung : DEF
  236.  
  237.  
  238. Befehl : DEF <ASCII>  <Zeilenmarke>        Abkürzung : D
  239.  
  240. Einer Taste wird ein Label zugeordnet. Wird während der Textausgabe die definierte Taste gedrückt, so wird die Textausgabe unterbrochen. Beim nächsten Aufruf von SPRUNG springt das Programm zu dem definierten Label. Die Definitionen werden mit CLR gelöscht.
  241.  
  242. Das ASCII-Zeichen kann inerhalb von einem Hochkomma stehen, muß aber nicht. Das Hochkomma wird beim Erzeugen einer Textdatei von CODE.EXE automatisch hinzugefügt. Es kann auch ein nicht darstellbares Zeichen angegeben werden. Das Format ist :
  243.  
  244. \<ASCII-WERT>
  245.  
  246. Der ASCII-WERT kann zwischen 0 und 255 liegen. Damit kann jedes ASCII- Zeichen definiert werden.
  247.  
  248. Beispiel :
  249.  
  250. DEF 1 Label2
  251. ; Taste '1' wird Label2 zugeordnet.
  252. DEF \13 Label1
  253. ; Dem ASCII- Wert 13 (entspricht RETURN) wird Label2 zugeordnet.
  254. DEF 'q' Label3
  255. ; Dem kleinem q wird Label3 zugeordnet.
  256. TEXTAUSGABE
  257. ; Textausgabe. Wird während der Textausgabe eine 1 gedrückt
  258. ; so wird beim Aufruf von S nach Label2 gesprungen,
  259. ; bei RETURN nach Label1
  260. ; und bei q nach Label2
  261.  
  262. Querverweise :
  263.  
  264.     Clr    defGos    Sprung
  265. }
  266. DEF 'c' clr
  267. DEF 'g' defgos
  268. DEF 's' sprung
  269. TEXTAUSGABE 
  270. CLR 
  271. SPRUNG 
  272.  
  273. : defgos
  274. {    Tastendefinitionen mit Sprung in ein Unterprogramm: DEFGOS
  275.  
  276.  
  277. Befehl : DEFGOS <ASCII>  <Zeilenmarke>        Abkürzung : DG
  278.  
  279. Definiert einen GOSUB-Sprung. Einer Taste wird ein Label zugeordnet. Wird während der Textausgabe die definierte Taste gedrückt, so wird die Textausgabe unterbrochen. Beim nächsten Sprungaufruf wird per GOSUB zum definierten Label gesprungen. Das heißt, das Programm merkt sich, von wo der Sprung ausgefüht wurde. Bei einem Return wird das Programm an dieser Stelle fortgefüht. Ein Return wird entweder durch den Befehl RETURN ausgelöst, oder wenn der Leser des Textordners ESC drückt, und dieses nicht durch RÜCKSPRUNG, DEF oder DEFGOS anders definiert ist.
  280.  
  281.  
  282. Beispiel :
  283.  
  284. DEFGOS 1 Label2
  285. ; Taste '1' wird Label2 zugeordnet.
  286. DEFGOS \13 Label1
  287. ; Dem ASCII- Wert 13 (entspricht RETURN) wird Label2 zugeordnet.
  288. DEFGOS 'q' Label3
  289. ; Dem kleinem q wird Label3 zugeordnet.
  290. TEXTAUSGABE
  291. CLR
  292. SPRUNG
  293. .
  294. .
  295. .
  296.  
  297. :LABEL2
  298. LOAD text
  299. TEXTAUSGABE
  300. ; Da keine Taste definiert wurde, wird die Textausgabe
  301. ; nur mit ESC beendet, und dies löst
  302. SPRUNG
  303. ; nach SPRUNG ein RETURN aus.
  304. .
  305. .
  306. .
  307. :Label1
  308. LOAD demo
  309. TEXTAUSGABE
  310. RETURN
  311. ; Rücksprung mit Return
  312. .
  313. .
  314. .
  315. :Label3
  316. RETURN
  317.  
  318. Querverweise :
  319.  
  320.     Return    Def        rüKschrung    Sprung    Clr
  321.  
  322. }
  323. DEF 'r' return
  324. DEF 'd' def
  325. DEF 'k' rücksprung
  326. DEF 's' sprung
  327. DEF 'c' clr
  328. TEXTAUSGABE 
  329. SPRUNG 
  330.  
  331. : goto
  332. {            Sprungbefehl : GOTO
  333.  
  334.  
  335. Befehl : GOTO  <Label>            Abkürzung : G
  336.  
  337. Das Programm wird an der Angegebenen Zeilenmarke fortgesetzt. Es findet ein unbedinger Sprung statt.
  338.  
  339. Beispiel :
  340.  
  341. TEXTAUSGABE
  342. GOTO Label1
  343. ; Springe nach Label1
  344. .
  345. .
  346. :Label1
  347. ; Hier wird die Programmabarbeitung fortgesetzt.
  348.  
  349. Querverweise :
  350.  
  351.     Gosub    Sprung
  352.  
  353. }
  354. DEF 'g' gosub
  355. DEF 's' sprung
  356. TEXTAUSGABE 
  357. SPRUNG 
  358.  
  359. : gosub
  360. {        Sprungbefehl zu einem Unterprogramm : GOSUB
  361.  
  362.  
  363. Befehl : GOSUB <Label>                Abkürzung : GOS
  364.  
  365. Das Programm wird bei dem angegebenen Label fortgesetzt. Nach einem RETURN springt das Programm zu dem Programmschritt nach dem GOSUB zurück.
  366. Ein Return wird entweder durch den Befehl RETURN ausgelöst, oder wenn der Leser des Textordners ESC drückt, und dieses nicht durch RÜCKSPRUNG, DEF oder DEFGOS anders definiert ist.
  367.  
  368.  
  369. Querverweise :
  370.  
  371.     Return    Goto        Sprung
  372. }
  373. DEF 'r' return
  374. DEF 'g' goto
  375. DEF 's' sprung
  376. TEXTAUSGABE 
  377. SPRUNG 
  378.  
  379. : load
  380. {        Texte laden : LOAD
  381.  
  382.  
  383. Befehl : LOAD  <Pfad+Filename>        Abkürzung : L
  384. oder     LOAD  <Filename>
  385. Load. Die angegebene Textdatei wird geladen, und steht zur Textausgabe zur Verfügung. Es muß ein gültiger DOS- Pfad angegeben werden, wenn nicht mit VERZEICHNIS einer definiert wurde. Wenn die Größe des Arbeitsspeicher es erlaubt, wird der Text im RAM gespeichert, und braucht beim nächsten Aufruf nicht mehr geladen zu werden. Die Endung .txt wird automatisch angehängt.
  386. Beispiel :
  387.  
  388. LOAD \asc\beispiel
  389. ; Der Text beispiel.txt im Verzeichnis asc wird geladen
  390. TEXTAUSGABE
  391. ; Text ausgegeben.
  392.  
  393. Querverweise :
  394.  
  395.     Verzeichnis
  396. }
  397. DEF 'v' verzeichnis
  398. TEXTAUSGABE 
  399. SPRUNG 
  400.  
  401. : rücksprung
  402. {         Definition eines Rücksprungs : RÜCKSPRUNG
  403.  
  404.  
  405. Befehl : RÜCKSPRUNG  <Label>        Abkürzung : R
  406. Rücksprung. Dieser Befehl ist eine Sonderform von DEF. Es wird die Rücksprungzeilenmarke definiert. Sie wird beim betätigen von ESC aufgerufen. Die Rücksprungadresse wird nach Aufruf, oder durch CLR gelöscht. Normalerweise wird nach dem Betätigen von ESC ein RETURN ausgelöst. Mit RÜCKSPRUNG kann jedoch eine eigene Sprungadresse definiert werden.
  407.  
  408. Beispiel :
  409.  
  410. RÜCKSPRUNG LABEL_52
  411. def \27 LABEL_52
  412. ; Beide Ausdrücke sind identisch
  413.  
  414. TEXTAUSGABE
  415. SPRUNG
  416. ;    Es wurde ESC gedrückt :
  417. .
  418. .
  419. .
  420. :LABEL_52
  421. ; Hier wird das Programm fortgesetzt.
  422.  
  423. Querverweise :
  424.  
  425.     Return    Clr        Def
  426.  
  427. }
  428. DEF 'r' return
  429. DEF 'c' clr
  430. DEF 'd' def
  431. TEXTAUSGABE 
  432. SPRUNG 
  433.  
  434. : sprung
  435. {            Sprung nach Textausgabe : SPRUNG
  436.  
  437.  
  438. Befehl : SPRUNG        Abkürzung : S
  439.  
  440. Es wird ein bedingter Sprung ausgeführt. Nachdem mit DEF, RÜCKSPRUNG und DEFGOS einigen Tasten Zeilenmarken zugeordnet wurden, und der Text mit TEXTAUSGABE ausgegeben wurde, übergibt die Textausgabe den Label, der mit der zum Abbruch führenden Taste korrespondierte. An diesem Label wird das Programm nach dem Aufruf von SPRUNG fortgesetzt. Die mit DEF und RÜCKSPRUNG definierten Label werden mit GOTO angesprungen, die mit DEFGOS mit GOSUB.
  441. Beispiel :
  442.  
  443. DEF 1 100
  444. ; Taste 1 wird die Zeilenmarke 100 zugeordnet.
  445. TEXTAUSGABE
  446. ; Der Text wird ausgegeben. Der Benutzer drückt nun die 1. Die
  447. ; Textausgabe wird unterbrochen
  448. SPRUNG
  449. ; Das Programm wird nun bei Zeilenmarke 100 fortgesetzt.
  450. .
  451. .
  452. : 100
  453. ; Hier wird das Programm fortsetzt.
  454.  
  455. Querverweise :
  456.  
  457.     Rücksprung    Defgos    deF
  458. }
  459. DEF 'r' rücksprung
  460. DEF 'd' defgos
  461. DEF 'f' def
  462. TEXTAUSGABE 
  463. SPRUNG 
  464.  
  465. : textausgabe
  466. {        Ausgabe eines Textes : TEXTAUSGABE
  467.  
  468.  
  469. Befehl : TEXTAUSGABE            Abkürzung : T
  470.  
  471. Textausgabe. Der Text wird auf dem Bildschirm ausgegeben. Man kann im Text mit den Tasten Bild auf und Bild ab blättern. Beendet wird diese Funktion mit dem Druck einer durch D definierten Tasten, oder durch ESC. Welche beim Aufruf von SPRUNG angesprungen wird.
  472.  
  473. Einige Tasten sind festgelegt
  474.  
  475.     - Page hoch    : Eine halbe Seite nach oben blättern
  476.     - Page runter    : Eine halbe Seite nach unten blättern
  477.     - ESC        : Beendet die Textausgabe, (siehe RÜCKSPRUNG)
  478.     - Pos1        : Blättern zum Anfang des Textes
  479.     - Ende        : Blättern zum Ende des Textes
  480.  
  481. Beispiel :
  482.  
  483. LOAD demo
  484. ; Das Programm demo wird geladen
  485. TEXTAUSGABE
  486. ; und auf dem Bildschirm ausgegeben.
  487.  
  488. Querverweise :
  489.  
  490.     Rücksprung    Sprung
  491. }
  492. DEF 'r' rücksprung
  493. DEF 's' sprung
  494. TEXTAUSGABE 
  495. SPRUNG 
  496.  
  497. : überschrift
  498. {            Überschriften definieren : ÜBERSCHRIFT
  499.  
  500.  
  501. Befehl : ÜBERSCHRIFT  <Text>            Abkürzung : U und Ü 
  502.  
  503. Überschrift. Es wird eine Überschrift definiert. Die Überschrift muß kleiner als 60 Zeichen sein. Sie wird immer dann ausgegeben, wenn die Texte keine eigenen Überschriften besitzten. Sie wird automatisch in die Mitte der Zeile gedruckt.
  504.  
  505.  
  506. Beispiel :
  507.  
  508. ÜBERSCHRIFT Hauptmenü
  509.  
  510. ; Als Überschrift wird 'Hauptmenü' definiert,
  511. ; und ausgegeben, wenn der Text keine eigene Überschrift besitzt.
  512. }
  513. TEXTAUSGABE 
  514. SPRUNG 
  515.  
  516. : verzeichnis
  517. {            Verzeichnis festlegen : VERZEICHNIS
  518.  
  519.  
  520. Befehl : VERZEICHNIS <Pfad>                Abkürzung : V
  521. Verzeichnis. Es wird der DOS- Pfad definiert, aus dem die Textdateien geladen werden.
  522.  
  523.  
  524. Beispiel :
  525.  
  526.  
  527. ; TWG wurde aus dem Verzeichnis e:\test\ gestartet :
  528. VERZEICHNIS asc
  529. ; Der Pfad für Dateien lautet nun : e:\test\asc\
  530. LOAD demo
  531. ; Es wird der File e:\test\asc\demo.txt geladen.
  532.  
  533.  
  534. VERZEICHNIS c:\kdv\asc
  535. LOAD text
  536. ; Es wird der File c:\kdv\asc\text.txt geladen.
  537.  
  538. Querverweise :
  539.  
  540.     Load
  541.  
  542. }
  543. DEF 'l' load
  544. TEXTAUSGABE 
  545. SPRUNG 
  546.  
  547. : Exit1
  548. {                Programmende : EXIT
  549.  
  550.  
  551. Befehl : EXIT            Abkürzung : X
  552.  
  553. Exit. Dieser Befehl beendet das Programm.
  554. Beispiel :
  555.  
  556. RÜCKSPRUNG ende
  557. ; Rücksprungzeilenmarke ist 'ende'
  558. TEXTAUSGABE
  559. ; Textausgabe, wird vom Benutzer mit ESC beendet.
  560. SPRUNG
  561. ; Springe zur Zeilenmarke 'ende'
  562. .
  563. .
  564. : ende
  565. EXIT
  566. ; Programmende
  567. }
  568. TEXTAUSGABE 
  569. SPRUNG 
  570.  
  571. : zeile
  572. {                Zeilenlabel : ZEILE
  573.  
  574.  
  575. Befehl : ZEILE            Abkürzung :  z oder :
  576. Label. Es wird ein Label definiert. Die Label können aus beliebigen Buchstaben und Zahlen bestehen. Zwei Zeilenmarken hintereinander sind unzulässig. Auch eine Bemerkung zwischen zwei Zeilenmarken ist nicht erlaubt.
  577.  
  578. Beispiel :
  579.  
  580. : Dies_ist_ein_Label
  581.  
  582. Label können beliebig lang sein. Lange Labelnamen verbessern die Lesbarkeit des Programmes, vergrößern aber die Tipparbeit. Ein Label muß aber aus einem Wort bestehen. Darum eignet sich der Unterstrich (_) gut, um verschiedene Wörter in einem Label unterzubringen.
  583.  
  584. Querverweise :
  585.  
  586.     Def    defGos    gOto        goSub    Rücksprung
  587.  
  588. }
  589. DEF 'd' def
  590. DEF 'g' defgos
  591. DEF 'o' goto
  592. DEF 's' gosub
  593. DEF 'r' rücksprung
  594. TEXTAUSGABE 
  595. SPRUNG 
  596.  
  597. : return
  598. {        Unterprogramm beenden : RETURN
  599.  
  600.  
  601. Befehl : RETURN        Abkürzung : ret
  602. Nach einem GOSUB oder einen Sprung der von DEFGOS eingeleitet wurde, erfolgt ein Rücksprung zu der Stelle, von welcher der Sprung eingeleitet wurde.
  603.  
  604.  
  605. Beispiel :
  606.  
  607. GOSUB unterprogramm
  608. ; Nach einem Return in 'unterprogramm' wird die Verarbeitung hier
  609. ; vortgesetzt.
  610. DEFGOS 'A' unterprogramm
  611. TEXTAUSGABE
  612. ; Die Textausgabe wurde mit 'A' abgebrochen.
  613. SPRUNG
  614. ; Der Label 'unterprogramm' wird angesprungen. Nach
  615. ; einem Return in 'unterprogramm' wird die Verarbeitung
  616. ; hier vortgesetzt.
  617. .
  618. .
  619. .
  620. : unterprogramm
  621. ; Der Label 'unterprogramm'.
  622. .
  623. .
  624. .
  625. RETURN
  626. ; Die Verarbeitung wird hier abgebrochen, und hinter dem GOSUB
  627. ; oder SPRUNG- Befehl, der nach 'unterprogramm' sprang,
  628. ; fortgesetzt.
  629.  
  630.  
  631. Querverweise :
  632.  
  633.     Gosub    Defgos
  634. }
  635. DEF 'g' gosub
  636. DEF 'd' defgos
  637. TEXTAUSGABE 
  638. SPRUNG 
  639.  
  640. : textanfang
  641. LOAD tanf
  642. TEXTAUSGABE 
  643. SPRUNG 
  644.