Codebase list debian-goodies / 772f7ac
Fix many typos in man pages (see #610563, thanks Justin B Rye!) Axel Beckert 11 years ago
4 changed file(s) with 22 addition(s) and 21 deletion(s). Raw diff Collapse all Expand all
1414 * [debmany]
1515 - Replace less by sensible-pager, remove dependency on less. (Closes:
1616 #610563)
17 - Fix many typos in man pages (see #610563, thanks Justin B Rye!)
1718 * [bash_completion]
1819 - Install debmany bash completion file to /etc/bash_completion.d
1920 instead of as example. Rename it for easier use of dh_install.
5353 Supported locations for debian packages are: Local .deb-file,
5454 a package in the repository or an installed package.
5555 The default for manpages is man - sensible-pager is used for other files.
56 Default can be overwritten with -k|-g|-x and -m -o.
56 Default can be overridden with -k|-g|-x and -m -o.
5757 Syntax1 : debmany [-?|-h|--help]
5858 Syntax2 : debmany [-v[v]] [-k|-g|-x] [-m manviewer] [-o otherviewer] [-L limit] [-l lang1[,...]] package[.deb]
5959 Syntax3 : debmany [-v[v]] [-k|-g|-x] [-m manviewer] [-o otherviewer] [-L limit] [-l lang1[,...]] -z [package[.deb]]
6969 man: xdg-open man:%s other: xdg-open %s
7070 using xdg-open from xdg-utils package (Xfce users)
7171 debmany -m 'konqueror man:%s' -l 'de*,fr*' -L 5M foo
72 show english, german and french manpages using
72 show English, German and French manpages using
7373 konqueror as man-viewer and ask if download size
7474 exceeds 5M
7575 debmany -z -k use zenity (as dialog) to select packages and files
7676 TMPDIR=~/tmp debmany -k -o 'foo.sh %s' -l de,fr -L 5M foo
7777 use ~/tmp as temporary folder
78 use KDE-defaults but overwrite viewer for other files
78 use KDE-defaults but override viewer for other files
7979 debmany -v foo show some debugging information (-vv show more)
8080 alias debmany='debmany -l de -L 5M -k'; debmany -m man -l 'zh*' foo
8181 set an alias with your preferred options and
82 overwrite them if needed"
82 override them if needed"
8383 if [ $# -eq 0 ]
8484 then
8585 exit 0
00 .TH "DEBMANY" "1" "1.3" "Michael Arlt" "User Commands"
11 .SH "NAME"
2 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.
2 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.
33 .SH "SYNOPSIS"
44 .B debmany
55 \fI\-\-help
1212 .SH "DESCRIPTION"
1313 .\" Add any additional description here
1414 .PP
15 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.
15 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.
1616 .TP
1717 \fB\-\-help\fR
18 display a small help and exit
18 display a short usage guide and exit
1919 .TP
2020 \fB\-k\fR
2121 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).
2828 .TP
2929 \fB\-m manpageviewer\fR
3030 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.
31 If you use a graphical viewer you must ensure that you have access to your desktop (if necessary: sux or ssh with x\-forwarding)
31 If you use a graphical viewer you must ensure that you have access to your desktop (if necessary: sux or ssh with X\-forwarding)
3232 .TP
3333 \fB\-o otherviewer\fR
3434 Optionally set a viewer for other files (/use/share/doc).
3535 .TP
3636 \fB\-L limit\fR
37 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.
37 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.
3838 .TP
3939 \fB\-l lang1[,...]\fR
4040 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 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.
41 During installation automatic generated character set based versions are not available for selection.
41 Character set versions automatically generated during installation are not available for selection.
4242 .TP
4343 \fB\-z\fR
44 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.
44 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.
4545 .PP
4646 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.
4747 .PP
48 You need to have the debian package "whiptail" (preferred) or "dialog" as well as "curl" installed.
48 You need to have the Debian package "whiptail" (preferred) or "dialog" as well as "curl" installed.
4949 .SH "EXAMPLES"
5050 .TP
5151 debmany coreutils
52 Show all manpages from the installed debian package "coreutils" using man.
52 Show all manpages from the installed Debian package "coreutils" using man.
5353 .TP
5454 debmany 3dchess
55 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.
55 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.
5656 .TP
5757 debmany test.deb
58 Show all manpages from the local debian package "./test.deb" using man.
58 Show all manpages from the local Debian package "./test.deb" using man.
5959 .TP
6060 debmany \-k sc
61 Use your preferred man\-viewer (for KDE user).
61 Use your preferred man\-viewer (for KDE users).
6262 .TP
6363 debmany \-g sc
64 Use your preferred man\-viewer (for GNOME user).
64 Use your preferred man\-viewer (for GNOME users).
6565 .TP
6666 debmany \-x sc
67 Use your preferred man\-viewer (for KDE/GNOME/Xfce user).
67 Use your preferred man\-viewer (for KDE/GNOME/XFCE users).
6868 .TP
6969 debmany \-z \-k
7070 Uses "zenity" to select files and to enter the package name.
7373 Use ~/tmp as temporary folder and Konqueror as viewer.
7474 .TP
7575 alias debmany='debmany \-l de \-L 5M \-k'; debmany \-m man \-l "zh*" foo
76 Set an alias with your preferred options and overwrite them if needed.
76 Set an alias with your preferred options and override them if needed.
7777 .TP
7878 vi /usr/local/bin/ask # after saving: chmod 755 ask
7979 #!/bin/dash
00 .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. "less" 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 "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.
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