Commit debian/0.32 - debian-goodies

~~.checkrestart.swp~~ less more

Binary diff not shown

+9

-0

debian/changelog less more

	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
0	9	debian-goodies (0.31) unstable; urgency=low
1	10
2	11	* Introduce the debmany script written by Michael Arlt (it was actually in

+1

-1

debian/rules less more

43	43	ln -s dgrep $(CURDIR)/debian/debian-goodies/usr/bin/$$grepname; \
44	44	done
45	45	install -m 755 debmany/debmany \
46		$(CURDIR)/debian/debian-goodies/usr/sbin
	46	$(CURDIR)/debian/debian-goodies/usr/bin
47	47
48	48	# Build architecture-dependent files here.
49	49	# We have nothing to do by default.

+4

-4

debmany/debmany less more

2	2	# author: Michael Arlt
3	3	# description: select the manpages of any [not] installed debian package
4	4	# 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
6	6	# This is free software. You may redistribute copies of it under the terms of
7	7	# the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
8	8	# There is NO WARRANTY, to the extent permitted by law.

23	23
24	24	usage()
25	25	{
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
27	27	Description: Display a manpage from a Debian package.
28	28	The list of manpages is displayed in a dialog.
29	29	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.
31	31	Syntax1 : debmany [-?\|-h\|--help]
32	32	Syntax2 : debmany [-m viewer\|-k\|-g\|-x] [-L limit] [-l lang1[,...]] package[.deb]
33	33	Examples: debmany foo.deb show manpages from a local package file foo.deb

42	42	show english, german and french manpages using
43	43	konqueror as man-viewer and ask if download size
44	44	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
46	46	set an alias with your preferred options and
47	47	overwrite them if needed"
48	48	if [ $# -eq 0 ]

+11

-5

debmany/man/debmany.1 less more

0		.TH "DEBMANY" "1" "1.1" "Michael Arlt" "User Commands"
	0	.TH "DEBMANY" "1" "1.2" "Michael Arlt" "User Commands"
1	1	.SH "NAME"
2	2	debmany \- select manpages from installed packages, packages from the repository or .deb\-files for viewing using "man" or an alternative viewer.
3	3	.SH "SYNOPSIS"

5	5	\fI\-\-help
6	6	.br
7	7	.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
9	9	.SH "DESCRIPTION"
10	10	.\" Add any additional description here
11	11	.PP

15	15	display a small help and exit
16	16	.TP
17	17	\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.
19	19	If you use a graphical viewer you must ensure that you have access to your desktop (if necessary: sux or ssh with x\-forwarding)
20	20	.TP
21	21	\fB\-k\fR

26	26	.TP
27	27	\fB\-x\fR
28	28	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).
29	35	.PP
30	36	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.
31	37	.PP

53	59	debmany \-m 'konqueror man:%s' sc
54	60	Use Konqueror as viewer
55	61	.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.
58	64	.SH "AUTHOR"
59	65	Written by Michael Arlt.
60	66	.SH "LICENSE"

+11

-5

debmany/man/debmany.de.1 less more

0		.TH "DEBMANY" "1" "1.1" "Michael Arlt" "Dienstprogramme für Benutzer"
	0	.TH "DEBMANY" "1" "1.2" "Michael Arlt" "Dienstprogramme für Benutzer"
1	1	.SH "NAME"
2	2	debmany \- Wählen von manpages aus installierten Paketen, Paketen des Repositories oder .deb\-Dateien zum Betrachten mit "man" oder einem alternativen Viewer.
3	3	.SH "SYNTAX"

5	5	\fI\-\-help
6	6	.br
7	7	.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
9	9	.SH "BESCHREIBUNG"
10	10	.\" Add any additional description here
11	11	.PP

15	15	zeigt eine kurze Hilfe und beendet sich
16	16	.TP
17	17	\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.
19	19	Bei der Benutzung eines grafischen Manpageviewers müssen Sie sicherstellen, dass Sie Zugriff auf den Desktop haben (ggf.: sux oder ssh mit x\-forwarding)
20	20	.TP
21	21	\fB\-k\fR

26	26	.TP
27	27	\fB\-x\fR
28	28	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.
29	35	.PP
30	36	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.
31	37	.PP

53	59	debmany \-m 'konqueror man:%s' sc
54	60	Benutzt Konqueror als Viewer
55	61	.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.
58	64	.SH "AUTOR"
59	65	Geschrieben von Michael Arlt.
60	66	.SH "LIZENZ"