[tyndur-devel] [PATCH] bincat, cat, cd, date, exit, pwd, set, sleep, source, start und stat

[Alexander Hartmut Kluth <alexanderkluth@xxxxxx>]

From: Alexander Hartmut Kluth <derhartmut@xxxxxxxx>

---
 bincat.xml |   38 ++++++++++++++++++++++++++++++++++++++
 cat.xml    |   36 ++++++++++++++++++++++++++++++++++++
 cd.xml     |   34 ++++++++++++++++++++++++++++++++++
 date.xml   |   34 ++++++++++++++++++++++++++++++++++
 exit.xml   |   29 +++++++++++++++++++++++++++++
 pwd.xml    |   29 +++++++++++++++++++++++++++++
 set.xml    |   44 ++++++++++++++++++++++++++++++++++++++++++++
 sleep.xml  |   36 ++++++++++++++++++++++++++++++++++++
 source.xml |   35 +++++++++++++++++++++++++++++++++++
 start.xml  |   37 +++++++++++++++++++++++++++++++++++++
 stat.xml   |   37 +++++++++++++++++++++++++++++++++++++
 11 files changed, 389 insertions(+), 0 deletions(-)
 create mode 100644 bincat.xml
 create mode 100644 cat.xml
 create mode 100644 cd.xml
 create mode 100644 date.xml
 create mode 100644 exit.xml
 create mode 100644 pwd.xml
 create mode 100644 set.xml
 create mode 100644 sleep.xml
 create mode 100644 source.xml
 create mode 100644 start.xml
 create mode 100644 stat.xml

