Bug 218257 - pkg.conf and pkg.conf.sample - too many old syntax styles (for BSD newbies)
Summary: pkg.conf and pkg.conf.sample - too many old syntax styles (for BSD newbies)
Status: New
Alias: None
Product: Base System
Classification: Unclassified
Component: conf (show other bugs)
Version: 11.0-RELEASE
Hardware: Any Any
: --- Affects Some People
Assignee: freebsd-pkg (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2017-03-31 15:07 UTC by Bernd Roth
Modified: 2020-01-25 15:51 UTC (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Bernd Roth 2017-03-31 15:07:09 UTC
Hello, persuaded to try FreeBSD i'd like to use my existing proxy for repeativ VM installations. I found configuration examples but proxing the repo didn't work.
I had troubles with both sides, my proxy system and the pkg configs.

In man pkg i learned that there is a man pkg.conf.

In man pkg.conf i learned that there is a /usr/local/etc/pkg.conf file,
and that all keywords are followed with a colon (:).

But nearly the complete pkg.conf and pkg.conf.sample do not follow the manpage.

paste from pkg.conf.sample:
#ALIAS {
#}
#CUDF_SOLVER = "";

# Sample alias settings       <- and only occurrence of keyword colon usage
ALIAS              : {
  all-depends: query %dn-%dv,
  annotations: info -A,
[...]
}
end paste

I found in the FreeBSD handbook that there was a change in the pkg system to pkgng. Maybe there was a change of the config syntax too?

I was completely confused what is correct.

It took me days and the help of a more experienced FreeBSD user to find out that the relevant information was hidden in man pkg.conf: "The file is in UCL format. For more information on the syntax of UCL, please visit the official UCL website"

In the end i had to run around 4 corners just to find out that i was in front off the correct door already.

So i would like to kindly ask you to make life for newbies a little bit easier by adjusting the config and sample to one syntax style.
Comment 1 Mark Linimon freebsd_committer freebsd_triage 2017-03-31 18:43:34 UTC
Although it's in the source tree, probably someone from pkg@ should weigh in on this.
Comment 2 Baptiste Daroussin freebsd_committer freebsd_triage 2017-03-31 18:47:51 UTC
It is not in the source tree :) and I can for sure use a consistent syntax, I'll make it in the next release