add some clues for people who want to run full bulks

1 files changed, 28 insertions, 2 deletions

diff --git a/share/man/man7/ports.7 b/share/man/man7/ports.7
index b56a84b751d..1735f76aeab 100644
--- a/share/man/man7/ports.7
+++ b/share/man/man7/ports.7
@@ -23,10 +23,10 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.\" $OpenBSD: ports.7,v 1.90 2012/08/12 17:01:35 schwarze Exp $
+.\" $OpenBSD: ports.7,v 1.91 2012/12/24 13:58:53 espie Exp $
 .\" $FreeBSD: ports.7,v 1.7 1998/06/23 04:38:50 hoek Exp $
 .\"
-.Dd $Mdocdate: August 12 2012 $
+.Dd $Mdocdate: December 24 2012 $
 .Dt PORTS 7
 .Os
 .Sh NAME
@@ -423,6 +423,31 @@ normally as
 In particular, it can take advantage of machine clusters (same architecture
 and same installation), and of multi-core machines.
 .Pp
+A few remarks may save a lot of time
+.Bl -bullet
+.It
+The default limits in
+.Xr login.conf 5
+are inappropriate for bulk builds.
+.Ar maxproc , openfiles , datasize
+should be cranked way up, especially for parallel builds.
+For instance, a lot of C++-based ports will require a
+.Ar datasize
+over 1G.
+.It
+.Pa devel/jdk/1.6
+requires manually fetching distfiles, and setting up
+.Ev ACCEPT_JRL_LICENSE Ns = Ns Va Yes
+in
+.Pa /etc/mk.conf .
+Not building it will take out a sizeable chunk of the ports tree.
+.It
+cluster builds should have shared portsdir and local
+.Ev WRKOBJDIR .
+.It
+a full bulk will fetch over 20G of distfiles, create over 17G of packages.
+The largest work directories are about 10G each.
+.It
 Take notice of
 .Ev CHECKSUM_PACKAGES
 in
@@ -435,6 +460,7 @@ At the end of the build, just
 .Bd -literal -offset indent
 cd ${PORTSDIR}/packages/${MACHINE_ARCH}/cksums && cat * >sha256
 .Ed
+.El
 .Sh NETWORK CONFIGURATION
 The variables pertaining to network access have been marshalled into
 .Pa ${PORTSDIR}/infrastructure/templates/network.conf.template .