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

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

[Mike Frysinger]

commit:     3fb265e0863689e3e352fc6abcedc77a262323f2
Author:     Mike Frysinger <vapier <AT> gentoo <DOT> org>
AuthorDate: Wed Jun 15 04:55:06 2016 +0000
Commit:     Mike Frysinger <vapier <AT> gentoo <DOT> org>
CommitDate: Wed Jun 15 04:55:06 2016 +0000
URL:        https://gitweb.gentoo.org/proj/portage-utils.git/commit/?id=3fb265e0

man: drop qfile --from docs

URL: https://bugs.gentoo.org/573574
Reported-by: Rick Farina <zerochaos <AT> gentoo.org>

 man/include/qfile-04-from.include | 61 ---------------------------------------
 1 file changed, 61 deletions(-)

diff --git a/man/include/qfile-04-from.include b/man/include/qfile-04-from.include
deleted file mode 100644
index 47652bb..0000000
--- a/man/include/qfile-04-from.include
+++ /dev/null
@@ -1,61 +0,0 @@
-.SH "READING ARGUMENTS FROM A FILE/STDIN"
-.PP
-When you try to launch \fBqfile\fP with a large number of arguments, you may
-hit the following shell error:
-.nf\fI
-	$ qfile -o $(find /usr/lib)
-	bash: ./qfile: Argument list too long
-.fi
-.PP
-To avoid that, you must use the \fB\-\-from\fP (\fB\-f\fP) option, which
-allows reading your arguments list in a file:
-.nf\fI
-	$ find /usr/lib > ~/usr-lib.list
-	$ qfile -o -f ~/usr-lib.list
-	/usr/lib/libMagick-5.5.7-Q16.so.0.0.0
-	/usr/lib/libGL.so
-	...
-.fi
-.PP
-Your arguments list must be formatted with one file per line, and without any
-kind of garbage (no leading or trailing space, no empty line, etc.).  The 
-default \fBfind\fP output format is just fine in general.
-.PP
-You can also read the arguments list from standard input with the "\fB\-\fP" 
-pseudo filename, which is useful with shell pipes:
-.nf\fI
-	$ find /usr/lib | qfile -o -f -
-	/usr/lib/libMagick-5.5.7-Q16.so.0.0.0
-	/usr/lib/libGL.so
-	...
-.fi
-.PP
-Here is an other example of use.  This script lists some files which may be
-orphan config files left behind by Portage after uninstallation or upgrade of 
-some packages:
-.nf\fI
-	#!/bin/bash
-	SEARCH_PATHS="$(portageq envvar CONFIG_PROTECT)"
-	SEARCH_MASK="$(portageq envvar CONFIG_PROTECT_MASK) \\
-		/etc/runlevels /etc/portage \\
-		/etc/ssl/certs /etc/ssh \\
-		/etc/bash_completion.d /etc/cups"
-	for path in ${SEARCH_MASK} ; do
-		EXCLUDE="${EXCLUDE} -not -path ${path}/*"
-	done
-	set -f
-	find ${SEARCH_PATHS} ${EXCLUDE} | qfile -o -f -
-.fi
-.PP
-\fBIMPORTANT:\fP this script is just a quick example.  Do not blindly delete the
-files it will list!
-.PP
-When reading arguments from a file or from stdin, \fBqfile\fP will, for
-performances reasons, treat then by groups of 5000 (search owners of the
-5000 first files, then of the 5000 following ones, etc.).  This magic value
-should be fine in most cases, but you can change it if you really want, using
-the \fB\-\-max\-args\fP option (\fB\-m\fP).  Using a greater value will eat a
-bit more memory, but may be a bit faster for really big queries.  Be careful
-though, using some stupidly high or low value can completly kill the
-performances.  In short, you probably don't want to touch this option.
-.PP

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

[Fabian Groffen]

commit:     b7e95e98e237fed7ae4a78698cec0c42adf22f30
Author:     Fabian Groffen <grobian <AT> gentoo <DOT> org>
AuthorDate: Mon Apr  2 17:39:01 2018 +0000
Commit:     Fabian Groffen <grobian <AT> gentoo <DOT> org>
CommitDate: Mon Apr  2 17:39:01 2018 +0000
URL:        https://gitweb.gentoo.org/proj/portage-utils.git/commit/?id=b7e95e98

typo

 man/include/qfile-05-collisions.include | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man/include/qfile-05-collisions.include b/man/include/qfile-05-collisions.include
index dcf0e49..1b8672d 100644
--- a/man/include/qfile-05-collisions.include
+++ b/man/include/qfile-05-collisions.include
@@ -9,7 +9,7 @@ takes one argument, which can be a package name (\fBbash\fP or
 packages (ie., comparing the contents of one package with the contents of all 
 the others).
 .PP
-For example, the following script will search collisions beetween all your 
+For example, the following script will search collisions between all your
 installed packages. Be careful, this will takes time:
 .nf\fI
 	#!/bin/bash

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

[Fabian Groffen]

commit:     d99b6860d44ea074840f804dd788b9c3a801ee11
Author:     Fabian Groffen <grobian <AT> gentoo <DOT> org>
AuthorDate: Sat Jan 18 13:48:07 2020 +0000
Commit:     Fabian Groffen <grobian <AT> gentoo <DOT> org>
CommitDate: Sat Jan 18 13:48:07 2020 +0000
URL:        https://gitweb.gentoo.org/proj/portage-utils.git/commit/?id=d99b6860

man: add missing include file for q options

Signed-off-by: Fabian Groffen <grobian <AT> gentoo.org>

 man/include/q.optdesc.yaml | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/man/include/q.optdesc.yaml b/man/include/q.optdesc.yaml
new file mode 100644
index 0000000..cde6eed
--- /dev/null
+++ b/man/include/q.optdesc.yaml
@@ -0,0 +1,14 @@
+overlays: |
+    Print available overlays (read from repos.conf).  Use \fI-v\fR to
+    see the source (file) where the overlay was declared.
+envvar: |
+    Print used environment variables and found values.  Use \fI-v\fR to
+    see the source (file, environment) where the variable was declared.
+    Additional arguments are treated as variable names to print the
+    values for.  If just one name is given, only the value is printed if
+    matched.  When no arguments or more than one argument is given, the
+    variable name and the value is printed as a shell-style declaration.
+masks: |
+    Print the masks from package.mask files found.  Use \fI-v\fR to see
+    the source (file) where the mask was declared.  Additional arguments
+    are treated as atom selectors which must match the masks.