X11-BASIC Version 1.25 Benutzerhandbuch

Dieses Dokument beschreibt die Funktionen von X11-Basic. Sie finden Informationen zum X11-Basic-Interpreter (das Programm xbasic unter Unix oder xbasic.exe unter Windows) und dem Compiler (das Programm xbc unter UNIX oder xbc.exe unter Windows) sowie zur Sprache selbst. Für eine kompaktere Beschreibung bzw. Einführung möchten Sie vielleicht die man-page x11basic(1) oder die man-page des X11-Basic-Compilers xbc(1) jeweils von Fall zu Fall zu rate ziehen.

Die neuesten Informationen und Updates sowie neue Versionen von X11-Basic finden Sie unter http://x11-basic.sourceforge.net/ .

Schön, daß Sie sich für mein kleines Projekt X11-Basic interessieren. Es wird gelegentlich der Wunsch an mich herangetragen, das Benutzerhandbuch zur Programmiersprache, welches es derzeit nur in einer englischen Version gibt, ins Deutsche zu übersetzten. Da ich froh bin, daß es ein einigermaßen brauchbares Handbuch überhaupt gibt und kaum Zeit habe, noch eine deutsche Version zu machen, werde ich an dieser Stelle wenigstens einige grundlegende Hilfestellungen zum Benutzen der Programmiersprache X11-Basic geben.

Aus dem kleinen Projekt ist inzwischen über die Jahre eine recht ansehnliche und rubuste Programmierumgebung geworden, von der man in den 80er Jahren des vergangenen Jahrhunderts nur träumen konnte. Dennoch hat sich in Sachen IT-Technik, Programmieranwendungen und auch Programmiertechniken seitdem einiges getan, so daß X11-Basic heutigen Ansprüchen an eine zeitgemäße Entwicklungsumgebung nicht genügt. Das war aber auch nie so gedacht. X11-Basic richtet sich nicht an den (angehenden) professionellen Programmierer, sondern mehr an den mathematisch interessierten Programmier-Laien, oder zumindest an solche, welche zu faul sind, sich die Eigenheiten heutiger Programmiersprachen anzulernen, nur um ein etwas komplexeres Problem rechnerisch umzusetzen. Diese Diskrepanz zwischen Computerprogrammierung und Umsetzen von mathematischen Algorithmen hat es schon immer gegeben, und das war nicht zuletzt der Grund, warum die BASIC Programmiersprache vor mehr als 50 Jahren überhaupt entstanden ist.

Um es kurz zu machen: Suchen Sie eine Programmiersprache, mit der Sie Anwenderprogramme mit Benutzerschnittstellen, evtl. sogar Apps für Smartphones oder dergleichen machen wollen, nutzen Sie besser gleich die dort übliche Programmiersprache. Dann lohnt es sich auch, die zu lernen. Ihre App wird sowieso nicht an einem Tag fertig lauffähig sein. Dafür bekommen Sie aber massenhaft Hilfe im Internet in einschlägigen Foren. Die meisten Probleme, die Sie treffen werden, hat eh schon jemand vor Ihnen gelöst. Sie müssen sie nur finden, abwandeln und für Ihre App einsetzen.

X11-Basic hingegen würden Sie nutzen, wenn Sie eine neue Idee für einen Algorithmus schnell ausprobieren wollen. Die Stärken von X11-Basic sind seine Rechenfähigkeit. Sie können leicht mit komplexen Zahlen, beliebig großen ganzen Zahlen oder auch nur mit normalen rationalen Zahlen Berechnungen anstellen. Es gibt weiterhin Funktionen, um mit Matritzen zu rechnen. Nebenbei ist X11-Basic recht schnell in der Ausführung, und es bedarf nur einer kurzen Lernphase, bis Sie ihr erstes Programm schreiben und laufen lassen können. Die graphischen Fähigkeiten helfen Ihnen dabei, die Berechnungen auch plastisch und in Farbe darzustellen. Schliesslich eignet sich X11-Basic auch besonders für Datenmanipulationen aller Art, dank einer vollständigen Implementierung aller I/O-Funktionen des Betriebsystems.

Wenn Sie jetzt denken, dass X11-Basic dann doch recht eingeschränkt ist, so darf ich Sie beruhigen: X11-Basic erlaubt fast alles, was das Betriebsystem an Dateimanipulationen, Datenverarbeitung direkten Speicherzugriff etc. ermöglicht. Und das trotzdem weitgehend unabhängig vom tatsächlich eingesetzten Betriebsystem (ob WINDOWS, Linux oder Android).

Genug der einführenden Worte. Installieren Sie einfach X11-Basic, und sehen Sie selbst.

Warscheinlich möchten Sie sofort ein Programm schreiben und zum Laufen bringen. Hierzu müssen Sie wissen, dass X11-Basic Programme ganz normale Textdateien mit der Endung .bas sind. Diese müssen Sie erstellen und zwar mit einem Text Editor. Das Schreiben eines X11-Basic Programms geht also nicht mit X11-Basic selbst sondern mit einem separaten Programm. Ein solches müssen Sie also noch besorgen, wenn es noch nicht auf Ihrem Computer installiert ist. Unter Android installieren Sie eine entsprechende App aus dem Play-Store, z.B. "Jota Text Editor". In Windows können Sie den vorhandenen aber sehr rudimentären Editor "notepad" benutzen. Nach einer Weile werden Sie herausfinden, was Ihnen in Notepad fehlt und dann vielleicht eine bessere Alternative installieren. In Linux sind üblicherweise bereits jede Menge Texteditoren installiert. Versuchen Sie mal gedit.

Erwähnenswert ist vielleicht noch, daß Sie in Android nach der Installaiton des Editors direkt von der X11-Basic App über MENU→Editor in den Editor ihrer Wahl gelangen können. Nach Beendigung des Editors wird das Programm dann automatisch in X11-Basic neu geladen, so daß Sie es gleich starten können.

Was für ein Programm sollen Sie schreiben? Wenn Sie noch nichts anderes wissen, schreiben Sie die drei Zeilen

in die Datei und speichern sie als hallo.bas ab.

In Android laden Sie die Datei mit MENU→Load, dann MENU→Run zum Starten. In Windows ziehen Sie die Datei einfach auf den Interpreter xbasic.exe, lassen Sie los und Ihr Programm wird gestartet. In Linux öffnen Sie ein Terminal und geben xbasic hallo.bas ein. Und schon gehts los. Mehr müssen SIe für den Anfang nicht wissen, um losprogrammieren zu können.

Sie müssen Sich nun nur noch anlernen, wie man Berechnungen in BASIC formuliert, und was all die einzelnen Befehle machen. Diese Informationen finden Sie im Benutzerhandbuch (in den Kapiteln weiter unten) bzw. in der integrierten Hilfe der Android Version der X11-Basic App.

Vielleicht erinnern Sie sich an GFA-Basic (z.B. für den ATARI ST aus den 80er Jahren), dann kennen Sie die meisten Befehle schon.

Der X11-Basic-Dialekt wurde so konzipiert, dass sie soweit möglich plattformunabhängig ist. Sie können also erwarten, dass X11-Basic-Programme auf vielen Betriebssystemen laufen, und überall etwa dasselbe tun und das gleiche Aussehen produzieren. X11-Basic-Programme sind portabel.

X11-Basic wurde entwickelt, um auf vielen Betriebsystemen mit extrem niedrigen Ressourcen zu laufen. Es wurde ursprünglich für UNIX-Workstations und Linux-Systeme mit dem X-Window-System entwickelt.

Nichtsdestotrotz wurden bald X11-Basic Versionen auch für andere Betriebssysteme (MS WINDOWS, MAC OSX, ATARI ST / TOS) erstellt.

In den Fällen, in denen kein X11-Fenstergrafiksystem vorhanden ist, kann X11-Basic stattdessen auch mit einer Unterstützung des Framebuffers kompiliert werden. Die Android-Version z.B. verwendet die Framebuffer-Schnittstelle. Ebenfalls ist eine solche Implementierung für die TomTom-Navigationsgeräte und für den Raspberry Pi (ohne X.org) möglich. Die SDL (= Simple Direct-Media Library) wird ebenfalls unterstützt als alternative Grafik-Engine. Die MS-Windows-Version nutzt dies. Aber es ist auch möglich, SDL-Unterstützung für andere Betriebssysteme in X11-Basic hinein zu kompilieren.

So ist es auch möglich, X11-Basic auf sehr einfachen Systemen, den sogenannten embedded (=eingebettete) Systemen mit einer sehr geringen Menge an RAM und bei kleiner Prozessorleistung zu portieren.

Schließlich ist es sogar möglich, eine Version von X11-Basic ohne Grafik zu kompilieren. Auf diese Weise entsteht eine sehr leichte Skript-Engine, z.B. zum Aufbau von Servern.

Sound ist nicht auf jedem System verfügbar. Wo es verfügbar ist, nutzt X11-Basic einen 16-Kanal-Sound-Synthesizer sowie die Möglichkeit, Sound-Samples aus Standard-Sounddateiformaten (wie .wav und .ogg) abzuspielen. Auf LINUX-Systemen wird das meist durch die ALSA Sound-Engine ermöglicht. Auf dem Android-Betriebsystem nutzt X11-Basic zusätzlich das Android-Sprachmodul.

Die X11-Basic-Bibliothek enthält eine grafische Benutzerschnittsteölle (GUI), welche dem GEM nachempfunden ist. Dies macht das Schreiben von GUI-Programmen in X11-Basic schneller, einfacher und portabler als das Programmieren mit jeweils nativen GUI-Tools.

Die Android-Version von X11-Basic enthält eine voll ausgestattete farbige VT100/ANSI Terminalemulation und Unterstützung für Unicode-Zeichensätze (UTF-8 codiert) auf der Standardausgabe für Text.

X11-Basic ist eine strukturierte prozedurale Programmiersprache. Struktur ist eine Form der visuellen und funktionalen Verkapselung, in denen mehrzeilige Abschnitte des Programms sich wie einzelne Einheiten verhalten und aussehen. Anfang und Ende der Blöcke sind mit aussagekräftigen Schlüsselwörtern markiert.

Im Gegensatz zu traditionellen BASIC-Implementierungen werden Zeilennummern in X11-Basic nicht verwendet. Jede Zeile enthält nur eine Anweisung. Sprünge mit GOTO sind möglich, aber nicht notwendig. Alle gebräuchlichen Schleifentypen sind verfügbar sowie zusätzliche Kommandos zum vorzeitigen Abbrechen (-→ EXIT IF, BREAK).

Prozeduren und Funktionen können mit Rückgabewerten beliebigen Typs definiert werden. Auf diese Weise können BASIC-Programme modular aufgebaut werden. Ein Programm kann einen Hauptteil enthalten, von dem aus Unterfunktionen und Unterprozeduren aufgerufen werden können, die in der gleichen Quelldatei definiert sein können (aber nicht unbedingt müssen). Einzelne Quellen können eine Bibliothek bilden. Ganze Bibliotheken können mit dem Zusammenführungsbefehl (-→ MERGE) hinzugefügt werden.

Um die Portierung von ANSI-Basic-Programmen (mit Zeilennummern) nach X11-Basic zu erleichtern, wurde ein Konverter (→ bas2x11basic) geschrieben. Dieser ist im X11-Basic-Paket enthalten.

Da skleine und nützliche Programm gfalist von Peter Backes erlaubt sogar die Dekodierung vom GFA-BASIC Programmen, erkennbar an der Endung .gfa, nach ASCII.

Als Mindestanforderung benötigt der X11-Basic Interpreter und der Bytecode Interpreter (die sogenannte virtual machine) etwa 350 KB Speicher und weitere 400 kB als Dateigröße. Die X11-Basic Runtime-Library ist dann darin enthalten. Das ist also der Overhead, den all Ihre selbstgeschrebenen BASIC-Programme haben werden. Im Vergleich zu einigen Windows-Programmen ist das gar nicht so übel. Höchtwahrscheinlich ist Ihr Programmcode oder Bytecode sowieso kleiner als 50 kB (für eine mittelgroße Anwendung), plus alle Ressourcen und Grafiken, die Sie natürlich hinzufügen möchten. Schlussendlich wird der produzierte Code relativ klein und leicht genug sein, um auch auf tragbaren Geräten (z. B. Mobiltelefone, eBook-Lesegeräte und Navigationsgeräte) verwendet zu werden. Jene Geräte haben nur wenig Speicher (und einen relativ langsamen Prozessor).

