Codebase list debian-goodies / 965d289
Convert debmany script to ASCII and manual page to UTF-8 Suggested-by: isutf8 Paul Wise 7 years ago
2 changed file(s) with 24 addition(s) and 24 deletion(s). Raw diff Collapse all Expand all
371371 debug "Mode1/3: Extract the manpage and doc dirs from '$file'" # comment
372372 dpkg --fsys-tarfile "$file" | tar --wildcards -xf - $mandirs 2>/dev/null
373373 # find all manpage files
374 manpages=`find usr -type f 2>/dev/null|sort|sed -e 's§\([^/]*\)$§\1 \1§'`
374 manpages=`find usr -type f 2>/dev/null|sort|sed -e 's|\([^/]*\)$|\1 \1|'`
375375 fi
376376
377377 while true
395395 if echo $return | grep -q usr/share/man
396396 then
397397 path=$(dirname `dirname "$return"`)
398 file=`echo "$return"|sed "s§^$path/§§"`
398 file=`echo "$return"|sed "s|^$path/||"`
399399 if [ "${return##/*}" ] # test relative path
400400 then
401401 # it is a temporary extracted archive
0 .TH "DEBMANY" "1" "1.3" "Michael Arlt" "Dienstprogramme für Benutzer"
0 .TH "DEBMANY" "1" "1.3" "Michael Arlt" "Dienstprogramme für Benutzer"
11 .SH "NAME"
2 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.
2 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.
33 .SH "SYNTAX"
44 .B debmany
55 \fI\-\-help
1212 .SH "BESCHREIBUNG"
1313 .\" Add any additional description here
1414 .PP
15 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.
15 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.
1616 .TP
1717 \fB\-\-help\fR
1818 zeigt eine kurze Hilfe und beendet sich
1919 .TP
2020 \fB\-k\fR
21 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).
21 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).
2222 .TP
2323 \fB\-g\fR
24 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).
24 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).
2525 .TP
2626 \fB\-x\fR
27 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).
27 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).
2828 .TP
2929 \fB\-m manpageviewer\fR
30 Ü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.
31 Bei der Benutzung eines grafischen Manpageviewers müssen Sie sicherstellen, dass Sie Zugriff auf den Desktop haben (ggf.: sux oder ssh mit x\-forwarding)
30 Ü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.
31 Bei der Benutzung eines grafischen Manpageviewers müssen Sie sicherstellen, dass Sie Zugriff auf den Desktop haben (ggf.: sux oder ssh mit x\-forwarding)
3232 .TP
3333 \fB\-o otherviewer\fR
34 Überschreibt den Viewer für sonstige Dateien (/usr/share/doc).
34 Überschreibt den Viewer für sonstige Dateien (/usr/share/doc).
3535 .TP
3636 \fB\-L Limit\fR
37 Ü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.
37 Ü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.
3838 .TP
3939 \fB\-l Sprache1[,...]\fR
40 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.
40 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.
4141 Bei der Installation ggf. dynamisch generierte zeichensatzbasierte Abwandlungen stehen nicht zur Auswahl.
4242 .TP
4343 \fB\-z\fR
44 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.
44 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.
4545 .PP
46 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.
46 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.
4747 .PP
4848 Das Debian Paket "whiptail" (bevorzugt) oder "dialog" sowie "curl" muss installiert sein.
4949 .SH "BEISPIELE"
5252 Zeigt alle Manpages des installierten Debian Pakets "coreutils" mit "man" an.
5353 .TP
5454 debmany 3dchess
55 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.
55 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.
5656 .TP
5757 debmany test.deb
5858 Zeigt alle Manpages des lokalen Debian Paketes "./test.deb" mit "man" an.
5959 .TP
6060 debmany \-k sc
61 Benutzt den bevorzugten Manviewer (für KDE Anwender)
61 Benutzt den bevorzugten Manviewer (für KDE Anwender)
6262 .TP
6363 debmany \-g sc
64 Benutzt den bevorzugten Manviewer (für GNOME Anwender)
64 Benutzt den bevorzugten Manviewer (für GNOME Anwender)
6565 .TP
6666 debmany \-x sc
67 Benutzt den bevorzugten Manviewer (für KDE/GNOME/Xfce Anwender)
67 Benutzt den bevorzugten Manviewer (für KDE/GNOME/Xfce Anwender)
6868 .TP
6969 debmany \-z \-k
70 Benutzt "zenity" um Dateien auszuwählen und Paketnamen einzugeben.
70 Benutzt "zenity" um Dateien auszuwählen und Paketnamen einzugeben.
7171 .TP
7272 TMPDIR=~/tmp debmany \-m 'konqueror man:%s' sc
73 Benutzt ~/tmp als temporären Ordner und Konqueror als Viewer
73 Benutzt ~/tmp als temporären Ordner und Konqueror als Viewer
7474 .TP
7575 alias debmany='debmany \-l de \-L 5M \-k'; debmany \-m man \-l "zh*" foo
76 Setzte einen Alias um die bevorzugten Optionen festzulegen. Diese können, wie man sieht, jederzeit überschrieben werden.
76 Setzte einen Alias um die bevorzugten Optionen festzulegen. Diese können, wie man sieht, jederzeit überschrieben werden.
7777 .TP
7878 vi /usr/local/bin/ask # nach dem Speichern: chmod 755 ask
7979 #!/bin/dash
8080 .br
81 read \-p "Programm zum Öffnen: " pgm
81 read \-p "Programm zum Öffnen: " pgm
8282 .br
8383 eval $pgm "$1"
8484 .br
8686 .br
8787 debmany \-o ask
8888 .br
89 Beim Öffnen einer Datei aus usr/share/doc wird man nach dem Programm, mit dem man sie öffnen möchte, gefragt.
89 Beim Öffnen einer Datei aus usr/share/doc wird man nach dem Programm, mit dem man sie öffnen möchte, gefragt.
9090 .SH "AUTOR"
9191 Geschrieben von Michael Arlt.
9292 .SH "LIZENZ"