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
Aufbau
Dateinamens-Endung
Zeichenkodierung

die Details

export definition file

Notwendigkeit
Schlüssel
Wert

import definition files

Notwendigkeit
Schlüssel
Wert

source code files

Notwendigkeit
Schlüssel
Wert

output

Notwendigkeit
Schlüssel
Wert

weiteres Material zu diesem Thema

Dokumente
Sonstiges
Aufnahme von weiteren Materialien

über dieses Dokument

was es hierin gibt

Dieses Dokument

• beschreibt Kompiler-Konfigurationsdateien für die Programmiersprache "Minicode" und
• zeigt, welche Konfigurationsmöglichkeiten es für den Kompiler gibt.

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

Die Kompiler-Konfigurationsdatei ist ein Hilfsmittel, um dem Kompiler die notwendigen Angaben für das zu kompilierende Projekt zu übermitteln.

Dem Minicode-Kompiler wird als Kommandozeilen-Parameter lediglich der Pfad und der Dateiname von der Kompiler-Konfigurationsdatei übergeben.

Notwendigkeit

Unabhängig davon, was mit Minicode programmiert wird, ist bei jedem Projekt (also bei jeder Anwendung und bei jeder Bibliothek) mindestens 1 Kompiler-Konfigurationsdatei notwendig.

Wenn

• das Projekt für mehrere Betriebssysteme programmiert wird,

dann

• ist für jedes Betriebssystem eine separate Kompiler-Konfigurationsdatei notwendig.

Diese zusätzliche Kompiler-Konfigurationsdatei ist in anderen Sprachen nicht notwendig. Es gibt in anderen Sprachen

• zum Einen die Variante, dass man die Konfiguration dem Kompiler mit der Hilfe von Kommandozeilen-Parametern übergibt.
  
  Die Minicode-Variante bietet die Vorteile,
  • dass ein Minicode-Projekt leichter von einer Person einer anderen Person übergeben werden kann und
  • dass die Kompiler-Konfiguration nicht durch Vergessenheit verloren geht, da sie in einer Datei abgespeichert ist.
• zum Anderen die Variante, dass man die Konfiguration in den Quellcode schreibt. Bei dieser Variante wird dann meist speziell gekennzeichnet, dass es sich nicht um Quellcode handelt, sondern um eine Kompiler-Konfiguration/-Anweisung. Meiner Meinung nach gehören diese Angaben dort nicht hin. Deshalb ist dieser "Hack", das spezielle Kennzeichnen, notwendig.

Aufbau

Die Definitionen, welche in der Kompiler-Konfigurationsdatei festgelegt werden, werden so formatiert in der Datei gespeichert, wie in Minicode eine Variable vom Variablentyp "Liste" definiert wird. In der Datei befindet sich lediglich 1 Hauptliste. Diese kann allerdings weitere Unterlisten enthalten.

Der komplette Inhalt von einer Kompiler-Konfigurationsdatei kann also beispielsweise wie folgt aussehen:

<
    "source code files" : <
        "Quellcode-Dateien\\Haupt-Quellcode.mico-soco"
        "C:\\allgemeine Minicode Funktionen\\Datenbank-Zugriff.mico-soco"
    >
    "output" : "kompilierte Dateien\\Programm.exe"
>

Dateinamens-Endung

Die vorgeschlagene Dateinamens-Endung heißt "mico-coco". "Kompiler-Konfiguration für Windows.mico-coco" ist ein Beispiel für einen vollständigen Dateinamen.

Die Abkürzung steht für "Minicode - compiler configuration 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

export definition file

Notwendigkeit

Dieser Eintrag ist nicht notwendig, damit ein Projekt kompiliert werden kann.

Schlüssel

Bezeichnung:	export definition file
Variablentyp:	Zeichenkette

Wert

Beispiel:	Export-Definitionsdatei\diese_Bibliothek.mico-exde
Beschreibung:	Mit der Hilfe von dieser Angabe wird dem Kompiler bekannt gemacht, wo die zu verwendene Export-Definitionsdatei gespeichert ist. Der Wert gibt einen Pfad und einen Dateinamen zu der Datei an, welche gelesen werden soll. Diese Pfadangabe kann absolut oder relativ zur Kompiler-Konfigurationsdatei sein.
Variablentyp:	Zeichenkette

