Stand: 7. Januar 2018

Inhaltsverzeichnis

über dieses Dokument

was es hierin gibt
wo man die neuste Version bekommt
wie man den Verfasser kontaktiert
welche gesetzlichen Einschränkungen es gibt

Lizenzlosigkeit
Verfasserschutz
Vorbehalt für zusätzliche Einschränkungen für zukünftige Versionen

allgemeine Informationen

Zweck
Notwendigkeit
Dateinamens-Endung
Zeichenkodierung

die Details

Funktionsbeschreibung

Allgemeines
Wert
name in the raw data file

Notwendigkeit
Schlüssel
Wert

name in the source code files

Notwendigkeit
Schlüssel
Wert

parameters

Notwendigkeit
Schlüssel
Wert

weiteres Material zu diesem Thema

Dokumente
Aufnahme von weiteren Materialien

über dieses Dokument

was es hierin gibt

Dieses Dokument

• beschreibt Export-Definitionsdateien für die Programmiersprache "Minicode".

Alle anderen Informationen über Minicode, inklusiv den anderen Dateitypen, sind in separaten Dokumenten untergebracht. Diese sind im Kapitel "weiteres Material zu diesem Thema - Dokumente" aufgelistet.

wo man die neuste Version bekommt

Derzeit nutze ich OnTheServer.de/Downloads/ um neue Versionen zugänglich zu machen. Sie müsste irgendwo dort in den Unterverzeichnissen sein; das kann sich hin und wieder ein bischen ändern.

Dort gibt es vielleicht auch dieses Dokument in anderen Sprachen.

Die Versions-Angabe von diesem Dokument steht oben rechts ("Stand: ...").

wie man den Verfasser kontaktiert

Der Verfasser von diesem Dokument kann mit der Hilfe von einer elektronischen Nachricht kontaktiert werden. Das hierfür eingerichtete Postfach ist mit der Hilfe von der folgenden Adresse erreichbar:

Kontakt@On(entferne mich)TheServer.de

welche gesetzlichen Einschränkungen es gibt

Lizenzlosigkeit

Dieses Dokument

• ist an keine Lizenz gebunden.
• unterliegt nicht den Einschränkungen durch das Urhebergesetz.
• soll allgemeinfrei (public domain) behandelt werden. Also so, als wenn es sich um ein Eigentum von der Allgemeinheit handelt.

Im Übrigen soll alles, was man auf OnTheServer.de und den Subdomains öffentlich zugänglich findet, entsprechend behandelt werden.

Es gibt auf OnTheServer.de allerdings eine Ausnahme:

Ich lege gelegentlich im Verzeichnis "OnTheServer.de/temp/" urheberrechtlich geschütztes Material ab.

Es ist nicht gestattet, auf irreführendeweise vorzutäuschen, dass das (ursprüngliche) Dokument an eine Lizenz gebunden wäre.

Verfasserschutz

Es ist nicht gestattet, auf irreführendeweise vorzutäuschen, dass man der (ursprüngliche) Verfasser vom Dokument wäre. Der (ursprüngliche) Verfasser muss jedoch nicht namentlich genannt werden.

Vorbehalt für zusätzliche Einschränkungen für zukünftige Versionen

Ich (der ursprüngliche Verfasser) behalte die Möglichkeit, Einschränkungen für

• die Veränderung oder/und
• die Verbreitung

aufzuerlegen. Von den Einschränkungen wären lediglich neue Versionen betroffen. Was bisher veröffentlicht wurde, erhält keine weiteren Einschränkungen.

Von diesem Recht werde ich hoffentlich nie gebrauch machen müssen.

allgemeine Informationen

Zweck

Wenn

• keine Anwendung programmiert wird, sondern eine Bibliothek,

dann

• ist die Export-Definitionsdatei ein Hilfsmittel, um die maschinennahen Spezifikationen von den Dingen zu definieren, welche für einen Export markiert werden sollen und somit von anderen
  • Anwendungen und
  • Bibliotheken
  importiert werden können.

Notwendigkeit

Wenn

• eine Bibliothek programmiert wird und
• etwas von der Bibliothek für einen Export markiert werden soll,

dann

• ist für das Projekt 1 Export-Definitionsdatei notwendig.

Ansonsten, wenn

• eine Anwendung programmiert wird,

dann

• ist keine Export-Definitionsdatei zulässig, da es in Minicode nicht zulässig ist, dass eine Anwendung etwas exportiert.
  
  Diese Entscheidung wurde getroffen, da nicht alle Betriebssysteme,
  • welche unterstützt werden oder
  • welche zu unterstützen geplant sind,
  bei einer Anwendung einen Export zulassen. Somit kann Minicode weitgehend Betriebssystem-unabhängig bleiben.

Dateinamens-Endung

Die vorgeschlagene Dateinamens-Endung heißt "mico-exde". "meine_Bibliothek.mico-exde" ist ein Beispiel für einen vollständigen Dateinamen.

Die Abkürzung steht für "Minicode - export definition file".

Zeichenkodierung

Die vorgeschlagene Zeichenkodierung heißt "UTF-8".

Die Abkürzung steht für "Unicode Transformation Format - 8 bit (per part)".
Der in Klammern stehende Teil gehört nicht zur offiziellen Bezeichnung.

Im Kapitel "weiteres Material zu diesem Thema - Dokumente" ist ein Dokument über Zeichenkodierungen aufgelistet, in welchem unter anderem diese Zeichenkodierung beschrieben ist.

die Details

Funktionsbeschreibung

Allgemeines

