Bug 616262 – emerge(1) man page outdated: quickpkg now uses atom input

• Status: RESOLVED FIXED
• Product: Portage Development

[Description fuse809 2017-04-22 06:27:37 UTC]

I have noticed a minor issue in the emerge(1) man page, namely it presently reads:

tbz2file
              A  tbz2file  must  be  a valid .tbz2 created with ebuild <package>-<version>.ebuild package or
              emerge --buildpkg [category/]<package> or quickpkg /var/db/pkg/<category>/<package>.

I tried to use its syntax with quickpkg but it gave the error:

 * Invalid atom: /var/db/pkg/app-editors/vim-8.0.0577
 * No packages found

So I believe the man page should now read in this section:

tbz2file
              A  tbz2file  must  be  a valid .tbz2 created with ebuild <package>-<version>.ebuild package or
              emerge --buildpkg [category/]<package> or quickpkg [category/]<package>.

Reproducible: Always

Steps to Reproduce:
1. Run man 1 emerge
2. Search for quickpkg
3. Read the tbz2file section



My version of Portage is 2.3.5, if relevant. Line 50-54 of the Portage emerge.1 file (git URL: https://gitweb.gentoo.org/proj/portage.git/tree/man/emerge.1#n50) is where the error lies. If I could submit a pull request to fix this issue I would.

[Comment 1 Zac Medico 2017-04-22 06:35:04 UTC]

Thanks for the report. You can send a pull request against https://github.com/gentoo/portage.

[Comment 2 fuse809 2017-04-22 06:47:41 UTC]

Well if I can file pull requests there you better update the Project:Portage (https://wiki.gentoo.org/wiki/Project:Portage) article as it says and I quote:

"We also have a GitHub mirror, but note that this is just a mirror, so do not file bugs nor pull requests there."

[Comment 3 Zac Medico 2017-04-22 08:17:00 UTC]

Thanks, this is in the master branch:

https://gitweb.gentoo.org/proj/portage.git/commit/?id=8889360554e80e2ca461ee67bbbc11de8a9a5a1a

(In reply to Brenton Horne from comment #2)
> Well if I can file pull requests there you better update the Project:Portage
> (https://wiki.gentoo.org/wiki/Project:Portage) article as it says and I
> quote:
> 
> "We also have a GitHub mirror, but note that this is just a mirror, so do
> not file bugs nor pull requests there."

Yeah, we'll have to re-evaluate that policy. We may have some team members that prefer to avoid using a "proprietary" platform, since Gentoo hosts its own infrastructure based entirely on free software. Within that context, patch submission and review is done via Gentoo mailing lists.

[Comment 4 Zac Medico 2017-08-11 19:43:51 UTC]

Fixed in 2.3.6.