Kali Linux Revealed

In addition to
man
, you can use
konqueror
(in KDE) and
yelp
(in GNOME) to search manual pages
as well.
6.1.2. Info Documents
The GNU project has written manuals for most of its programs in the info format; this is why many
manual pages refer to the corresponding info documentation. This format offers some advantages
but the default program to view these documents (also called
info
) is slightly more complex. You
would be well advised to use
pinfo
instead (from the pinfo package). To install it, simply run
apt
update
followed by
apt install pinfo
(see section 
8.2.2.2
, “
Installing Packages with APT
” [page
183]).
The info documentation has a hierarchical structure and if you invoke
pinfo
without parameters,
it will display a list of the nodes available at the first level. Usually, nodes bear the name of the
corresponding commands.
You can use the arrow keys to navigate between nodes. Alternatively, you could also use a graph-
ical browser (which is a lot more user-friendly) such as
konqueror
or
yelp
.
As far as language translations are concerned, the info system is always in English and is not suit-
able for translation, unlike the
man
page system. However, when you ask the
pinfo
program to
display a non-existing info page, it will fall back on the man page by the same name (if it exists),
which might be translated.
6.1.3. Package-Specific Documentation
Each package includes its own documentation and even the least documented programs generally
have a
README
file containing some interesting and/or important information. This documenta-
tion is installed in the
/usr/share/doc/
package
/
directory (where package represents the name
of the package). If the documentation is particularly large, it may not be included in the program’s
main package, but might be offloaded to a dedicated package which is usually named
package
-doc.
The main package generally recommends the documentation package so that you can easily find
it.
The
/usr/share/doc/
package
/
directory also contains some files provided by Debian, which com-
plete the documentation by specifying the package’s particularities or improvements compared
to a traditional installation of the software. The
README.Debian
file also indicates all of the adap-
tations that were made to comply with the
Debian Policy
1
. The
changelog.Debian.gz
file allows
the user to follow the modifications made to the package over time; it is very useful to try to
understand what has changed between two installed versions that do not have the same behav-
ior. Finally, there is sometimes a
NEWS.Debian.gz
file that documents the major changes in the
program that may directly concern the administrator.
1
https://www.debian.org/doc/debian-policy/
130
Kali Linux Revealed

6.1.4. Websites
In many cases, you can find websites that are used to distribute free software programs and to
bring together the community of its developers and users. These sites are loaded with relevant
information in various forms such as official documentation, frequently asked questions (FAQ),
and mailing list archives. In most cases, the FAQ or mailing list archives address problems that
you have encountered. As you search for information online, it is immensely valuable to master
search syntax. One quick tip: try restricting a search to a specific domain, like the one dedicated
to the program that is giving you trouble. If the search returns too many pages or if the results
do not match what you seek, you can add the keyword

Download 11,68 Mb.