install-docs - manage online Debian documentation

       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).

       -ifile [file ...],  --installfile [file ...]
           Install the documentation described by the control file file.

       -rfile [file ...],  --removefile [file ...]
           Remove the documentation identified by the control file file.

       -cfile [file ...],  --checkfile [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.

       -sdocid [docid ...], --statusdocid [docid ...]
           Display the status of the document identifier docid.

       -Ldocid [docid ...], --listfilesdocid [docid ...]
           Deprecated option. Does nothing.

       --dump-dbdbname
           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.

       This  program  was originally written by Christian Schwarz <schwarz@debian.org>, for the Debian GNU/Linux
       system, and the next maintainer was Adam Di Carlo <aph@debian.org>.  Robert  Luberda  <robert@debian.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@lists.debian.org>.

doc-base v0.11.2                                 21 January 2024                                 INSTALL-DOCS(8)

       See <http://bugs.debian.org/doc-base>.

       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.

install-docs is a tool allow Debian package maintainers to register documentation to various
       documentation systems.  It currently supports dhelp, dwww, dochelp, and doc-central 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.

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

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

       /var/lib/doc-base/info/documents/
           The location of registered control files.

       /var/lib/doc-base/info/status.db
           Statuses of registered documents.

       /var/lib/doc-base/info/files.db
           Timestamps and documents ids of registered doc-base files.

       install-docs - manage online Debian documentation

-v, --verbose
           Operate verbosely.

       -d, --debug
           Print some debugging information.

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

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

dhelp(1),       doccentral(1),       dochelp(1),       dwww(7),       Debian       doc-base        Manual
       /usr/share/doc/doc-base/doc-base.html/index.html

        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