---
name: "dwww-convert"
section: "8"
platform: "linux"
package: "dwww"
version: "1.16"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/dwww-convert"
---

# dwww-convert(8)

convert files to HTML for dwww

## 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)](/intro/1.md) 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)](/realpath/1.md)). The file must be located in or below a directory that has been allowed by the system administrator; see [**dwww**(7)](/dwww/7.md) for more info.

The file may be compressed with [**gzip**(1)](/gzip/1.md) or [**bzip2**(1)](/bzip2/1.md). It is uncompressed automatically and invisibly. Compression is indicated by a filename 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)](/dwww/7.md) for more information.

## SEE ALSO

[**dwww**(7)](/dwww/7.md), [**dwww-txt2html**(8)](/dwww-txt2html/8.md), [**dwww-build**(8)](/dwww-build/8.md), [**dwww-cache**(8)](/dwww-cache/8.md).

## AUTHOR

Lars Wirzenius. Modified by Robert Luberda.\
 See [**dwww**(7)](/dwww/7.md) for copyrights and stuff.