summaryrefslogtreecommitdiff
path: root/imake/mkhtmlindex.man
diff options
context:
space:
mode:
Diffstat (limited to 'imake/mkhtmlindex.man')
-rw-r--r--imake/mkhtmlindex.man32
1 files changed, 32 insertions, 0 deletions
diff --git a/imake/mkhtmlindex.man b/imake/mkhtmlindex.man
new file mode 100644
index 0000000..fc8a427
--- /dev/null
+++ b/imake/mkhtmlindex.man
@@ -0,0 +1,32 @@
+.TH mkhtmlindex 1 __vendorversion__
+.SH NAME
+mkhtmlindex \- generate index files for HTML man pages
+.SH SYNOPSIS
+.B mkhtmlindex
+.I htmlmandir
+.SH DESCRIPTION
+The
+.I mkhtmlindex
+program generates index files for a directory of HTML-formatted manual
+pages.
+It searches for files whose names are of the form \(lqname.1.html\(rq,
+and outputs index files \(lqmanindex1.html\(rq, \(lqmanindex.2.html\(rq,
+and so on, one for each manual volume.
+Empty index files will be removed.
+Names and descriptions are found by scanning the first
+.I <H2>
+section of each page.
+.SH OPTIONS
+.I mkhtmlindex
+takes only one argument: the directory to process.
+.SH NOTES
+This utility is currently rather specific to X manual pages.
+In particular, the format of the index files it outputs is not configurable,
+nor is the HTML formatting it expects of manual pages.
+.SH AUTHOR
+The version of the
+.I mkhtmlindex
+included in this X.Org Foundation release was originally written
+by David Dawes wrote as a part of XFree86.
+.PP
+Colin Watson wrote this manual page, originally for the Debian Project.