[Bug 218257] pkg.conf and pkg.conf.sample - too many old syntax styles (for BSD newbies)

[bugzilla-noreply at freebsd.org]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=218257

            Bug ID: 218257
           Summary: pkg.conf and pkg.conf.sample - too many old syntax
                    styles (for BSD newbies)
           Product: Base System
           Version: 11.0-RELEASE
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Some People
          Priority: ---
         Component: conf
          Assignee: freebsd-bugs at FreeBSD.org
          Reporter: gwbr0601 at yahoo.de

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.

-- 
You are receiving this mail because:
You are the assignee for the bug.