(Linux users: use CTRL+RBUTTON instead of ALT+LBUTTON. More in the linux specific help.)

• the selected phrase, as the bookmark "title".
• the full line of the selected phrase. i.e. internally, dview also remembers the whole line from "long" until ")", to allow safer bookmark searches later.
• the filename in which the bookmark was defined.

Let's have another example text:

   void FooController::importantSubFunc()
   {
      printf("foo candy delivery just started\n");
   }

Just as above, bookmark the phrase from "Foo" until "Func".
Now you have two bookmarks:

   FooController::testBar(char *pszCandy
   FooController::importantSubFunc

Actually, "importantSubFunc" is a function called by "testBar".
To make this dependency clearer, it would be good if the
second bookmarks would be indented, like:

   FooController::testBar(char *pszCandy
      FooController::importantSubFunc

To achieve this,

• left click onto the 2nd bookmark, and keep left button pressed.
• then slowly move the mouse right or left.
• => the indentation is changed.

Or even better, click onto a bookmark, then move the mouse UP or DOWN while keeping the left button pressed.

-> the bookmark's position is changed, like:

FooController::importantSubFunc FooController::testBar(char *pszCandy

Click on the little "DEL" button at the right side of a bookmark to delete it.

example:

   -  you OPEN the directory

         C:\mydocs\letters

      then the bookmark filename is 

         C:\mydocs\zz-letters-bookmarks.1.dvbm

      so the bookmarks are parallel to that directory.

   -  after that, you APPEND the directory

         C:\otherdocs\diverse

      but the bookmark filename STILL is

         C:\mydocs\zz-letters-bookmarks.1.dvbm

      as only OPEN redefines the bookmark path.

   -  you OPEN the single file
   
         C:\mydocs\letters\hello.txt

      then the bookmark filename is

         C:\mydocs\letters\hello.txt.1.dvbm

      so the bookmarks are parallel to exactly that file.

   -  if you specified multiple directories to load text from,
      esp. during start from the command line,
      the first of those directories is taken to build
      the bookmark filename.

   -  if you load a single file, the bookmark filename
      is based on that filename.

There is an option "-book basename" available. For example:

dview -book mybooks thetextdir

will create bookmarks in the files

   mybooks.1.dvbm
   mybooks.2.dvbm
   mybooks.3.dvbm

   zz-thetextdir.1.dvbm
   zz-thetextdir.2.dvbm
   zz-thetextdir.3.dvbm