This is an old revision of the document!

mkreadmes is a tool I wrote in C to speed up building the README.html files for the FreeBSD Ports Collection. The latest, “finalized” version (1.2) is now available in ports as ports-mgmt/mkreadmes.

The program builds the README.html files orders of magnitude times faster than the standard “make readmes”, typically clocking in at 30 seconds or less for a rebuild of the files for the entire ports tree. A number of command line options are provided to make this as flexible and useful a tool as possible.

Please feel free to ask questions, make comments/suggestions.

– Conrad J. Sabatier conrads@cox.net