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>
288
288
symbol from it even if < code > foo.h</ code >
289
289
includes < code > bar.h</ code > .</ p >
290
290
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
+
291
301
< h3 id ="Forward_Declarations "> Forward Declarations</ h3 >
292
302
293
303
< p > Avoid using forward declarations where possible.
You can’t perform that action at this time.
0 commit comments