The Design and Implementation of laffer1

Mandoc (mdocml) includes a man.cgi(8) script to display man pages. Here's a quick and dirty explanation on how to set it up.

• mport install mdocml

• Files will be installed in /usr/local/www/mdocml/

• Configure apache

• Configure man directory

create a directory /man on your file system. This is the default path.

in it, create a file called manpath.conf

it should have a RELATIVE path for one or more directories (per line) that you want to index.

so /man/midnightbsd-3.1

copy the man1, man2, and so on folders from /usr/share/man for your release.

extract all of then with gunzip

run makewhatis -a . from the /man/midnightbsd-3.1 folder. This will create your mandoc.db file.

Apache config

<VirtualHost *:80>
Protocols h2c http/1.1
H2Direct on
DocumentRoot /usr/local/www/mdocml/htdocs/
ServerName man.midnightbsd.org
ErrorLog /var/log/man.midnightbsd.org-error_log
CustomLog /var/log/man.midnightbsd.org-access_log combinedio
RedirectMatch ^/$ /cgi-bin/man.cgi
<Directory /usr/local/www/mdocml/>
DirectoryIndex man.cgi index.html
Require all granted

ScriptAlias /cgi-bin/ "/usr/local/www/mdocml/cgi-bin/"
<Location "/cgi-bin/man.cgi">
Options +ExecCGI
SetHandler cgi-script