Onlinehilfen im Linux (Linuxskript 1.7)

Word Processing und der Onlinezugriff auf Dokumentationen spielte bereits in den frühen UNIX-Systemen eine große Rolle.
Plattenkapazitäten und Rechnerleistung erzwangen eine entsprechende Softwareunterstützung durch umfangreiche Formatierungssysteme - Beispiel troff.
In älteren UNIX-Lehrbüchern spielt die Arbeit mit diesen Makrosysteren und der Aufbau der Manuals eine große Rolle.
Für viele Programme, auch die shells, wurden zusätzlich einfache Hilfen über Kommandos bzw. Optionen bereitgestellt - z.B. in der bash das Kommando "help" ( bash_help ).

Anfang der 90ziger Jahre wurde begonnen Hypertext-Datenbanken für die Online-Manuals einzusetzen - ein Beispiel ist der InfoExplorer im AIX.
Eine kurze Einführung in die Nutzung des InfoExplorer finden Sie im Lehrheft UNIX 2.1.

Mit der Verbreitung des HTML-Formates und der verstärkten Nutzung von Web-Browsern werden die Dokumente auf allen Plattformen in diesem Format angeboten.
Siehe dazu auch die Seite zur Historie des Doc_Servers.

Was steht nun konkret auf den Linux-PC's an der HTW-DD zur Verfügung.

Kommando man - etwa:
$ man ls
liefert die Manualseite zum Kommando ls.
Mehre Jahre wurden die man's vollständig in deutscher Sprache bereitgestellt. Leider waren und sind diese Informationen häufig unvollständig. Deshalb werden die Man Pages überwiegend nur noch in englisch bereitgestellt.
Wer unbedingt die deutschen Seiten benötigt kann etwa auf den Seiten von linuxinfor.com nachlesen.)

Die Manuals sind in Kategorien eingeteilt. Hier die Einteilung aus den aktuellen Manual.

1	Ausführbare Programme oder Shellbefehle
2	Systemaufrufe (Kernelfunktionen)
3	Bibliotheksaufrufe (Funktionen in System-Bibliotheken)
4	Spezielle Dateien (gewöhnlich in /dev)
5	Dateiformate und Konventionen, z. B. /etc/passwd
6	Spiele
7	Makropakete und Konventionen, z. B. man(7), groff(7)
8	Systemadministrationsbefehle (in der Regel nur für root)
9	Kernelroutinen [ Nicht Standard ]
n	neu [ veraltet ]
l	lokal [ veraltet ]
p	öffentlich [ veraltet ]
o	alt [ veraltet ]

Falls die POSIX-Manuals installiert sind, gelten hier die Kategorien 0p, 1p und für Perl 3p.
Die Kategorien entsprechen den Verzeichnissen in /usr/share/man.

Der Aufruf erfolgt dann beispielsweise in der Form:
man 1 kill für das kill-Kommando und
man 2 kill für die kill-Funktion.

Das man Protokoll im Konqueror
Der KDE-Browser Konqueror ist sehr gut in die KDE-Umgebung eingebettet und liefert an vielen System internen Schnittstellen einen umfangreicheren Service gegenüber Firefox.
So nutzt für die verschiedenen Onlinehilfen spezielle "URL-Protokolle". Für die Manuals etwa einfach man:/ls oder kurz man:ls
Gibt es mehrere Kategorien/Sprachen bekommt man zuerst eine Auswahlliste.

Die Seiten werden dann gut aufbereitet angeboten und zusätzlich erhält man noch ein Auswahlmenü bei der Eingabe des gesuchten Manuals in der URL-Zeile.
Mit den Kommandos
whatis und apropos
kann man die Kurzbeschreibungen der Manualseiten nach Schlüsselworten durchsuchen.
Über die GNU-Option --help wird für die Kommandos eine kurze Information angeboten. Etwa
$ ls --help,
leider gibt es hier manchmal Probleme mit der Syntax, z.B. für zip
$ zip -help, oder einfach $ zip ohne Parameter.
Das Bash-Kommando help zum Anzeigen einer Kurzbeschreibung der integrierten (built-in) Kommandos der Bash. Etwa
$ help cd
für eine Kurbeschreibung des Kommandos cd.
SuSE KDE-Hilfesystem lokal
Mit dem Symbol
in der KDE-Kontrollleiste oder dem K-Menü.

Das GNU-Infosystem im ASCII-Mode:
Dies geht natürlich auch auf der Kommandozeile mit info.
Die Anzeige eines Themas kann dann so aussehen
$ info bash Introduction What is Bash?
Einige Hinweise zur Bedienung:

