[gentoo-commits] proj/portage:master commit in: man/, /

[gentoo-commits] proj/portage:master commit in: man/, /

[Zac Medico]

commit:     cd5e6d8d4e84bc042c041f75e428410d6cdb5475
Author:     Zac Medico <zmedico <AT> gentoo <DOT> org>
AuthorDate: Tue Aug 13 01:02:55 2019 +0000
Commit:     Zac Medico <zmedico <AT> gentoo <DOT> org>
CommitDate: Mon Aug 19 04:09:54 2019 +0000
URL:        https://gitweb.gentoo.org/proj/portage.git/commit/?id=cd5e6d8d

glsa-check: install in /usr/bin (bug 463952)

In order to eliminate the duplicate implementation from gentoolkit,
install glsa-check into /usr/bin and add man page from gentoolkit.

Bug: https://bugs.gentoo.org/463952
Signed-off-by: Zac Medico <zmedico <AT> gentoo.org>

 man/glsa-check.1 | 66 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 setup.py         |  2 +-
 2 files changed, 67 insertions(+), 1 deletion(-)

diff --git a/man/glsa-check.1 b/man/glsa-check.1
new file mode 100644
index 000000000..67527230c
--- /dev/null
+++ b/man/glsa-check.1
@@ -0,0 +1,66 @@
+.TH "GLSA-CHECK" "1" "Aug 2019" "Portage VERSION" "Portage"
+.SH "NAME"
+.LP
+glsa\-check \- Gentoo: Tool to locally monitor and manage GLSAs
+.SH "SYNTAX"
+.LP
+glsa\-check <\fIoption\fP> [\fIglsa\-list\fP]
+
+[\fIglsa\-list\fR] can contain an arbitrary number of GLSA ids, filenames containing GLSAs or the special identifiers 'all' and 'affected'
+.SH "DESCRIPTION"
+.LP
+This tool is used to locally monitor and manage Gentoo Linux Security Advisories.
+Please read:
+.br
+http://www.gentoo.org/security
+.br
+before reporting a bug.
+.LP
+Note: In order for this tool to be effective, you must regularly sync your local portage tree.
+.SH "OPTIONS"
+.LP
+.TP
+.B \-l, \-\-list
+list the a summary for all GLSAs in glsa\-list and whether they affect the system
+.TP
+.B \-d, \-\-dump, \-\-print
+show all information about the GLSAs in glsa\-list
+.TP
+.B \-t, \-\-test
+test if this system is affected by the GLSAs in glsa\-list and output the GLSA IDs
+.TP
+.B \-p, \-\-pretend
+show the necessary steps to apply the GLSAs in glsa\-list
+.TP
+.B \-f, \-\-fix
+try to auto\-apply the GLSAs in in glsa\-list using emerge. This will only upgrade packages to later version, but not remove packages when no upgrade path exists (experimental)
+.TP
+.B \-i, \-\-inject
+inject the given GLSA into the glsa_injected file
+.TP
+.B \-n, \-\-nocolor
+disable colors (option)
+.TP
+.B \-h, \-\-help
+show this help message
+.TP
+.B \-V, \-\-version
+some information about this tool
+.TP
+.B \-v, \-\-verbose
+print more messages (option)
+.TP
+.B \-c, \-\-cve
+show CVE ids in listing mode (option)
+.TP
+.B \-q, \-\-quiet
+be less verbose and do not send empty mail (option)
+.TP
+.B \-m, \-\-mail
+send a mail with the given GLSAs to the administrator
+.SH "FILES"
+.LP
+.TP
+.B /var/lib/portage/glsa_injected
+List of GLSA ids that have been injected and will never show up as 'affected' on this system.
+The file must contain one GLSA id (e.g. '200804\-02') per line.

