DWWW-CONVERT(8)

✨ DWWW-CONVERT ✨

okay bestie, so this is dwww-convert from the Debian section 8 of the manual pages 💅 (that's the admin/commands girlies section, iykyk).

🦋 NAME 🦋

dwww-convert — converts files to HTML so dwww can serve them, no cap 💖

🌸 SYNOPSIS 🌸

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

💖 DESCRIPTION 💖

So dwww-convert is literally part of the dwww package, which is the whole vibe that gives you access to on-line documentation on a Debian system via WWW 🌈. What this little icon does is convert documentation to HTML so your WWW browser can actually look at it 👑.

Most of the time dwww-convert is run by the WWW server (main character energy, it does NOT run itself), but you can also run it by hand if you're feeling brave fr fr 🫶.

The type argument tells it what kind of file we're dealing with, and it's one of these:

• file — just an arbitrary file. The type gets guessed using simple heuristics based on the filename (she's intuitive like that ✨).
• dir — a directory. If that directory has an index.html or index.htm in it, that file gets returned. Otherwise, a listing of the files in the directory is generated 🎀.
• html — an HTML file. The file is returned as is, no notes, she's already perfect 💅.
• man — a manual page. The location is the pathname of the nroff source file.
• runman — also a manual page, but the location is the name of the manual page and its section, separated by a slash. Like, 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. She's not judgy, she just defaults 💀.

The location argument gives the filename of the file. And listen — the name must be complete, meaning it must start at the root directory (/). It must not contain any symbolic links (cf. realpath(1)). And the file must be located in or below a directory that has been allowed by the system administrator; check dwww(7) for more info 🔥.

Oh and the file may be compressed with gzip(1) or bzip2(1)! It gets uncompressed automatically and invisibly, like it never even happened 💫. Compression is indicated by a filename that ends in .gz or .bz2.

✨ OPTIONS ✨

• --no-path-info — this one's an internal option used by 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 🙈. (insider info, you didn't hear it from me)

🎀 FILES 🎀

• /etc/dwww/dwww.conf — the configuration file for dwww. See dwww(7) for more information 💜.

🌈 SEE ALSO 🌈

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

(the whole friend group, obsessed with them all 🍓)

👑 AUTHOR 👑

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

okay that's the whole page, you ate that 🫶 this was dwww 1.11.1, dated February 15th, 2009 — yeah she's a vintage icon and she still slays, periodt 💅✨