summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorZac Medico <zmedico@gentoo.org>2007-10-19 22:33:57 +0000
committerZac Medico <zmedico@gentoo.org>2007-10-19 22:33:57 +0000
commiteaa60cb097683a80eeabdb2140a7a88302e6c288 (patch)
tree15f558dacac1bc3900c7bc176cd24941489c5ab1
parent7f3db57c5feb631f6ff45b40ec45f1721e144a1c (diff)
downloadportage-eaa60cb097683a80eeabdb2140a7a88302e6c288.tar.gz
portage-eaa60cb097683a80eeabdb2140a7a88302e6c288.tar.bz2
portage-eaa60cb097683a80eeabdb2140a7a88302e6c288.zip
Bug #196435 - Add some more references to quickpkg(1) since
sometimes people don't realize that it exists. svn path=/main/trunk/; revision=8185
-rw-r--r--man/emerge.16
-rw-r--r--man/make.conf.54
-rw-r--r--pym/_emerge/help.py20
3 files changed, 22 insertions, 8 deletions
diff --git a/man/emerge.1 b/man/emerge.1
index 047677242..20f954cd6 100644
--- a/man/emerge.1
+++ b/man/emerge.1
@@ -222,9 +222,10 @@ buffer is not cleared prior to the prompt, so an accidental press of the
Tells emerge to build binary packages for all ebuilds processed in
addition to actually merging the packages. Useful for maintainers
or if you administrate multiple Gentoo Linux systems (build once,
-emerge tbz2s everywhere). The package will be created in the
+emerge tbz2s everywhere) as well as disaster recovery. The package
+will be created in the
\fI${PKGDIR}/All\fR directory. An alternative for already\-merged
-packages is to use \fBquickpkg\fR which creates a tbz2 from the
+packages is to use \fBquickpkg\fR(1) which creates a tbz2 from the
live filesystem.
.TP
.BR "\-\-buildpkgonly " (\fB\-B\fR)
@@ -664,6 +665,7 @@ Contains the default variables for the build process. \fBDo not edit
this file\fR.
.SH "SEE ALSO"
.BR "emerge \-\-help",
+.BR quickpkg (1),
.BR ebuild (1),
.BR ebuild (5),
.BR make.conf (5),
diff --git a/man/make.conf.5 b/man/make.conf.5
index 9915f4980..97e5b30b4 100644
--- a/man/make.conf.5
+++ b/man/make.conf.5
@@ -143,7 +143,9 @@ not \fIassume\-digests\fR is enabled. The \fBebuild\fR(1) \fBdigest\fR command
has a \fB\-\-force\fR option that can be used to force regeneration of digests.
.TP
.B buildpkg
-Binary packages will be created for all packages that are merged.
+Binary packages will be created for all packages that are merged. Also see
+\fBquickpkg\fR(1) and \fBemerge\fR(1) \fB\-\-buildpkg\fR and
+\fB\-\-buildpkgonly\fR options.
.TP
.B buildsyspkg
Build binary packages for just packages in the system set.
diff --git a/pym/_emerge/help.py b/pym/_emerge/help.py
index 5bb93a1f4..4c7505da1 100644
--- a/pym/_emerge/help.py
+++ b/pym/_emerge/help.py
@@ -21,6 +21,11 @@ def shorthelp():
print bold("Actions:")+" [ "+green("--clean")+" | "+green("--depclean")+" | "+green("--prune")+" | "+green("--regen")+" | "+green("--search")+" | "+green("--unmerge")+" ]"
def help(myaction,myopts,havecolor=1):
+ # TODO: Implement a wrap() that accounts for console color escape codes.
+ from textwrap import wrap
+ desc_left_margin = 14
+ desc_indent = desc_left_margin * " "
+ desc_width = 80 - desc_left_margin - 5
if not myaction and ("--verbose" not in myopts):
shorthelp()
print
@@ -184,11 +189,16 @@ def help(myaction,myopts,havecolor=1):
print " time prior to the prompt will be interpreted as a choice!"
print
print " "+green("--buildpkg")+" ("+green("-b")+" short option)"
- print " Tell emerge to build binary packages for all ebuilds processed"
- print " (in addition to actually merging the packages. Useful for"
- print " maintainers or if you administrate multiple Gentoo Linux"
- print " systems (build once, emerge tbz2s everywhere) as well as disaster"
- print " recovery."
+ desc = "Tells emerge to build binary packages for all ebuilds processed in" + \
+ " addition to actually merging the packages. Useful for maintainers" + \
+ " or if you administrate multiple Gentoo Linux systems (build once," + \
+ " emerge tbz2s everywhere) as well as disaster recovery. The package" + \
+ " will be created in the" + \
+ " ${PKGDIR}/All directory. An alternative for already-merged" + \
+ " packages is to use quickpkg(1) which creates a tbz2 from the" + \
+ " live filesystem."
+ for line in wrap(desc, desc_width):
+ print desc_indent + line
print
print " "+green("--buildpkgonly")+" ("+green("-B")+" short option)"
print " Creates a binary package, but does not merge it to the"