.\" $Id: dwww-find.8 547 2011-01-15 15:29:55Z robert $
.\"
.TH DWWW\-FIND 8 "January 15th, 2011" "dwww 1.11.4" "Debian"
.SH NAME
dwww\-find \- find documentation related to a search argument
.SH SYNOPSIS
.B "dwww-find" 
.RB [ \-\-program | \-\-menu | \-\-documentation | \-\-docfile | \-\-doc-base-list ] 
.RB [ \-\-skip=\fInumber\fP ]
.IR "argument " [ ... ]
.SH DESCRIPTION
.B dwww-find
is part of the dwww package,
which provides access to on-line documentation on a Debian system via WWW.
.PP
.B dwww\-find
searches for a documentation related to a given program,
for entries from Debian Documentation Menu, or at least
for documents registered with doc-base.
It returns a HTML-formatted document with
search results.
.SH OPTIONS
.TP
.B \-\-program
Search for documentation  (man pages, info files, etc.) related to
program specified by
.IR argument .
.TP
.B \-\-menu
Search for entries in Debian Documentation Menu pages generated by 
.BR dwww\-build\-menu (8).
.TP
.B \-\-documentation
Search in documentation files registered with doc\-base.
It uses
.BR search++ (1)
for searching.
.TP
.B \-\-docfile
Search for documentation for package, which contains the file
specified by the
.IR argument .
The file must be located in or below a directory that has been allowed
by the system administrator; see
.BR dwww (7)
for more info.
.TP
.B \-\-doc\-base\-list
Show list of registerered doc-base files for given
.IR argument ,
which should be specified as 
.IR format/document\-id ,
where
.I document\-id
is an identificator of registered doc\-base document, and
.I format 
is a name of format (e.g. text or pdf) registered by the document, for which
the list list is to be generated.
.TP
.BI \-\-skip= number
Works only with
.BR \-\-documentation .
Skip 
.I number
of search results.
.PP
When no options are specified, 
.B \-\-program 
is assumed.
.SH FILES
.TP 
.I /etc/dwww/dwww.conf
Configuration file for dwww.
.SH "SEE ALSO"
.BR dwww (7),
.BR dwww\-quickfind (8),
.BR dwww\-build\-menu (8),
.BR dwww\-index++ (8),
.BR search++ (1),
.RI "Debian doc\-base Manual in "  /usr/share/doc/doc\-base/doc\-base.html/index.html .
.SH AUTHORS
Lars Wirzenius.
Robert Luberda.
.br
See
.BR dwww (7)
for copyrights and stuff.