On Sat, Feb 13, 2016 at 10:48:37PM -0800, Manoj Srivastava wrote: > Could you please provide a pointer to these docs, or any suggested wording > you might have? That'd save me some work.
http://make.mad-scientist.net/papers/jobserver-implementation/ provides full documentation. For the manpage, I'd suggest a few additions. First, the documentation for -j should add a sentence "When make invokes a sub-make, all instances of make will coordinate to run the specified number of jobs at a time; see PARALLEL MAKE AND THE JOBSERVER for details." Second, in the options section right after -j, add a single entry "--jobserver-fds R,W" "Internal option make uses to pass the jobserver pipe read and write file descriptor numbers to sub-makes; see PARALLEL MAKE AND THE JOBSERVER for details." Finally, the manpage should include that referenced section "PARALLEL MAKE AND THE JOBSERVER", giving a couple of paragraphs explaining the jobserver pipe (and interaction with '+', $(MAKE), and $(MAKEFLAGS)). This information should probably go in the relevant section of the info manual as well, but I care more about the manpage. - Josh Triplett
