Include What You Use

[HTRamsey]

Don't know if this is of any value to you guys, so close if not. But here are the results of running IWYU.

freertos_tcp_iwyu.txt

[tony-josi-aws]

@HTRamsey thanks for sharing this.

It would be great to have it included in the Github CI as a PR check as well to maintain it.

[HTRamsey]

I just added

if(CMAKE_C_COMPILER_ID STREQUAL "Clang")
    find_program(INCLUDE_WHAT_YOU_USE_PROGRAM include-what-you-use)
    if(INCLUDE_WHAT_YOU_USE_PROGRAM)
        set(CMAKE_C_INCLUDE_WHAT_YOU_USE ${INCLUDE_WHAT_YOU_USE_PROGRAM})
    endif()
endif()

[tony-josi-aws]

I tried applying the fixes that were generated (both locally as well as freertos_tcp_iwyu.txt) using IWYU fix_includes.py tool:
python3 ~/Tools/include-what-you-use/fix_includes.py < freertos_tcp_iwyu.txt

It seems like the build fails after applying the fixes because of missing macro definitions, mostly from header files that depended on other header files included in the same source files, as far as I checked.

[HTRamsey]

Might have to make the header files self contained using --check_also. There's also other stuff you can do in the documentation to fix some issues. But without some complex workflow set up for this, it might just be better to use it as a reference only and avoid the auto-fix.