Aufruf                 info {Thema}
Ende                   q (Quit)
Rollen vorwärts        Leertaste
Rollen rückwärts       Delete
Nächste Seite          n
Vorherige Seite        p
Eine Ebene zurück      u
Zuletzt gelesene Seite l (z.B. Zur Rückkehr aus der Hilfeseite)
Nächster Link          Tabulator
(Sub)Menü anspringen   m    (Der Titel kann eindeutig abgekürzt werden
                                  z.B. ema statt emacs)
Text Suchen            Ctrl-S

GNU-Infosystem über das KDE-Befehlsfenster
Auruf über das Symbol im K-Menü oder mit Alt+F2 das KDE-Befehlsfenster aufrufen.

Nach Einstellung: "Im Terminal ausführen", info eingeben. Hier eine alte Darstellung.

Bringt aber keine Verbesserung, da letztlich "info" auch im Kommandomodus.
Das info Protokoll im Konqueror
Der Konqueror bietet über das "info-Protokoll" eine HTML-Aufbereitung des Infosystems. Damit ist das GNU-Infosystem wesentlich nutzerfreundlicher. Allerdings gehen damit auch einige fexiblen Such -und Navigationsmöglichkeiten der Kommandoebene verloren.
Einfach mit info als URL kommt man in das Top-Verzeichnis. Hier kann man z.B. recht gut in der Bash-Referenz lesen.

Wir wollen die Arbeitsweise kurz am Beispiel ls betrachten.
Die erste Textseite gibt meist nur einen allgemeine Überblick über das jeweilige Kommando.

Die Links zu den Inhalten findet man dann unter Menu. Hier nur ein Auszug für ls.

Wir wählen hier "Sorting des output" und erhalten umfangreiche Informationen über die entsprechenden Optionen. Hier natürlich nur ein kleiner Auszug.

Insgesamt lässt sich mit diesem Dienst des Konqueror das GNU-Infosystem recht bequem nutzen.
rman
Auf allen LINUX-PC's in den Laboren z146a und z136c läuft lokal auf Port 6711 ein Dienst als Doc_Server. Über das Programm rman wird dieser Dienst genutzt und die Manuals in HTML-Format bereitgestellt. In diesem Lehr-Skript wird dieser Dienst genutzt. Etwa http://localhost:6711/man?p=ls für ls.
sman.informatik.htw-dresden.de
Dokumentationsserver für SuSE-Linux

Hinweis: Aktuell läuft der Server mit Suse 10.0. Damit liegen jetzt unter den "Original-Links" im SuSE Help Center die Dokumente zur 10.0. In einigen Fällen (direkte Links in /usr/share/doc) kann es zu Fehlern kommen, die schrittweise behoben werden.
Vielen Dank für jeden Hinweis.
- mit rman wie lokal - etwa http://sman.informatik.htw-dresden.de:6711/man?p=ls für ls
- über das SuSE Help Center, noch ohne Manuals
- und zusätzlich, Dokumente in einem Manual- und Packageverzeichnis, etwa:
  - SUSE LINUX - Benutzerhandbuch 9.1., 9.2. (pdf), 9.3.
  - SUSE LINUX - Administrationshandbuch 9.1., 9.2., 9.3.
  - SUSE LINUX - Administration Guide aktuell,
  - SUSE LINUX -Dokumentation 10.0,
  - openSUSE Documentation, 10.2: reference.pdf-de.
  - openSUSE Documentation, 10.3: en, de, reference.pdf-de.
  - penSUSE Documentation, 11.0: de
Lokale Dokumente
Falls installiert stehen diese Dokumente auch lokal zur Verfügung, allerdinks sind die konkreten Links versionsabhängig.
im Manual- und Packageverzeichnis
- SUSE LINUX - Benutzerhandbuch
- SUSE LINUX - Administrationshandbuch
Doc-Server für AIX
AIX Dokumentation-Server der Firma IBM, AIX 5.1.
der zentrale Doc-Server der HTW-DD für AIX ist nicht mehr nutzbar.
Auswahllisten
Zur Verbesserung der Arbeit mit den 3 Quellen lokal, sman und doc
wurden zusätzlich Auswahllisten zusammengestellt.
- Für Linux/Unix Kommandos eine "Kommandoliste",
- für die Arbeit mit der Bash eine "Bash Reference List",
- und für die Arbeit in Systemprogrammierung eine "Funktionsliste"
Stichwortsuche
Zusätzlich wird für alle Lehrunterlagen eine Stichwortsuche angeboten.
Dafür werden genutzt:
- Google - über die freien Lehrunterlagen
- ht:/Dig - gezielt (verzeichnisorientiert) über alle Lehrunterlagen
- Stichwortverzeichnis - in einzelnen Skripten (z.B. im Linuxskript)
- Glossar
und die weltweite Hilfe im Internet
Beispiele für Suchmaschinen auf der Internetseite.

^
<- | ->

L. Koch; 17.11.2008