For this exercise, having an up-to-date mandoc suite is more important than for most. Consider checking out from email@example.com:/cvs and building and installing from that before starting. On OpenBSD, it is better to build from /usr/src/usr.bin/mandoc
To run makewhatis(8)
on one specific tree only, you will need the dir
If everythings appears to be working fine, try to refine your methods. For example, try the -p
, and -DD
options of makewhatis(8)
and try to understand the output.
Probably, most of the output will be false positives, but you may also find some real bugs in the manuals in this way that can be worth patching.
If you are comfortable with SQL, run the sqlite3(1)
command line client directly on the database generated by makewhatis(8)
and look for anything that seems questionable.