NAME

       debmany  - Wählen von Manpages oder Dokumentationen aus installierten Paketen, Paketen des
       Repositories oder .deb-Dateien zum Betrachten mit "man" bzw. "sensible-pager"  oder  einem
       alternativen Viewer.

SYNTAX

       debmany --help
       debmany   [-v[v]]   [-k|-g|-x]   [-m   manpageviewer]  [-o  otherviewer]  [-L  Limit]  [-l
       Sprache1[,...]] Paket|Paket.deb
       debmany  [-v[v]]  [-k|-g|-x]  [-m  manpageviewer]  [-o   otherviewer]   [-L   Limit]   [-l
       Sprache1[,...]] -z [Paket|Paket.deb]

BESCHREIBUNG

       Wählen  Sie  eine Manpage oder Dateien aus usr/share/doc von einem Debian Paket um sie mit
       "man" oder "sensible-pager" bzw. einem alternativen Viewer zu betrachten.  Die  Liste  der
       Dateien  wird  in  einem  Dialog dargestellt. Unterstützte Quellen für Debian Pakete sind:
       Lokale .deb-Datei, ein Paket aus dem Repository oder ein installiertes Paket.

       --help zeigt eine kurze Hilfe und beendet sich

       -k     Zeigt die Manpage im bevorzugten Viewer (muss .gz Dateien unterstützen)  an,  falls
              Sie KDE benutzen - Kurzform von -m 'kfmclient exec man:%s' bzw. 'kfmclient exec %s'
              für andere Dateien. "kfmclient" ist Teil  des  Paketes  "konqueror"  (zumindest  in
              Debian Etch).

       -g     Zeigt  die  Manpage im bevorzugten Viewer (muss .gz Dateien unterstützen) an, falls
              Sie GNOME benutzen - Kurzform von -m 'gnome-open man:%s'. "gnome-open" ist Teil des
              Paketes "libgnome2-0" (zumindest in Debian Etch).

       -x     Zeigt  die  Manpage im bevorzugten Viewer (muss .gz Dateien unterstützen) an, falls
              Sie KDE/GNOME/Xfce benutzen - Kurzform von -m  'xdg-open  man:%s'.  "xdg-open"  ist
              Teil des Paketes "xdg-utils" (zumindest in Debian Etch).

       -m manpageviewer
              Überschreibt den Manpageviewer. Der Viewer muss .gz Dateien unterstützen. Es ist zu
              beachten, dass der komplette Aufruf formuliert werden muss.  "%s"  wird  durch  den
              Pfad  zur  Manpage  ersetzt.  Wenn  "%s"  fehlt  wird  "  %s"  an den Manpageviewer
              angehängt. Der Aufruf muss in "" oder '' gefasst werden - siehe Beispiele. Bei  der
              Benutzung  eines  grafischen  Manpageviewers  müssen  Sie  sicherstellen,  dass Sie
              Zugriff auf den Desktop haben (ggf.: sux oder ssh mit x-forwarding)

       -o otherviewer
              Überschreibt den Viewer für sonstige Dateien (/usr/share/doc).

       -L Limit
              Überschreitet ein File, das per Download heruntergeladen werden muss, das Limit  so
              werden Sie gefragt, ob der Download stattfinden soll. Ohne Angabe einer Einheit ist
              die Angabe in Bytes. Durch Anhängen der Buchstaben K, M, G oder T kann die  Einheit
              geändert werden.

       -l Sprache1[,...]
              Englische  Manpages werden immer angezeigt. Wenn Sie mehr Sprachen sehen wollen, so
              können Sie dies hier festlegen. Im Prinzip geben Sie hier eine mit Komma  getrennte
              Liste  der  Ordner  aus  den Manpage Ordnern (/usr/share/man) an - z. B. de,fr oder
              "zh*" wenn Sie alle chinesischen Manpages (sowohl das einfache "zh_CN" als auch das
              traditionelle  Chinesisch  "zh_TW")  sehen  wollen. Sicherheitshalber kann man auch
              immer "*" am Ende  der  Sprache  anhängen.  Bei  der  Installation  ggf.  dynamisch
              generierte zeichensatzbasierte Abwandlungen stehen nicht zur Auswahl.

       -z     Zur  Auswahl der Dateien und ggf. zur Eingabe des Paketes wird "zenity" (grafischer
              Dialog) verwendet. Hierzu muss man berechtigt sein, X-Programme zu  starten.  Diese
              Option  in  Kombination mit den Parametern -k, -g, -x bzw. -m und -o ermöglicht es,
              debmany ohne Console zu verwenden.

       Die Manpages werden temporär nach /tmp oder /var/tmp  extrahiert.  Durch  das  Setzen  und
       Exportieren  der Umgebungsvariable TMPDIR bzw. das Setzen als temporären Variable kann der
       Speicherort überschrieben werden.

       Das Debian Paket "whiptail" (bevorzugt) oder "dialog" sowie "curl" muss installiert sein.

BEISPIELE

       debmany coreutils
              Zeigt alle Manpages des installierten Debian Pakets "coreutils" mit "man" an.

       debmany 3dchess
              Zeigt alle  Manpages  des  Paketes  "3dchess"  mit  "man"  an.  Da  es  noch  nicht
              installiert ist wird es vom Repository bezogen - wenn nötig auch per Download.

       debmany test.deb
              Zeigt alle Manpages des lokalen Debian Paketes "./test.deb" mit "man" an.

       debmany -k sc
              Benutzt den bevorzugten Manviewer (für KDE Anwender)

       debmany -g sc
              Benutzt den bevorzugten Manviewer (für GNOME Anwender)

       debmany -x sc
              Benutzt den bevorzugten Manviewer (für KDE/GNOME/Xfce Anwender)

       debmany -z -k
              Benutzt "zenity" um Dateien auszuwählen und Paketnamen einzugeben.

       TMPDIR=~/tmp debmany -m 'konqueror man:%s' sc
              Benutzt ~/tmp als temporären Ordner und Konqueror als Viewer

       alias debmany='debmany -l de -L 5M -k'; debmany -m man -l "zh*" foo
              Setzte  einen  Alias um die bevorzugten Optionen festzulegen. Diese können, wie man
              sieht, jederzeit überschrieben werden.

       vi /usr/local/bin/ask # nach dem Speichern: chmod 755 ask
              #!/bin/dash
              read -p "Programm zum Öffnen: " pgm
              eval $pgm "$1"

              debmany -o ask
              Beim Öffnen einer Datei aus usr/share/doc wird man nach dem Programm, mit  dem  man
              sie öffnen möchte, gefragt.

AUTOR

       Geschrieben von Michael Arlt.

LIZENZ

       This  is  free  software.  You  may  redistribute  copies of it under the terms of the GNU
       General Public License <http://www.gnu.org/licenses/gpl.html>. There is  NO  WARRANTY,  to
       the extent permitted by law.