DOCS: Clarification of "compilation_mode" as "-c"
RELNOTES: None
@@ -456,7 +456,8 @@ Package path elements may be specified in three formats:
<h4 id='flag--compilation_mode'><code class='flag'>--compilation_mode (fastbuild|opt|dbg)</code> (-c)</h4>
<p>
- This option takes an argument of <code>fastbuild</code>, <code>dbg</code>
+ The <code class="flag">--compilation_mode</code> option (often shortened to <code>-c</code>,
+ especially <code>-c opt</code>) takes an argument of <code>fastbuild</code>, <code>dbg</code>
or <code>opt</code>, and affects various C/C++ code-generation
options, such as the level of optimization and the completeness of
debug tables. Bazel uses a different output directory for each
