Re: Note: libutil.so bump from main-n279246-0c381b7f0570

On Aug 15, 2025, at 00:17, Dag-Erling Smørgrav <des@FreeBSD.org> wrote:

> Mark Millard <marklmi@yahoo.com> writes:
>> Okay.
>> 
>> # man pkg-info | grep -i compat
>>             compatibility.
>>             compatibility.
>> 
>> # man pkg-delete | grep -i compat
>> # 
>> 
>> The 2 pkg commands involved do not seem to document how
>> they are to be used with "compat-libraries" for such
>> things.
> 
> Are you really incapable of putting “legacy libraries get moved to the
> compat-libraries package” and “the pkg delete command can be used to
> delete packages” together to form “pkg delete compat-libraries will
> remove all legacy libraries”?

# man -K compat-libraries
/usr/local/share/man/man5/pkg.conf.5.gz:                  exist yet a new package "compat-libraries" will be created.

In my view the concept of compat-libraries is not
very discoverable as stands --because of the single
existing documentation reference being the one in:

     BACKUP_LIBRARIES: boolean
                  If set to true pkg(8) will backup ancient libraries if they
                  are removed as the result of an upgrade and keep a copy in
                  the path define in BACKUP_LIBRARY_PATH.  If it does not
                  exist yet a new package "compat-libraries" will be created.
                  the version will be bumped each time a new library is backed
                  up Default: NO.

in "man 5 pkg.conf". Also:

# grep compat-libraries /usr/local/etc/pkg.conf*
# 

In my view having some primary commands show some
usage (and possibly have a see-also reference to
the BACKUP_LIBRARIES material) would be useful.


Side note: Ridicule as a reply was an interesting choice
that I not think much of.


>> # grep compat /usr/local/etc/pkg.conf*
>> # 
>> 
>> So: No sample command alias either.
> 
> What would you want an alias for?

I was just looking for another reference to
compat-libraries besides the BACKUP_LIBRARIES
description's reference but did not find one.

===
Mark Millard
marklmi at yahoo.com