1HEADER_FILE_ONLY
2----------------
3
4Is this source file only a header file.
5
6A property on a source file that indicates if the source file is a
7header file with no associated implementation.  This is set
8automatically based on the file extension and is used by CMake to
9determine if certain dependency information should be computed.
10
11By setting this property to ``ON``, you can disable compilation of
12the given source file, even if it should be compiled because it is
13part of the library's/executable's sources.
14
15This is useful if you have some source files which you somehow
16pre-process, and then add these pre-processed sources via
17:command:`add_library` or :command:`add_executable`. Normally, in IDE,
18there would be no reference of the original sources, only of these
19pre-processed sources. So by setting this property for all the original
20source files to ``ON``, and then either calling :command:`add_library`
21or :command:`add_executable` while passing both the pre-processed
22sources and the original sources, or by using :command:`target_sources`
23to add original source files will do exactly what would one expect, i.e.
24the original source files would be visible in IDE, and will not be built.
25