usr/ports make readmes & description

tech-lists tech-lists at
Fri Oct 2 03:21:23 UTC 2020

On Wed, Sep 30, 2020 at 02:29:01PM +0200, Polytropon wrote:
>On Wed, 30 Sep 2020 01:59:48 +0100, tech-lists wrote:
>> Years ago one could go into /usr/ports and make readmes for every single port.
>> It'd take a while, but you'd end up with a ports tree browsable comfortably in
>> lynx. Nowadays, make readmes only works for the top level ie /usr/ports/category and
>> won't make the longer descriptions in HTML.
>> How can I get the old behaviour back?
>According to "man 7 ports", this is still supported:
>readmes	      Create a port's README.html.  This can be	used from
>	      /usr/ports to create a browsable web of all ports	on
>	      your system!
>See /usr/ports/Mk/ for the target.

Hi, this is my point.

/usr/ports/Mk/ seems to suggest that 'make readme'
builds the category (for example cd /usr/ports/archivers && make
readme) one gets a README.html with a one-line description of each port.
The port name is a link but if it's selected of course it goes nowhere.

Now, if instead you 'make readmes', the end result is *identical* my point
is that make readmes used to (it was a long time ago but I'm sure of it
now) first make the top level readme and then go into each and every
port in that category and make the readme for all those ports. It'd take
a long while, but what you were left with is a README.html you could
click through right down to the port's long description.

That's what it's missing. Maybe the ports tree got too big for this I
guess? The bit in that that's not getting run appears
to be this:

readmes: readme ${SUBDIR:S/^/_/:S/$/.readmes/}
         @${ECHO_MSG} "===>   Creating README.html for all ports"
                 @perl ${PORTSDIR}/Tools/make_readmes <

I never see "Creating README.html for all ports" regardless of whether
i'm in /usr/ports or /usr/ports/category when I run "make readmes". Is
this a bug?
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <>

More information about the freebsd-questions mailing list