Commit 8f835d36ce0e0fefd15a09663d679401d277b4d2 - debian-goodies

Document and apply clear rules for dependencies in debian-goodies * Hard dependencies of single scripts should go into Recommends. * Optional dependencies of single scripts should go into Suggests. Document these rules in debian/README.source. Document the dependencies of all included scripts in the long package description. Also add some missing package relations: apt, apt-file, man-db, konqueror, libgnome2-bin, procps, www-browser, x-www-browser. Also fix some related documentation: * Fix comment about "kfmexec" in debmany: "kfmclient exec" is meant. * Fix mentioned package names in debmany man pages. Axel Beckert 6 years ago

6 changed file(s) with 73 addition(s) and 26 deletion(s). Raw diff Collapse all Expand all

+15

-0

debian/README.source less more

	0	Dependencies handling in debian-goodies:
	1
	2	* Hard dependencies of scripts should go into Recommends. (Only
	3	potential hard dependencies of _all_ included tools should go into
	4	Depends. Since we have a mixture of Perl, Python and Shell scripts,
	5	this is likely never the case.)
	6
	7	Also included in Recommends should be programs which are used by
	8	default and can only be replaced on request by the user,
	9	e.g. sensible-utils if it is used if $PAGER is not set.
	10
	11	* Optional dependencies of scripts should go into Suggests (unless
	12	they're alternativ dependencies for required default functionality).
	13
	14	-- Axel Beckert <abe@debian.org>, Sun, 19 Nov 2017 04:37:56 +0100

+10

-0

debian/changelog less more

2	2	[ Axel Beckert ]
3	3	* Drop long obsolete alternative dependency on grep-dctrl.
4	4	* Fix doubled program name in synopsis of check-enhancements man page.
	5	* Document and apply clear rules for dependencies in debian-goodies:
	6	+ Hard dependencies of single scripts should go into Recommends.
	7	+ Optional dependencies of single scripts should go into Suggests.
	8	+ Document rules in debian/README.source.
	9	+ Document the dependencies of all included scripts in the long
	10	package description.
	11	+ Also add some missing package relations: apt, apt-file, man-db,
	12	konqueror, libgnome2-bin, procps, www-browser, x-www-browser.
	13	+ Fix comment about kfmexec in debmany: "kfmclient exec" is meant.
	14	+ Fix mentioned package names in debmany man pages.
5	15
6	16	[ Stefan Fritsch ]
7	17	* New tool find-dbgsym-packages. (Closes: #871620)

+41

-19

debian/control less more

11	11
12	12	Package: debian-goodies
13	13	Architecture: all
14		Depends: curl,
15		dctrl-tools,
16		perl,
17		python3,
18		whiptail \| dialog,
19		${misc:Depends}
20		Recommends: lsof,
21		sensible-utils
22		Suggests: elfutils,
23		libipc-system-simple-perl,
	14	Depends: ${misc:Depends}
	15	Recommends: apt,
	16	curl,
	17	dctrl-tools,
	18	elfutils,
	19	libipc-system-simple-perl,
	20	man-db,
	21	perl,
	22	popularity-contest,
	23	procps,
	24	python3,
	25	sensible-utils,
	26	whiptail \| dialog \| zenity
	27	Suggests: apt-file,
	28	konqueror,
	29	libgnome2-bin,
24	30	lsb-release,
25		popularity-contest,
26		xdg-utils,
27		zenity
	31	lsof,
	32	x-www-browser \| www-browser,
	33	xdg-utils
28	34	Conflicts: bikeshed,
29	35	debget
30	36	Replaces: bikeshed,

34	40	extending them to operate on the Debian packaging system.
35	41	.
36	42	dglob - Generate a list of package names which match a pattern
	43	[dctrl-tools, apt-file*]
37	44	dgrep - Search all files in specified packages for a regex
	45	[dctrl-tools, apt-file (both via dglob)]
38	46	.
39	47	These are also included, because they are useful and don't justify
40	48	their own packages:
41	49	.
42		check-enhancements - find packages which enhance installed packages
	50	check-enhancements - find packages which enhance installed packages [apt,
	51	dctrl-tools]
43	52	checkrestart - Help to find and restart processes which are using old
44	53	versions of upgraded files (such as libraries)
45		debget - Fetch a .deb for a package in APT's database
	54	[python3, procps, lsof*]
	55	debget - Fetch a .deb for a package in APT's database [apt]
46	56	debman - Easily view man pages from a binary .deb without
47		extracting
	57	extracting [man, apt* (via debget)]
48	58	debmany - Select manpages of installed or uninstalled packages
49		dhomepage - Open homepage of a package in a web browser
	59	[man \| sensible-utils, whiptail \| dialog \| zenity, apt*,
	60	konqueror, libgnome2-bin, xdg-utils*]
	61	dhomepage - Open homepage of a package in a web browser [dctrl-tools,
	62	sensible-utils, www-browser \| x-www-browser*]
50	63	dman - Fetch manpages from online manpages.debian.org service
	64	[curl, man, lsb-release*]
51	65	dpigs - Show which installed packages occupy the most space
	66	[dctrl-tools]
52	67	find-dbgsym-packages
53	68	- gets list of dbgsym packages from core dump or PID
	69	[dctrl-tools, elfutils, libipc-system-simple-perl]
54	70	popbugs - Display a customized release-critical bug list based
55	71	on packages you use (using popularity-contest data)
56		which-pkg-broke - find which package might have broken another
	72	[python3, popularity-contest]
	73	which-pkg-broke - find which package might have broken another [python3,
	74	apt]
57	75	which-pkg-broke-build
58	76	- find which package might have broken the build of
59		another
	77	another [python3 (via which-pkg-broke), apt]
	78	.
	79	Package name in brackets denote (non-essential) dependencies of the
	80	scripts. Packages names with an asterisk ("*") denote optional
	81	dependencies, all other are hard dependencies.

-1

debmany/debmany less more

4	4	# comment: debmany is based on the work of debman and debget
5	5	# gui uses: whiptail (preferred), dialog or zenity as well
6	6	# other uses: curl, $PAGER or sensible-pager (can be overwritten: -o)
7		# optional: -k -g -x: kfmexec gnome-open xdg-open (xdg-utils)
	7	# optional: -k -g -x: kfmclient exec (konqueror), gnome-open (libgnome2-bin), xdg-open (xdg-utils)
8	8	# This is free software. You may redistribute copies of it under the terms of
9	9	# the GNU General Public License <https://www.gnu.org/licenses/gpl.html>.
10	10	# There is NO WARRANTY, to the extent permitted by law.

-3

debmany/man/debmany.1 less more

18	18	display a short usage guide and exit
19	19	.TP
20	20	\fB\-k\fR
21		Display the manpage using your preferred viewer (must support .gz files) if you use KDE \- this is the short form of \-m 'kfmclient exec man:%s'. "kfmclient" is a part of the package "konqueror" (at least in Debian Etch).
	21	Display the manpage using your preferred viewer (must support .gz files) if you use KDE \- this is the short form of \-m 'kfmclient exec man:%s'. "kfmclient" is a part of the package "konqueror" (at least in Debian Buster).
22	22	.TP
23	23	\fB\-g\fR
24		Display the manpage using your preferred viewer (must support .gz files) if you use GNOME \- this is the short form of \-m 'gnome\-open man:%s'. "gnome\-open" is a part of the package "libgnome2\-0" (at least in Debian Etch).
	24	Display the manpage using your preferred viewer (must support .gz files) if you use GNOME \- this is the short form of \-m 'gnome\-open man:%s'. "gnome\-open" is a part of the package "libgnome2\-bin" (at least in Debian Buster).
25	25	.TP
26	26	\fB\-x\fR
27		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" (at least in Debian Etch).
	27	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" (at least in Debian Buster).
28	28	.TP
29	29	\fB\-m manpageviewer\fR
30	30	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.

-3

debmany/man/debmany.de.1 less more

18	18	zeigt eine kurze Hilfe und beendet sich
19	19	.TP
20	20	\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 Buster).
22	22	.TP
23	23	\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\-bin" (zumindest in Debian Buster).
25	25	.TP
26	26	\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 Buster).
28	28	.TP
29	29	\fB\-m manpageviewer\fR
30	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.