View source

You do not have permission to edit this page, for the following reason:

You can view and copy the source of this page:

Date: 21 FEB 2012 Author: Miloslav Metelka, Petr Somol = Editor Bookmarks Support in NetBeans = == Introduction - Current State == [[File:Bookmark.png|200px|thumb|right|Current state: Bookmark symbol is displayed to the left of the bookmarked line. Hovering mouse over displays a tooltip with always the same text 'Bookmark']] [[File:Bookmark_shared.png|200px|thumb|right|Current state: With more than one annotation per line only one is displayed. Clicking the black arrow cycles the annotation symbols (and shows possibly hidden bookmark symbol).]] [[File:Bookmark_popup.png|200px|thumb|right|Current state: Right-click on bookmark symbol opens the shared annotation menu. The bookmark submenu puts on show the three currently defined bookmark actions/shortcuts.]] Existing bookmarks support in NetBeans consists of three shortcuts: * '''Ctrl+Shift+M''' for Toggle Bookmark on current line in the currently focused document * '''Ctrl+Shift+Comma''' and '''Ctrl+Shift+Period''' for cycling through bookmarks back/forward in a currently focused document. The choice of these particular shortcuts is good from UEX point of view because the respective keys carry the symbols '''<''' and '''>''', what visually underpins the respective cycling directions. At the moment bookmark navigation is limited to a single file only. Bookmarks are unnamed. Any number of bookmarks can be set in each file, but no shortcuts to access particular bookmarks are provided, nor it is possible to cycle across file borders. There is no view/window available to get an overview over all existing bookmarks. == Bookmarks Storage == Bookmarks are physically stored in ''private.properties'' file inside a project in which the particular source file with the bookmark resides. This is generally a desirable approach however it means that the IDE always works with bookmarks from currently opened projects only. == Use-Cases and Scenarios To Be Addressed == === Navigation Across Files === Users need to navigate through bookmarks across files. Since a global list of bookmarks can become large it is desirable to have more navigation options than just cycle through previous/next bookmark. === Named Bookmarks === Some users demand to create named bookmarks which many editors support. But they also want to retain unnamed bookmarks which are faster to create and work with. === Bookmark Management === Users need to see a list of all bookmarks in a window (similarly like e.g. a list of all breakpoints). Bookmark window will enable quick navigation. Possibly it would provide also other bookmark management actions: various modes of view sorting/grouping (by name, by file, by project), renaming, search by name, enabling/disabling, adding/removing. = Bookmark Improvements Proposed for NetBeans 7.2 = == Updated Bookmark Definition == In addition to the current properties of a bookmark (''source-file'' and ''line-number'') the bookmark would newly have a ''name'' (auto-generated names "bookmark1", "bookmark2" etc. for unnamed bookmarks, may be renamed by user) and a ''keyboard shortcut'' consisting of a prefix shortcut '''Ctrl+J''' followed by a single digit or character '''[0-9a-z]'''. == Bookmark Manager == A Bookmark Manager window would behave similarly to windows docked usually under the main editor window, like Output, Breakpoints, etc. The Bookmark Manager would show all the currently navigable bookmarks (from all currently opened projects). On the left there would be a table showing each bookmark's properties: ''name'', ''shortcut'', ''source-file:line-number'' (tooltip would show full source path). On the right there would be a preview of the code where the bookmark is located. If a new bookmark was created by Ctrl+Shift+M the window would preselect it when invoked so that the user can easily turn the recently created unnamed bookmark to a named one. [[File:Bookmark_manager1.png|200px|thumb|none|Bookmark Manager in list view mode, should enable in-place editing of bookmark name and shortcut.]] [[File:Bookmark_manager2.png|200px|thumb|none|Bookmark Manager in tree view mode.]] == Updated Navigation Keyboard Shortcuts == * '''Ctrl+Shift+M''' toggles (add/delete) an ''unnamed'' bookmark on the current line. If applied to an existing ''named'' bookmark, the named bookmark is not immediately deleted but a confirmation messagebox is displayed first. * '''Ctrl+Shift+Comma''' and '''Ctrl+Shift+Period''' semantics would be changed to navigate in Bookmarks History which would be similar to Jump List navigation (or a browser navigation history). A bookmark would be added to bookmark history when it gets created (by toggling) or when it is navigated to explicitly either using direct shortcut (using "Ctrl+Shift+G") or from Navigator Window. * '''Ctrl+J then [0-9a-z]''' would navigate to a concrete bookmark. If no bookmark is assigned to the shortcut then a dialog would be displayed allowing a new bookmark creation. Remark: Releasing Ctrl after J has been pressed but before the final navigational key is pressed cancels the navigation. * '''Ctrl+Shift+J''' opens Bookmark Manager window. * '''Ctrg+G''' opens Go To dialog used so far for line number navigation only. The improved dialog should enable entering either a line number or a bookmark name Remark: The shortcuts '''Ctrl+J''' and '''Ctrl+Shift+J''' are so far unused and are suitable for bookmark navigation because the location of key J is just above M which has long been used to toggle bookmarks and the letter '''J''' suggests 'Jump to..'. == Improved Go To dialog == Currently the shortcut '''Ctrl+G''' opens the simple Go To dialog allowing to enter a line number to go to. The functionality should be extended to accept also bookmark names. The semantics can be kept simple: as long as the entered text is numeric only, it is interpreted as line number; when a [a-z] character appears, the text starts to be interpreted as bookmark, and the dialog shows a code-completion drop-down list with appropriate bookmark names as the user continues to type. To code-completion list should include both the valid bookmark names and the list of previous choices (including line numbers). Accordingly the dialog and its entry in Navigation menu would be renamed to Go To Line Or Bookmark. [[File:Goto.png|200px|thumb|none|Improved Go To dialog would enable entering line number or bookmark name.]] == Bookmark Line Annotation Symbol == The annotation symbol is used to mark lines with bookmarks in editor. When mouse over, it will show the bookmark name. Right-click will enable editing bookmark properties (changing name or shortcut) or opening Bookmark Manager with the current bookmark shown in it. == Bookmark Scope and Possible Conflicts == Bookmarks will be stored on a per-project basis. A conflict in name and shortcut may thus arise across opened projects. * Name conflicts can be resolved by using 'extended' names consisting of project-bookmark name. When defining the name in Bookmark Manager the name would turn red while typing as long as the name being typed is in conflict. * Conflict in shortcuts can be bypassed when navigating by automatically preferring the shortcut in closer scope (navigate to project in focus instead of other project). Additionally, repeated pressing of the same shortcut would cycle through conflicting bookmarks. When defining a shortcut for a bookmark the user can either ask for a free shortcut or can define a shortcut directly. If defining directly and the shortcut has been previously defined for a different bookmark in the same project, a confirmation/warning is displayed. If the shortcut exists already in another opened project, the definition is accepted but displayed in red. Bookmark Manager warns about conflicting names and/or shortcuts by showing them in red in the table; a tooltip would show conflicting bookmark description.

Return to EditorBookmarks72.