[cmake-developers] How to use JOB_POOLS?

[Dave Abrahams]

Hi all,

I'm finding that the documentation for JOB_POOLS is... sparse, to say
the least.  I understand the principle at work, but it's really unclear
how JOB_POOL_LINK and JOB_POOL_COMPILE are supposed to work when set
per-target.  When set globally, it's clear that JOB_POOL_COMPILE is
supposed to affect “compilation” targets (which I presume means
compilation of languages that CMake knows about?) while JOB_POOL_LINK is
supposed to affect link targets (a little more constrained; I think
CMake knows about most linkers) but what about custom targets?  I have
lots of those and their compilations can't be distributed with distcc.
Can they be assigned to job pools?

Can anyone explain this stuff?

Thanks,
Dave

P.S. Someone should build up an example that illustrates how this all works.