diff --git a/setup.py b/setup.py
index 156537a31..c71deb97f 100755
--- a/setup.py
+++ b/setup.py
@@ -38,7 +38,7 @@ import sys
 x_scripts = {
 	'bin': [
 		'bin/ebuild', 'bin/egencache', 'bin/emerge', 'bin/emerge-webrsync',
-		'bin/emirrordist', 'bin/portageq', 'bin/quickpkg',
+		'bin/emirrordist', 'bin/glsa-check', 'bin/portageq', 'bin/quickpkg',
 	],
 	'sbin': [
 		'bin/archive-conf', 'bin/dispatch-conf', 'bin/emaint', 'bin/env-update',

[gentoo-commits] proj/portage:master commit in: man/, /

[Sam James]

commit:     bbf7f53a970f9ee31830e1546d7c04997ea3463e
Author:     Sam James <sam <AT> gentoo <DOT> org>
AuthorDate: Mon Jul 18 20:20:56 2022 +0000
Commit:     Sam James <sam <AT> gentoo <DOT> org>
CommitDate: Mon Jul 18 20:22:04 2022 +0000
URL:        https://gitweb.gentoo.org/proj/portage.git/commit/?id=bbf7f53a

ebuild.5: update modified date

Signed-off-by: Sam James <sam <AT> gentoo.org>

 NEWS         | 2 ++
 man/ebuild.5 | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/NEWS b/NEWS
index 5e87b85d6..129416f50 100644
--- a/NEWS
+++ b/NEWS
@@ -36,6 +36,8 @@ Bug fixes:
 * ebuild(5): econf: drop --disable-dependency-tracking from "example"
   because it's confusing (implies it was always added, even before EAPI 4).
 
+* ebuild(5): modernize examples slightly.
+
 portage-3.0.32 (2022-07-11)
 --------------
 

diff --git a/man/ebuild.5 b/man/ebuild.5
index 91660660a..226b998e8 100644
--- a/man/ebuild.5
+++ b/man/ebuild.5
@@ -1,4 +1,4 @@
-.TH "EBUILD" "5" "May 2021" "Portage VERSION" "Portage"
+.TH "EBUILD" "5" "July 2022" "Portage VERSION" "Portage"
 
 .SH "NAME"
 ebuild \- the internal format, variables, and functions in an ebuild script

[gentoo-commits] proj/portage:master commit in: man/, /

[Sam James]

commit:     e799003581e49a3ba2aac0d49821f52ed6eda931
Author:     Sam James <sam <AT> gentoo <DOT> org>
AuthorDate: Wed Dec 14 04:57:57 2022 +0000
Commit:     Sam James <sam <AT> gentoo <DOT> org>
CommitDate: Wed Dec 14 05:03:15 2022 +0000
URL:        https://gitweb.gentoo.org/proj/portage.git/commit/?id=e7990035

man/make.conf.5: describe binpkg suffix

- BINPKG_FORMAT="xpak" has suffix .tbz2 for any compression type(!)
- BINPKG_FORMAT="xpak" and FEATURES="binpkg-multi-instance" (default
  as of bug #715112) has suffix .xpak.
- BINPKG_FORMAT="gpkg" has suffix .gpkg.

Bug: https://bugs.gentoo.org/696080
Bug: https://bugs.gentoo.org/715112
Bug: https://bugs.gentoo.org/721070
Bug: https://bugs.gentoo.org/885799
Signed-off-by: Sam James <sam <AT> gentoo.org>

 NEWS            |  3 +++
 man/make.conf.5 | 10 +++++++---
 2 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/NEWS b/NEWS
index 2fd09bbaa..4684487b3 100644
--- a/NEWS
+++ b/NEWS
@@ -12,6 +12,9 @@ Bug fixes:
 * etc-update: Apply defences for patsub_replacement being default on in Bash 5.2
   (bug #881383).
 
+* make.conf(5): Note the various file suffixes / file extensions used
+  for binary packages.
+
 portage-3.0.41 (2022-11-04)
 --------------
 

diff --git a/man/make.conf.5 b/man/make.conf.5
index 7f398c28e..ad8ece43f 100644
--- a/man/make.conf.5
+++ b/man/make.conf.5
@@ -114,12 +114,16 @@ ACCEPT_RESTRICT="* -bindist"
 .TP
 .B BINPKG_FORMAT
 This variable sets the format used for tar binary packages. Possible
-values are \fIxpak\fI or \fIgpkg\fI.
+values are \fIxpak\fI or \fIgpkg\fI.  If \fBBINPKG_FORMAT\fR is set to \fIxpak\fR,
+packages will have the file extension .tbz2 for any compression type for historical
+reasons.  If \fBBINPKG_FORMAT\fR is set to \fIxpak\fR, and FEATURES="binpkg-multi-instance"
+is set, packages will have the file extension .xpak.  If \fBBINPKG_FORMAT\fR is set
+to \fIgpkg\fR, packages will have the file extension .gpkg.
 .TP
 \fBBINPKG_COMPRESS\fR = \fI"compression"\fR
 This variable is used to determine the compression used for \fIbinary
-packages\fR. Supported settings and compression algorithms are: bzip2, gzip,
-lz4, lzip, lzop, xz, zstd.
+packages\fR.  Supported settings and compression algorithms are: bzip2, gzip,
+lz4, lzip, lzop, xz, zstd.  See note for \fBBINPKG_FORMAT\fR on file suffix.
 .br
 Defaults to "zstd".
 .br

[gentoo-commits] proj/portage:master commit in: man/, /

[Sam James]

commit:     bde7b6440c6cfbf87776e88fc22313dc0ebbc8ca
Author:     Philipp Rösner <rndxelement <AT> protonmail <DOT> com>
AuthorDate: Fri Jan 27 22:07:13 2023 +0000
Commit:     Sam James <sam <AT> gentoo <DOT> org>
CommitDate: Fri Feb  3 06:33:59 2023 +0000
URL:        https://gitweb.gentoo.org/proj/portage.git/commit/?id=bde7b644

portage(5): list volatile option as a separate entry

The volatile option was hidden in the sync-webrsync-verify-signature
entry. Add a separate entry for volatile, specifying its possible
values in the portage(5) man page.

Closes: https://bugs.gentoo.org/888585
Signed-off-by: Philipp Rösner <rndxelement <AT> protonmail.com>
Closes: https://github.com/gentoo/portage/pull/982
Signed-off-by: Sam James <sam <AT> gentoo.org>

 NEWS          | 2 ++
 man/portage.5 | 3 ++-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/NEWS b/NEWS
index b22d4e80f..d81d5823f 100644
--- a/NEWS
+++ b/NEWS
@@ -4,6 +4,8 @@ portage-3.0.45 (UNRELEASED)
 Bug fixes:
 * gpkg: Handle out-of-space errors (bug #891391).
 
+* portage(5): List volatile option as a separate entry (bug #888585).
+
 portage-3.0.44 (2023-01-15)
 --------------
 

diff --git a/man/portage.5 b/man/portage.5
index c2c92faaa..f722bfb1a 100644
--- a/man/portage.5
+++ b/man/portage.5
@@ -1260,7 +1260,8 @@ Keep snapshots in \fBDISTDIR\fR (do not delete). Defaults to no, false.
 Require the detached tarball signature to contain a good OpenPGP
 signature. This uses the OpenPGP key(ring) specified by the
 sync\-openpgp\-key\-path setting. Defaults to no, false.
-.B volatile
+.TP
+.B volatile = yes|no|true|false
 Specifies whether a repository is volatile.  Volatile repositories
 are assumed to contain changes made outside of Portage.  This prohibits
 optimizations from occurring by assuming the integrity of the repository