0 | 0 |
.TH "DEBMANY" "1" "1.3" "Michael Arlt" "User Commands"
|
1 | 1 |
.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.
|
3 | 3 |
.SH "SYNOPSIS"
|
4 | 4 |
.B debmany
|
5 | 5 |
\fI\-\-help
|
|
12 | 12 |
.SH "DESCRIPTION"
|
13 | 13 |
.\" Add any additional description here
|
14 | 14 |
.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.
|
16 | 16 |
.TP
|
17 | 17 |
\fB\-\-help\fR
|
18 | |
display a small help and exit
|
|
18 |
display a short usage guide and exit
|
19 | 19 |
.TP
|
20 | 20 |
\fB\-k\fR
|
21 | 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).
|
|
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.
|
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)
|
32 | 32 |
.TP
|
33 | 33 |
\fB\-o otherviewer\fR
|
34 | 34 |
Optionally set a viewer for other files (/use/share/doc).
|
35 | 35 |
.TP
|
36 | 36 |
\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.
|
38 | 38 |
.TP
|
39 | 39 |
\fB\-l lang1[,...]\fR
|
40 | 40 |
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.
|
42 | 42 |
.TP
|
43 | 43 |
\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.
|
45 | 45 |
.PP
|
46 | 46 |
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.
|
47 | 47 |
.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.
|
49 | 49 |
.SH "EXAMPLES"
|
50 | 50 |
.TP
|
51 | 51 |
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.
|
53 | 53 |
.TP
|
54 | 54 |
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.
|
56 | 56 |
.TP
|
57 | 57 |
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.
|
59 | 59 |
.TP
|
60 | 60 |
debmany \-k sc
|
61 | |
Use your preferred man\-viewer (for KDE user).
|
|
61 |
Use your preferred man\-viewer (for KDE users).
|
62 | 62 |
.TP
|
63 | 63 |
debmany \-g sc
|
64 | |
Use your preferred man\-viewer (for GNOME user).
|
|
64 |
Use your preferred man\-viewer (for GNOME users).
|
65 | 65 |
.TP
|
66 | 66 |
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).
|
68 | 68 |
.TP
|
69 | 69 |
debmany \-z \-k
|
70 | 70 |
Uses "zenity" to select files and to enter the package name.
|
|
73 | 73 |
Use ~/tmp as temporary folder and Konqueror as viewer.
|
74 | 74 |
.TP
|
75 | 75 |
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.
|
77 | 77 |
.TP
|
78 | 78 |
vi /usr/local/bin/ask # after saving: chmod 755 ask
|
79 | 79 |
#!/bin/dash
|