Copyright © 1997­-2018 by Markus Hoffmann

Es ist erlaubt, dieses Dokument zu kopieren, zu verteilen und / oder zu modifizieren unter den Bedingungen der GNU-Lizenz für freie Dokumentation, Version 1.2 oder einer späteren Version veröffentlicht von der Free Software Foundation; aber nur ohne invariante Abschnitte, ohne Front- oder Deckblatttexte und ohne Die Texte auf der Rückseite. Eine Kopie der Lizenz ist in im Abschnitt "GNU-Lizenz für freie Dokumentation" wiedergegeben.

X11-Basic ist freie Software; Sie können es weitergeben und / oder modifizieren, aber nur unter den Bedingungen der GNU General Public License, wie sie von der Free Software Foundation veröffentlicht wurden; entweder Version 2 der Lizenz oder (nach Ihrer Wahl) eine spätere Version.

Dieses Programm wird in der Hoffnung verteilt, dass es nützlich sein wird, aber OHNE JEGLICHE GARANTIE ohne auch nur die stillschweigende Gewährleistung der MARKTGÄNGIGKEIT oder Eignung für einen bestimmten Zweck. Siehe die GNU General Public License für mehr Details.

Für die gängigsten Betriebssysteme stehen fertige Pakete zum Installieren des gesamten X11-Basic Pakets zur Verfügung. Sie ermöglichen eine einfache Installation von X11-Basic, ohne dass es aus den (freien und offenen) Quellen kompiliert werden muss.

Auf anderen Betriebssysteme, die hier nicht erwähnt werden, kann X11-Basic funktionieren oder nicht. Im Allgemeinen ist möglicherweise kein Binärpaket verfügbar. Dies hängt immer davon ab, ob sich jemand die Mühe gemacht hat, X11-Basic für das jeweilige Betriebsystem zu kompilieren und dann ein fertiges Paket zur Verfügung zu stellen. Suchen Sie ruhig im Internet, aber seien sie etwas vorsichtig, von wem Sie ein Binärpaket annehmen und auf Ihren Rechner lassen. Bei Binärpaketen brauchen Sie immer besonderes Vertrauen in dessen Urheber. In den Fällen, wo Sie nichts fertiges finden, werden Sie nicht darumherum kommen, X11-Basic selbst aus seinen Quellen zu kompilieren. Je nach Betriebsystem kann das jedoch etwas (Hand-)Arbeit machen. Vielleicht haben Sie Glück und Sie sind nicht der erste, der dies versucht. Also im Internet nach Hinweisen suchen ist generell eine gute Idee.

Aber wahrscheinlich lesen Sie dieses Handbuch, weil Sie bereits X11-Basic auf Ihrem System installiert haben, oder Sie haben mindestens ein Paket bereit für die sofortige Installation.

Es gibt mehrere Möglichkeiten, den X11-Basic-Interpreter zu starten, abhängig vom verwendeten Betriebssystem.

Wenn Sie X11-Basic unter Android verwenden, können Sie diesen Abschnitt überspringen.

Der X11-Basic-Interpreter xbasic kann mit zusätzlichen, aber optionalen Kommandozeilenparametern aufgerufen werden. Er akzeptiert die folgenden:

Die Framebuffer-Version von X11-Basic unterstützt zusätzlich noch weitere Kommandozeilenoptionen:

X11-Basic-Programme (Quellcode, .bas-Dateien) sind reguläre ASCII-Dateien und können daher mit jedem verfügbaren Texteditor erstellt werden.

Benutzer von UNIX-ähnlichen Betriebssystemen sind mit jedem Texteditor gut bedient. Einfache wie "Pico" oder "Nano" sind schon absolut perfekt. MS-WINDOWS-Benutzer können den einfachen Texteditor notepad verwenden.

Benutzer von X11-Basic unter Android müssen einen guten Texteditor installieren. TED (Texteditor), 920 Text Editor oder` Jota` funktionieren gut. Andere Texteditoren, die möglicherweise bereits vorinstalliert wurden, können Grund für Frustration und Ärger sein. Wenn Sie sich also nicht sicher sind, installieren Sie einen der genannten Editoren aus dem Android Market. Wenn Sie mehr als einen Editor installiert haben, ist dies kein Problem, Sie werden gefragt, welchen Sie verwenden möchten, wenn der Editor aufgerufen wird.

Neben den grundlegenden Bearbeitungsfunktionen empfehle ich einen Texteditor mit Syntax-Highlighting zu verwenden. Derzeit sind X11-Basic-Syntaxdefinitionen für den "Nirvana Editor" nedit (verfügbar für Linux, UNIX und WINDOWS) und für den "920 Text Editor" und "Jota" für Android verfügbar.

X11-Basic unterstützt Fremdsprachenzeichen. Daher kann das BASIC-Programm in UTF-8 codiert sein. UTF-8 ist mit ASCII kompatibel, kann aber jedes Unicode-Zeichen codieren. Solche Zeichen können in X11-Basic-String-Konstanten verwendet werden, dürfen aber nicht in Variablennamen vorkommen. Derzeit unterstützt nur die Standardausgabe (Konsole) den vollständigen UTF-8-Zeichensatz..

Wenn Sie die Android-Version von X11-Basic verwenden, können Sie dieses Kapitel überspringen. Alles, was Sie wissen müssen, ist, dass es die Möglichkeit gibt, X11-Basic-Programme (zu Bytecode) zu kompilieren, wodurch sie viel schneller laufen.

Unter UNIX, Linux und Windows muss ein separates Programm verwendet werden, um .bas-Dateien zu kompilieren und Bytecode-Dateien oder Standalobe-EXE-Dateien daraus zu machen.

Wenn Sie WINDOWS verwenden, besteht die praktischste Möglichkeit zum Kompilieren von X11-Basic-Programmen darin, den Compiler xbc.exe auszuführen, der über eine kleine Benutzeroberfläche verfügt. Auch unter UNIX/Linux ist es sehr praktisch, den Compilermanager xbc mit entsprechenden Befehlszeilenoptionen zu verwenden (achten Sie auf die` -virtualm` Option).

Fortgeschrittene Benutzer möchten sich wahrscheinlich mit den Bytecode-Dateien befassen, die beim Kompilieren erzeugt werden. Für jeden Übersetzungsschritt gibt es separate Programme, die das tun; nämlich: xbbc,` xb2c` und xbvm.

Die Idee ist, die Ausführungsgeschwindigkeit von X11-Basic-Programmen zu erhöhen, indem man sie zu einem Bytecode kompiliert, der immer noch lauffähig ist. Der Bytecode selbst wird von einem Bytecode-Interpreter (auch als virtuelle Maschine bezeichnet) interpretiert. Diese virtuelle Maschine muss auf dem Zielcomputer vorhanden sein, und dann können alle Bytecode-Programme dort verwendet werden. Auf diese Weise muss der X11-Basic-Compiler nicht mit verschiedenen Zielmaschinenarchitekturen umgehen, und auch der Bytecode kann viel schneller als der interpretierte BASIC-Quellcode ausgeführt werden.

Die Umwandlung in Bytecode ist eine echte Übersetzung. Der Schritt zum Assembler- oder Maschinencode ist nicht weit. Auch eine Übersetzung nach C oder nach JAVA oder einer anderen Sprache wäre unkompliziert. Wie bei JAVA ist der Bytecode plattformunabhängig und kann auf jedem System ausgeführt werden, auf das eine virtuelle Maschine portiert wurde.

Wenn Sie wissen möchten, worum es dabei geht, öffnen Sie eine .c-Quelldatei, die vom Bytecode-nach-C-Übersetzer xb2c erzeugt wurde. Ausgedrückt in einer Makro-Sprache ist der Bytecode in gewisser Weise lesbar.

Hier ist ein Beispiel:

Dies ist Bytecode, welcher aus folgenden (X11-Basic) Zeilen generiert wurde:

Es ist nicht nötig, etwas davon zu verstehen, aber es gibt Ihnen vielleicht ein Gefühl dafür, was Bytecode wirklich ist, und dass es wirklich schwierig ist, die ursprünglichen BASIC-Zeilen daraus zu rekonstruieren.

Bitte probieren Sie den Bytecode-Compiler ruhig aus. Viele der Beispielprogramme funktionieren mit dem Bytecode-Compiler recht gut: z.B. mandel-einfach.bas. Der Bytecode wird etwa 10 mal schneller ausgeführt als das interpretierte Programm.

Hier wird gezeigt, wie man vorgeht:

Es ist möglich, den durch xbbc erzeugten Bytecode in C-Quellcode zu übersetzen und schließlich diesen C-Quellcode zu einer ausführbaren binär-Datei zu kompilieren (z.B. mit dem GNU C-Compiler gcc). Auf diese Weise wird das endgültige Programm eine echte ausführbare Datei in Maschinencode, die (noch) etwas schneller läuft als der von der virtuellen Maschine interpretierte Bytecode.

Solche Programme können mit der dynamischen Laufzeitbibliothek (.so oder .dll) von X11-Basic oder der statischen Bibliothek (.a oder .lib) verknüpft werden. Am Ende laufen sie unabhängig von einem Interpreter oder einer virtuellen Maschine. Es gelten jedoch einige Einschränkungen für den Code. Was bedeutet: Nicht jedes Programm, das interpretiert werden kann, kann auch kompiliert werden.

Die generierten C-Quellen hängen von der Header-Datei xb2csol.h (normalerweise installiert unter /usr/include/x11basic/) und den Bibliotheken x11basic.a oder libx11basic.so ab, die daher vorhanden sein müssen.

xb2c verarbeitet eine Eingabedatei. Die Dateiendung der Eingabedatei ist normalerweise .b (was eine Bytecodedatei sein sollte, die von` xbbc` erzeugt wurde). Der Name der Standardausgabedatei ist 11.c, aber Sie können natürlich alternative Namen mit der Option -o angeben.

Eigentlich ist xb2c kein echter Compiler, sondern ein Übersetzer. Die Kompilierung wurde bereits vom Bytecode-Compiler durchgeführt. xb2c selbst führt lediglich eine Eins-zu-Eins-Übersetzung des Bytecodes durch (derzeit nur in C). Dieser Übersetzungsprozess ist noch nicht stark optimiert, aber sehr robust und portabel.

Es gibt keine Möglichkeit, den .bas-Quellcode aus der .c-Datei neu zu erstellen. Dennoch ist die C-Datei plattformunabhängig und kann auf allen Plattformen kompiliert werden, wo ein C-Compiler verfügbar ist (und die x11basic-Bibliothek portiert ist).

Hier wird gezeigt, wie man es benutzt (alle Beispiele laufen unter Linux):

Aus Bequemlichkeit kann man auch folgendes Kommando ausführen:

Das macht exakt das gleiche.

Das X11-Basic-Paket wird mit dem X11-Basic-Compiler xbc ausgeliefert, der eigenständige Binärdateien aus dem X11-Basic-Quellcode erstellt. Es kann auch .o Objektdateien, sogenannte Shared Objekte (oder DLLs) und Bytecode erzeugen.

Es gibt drei Methoden, wie die Kompilierung durchgeführt werden kann:

Um Methode 3 auf UNIX / Linux-Systemen auszuwählen, verwenden Sie die Befehlszeilenoption -virtualm. Die Windows-Version des Compilers verwendet automatisch nur Methode 2.

Der Compiler xbc selbst wurde in X11-Basic geschrieben und beruht auf dem Vorhandensein von` xbbc` und xv2c (für Methoden 2 und 3).

