Documentation Bug in Parallel Execution Section

[Isaac Dooley]

The manual has a problem in its Parallel Execution section. It says the 
following:

   GNU |make| knows how to execute several commands at once. Normally,
   |make| will execute only one command at a time, waiting for it to
   finish before executing the next. However, the `-j' or `--jobs'
   option tells |make| to execute many commands simultaneously.

In actuality the parallel build option DOES execute multiple commands 
simultaneously, but it still respects the normal ordering of commands 
within a single rule. Your current explanation is misleading. I propose 
something like the rewritten form:

   GNU |make| knows how to execute several commands at once. Normally,
   |make| will execute only one command at a time, waiting for it to
   finish before executing the next. When the `-j' or `--jobs' option
   is used, it tells |make| to execute commands from different rules at
   the same time if their respective dependencies are already met. The
   usual ordering of commands within a single rule still holds.

Your current use of "Normally" and "however" is very confusing, even if 
semantically correct. Perhaps I am wrong and you in some cases reorder 
commands within a single rule. In this case the manual definitely should 
be modifed to reflect that case. Or possibly the use of the term 
"command" is overloaded and therefore ambiguous.

Cheers,
Isaac Dooley