[Bug 256676] manpage of poudriere-bulk(8) claims features which aren't available in 3.3.6

From: <bugzilla-noreply_at_freebsd.org>
Date: Wed, 01 Dec 2021 16:26:43 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=256676

Wolfram Schneider <wosch@FreeBSD.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|New                         |Closed
         Resolution|---                         |Works As Intended
         Depends on|                            |254466

--- Comment #9 from Wolfram Schneider <wosch@FreeBSD.org> ---
There are two poudriere ports

https://cgit.freebsd.org/ports/tree/ports-mgmt/poudriere
https://cgit.freebsd.org/ports/tree/ports-mgmt/poudriere-devel

pkg search poudriere
poudriere-3.3.7_1              Port build and test system
poudriere-devel-3.3.99.20211017_2 Port build and test system

pkg fetch poudriere-3.3.7_1
tar tfv /var/cache/pkg/poudriere-3.3.7_1.pkg | grep /man/man
-rw-r--r--  0 root   wheel    4635 Nov 21 06:13
/usr/local/man/man8/poudriere.8.gz
-rw-r--r--  0 root   wheel    3165 Nov 21 06:13
/usr/local/man/man8/poudriere-bulk.8.gz
-rw-r--r--  0 root   wheel    1520 Nov 21 06:13
/usr/local/man/man8/poudriere-distclean.8.gz
-rw-r--r--  0 root   wheel    1784 Nov 21 06:13
/usr/local/man/man8/poudriere-image.8.gz
-rw-r--r--  0 root   wheel    4215 Nov 21 06:13
/usr/local/man/man8/poudriere-jail.8.gz
-rw-r--r--  0 root   wheel    1482 Nov 21 06:13
/usr/local/man/man8/poudriere-logclean.8.gz
-rw-r--r--  0 root   wheel    1606 Nov 21 06:13
/usr/local/man/man8/poudriere-options.8.gz
-rw-r--r--  0 root   wheel    1609 Nov 21 06:13
/usr/local/man/man8/poudriere-pkgclean.8.gz
-rw-r--r--  0 root   wheel    2416 Nov 21 06:13
/usr/local/man/man8/poudriere-ports.8.gz
-rw-r--r--  0 root   wheel    1146 Nov 21 06:13
/usr/local/man/man8/poudriere-queue.8.gz
-rw-r--r--  0 root   wheel    1550 Nov 21 06:13
/usr/local/man/man8/poudriere-status.8.gz
-rw-r--r--  0 root   wheel    2366 Nov 21 06:13
/usr/local/man/man8/poudriere-testport.8.gz
-rw-r--r--  0 root   wheel    1071 Nov 21 06:13
/usr/local/man/man8/poudriere-version.8.gz

pkg fetch poudriere-devel-3.3.99.20211017_2
tar tfv /var/cache/pkg/poudriere-devel-3.3.99.20211017_2.pkg | grep /man/man
-rw-r--r--  0 root   wheel    4493 Nov 21 16:47
/usr/local/man/man8/poudriere.8.gz
-rw-r--r--  0 root   wheel    4115 Nov 21 16:47
/usr/local/man/man8/poudriere-bulk.8.gz
-rw-r--r--  0 root   wheel    1535 Nov 21 16:47
/usr/local/man/man8/poudriere-distclean.8.gz
-rw-r--r--  0 root   wheel    2521 Nov 21 16:47
/usr/local/man/man8/poudriere-image.8.gz
-rw-r--r--  0 root   wheel    4176 Nov 21 16:47
/usr/local/man/man8/poudriere-jail.8.gz
-rw-r--r--  0 root   wheel    1497 Nov 21 16:47
/usr/local/man/man8/poudriere-logclean.8.gz
-rw-r--r--  0 root   wheel    1658 Nov 21 16:47
/usr/local/man/man8/poudriere-options.8.gz
-rw-r--r--  0 root   wheel    1694 Nov 21 16:47
/usr/local/man/man8/poudriere-pkgclean.8.gz
-rw-r--r--  0 root   wheel    2400 Nov 21 16:47
/usr/local/man/man8/poudriere-ports.8.gz
-rw-r--r--  0 root   wheel    1133 Nov 21 16:47
/usr/local/man/man8/poudriere-queue.8.gz
-rw-r--r--  0 root   wheel    1543 Nov 21 16:47
/usr/local/man/man8/poudriere-status.8.gz
-rw-r--r--  0 root   wheel    2767 Nov 21 16:47
/usr/local/man/man8/poudriere-testport.8.gz
-rw-r--r--  0 root   wheel    1063 Nov 21 16:47
/usr/local/man/man8/poudriere-version.8.gz

both contain the same manual pages files from nearly the same time 21-Nov-2021
(12.3-STABLE).

In that case, the package poudriere-devel wins because it is alphabetically
last. man.freebsd.org will show the manual pages from poudriere-devel and not
poudriere.

This is a common problem with the ports and several dozen packages are
affected. I don't think there is an easy solution for this. But I also think
that it is fine that the higher version number or the devel packages wins. Our
users want to use the latest and best version, aren't they?

If you think that  poudriere-devel is stale or outdated, please fix the port.


Referenced Bugs:

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=254466
[Bug 254466] sysutils/beadm-devel section (1) and sysutils/beadm section (8)
for the two manual pages for beadm; consequences
-- 
You are receiving this mail because:
You are on the CC list for the bug.