On Thu, 08 May 2025 08:59:25 -0700, Chris <[email protected]> wrote:
>On 2025-05-08 06:23, [email protected] wrote:
>> Moin Rahman wrote on Thu, 08 May 2025 14:19:05 +0200 (CEST):  
>>> Let me be blunt, because this needs to be said clearly.  
>> 
>> No necessity. It boils down to the fact that STABLE's and RELEASE's
>> FreeBSD.conf refer to different repository URLs. Which I simply wasn't  
>
>> aware of. Perhaps documented somewhere?  
>Please see pkg.conf(5). :)
 
So ... pkg.conf(5) ... I couldn't find -clear- documentation on anything other
than what a URL field does in that man page.

Now I happen to have some familiarity (which will quite likely be challenged on
these lists) with this entire ports system. With this in mind, I'll note that
the example:

  url: "pkg+https://pkg.freebsd.org/${ABI}/latest";

comes with no explanation of the "pkg+https" pseudo-schemea, no clear idea of
what ABI should be (yes I am aware this is auto generated, that's not the
point), and no list that I've found (even unmaintained) of supported scheme/ABI
combinations. (Does FreeBSD:13:i386 exist?)

It has been said that man pages are reference documentation and not tutorial
documentation. Yet I find the most common implication of "Please see some man
page" is that it is somehow a substitute for tutorial documentation, which is
lacking in FreeBSD to some degree which can and will be debated. 

It is not required to explain anything. It is a courtesy, which I dare say is
the same kind of courtesy as knowing at least -some- background before posting
a bug report. I know some of you are insanely busy, which is why I understand
when some of you do not explain anything in depth. 

But it sure would be nice if you did. :)
-- 
Dave Hayes - Computer and Internet Consultant - LA CA, USA
  >> *Opinions expressed above are entirely my own* <<

Nasrudin went into a bank with a check to cash. "Can you
identify yourself?"  asked the clerk.

Nasrudin took out a mirror and peered into it. "Yes, that's
me alright."

Reply via email to