diff --git a/bincat.xml b/bincat.xml
new file mode 100644
index 0000000..4bf9d8c
--- /dev/null
+++ b/bincat.xml
@@ -0,0 +1,38 @@
+<refentry id="bincat" lang="de">
+
+<refnamediv>
+    <refname>bincat</refname>
+    <refpurpose>
+        Zeige den Inhalt einer Datei als einzelne Bytes an
+    </refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+    <cmdsynopsis>
+        <command>bincat</command>
+        <arg choice="req"><replaceable>Datei</replaceable></arg>
+    </cmdsynopsis>
+</refsynopsisdiv>
+
+<refsection>
+    <title>Beschreibung</title>
+    <para>
+        Per bincat kann man sich den Inhalt einer Datei in Form von Bytes (hexadazimal)
+        auf dem Bildschirm anzeigen lassen.
+        <itemizedlist>
+            <listitem>
+                Die Datei wird als Parameter angegeben. Wenn selbige exisitiert und kein
+                Verzeichnis ist, wird der Inhalt in Form von Bytes auf dem Bildschirm 
+                ausgegeben. Zum Scrollen bitte Shift+BildAuf/BildAb benutzen.
+            </listitem>
+        </itemizedlist>
+    </para>
+</refsection>
+
+<refsection>
+    <title>Siehe auch</title>
+    <para><olink targetdoc="cat" targetptr="">cat</olink></para>
+    <para><olink targetdoc="pipe" targetptr="">pipe</olink></para>
+</refsection>
+
+</refentry>
diff --git a/cat.xml b/cat.xml
new file mode 100644
index 0000000..1d87b8a
--- /dev/null
+++ b/cat.xml
@@ -0,0 +1,36 @@
+<refentry id="cat" lang="de">
+
+<refnamediv>
+    <refname>cat</refname>
+    <refpurpose>
+        Zeige den Inhalt einer Datei an
+    </refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+    <cmdsynopsis>
+        <command>cat</command>
+        <arg choice="req"><replaceable>Datei</replaceable></arg>
+    </cmdsynopsis>
+</refsynopsisdiv>
+
+<refsection>
+    <title>Beschreibung</title>
+    <para>
+        Per cat kann man sich den Inhalt einer Datei auf dem Bildschirm anzeigen lassen.
+        <itemizedlist>
+            <listitem>
+                Die Datei wird als Parameter angegeben. Wenn selbige exisitiert und kein
+                Verzeichnis ist, wird der Inhalt auf dem Bildschirm ausgegeben.
+            </listitem>
+        </itemizedlist>
+    </para>
+</refsection>
+
+<refsection>
+    <title>Siehe auch</title>
+    <para><olink targetdoc="bincat" targetptr="">bincat</olink></para>
+    <para><olink targetdoc="pipe" targetptr="">pipe</olink></para>
+</refsection>
+
+</refentry>
diff --git a/cd.xml b/cd.xml
new file mode 100644
index 0000000..d4ed4a8
--- /dev/null
+++ b/cd.xml
@@ -0,0 +1,34 @@
+<refentry id="cd" lang="de">
+
+<refnamediv>
+    <refname>cd</refname>
+    <refpurpose>
+        Wechseln in ein neues Verzeichnis
+    </refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+    <cmdsynopsis>
+        <command>cd</command>
+        <arg choice="req"><replaceable>Verzeichnis</replaceable></arg>
+    </cmdsynopsis>
+</refsynopsisdiv>
+
+<refsection>
+    <title>Beschreibung</title>
+    <para>
+        Mit cd kann man in ein neues Verzeichnis wechseln.
+        <itemizedlist>
+            <listitem>
+                Mit Parameter wird in das aktuelle Verzeichnis gewechselt, sofern es eins ist.
+            </listitem>
+        </itemizedlist>
+    </para>
+</refsection>
+
+<refsection>
+    <title>Siehe auch</title>
+    <para><olink targetdoc="pwd" targetptr="">pwd</olink></para>
+</refsection>
+
+</refentry>
diff --git a/date.xml b/date.xml
new file mode 100644
index 0000000..d25f37e
--- /dev/null
+++ b/date.xml
@@ -0,0 +1,34 @@
+<refentry id="date" lang="de">
+
+<refnamediv>
+    <refname>date</refname>
+    <refpurpose>
+        Zeigt das aktuelle Datum und die aktuelle Uhrzeit an
+    </refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+    <cmdsynopsis>
+        <command>date</command>
+    </cmdsynopsis>
+</refsynopsisdiv>
+
+<refsection>
+    <title>Beschreibung</title>
+    <para>
+        date zeigt das aktuelle Datum und die aktuelle Uhrzeit an.
+        <itemizedlist>
+            <listitem>
+                Die Datei wird als Parameter angegeben. Wenn selbige exisitiert und kein
+                Verzeichnis ist, wird der Inhalt auf dem Bildschirm ausgegeben.
+            </listitem>
+        </itemizedlist>
+    </para>
+</refsection>
+
+<refsection>
+    <title>Siehe auch</title>
+    <para><olink targetdoc="sleep" targetptr="">sleep</olink></para>
+</refsection>
+
+</refentry>
diff --git a/exit.xml b/exit.xml
new file mode 100644
index 0000000..0213389
--- /dev/null
+++ b/exit.xml
@@ -0,0 +1,29 @@
+<refentry id="exit" lang="de">
+
+<refnamediv>
+    <refname>exit</refname>
+    <refpurpose>
+        Beendet die Shell
+    </refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+    <cmdsynopsis>
+        <command>exit</command>
+    </cmdsynopsis>
+</refsynopsisdiv>
+
+<refsection>
+    <title>Beschreibung</title>
+    <para>
+        exit beendet die aktuelle Shell. Läuft keine Shell mehr im Hintergrund, lässt sich
+        per ENTER eine neue starten.
+    </para>
+</refsection>
+
+<refsection>
+    <title>Siehe auch</title>
+    <para><olink targetdoc="start" targetptr="">start</olink></para>
+</refsection>
+
+</refentry>
diff --git a/pwd.xml b/pwd.xml
new file mode 100644
index 0000000..efd5cdf
--- /dev/null
+++ b/pwd.xml
@@ -0,0 +1,29 @@
+<refentry id="pwd" lang="de">
+
+<refnamediv>
+    <refname>pwd</refname>
+    <refpurpose>
+        Anzeigen des aktuellen Verzeichnispfades
+    </refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+    <cmdsynopsis>
+        <command>ls</command>
+    </cmdsynopsis>
+</refsynopsisdiv>
+
+<refsection>
+    <title>Beschreibung</title>
+    <para>
+        Per pwd wird der aktuelle Verzeichnispfad auf dem Bildschirm ausgegeben.
+    </para>
+</refsection>
+
+<refsection>
+    <title>Siehe auch</title>
+    <para><olink targetdoc="ls" targetptr="">ls</olink></para>
+    <para><olink targetdoc="cd" targetptr="">cd</olink></para>
+</refsection>
+
+</refentry>
diff --git a/set.xml b/set.xml
new file mode 100644
index 0000000..5be6bcc
--- /dev/null
+++ b/set.xml
@@ -0,0 +1,44 @@
+<refentry id="set" lang="de">
+
+<refnamediv>
+    <refname>set</refname>
+    <refpurpose>
+        Setzt Umgebungsvariablen oder zeigt diese an
+    </refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+    <cmdsynopsis>
+        <command>set</command>
+    </cmdsynopsis>
+    <cmdsynopsis>
+        <command>set</command>
+        <arg choice="req"><replaceable>Umgebungsvariable</replaceable></arg>
+    </cmdsynopsis>
+</refsynopsisdiv>
+
+<refsection>
+    <title>Beschreibung</title>
+    <para>
+        Per set kann man sich die aktuellen Umgebungsvariablen ansehen, deren Werte neu
+        setzen oder neue Umgebungsvariablen mit neuen Werten setzen.
+        <itemizedlist>
+            <listitem>
+                Ohne Parameter werden die aktuellen Umgebungsvariablen samt Werte angezeigt.
+            </listitem>
+            <listitem>
+                Ist der erste Parameter eine existierende Variable, so wird mit dem zweite Parameter
+                der neue Wert gesetzt.
+            </listitem>
+            <listitem>
+            	Ist der erste Parameter eine neue Variable, so wird diese angelegt, allerdings nur, 
+            	wenn ein zweiter Parameter vorhanden ist.
+        </itemizedlist>
+    </para>
+</refsection>
+
+<refsection>
+    <title>Siehe auch</title>
+</refsection>
+
+</refentry>
diff --git a/sleep.xml b/sleep.xml
new file mode 100644
index 0000000..916465f
--- /dev/null
+++ b/sleep.xml
@@ -0,0 +1,36 @@
+<refentry id="sleep" lang="de">
+
+<refnamediv>
+    <refname>sleep</refname>
+    <refpurpose>
+        Aktuelle Unterbrechung des Betriebes
+    </refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+    <cmdsynopsis>
+        <command>sleep</command>
+        <arg choice="req"><replaceable>Sekunden</replaceable></arg>
+    </cmdsynopsis>
+</refsynopsisdiv>
+
+<refsection>
+    <title>Beschreibung</title>
+    <para>
+        Per sleep unterbricht bzw. hält man z.B. ein Script für eine definierte
+        Zeit an.
+        <itemizedlist>
+            <listitem>
+                Die zu pausierende Zeit wird als Sekunde in Form einer Zahl als
+                Parameter angegeben.
+            </listitem>
+        </itemizedlist>
+    </para>
+</refsection>
+
+<refsection>
+    <title>Siehe auch</title>
+    <para><olink targetdoc="date" targetptr="">date</olink></para>
+</refsection>
+
+</refentry>
diff --git a/source.xml b/source.xml
new file mode 100644
index 0000000..8b62409
--- /dev/null
+++ b/source.xml
@@ -0,0 +1,35 @@
+<refentry id="source" lang="de">
+
+<refnamediv>
+    <refname>source</refname>
+    <refpurpose>
+        Fürt ein Script aus
+    </refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+    <cmdsynopsis>
+        <command>source</command>
+        <arg choice="req"><replaceable>Auszuführendes Script</replaceable></arg>
+    </cmdsynopsis>
+</refsynopsisdiv>
+
+<refsection>
+    <title>Beschreibung</title>
+    <para>
+        Per source führt man ein Script aus.
+        <itemizedlist>
+            <listitem>
+                Das Script muss als Parameter übergeben werden. Befindet es sich nicht
+                im aktuellen Verzeichnis, so muss man den Pfad zum SCript mit angeben.
+            </listitem>
+        </itemizedlist>
+    </para>
+</refsection>
+
+<refsection>
+    <title>Siehe auch</title>
+    <para><olink targetdoc="start" targetptr="">start</olink></para>
+</refsection>
+
+</refentry>
diff --git a/start.xml b/start.xml
new file mode 100644
index 0000000..036f14b
--- /dev/null
+++ b/start.xml
@@ -0,0 +1,37 @@
+<refentry id="start" lang="de">
+
+<refnamediv>
+    <refname>start</refname>
+    <refpurpose>
+        Startet ein Programm im Hintergrund
+    </refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+    <cmdsynopsis>
+        <command>start</command>
+        <arg choice="req"><replaceable>Pfad zum Programm</replaceable></arg>
+    </cmdsynopsis>
+</refsynopsisdiv>
+
+<refsection>
+    <title>Beschreibung</title>
+    <para>
+        Per start wird ein Programm im Hintergrund gestartet, die Shell kann 
+        weiterbenutzt werden.
+        <itemizedlist>
+            <listitem>
+                Das Programm wird als Parameter übergeben. Sofern es sich nicht
+                im aktuellen Verzeichnis befindet, muss noch der Pfad vorangestellt
+                werden.
+            </listitem>
+        </itemizedlist>
+    </para>
+</refsection>
+
+<refsection>
+    <title>Siehe auch</title>
+    <para><olink targetdoc="source" targetptr="">source</olink></para>
+</refsection>
+
+</refentry>
diff --git a/stat.xml b/stat.xml
new file mode 100644
index 0000000..7cc74e9
--- /dev/null
+++ b/stat.xml
@@ -0,0 +1,37 @@
+<refentry id="stat" lang="de">
+
+<refnamediv>
+    <refname>stat</refname>
+    <refpurpose>
+        Informationen zu einer Datei ermitteln
+    </refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+    <cmdsynopsis>
+        <command>stat</command>
+        <arg choice="req"><replaceable>Datei</replaceable></arg>
+    </cmdsynopsis>
+</refsynopsisdiv>
+
+<refsection>
+    <title>Beschreibung</title>
+    <para>
+        Per stat kann man sich Informationen zu einer Datei auf dem Bildschirm
+        ausgeben lassen.
+        <itemizedlist>
+            <listitem>
+                Die Datei wird als Parameter angegeben. Nun werden Informationen zum
+                Dateinamen, der Groesse und des Typs angegeben.
+            </listitem>
+        </itemizedlist>
+    </para>
+</refsection>
+
+<refsection>
+    <title>Siehe auch</title>
+    <para><olink targetdoc="pwd" targetptr="">pwd</olink></para>
+    <para><olink targetdoc="cd" targetptr="">cd</olink></para>
+</refsection>
+
+</refentry>
-- 
1.6.0.4