Sie finden den Compiler-Quellcode in examples/compiler/xbc.bas. Ja, der Compiler kompiliert sich selbst. Stellen Sie nur sicher, dass Sie die gemeinsam genutzte Bibliothek libx11basic.so und die Bibliothek für die statische Verknüpfung zuvor erstellt und nach /usr/lib verschoben haben.

Dann können sie den Kompiler starten:

Weitere Informationen zum Compiler finden Sie auf der Manpage xbc (1).

Im X11-Basic-Paket ist ein einfacher ANSI-Basic zu X11-Basic Konverter bas2x11basic enthalten.

Er hilft dabei, alte (echte) BASIC-Programme mit Zeilennummern und mehreren Befehlen pro Zeile in die X11-Basic-Struktur zu konvertieren. Da es so viele verschiedene BASIC-Versionen gibt, müssen Sie diese Dateien in den meisten Fällen manuell nachbearbeiten. Aber die meiste Arbeit wurde bereits von diesem Konverter erledigt. Details zur Kompatibilität zu anderen Dialekten von BASIC finden Sie in Kapitel {compat}.

Hier ein Beispiel:

Für weitere Optionen versuchen Sie mal

und konsultieren Sie auch die man-page man bas2x11basic. Wenn Sie den Konverter verbessern möchten, tun Sie dies bitte. Vielleicht möchten Sie mir das Ergebnis senden.

GFA-Basic-Programme haben ein tokenisiertes Binärformat und normalerweise die Endung .gfa. Dieses Binärformat muss in ASCII-Dateien dekodiert werden, bevor sie mit X11-Basic verwendet werden können. Dieser Job wird mit dem Hilfsprogramm gfalist (manchmal auch` gfa2lst` oder ons-gfalist genannt) von Peter Backes erledigt.

Die resultierenden GFA-Basic-Programme benötigen normalerweise einige manuelle Korrekturen. Nur sehr einfache werden direkt und ohne Korrekturen mit X11-Basic. Details zur Kompatibilität finden Sie im Kapitel {gfacompat}.

Die Programmiersprache BASIC gibt es seit den 1960er Jahren. BASIC ist ein Akronym und steht für Beginners All Purpose Symbolic Instruction Code. BASIC wurde ursprünglich entwickelt, um eine Programmiersprache zu sein, die für eine breite Palette von Projekten von jedermann einfach zu bedienen und zu erlernen ist.

X11-Basic ist ein Dialekt davon, aber es ist kein BASIC in seiner ursprünglichen Form. Es ist eher eine Mischung aus klassischem BASIC mit strukturierten Sprachen wie PASCAL und Modula-2.

Die Syntax von X11-Basic orientiert sich am berühmten GFA-BASIC, welches 1985 für den ATARI ST entwickelt wurde. GFA BASIC (ab Version 3.5, der populärsten Version) war für damalige Verhältnisse eine sehr moderne Programmiersprache. Wie X11-Basic verzichtet es auf Zeilennummern und verfügt über eine vernünftige Auswahl an strukturierten Programmierbefehlen.

X11-Basic hat viele Eigenschaften, die die Sprache von der ursprünglichen Zielsetzung (ANSI-Basic) unterscheiden. Wie bei GFA-Basic helfen diese Abwandlungen bei der Entwicklung von Programmen. Diese haben dann nämlich eine strukturiertere Form, und nutzen außerdem die seit Mitte der 80er Jahre verfügbaren modernen grafischen Benutzeroberflächen:

Um ein erstes X11-Basic-Programm zu schreiben, benötigen Sie einen Editor, in den Sie den Quellcode eingeben können. Das X11-Basic-Paket enthält keinen Editor, aber viele so genannte Texteditoren sind fast überall verfügbar und zufällig sind sie bereits auf Ihrem System installiert. Sie können Notapad2 auf MS WINDOWS-Systemen, pico, nano, vi, emacs, nedit, gedit und viele mehr auf UNIX- und Linux-Systemen verwenden, pico auf einem TomTom-Gerät, "Ted" oder "920 Texteditor" auf Android. Dies ist nur eine kleine Liste von Möglichkeiten hier.

Öffnen Sie einen solchen Editor und Sie können mit der Programmierung beginnen.

Wir gehen davon aus, dass Sie ein Konsolenfenster (eine Shell) unter Linux oder WINDOWS geöffnet haben. Die Android-Version ist ein bisschen anders.

Öffnen Sie Ihren bevorzugten Editor und geben Sie die folgende Codezeile in den Editor ein.

Speichern Sie nun die Datei als "hallo.bas" und starten Sie den Interpreter mit

X11-Basic sollte sich nicht beschweren. Wenn dies der Fall ist, prüfen Sie nochmal sorgfältig auf Tippfehler. Das Programm sollte jetzt Ihre Hallo-Nachricht an der Konsole oder im Konsolenfenster ausgeben, von dem der Interpreter gestartet wurde. Es wird nicht zur Shell zurückkehren, sondern nur nach zusätzlichen Befehlen fragen. Geben Sie nun

ein und Sie kehren zur Shell zurück.

Natürlich können Sie den quit Befehl auch gleich in Ihr hello.bas einfügen:

Jetzt kehrt das Programm immer zum Shell-Prompt zurück, wenn es fertig ist.

Jetzt können wir es kompilieren:

erzeugt eine Bytecode-Binärdatei hallo.b.

Sie können dies ausführen:

gibt Ihnen die gleiche Ausgabe "Hallo X11-Basic!".

Echte Compilierung benötigt zwei weitere Schritte:

produziert eine C-Quelldatei hallo.c.

Wenn Sie den gnu C Compiler verfügbar haben, können Sie die C-QUelldatei in ein unabhängiges ausführbares Programm mit dem Namen hallo (oder hallo.exe auf Windows) kompilieren:

Bittesehr! Ihr Programm kann jetzt direkt gestartet werden mit:

Wenn Sie anspruchsvollere Programme als das Hallo-Beispiel schreiben möchten, sollten Sie die allgemeine Struktur eines X11-Basic-Programms verstehen.

Ein X11-Basic-Programm besteht aus einem Hauptprogrammblock und Unterprogrammen und -funktionen. Der Hauptprogrammblock ist der Abschnitt zwischen der ersten Zeile und dem Schlüsselwort END (oder QUIT). Der Code im Hauptblock steuert die Logik Ihres Programms. In einem einfachen Programm ist das alles, was benötigt wird. In größeren und komplexeren Programmen macht das Einfügen des gesamten Codes in den Hauptblock das Programm schwer lesbar und schwer verständlich. Mit Unterprogrammen können Sie Ihr Programm in überschaubare Abschnitte aufteilen, von denen jeder seine eigenen, aber begrenzten Aufgaben ausführt.

Die Syntax einer typischen X11-Basic-Zeile lautet:

Die Parameterliste besteht normalerweise aus einer Liste von durch Kommas getrennten Ausdrücken.

Ein anderer Typ von X11-Basic-Zeilen sind Zuweisungen:

Variablen haben typischerweise einen Namen und können verschiedene Typen haben. Das Ergebnis des Ausdrucks wird unter diesem Namen zur weiteren Bezugnahme gespeichert. Jede Zeile des X11-Basic-Codes kann genau einen Befehl oder eine Zuweisung (oder einen Kommentar) enthalten.

Hier ist ein typisches Stück X11-Basic-Code:

Mit dem PRINT-Befehl wird Text auf den Textbildschirm ausgegeben. Der Textbildschirm ist Ihr Terminal (unter UNIX) oder das Konsolenfenster (unter Windows). PRINT wird verwendet, um eine Standardausgabe zu erzeugen, z.B. Text, Zeichenfolgen, Zahlen, das Ergebnis einer Berechnung. Formatierungen der Zahlen sind ausserdem möglich.

Mit dem Befehl INPUT lässt man den Benutzer Daten eingeben, z.B. Zahlen oder Text. Die Daten können auf dem Textbildschirm bzw. Konsolenfenster eingegeben werden. Zusammen mit PRINT ermöglicht dies bereits die Implementierung einer sehr einfachen Benutzeroberfläche.

Der IF-Befehl lässt das Programm abhängig vom Ergebnis einer Berechnung verschiedene Dinge tun. Dazu wird der Code in einen Block gruppiert, der nur ausgeführt werden soll, wenn das Ergebnis des Ausdrucks nach IF nicht Null ist. Der Block beginnt mit dem IF-Befehl und endet mit einem ENDIF-Befehl. Wenn das Ergebnis des Ausdrucks nach IF Null ist, wird das Programm nach dem ENDIF fortgesetzt und die Codezeilen zwischen dem IF und dem ENDIF werden nicht ausgeführt.

Mit GOTO können Sie in einen anderen Teil Ihres Programms verzweigen. GOTO, trotz seines schlechten Rufs (es galt als schädlich), hat immer noch seinen guten Nutzen. Da keine Zeilennummern verwendet werden, müssen Sie eine Markierung der Zeile verwenden, zu der Sie mit dem GOTO-Befehl springen wollen. Diese Markierung muss am Zeilenanfang stehen und mit einem Doppelpunkt enden.

Neben diesen vier sehr grundlegenden Befehlen (die in jedem BASIC-Dialekt existieren) hat X11-Basic viele weitere Funktionen, die das Leben einfacher und Ihre Programme benutzerfreundlicher machen.

Variablen im BASIC-Dialekt sind analog zu Variablen in der Mathematik. Variablenbezeichner (Namen) bestehen aus alphanumerischen Zeichenfolgen. Diese Bezeichner beziehen sich auf Werte im Computerspeicher. Im X11-Basic-Programm ist ein Variablenname eine Möglichkeit, eine Variable an einen Speicherort zu binden. Der entsprechende Wert wird als Datenobjekt an diesem Ort gespeichert, so dass später über den Variablennamen auf das Objekt zugegriffen werden kann.

Die Variablen werden dynamisch verwaltet, so sind beliebig große Zeichenketten und Felder möglich. Die Grenze ist hier nur der maximal allozierbare Speicher und max. 31 Bit für die Indizierung. Das sollte vorerst ausreichen.

Variablennamen dürfen sehr lang sein, wenn Sie möchten, und können auch Ziffern und einen Unterstrich enthalten, mit der Ausnahme, dass der erste Buchstabe des Variablennamens keine Ziffer sein darf.

Sie können auf eine Variable verweisen, indem Sie ihren Namen an der Stelle angeben, an der der Wert der Variablen verwendet werden soll. X11-Basic weiss automatisch, wo die Daten gespeichert sind und wie damit umgegangen wird.

Es ist auch wichtig, X11-Basic mitzuteilen, welche Art von Daten Sie speichern möchten. Sie können Variablen haben, die nur Zahlen speichern, aber auch Variablen, die sich auf ein Zeichen oder eine ganze Zeichenfolge beziehen, z.B. eine Textzeile. Die folgende Zeile des X11-Basic-Codes erstellt eine Variable namens "alter" für Sie und weist ihr den Wert 18 zu.

Wenn Sie jedoch einen Text speichern möchten, muss die Variable Zeichen anstelle von Zahlen enthalten können. In diesem Fall markieren Sie die Variable mit einem $, um zu sagen, dass sie Text und nicht Zahlen speichern soll:

Textkonstanten müssen übrigens mit "" eingeschlossen sein, um X11-Basic mitzuteilen, dass der Text nicht als Programmcode interpretiert werden darf, sondern nur als beliebiger Text behandelt werden soll.

Die Zuweisung erfolgt mit dem Operator =. Der Operator = wird auch in Ausdrücken verwendet, z.B. nach einem IF-Befehl. Aber dort wird er nicht als Zuweisungsoperator verwendet, sondern als Vergleichsoperator behandelt. In X11-Basic sind beide =-Operatoren identisch. Der Interpreter unterscheidet zwischen ihnen nur durch den Zusammenhang.

