Package list debian-goodies / 7d2b85f
Imported Debian version 0.32 Javier Fernandez-Sanguino 9 years ago
6 changed file(s) with 36 addition(s) and 15 deletion(s). Raw diff Collapse all Expand all
.checkrestart.swp less more
Binary diff not shown
0 debian-goodies (0.32) unstable; urgency=low
1
2 * Put debmany in the proper location (/usr/bin)
3 * Remove vi swap file from sources
4 * Small changes to debmany binary (typo, versiondate and a comment)
5 * Update debmany's manpages, I was putting in a previous version.
6
7 -- Javier Fernandez-Sanguino Pen~a <jfs@debian.org> Tue, 28 Aug 2007 23:35:26 +0200
8
09 debian-goodies (0.31) unstable; urgency=low
110
211 * Introduce the debmany script written by Michael Arlt (it was actually in
4343 ln -s dgrep $(CURDIR)/debian/debian-goodies/usr/bin/$$grepname; \
4444 done
4545 install -m 755 debmany/debmany \
46 $(CURDIR)/debian/debian-goodies/usr/sbin
46 $(CURDIR)/debian/debian-goodies/usr/bin
4747
4848 # Build architecture-dependent files here.
4949 # We have nothing to do by default.
22 # author: Michael Arlt
33 # description: select the manpages of any [not] installed debian package
44 # comment: debmany is based on the work of debman and debget
5 # uses: whiptail (preferred) or dialog
5 # uses: whiptail (preferred) or dialog as well as curl
66 # This is free software. You may redistribute copies of it under the terms of
77 # the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
88 # There is NO WARRANTY, to the extent permitted by law.
2323
2424 usage()
2525 {
26 echo "debmany 1.2 Sat Aug 25 22:38:17 CEST 2007
26 echo "debmany 1.2 Mon Aug 27 19:06:55 CEST 2007
2727 Description: Display a manpage from a Debian package.
2828 The list of manpages is displayed in a dialog.
2929 Supported locations for debian packages are: Local .deb-file,
30 a package in the repository or a installed package.
30 a package in the repository or an installed package.
3131 Syntax1 : debmany [-?|-h|--help]
3232 Syntax2 : debmany [-m viewer|-k|-g|-x] [-L limit] [-l lang1[,...]] package[.deb]
3333 Examples: debmany foo.deb show manpages from a local package file foo.deb
4242 show english, german and french manpages using
4343 konqueror as man-viewer and ask if download size
4444 exceeds 5M
45 alias debmany='debmany -l de -L 5M -k'; debmany -m man -l "*" foo
45 alias debmany='debmany -l de -L 5M -k'; debmany -m man -l '*' foo
4646 set an alias with your preferred options and
4747 overwrite them if needed"
4848 if [ $# -eq 0 ]
0 .TH "DEBMANY" "1" "1.1" "Michael Arlt" "User Commands"
0 .TH "DEBMANY" "1" "1.2" "Michael Arlt" "User Commands"
11 .SH "NAME"
22 debmany \- select manpages from installed packages, packages from the repository or .deb\-files for viewing using "man" or an alternative viewer.
33 .SH "SYNOPSIS"
55 \fI\-\-help
66 .br
77 .B debmany
8 \fI[\-m manpageviewer|\-k|\-g|\-x] package|package.deb\fR
8 \fI[\-m manpageviewer|\-k|\-g|\-x] [\-L limit] [\-l lang1[,...]] [package|package.deb\fR
99 .SH "DESCRIPTION"
1010 .\" Add any additional description here
1111 .PP
1515 display a small help and exit
1616 .TP
1717 \fB\-m manpageviewer\fR
18 Optionally set a manpage viewer. The viewer must support .gz files. You can preset the desired manpage viewer with the environment variable DEBMANY_MANPAGE_VIEWER. You must define the complete request. "%s" gets replaced with the path to the manpage. The manpageviewer must be enclosed with "" or '' \- see examples.
18 Optionally set a manpage viewer. The viewer must support .gz files. You must define the complete request. "%s" gets replaced with the path to the manpage. If "%s" is missing " %s" is appended to the manpageviewer. The manpageviewer must be enclosed with "" or '' \- see examples.
1919 If you use a graphical viewer you must ensure that you have access to your desktop (if necessary: sux or ssh with x\-forwarding)
2020 .TP
2121 \fB\-k\fR
2626 .TP
2727 \fB\-x\fR
2828 Display the manpage using your preferred viewer (must support .gz files) if you use KDE/GNOME/Xfce \- this is the short form of \-m 'xdg\-open man:%s'. "xdg\-open" is a part of the package "xdg\-utils".
29 .TP
30 \fB\-L limit\fR
31 If a file which must be downloaded exceeds the limit, you are asked if the download should start. Without unit the value is in bytes. You can append K, M, G or T to the value to change the unit.
32 .TP
33 \fB\-l lang1[,...]\fR
34 English manpages are displayed always. If you want more languages you can specify them here. Provide a comma separated list of the folder names in the manpgage folders (/usr/share/man,/usr/X11R6/man) \- e.g. de,fr or "*" if you want to see all languages. Folders with ".xyz" at the end (e.g. fr.ISO8859\-1) are automatically selected together with your choice (fr in this example).
2935 .PP
3036 The manpages are temporarily extracted to /dev/shm (if the directory exists) or /tmp . You can override the path if you set and export the environment variable TMPDIR.
3137 .PP
5359 debmany \-m 'konqueror man:%s' sc
5460 Use Konqueror as viewer
5561 .TP
56 export DEBMANY_MANPAGE_VIEWER="konqueror man:%s"; debmany sc
57 Use the viewer specified in the environment variable DEBMANY_MANPAGE_VIEWER (konqueror)
62 alias debmany='debmany \-l de \-L 5M \-k'; debmany \-m man \-l "*" foo
63 Set an alias with your preferred options and overwrite them if needed.
5864 .SH "AUTHOR"
5965 Written by Michael Arlt.
6066 .SH "LICENSE"
0 .TH "DEBMANY" "1" "1.1" "Michael Arlt" "Dienstprogramme für Benutzer"
0 .TH "DEBMANY" "1" "1.2" "Michael Arlt" "Dienstprogramme für Benutzer"
11 .SH "NAME"
22 debmany \- Wählen von manpages aus installierten Paketen, Paketen des Repositories oder .deb\-Dateien zum Betrachten mit "man" oder einem alternativen Viewer.
33 .SH "SYNTAX"
55 \fI\-\-help
66 .br
77 .B debmany
8 \fI[\-m manpageviewer|\-k|\-g|\-x] Paket|Paket.deb\fR
8 \fI[\-m manpageviewer|\-k|\-g|\-x] [\-L Limit] [\-l Sprache1[,...]] Paket|Paket.deb\fR
99 .SH "BESCHREIBUNG"
1010 .\" Add any additional description here
1111 .PP
1515 zeigt eine kurze Hilfe und beendet sich
1616 .TP
1717 \fB\-m manpageviewer\fR
18 Setzt optional den Manpageviewer. Der Viewer muss .gz Dateien unterstützen. Durch die Umgebungsvariable DEBMANY_MANPAGE_VIEWER kann der gewünschte Manpageviewer voreingestellt werden. Hierbei ist zu beachten, dass der komplette Aufruf formuliert werden muss. "%s" wird durch den Pfad zur Manpage ersetzt. Der Aufruf muss in "" oder '' gefasst werden \- siehe Beispiele.
18 Setzt optional 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.
1919 Bei der Benutzung eines grafischen Manpageviewers müssen Sie sicherstellen, dass Sie Zugriff auf den Desktop haben (ggf.: sux oder ssh mit x\-forwarding)
2020 .TP
2121 \fB\-k\fR
2626 .TP
2727 \fB\-x\fR
2828 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".
29 .TP
30 \fB\-L Limit\fR
31 Ü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 der T kann die Einheit geändert werden.
32 .TP
33 \fB\-l Sprache1[,...]\fR
34 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,/usr/X11R6/man) an \- z. B. de,fr oder "*" wenn Sie alle Sprachen sehen wollen. Ordner mit ".xyz" am Ende (z. B. fr.ISO8859\-1) werden automatisch durch Ihre Auswahl (fr in diesem Beispiel) selektiert.
2935 .PP
3036 Die Manpages werden temporär nach /dev/shm (sofern dieses Verzeichnis existiert) oder /tmp extrahiert. Durch das Setzen und Exportieren der Umgebungsvariable TMPDIR kann der Speicherort überschrieben werden.
3137 .PP
5359 debmany \-m 'konqueror man:%s' sc
5460 Benutzt Konqueror als Viewer
5561 .TP
56 export DEBMANY_MANPAGE_VIEWER="konqueror man:%s"; debmany sc
57 Benutzt den in der Umgebungsvariable DEBMANY_MANPAGE_VIEWER festgelegten Viewer (konqueror)
62 alias debmany='debmany \-l de \-L 5M \-k'; debmany \-m man \-l "*" foo
63 Setzte einen Alias um die bevorzugten Optionen festzulegen. Diese können, wie man sieht, jederzeit überschrieben werden.
5864 .SH "AUTOR"
5965 Geschrieben von Michael Arlt.
6066 .SH "LIZENZ"