home *** CD-ROM | disk | FTP | other *** search
/ Vectronix 2 / VECTRONIX2.iso / FILES_01 / HSMODA04.LZH / SETTER.TXT < prev    next >
Text File  |  1994-05-07  |  8KB  |  196 lines
  1. SETTER.TTP, ein Konfigurator
  2. ****************************
  3.  
  4. (Note for the English reading people: The English version is appended on 
  5. the German, look for it!)
  6.  
  7. Die kleinen ASCII-Textfiles, mit denen viele Programme konfiguriert 
  8. werden, sind mir auf die Nerven gegangen. Sie haben zwar den Vorteil der 
  9. Änderbarkeit mit jedem Texteditor, liegen als Nachteil aber mit im 
  10. Verzeichnis rum und sind trotzdem oft nicht da, wo sie sein sollten.
  11.  
  12. Deshalb habe ich die Konfigurationsinformationen direkt im Programm 
  13. untergebracht und mit einer kurzen Erklärung versehen. Bei residenten 
  14. Programmen liegen diese Erklärungen natürlich im nichtresidenten Teil 
  15. (kein Problem bei Assemblerprogrammierung). Konfiguriert werden solche 
  16. Programme mit SETTER, das die Informationen und Erklärungen aus dem 
  17. Programm liest und die Konfiguration wieder im Programm speichert.
  18.  
  19.  
  20. Nutzung
  21. -------
  22.  
  23. Ab TOS1.04 oder mit einem entsprechenden Desktop-Ersatz zieht man das zu 
  24. bearbeitende Programm mit der Maus auf SETTER.TTP. Man kann SETTER auch 
  25. per Doppelklick starten (mit dem Desktop von TOS1.00 und 1.02 geht es nur 
  26. so) und den Namen (und eventuell Pfad) des zu bearbeitenden Programms per 
  27. Hand eintippen. SETTER erkennt mit sehr hoher Sicherheit automatisch, ob 
  28. das Programm konfigurierbar ist oder nicht.
  29.  
  30. Ist es konfigurierbar, so wird jeweils eine Option angezeigt und eine neue 
  31. Angabe dafür erwartet. Alle Eingaben werden mit der Return-Taste 
  32. abgeschlossen. Alles andere sollte sich selbst erklären. Zum Schlu₧ wird 
  33. noch gefragt, ob man die Änderungen wirklich speichern möchte.
  34.  
  35. Falls Fehler auftreten, hat SETTER einige Meldungen dafür übrig.
  36.  
  37.  
  38. Copyright
  39. ---------
  40.  
  41. SETTER.TTP darf zusammen mit diesem Text frei kopiert werden. Die C-Quelle 
  42. SETTER.C darf nur zusammen mit SETTER.TTP und SETTER.TXT kopiert werden.
  43.  
  44. Ich hafte natürlich in keinster Weise für irgendwelche Auswirkungen oder 
  45. Nichtwirkungen, die der Einsatz oder Nichteinsatz von SETTER.* hat.
  46.  
  47. Möglicherweise finden auch andere Programmierer SETTER nützlich, bitte, 
  48. ihr dürft es benutzen. Aber!:
  49. Wenn jemand eine erweiterte Version von SETTER in Umlauf bringt, mu₧:
  50. - diese ebenfalls frei kopierbar sein.
  51. - diese entsprechend gekennzeichnet sein.
  52. - er mir eine Nachricht, besser ein Exemplar, kostenlos zukommen lassen.
  53. Ich kann es nicht ausstehen, wenn jemand meine Spezifikation ändert. 
  54. Erweitern ist erlaubt und erwünscht, aber bitte keine bereits vorhandenen 
  55. Kommandos ändern.
  56.  
  57. Mein Dank gilt Wolfgang Wander, der diesen meinen C-Programmierversuch 
  58. entfehlert hat. (Sonst hätte ich SETTER nochmal, in Assembler, schreiben 
  59. müssen.)
  60.  
  61. "Ich" bin: Harun Scheutzow,
  62. zu erreichen im Internet über
  63. Harun_Scheutzow@B.maus.de
  64. bzw. im Mausnetz: Harun Scheutzow @B
  65. oder per Post:
  66. Harun Scheutzow
  67. Dresdener Stra₧e 83
  68. D-10179 Berlin, Deutschland
  69.  
  70.  
  71. GEM-Version von SETTER
  72. ----------------------
  73.  
  74. Ich habe SETTER der Einfachheit und Kürze wegen als TTP geschrieben. 
  75. Markus Kohm fand die Idee von SETTER gut und hat eine GEM-konforme Version 
  76. entwickelt, die einige Funktionen mehr bietet. Diese Version ist ebenfalls 
  77. in Mailboxen zu finden. Sie sollte als SETTER.ZIP in der Maus KA liegen. 
  78. Zum Zeitpunkt der Texterstellung gültige Daten der Maus KA: Telefonnummer 
  79. 0721-358887, Gastdownload 08.00-18.00 und 20.00-03.00. Markus Kohm ist per 
  80. Internet-Email unter: Markus_Kohm@KA2.maus.de zu erreichen.
  81.  
  82. Wer andere SETTER schreiben will oder weitere Datentypen braucht, sollte 
  83. sich zuerst diese GEM-Version ansehen.
  84.  
  85.  
  86. Versionen
  87. ---------
  88.  
  89. SETTER gibt beim Start das Erstellungsdatum als Jahr-Monat-Tag aus, wobei 
  90. neuere Versionen hoffentlich funktionell weiter- und fehlermä₧ig zurück- 
  91. entwickelt sind.
  92.  
  93. 1993-11-27  String-Eingabe implementiert
  94. 1994-01-09  Englische Meldungen ergänzt, minimale Korrektur
  95. 1994-05-07  Läuft jetzt auch unter TOS4.xx (auf Falcon)
  96.  
  97.  
  98.  
  99. (Der reine Anwender braucht nicht weiter zu lesen.)
  100. Spezifikation des Speicherns modifizierbarer Informationen in Programmen
  101. ------------------------------------------------------------------------
  102.  
  103. Harun Scheutzow, 21.11.1993
  104.  
  105. Die Modifikation erfolgt durch ein SETTER.TTP, welches das Programm 
  106. bearbeitet, dessen Einsstellungen zu verändern sind.
  107.  
  108. Im TEXT- oder DATA-Segment befindet sich auf einer geraden Adresse der 
  109. nullterminierte String "hAruNs cONfigER" (inklusive 0-Byte genau 16 Zeichen 
  110. lang) und dahinter ein LONG-Zeiger auf den Anfang des Strings. In 
  111. Assembler:
  112.  
  113.       .even
  114. hkbg:
  115.       .dc.b "hAruNs cONfigER",0
  116.       .dc.l hkbg
  117.  
  118.  
  119. Darauf folgen als Liste die einzelnen Objekte, die aus Anzeigetext, 
  120. Art der Konfiguration und Konfigurationsplatz bestehen.
  121.  
  122. Der Anzeigetext ist ein C-String (also nullterminiert) und auf die nächste 
  123. gerade Adresse evtl. mit einem zusätzlichen 0-Byte aufgefüllt. Ist der 
  124. Anzeigestring leer (nur 0-Byte), so endet hier die Liste der Objekte.
  125.  
  126. Das Konfigurationskommando ist ein WORD (16Bit) mit folgenden möglichen 
  127. Werten im Highbyte:
  128.  
  129. 0
  130. Ja/Nein Entscheidung. Das folgende WORD wird für JA auf $FFFF und für 
  131. NEIN auf $0000 gesetzt.
  132.  
  133. 1
  134. LONG-Werteingabe-Liste. Im Lowbyte steht die Anzahl der Listenelemente. 
  135. Die folgenden LONG werden auf die Werte der eingegebenen 32-Bit-Integer 
  136. gesetzt. Die interne ungültig-Kennung für einen Platz ist $80000000.
  137.  
  138. 2
  139. String-Eingabe. Im Lowbyte steht die Maximallänge des Eingabestrings 
  140. inklusive des abschlie₧enden Nullbytes. Diese Länge mu₧ gerade sein. Der 
  141. eingegebene String wird unmittelbar hier hinter abgelegt und bis zur 
  142. Maximallänge mit 0-Bytes aufgefüllt.
  143.  
  144.  
  145.  
  146.  
  147. SETTER.TTP
  148. **********
  149.  
  150. (Some parts translated from German to English on 1994-01-08 by Harun 
  151. Scheutzow. I have no time for translating all. Do it yourself!)
  152.  
  153. The small ASCII-files containing the configuration of many programs I 
  154. don't like. These files have the advantage of an easy changability by 
  155. using a text editor but the disadvantage of laying around in the 
  156. directory and being not on the right place.
  157.  
  158. That's why I placed the configuration direct in the program. I added a 
  159. short explanaition to every point. These explainations don't stay 
  160. resident in my resident programs, no problem for an assembler programmer. 
  161. The configuration of such programs is changed by using SETTER which reads 
  162. the information and explaination and saves the configuration in the 
  163. program again.
  164.  
  165.  
  166. Usage
  167. -----
  168.  
  169. From TOS1.04 up the use of SETTER is simple: Take the program to modify 
  170. with the mouse and drag it on SETTER.TTP. SETTER will start, load the 
  171. programm and start the configuration dialog or give a message, that 
  172. configuration is impossible because the program doesn't contain any 
  173. settings. For older versions of TOS: doubleclick SETTER.TTP and enter the 
  174. name and path of the program in the appearing dialog box. SETTER 
  175. recognizes with high safety whether the program contains a settings.
  176.  
  177. SETTER displays one setting after the other and waits for a new value for 
  178. this setting. After every input the Return key has to pressed. The last 
  179. question of SETTER is whether or not to save the changes.
  180.  
  181. SETTER gives some error messages if errors occur.
  182.  
  183. SETTER displays _its_ messages in German and English. The explainations 
  184. in the programs SETTER displays only in the language in which they are.
  185.  
  186.  
  187. Copyright
  188. ---------
  189.  
  190. SETTER.TTP may be freely copied together with this text. The C-source may 
  191. only be copied together with SETTER.TTP and SETTER.TXT.
  192.  
  193. You use SETTER on your own risk!
  194.  
  195. (see German part ...)
  196.