Bookmarks
Bookmarks
Bookmarks are useful for remembering locations of interest in your files. Bookmarks are accessed and managed from the Bookmark Window panel. The vertical scrollbar and Overiew scroller also indicate bookmarks.
The Bookmark Panel is a floating, dock-able window that shows the current list of bookmarks. The Book-
mark
command activates the Bookmark Window. See “Bookmark” on page 158.
A bookmark points to a particular line position in a file. Each bookmark has a name, and specifies a file and line number. The Bookmark window also displays the function or symbol where the mark is located.
The Bookmark Window has functions for adding, deleting, saving, and loading bookmarks. See “Bookmark
Window” on page 158.
Setting a Bookmark
To set a new bookmark, do one of the following:
•
Use the Bookmark command (Ctrl+M), or
•
Right-click in the selection bar area in the far left margin, and select Bookmark...
The Bookmark Window will open.
You can press Enter and Source Insight will assign a single letter name to the bookmark and add a new bookmark. Or, you can type a meaningful name and press Enter.
You can also type the name of an existing bookmark and press Enter to jump to that bookmark. There are
other keyboard shortcuts available in the Bookmark Window. See “Bookmark Window” on page 158.
100 Source Insight 4 User Guide
Bookmarks
Bookmark Storage
Bookmarks are saved in a special file named booksmarks.xml, so they are preserved from session to session. Each project has its own bookmarks.xml file located in the project data directory. Each bookmark is saved as a line offset relative to a symbol declaration, such as a function. This helps to maintain the bookmarks if the original file is edited outside of Source Insight.
Bookmarks are maintained as you edit your files. For example, if you set a mark on a particular line, and then insert lines before that one, the mark will still be on the original line of text, even though the actual line number may have changed. If the line that the mark is set at is deleted, then the mark is deleted also.
FTP Bookmarks
Bookmarks can also point to a file on an FTP host. If you used the FTP Panel to open a file and set a bookmark in that file, then the bookmark will remember the FTP Site name and directory so you can open the file again.
However, this requires that the FTP Site is defined in the FTP Panel. If you set a bookmark, and later delete
the FTP Site from the Site List of the FTP Panel, then the bookmark will not work anymore. See “FTP
Browser” on page 215.
Source Insight 4 User Guide 101