Difference between revisions of "Using Qt Creator TODO plugin"

From Mudlet
Jump to navigation Jump to search
(Created page with "The IDE that several Mudlet developers use for working on the project is the Qt Creator IDE. It has an add-on (it calls them "plugins") that is not installed by default but wh...")
 
 
Line 1: Line 1:
The IDE that several Mudlet developers use for working on the project is the Qt Creator IDE. It has an add-on (it calls them "plugins") that is not installed by default but which can help developers to find previous marked spots quickly which can enable one (or a group of) commonly edited spots to (all) be visited quickly, even if the relevant file is not currently opened within the project.
+
The IDE that several Mudlet developers use for working on the project is the Qt Creator IDE. It has an add-on (it calls them "plugins") that is not active by default but which can help developers to find previous marked spots quickly which can enable one (or a group of) commonly edited spots to (all) be visited quickly, even if the relevant file is not currently opened within the project.
  
To install it go to the Creator ''Help'' menu and select the ''About plugins...'' item:
+
== Activating ==
 +
To activate it go to the Creator ''Help'' menu and select the ''About plugins...'' item:
 +
 
 +
[[File:Qt_Creator_-_Help_menu_-_About_plugins_screenshot.png|Accessing the "About Plugins..." dialog|thumb|none]]
 +
 
 +
On the dialog that is displayed, scroll down to the Utilities section and locate the item called "Todo (experimental)" - if it is not set to be loaded (so is not available for use) it will have a red minus sign or other negative state mark to the left of the name and the check-box in the "Load" column will be cleared:
 +
 
 +
[[File:Qt Creator - Installed plugins - ToDo plugin not active screenshot.png|thumb|none]]
 +
 
 +
Check the box in the "Load" column and an advisory message saying "Restart required." will be shown on the bottom in the middle of the buttons. Click close and a choice will be offered to either "Restart Now" or "Later" - make the choice that is most convenient (which will probably depend on whether files are already in the middle of being edited!)
 +
 
 +
[[File:Qt Creator - Restart required after enabling-disabling a plugin.png|thumb|none]]
 +
== Using ==
 +
When Qt Creator has been (re)started there will be an extra numbered "To-Do Entries" item at the bottom of the application window which can be selected to show various predefined identifiers that can be embedded into the source code - clicking on an entry will open the relevant file at the associated point. The list shown can be sorted in several ways and clicking on one or more of the icons at the top of the window can be used to restrict the display to that type of entry:
 +
 
 +
[[File:Qt Creator - ToDo window screenshot.png|thumb|none]]
 +
 
 +
The entries are formed from C and C++ single line comments and are classified by the text (first word) that appears after the ''//'' comment delimiter. In Mudlet a couple have been used that do not appear in the predefined list of:
 +
 
 +
:* TODO
 +
:* NOTE
 +
:* FIXME
 +
:* BUG
 +
:* WARNING
 +
{TBD - the above needs verification by someone who's system has not used this feature before!}
 +
 
 +
A couple of extra entries have been used within the Mudlet project (including "'''PLACEMARKER'''" for some locations that need to be edited or have new code entered often) and those (or any other) can be changed via the '''Tools''' - '''Options''' menu:
 +
 
 +
[[File:Qt Creator - Options - ToDo screenshot.png|thumb|none]]
 +
 
 +
:''New entries added to this list do not get shown until the next time that Qt Creator is started!''

Latest revision as of 23:24, 30 December 2020

The IDE that several Mudlet developers use for working on the project is the Qt Creator IDE. It has an add-on (it calls them "plugins") that is not active by default but which can help developers to find previous marked spots quickly which can enable one (or a group of) commonly edited spots to (all) be visited quickly, even if the relevant file is not currently opened within the project.

Activating

To activate it go to the Creator Help menu and select the About plugins... item:

Accessing the "About Plugins..." dialog

On the dialog that is displayed, scroll down to the Utilities section and locate the item called "Todo (experimental)" - if it is not set to be loaded (so is not available for use) it will have a red minus sign or other negative state mark to the left of the name and the check-box in the "Load" column will be cleared:

Qt Creator - Installed plugins - ToDo plugin not active screenshot.png

Check the box in the "Load" column and an advisory message saying "Restart required." will be shown on the bottom in the middle of the buttons. Click close and a choice will be offered to either "Restart Now" or "Later" - make the choice that is most convenient (which will probably depend on whether files are already in the middle of being edited!)

Qt Creator - Restart required after enabling-disabling a plugin.png

Using

When Qt Creator has been (re)started there will be an extra numbered "To-Do Entries" item at the bottom of the application window which can be selected to show various predefined identifiers that can be embedded into the source code - clicking on an entry will open the relevant file at the associated point. The list shown can be sorted in several ways and clicking on one or more of the icons at the top of the window can be used to restrict the display to that type of entry:

Qt Creator - ToDo window screenshot.png

The entries are formed from C and C++ single line comments and are classified by the text (first word) that appears after the // comment delimiter. In Mudlet a couple have been used that do not appear in the predefined list of:

  • TODO
  • NOTE
  • FIXME
  • BUG
  • WARNING

{TBD - the above needs verification by someone who's system has not used this feature before!}

A couple of extra entries have been used within the Mudlet project (including "PLACEMARKER" for some locations that need to be edited or have new code entered often) and those (or any other) can be changed via the Tools - Options menu:

Qt Creator - Options - ToDo screenshot.png
New entries added to this list do not get shown until the next time that Qt Creator is started!