DEBMANY(1)

📦 version 0.88.2, in nixos 26.05, nixpkgs unstable

🎀 debmany — die Manpage-Queen, die du verdienst 🎀

okay so, allererstes: die Seite hier heißt DEBMANY(1) und wohnt bei den „Dienstprogrammen für Benutzer". Setz dich hin, mach's dir gemütlich, wir gehen das zusammen durch — kein Stress, sie ist wirklich nett. 💖

🌸 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. Ja, sie macht genau das, was draufsteht, und sie macht es slay. ✨

🦋 SYNTAX 🦋

Diese Seite hat genau zwei Formen, und beide sind wichtig, also einmal komplett:

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

💜 BESCHREIBUNG 💜

Also: du wählst eine Manpage oder Dateien aus usr/share/doc von einem Debian Paket aus, um sie mit man oder sensible-pager bzw. einem alternativen Viewer zu betrachten. Die Liste der Dateien wird in einem Dialog dargestellt — du musst also nichts tippen, du pickst einfach. 🫶

Die unterstützten Quellen für Debian Pakete sind, und das ist wichtig, alle drei:

  • eine lokale .deb-Datei
  • ein Paket aus dem Repository
  • ein installiertes Paket

Und jetzt die Optionen, in der Reihenfolge, in der sie auf der Seite stehen:

  • --help — zeigt eine kurze Hilfe und beendet sich sofort. Kurz, süß, weg. 💅
  • -k — zeigt die Manpage im bevorzugten Viewer an (der Viewer muss .gz-Dateien unterstützen!), falls du KDE benutzt. Ist die Kurzform von -m 'kfmclient exec man:%s' bzw. -m 'kfmclient exec %s' für andere Dateien. Fun Fact am Rande: "kfmclient" ist Teil des Paketes "konqueror" (zumindest in Debian Buster). 👑
  • -x — zeigt die Manpage im bevorzugten Viewer an (auch hier: .gz-Dateien müssen unterstützt werden!), falls du KDE/GNOME/Xfce benutzt. Ist die Kurzform von -m 'xdg-open man:%s'. Und ja: "xdg-open" ist Teil des Paketes "xdg-utils" (zumindest in Debian Buster). ✨
  • -m manpageviewer — überschreibt den Manpageviewer. Der Viewer muss .gz-Dateien unterstützen. Und jetzt gut aufpassen, das ist der Teil, bei dem alle strugglen: du musst den kompletten Aufruf formulieren. "%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 musst du sicherstellen, dass du Zugriff auf den Desktop hast (ggf.: sux oder ssh mit x-forwarding). 😭
  • -o otherviewer — überschreibt den Viewer für sonstige Dateien (/usr/share/doc). Praktisch, wenn dein Manpage-Viewer und dein Doku-Viewer nicht dieselben Vibes haben.
  • -L Limit — wenn ein File, das per Download heruntergeladen werden muss, das Limit überschreitet, dann wirst du gefragt, ob der Download stattfinden soll. Kein Stress also. 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, das ist gesetzt. Wenn du mehr Sprachen sehen willst, legst du das hier fest. Im Prinzip gibst du hier eine mit Komma getrennte Liste der Ordner aus den Manpage-Ordnern (/usr/share/man) an — z. B. de,fr oder "zh*", wenn du alle chinesischen Manpages sehen willst (sowohl das einfache "zh_CN" als auch das traditionelle Chinesisch "zh_TW"). 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 musst du berechtigt sein, X-Programme zu starten. Diese Option in Kombination mit den Parametern -k, -x bzw. -m und -o ermöglicht es, debmany ohne Console zu verwenden. main character energy, honestly. 🌈
Und wo landen die Manpages? Die 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. 🧚
Achtung, Setup-Check: das Debian Paket "whiptail" (bevorzugt) oder "dialog" sowie "apt" muss installiert sein. Ohne die läuft hier gar nichts, das ist kein Vorschlag, das ist ein Muss. ⭐

💖 BEISPIELE 💖

Hier wird's praktisch, und ich bin obsessed, weil die Beispiele echt alles abdecken:

  • debmany coreutils — zeigt alle Manpages des installierten Debian Pakets "coreutils" mit "man" an. Der Klassiker.
  • 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. Sie holt's sich einfach, slay.
  • 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 — setzt einen Alias, um die bevorzugten Optionen festzulegen. Diese können, wie man sieht, jederzeit überschrieben werden. Selbstbestimmte Königin. 💅

Und dann gibt's da noch das selbstgebaute Viewer-Script — erst anlegen:

vi /usr/local/bin/ask — und 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 gefragt, mit dem man sie öffnen möchte. Personalisiert, individuell, ein bisschen frech. 🔥

🌟 AUTOR 🌟

Geschrieben von Michael Arlt. Shoutout, danke fürs Bauen. 🫶

📜 LIZENZ 📜

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

Heißt auf gut Deutsch: ja, du darfst sie kopieren und weitergeben, im Rahmen der GNU General Public License, und nein, es gibt keine Garantie, soweit das Gesetz das erlaubt. Kein cap. ⭐

So, das war's — debmany, Version 1.3, von Michael Arlt, komplett durchgekaut. Du hast das geschafft, bestie. Bis zum nächsten Manpage-Date, bleib süß und lies deine Docs. 💖🎀🦋

📦 where this page comes from