home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: Alpha / Whiteline Alpha.iso / progtool / gfabasic / gfashell / readme.doc < prev    next >
Encoding:
Text File  |  1994-09-22  |  12.8 KB  |  381 lines

  1. 07201010101800
  2. 1
  3. 2
  4. F0110030
  5. 9[........................................................]001
  6. Ç
  7. GFASHELL.PRGV.1.0
  8. ==================
  9. Versionvom18-SEP-1989
  10. VORWORT:
  11. ========
  12.  
  13. NachlangemwartenwarderCompilerfürdasGFA-BasicVersion3.0nun
  14. endlicherschienen.MitzittrigenHändenwurdederUmschlaggeöffnetund
  15. diedarinliegendeDisketteindieFloppygeschoben.Dochwasistdas?
  16. NachdemStartvonGFA_BCOM.PRGpassiertenichtdaswasmanbishervom
  17. GFA-Compiler(V.2)gewöhntwar.Alsohalfnichts,dasHandbuchmußte
  18. dochnochaufgeschlagenwerden.(WerliestdennnochHandbücher?)Aha,
  19. MENUX.PRGmußgestartetwerden,wärhättedasgedacht.Parametergehören
  20. auchnochdazu.WasbedeutetnunschonwiederS>inderParameterliste,
  21. woistdennschonwiederdasHandbuchhin?HILFEwobleibtdiebisher
  22. gewohnteArbeitsumgebung?!!
  23.  
  24. Eshalfnichts.WaseinrichtigerProgrammiererist,dermachtsichhalt
  25. seineArbeitsumgebungselbst.Soentstandalsoinschweißtreibenden
  26. NächtendieGFASHELL.
  27. 
  28. SinndiesesProgrammesistesalsodieArbeitmitGFA-Basic3.0zu
  29. vereinfachen,undwoichgeradedabeiwarkamendannnocheinpaar
  30. kleineExtrasdazu.DasProgrammistweitgehendselbsterklärend
  31. geschrieben,abertrotzdemfolgthiereinekleineBeschreibung:
  32.  
  33.  
  34. BEDIENUNGSANLEITUNG:
  35. ====================
  36.  
  37. (Wennsiejemalsvonirgendwemgelesenwird)
  38.  
  39.  
  40. ZudemProgrammgehörendieDateien:
  41. GFASHELL.PRG(DaseigentlicheProgramm)
  42. GFASHELL.RSC(DiedazugehörendeResource-Datei)
  43. GFASHELL.INF(DateimitDefaultwertenfürdieSHELL)
  44. README.TXT(DieseDateilesenSiegerade)
  45. README.DOC(DasselbeinWORDPLUS-Format)
  46. DieerstendreiDateienmüssenimselbenOrdnerliegen(z.B.:GFA_3).
  47. DieMindestkonfigurationisteinSpeicherplatzvonmindestens520K,ein
  48. einseitigesLaufwerksowieeinSM124Monitor(RealProgramersdon'tuse
  49. color!).EineFestplatteodereineRAMDISKerhöhendieGeschwindigkeit.
  50. EinDruckeristnatürlichimmerempfehlenswert.
  51.  
  52. Ç
  53. 1.Programmstart:
  54. =================
  55.  
  56. BevorSiedasProgrammstarten,solltenSieüberprüfen,obdieAngaben
  57. inGFASHELL.INFIhrerArbeitsumgebungentspricht.
  58. DieOriginaldateisiehtwiefolgtaus:
  59.  
  60.  
  61.     '
  62.     ' INFO-FILE FUER GFAASHELL
  63.     ' ************************
  64.     '
  65.     ' STANDARTNAMEN FUER COMPILE UND LINK
  66.     '
  67.     G3OBJ=F:\GFA_3\TEST.O
  68.     G3PRG=F:\GFA_3_TEST.PRG
  69.     '
  70.     ' PROGRAMME DIE VON GFASHELL DIREKT AUSGEFUEHRT WERDEN
  71.     '
  72.     G3LIB=F:\GFA_3\GFA3BLIB
  73.     G3INT=F:\GFA_3\GFABASIC.PRG
  74.     G3COM=F:\GFA_3\GFA_BCOM.PRG
  75.     G3LNK=F:\GFA_3\GL.PRG
  76.     G3RCS=F:\GFA_3\RCS2.PRG
  77.     '
  78.     ' KANN BEI BEDARF GESETZT WERDEN:
  79.     '
  80.     ' SHELL=
  81.     '
  82.     'STANDARTPFADFÜRFILESELECTORBOX
  83.     '
  84.     G3PTH=F:\GFA_3\MAKE\
  85.  
  86. Kommentarzeilenwerdenmit',!oder;gekennzeichnet.AmAnfangundam
  87. EndejederZeilekönnenbeliebigvieleBlanksstehen.DieReihenfolge
  88. derDefinitionenkannfreigewähltwerden.SolltenParameternicht
  89. definiertsein,werdenautomatischdieDefaultwerteausdemHandbuch
  90. genommen.
  91.  
  92.  
  93.  
  94. 2.INFOS
  95. ========
  96.  
  97. SiehabendasProgrammschongestartet?DannhabenSiejaschongesehen
  98. wiesichdasganzeaufdemBildschirmdarstellt.
  99.  
  100. DerweißeKastenobenbeinhaltetdiesehrwichtigeMitteilungwiedas
  101. Programmheiβt,undvonwemeserstelltwurde.WennSiedieseBOX
  102. anklickenerscheinteinbiβchenWerbungfürmich.Siehabennundie
  103. Möglichkeitmit"ZURUECK"wiederindieSHELLzurückzukehren,odersich
  104. mit"PARAMETER"alleaktuellenWertederSHELLanzeigenzulassen.Wenn
  105. SiesichsattgesehenhabengenügteinMausklickundSiesindwiederin
  106. derSHELL.
  107.  
  108. Ç
  109. 3.Arbeiten
  110. ===========
  111.  
  112. DerKastenunterdenInformationenistfürdieDefinitionender
  113. Standard-Datei-NamenundzumAufrufderGFA-Programmegedacht:
  114.  
  115. EDIT     AufrufdesGFA-Basic-Interpreters
  116. COMPILEAufrufdesGFA-Basic-Compilers
  117. LINK     AufrufdesGFA-Basic-Linkers
  118. MAKE     AufrufdesCompilers,unddesLinkershintereinander
  119. RCS      AufrufdesResource-Construktion-Sets
  120. TEST     AufrufdeszuletztcompiliertenProgrammes
  121.  
  122. GFA      Bestimmungdes*.GFAFiles
  123. OBJ      BestimmungdesObjekt-Files
  124. PRG      BestimmungdesProgramm-Files
  125. LIB      BestimmungderLibrary
  126. C-OBJ    BestimmungdesC-Objekt-Filesdasdazugelinktwerdensoll
  127.  
  128. OBJ=GFA  ObjektfilenimmtautomatischdenNamendesGFA-Filesan.
  129. PRG=GFA  ProgrammfilenimmtautomatischdenNamendesGFA-Filesan.
  130.          (Wennhatesnichtschongestört,daßalleProgrammeTEST.*
  131.          genanntwerden?)
  132. G3WAIT   G3WAITeinoderausschalten(s.Handbuch)
  133. G3MOVE   G3MOVEeinoderausschalten(s.Handbuch)
  134. COMMAND  RufteinenCOMMAND-LINE-INTERPRETERauf.Standardmäβigwirdeine
  135.          abgespeckteaufdieSHELLangepaβteVersiondesLCI'sbenutzt.
  136.          WenninGFASHELL.INFeineandereSHELLbenanntistwird
  137.          natürlichdiesebenutzt.(Mankannnatürlichaucheinnormales
  138.          Programmdefinieren,unddannz.B.Raumschiffeabballern,
  139.          Malen,Briefeschreibeno.Ä.)
  140.  
  141. EXIT     AllesaufdieserErdeistvergänglich,soauchdieGFASHELL.
  142.  
  143.  
  144. 4.Parameter
  145. ============
  146.  
  147. DieBedienungderParametereinstellungentsprichtinetwaderBedienung
  148. vonMENU.PRGbzw.MENUX.PRG,nuristallesaufeinenBlick,imKlartext
  149. ohneständigesnachschlagenimHandbuchsichtbar.DiegenaueBedeutung
  150. derParameteristrechtausführlichimHandbuchbeschrieben.Leutedie
  151. ihrenCompiler"zufällig"aufeinerihrerDiskettenentdeckthaben,
  152. solltensichvielleichtdochnochdenCompilerkaufen.Ichverratehier
  153. nichts.
  154.  
  155. Ç
  156. 5.LittleCommandInterpreter(LCI)
  157. ===================================
  158.  
  159. AlskleinesExtraistinderGFASHELLeinkleinerKommandointerpreter
  160. eingebautderdiewichtigstenBefehlefüreinsinnvollesArbeiten
  161. beherrscht.
  162.  
  163. SyntaxderBeschreibung:
  164. ========================
  165.  
  166. KOMMANDOPARAMETERPARAMETER
  167.  
  168. inKlammern()=>kannzusätzlichzumKommandoeingegebenwerden
  169. [nnnn]        =>kannoptionalbenutztwerden
  170. filespec      =>[Laufwerk:][\ORDNER...\]DATEINAME.EXTENSION
  171.  
  172.  
  173.  
  174. CD[filespec]
  175.          WechseltdasVerzeichniss
  176.          BeispielCDA:\GFA\      gehtnachA:\GFA\
  177.                   CD              wechseltindasVerzeichnissdasmit
  178.                                   SETPATHdefiniertwurde
  179.  
  180. CLS
  181.          löschtdenBildschirm
  182.  
  183. DEL(ETE)filespec(ohneWildcards)
  184.          löschtangegebeneDatei
  185.          Beispiel:DELTEST.OlöschtdieDateiTEST.O
  186.  
  187. DFREElaufwerk
  188.          zeigtdenfreienSpeicherplatzaufdemangegebenLaufwerk
  189.  
  190. DIR[filespec][filespec]
  191.          Inhaltsverzeichnisvon1.Parameterauf2.Parameter
  192.          Beispiel:DIRgibtalleDateiendesaktuellenOrdnersaus
  193.                    DIRA:\TEST\*.GFAzeigtalle*.GFA-FilesaufA:\TEST
  194.                    DIR*.*LST:DrucktdenInhaltdesaktuellenOrdners
  195.  
  196. EXIToderQUIT
  197.          ZurückzurSHELL.KannauchmitQUIToderdurchdrückenvon
  198.          "UNDO"erreichtwerden.
  199.  
  200. FREE
  201.          ZeigtdenfreienSpeicheran
  202.  
  203. HELP
  204.          ZeigtdiebekanntenKommandosan
  205.  
  206. MKDIR filespec   
  207.          ErzeugteinenOrdner
  208.  
  209. PRINTfilespec
  210.          GibtdieangegebeneDateiaufdenDruckeraus
  211.  
  212. REN(AME)filespecfilespec
  213.          Verändert1.Dateinamenin2.Dateinamen.Gehtnuraufaktuellen
  214.          Laufwerk.
  215.          Beispiel:RENAMETEST.O\GFA_3\HUGO.O
  216.  
  217. RMDIRfilespec
  218.          LöschteinenOrdner
  219. Ç
  220. SETparameterparameter
  221.          setztverschiedeneWerte
  222.  
  223.     SETDATEdatum
  224.          BeigültigerDatumsangabewirddasSystemdatumgeändert
  225.     SETTIMEzeit
  226.          BeigültigerZeitangabewirddieSystemzeitgeändert
  227.     SETPATHpfad
  228.          VerändertdenStandardsuchpfadderGFASHELL
  229.     SETPROMPTstring
  230.          VerändertdasEingabezeichen(Maximal6Stellen)
  231.  
  232. SH(OW)parameter
  233.          zeigtverschiedeneWerte
  234.  
  235.     SHOWGFA(SHELL)
  236.          zeigtdieaktuellenGFASHELLParameter
  237.     SHOWDATE
  238.          zeigtdasSystemdatum
  239.     SHOWDIR
  240.          zeigtdasaktuelleVerzeichniss
  241.     SHOWTIME
  242.          zeigtdieSystemzeit
  243.     SHOWPATH
  244.          zeigtdenaktuellenGFA-SHELLPfad
  245.     SHOWMEMORY[SYSTEM]
  246.          zeigtdenfreienSpeicheran
  247.     SHOWMEMORYINTERN
  248.          zeigtdenfreienSpeicherderGFASHELLan
  249.  
  250. TYPEfilespec
  251.          gibtdieangegebeneDateiaufdemBildschirmaus
  252.  
  253. PURGE
  254.          löschtalle*.BAKDateienimaktuellenVerzeichniss
  255.  
  256. ProgrammewerdendurchEingabedesPfadesunddesDateinamens(ohne
  257. Extension)gestartet.LCIüberprüftobeinausführbaresProgrammmit
  258. diesenAngabenbesteht.Bzw.:ohnePfadangabewirdgeprüftobein
  259. ProgrammimOrdner\BINoderomdefiniertenPfad(mitSETPATH)mit
  260. diesenAngabenexistiert.LCImerktsichdieletzten10Eingaben(auch
  261. nachverlassenvonCOMMAND).DiesekönnendurchdiePfeiltastenUPund
  262. DOWNwiederaufgerufenundeditiertwerden.
  263.  
  264. Ç
  265. 6.Publik-Domain
  266. ================
  267.  
  268. NichtvergessendarfichnatürlichdenHinweisaufmeinarmesKonto:
  269. DasProgrammistalsPublikDomainSoftwarefreigegeben,d.H.dieses
  270. Programmdarffreikopiertundweitergegebenwerden.Dabeimüssendie
  271. DateienGFASHELL.PRG,GFASHELL.INF,README.TXTundREADME.DOCmit
  272. kopiertwerden.
  273.  
  274. UmaberwenigstenseinenTeilmeinerUnkostenfürKaffeeundZigaretten,
  275. diebeiderErstellungdiesesProgrammesverbrauchtwurden,wieder
  276. zurückzubekommen,bitteichjedenderdiesesProgrammgebrauchenkann,
  277. mireinenkleineren(oderauchetwasgrößeren)BetragzuÜberweisen.
  278.  
  279. Ab20,00DMwirdmanregistrierterBesitzer.(RegistrierteBesitzer
  280. erhaltenvonmirautomatischdasnächsteUpdatezugesandt,undbekommen
  281. vommirbeiBedarfeineindividuelleBeratung.)
  282.  
  283. AnsonstenbinichfürAnregungen,Verbesserungsvorschläge,Lobundauch
  284. Beschimpfungenimmerzuhaben.EinkurzerBriefanmichgenügt.Antwort
  285. gibtesgarantiert.
  286.  
  287. Evntl.FehlermeldungenbittemitgenauerBeschreibungdesFehlers(s.
  288. Anlage)undderVersionsnummerdesProgrammsanmichsenden.Ich
  289. benötigedazueineDiskettemit:a)derGFASHELL.INFundb)evntl.dem
  290. geradebearbeitetenFiles*.GFA*.O....DieDiskettegibtes
  291. garantiertwiederzurück(natürlichmitderneustenGFASHELLVersion).
  292.  
  293. RalfLenz
  294. Gluckensteinweg71
  295. 6380BadHomburg
  296.  
  297. Konto:17837228BLZ:50052009KreissparkasseBadHomburg
  298.  
  299. P.S.DenServicemitdenFehlermeldungengibtesnatürlichnurfür
  300. registrierteBesitzerderGFASHELL.Ansonstenhilftnurwartenaufdie
  301. nächsteVersiondieinderPD-Scenekursiert.
  302.  
  303. P.P.S.Fanpost,DrohbriefeundAnregungendarfmirauchjederandere
  304. zusenden.
  305.  
  306.  
  307. Ç
  308. FEHLERMELDUNG
  309. =============
  310.  
  311. êAdresseÇName:
  312.          Straße:
  313.          PLZ,Ort:
  314.          Tel.:
  315.  
  316.  
  317. BeimBenutzenvonderGFASHELLV1.0istfolgenderFehleraufgetreten:
  318.  
  319. (BittehierdenFehlergenaubeschreiben,evntl.Blattanfügen.)
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336. ------------------------------------------------------------------------
  337.  
  338. DerFehlerist    []reproduzierbar
  339.                    []nichtreproduzierbar
  340.  
  341. DerFehlertrataufim[]Diskettenbetrieb
  342.                            TypderFloppy:______________
  343.  
  344.                         []Festplattenbetrieb
  345.                            TypderFestplatte:________________
  346.                            Treiber:___________________________
  347.                         TURBODOSgeladen[]Ja[]Nein
  348.                            CACHE-Programmgeladen[]Ja[]Nein                            
  349.                            (wennja,welches?:________________)
  350.  
  351.                         []RAM-Diskbetrieb
  352.                         NamedesRAMDISK-Programms:________________
  353.     
  354. IchbesitzefolgendeKonfiguration:
  355.  
  356. TOS-Version:____________[]imROM[]aufDiskette
  357.  
  358. ST-Typ[]520ST[]520ST+[]260ST[]520STM
  359.         []1040ST[]1040STM[]MegaST2[]MegaST4
  360.     []anderen:__________________________
  361.  
  362. beiDruckerfehlern:
  363.  
  364.         Druckertyp:__________________
  365.  
  366.     Spoolergeladen[]Ja[]Nein
  367.         wennja,welcher?:____________________
  368.  
  369.         Schnittstelle:[]Seriell[]Parallel
  370.  
  371. MeinGFA-BasicInterpreterhatdieVersionsnummer3.__
  372. MeinGFA-BasicCompilerhatdieVersionsnummer:3.__
  373.  
  374.  
  375.