https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=288871
Bug ID: 288871
Summary: pkg.conf documentation errors
Product: Base System
Version: 14.3-RELEASE
Hardware: Any
OS: Any
Status: New
Severity: Affects Some People
Priority: ---
Component: bin
Assignee: [email protected]
Reporter: [email protected]
I found two significant documentation errors. The pkg.conf page--and possibly
others--say that pkg uses the fetch library. But instead, it uses libcurl.
This bit me because I was trying to set up pkg to use a SOCKS proxy and it is
done different ways in the two libraries. That pain was compounded by the fact
that that page also says that environment variables override configuration
variables. This is more or less true, but the "less" part can be a killer: It
doesn't work properly for non-scalars. So, for example, setting the
environment variable REPOS_DIR to [my_directory] didn't work; I had to remove
the brackets. And it's likely, though I didn't test it, that it won't work for
a list of directories. Similarly, setting a complicated PKG_ENV environment
variable doesn't work; however, ALL_PROXY=socks5://127.0.0.1:1080 was
apparently passed to libcurl, without the use of PKG_ENV. So maybe PKG_ENV is
obsolete? Or only relevant in the config file?
At a minimum, the man pages should reflect the proper library, and the comment
about environment variables overriding configuration variables should be
qualified to point out the issues with non-scalars. And if, as I expect,
PKG_ENV is only relevant from the config file, that one can just set libcurl
environment variables, it might be good to mention it. An example that
reflects what I did to use a SOCKS proxy would be a good idea.
--
You are receiving this mail because:
You are the assignee for the bug.
