De Mark User Manual
User Manual: Pdf
Open the PDF directly: View PDF 
.
Page Count: 4
| Download | |
| Open PDF In Browser | View PDF |
The Official DeMark User Manual Team DeFacto-UW: Andrew Tran, Tony Vo, Tuan Ma, Jeff Xu, Lemei Zhang April 17, 2018 1 Introduction Debugging plays an important role in software engineering and can be very time-consuming. One common way for a developer to debug through their code is with the use of print statements, but it can be a tedious task to manage them. DeMark is a plugin for the IntelliJ IDEA that is used to keep track of temporary debug code. It aims to increase software developers’ programming productivity by facilitating the management of temporary code. 2 Installation The following instruction is a modified version of the official IntelliJ help documentation on the JetBrains website[1] : 1. Press [Ctrl + Alt + S] or choose File | Settings (for Windows and Linux or IntelliJ IDEA | Preferences (for macOS) from the main menu, then go to Plugins. 2. Click the Install JetBrains plugin or the Browse repositories button. 3. In the dialog that opens, search for the plugin by typing “DeMark” into the search bar. Right-click the plugin labled “DeMark” and select Download and Install. 4. Confirm your intention to download and install DeMark. 5. Close the plugin window and click OK in the Settings dialog. 6. Restart IntelliJ IDEA. DeMark will appear as a drop down menu on the top tool bar. There will also be a toggle button next to the quick tools area. 1 3 Using DeMark 3.1 Mark and Unmark Marking a line will highlight the line and put a check mark next to its line number. There are two ways to mark a line: • Click on the line number located to the right of the code editor of the line you want to mark. • Place the cursor on the line you want to mark and press [Alt + M]. Unmarking a line will remove the highlight on the line and the check mark next to its line number. There are two ways to unmark a line: • Click on the line number located to the right of the code editor of the currently marked line. • Place the cursor on the marked line you want to unmark and press [Alt + M]. For specific behaviors of marking and unmarking, please refer to section 4.1 on page 3. 3.2 Clear and Unclear Clear will clear all currently marked lines from the current file. There are two ways to clear all marked lines: • Choose DeMark | Clear in the toolbar. • Press [Alt + D + D]. Unclear will restore all previously cleared line for a file. There are two ways to unclear all previously cleared lines: • Choose DeMark | Unclear • Press [Alt + Shift + D + D] For specific behaviors of clear and unclear, please refer to section 4.2 on page 3. 3.3 Toggle The Toggle feature will allow the user to comment/uncomment all the marked lines at a time. • When the toggle is off, the marked lines will be commented out so that they will not be executed on runtime. • When the toggle is switched to on, all the marked lines that are commented out will be uncommented. For specific behaviors of toggle, please refer to section 4.3 on page 3. 3.4 Display Display allows the user to view all marked lines in a file from a more project overview level by only displaying the marked lines along with a range of lines above and below to provide context: • Choose DeMark | Display in the toolbar. For specific behaviors of display, please refer to section 4.4 on page 4. 2 4 Specific Behaviors of Functionality 4.1 Marking and unmarking: • Marked lines will have a description that says “DeMark.” • Marking and unmarking can only be done in IntelliJ and the marked lines will not show up in other text editors or IDEs. • Lines written in other files and marked using other IDEs will not show up as marked in IntelliJ but the line will still be there. • Lines deleted in other IDEs or text editor will have the correct behavior as deleted in IntelliJ as well. This will also remove the mark for said line. 4.2 Clearing and unclearing: • Clearing will remove all marked lines from the current file, regardless of whether the file is commented or not. • Clearing will not clear lines that are not shown as marked by “DeMark.” This means that bookmarks made for other purposes will not be removed. • Clearing when there are no marked lines will produce no effect. • Unclearing will restore all lines that were removed by the most recent clear function to the current file. • Unclearing will not restore lines that were not removed by the clear function. This includes lines that were manually deleted by the user in IntelliJ, another text editor, or IDE; and lines that were deleted by other plugins or extensions. • Unclearing multiple clears in a row will restore the most recent clear, the second most recent clear, and so on. • Lines that are added and marked after clear will be removed by clear. • Lines that are added and marked after clear will not be removed by unclear. 4.3 Toggle Because toggling will put the plugin into two separate states, each state will have their own specific behaviors with some overlapping features. 4.3.1 Both states of toggle: • Lines would still be able to be individually uncommented. • Lines would still be able to be manually deleted. • Lines deleted in other text editors or IDEs will still be represented correctly as deleted. 4.3.2 “Off ” state: • Marked lines that were already commented will gain an extra level of comment. This is similar to saying that the line will be commented twice. • Marked lines that were commented will still be editable. 3 • Clearing and unclearing during this state is not permitted. • Marking and unmarking in this state is permitted. 4.3.3 “On” state: • Marked lines having more than one level of comment will lose one level. • Marked lines that were uncommented during “off” state will stay uncommented. • Clearing and unclearing in this state is permitted. • Marking and unmarking in this state is permitted. 4.4 Display: • Only marked lines for the current file will be displayed. • Display will provided 3 extra lines of code above and below marked lines for context purposes. • Displayed lines will be read-only. This includes the inability to mark, unmark, insert, or delete. References [1] Installing, updating and uninstalling repository plugins. Available at https://www.jetbrains. com/help/idea/installing-updating-and-uninstalling-repository-plugins.html. 4
Source Exif Data:
File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.5 Linearized : Yes Create Date : 2018:04:19 19:27:16Z Creator : TeX Modify Date : 2018:04:19 19:27:16Z PTEX Fullbanner : This is pdfTeX, Version 3.14159265-2.6-1.40.18 (TeX Live 2017) kpathsea version 6.2.3 Producer : pdfTeX-1.40.18 Trapped : False Page Count : 4EXIF Metadata provided by EXIF.tools