The portage manual page conflicts with actual behavior regarding files scanned. For example, consider these files both exist: /etc/portage/repos.conf/eselect-repo.conf /etc/portage/repos.conf/eselect-repo.conf~ Only the first one appears to be read. This conflicts with the portage manual which states: ~~~snip~~~ /etc/portage/ Files in this directory including make.conf, repos.conf, and any file with a name that begins with "package." can be more than just a flat file. If it is a directory, then all the files in that directory will be sorted in ascending alphabetical order by file name and summed together as if it were a single file. ~~~snip~~~ This has resulted in app-shells/gentoo-bashcomp bug 562626, and it's counter bug 730624. There may be problems in other portage tools whose programmers rely on the manual. Reproducible: Always
Portage intentionally skips files starting with a period (.) or ending with a tilde (~). If you want to submit a patch to update the manpage, I think that would be welcome.
Created attachment 783464 [details, diff] man/portage.5: document portage skips files that begin with '.' or end '~'
The bug has been closed via the following commit(s): https://gitweb.gentoo.org/proj/portage.git/commit/?id=704554770bb49bdfc24e9245404e2f0da938e3d7 commit 704554770bb49bdfc24e9245404e2f0da938e3d7 Author: Jernej Jakob <jernej.jakob+gentoo@gmail.com> AuthorDate: 2022-06-07 14:13:20 +0000 Commit: Sam James <sam@gentoo.org> CommitDate: 2023-01-14 16:41:48 +0000 man/portage.5: document portage skips files that begin with '.' or end '~' Closes: https://bugs.gentoo.org/834038 Signed-off-by: Jernej Jakob <jernej.jakob+gentoo@gmail.com> Signed-off-by: Sam James <sam@gentoo.org> man/portage.5 | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-)
The bug has been closed via the following commit(s): https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=e342b1cae0ba19e35d27fe523ce0331e1412e295 commit e342b1cae0ba19e35d27fe523ce0331e1412e295 Author: Sam James <sam@gentoo.org> AuthorDate: 2023-01-15 22:13:26 +0000 Commit: Sam James <sam@gentoo.org> CommitDate: 2023-01-15 22:13:26 +0000 sys-apps/portage: add 3.0.44 Closes: https://bugs.gentoo.org/889328 Closes: https://bugs.gentoo.org/607696 Closes: https://bugs.gentoo.org/867031 Closes: https://bugs.gentoo.org/873202 Closes: https://bugs.gentoo.org/888543 Closes: https://bugs.gentoo.org/834038 Signed-off-by: Sam James <sam@gentoo.org> sys-apps/portage/Manifest | 1 + sys-apps/portage/portage-3.0.44.ebuild | 288 +++++++++++++++++++++++++++++++++ 2 files changed, 289 insertions(+)
The bug has been referenced in the following commit(s): https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=81aa9d9a0ee5f9f33fb9ab1f591c79f1fb134ffd commit 81aa9d9a0ee5f9f33fb9ab1f591c79f1fb134ffd Author: Sam James <sam@gentoo.org> AuthorDate: 2023-03-13 21:23:21 +0000 Commit: Sam James <sam@gentoo.org> CommitDate: 2023-03-13 21:23:33 +0000 app-shells/gentoo-bashcomp: add 20230313 Bug: https://bugs.gentoo.org/730624 Bug: https://bugs.gentoo.org/870373 Bug: https://bugs.gentoo.org/834038 Signed-off-by: Sam James <sam@gentoo.org> app-shells/gentoo-bashcomp/Manifest | 1 + .../gentoo-bashcomp/gentoo-bashcomp-20230313.ebuild | 21 +++++++++++++++++++++ 2 files changed, 22 insertions(+)