Hier ist das erste = eine Zuweisung und das zweite ist der Vergleichsoperator. x wird eine -1 (TRUE, wahr) zugewiesen, wenn a 3 ist und eine 0 (FALSE, falsch) ansonsten. Die Klammern sind hier nicht notwendig, sie helfen nur, diesen Ausdruck zu lesen. Verwirrt? Nun, Sie werden sich irgendwann daran gewöhnen.

Eine Zuweisung überschreibt übrigens den alten Wert, der in der Variable evtl. gespeichert ist. Solange Sie einer Variablen keinen Wert zuweisen, enthält sie einen Standardwert von 0 oder eine leere Zeichenkette.

X11-Basic kann mit Zahlen und Arithmetik umgehen: Sie können trigonometrische Funktionen wie SIN() oder ATAN() oder Logarithmen (mit LOG()) berechnen lassen. Bitweise Operationen, wie AND oder` OR` sind ebenso verfügbar wie MIN() und MAX() (berechnet das Minimum oder Maximum ihres Arguments) oder MOD oder INT() (Rest bei einer Division bzw. der ganzzahliger Teiler einer Zahl). Viele andere Anweisungen geben einen vollständigen Satz von mathematischen Funktionen.

Die meisten dieser Funktionen können mit verschiedenen Eingabedatentypen arbeiten. Z.B. können Sie die Funktion SQRT() auch für komplexe Zahlen verwenden, wodurch ein komplexes Ergebnis zurückgegeben wird.

In X11-Basic gibt es zwei Arten von Unterprogrammen: Prozeduren und Funktionen. Der Hauptunterschied zwischen den beiden besteht darin, dass eine Funktion einen einzelnen Wert zurückgibt und in Ausdrücken verwendet werden kann, während eine Prozedur keinen Wert zurückgibt, und wie ein Kommando aufgerufen wird. Eine Prozedur oder Funktion muss hinter dem Hauptprogrammblock erscheinen. Daher ist die Struktur eines X11-Basic-Programms wie folgt:

Sie kennen tatsächlich bereits einen X11-Basic-Befehl, um Daten auf den Bildschirm zu schreiben. Dieser Befehl ist PRINT. Es ist sehr vielseitig und Sie können ihn auf verschiedene Arten erweitern.

Die Syntax von PRINT ist einfach:

wobei <data> darauf ankommt, welche Art von Daten Sie auf dem Bildschirm drucken möchten. Das können Variablen, Zahlen, das Ergebnis einer Berechnung, ein String oder eine Mischung aus allen sein. Sie können Ihrer PRINT-Anweisung sogar spezielle Befehle und Funktionen zur Bildschirmsteuerung hinzufügen, wie z. B. die Cursorpositionierung und Formatierung der Daten. Einige Beispiele für den Befehl 'PRINT' finden Sie hier:

Dies sind die einfachsten Varianten des Befehls 'PRINT'. Sie können natürlich komplizierter sein, und alle Merkmale können kombiniert werden.

Nun, warum schreiben wir PRINT "y =";y anstelle von PRINT "y =",y? Wenn Sie ; verwenden, werden die folgenden Daten direkt hinter Ihrem Text hinzugefügt, ohne die Cursorposition zu verändern, während , den Cursor zur nächsten vertikalen Tabellenposition bringt. Sie können damit Ihre Daten in Tabellen auf dem Bildschirm ausrichten. Kurz gesagt, wenn Sie Daten direkt hinter eine Art Eingabeaufforderung oder hinter einen Text schreiben möchten, verwenden Sie die Notation ;. Setzen Sie als letztes Zeichen Ihrer PRINT-Anweisung ein ;, damit der Cursor auf der aktuellen Zeile bleibt. Sie können dies verwenden, um zu verhindern, dass in der letzten Bildschirmzeile gescrollt wird, oder wenn Sie das Schreiben von Prompts und Daten einfach in zwei Codezeilen aufteilen möchten. Technisch gesehen wird das Zeichen ; als letzte Anweisung einen Wagenrücklauf unterdrücken.

Jetzt, wo Sie wissen, wie Sie Ihre Daten auf dem Bildschirm schreiben, möchten Sie auch wissen, wie Sie die Bildschirmausgabe im Detail handhaben. Wie kann ich eine Textzeile leer lassen? Schreiben Sie einfach PRINT ohne irgendwelche Daten hinterher, um eine leere Zeile auf dem Bildschirm auszugeben. Probieren Sie dieses 3-Zeilen-Programm aus:

Wie Sie sehen, wird die Begrüßung und die andere Zeile mit einer leeren Zeile dazwischen gedruckt.

Eine sehr wichtige Sache ist, wie man den Bildschirm löscht. So werden die Reste der vorhergehenden Textausgabe gelöscht. Sie löschen den Bildschirm einfach mit dem folgenden Befehl.

Eine nette Sache ist es, auf dem Bildschirm an genau ader Position zu schreiben, wo man den Text hin platzieren möchte, und nicht dahin, wo PRINT ihn selbst im Fluss der Ausgaben schreiben würde. Sie können dafür die Anweisung AT() verwenden. Dieser spezielle Zusatz für PRINT ermöglicht es Ihnen, den Cursor frei auf dem Bildschirm zu positionieren, damit Sie Ihre Daten an die gewünschte Stelle schreiben können. Lassen Sie uns das folgende Beispielprogramm ausprobieren:

Die Syntax für PRINT AT () ist PRINT AT (Spalte, Zeile);, wobei Zeile 1 oben auf dem Bildschirm und Spalte 1 am linken Ende steht. Spalte und Zeile können Variablen, Ausdrücke oder einfach einfache Zahlen sein. Gültige PRINT AT () Befehle sind:

Wie viele Zeichenpositionen Sie haben, hängt von der aktuellen Bildschirmgröße der Textkonsole ab. Sie haben fast immer mindestens 24 Textzeilen. 80 Spalten sind Standard. Wenn Sie die Anzahl der Zeilen und Spalten des Textfensters genau kennen möchten, können Sie die (System-) Variablen ROWS und` COLS` verwenden.

Es gibt weitere Zusatz-Befehle, die Sie mit PRINT verwenden können. Z.B. SPC() und TAB(). Bitte schlagen Sie diese in der Befehlsreferenz am Ende dieses Handbuch nach, wenn Sie mehr darüber wissen möchten.

X11-BASIC gibt normalerweise Zahlen in einer Form aus, die für die meisten Zwecke geeignet ist. Aber gelegentlich bevorzugen Sie vielleicht eine ausführlichere Form. Sie möchten z.B. Finanzdaten, Geldmengen oder Buchungen mit zwei Dezimalstellen (für Cent) korrekt formatier ausgeben lassen. Oder Sie möchten die Zahlen in wissenschaftlicher Notation ausdrucken. PRINT USING bietet Möglichkeiten, Zahlen in dieser und fast jeder anderen Form darzustellen.

Die allgemeine Syntax ist:

Das Ergebnis des Ausdrucks sollte eine Zahl sein. Die Formatzeichenfolge definiert, wie Ihre Daten auf dem Bildschirm formatiert werden sollen. Die Formatzeichenfolge kann eine Stringvariable, eine Zeichenfolge in Anführungszeichen oder ein allgemeinerer Zeichenkettenausdruck sein.

Mit 'PRINT USING' können Sie auch Zeichenfolgen formatieren. In diesem Fall beschränken sich die Möglichkeiten jedoch auf das Ausgeben der Zeichenfolge zentriert, rechtsbündig oderlinksbündig innerhalb des Formatfeldes.

Die Funktion USING$() macht fast exakt dasselkbe wie PRINT USING, Es können jedoch nur Zahlen formatiert werden, keine Strings. Das Ergebnis wird als String zurückgegeben, anstatt es auf dem Bildschirm auszugeben.

Im Gegensatz zu STR$(), wo Sie die Länge des Strings, die Anzahl der signifikanten Stellen der Zahl und ein Flag angeben können, ob führende Nullen verwendet werden sollen, verwenden Sie USING $() und PRINT USING, um eine klassische Formatierzeichenfolge im BASIC-Stil zum Formatieren von Zahlen zu verwenden.

Sie können Ihr Programm interaktiv gestalten, und den Benutzer auffordern, Daten zur Laufzeit Ihres Programms einzugeben.

Mit dem Befehl INPUT kann der Benutzer mit der Tastatur auf der Textkonsole eine Datenzeile eingeben. Die Daten werden interpretiert und in einer oder mehreren Variablen gespeichert, die durch die Anweisung INPUT angegeben werden. Wenn Sie eine Zeichenfolgenvariable angeben, können Sie Text eingeben, während Sie numerische Daten nur eingeben können, wenn Sie eine numerische Variable verwenden. Ein Minuszeichen und ein optionaler Dezimalpunkt sind für numerische Eingaben zulässig. Zahlen können auch in wissenschaftlicher Schreibweise eingegeben werden. Hexadezimale Werte sind ebenfalls möglich.

Dies fordert den Benutzer auf, einen Wert für x einzugeben, der in einer (Gleitkomma-) Variable x gespeichert wird. Sie können diese Variable dann wie gewohnt in Ihrem Programm verwenden und damit rechnen. Bitte beachten Sie, dass Ihr Programm stoppt, bis die RETURN-Taste oder die ENTER-Taste gedrückt wurde, um die Eingabe zu beenden.

Sie können mehr als eine Variable mit einer INPUT-Anweisung lesen. Listen Sie einfach Ihre Variablen auf (mit Kommas getrennt), an die die Eingabe gehen soll.

Der Benutzer muss dann an den entsprechenden Stellen Kommas eingeben, um zu bestimmen, welcher Datenwert zu welcher Variablen geht. Im obigen Beispiel würde der Benutzer mit 5,6,7 antworten.

Bei der Eingabe von Strings ist Ihnen vielleicht schon aufgefallen, dass X11-Basic die Eingabe eines Kommas als Trennzeichen behandelt, wodurch die Zeichenkette effektiv abgeschnitten wird.

Sie können jetzt Zeichenfolgen mit einem Komma eingeben und sie werden auch in der Stringvariablen gespeichert. Sie können auch mehrere Zeichenfolgen mit LINEINPUT lesen, aber der Benutzer muss die RETURN-Taste drücken, um jede Zeichenfolge, die eingegeben werden soll, zu beenden.

In diesem Kapitel wollen wir Ihre Programme schließlich dazu bringen, Dinge mehr als einmal zu tun, ohne dass Sie Ihren Code erneut eingeben müssen. Das Erstellen von sogenannten Schleifen ist wesentlich, um komplexe Programme zum Laufen zu bekommen. Das Konzept von Schleifen und einfachen Zählschleifen soll hier vorgestellt werden.

Bevor Sie weiter gehen, lassen Sie mich die grundlegende Idee der Schleifen erläutern. Die Idee ist, dass Ihr Programm für eine bestimmte Zeit einen Codeabschnitt wiederholt. Sie können X11-Basic eine Variable für sich zählen lassen und Sie können dann den Wert dieser Variablen in einer laufenden Berechnung verwenden. Oder Sie können X11-Basic einen bestimmten Teil des Codes durchlaufen lassen, bis eine spezielle Bedingung erfüllt ist. Sehen Sie sich das folgende Beispielprogramm an:

Dieses kleine Beispielprogramm läuft 5 mal über die Anweisung PRINT i% und zählt die Variable i% von 1 bis 5 und gibt den aktuellen Wert auf dem Bildschirm aus. Diese Art von Schleife wird FOR-NEXT-Schleife genannt. Sie können eine beliebige numerische Variable zum Zählen verwenden. Meistens wird diese Art von Schleife verwendet, um Dinge eine bestimmte Zeit lang auszuführen oder um über eine Liste zu iterieren. Die Schleife wiederholt den Code zwischen dem FOR und dem zugehörigen NEXT. Jedes Mal, wenn X11-Basic das NEXT erreicht, inkrementiert es die Zählvariable und stoppt die Schleife, sobald die maximale Anzahl, bzw. der bei FOR angegebene Maximalwert erreicht wird.

Sie können natürlich noch eine andere Schleife innerhalb der aktuellen haben. Stellen Sie sicher, dass Sie nicht dieselbe Variable zum Zählen verwenden, sonst gibt es Durcheinander:

