Parsing Tasks from comments
Leaving comments during coding is a good way to make a note for the future: it could be an explanation of some part of code, or a reminder to refactor some code, implement additional checks and parts of the logic, or even fix bugs. The Welkin Suite allows you no to keep all these tasks in mind but accomplish them with the help of a special pad.
The Tasks list pad is a great way to track all your important comments in the project and provides you a clear interface to see all of them. To activate it, go to the Main Menu:
View ⇒ Pads ⇒ Tasks.
In this pad you can see a list of tasks from your code with the following details about each of them:
- Line — a line in the source file where the task is located,
- Description — a comment text in the line with a token,
- File — the file where the task is located,
- Path — a path to the file in your project structure.
Double-click on any of the tasks to immediately navigate to the corresponding line in the code.
FIX ME— the high priority tasks,
HACK— the normal priority tasks,
UNDONE— the low priority tasks.
To use any other token in your comments to highlight important tasks you can easily configure this in The Welkin Suite Menu:
Preferences ⇒ Environment ⇒ Tasks.
To add a new token in the Name text box type the text which you will use to identify a task, select a priority and press the Add button. In a similar way, you can modify any existing tokens: select it in the Token List, edit its name and press the Edit button or just press Remove if you don't need it anymore.
In the lower part of the configuration window, you can assign any color to the tasks priority, and they will be highlighted in the list with the given color.
Another option to add some tasks to your IDE is to switch to the User Tasks in the Tasks pad using a dropdown in the top part of the pad. Here you are able to manually create a task with a custom text and priority, however, such tasks won't be linked to a certain line in the code, just to the project itself. Once you complete a task, you can check it in the list and it will remain there completed. You can also delete the completed task with the Delete Task button.
User tasks are stored in the project folder in the file with the same name as your project and with the
.usertasks extension, so please take this into account if you want to store your project in the Git or other repositories.
In this section:
This also may be useful: