[Bug 291127] FreeBSD-base packages are pkg-fetch-ed into Hashed/ - not documented

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

            Bug ID: 291127
           Summary: FreeBSD-base packages are pkg-fetch-ed into Hashed/ -
                    not documented
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Only Me
          Priority: ---
         Component: Manual Pages
          Assignee: bugs@FreeBSD.org
          Reporter: erichanskrs@gmail.com
                CC: doc@FreeBSD.org

FreeBSD 15.0-RC2 (package based), using pkg v. 2.4.2_1

1) pkg-fetch does not use the All directory relative to the 
specified output directory, it uses the Hashed directory 
when a package is in the FreeBSD-base repository.
This is not documented in the pkg-fetch man page:

OPTIONS
     The following options are supported by pkg fetch:
   [...]
    -o destdir, --output destdir
                   Place files in a sub-directory called All of the specified
                   directory.  In this mode, packages are fetched for
                   distribution instead of placing them into the internal
                   cache.

[1-0] # pkg fetch -r FreeBSD-base -o . FreeBSD-vi
Updating FreeBSD-base repository catalogue...
FreeBSD-base repository is up to date.
FreeBSD-base is up to date.
The following packages will be fetched:

New packages to be FETCHED:
        FreeBSD-vi: 15.0.rc2.20251118061818 (279 KiB: 100.00% of the 279 KiB to
download)

Number of packages to be fetched: 1

279 KiB to be downloaded.

Proceed with fetching packages? [y/N]: y
Fetching FreeBSD-vi-15.0.rc2.20251118061818~cbdaafb0b4.pkg: 100%  279 KiB
285.7kB/s    00:01

[2-0] # ls -l All/FreeBSD-vi*
ls: No match.
[3->1<] # ls -l Hashed/FreeBSD-vi*
-rw-r--r--  1 root wheel 285673 Nov 18 22:18
Hashed/FreeBSD-vi-15.0.rc2.20251118061818~cbdaafb0b4.pkg


2) SYNOPSIS of pkg-fetch options are not everywhere completely documented:

SYNOPSIS
-      pkg fetch [-r reponame] [-dqUy] [-Cgix] pkg-name [...]
+      pkg fetch [-r reponame] [-o destdir] [-dqUy] [-Cgix] pkg-name    [...]
       pkg fetch [-r reponame] [-o destdir] [-dqUy] -a
       pkg fetch [-r reponame] [-dqUy] -u

       pkg     fetch     [--repository     reponame]     [--output    destdir]
           [--{dependencies,quiet,no-repo-update,yes}]
           [--{case-sensitive,glob,case-insensitive,regex}] pkg-name [...]
-      pkg             fetch              [--repository              reponame]
+      pkg     fetch     [--repository     reponame]     [--output    destdir]
           [--{dependencies,quiet,no-repo-update,yes}] --all
       pkg              fetch              [--repository             reponame]
           [--{dependencies,quiet,no-repo-update,yes}] --available-updates

-- 
You are receiving this mail because:
You are on the CC list for the bug.