From 4960dbf427c090fa03ed4d1bfa1966bc0d668ae4 Mon Sep 17 00:00:00 2001 From: Zac Medico Date: Tue, 15 Jul 2008 23:19:16 +0000 Subject: [PATCH] Add some cross references between emerge's new parallel build options and MAKEOPTS. svn path=/main/trunk/; revision=11063 --- man/emerge.1 | 4 ++++ man/make.conf.5 | 6 ++++-- pym/_emerge/help.py | 9 ++++++++- 3 files changed, 16 insertions(+), 3 deletions(-) diff --git a/man/emerge.1 b/man/emerge.1 index fdf94c13c..bc9a7efc8 100644 --- a/man/emerge.1 +++ b/man/emerge.1 @@ -335,6 +335,10 @@ the related \fB\-\-skipfirst\fR option. .BR \-\-load\-average=LOAD Specifies that no new builds should be started if there are other builds running and the load average is at least LOAD (a floating-point number). +This option is recommended for use in combination with \fB\-\-jobs\fR in +order to avoid excess load. See \fBmake\fR(1) for information about +analogous options that should be configured via \fBMAKEOPTS\fR in +\fBmake.conf\fR(5). .TP .BR "\-\-newuse " (\fB\-N\fR) Tells emerge to include installed packages where USE flags have changed since diff --git a/man/make.conf.5 b/man/make.conf.5 index 2fa95f724..b3dc3c49d 100644 --- a/man/make.conf.5 +++ b/man/make.conf.5 @@ -378,8 +378,10 @@ package. Use this variable if you want to use parallel make. For example, if you have a dual\-processor system, set this variable to "\-j2" or "\-j3" for enhanced build performance with many packages. Suggested settings are -between \fICPUs+1\fR and \fI2*CPUs+1\fR. -For more information, see \fBmake\fR(1). +between \fICPUs+1\fR and \fI2*CPUs+1\fR. In order to avoid +excess load, the \fB\-\-load\-average\fR option is recommended. +For more information, see \fBmake\fR(1). Also see \fBemerge\fR(1) for +information about analogous \fB\-\-jobs\fR and \fB\-\-load\-average\fR options. .TP \fBNOCOLOR\fR = \fI["true" | "false"]\fR Defines if color should be disabled by default. diff --git a/pym/_emerge/help.py b/pym/_emerge/help.py index 756f9156b..bf6a13834 100644 --- a/pym/_emerge/help.py +++ b/pym/_emerge/help.py @@ -319,7 +319,14 @@ def help(myaction,myopts,havecolor=1): desc = "Specifies that no new builds should " + \ "be started if there are other builds " + \ "running and the load average is at " + \ - "least LOAD (a floating-point number)." + "least LOAD (a floating-point number). " + \ + "This option is recommended for use " + \ + "in combination with --jobs in " + \ + "order to avoid excess load. See " + \ + "make(1) for information about " + \ + "analogous options that should be " + \ + "configured via MAKEOPTS in " + \ + "make.conf(5)." for line in wrap(desc, desc_width): print desc_indent + line print -- 2.26.2