[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Documentation Bug in Parallel Execution Section
From: |
Isaac Dooley |
Subject: |
Documentation Bug in Parallel Execution Section |
Date: |
Thu, 21 Jun 2007 14:47:47 -0500 |
User-agent: |
Thunderbird 1.5.0.12 (X11/20070509) |
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- Documentation Bug in Parallel Execution Section,
Isaac Dooley <=