CLion 2019.1 Help

TODO comments

Sometimes, you need to mark parts of your code for future reference: areas of optimization and improvement, possible changes, questions to be discussed, and so on. CLion lets you add special types of comments that are highlighted in the editor, indexed, and listed in the TODO Tool Window. This way you and your teammates can keep track of issues that require attention.

Example of TODO comment

By default, there are two patterns recognized by CLion: TODO and FIXME in both lower and upper case. These patterns can be used inside line and block comments of any supported filetype. You can modify the default patterns or add your own patterns if necessary.

To create a multiline TODO item, indent the comment lines that follow the initial line. Without the indent, lines are treated as regular comment lines. To disable multiline TODO items, open the Settings / Preferences dialog (Ctrl+Alt+S), then go to Editor | TODO and clear the Treat the indented text on the following lines as part of the same TODO checkbox.

You can view all the available TODO items in the TODO tool window (View | Tool Windows | TODO or Alt+6). To jump to the location of the relevant comment in the source code, double-click the corresponding TODO item in the TODO tool window. To automatically jump to the location of the relevant comment every time you select the corresponding TODO item, right-click the TODO tool window title bar, point to View Options, and select Autoscroll to Source (this option is enabled by default).

Add custom patterns and filter TODO items

You can add your own patterns and filter the list to show only TODO items that match certain patterns. For example, you can choose to mark places of possible optimization in your code with the OPTIMIZE pattern and ignore all other types of TODO items when viewing them in the TODO tool window:

  1. In the Settings/Preferences dialog (Ctrl+Alt+S), select Editor | TODO.

  2. Use the regular expression to specify a custom pattern: \b<pattern string>\b.*. To add a pattern for the OPTIMIZE items, click the Add icon (Add) in the Patterns section of the TODO dialog, and type the following regular expression:


    Then click OK to save the new pattern.

  3. To add a filter with the new pattern, click the Add icon (Add) in the Filters section of the TODO dialog, specify a name for the new filter (for example, Optimization), and select the new pattern to be included in this filter.

    Then click OK to save the new filter.

  4. Click OK to apply the changes in the TODO settings dialog.

  5. To apply the new filter, in the TODO tool window, click the Filter TODO Items icon (Filter TODO Items) and select the Optimization filter.

Last modified: 24 July 2019