Dieses Beispielprogramm hat eine FOR-NEXT-Schleife innerhalb einer anderen und berechnet das Produkt der beiden Zählervariablen, wodurch eine Art Multiplikationstabelle erzeugt wird.

Hier einige Regeln und Ratschläge, die man bei FOR-NEXT-Loops beachten sollte:

Einige Fehler können vom Anwenderprogramm mit dem Befehl ON ERROR GOTO oder ON ERROR GOSUB abgefangen werden. Wenn keine Fehlerabfangroutine spezifiziert wurde, wird die Programmausführung beendet und eine Nachricht mit der entsprechenden Zeilennummer ausgegeben. Die Fehlermeldungen sind standardisiert. Jede Fehlermeldung hat eine entsprechende Nummer. Die Nummer wird auch in der Systemvariable ERR abgelegt und kann in der Fehlerabfangroutine ausgewertet werden. Eine Liste der Standardfehlermeldungen nach Nummer finden Sie im Kapitel {errors}.

Eine Pipe ist ein unidirektionaler Datenkanal, der für die Interprozesskommunikation verwendet werden kann. Der UNIX-Kernel unterstützt normalerweise diesen Mechanismus. Die Pipe kann verwendet werden, um Informationen oder Daten von einem Prozess zu einem anderen zu senden. Hier ist ein kleines Beispielprogramm, mit dem Sie spielen können:

Statt mit Pipes kann die Interprozesskommunikation auch über ein gemeinsames Speichersegment erfolgen. X11-Basic unterstützt auch Befehle zum Erstellen und Zugriff auf solche geteilten Speichersegmente.

Die meiste Kommunikation zwischen Prozessen verwendet das Client-Server-Modell. Diese Begriffe beziehen sich auf die zwei Prozesse, die miteinander kommunizieren. Einer der beiden Prozesse, der Client, verbindet sich mit dem anderen Prozess, dem Server, um typischerweise eine Informationsanforderung zu stellen. Eine gute Analogie ist eine Person, die eine andere Person anruft.

Beachten Sie, dass der Client von der Existenz und der Adresse des Servers wissen muss, aber der Server die Adresse (oder sogar die Existenz) des Clients nicht kennen muss, bevor die Verbindung hergestellt wird. Beachten Sie auch, dass nach dem Verbindungsaufbau beide Seiten Informationen senden und empfangen können.

Wenn ein Socket erstellt wird, muss das Programm die Adressdomäne und den Socket-Typ angeben. Zwei Prozesse können nur miteinander kommunizieren, wenn ihre Sockets vom selben Typ und in derselben Domäne sind. Es gibt zwei weit verbreitete Adressdomänen, die (lokale) Unix-Domäne, in der zwei Prozesse, die sich ein gemeinsames Dateisystem teilen, kommunizieren, und die Internetdomäne, in der zwei Prozesse auf zwei beliebigen Hosts im Internet kommunizieren. Jeder von diesen hat sein eigenes Adressenformat. Eine weitere zu erwähnende Domäne ist die Bluetooth-Domäne für Kurzstrecken-Funkverbindungen. Es funktioniert ähnlich wie die Internetverbindungen, verwendet aber einen eigenen Adressraum.

Die Adresse eines Sockets in der Unix-Domäne ist eine Zeichenkette, die im Grunde genommen ein Eintrag im Dateisystem ist. Es kann von dort aus wie eine Datei aufgerufen werden. In X11-Basic können all die normalen Datei-Ein- und -Ausgabe-Befehle verwendet werden.

Die Adresse eines Sockets in der Internetdomäne besteht aus der Internetadresse des Host-Rechners (jeder Computer im Internet hat eine eindeutige 32-Bit-Adresse, oft als IP-Adresse (oder Bluetooth-ID) bezeichnet.). Darüber hinaus benötigt jeder Socket eine Portnummer auf diesem Host. Portnummern sind 16-Bit-Ganzzahlen ohne Vorzeichen. Die niedrigeren Nummern sind im Internet für Standarddienste reserviert. Die Portnummer für den FTP-Server lautet beispielsweise 21. Es ist wichtig, dass sich die Standarddienste auf allen Computern auf demselben Port befinden, damit die Clients ihre Adressen kennen. Portnummern über 2000 sind jedoch in der Regel frei verfügbar.

RFCOMM (Radio Frequency Communication) stellt dem Benutzer, ähnlich wie TCP, eine einfache, zuverlässige Datenstromverbindung zur Verfügung.

Viele Bluetooth-Anwendungen verwenden RFCOMM, da es weit verbreitet ist und von vielen frei verfügbaren Programmierschnittstellen auf den meisten Betriebssystemen unterstützt wird. Darüber hinaus können Anwendungen, die eine serielle Schnittstelle für die Kommunikation verwenden, schnell auf RFCOMM portiert werden.

Wie bei TCP/IP ist für den Aufbau einer Verbindung über RFCOMM das Grundkonstrukt ein Socket. Die beiden Prozesse (Server und Client) bauen jeweils einen eigenen Socket auf.

Die Schritte zum Einrichten eines Sockets auf der Client-Seite sind wie folgt (angenommen, die Bluetooth-ID, mit der Sie sich verbinden wollen, liegt in adr$.):

Die Schritte zum Einrichten eines Sockets auf der Serverseite sind wie folgt:

(L2CAP=Logical link control and adaptation protocol)

Zuerst muss ein Socket mit dem Befehl OPEN erstellt werden:

Wenn ein L2CAP-Socket erstellt wird, sind seine lokalen und Remoteadressen nicht angegeben. Datagramme können sofort mit SEND mit einer gültigen Zieladresse und einem Port als Argument gesendet werden:

TODO …​. verwendet das IPv4-Adressformat, so dass eine lange Ganzzahl übergeben werden muss.

Wenn CONNECT für den Socket aufgerufen wird, wird die Standardzieladresse festgelegt, und Datagramme können jetzt mit SEND gesendet werden, ohne eine Zieladresse anzugeben.

Alle Empfangsoperationen geben nur ein Paket zurück.

