9

How can I get information about a package before installing it, from the terminal?

I mean something like man pages, but accessible even before the package is installed.

10

not as extensive as manpages but I think this is what you are looking for:

apt-cache show <packagename>

you can also search for related packages:

apt-cache search <searchtag>
| improve this answer | |
11

dman Retrieves Manual Pages

In practice, viewing a package's brief description (as mchid suggests) is usually what you'll want to see, to decide if you want the package. However, if you like you can view a manpage provided by a package that has not yet been installed, using the dman utility.

dman is provided by the bikeshed Install bikeshed package. You can install that in the Software Center, or with sudo apt-get install bikeshed.

Then use dman like man.

dman is a script that retrieves manual pages over the Internet and displays them, so you have to be connected to the Internet to use it successfully. (But you probably are, because in your specific scenario you're about to install a package.) It also often runs slowly, so be prepared to wait several seconds.

If dman's database doesn't have your release, you can specify another.

Due to a bug dman doesn't work right on some releases of Ubuntu. For now you can get around the problem by viewing another release's version of the manpage you want (this workaround was suggested by Marius Gedminas in a comment on the bug report). You use the adjective part of the codename, in all lower case (e.g., precise from 12.04 Precise Pangolin, trusty from 14.04 Trusty Thar). For example:

ek@Io:~$ dman sl       # doesn't work on Vivid, produces no output
ek@Io:~$ dman --release trusty sl

SL(6)                            Games Manual                            SL(6)

NAME
       sl  -  display animations aimed to correct users who accidentally enter
       sl instead of ls.

SYNOPSIS
       sl [ -alFe ]

DESCRIPTION
       sl Displays animations....

Alternative: Browse Manual Pages with a (Text-Based) Web Browser

Of course, you can also simply browse the manpages on the web. If you want to do this from the command-line, you can use a text-based web browser.

If you like, you could even define a function in .bashrc so you have a command that opens up a text-based web browser and searches for the term passed as its argument:

wman() { links2 "http://manpages.ubuntu.com/cgi-bin/search.py?q=$1"; }

For that particular function definition to work, the links2 Install links2 package must be installed. It will cause the wman function to be defined automatically in each newly created interactive shell, but not in shells that were started before .bashrc was edited (you could simply run the function definition in those shells, though).

Then I can search for manual pages, and select between pages in different sections of the manual, for whichever Ubuntu release's version of the manual I like:

ek@Io:~$ wman chmod

                                            Ubuntu Manpage: Searching (p1 of 2) 
                                 Ubuntu manuals                                 
                                                                                
   _____________________ go                                                     
                                                                                
   +------------------------------------------------------------------------+   
   |  lucid      precise    trusty     utopic     Section Description       |   
   |  10.04 LTS  12.04 LTS  14.04 LTS  14.10                                |   
   |  chmod(1),  chmod(1),  chmod(1),  chmod(1),  (1) - Executable          |   
   |  chmod(1)   chmod(1)   chmod(1)   chmod(1)   programs or shell         |   
   |                                              commands                  |   
   |  chmod(2),  chmod(2),  chmod(2),  chmod(2),  (2) - System calls        |   
   |  chmod(2)   chmod(2)   chmod(2)   chmod(2)   (functions provided by    |   
   |                                              the kernel)               |   
   |                                              (3) - Library calls       |   
   |  chmod(3)   chmod(3)   chmod(3)   chmod(3)   (functions within         |   
   |                                              program libraries)        |   
   |      .          .          .          .      (4) - Special files       |   
   |                                              (usually found in /dev)   |   
   |                                              (5) - File formats and    |   
   |      .          .          .          .      conventions eg            |   
   |                                              /etc/passwd               |   
   |      .          .          .          .      (6) - Games               |   
   |                                              (7) - Miscellaneous       |   
   |      .          .          .          .      (including macro          |   
   |                                              packages and              |   
http://manpages.ubuntu.com/
| improve this answer | |
  • 2
    +1 dman is an extremely useful idea. – Sathyam Jan 27 '17 at 15:01
  • 1
    I recommend debman. – Shayan Aug 31 '19 at 22:02
  • Instead of installing bikeshed, you can install debian-goodies which will give you both dman and debman – Shayan Sep 1 '19 at 9:11
  • For example to view manpage for debman which is part of the debian-goodies package you can use debman -p debian-goodies debman. If you have a .deb package on your computer you can use -f option to view manpages of it without installing that package: debman -f debian-goodies_0.79_all.deb debman – Shayan Sep 1 '19 at 9:54
  • @Shayan I believe this is very useful and deserves its own answer. Would you be willing to post one? – Eliah Kagan Sep 1 '19 at 13:03
1

I recommend installing debian-goodies package which will give you access to the dman, debman, debmany, and debget commands, and many more. Install it with:

sudo apt install debian-goodies

dman has already been covered by Eliah Kagan.

Now you know dman is both included in bikeshed and debian-goodies.


You can use debman to read man pages from uninstalled (not installed) packages.

In these examples I want to read the man page of dman from package debian-goodies:

debman -p debian-goodies dman

Or if you're looking to read man pages for a specific version, use:

debman -p debian-goodies=0.79 dman

You can also read local .deb files' manpage using the -f option:

debman -f debian-goodies_0.79_all.deb dman

Just for clarity, here's another example, I want to read the man page of apt-get tool which belongs to the apt package:

debman -p apt apt-get

So you need to know the command which you want to read it's man page belongs to which package.


You can download packages with debget and read them manually with your favorite app:

debget debian-goodies

man pages and other documentation are included in .deb packages, they can be found in:

debian-goodies_0.79_all.deb\data.tar\usr\share\man
debian-goodies_0.79_all.deb\data.tar\usr\share\doc

Or you can use debmany to view all documentation using terminal:

debmany ./debian-goodies_0.79_all.deb

You can also use it for installed packages:

debmany debian-goodies
| improve this answer | |
0

When I'm on my android phone and sometimes even when I'm on Ubuntu I will use internet to view man pages. Another benefit of internet browser is ability to easily search with Ctrl+F. In your browser search bar you can type man ls and this is the first hit:

man ls

| improve this answer | |
-1

In my Opinion you can't read the documentation without installing the package. when you install any specific package you may have noticed some additional files also gets installed one of which is named as 'man-db' or something similar.

This 'man-db' actually contains the manual documentation about the package.

but you can see some basic details of the package by

apt-cache show <packagename>
| improve this answer | |
  • 3
    The first part about man-db becomes relevant only after package installation (which OP doesn't want). – David Foerster Apr 4 '15 at 18:37

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.