File tree Expand file tree Collapse file tree 1 file changed +10
-0
lines changed Expand file tree Collapse file tree 1 file changed +10
-0
lines changed Original file line number Diff line number Diff line change @@ -288,6 +288,16 @@ <h3 id="Include_What_You_Use">Include What You Use</h3>
288288symbol from it even if < code > foo.h</ code >
289289includes < code > bar.h</ code > .</ p >
290290
291+ < p class ="drake "> < a name ="iwyu_exception "/>
292+ While we encourage you to Include What You Use (IWYU) since it improves code
293+ transparency and readability, it will not be strictly enforced. Instead, we
294+ enforce a “weak include” style that simply requires every symbol referenced
295+ within a file be covered by the transitive closure of all #include
296+ statements in the file. We decided to make this exception because (1) we can
297+ always adopt an IWYU rule later, (2) to reduce verbosity, and (3) we don’t
298+ have a tool to enforce IWYU at this time.
299+ </ p >
300+
291301< h3 id ="Forward_Declarations "> Forward Declarations</ h3 >
292302
293303< p > Avoid using forward declarations where possible.
You can’t perform that action at this time.
0 commit comments