docs: document balancing cores and max-jobs#2749
Conversation
| <listitem><para> | ||
| Dictates how many separate derivations will be built at the same | ||
| time. If you set this to zero, the local machine will attempt to | ||
| do no builds (forcing it to be built remotely.) |
There was a problem hiding this comment.
will attempt to do no build -> will do no builds.
| <listitem><para> | ||
| Dictates how many cores each derivation is allowed to use. If | ||
| you set this to zero, the builds will be given access to all the | ||
| cores of your system. |
There was a problem hiding this comment.
"Dictates" -> "suggests" (and drop the second sentence). There is nothing that stops a derivation from using more cores. In practice, the "cores" option translates to GNU Make's -j <cores> flag.
| </tbody> | ||
| </table> | ||
|
|
||
| <para>It is up to the derivations' build scirpt to respect |
|
ping @grahamc I still think this is really valuable, and would love to have it in the manual :) |
a9e32d3 to
3601b8a
Compare
|
Thanks @jonringer, I've updated the docs and addressed @edolstra's feedback. Would you might giving it a read for mistakes? I have a tendency to make silly mistakes :x |
jonringer
left a comment
There was a problem hiding this comment.
Even though English is my first language, i still struggle greatly with it as well :).
Looks good to me, except i think there's an extra newline added accidentally.
| <xi:include href="cores-vs-jobs.xml" /> | ||
| <xi:include href="diff-hook.xml" /> | ||
|
|
||
|
|
There was a problem hiding this comment.
Extra white space? I don't see 2 newlines anywhere else.
e92c925 to
b33b434
Compare
b33b434 to
cf6172f
Compare
Write a bit about the balance between max-jobs and cores.