Subject: hier(7) silent on pkg documentation
To: None <>
From: James K. Lowden <>
List: tech-pkg
Date: 11/06/2003 03:19:11
OK, I'm mad.  In both senses.  

Am I the only person who thinks it's no fun to guess which rock pkg_add
hid the documentation for <packagename>?  Let's see:


I'm probably missing some, but that's not the point.  What I want to know
is, why on earth would any package's documentation be anywhere except

I'd like to bring some rationality to this, starting with hier(7), so
we're all on the same page, so to speak.  Then I want to patch every last
package so it will DTRT once and for all.  I don't know exactly how to do
that, but I'm pretty sure once I've fixed one package, I'll know how to
fix most of them.  But there's no sense aiming at a moving target: we have
to agree on what we want.  

I'm pretty sure it takes both kinds of madness to attempt such a thing.  

My suggestion is that /usr/pkg/share hold the documentation in a tree
mimicking /usr/pkgsrc.  IOW, 

instead of 
we have 

and instead of 
we have 

Of course, /usr/pkg/info is useful and should be kept.  And mentioned in

One tree to hold the docs, one search to find them.  Less darkness, more
light, say I.  
Can we do this?