DWWW-CONVERT(8) 						      Debian							   DWWW-CONVERT(8)

NAME

       dwww-convert - convert files to HTML for dwww

SYNOPSIS

       dwww-convert [--no-path-info] type location

DESCRIPTION

       dwww-convert is part of the dwww package, which provides access to on-line documentation on a Debian system via WWW.  dwww-convert converts
       documentation to HTML so that it can be viewed with a WWW browser.  dwww-convert is usually run by the WWW server, but can also be  run	by
       hand.

       The type argument gives the type of the file, one of:

       file   An arbitrary file; the type is guessed using simple heuristics based on the filename.

       dir    A  directory.   If  the  directory contains the file index.html or index.htm that file will be returned. Otherwise, A listing of the
	      files in the directory is generated.

       html   An HTML file.  The file is returned as is.

       man    A manual page.  The location is the pathname of the nroff source file.

       runman A manual page.  The location is the name of the manual page and its section, separated by a slash.  For example, the location  would
	      be intro/1 to refer to the intro(1) manual page.

       info   An Info file.

       text   A plain text file (using the ISO-8859-1 character set).

       An unknown file type is treated as text.

       The  location argument gives the filename of the file.  The name must be complete, i.e., it must start at the root directory (/).  The name
       must not contain any symbolic links (cf.  realpath(1)).	The file must be located in or below a directory that has been allowed by the sys-
       tem administrator; see dwww(7) for more info.

       The  file may be compressed with gzip(1) or bzip2(1).  It is uncompressed automatically and invisibly.  Compression is indicated by a file-
       name that ends in `.gz' or `.bz2'.

OPTIONS

       --no-path-info
	      Internal option used by the dwww's CGI script to let dwww-convert know, that the arguments following the option do not come from the
	      PATH_INFO variable, but from the QUERY_STRING.

FILES

       /etc/dwww/dwww.conf
	      Configuration file for dwww.  See dwww(7) for more information.

SEE ALSO

       dwww(7), dwww-txt2html(8), dwww-build(8), dwww-cache(8).

AUTHOR

       Lars Wirzenius.	Modified by Robert Luberda.
       See dwww(7) for copyrights and stuff.

dwww 1.11.1							February 15th, 2009						   DWWW-CONVERT(8)