INP?(#n) Gibt die Größe des nächsten ausstehenden Datagramms in Bytes zurück oder 0, wenn kein Datagramm aussteht.

Der Socket sollte geschlossen werden, wenn die Verbindung nicht mehr genutzt wird:

Die maximale Paketgröße sollte 672 Bytes nicht überschreiten.

Die Bluetooth-Unterstützung von X11-Basic ist noch neu und noch in Arbeit und funktioniert noch nicht unter Android und WINDOWS.

Wenn Sie eigene Funktionen, welche sie in einer anderen Programmiersprache (wie z.B. C) als X11-Basic geschrieben haben, zusammen mit X11-Basic verwenden wollem, dann müssen sie diese zuvor in eine dynamische Bibliothek kompilieren. Es entsteht so eine .so-Datei oder eine .dll-Datei.

Bevor eine X11-Basic-Anwendung eine Funktion aus einem .so verwenden kann, muss die dynamische Bibliothek geladen werden. Die geschieht mit dem LINK Kommando.

Die Bibliothek wird also zur Laufzeit hinzugelinkt.

Wenn Sie jetzt zum Beispiel eine C-funktion binit() aus der Bibliothek`trackit.so` aufrufen möchten, können SIe das mit den folgenden Codezeilen tun:

Zur Verdeutlichung hier auch der C-Quelltext für die erwähnte Funktion:

X11-Basic-Anwendungen können bis zu 99 shared object Dateien gleichzeitig laden, obwohl der Kanalnummernbereich auch für die geöffneten Dateien verwendet wird.

X11-Basic verwaltet eine interne Tabelle mit 99 Einträgen, um die interne Referenz der geladenen Dateien zu speichern. Diese Referenzen sind notwendig, um auf die Daten zuzugreifen.

Die `.so’s werden mit dem Befehl 'UNLINK' wieder aus dem Speicher entfernt:

Die CALL() Funktion erlaubt nur einen Integer (int) Typ für den Rückgabewert. Um einen Gleitkomma-Rückgabewert zu erhalten, verwenden Sie stattdessen CALLD(). Wenn die aufgerufene Funktion eine komplizierte Datenstruktur zurückgibt, verwenden Sie stattdessen CALL$().

Folgende Parametertypen sind möglich:

Die Option P: verhält sich genauso wie L: auf 32-Bit-Betriebssystemen. Aber Sie sollten P: für Zeiger (VARPTR() usw.) in den Speicher verwenden, damit sie von der 32-Bit-X11-Basic-Darstellung in 64-Bit-Adressen auf 64it-Betriebssystemen übersetzt werden können. Die Optionen B: und W: verhalten sich genauso wie die Option L:.

Die Funktion SYM_ADR() bestimmt die Adresse der Funktion anhand ihres Namens. Die Schreibweise des Funktionsnamens muss daher genau mit der Schreibweise der Funktion im .so identisch sein.

Wenn Sie die Adresse einer Zeichenfolge übergeben, muss ein Nullbyte am Ende der Zeichenfolge hinzugefügt werden.

Wenn eine Anwendung geringe Datenmengen speichern muss, sollten Strings verwendet werden, um diese zu speichern. Strings werden oft auch als DatenPuffer für Funktionen verwendet. Die Adresse des von einem String belegten Speichers kann mit der VARPTR() Funktion erhalten werden. Seine Länge durch die LEN() Funktion. Strings dürfen 2 Gigabyte gross sein und können beliebige Bytes speichern. Also genug für viele Anwendungen. Die Adresse eines Strings kann sich jedoch nach jeder Zuweisung von Daten ändern. Das sollten Sie bedenken.

Um Speicher aus dem globalen und systemweiten Programm-User-Space-Speicherpool zu reservieren, können Sie die Funktion MALLOC() verwenden. Um beispielsweise 2000 Bytes zu reservieren, könnten Sie Folgendes schreiben:

Die Adresse des Begins des Speicherbereichs befindet sich dann in ptr%. Im Gegensatz zu Strings, bleibt der reservierte Speicherbereich immer an derselben Stellen, seine Adresse ändert sich also nicht.

Ein globaler Speicherblock, der mit MALLOC() reserviert wurde, muss mit der Funktion FREE() wieder freigegeben werden. Eine Anwendung sollte immer alle Speicherblöcke freigeben, bevor sie beendet wird.

Zum Beispiel:

Speicher, der mit MALLOC() zugeordnet wurde, kann nur von einem einzigen Prozess aus benutzt werden. Wenn zwei verschiedene X11-Basic-Instanzen oder im Allgemeinen zwei verschiedene laufende X11-Basic-Programme auf denselben Speicher zugreifen möchten (z.B. um Daten gemeinsam zu nutzen oder auszutauschen), müssen sie stattdessen einen gemeinsam genutzten Speicher verwenden, sogenannte shared mamory.

Das Shared Memory-Segment muss zuerst erstellt und zugewiesen werden. Dies sollte nur von einem der Programme durchgeführt werden. Der Ersteller wählt auch einen Schlüssel (der nur eine Ganzzahl ist) und muss allen anderen Programmen bekannt sein, die später auf diesen Speicher zugreifen wollen. Als Beispiel wählen wir den Schlüssel 4711. Um beispielsweise 2000 Bytes zuzuweisen, könnten Sie Folgendes schreiben:

Im Gegensatz zu MALLOC() gibt SHM_MALLOC() nicht direkt eine Adresse zurück. Stattdessen liefert es einen Bezeichner des gemeinsamen Speichersegments, welcher mit dem Schlüssel verknüpft ist. Die Kennung ist auch nur eine ganze Zahl. Ein neues Shared-Memory-Segment wird erstellt, wenn noch kein dem Schlüssel entsprechendes Shared-Memory-Segment existiert, ansonsten wird ein bereits vorhandenes verwendet.

Um eine Adresse zu erhalten, die Sie dann normal wie alle anderen Speicheradressen verwenden können, müssen Sie die Funktion SHM_ATTACH() bemühen:

Sobald der andere Prozess den Schlüssel und die Größe des Shared-Memory-Segments (oder zumindest seine ID) kennt, kann er das gleiche Segment auch an seinen Adressraum anhängen. Es wird schließlich eine andere Adresse erhalten (adr%), aber das Schreiben in den Speicher und das Lesen von diesem wird nun auch alle anderen Prozesse betreffen, die dieses gemeinsame Segment verwenden.

Wenn es nicht mehr verwendet wird, sollte das Segment von jedem der Prozesse, die es verwenden, vom Adressraum getrennt werden (so dass adr% nicht mehr verwendet werden kann). Wenn das gemeinsam genutzte Speichersegment vollständig aus dem Speicher entfernt werden sollte (und alle seine Inhalte verworfen werden sollten), kann der Ersteller dieses Segments es mit SHM_FREE freigeben.

Wenn es nicht freigegeben wird, bleibt es und die darin enthaltenen Daten persistent im Speicher des Rechners bestehen, bis dieser ausgeschaltet oder neu gebootet wird.

Die zwei am häufigsten verwendeten Nutzerschnittstellen sind

Beide sind als voll funktionsfähige grafisches Dialogfeld implementiert.

Darüber hinaus gibt es noch weitere Dialogfelder für Listen-Auswahl, Einfache Texteingabefelder, Pull-Down-Menüs und die Möglichkeit, beliebige Dialogfelder aus einfachen Objekten zusammenzustellen. Beliebige Dialoge können mit den Objekt- und Ressourcenfunktionen erstellt werden.

Abb. {img-alert} zeigt eine typische Nachrichtenbox. Der Befehl, der es erzeugt, ist:

ALERT-Felder können auch verwendet werden, um einfache Eingabeformulare zu verwalten, wie sie in Abb. {img-alert3} zu sehen sind. Hier ist ein kleines Beispielprogramm:

Abb. {img-fileselect} zeigt das Dateiauswahlfeld. Der Befehl, der es erzeugt, ist:

Der vollständige Pfad und Dateiname der ausgewählten Datei wird in f$ zurückgegeben.

X11-Basic-Ressourcen bestehen aus Objektbäumen, Strings und Bitmaps, die von einem BASIC-Programm verwendet werden. Sie kapseln die Benutzerschnittstelle und erleichtern die Internationalisierung, indem sie alle Zeichenfolgen mit Meldungen und Beschriftungen in einer einzigen separaten Datei ablegen. Das Datenformat der X11Basic-Ressource ist abwärtskompatibel zu der Atari-ST GEM-Implementierung.

Die Abbildungen zeigen drei Beispiele für komplexere Dialogfelder, welche in X11-Basic benutz werden können. Ressourcen werden in der Regel mithilfe eines Resource Construction Set (RCS) erstellt und in einer .RSC-Datei gespeichert. Diese wird dann vom X11-Basic-Programm mit RSRC_LOAD() zur Programminitialisierungszeit geladen.

Ressourcen können auch als Datenstrukturen im Quellcode eingebettet sein (die Hilfsprogramme rsc2gui.bas und gui2bas.bas konvertieren .RSC Dateien in den Quellcode). Ressourcen enthalten Zeiger und Koordinaten, die vor der Verwendung an die aktuelle Bildschirmgröße angepasst werden. RSRC_LOAD() macht dies automatisch, wenn Sie jedoch eine eingebettete Ressource verwenden, müssen Sie sich selbst um jedes Objekt in jeder Objektbaumstruktur kümmern, um die ursprünglichen Zeichenkoordinaten in Bildschirmkoordinaten zu konvertieren. Dadurch können Ressourcen, die auf Bildschirmen mit unterschiedlichen Seitenverhältnissen und Systemschriftarten erstellt wurden, gleich aussehen. Sobald eine Ressource geladen ist, verwenden Sie rsrc_gaddr(), um Zeiger auf einzelne Objektbäume zu erhalten, die dann direkt oder mit den eingebauten X11-Basic-Funktionen manipuliert werden können.

Bei dem Dateiformat .gui handelt es sich im Wesentlichen um eine ASCII-Darstellung der ATARI ST-Ressourcendateien (.rsc). Diese können so in X11-Basic-Code konvertiert werden, der dann Nachrichtenfelder und Formulare beinhalten kann. Der Konverter gui2bas(1) macht genau das. Zur Konvertierung von ATARI ST-Ressourcendateien in *.gui-Dateien gibt es auch einen praktischen Konverter. Siehe rsc2gui(1).

Eine *.gui-Datei besteht aus Zeilen und Blöcken, die Objekte spezifizieren und ihre hierarchischen Abhängigkeiten enthalten.

Das generische Format eines solchen Objekts ist:

Das Label ist optional und gibt dem Objekt einen Namen. Je nach TYPE des Objekts werden eine oder mehrere Variablen als durch Kommas getrennte Liste in Klammern angegeben.

Jedes Objekt kann einen Block mit { am Ende der Zeile beginnen. Innerhalb dieses Blocks können ein oder mehrere Objekte definiert werden, die dann als Unterobjekte desjenigen betrachtet werden, der den Block geöffnet hat. Der Block wird mit einem } in einer einzigen Zeile geschlossen.

Die meisten Anwendungen verwenden eine Menüleiste, damit der Benutzer durch Programmoptionen navigieren kann.

Hier ist ein einfaches Beispielprogramm, das die Handhabung eines Dropdown-Menüs demonstriert.

Es gibt einige reservierte Variablen bzw. Variablennamen. Einige Schlüsselwörter funktionieren außerdem möglicherweise nicht als Variablennamen. Obwohl der Interpreter die Variablennamen nicht explizit überprüft, können Syntaxfehler bei Zuweisungen auftreten. Bitte versuchen Sie in solchen Fällen den Befehl LET. Solange sich eine Endung eines Variablennamens von einem Befehl oder Schlüsselwort unterscheidet, kann sie im Allgemeinen als Name verwendet werden.

Reservierte und Systemvariablen sind:

Beachten Sie, dass Sie diesen Variablen nichts zuweisen können. Sie haben immer ihren Wert je nach Funktion.

Bedingungen und Ausdrücke sind gleich, FALSE ist definiert als 0 und TRUE als -1. Boolesche Operatoren wie AND, OR, XOR usw. werden als bitweise Operation angewendet. Auf diese Weise können sie sowohl in Ausdrücken als auch in Bedingungen verwendet werden.

Zahlenkonstanten können mit 0x vorangestellt werden, um Hexadezimalwerte darzustellen. String-Konstanten werden mit Paaren von "" markiert. Array-Konstanten haben folgendes Format: [ , , ; , ; , , ].

Die Rangfolge ist wie folgt definiert (höchster zuerst):

Matritzenoperatoren oder allgemein Feld-Operatoren operieren auf Feldern. Je nach Feldtyp und Dimension koennen sie unterschiedliche Bedeuting haben.

Weiterhin gibt es Operatorn/Funktionen, die zwischen verschiedenen Variablenklassen Operieren: z.B.

Insbesondere sei auf den Reduktionsoperator hingewiesen: a(:,3) ist ein eindimensionaler Vektor, nämlich die Spalte Nr. 3 der Matrix a.

Im Interpreter kann jeder Befehl abgekürzt werden, solange der Befehlsparser den Befehl eindeutig identifizieren kann. Sie können also q anstelle von QUIT verwenden.

Zusätzlich gibt es Abkürzungen, die eigentlich alternative Befehle sind wie:

Die Mathematikfunktionsbibliothek enthält einen umfassenden Satz mathematischer Funktionen, einschließlich:

Einige mathematische Funktionen sind in Vektoren und Matrizen definiert.

X11-Basic kann eine Reihe von internen Fehlern erzeugen, auf die mit einer Nummer (ERR) verwiesen wird (siehe auch ERROR).

Die Bedeutung dieser Fehler und ihres Textausdrucks ist wie folgt:

Dieses Handbuch beschreibt die Syntax von BASIC-Befehlen und BASIC-Funktionen in verallgemeinerter Form. Hier ist ein Beispiel:

Die Teile des Befehls, die im Quellcode wörtlich vorkommen müssen (wie im obigen Beispiel PRINT), sind alle in Großbuchstaben geschrieben. Beschreibungen in spitzen Klammern ("<>") sollen nicht wörtlich im Quelltext erscheinen, sondern sind beschreibende Verweise auf das Element, das im Quellcode an dieser Stelle verwendet werden soll, wie eine Variable, ein numerischer Ausdruck usw. Optionale Elemente sind in eckigen Klammern ("[]") aufgeführt. Sie können in der Befehlszeile weggelassen werden. Gegenseitig ausschließende Alternativen sind durch das "|" Zeichen getrennt. Genau eine dieser Alternativen muß in der Befehlszeile erscheinen. Schließlich wird eine sich wiederholende Syntax durch drei Punkte "…​" angezeigt.

Hier sind einige BASIC-Befehlszeilen, die alle der obigen Syntaxvorlage entsprechen:

Nun, zuallererst: es ist möglich. Die grundlegenden Quelldateien (.bas) sind natürlich von jedem Texteditor lesbar und modifizierbar. Der Bytecode kompilierte Code (.b) ist bereits schwieriger zu lesen und fast unmöglich wieder in Quellcode zu konvertieren. Da X11-Basic jedoch Open Source ist, kann jeder, der möchte, in den Quellcode schauen und alle Informationen lesen, die notwendig sind, um den Bytecode zu dekodieren und ihn auch zu modifizieren.

Es ist möglich, aber es erfordert schon einen großen Aufwand. Der in C-Code übersetzte Bytecode könnte auch hier von jemandem geändert werden. Sobald der Bytecode in eine echte Maschinensprache übersetzt ist, ist der Code aber so sicher vor Hackern wie jeder andere Code (was bedeutet, dass es fast keinen Weg zurück gibt).

Selbst wenn Sie den Bytecode in die virtuelle Maschine einbinden, sollte Ihr Programm vor Schnüfflern sicher sein, die wissen ja nicht unbedingt, dass Ihr Programm Bytecode generiert.

Nein. Sie benötigen keine Lizenz, um X11-Basic zu benutzen (es ist kostenlos). Und Sie brauchen definitiv keine Lizenz, um Ihre Programme zu vertreiben oder zu verkaufen. Die einzige Vereinbarung, um die Sie sich sorgen müssen, ist, dass Sie, wenn Sie X11-Basic verwenden, alle direkten und indirekten Konsequenzen aus der Nutzung von X11-Basic übernehmen. Das bedeutet u.a.: Beschimpfen Sie mich nicht, wenn irgendwas nicht so funktioniert, wie Sie es erwarten. X11-Basic kann für jede Aufgabe verwendet werden, egal, ob diese gewinnorientiert ist oder nicht. Ich will es nicht wissen, und Sie brachen mir keinen Cent zu zahlen. Sie müssen nicht einmal erwähnen, dass Ihr Programm mit X11-Basic erstellt wurde (obwohl dies eine nette Geste wäre).

Sie dürfen X11-Basic mit Ihren Programmen bündeln, solange der Benutzer darüber informiert ist dass er nicht X11-Basic kauft oder dafür zahlt, sondern nur Ihr Programm oder Ihre Dienstleistung erwirbt. Wie kann man das machen? Indem Sie nicht einmal erwähnen, dass Ihre Distribution eine Kopie von X11-Basic enthält. Wenn Sie jedoch X11-Basic selbst verteilen oder ändern möchten oder wenn Sie Teile des X11-Basic-Quellcodes einbinden möchten, müssen Sie die GNU-Lizenz beachten.

Die Antwort hängt davon ab, wie ein X11-Basic-Programm ausgeführt wird: Es hängt davon ab, ob der Code interpretiert wird, als Bytecode in einer virtuellen Maschine ausgeführt wird oder in eine native Maschinensprache kompiliert wird. Generell finden wir:

Bytecodierte Programme werden immer schneller interpretiert als Skriptsprachen. Der X11-Basic-Compiler kann den X11-Basic-Bytecode in C übersetzen, der dann mithilfe eines beliebigen C-Compilers (vorzugsweise gcc auf UNIX-Systemen) in die native Maschinensprache kompiliert werden kann. Offensichtlich sind Ihre X11-Basic-Programme dann immernoch langsamer als optimierter C/C++ Code, aber es kommt dem schon nahe.

Wenn Sie die höchstmögliche Geschwindigkeit benötigen, können Sie eine separate DLL/ ein "shared Objekt" mit dem zeitkritischen Teil Ihres Codes hinzuladen, der in einer anderen Sprache geschrieben ist (z.B. C oder Assembler).

Ein Geschwindigkeitsvergleich wurde mit dem Whetstone-Benchmark (-→ Whets.bas) durchgeführt. Dies zeigt, dass Bytecode-Programme etwa 19 mal schneller sind als der interpretierte Code und ein nativ kompiliertes Programm etwa 28-mal schneller laufen kann.

Ich habe das letzte Update auf X11-Basic heruntergeladen, aber ich habe ein Problem mit dem UTF-8-Zeichensatz…​ Ich kann den ASCII-Zeichensatz nicht mehr verwenden, besonders den grafischen Teil davon…​ Ich habe ein kleines Spiel gemacht, das es benutzt, jetzt funktioniert es nicht mehr…​ Gibt es eine Möglichkeit, dieses Problem zu beheben?

Kopieren Sie aus der Seite http://de.wikipedia.org/wiki/Unicodeblock_Rahmenzeichnung das entsprechende Zeichen z.B.mit der Maus in den Editor. Sie müssen einen UTF-8-fähigen Editor verwenden, z. pico, nano, gedit.

Wenn dies bei Ihnen nicht funktioniert, können Sie das Zeichen auch selbst mit der Unicode-Nummer codieren:

So kann z.B. das Zeichen 0x250C mit @utf8$(0x250C) codiert werden.

Gibt es einen GUI-Designer für die grafischen Benutzeroberflächenfunktionen von X11-Basic?

X11-Basic weicht in zahlreichen Aspekten von ANSI BASIC ab. Es unterscheidet sich auch von GfA-Basic (Atari ST), obwohl es versucht, kompatibel zu sein und wirklich ähnlich aussieht:

TODO

Der Zweck dieser Lizenz ist es, ein Handbuch, Textbuch oder ein anderes zweckdienliches und nützliches Dokument frei, im Sinne von Freiheit, zu machen; jedermann die Freiheit zu sichern, es zu kopieren und mit oder ohne Änderungen daran, sowohl kommerziell als auch nicht kommerziell weiter zu verbreiten. Weiterhin sichert diese Lizenz einem Autor oder Verleger die Möglichkeit, Anerkennung für seine Arbeit zu erhalten ohne für Änderungen durch Andere verantwortlich gemacht zu werden.

Diese Lizenz ist eine Art des "copyleft", was bedeutet, daß von diesem Dokument abgeleitete Werke ihrerseits in derselben Weise frei sein müssen. Dies vervollständigt die GNU General Public License, die eine "copyleft"-Lizenz ist, und für freie Software entworfen wurde.

Diese Lizenz wurde für Handbücher für freie Software entworfen, denn freie Software braucht freie Dokumentation: Ein freies Programm sollte von Handbüchern begleitet sein, die dieselben Freiheiten bieten, die auch die Software selbst bietet. Diese Lizenz ist aber nicht auf Softwarehandbücher beschränkt; vielmehr kann sie für jede Art von textuellen Werken verwendet werden, unabhängig davon, was das Thema ist, oder ob es als gedrucktes Buch veröffentlicht wurde. Wir empfehlen diese Lizenz prinzipiell für Werke, die als Anleitungen oder Referenzen dienen sollen.

Diese Lizenz findet Anwendung auf jedes Handbuch oder andere Werk, unabhängig von dem Medium, auf dem es erscheint, das einen vom Rechteinhaber eingefügten Hinweis enthält, der besagt, daß das Werk unter den Bedingungen dieser Lizenz verbreitet werden darf. Ein solcher Hinweis gewährt eine weltweit gültige, tantiemenfreie und zeitlich unbefristete Lizenz, die es gestattet das Werk, unter den hier festgelegten Bedingungen, zu nutzen. Der Begriff Dokument wird im Folgenden für alle solche Handbücher und Werke verwendet. Jede Person kann Lizenznehmer sein und wird im Folgenden mit Sie angesprochen. Sie akzeptieren diese Lizenz, wenn Sie ein Dokument derart kopieren, verändern oder verteilen, daß Sie gemäß den Gesetzen zum Copyright die Erlaubnis benötigen.

Eine modifizierte Version des Dokumentes steht für jedes Werk, das das Dokument als Ganzes oder in Teilen enthält, sowohl auf Datenträger kopiert, als auch mit Änderungen und/oder in andere Sprachen übersetzt.

Ein zweitrangiger Abschnitt ist ein benannter Anhang oder eine Enleitung des Dokumentes, der sich ausschließlich mit dem Verhältnis des Autors oder Verlegers des Dokumentes zu dem eigentlichen Thema des Dokumentes (oder damit zusammenhängender Dinge) beschäftigt, und der nichts enthält, das direkt zu dem eigentlichen Thema gehört. (Wenn das Dokument beispielweise ein Buch über Mathematik ist, dann darf ein zweitrangiger Abschnitt nichts über Mathematik enthalten). Dies kann eine historische Beziehung zu dem Thema, oder damit zusammenhängender Dinge, oder von gesetzlicher, gesellschaftlicher, philosophischer, ethischer oder politischer Art sein, die das Thema betreffen.

Die unveränderlichen Abschnitte sind benannte zweitrangige Abschnitte, deren Titel als unveränderlicher Abschnitt in dem Lizenhinweis, der das Dokument unter diese Lizenz stellt, aufgeführt sind. Wenn ein Abschnitt nicht in die oben stehende Definition eines zweitrangigen Abschnittes passt, dann ist es nicht erlaubt diesen Bereich als unveränderlichen Bereich zu kennzeichnen.

Umschlagtexte sind bestimmte, kurze Textstücke, die als vorderer Umschlagtext oder als hinterer Umschlagtext in der Notiz benannt werden, die besagt, dass das Dokument unter dieser Lizenz freigegeben ist. Ein vorderer Umschlagtext kann bis zu 5 Worte enthalten, ein hinterer Umschlagtext bis zu 25 Worte.

Eine transparente Kopie des Dokumentes bezeichnet eine maschinenlesbare Kopie, dargestellt in einem Format, dessen Spezifikationen allgemein verfügbar sind, und das geeignet ist das Dokument auf einfache Weise mit einem allgemeinen Texteditor oder (für Bilder, die aus Pixeln bestehen) mit einem allgemeinen Bildberabeitungsprogramm oder (für Zeichnungen) mit einem häufig verfügbaren Zeichenprogramm zu überarbeiten, und das geeignet ist es als Eingabe für Textformatierer zu verwenden, oder als Eingabe für automatische Konvertierungsprogramme, die eine Reihe von unterschiedlichen Formaten erzeugen, die ihrerseits als Eingabe für Textformatierer verwendet werden können. Eine Kopie in ein anderes transparentes Dateiformat dessen Auszeichnung oder das fehlen der Auszeichnungen derart beschaffen sind, nachfolgende Modifikationen durch die Leser zu verhindern oder zu erschweren ist nicht transparent. Ein Bildformat ist nicht transparent, wenn es für eine wesentliche Menge von Text verwendet wird. Eine Kopie, die nicht transparent ist, wird als opak bezeichnet.

Beispiele verwendbarer Formate für transparente Kopien schliessen einfachen ASCII-Text ohne Auszeichnungen, TeX-info Eingabe, LaTeX-Eingabeformat, SGML oder XML, sofern die verwendete DTD öffentlich verfügbar ist, sowie standardkonformes, einfaches HTML, Postscript oder PDF, die für Veränderungen durch Menschen entworfen sind, ein.

Beispiele für transparente Bildformate sind u.a. PNG, XCF und JPG. Opake Formate sind unter anderen solche proprietären Formate, die nur von proprietären Textverarbeitungsprogramm gelesen und bearbeitet werden können, SGML oder XML deren DTD und/oder Verarbeitungswerkzeuge nicht allgemein verfügbar sind, und maschinengeneriertes HTML, PostScript oder PDF, das von manchen Textverarbeitungsprogrammen nur zu Ausgabezwecken erzeugt wird.

Mit Titelseite wird in einem gedruckten Buch die eigentliche Titelseite sowie die direkt darauf folgenden Seiten bezeichnet, die all das in lesbarer Form enthalten, was in dieser Lizenz gefordert ist, dass es auf der Titelseite erscheinen muss. Für Werke, die in Formaten vorliegen, die keine Titelseiten haben, gilt als Titelseite der Text, der der auffälligsten Darstellung des Titels des Werkes direkt folgt, aber noch vor dem Inhalt des Werkes steht.

Ein Abschnitt mit dem Titel xyz bezeichnet einen benannten Unterbereich des Dokumentes, dessen Titel entweder genau xyz ist, oder der xyz in Anführungszeichen enthält, der einem Text folgt, der xyz in eine andere Sprache übersetzt. (Hier steht xyz für einen speziellen Abschnittsnamen, der im Folgenden erwähnt wird wie"Danksagung"(Acknowledgements), "Widmung"(Dedications), "Anmerkung"(Endorsement) oder "Historie"(History).). Den Titel erhalten eines Abschnittes bedeutet, daß beim Modifizieren des Dokumentes dieser Abschnitt mit dem Titel xyz bleibt, wie es in dieser Definition festgelegt ist.

Das Dokument kann direkt hinter der Notiz, die besagt, dass das Dokument unter dieser Lizenz freigegeben ist, Garantieausschlüsse enthalten. Diese Garantieausschlüsse werden so behandelt, als seien sie als Referenzen in diese Lizenz eingeschlossen, allerdings nur um Garantien auszuschliessen: Jede andere Implizierung, die dieser Ausschluss hat ist ungültig und keine Wirkung im Sinne dieser Lizenz.

Sie dürfen das Dokument auf jedem Medium sowohl kommerziell als auch nicht kommerziell kopieren und verbreiten, vorausgesetzt, daß diese Lizenz, die Copyright-Hinweise sowie der Lizenzhinweis, der besagt, daß diese Lizenz auf das Dokument anzuwenden ist, in allen Kopien reproduziert wird, und daß keine weiteren Bedingungen jeglicher Art zu denen dieser Lizenz hinzugefügt werden. Sie dürfen in den Kopien, die Sie erstellen oder verbreiten, keinerlei technische Maßnahmen treffen um das Lesen oder das weitere Kopieren zu erschweren oder zu kontrollieren. Dennoch dürfen Sie Gegenleistungen für Kopien akzeptieren. Wenn Sie eine ausreichend große Menge von Kopien verteilen, müssen Sie zusätzlich die bestimmungen von Ziffer 4 beachten. Sie können ausserdem unter denselben Bedingungen, die oben angeführt sind, Kopien verleihen und sie können Kopien auch öffentlich bewerben.

Wenn Sie gedruckte Kopien des Dokumentes (oder Kopien auf Medien, die üblicherweise gedruckte Umschläge haben), in einer Stückzahl von mehr als 100 veröffentlichen, und der Lizenzhinweis des Dokumentes Umschlagtexte verlangt, müssen die Kopien in Hüllen verpackt sein, die alle diese Umschlagtexte klar und lesbar enthalten. Die vorderen Umschlagtexte auf dem vorderen Umschlag, die hinteren Umschlagtexte auf dem hinteren Umschlag. Beide Umschläge müssen Sie ausserdem klar und lesbar als den Herausgeber dieser Kopien benennen. Der vordere Umschlag muss den gesamten Titel darstellen, mit allen Worten gleich auffällig und sichtbar. Sie können weiteres Material den Umschlägen hinzufügen. Das Kopieren mit Änderungen, die auf Umschläge begrenzt sind, können, so lange der Titel des Dokuments erhalten bleibt, ansonsten als Datenträgerkopien behandelt werden.

Wenn der vorgeschriebene Text für einen der Umschläge zu umfangreich ist um lesbar zu bleiben, sollten Sie den ersten der aufgelisteten Texte auf den aktuellen Umschlag nehmen (so viel wie vernünftigerweise möglich ist) und den Rest auf direkt angrenzenden Seiten.

Wenn Sie mehr als 100 opake Kopien veröffentlichen oder verbreiten, müssen Sie entweder eine maschinenlesbare, transparente Kopie jeder opaken Kopie beilegen, oder mit bzw. in jeder opaken Kopie eine Computer-Netzwerk Adresse angeben, von wo die allgemeine, netzwerk benutzende Öffentlichkeit, Zugriff zum Download einer kompletten transparenten Kopie über öffentliche Standardnetzwerkprotokolle hat.

Wenn Sie sich für die letztere Möglichkeit entscheiden, müssen Sie mit Beginn der Verbreitung der opaken Kopien in Stückzahlen, zumutbare und vernünftige Schritte unternehmen, um sicher zu stellen, daß die transparenten Kopien mindestens ein Jahr nach der Auslieferung der letzten opaken Kopie (direkt oder über einen Agenten oder Händler) dieser Ausgabe an die Öffentlichkeit, an der genannten Adresse verfügbar bleiben.

Es ist erbeten, aber nicht gefordert, daß Sie ausreichend lange vor der Auslieferung einer grösseren Menge von Kopien, Kontakt mit den Autoren des Dokumentes aufnehmen, um jenen die Möglichkeit zu geben, Ihnen eine aktualisierte Version des Dokumentes zuzuleiten.

Unter den obigen Bedingungen unter Ziffer 3 und 4 können Sie modifizierte Versionen kopieren und verbreiten, vorausgesetzt, daß Sie die modifizierte Version unter exakt dieser Lizenz herausgeben, wobei die modifizierte Version die Rolle des Dokumentes einnimmt, und dadurch die weitere Modifikation und Verbreitung an jeden Lizensieren, der eine Kopie davon besitzt. Zusätzlich müssen Sie die folgenden Dinge in der modifizierten Version beachten:

Wenn die modifizierte Version neue Vorspannabschnitte oder Anhänge enthält, die zweitrangige Abschnitte sein können, und die kein vom Dokument kopiertes Material enthalten, können Sie, nach Ihrem Belieben, einige oder alle diese Abschnitte als unveränderliche Abschnitte in die Lizenzanmerkung der modifizierten Version aufnehmen. Diese Titel müssen sich von allen anderen Titeln unterscheiden.

Sie können einen Abschnitt Anmerkungen anfügen, sofern dieser nichts als Bemerkungen, verschiedener Stellen, zu der modifizierten Version enthält. Beispielsweise Publikumsreaktionen oder eine Mitteilung, daß der Text von einer Organisation als maßgebliche Definition eines Standards geprüft wurde.

Sie können einen Teil mit bis zu fünf Worten als vorderen Umschlagtext und einen mit bis zu 25 Worten als hinteren Umschlagtext an das Ende der Liste mit den Umschlagtexten der modifizierten Version hinzufügen. Nur je ein Teil für den vorderen Umschlagtext und den hinteren Umschlagtext können von jeder Einheit hinzugefügt (oder durch entsprechende Anordnung erstellt) werden.

Wenn das Dokument bereits einen Umschlagtext für denselben Umschlag enthält, das von Ihnen oder der Einheit, in deren Namen Sie tätig sind, bereits früher eingefügt wurde, dürfen Sie keine neue hinzufügen. Sie können aber den alten ersetzen, wenn sie die ausdrückliche Genehmigung des Herausgebers haben, der den früheren Text eingefügt hat.

Der/die Autor(en) und Herausgeber des Dokumentes geben duch diese Lizenz weder implizit noch explizit die Erlaubnis ihren Namen für Werbung in den Anmerkungen der modifizierten Version zu benutzen.

Sie können mehrere Dokumente, die unter dieser Lizenz freigegeben sind, unter den Bedingungen unter Ziffer 5 für modifizierte Versionen miteinander kombinieren, vorausgesetzt, daß in der Kombination alle unveränderlichen Abschnitte aller Originaldokumente, enthalten sind, und daß Sie diese alle in der Liste der unveränderlichen Abschnitte der Lizenzanmerkung des kombinierten Dokumentes aufführen, sowie alle Garantieausschlüsse erhalten.

Das kombinierte Werk braucht nur eine Kopie dieser Lizenz zu enthalten, und mehrere identische unveränderliche Abschnitte können durch eine einzelne Kopie ersetzt werden. Wenn es mehrere unveränderliche Abschnitte mit unterschiedlichem Inhalt aber gleichem Namen gibt, machen Sie den Namen eindeutig, indem Sie am Ende des Titels, in Anführungszeichen, den Namen des original Autors oder Herausgebers, falls bekannt, oder andernfalls eine eindeutige Nummer anhängen. Machen Sie dasselbe mit den Titeln der Abschnitte in der Liste der unveränderlichen Abschnitte im Lizenzhinweis des kombinierten Werkes.

In der Kombination müssen Sie alle Abschnitte mit dem Titel Historie in den unterschiedlichen Dokumenten zu einem einzelnen Abschnit Historie zusammenführen; entsprechend verfahren Sie mit den Abschnitten Danksagungen und Widmungen. Sie müssen alle Abschnitte mit dem Titel Anmerkungen löschen.

Sie können eine Sammlung von Dokumenten erstellen, bestehend aus diesem Dokument und weiteren, unter dieser Lizenz stehenden Dokumenten, wobei Sie die einzelnen Kopien dieser Lizenz in den verschiedenen Dokumenten durch eine einzelne Kopie, die in der Sammlung enthalten ist, ersetzen, vorausgesetzt, Sie befolgen in allen andern Punkten, für jedes der Dokumente, die Regeln für Datenträgerkopien.

Sie können ein einzelnes Dokument aus einer solchen Sammlung herausziehen und einzeln unter dieser Lizenz verbreiten, vorausgesetzt, Sie fügen eine Kopie dieser Lizenz in das extrahierte Dokument ein, und befolgen ansonsten die Bedingungen dieser Lizenz für Datenträgerkopien.

Eine Zusammenstellung des Werkes, oder von Ableitungen davon, mit anderen, separaten und unabhängigen Dokumenten oder Werken, in oder auf demselben Band eines Speicher- oder Verbreitungsmediums, wird dann eine Aggregation genannt, wenn die Copyrights der Zusammenstellung nicht dazu verwendet werden die Rechte der Benutzer, die für die einzelnen Werke gewährt werden, stärker zu beschränken als dies durch die Lizenzen der einzelnen Werke geschieht. Wenn das Werk in einer Aggregation vorhanden ist, so gilt diese Lizenz nicht für die anderen Werke dieser Aggregation, die keine Ableitung des Dokumentes sind.

Wenn die Bestimmungen für die Umschlagtexte aus Ziffer 4 Anwendung finden, und wenn das Dokument weniger als die Hälfte der gesammten Aggregation ausmacht, dann können die Umschlagtexte auf Seiten gesetzt werden, die das Dokument innerhalb der Aggregation umschliessen, oder auf das elektronische Äquivalent eines Umschlages, wenn das Dokument in elektronischer Form vorliegt. Andernfalls müssen sie auf gedruckten Umschlägen erscheinen, die das gesamte Werk umschliessen.

Übersetzungen werden als eine Art von Modifikationen betrachtet. Damit können Sie eine Übersetzung des Dokumentes unter den Bestimmungen von Ziffer 5 verbreiten. Um die unveränderlichen Abschnitte durch eine Übersetzung zu ersetzen, benötigen Sie die spezielle Erlaubnis des Copyright-Inhabers. Sie können allerdings Übersetzungen von einigen oder allen unveränderlichen Abschnitten zu den original Versionen der unveränderlichen Abschnitte hinzufügen. Sie können eine Übersetzung dieser Lizenz und allen Lizenzhinweisen im Dokument sowie allen Garantieausschlüssen hinzufügen, vorausgesetzt, daß Sie ebenso die originale englische Version dieser Lizenz und aller Hinweise und Ausschlüsse beifügen. Sollten die Übersetzung und die Originalversion dieser Lizenz oder eines Hinweises oder Ausschlusses voneinander abweichen, so hat die Originalversion vorrang.

Wenn ein Abschnitt des Dokumentes als Danksagung, Widmungen oder Historie überschrieben ist, so erfordert die Forderung (Ziffer 5) den Titel dieses Abschnittes zuerhalten, die Änderung des aktuellen Titels.

Sie dürfen dieses Dokument nicht kopieren, verändern, unterlizensieren oder verteilen mit der Ausnahme, daß Sie es ausdrücklich unter dieser Lizenz tun. Jedweder andere Versuch zu kopieren, zu modifizieren, unter zu lizensieren oder zu verbreiten ist unzulässig und führt automatisch zum Entzug der durch diese Lizenz gewährten Rechte. Dennoch verlieren jene Parteien, die von ihnen Kopien oder Rechte unter dieser Lizen erhalten haben, nicht Ihre Rechte, so lange sie sich in völliger Übereinstimmung mit der Lizenz befinden.

Die Free Software Foundation kann von Zeit zu Zeit neue, überarbeitete Versionen der GNU Free Dokumentation License veröffentlichen. Diese neuen Versionen werden im Geiste gleich bleiben, können sich aber in Details unterscheiden um neuen Problemen oder Besorgnissen gerecht zu werden. Siehe: http://www.gnu.org/copyleft/.

Jede Version dieser Lizenz erhält eine eigene Versionsnummer. Wenn das Dokument bestimmt, daß eine bestimmt numerierte Version oder jede spätere Version dafür gilt, haben Sie die Wahl den Bestimmungen dieser speziell benannten Version zu folgen, oder jeder Version, die später von der Free Software Foundation, nicht als Entwurf, veröffentlicht wurde.

Um diese Lizenz in einem Dokument zu verwenden, das sie selbst geschrieben haben, schliessen Sie eine Kopie dieser Lizenz (eine englische Kopie des Originals anm. des Übersetzers) in Ihr Dokument mit ein, und setzen Sie den folgenden Copyright- und Lizenzhinweis gleich hinter die Titelseite:

Es folgt eine Übersetzung des oben stehenden Hinweises, der nur zur Klarheit hier angegeben ist ! (anm.: des Übersetzers) Copyright Jahr Ihr Name Kopieren, Verbreiten und/oder Modifizieren ist unter den Bedingungen der GNU Free Documentation License, Version 1.2 oder einer späteren Version, veröffentlicht von der Free Software Foundation, erlaubt. Es gibt keine unveränderlichen Abschnitte, keinen vorderen Umschlagtext und keinen hinteren Umschlagtext Eine Kopie des Lizenztextes ist unter dem Titel GNU Free Documentation License enthalten. (Ende der Übersetzung des Lizenzhinweistextes)

Wenn Sie unveränderlichen Abschnitte, vordere und hintere Umschlagtexte haben, ersetzen Sie die Zeile: "Es gibt keine…​…​ Umschlagtext" durch die Folgende: Mit den unveränderlichen Abschnitten: Liste dem den Titeln der unveränderlichen Abschnitte mit dem vorderen Umschlagtext: vorderer Umschlagtext und dem hinteren Umschlagtext: hinterer Umschlagtext

Wenn Sie unveränderliche Abschnitte, aber keine Umschlagtexte oder irgend eine andere Kombination der drei Bereiche haben, mischen Sie die verschiedenen Alternativen, daß sie zu Ihren Anforderungen passen.

Wenn Ihr Dokument nicht-triviale Codebeispiele enthält empfehlen wir diese Beispiele parrallel unter einer freien Softwarelizenz Ihrer Wahl, beispielsweise der GNU General Public License zu lizensieren, um ihren Gebrauch in freier Software zu erlauben.