File: parser-cmake.rst

package info (click to toggle)
codelite 17.0.0%2Bdfsg-6
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 136,384 kB
  • sloc: cpp: 491,550; ansic: 280,393; php: 10,259; sh: 8,930; lisp: 7,664; vhdl: 6,518; python: 6,020; lex: 4,920; yacc: 3,123; perl: 2,385; javascript: 1,715; cs: 1,193; xml: 1,110; makefile: 805; cobol: 741; sql: 709; ruby: 620; f90: 566; ada: 534; asm: 464; fortran: 350; objc: 289; tcl: 258; java: 157; erlang: 61; pascal: 51; ml: 49; awk: 44; haskell: 36
file content (36 lines) | stat: -rw-r--r-- 1,106 bytes parent folder | download | duplicates (8) 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
 
.. _cmake:

======================================================================
CMake parser
======================================================================

The CMake parser is used for ``.cmake`` and ``CMakeLists.txt`` files.
It generates tags for the following items:

- User-defined functions
- User-defined macros
- User-defined options created by ``option()``
- Variables defined by ``set()``
- Targets created by ``add_custom_target()``, ``add_executable()`` and ``add_library()``

The parser uses the experimental multi-table regex ``ctags`` options to
perform the parsing and tag generation.

Caveats:

	Names that are ``${}`` references to variables are not tagged.

	For example, given the following::

	    set(PROJECT_NAME_STR ${PROJECT_NAME})
	    add_executable( ${PROJECT_NAME_STR} ... )
	    add_custom_target( ${PROJECT_NAME_STR}_tests ... )
	    add_library( sharedlib ... )

	...the variable ``PROJECT_NAME_STR`` and target ``sharedlib`` will both be tagged,
	but the other targets will not be.


References:

	https://cmake.org/cmake/help/latest/manual/cmake-language.7.html