GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
MKREADMES(1) FreeBSD General Commands Manual MKREADMES(1)

mkreadmes
high performance replacement for ports(8) “make readmes”.

mkreadmes [
options
] [
pathname-list
]

mkreadmes creates README.html files for one or more ports, just as “make readmes” from ports(8) does.
Just a tad bit faster. Like in “order of magnitude” faster, since it is specially built for the purpose.
Without options, mkreadmes will recursively create README.html files for all ports found either in /usr/ports, or the directory pointed to by PORTSDIR, resulting in a browseable hierarchy of README.html files.

Display help.
Do not reparent paths given in pathname-list. See -p for more information.
pathname
Set toplevel directory to pathname. mkreadmes expects the ports tree's INDEX file to be in this directory, and will work its way down from here. Relative paths in pathname-list will have their parent set to pathname, unless -n is used.
Without -p, mkreadmes defaults to /usr/ports, unless PORTSDIR is defined.
Just print errors, be quiet otherwise.
pathname
Template files should be read from pathname, instead of the default /usr/local/share/mkreadmes/Templates.
Be more verbose, reporting more detailed progress information. May be repeated to obtain progressively more lower-level details.
Display version information.
pathname-list
Optional list of port and/or category pathnames separated by whitespace. If pathname-list is omitted, mkreadmes defaults to work on the entire ports tree.

PORTSDIR
If not given, mkreadmes defaults to using /usr/ports.

Three ways for creating README.html for the port sysutils/froxlor:
# mkreadmes /usr/ports/sysutils/froxlor
# mkreadmes -vp /usr/ports sysutils/froxlor
# mkreadmes -qnp /usr/ports /usr/ports/sysutils/froxlor
Mimic “make readmes” from ports(8), creating README.html for all ports and categories in /usr/ports or the directory pointed to by PORTSDIR:
# mkreadmes

The mkreadmes utility exits 0 on success, and >0 if an error occurs.

The mkreadmes homepage at: http://mkreadmes.sourceforge.net.

mkreadmes was written by Conrad J. Sabatier <conrads@cox.net>.
This man page was written by Marco Steinbach <coco@executive-computing.de>.
March 4, 2012

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.