====================================================================== GaBi - GFA-BASIC FD-Serie "ReadMe": Eigene GaBi-Beiträge,Informationen,u.a. ====================================================================== Einleitung ---------- GFA-BASIC ist wie keine andere Programmiersprache dazu geeignet sich weit zu verbreiten.Die Sprache ist leicht zu erlernen,bietet aber zugleich viele Funktionen,die auch einen fortgeschrittenen Programmierer zufrieden stellen.Auch gestaltet sich die Programmentwicklung so leicht,wie in kaum einer anderen Sprache.Man entwickelt ein Programm im Interpreter,und wenn es fehlerfrei läuft,kompiliert man es.Da es im Gegensatz zu AmigaBASIC strukturiert ist,lassen sich einmal erstellte PROCEDUREn und FUNCTIONen leicht in andere Programme übernehmen,ohne daß sich Probleme wie in AmigaBASIC einstellen.Wovon ich spreche,weiß jeder,der schon mal ein fremdes AmigaBASIC-Programm analysieren wollte.Allerdings läßt sich in jeder Sprache Spaghetti-Code schreiben,da sind auch die ach so "großen" Sprachen C und Modula-2 nicht ausgenommen,obwohl besonders erstere dafür berühmt ist. Ich habe den Aufbau der Disketten,die Aufmachung dieses und des Inhalt- Textes und das Inhalt-Icon übernommen.Die Texticons sehen zwar auch AMOK mäßig aus,wurden aber von mir gezeichnet. Falls Sie also Programme oder Routinen geschrieben haben, von denen Sie denken,daß auch andere sie gebrauchen können, schicken Sie sie an GaBi. Wenn möglich,dann werde ich sie aufnehmen.Allerdings sollten dabei die folgenden Punkte beachtet werden,damit die Programme und Routinen auch für alle nützlich sind.Ich stelle allerdings keine besonderen Anforderungen an die eingesandten Programme und Routinen. 1) Kriterien ------------ Wie gesagt,ich stelle keine besonderen Anforderungen an die eingesandten Beiträge,aber das Programm bzw. die Routine sollte den Zweck schon korrekt erfüllen und nicht dauernd den Guru hervorkitzeln. 2) GaBi Anforderungen --------------------- Folgendes muß von allen Beiträgen eingehalten werden. - Zu jedem Beitrag gehört eine Anleitung. · Dokumentation in einer Extra-Datei mit der Endung ".dok" (für die deutsche Dokumentation) oder ".doc" (für die englische) · möglichst gut dokumentierter Sourcecode Die Dokumentation sollte mindestens diese Informationen beinhalten: · Bedeutung und Auswirkung der PROCEDURE/FUNCTION-Parameter · Funktion und Verwendungszweck der Prozeduren und Funktionen · Bedeutung der Rückgabewerte der Funktionen · Hinweise auf mögliche Fehler (wenn bekannt) · Angaben über Einschränkungen oder Warnungen Die deutsche Dokumentation darf nicht fehlen,die englische ist freiwillig. - Der Source-Code sollte den Programmen immer beigefügt werden. Schließlich sollen andere Programmierer aus Ihrem Programm etwas lernen können, daß Rad braucht ja nicht zweimal erfunden zu werden. Außerdem ist es dann möglich, eventuelle Fehler zu verbessern oder das Programm an eigene Bedürfnisse anzupassen.Dies ist allerdings kein Zwang,erhöht aber die Chance,daß das Programm veröffentlicht wird. - Alle Dateien und Verzeichnisse,mit Ausnahme des .GFA-Sourcecodes, müssen mit Icons ausgestattet werden,auch die eventuell vorhandenen .LST-Dateien.Die Icons für Textdateien und Verzeichnisse sollten möglichst den GaBi-Icons entsprechen. - Die Programme sollten sich so verhalten,wie es in einem Multitasking- System sein sollte,d.h. alle Programmierkonventionen müssen eingehalten werden.Eine Ausnahme sind allerdings Spiele,die sowieso nur alleine laufen, wie z.B. Action-Spiele,allerdings stellt sich hier die Frage,ob sich für sowas nicht doch C oder Assembler besser eignet. Viel Spaß,Nils