Package: debian-goodies
Version: 0.53
Severity: wishlist
Tags: patch
Also found in 0.55, which is what my patch is against.
debian-goodies Depends: on "less" solely because debmany hardcodes
that particular pager as the handler for non-manpages. Other pagers
such as "most" work equally well for this role, so rather than force
users to name their favourite $PAGER all over again via an -o option
why not take advantage of the fact you're on a Debian system and
invoke the "pager" alternative, or pull in "sensible-utils" instead
of "less" and invoke "sensible-pager"?
Since I needed to tweak the --help output and manpage slightly I've
fixed some trivial non-native-speakerisms in the English version.
(I hope patching a legacy-encoded German manpage won't break it.)
-- System Information:
Debian Release: 6.0
APT prefers testing
APT policy: (500, 'testing')
Architecture: amd64 (x86_64)
Kernel: Linux 2.6.32-5-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Versions of packages debian-goodies depends on:
ii curl 7.21.0-1 Get a file from an HTTP, HTTPS or
ii dctrl-tools [grep-dctrl 2.14.5 Command-line tools to process Debi
ii dialog 1.1-20100428-1 Displays user-friendly dialog boxe
ii less 436-1 pager program similar to more
ii lsof 4.81.dfsg.1-1 List open files
ii perl 5.10.1-17 Larry Wall's Practical Extraction
ii python 2.6.6-3+squeeze5 interactive high-level object-orie
ii whiptail 0.52.11-1 Displays user-friendly dialog boxe
debian-goodies recommends no packages.
Versions of packages debian-goodies suggests:
ii popularity-contest 1.49 Vote for your favourite packages a
ii xdg-utils 1.0.2+cvs20100307-2 desktop integration utilities from
pn zenity <none> (no description available)
-- no debconf information
--
JBR
Ankh kak! (Ancient Egyptian blessing)
diff -ru debian-goodies-0.55.pristine//debian/control debian-goodies-0.55/debian/control
--- debian-goodies-0.55.pristine//debian/control 2010-10-02 19:02:58.000000000 +0100
+++ debian-goodies-0.55/debian/control 2011-01-19 22:11:23.712925616 +0000
@@ -10,7 +10,7 @@
Package: debian-goodies
Architecture: all
-Depends: dctrl-tools | grep-dctrl, perl, curl, python (>= 2.4), whiptail | dialog, less, ${misc:Depends}
+Depends: dctrl-tools | grep-dctrl, perl, curl, python (>= 2.4), whiptail | dialog, sensible-utils, ${misc:Depends}
Recommends: lsof
Suggests: popularity-contest, xdg-utils, zenity
Conflicts: debget
diff -ru debian-goodies-0.55.pristine//debmany/debmany debian-goodies-0.55/debmany/debmany
--- debian-goodies-0.55.pristine//debmany/debmany 2010-05-26 11:34:24.000000000 +0100
+++ debian-goodies-0.55/debmany/debmany 2011-01-19 21:51:51.084925304 +0000
@@ -4,7 +4,7 @@
# description: select manpages+docs of any [not] installed debian package
# comment: debmany is based on the work of debman and debget
# gui uses: whiptail (preferred), dialog or zenity as well
-# other uses: curl, less (can be overwritten: -o)
+# other uses: curl, sensible-pager (can be overridden: -o)
# optional: -k -g -x: kfmexec gnome-open xdg-open (xdg-utils)
# This is free software. You may redistribute copies of it under the terms of
# the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
@@ -25,7 +25,7 @@
# defaults
mancmdline="man %s" # manpageviewer
-othercmdline="less %s" # viewer for other files
+othercmdline="sensible-pager %s" # viewer for other files
curdir=`pwd`
@@ -53,8 +53,8 @@
The list of files is displayed in a dialog.
Supported locations for debian packages are: Local .deb-file,
a package in the repository or an installed package.
- The default for manpages is man - less is used for other files.
- Default can be overwritten with -k|-g|-x and -m -o.
+ The default is man for manpages, sensible-pager for other files.
+ Default can be overridden with -k|-g|-x and -m -o.
Syntax1 : debmany [-?|-h|--help]
Syntax2 : debmany [-v[v]] [-k|-g|-x] [-m manviewer] [-o otherviewer] [-L limit] [-l lang1[,...]] package[.deb]
Syntax3 : debmany [-v[v]] [-k|-g|-x] [-m manviewer] [-o otherviewer] [-L limit] [-l lang1[,...]] -z [package[.deb]]
@@ -70,17 +70,17 @@
man: xdg-open man:%s other: xdg-open %s
using xdg-open from xdg-utils package (Xfce users)
debmany -m 'konqueror man:%s' -l 'de*,fr*' -L 5M foo
- show english, german and french manpages using
+ show English, German and French manpages using
konqueror as man-viewer and ask if download size
exceeds 5M
debmany -z -k use zenity (as dialog) to select packages and files
TMPDIR=~/tmp debmany -k -o 'foo.sh %s' -l de,fr -L 5M foo
use ~/tmp as temporary folder
- use KDE-defaults but overwrite viewer for other files
+ use KDE-defaults but override viewer for other files
debmany -v foo show some debugging information (-vv show more)
alias debmany='debmany -l de -L 5M -k'; debmany -m man -l 'zh*' foo
set an alias with your preferred options and
- overwrite them if needed"
+ override them if needed"
if [ $# -eq 0 ]
then
exit 0
diff -ru debian-goodies-0.55.pristine//debmany/man/debmany.1 debian-goodies-0.55/debmany/man/debmany.1
--- debian-goodies-0.55.pristine//debmany/man/debmany.1 2010-05-26 11:34:24.000000000 +0100
+++ debian-goodies-0.55/debmany/man/debmany.1 2011-01-19 22:13:37.792925343 +0000
@@ -1,6 +1,6 @@
.TH "DEBMANY" "1" "1.3" "Michael Arlt" "User Commands"
.SH "NAME"
-debmany \- select manpages or documentation files from installed packages, packages from the repository or .deb\-files for viewing using "man" resp. "less" or an alternative viewer.
+debmany \- select manpages or documentation files from installed packages, packages from the repository or .deb\-files for viewing using "man", "sensible-pager" or an alternative viewer.
.SH "SYNOPSIS"
.B debmany
\fI\-\-help
@@ -13,10 +13,10 @@
.SH "DESCRIPTION"
.\" Add any additional description here
.PP
-Select a manpage or files at /usr/share/doc from a debian package for viewing with "man", "less" or an alternative viewer. The list of files is displayed in a dialog. Supported locations for debian packages are: Local .deb\-file, a package in the repository or a installed package.
+Select a manpage or files in /usr/share/doc from a Debian package for viewing with "man", "sensible-pager" or an alternative viewer. The list of files is displayed in a dialog. Supported locations for Debian packages are: local .deb\-file, a package in the repository or an installed package.
.TP
\fB\-\-help\fR
-display a small help and exit
+display a short usage guide and exit
.TP
\fB\-k\fR
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).
@@ -29,43 +29,43 @@
.TP
\fB\-m manpageviewer\fR
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.
-If you use a graphical viewer you must ensure that you have access to your desktop (if necessary: sux or ssh with x\-forwarding)
+If you use a graphical viewer you must ensure that you have access to your desktop (if necessary: sux or ssh with X\-forwarding)
.TP
\fB\-o otherviewer\fR
Optionally set a viewer for other files (/use/share/doc).
.TP
\fB\-L limit\fR
-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.
+If a file which must be downloaded exceeds this 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.
.TP
\fB\-l lang1[,...]\fR
-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) \- e.g. de,fr or "zh*" if you want to see all Chinese manpages (Simplified and Traditional Chinese as well). It is safe always to use "*" at the end of your language.
-During installation automatic generated character set based versions are not available for selection.
+English manpages are always displayed. If you want more languages you can specify them here. Provide a comma separated list of the folder names in the manpage folders (/usr/share/man) \- e.g. de,fr or "zh*" if you want to see all Chinese manpages (Simplified and Traditional Chinese as well). It is safe always to use "*" at the end of your language.
+Character set versions automatically generated during installation are not available for selection.
.TP
\fB\-z\fR
-Zenity (a graphical dialog) is used to select the files and if necessary to enter the package name. You must have the rights to start X\-programs. This option combined with the parameters \-k, \-g, \-x respectively \-m and \-o make it possible to use debmany without console.
+Zenity (a graphical dialog) is used to select the files and if necessary to enter the package name. You must have the rights to start X programs. This option combined with the parameters \-k, \-g, \-x or \-m and \-o make it possible to use debmany without console.
.PP
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 or set it as a temporary variable.
.PP
-You need to have the debian package "whiptail" (preferred) or "dialog" as well as "curl" installed.
+You need to have the Debian package "whiptail" (preferred) or "dialog" as well as "curl" installed.
.SH "EXAMPLES"
.TP
debmany coreutils
-Show all manpages from the installed debian package "coreutils" using man.
+Show all manpages from the installed Debian package "coreutils" using man.
.TP
debmany 3dchess
-Show all manpages from the package "3dchess" using man. Since it is not already installed the package is accessed from the repository \- even downloading is done if needed.
+Show all manpages from the package "3dchess" using man. Since it is not already installed the package is accessed from the repository \- even downloading is done if needed.
.TP
debmany test.deb
-Show all manpages from the local debian package "./test.deb" using man.
+Show all manpages from the local Debian package "./test.deb" using man.
.TP
debmany \-k sc
-Use your preferred man\-viewer (for KDE user).
+Use your preferred man\-viewer (for KDE users).
.TP
debmany \-g sc
-Use your preferred man\-viewer (for GNOME user).
+Use your preferred man\-viewer (for GNOME users).
.TP
debmany \-x sc
-Use your preferred man\-viewer (for KDE/GNOME/Xfce user).
+Use your preferred man\-viewer (for KDE/GNOME/Xfce users).
.TP
debmany \-z \-k
Uses "zenity" to select files and to enter the package name.
@@ -74,7 +74,7 @@
Use ~/tmp as temporary folder and Konqueror as viewer.
.TP
alias debmany='debmany \-l de \-L 5M \-k'; debmany \-m man \-l "zh*" foo
-Set an alias with your preferred options and overwrite them if needed.
+Set an alias with your preferred options and override them if needed.
.TP
vi /usr/local/bin/ask # after saving: chmod 755 ask
#!/bin/dash
diff -ru debian-goodies-0.55.pristine//debmany/man/debmany.de.1 debian-goodies-0.55/debmany/man/debmany.de.1
--- debian-goodies-0.55.pristine//debmany/man/debmany.de.1 2010-05-26 11:34:24.000000000 +0100
+++ debian-goodies-0.55/debmany/man/debmany.de.1 2011-01-19 22:12:18.977259348 +0000
@@ -1,6 +1,6 @@
.TH "DEBMANY" "1" "1.3" "Michael Arlt" "Dienstprogramme f�r Benutzer"
.SH "NAME"
-debmany \- W�hlen von Manpages oder Dokumentationen aus installierten Paketen, Paketen des Repositories oder .deb\-Dateien zum Betrachten mit "man" bzw. "less" oder einem alternativen Viewer.
+debmany \- W�hlen von Manpages oder Dokumentationen aus installierten Paketen, Paketen des Repositories oder .deb\-Dateien zum Betrachten mit "man" bzw. "sensible-utils" oder einem alternativen Viewer.
.SH "SYNTAX"
.B debmany
\fI\-\-help
@@ -13,7 +13,7 @@
.SH "BESCHREIBUNG"
.\" Add any additional description here
.PP
-W�hlen Sie eine Manpage oder Dateien aus usr/share/doc von einem Debian Paket um sie mit "man" oder "less" 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.
+W�hlen Sie eine Manpage oder Dateien aus usr/share/doc von einem Debian Paket um sie mit "man" oder "sensible-utils" 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.
.TP
\fB\-\-help\fR
zeigt eine kurze Hilfe und beendet sich