import definition files

Notwendigkeit

Dieser Eintrag ist nicht notwendig, damit ein Projekt kompiliert werden kann.

Schlüssel

Bezeichnung:	import definition files
Variablentyp:	Zeichenkette

Wert

Beispiel:	<     "Import-Definitionsdateien\\individual_encryption.mico-imde"     "C:\\oft benutzte Minicode Import-Definitionsdateien\\kernel32.mico-imde" >
Beschreibung:	Mit der Hilfe von dieser Liste werden die Minicode Import-Definitionsdateien in einer beliebigen Reihenfolge aufgelistet, welche die Import-Definitionen enthalten, welche wiederum für das Projekt benötigt werden. Jeder Eintrag von dieser Liste gibt einen Pfad und einen Dateinamen zu einer Import-Definitionsdatei an. Diese Pfadangaben können absolut oder relativ zur Kompiler-Konfigurationsdatei sein. Jeder Eintrag von dieser Liste ist ein Wert vom Variablentyp "Zeichenkette".
Variablentyp:	Liste

source code files

Notwendigkeit

Dieser Eintrag ist notwendig, damit ein Projekt kompiliert werden kann.

Schlüssel

Bezeichnung:	source code files
Variablentyp:	Zeichenkette

Wert

Beispiel:	<     "Quellcode-Dateien\\Haupt-Quellcode.mico-soco"     "C:\\allgemeine Minicode Funktionen\\Datenbank-Zugriff.mico-soco" >
Beschreibung:	Mit der Hilfe von dieser Liste werden die Minicode Quellcode-Dateien in der Reihenfolge aufgelistet, wie sie zur Zusammenstellung von einer langen Quellcode-Datei verwendet werden sollen. Anschließend wird die lange Quellcode-Datei kompiliert. Jeder Eintrag von dieser Liste gibt einen Pfad und einen Dateinamen zu einer Quellcode-Datei an. Diese Pfadangaben können absolut oder relativ zur Kompiler-Konfigurationsdatei sein. Jeder Eintrag von dieser Liste ist ein Wert vom Variablentyp "Zeichenkette".
Variablentyp:	Liste

output

Notwendigkeit

Dieser Eintrag ist notwendig, damit ein Projekt kompiliert werden kann.

Schlüssel

Bezeichnung:	output
Variablentyp:	Zeichenkette

Wert

Beispiel:	kompilierte Dateien\Programm.exe
Beschreibung:	Mit der Hilfe von dieser Angabe wird dem Kompiler bekannt gemacht, wo die kompilierte Datei gespeichert werden soll. Der Wert gibt einen Pfad und einen Dateinamen zu der kompilierten Datei an, welche erzeugt werden soll. Diese Pfadangaben können absolut oder relativ zur Kompiler-Konfigurationsdatei sein. Die Art von der Datei, welche durch den Kompilierungsvorgang erzeugt wird, wird anhand von der vorgegebenen Dateinamen-Endung bestimmt: Datei-Art: Dateinamen-Endung: ausführbare Datei für Linux - keine von den aufgelisteten Endungen - ausführbare Datei für Windows .exe Bibliothek für Linux .so Bibliothek für Windows .dll
Variablentyp:	Zeichenkette

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 - Export-Definitionsdateien		beschreibt Export-Definitionsdateien für die Programmiersprache "Minicode"
	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 - Quellcode-Dateien		beschreibt Quellcode-Dateien für die Programmiersprache "Minicode"
	Zeichenkodierungen		beschreibt verschiedene Zeichenkodierungen

Sonstiges

Name vom		Beschreibung:	Sprache:	Weblink:
Autor:	Material:
	Beispiele für Kompiler-Konfigurationsdateien	Bei den Bibliotheken befinden sich zum Teil Beispiele für Kompiler-Konfigurationsdateien, da manche von den Demonstrationsprogrammen in Minicode geschrieben sind. Manche Demonstrationsprogramme sind allerdings in Maschinensprache geschrieben.	Minicode	OnTheServer.de/Downloads/

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".