Linux Commands Examples

A great documentation place for Linux commands


manage online Debian documentation


 install-docs [options] -i,--install | -r,--remove | -c,--check file [ file ... ]
 install-docs [options] -I,--install-all | -C,--install-changed | -R,--remove-all
 install-docs [options] -s,--status docid [ docid ... ]
 install-docs [options] --dump-db dbname
 install-docs -h,--help | -V,--version

add an example, a script, a trick and tips

: email address (won't be displayed)
: name

Step 2

Thanks for this example ! - It will be moderated and published shortly.

Feel free to post other examples
Oops ! There is a tiny cockup. A damn 404 cockup. Please contact the loosy team who maintains and develops this wonderful site by clicking in the mighty feedback button on the side of the page. Say what happened. Thanks!


if [ "$1" = "remove" ] || [ "$1" = "upgrade" ] ; then
if which install-docs > /dev/null 2>&1 ; then
if which install-docs > /dev/null 2>&1 ; then
install-docs -r logtalk-docs
echo ""
echo "Removing Logtalk integration and documentation scripts..."
rm -rf /usr/share/logtalk/bin
if [ "\$1" = configure ] ; then
if which install-docs >/dev/null 2>&1; then
install-docs -i $javadoc_base$j2se_name
# Unregister documentation from the various documentation systems, i.e. dhelp and dwww.
if [ "\$1" = configure ] ; then
if which install-docs >/dev/null 2>&1; then
install-docs -r $javadoc_base$j2se_name


install-docs is a tool allow Debian package maintainers to register documentation to various documentation systems. It currently supports dhelp, dwww, doc-central, and scrollkeeper browsers.

This manual page provides a quick synopsis of install-docs usage. Full documentation can be found in the documentation, including a description of the control file syntax and grammar.


-v, --verbose

Operate verbosely.

-d, --debug

Print some debugging information.


Inhibit running dwww-build-menu(8), dhelp_parse(8), and scrollkeeper-update(8).

--rootdir dir

Set the root directory to dir instead of ’/’. Useful and valid only with the --check action.


Below is list of possible actions install-docs could handle. There can be only one action option passed to install-docs, moreover the action with its arguments must be the last option passed.

Each file argument should be the full path for the doc-base control file (i.e. ’/usr/share/doc-base/some_file’ or ’/etc/doc-base/documents/some_file’), and each docid should be the document identifier (Document identifiers are set in the ’Document’ field of the control file, and usually correspond to the package name.)

If file or docid equals ’-’ (the minus sign), the list of arguments is read from the standard input (each file name or document id in separate line).
file [file ...], --install file [file ...]

Install the documentation described by the control file file.

-r file [file ...], --remove file [file ...]

Remove the documentation identified by the control file file.

-c file [file ...], --check file [file ...]

Check the control file file and display number of possible problems found. Use with --verbose to get the actual locations of errors and warnings. If --rootdir was also given, its argument will be prepended to names of the files given if the ’Files’ and ’Index’ fields of the file.

-R, --remove-all

De-register all registered documents.

-I, --install-all

(Re)register all documents from /usr/share/doc-base and /etc/doc-base/documents.

-C, --install-changed

Compare contents of /usr/share/doc-base and /etc/doc-base/documents directories with registered documents database and de-register any files that are missing and (re)register only changed or new files.

-s docid [docid ...], --status docid [docid ...]

Display the status of the document identifier docid.

-L docid [docid ...], --listfiles docid [docid ...]

Deprecated option. Does nothing.

--dump-db dbname

Dumps contents of internal databases, for debugging purposes. dbname can be either files.db or status.db.

-h, --help

Show a short help message.

-V, --version

Display version information.

compatibility issues

The following features were added in version 0.8.4, please make sure to add proper ’Conflicts’ or ’Depends’ lines if you would like to use them in your package’s scripts:

support for passing more than one argument to the -i and -r actions,

reading arguments from the standard input,

-I,--install-all, -R, ---remove-all, -c, --check actions,

-d, --debug, -h, --help options.

The -C, --install-changed, --dump-db, -V, --version options were added in 0.8.12.



The location of doc-base control files provided by various packages.


The location of doc-base control files provided by local administrator.


The location of registered control files.


Statuses of registered documents.


Timestamps and documents ids of registered doc-base files.


The location of generated scrollkeeper OMF files. Note: /usr/share/omf/doc-base should be a symbolic link pointing to the directory.


See <>.

see also

dhelp, doccentral, dwww, scrollkeeper, Debian doc-base Manual /usr/share/doc/doc-base/doc-base.html/index.html


This program was originally written by Christian Schwarz <schwarz[:at:]debian[:dot:]org>, for the Debian GNU/Linux system, and the next maintainer was Adam Di Carlo <aph[:at:]debian[:dot:]org>. Robert Luberda <robert[:at:]debian[:dot:]org> is currently maintaining and extending it.

This software was meant to be for the benefit of the entire Debian user and developer community. If you are interested in being involved with this software, please join the mailing list <debian-doc[:at:]lists.debian[:dot:]org>.

How can this site be more helpful to YOU ?

give  feedback