[distcc] Default job limits in distcc.1

[Jean Delvare]

Hi all,

It took me quite some time to figure out why "make CC=distcc -j5" with
DISTCC_HOSTS set to "localhost arrakis" would run 2 jobs on the local
machine and 3 jobs on the remote machine named "arrakis", when I would
have expected it the other way around.

Experiments revealed that the default job limit for localhost is 2, while
the limit for other hosts is 4. Reading the source code confirmed that.
The manual page doesn't mention the fact that localhost is handled
differently in that respect.

I think it would be great to mention this in distcc.1, so that newcomers
understand what happens. Below is a trivial patch doing just that
(hopefully my webmail client will not trash it).

Thanks,
Jean Delvare

--- distcc-2.16/man/distcc.1.orig	Mon May  3 02:37:10 2004
+++ distcc-2.16/man/distcc.1	Fri Jul 23 12:47:04 2004
@@ -292,9 +292,9 @@
 .B /LIMIT
 A decimal limit can be added to any host specification to restrict the
 number of jobs that this client will send to the machine.  The limit
-defaults to four per host, but may be further restricted by the
-server.  You should only need to increase this for servers with more
-than two processors.
+defaults to four per host (two for localhost), but may be further
+restricted by the server.  You should only need to increase this for
+servers with more than two processors.
 .TP
 .B ,lzo
 Enables LZO compression for this TCP or SSH host.