Bezeichnung:	Funktionsbeschreibung
Notwendigkeit:	Für jedes Ding (das heißt jede Funktion und jede Methode), welches von der Bibliothek für einen Export markiert werden soll, ist jeweils 1 Funktionsbeschreibung notwendig.

Wert

Beispiel:	<     "name in the raw data file" : "decode"     "name in the source code files" : "dekodieren"     "parameters" : <         ...     > >
Beschreibung:	Mit der Hilfe von dieser Liste werden die notwendigen Angaben gemacht, um 1 Ding für einen Export zu markieren.
Variablentyp:	Liste

name in the raw data file

Notwendigkeit

Dieser Eintrag ist notwendig.

Schlüssel

Bezeichnung:	name in the raw data file
Variablentyp:	Zeichenkette

Wert

Beispiel:	decode
Beschreibung:	Mit der Hilfe von dieser Angabe wird der Name von der Funktion definiert, wie er in die Bibliothek gespeichert werden soll.
Variablentyp:	Zeichenkette

name in the source code files

Notwendigkeit

Dieser Eintrag ist nicht notwendig. Wenn dieser Eintrag nicht angegeben wird, dann wird angenommen, dass der Name, wie er für die Speicherung in der Bibliothek angegeben ist, auch im Quellcode vorhanden ist. Wenn also beispielsweise der Name "from_GIF_to_PNG" als Funktionsname in der Bibliothek gespeichert werden soll und kein Funktions- oder Methodenname für die Funktion im Quellcode angegeben ist, dann wird die Funktion "from_GIF_to_PNG" vom Quellcode verwendet.

Schlüssel

Bezeichnung:	name in the source code files
Variablentyp:	Zeichenkette

Wert

Beispiel:	dekodieren
Beschreibung:	Mit der Hilfe von dieser Angabe wird ein Name von der Funktion oder ein Name von der Klasse und ein Name von der Methode definiert, welcher im Quellcode verwendet wird. Die Funktion oder Methode, welche durch diesen Eintrag angegeben ist, ist jene Funktion oder Methode, welche für einen Export markiert werden soll.
Variablentyp:	Zeichenkette

parameters

Notwendigkeit

Dieser Eintrag ist notwendig.

Schlüssel

Bezeichnung:	parameters
Variablentyp:	Zeichenkette

Wert

Beispiel:	<     "from the exporter to the importer" : <         ...     >     "from the importer to the exporter" : <         ...     > >
Beschreibung:	Mit der Hilfe von dieser Liste werden Unterlisten definiert, in welchen Parameter definiert werden. Weitere Informationen hierzu sind in der Dokumentation "Minicode Import-Definitionsdateien" in den Kapiteln "die Details - Bibliothekenbeschreibung - functions - Funktionsbeschreibung - parameters - from the exporter to the importer" und "die Details - Bibliothekenbeschreibung - functions - Funktionsbeschreibung - parameters - from the importer to the exporter".
Variablentyp:	Liste

weiteres Material zu diesem Thema

Dokumente

Name vom		Sprache:	Umfang vom Inhalt:	Weblink:
Autor:	Dokument:
	Minicode - allgemeine Informationen	deutsch	enthält allgemeine Informationen über die Programmiersprache "Minicode"	OnTheServer.de/Downloads/
	Minicode - Import-Definitionsdateien		beschreibt Import-Definitionsdateien für die Programmiersprache "Minicode"
	Minicode - Klasse - Ganzzahl		beschreibt die Klasse "Ganzzahl" für die Programmiersprache "Minicode"
	Minicode - Klasse - Kommazahl		beschreibt die Klasse "Kommazahl" für die Programmiersprache "Minicode"
	Minicode - Klasse - Liste		beschreibt die Klasse "Liste" für die Programmiersprache "Minicode"
	Minicode - Klasse - Nichtigkeitsangabe		beschreibt die Klasse "Nichtigkeitsangabe" für die Programmiersprache "Minicode"
	Minicode - Klasse - Rohdatenkette		beschreibt die Klasse "Rohdatenkette" für die Programmiersprache "Minicode"
	Minicode - Klasse - Wahrheitsangabe		beschreibt die Klasse "Wahrheitsangabe" für die Programmiersprache "Minicode"
	Minicode - Klasse - Zeichenkette		beschreibt die Klasse "Zeichenkette" für die Programmiersprache "Minicode"
	Minicode - Kompiler-Konfigurationsdateien		beschreibt Kompiler-Konfigurationsdateien für die Programmiersprache "Minicode" zeigt, welche Konfigurationsmöglichkeiten es für den Kompiler gibt
	Minicode - Quellcode-Dateien		beschreibt Quellcode-Dateien für die Programmiersprache "Minicode"
	Zeichenkodierungen		beschreibt verschiedene Zeichenkodierungen

Aufnahme von weiteren Materialien

Wenn

• Sie weitere Materialien zu diesem Thema haben, von welchen Sie wollen, dass sie in diese Auflistungen aufgenommen werden,

dann

• können Sie mir gerne die Materialien oder einen Link zu ihnen zusenden.

Sie dürfen durchaus auch Ihre eigenen Materialien zuschicken.

Bei den zugesendeten Materialien werde ich beurteilen, ob sie sich für die Auflistung eignen. Manche Materialien werden nicht aufgenommen, weil beispielsweise ein Hinweis enthalten ist, dass

• eine Verbreitung nicht gestattet ist oder
• nur unter Bedingungen, welche ich nicht erfüllen will.

Es besteht kein Anspruch darauf, dass zugesendete Materialien aufgenommen werden.

Link zum Kapitel "wie man den Verfasser kontaktiert".