How to view documentation for an installed library?
Solution 1:
You don't state the version of Ubuntu you use, but for Trusty, there's a PDF manual in /usr/share/doc/doxygen/doxygen_manual.pdf
.
There's also HTML documentation here: /usr/share/doc/doxygen/html/index.html
I can't spot a compressed archive besides the changelog (/usr/share/doc/doxygen-doc/changelog.Debian.gz
) that you'd look at using zless
.
Solution 2:
Finding Documentation on ubuntu
1. Search using nautilus or browser
You can search as mentioned above in the /usr/share/doc directory, but some packages install it in their /usr/share/package_name directories or even other locations. Here you can find the html and pdf docus, best using nautilus (use the search function of nautilus and open your requested docu in your browser). If you often use the docu don't forget to bookmark your link.
2. Using find command
From your command line you can use the find command to search for your docu:
-
html-documentation:
find /usr/share -type f -name index.html | grep doxy
-
pdf-documention:
find /usr/share/ -type f -name *.pdf | grep doxy
Invoke your result with evince or your browser (in my case google-chrome)
-
html:
google-chrome /usr/share/doc/doxygen/html/index.html
-
pdf:
google-chrome /usr/share/doc/doxygen_manual.pdf
evince /usr/share/doc/doxygen_manual.pdf
3. Make a list and search and invoke with less
I prefer to automate this task and make a list the following way:
-
for html:
find /usr/share/ -type f -name index.html | sort -k1 | awk '{ print "file://" $0;}' > ~/DocHtml.txt
-
for pdf:
find /usr/share/ -type f -name *.pdf | sort -k1 | awk '{ print "file://" $0;}' > ~/DocPdf.txt
This will create 2 files in your home-directory (DocPdf.txt and DocHtml.txt). Simply open this with less
less ~/DocPdf.txt
or
less ~/DocHtml.txt
and press & followed with your searching string, e.g. doxygen. Now simple move your mouse over the requested document and press ctrl and left-mouse-click will open the file.
You can also make a bash script and invoke it via a chron job. This will automate the task.
Here is a simple bash script which can be modified. Put additional directories as desscribed in the script. Save the below bash script as makeDoc, change chmod +x makeDoc and invoke it with ./makeDoc. Rest as above:
#!/bin/bash
# Author: abu
# Description: script creates two files, DocPdf.txt and DocHtml.txt,
# which lists all pdf/html documents found by the find function.
#
# You can include other search directories, e.g. Anaconda,
declare -a DocDirs=(
"/usr/share/"
"/opt/anaconda3/" # you can put here additional directories
# "/path/to/other/dirs/" # -""- -""- -""-
)
echo "DocHtml automatic generated!" > DocHtml.txt
echo " File generated with" $0 >> DocHtml.txt
echo -e " Date: " `date` "\n\n" >> DocHtml.txt
echo "DocPdf automatic generated!" > DocPdf.txt
echo " File generated with" $0 >> DocPdf.txt
echo -e " Date: " `date` "\n\n" >> DocPdf.txt
for i in "${DocDirs[@]}"
do
find $i -type f -name index.html | sort -k1 | awk '{ print "file://" $0;}' >> ~/DocHtml.txt
find $i -type f -name *.pdf | sort -k1 | awk '{ print "file://" $0;}' >> ~/DocPdf.txt
done
4. APT Package Solution
The package doc-base helps developers to install it in the correct way. To view this I know dhelp and doc-central.
4.1 dhelp: web base documentation reader.
Install it with
sudo apt-get install dhelp
and open in your browser the file:
file:///usr/share/doc/HTML/Programming/Awk/index.html
- documentation are well indexed
- documentation is available through a web browser
- indexes documentation (in the background)
- not so convenient command line interface .
4.2 doc-central: web base documentation reader.
Install it with:
sudo apt-get install doc-central
- documentation are well indexed
- documentation is available through a web browser
- indexes documentation (in the background)
- not so convenient command line interface