To search any word, JUST TYPE IT. Whatever you type goes into the "find mask", and when you stop typing, it is searched for instantly. Press Left/Right/Home/End to move the cursor within the mask, and INSERT to clear it. The * wildcard and operators AND OR NOT are supported. For example,

   class *bar* obj OR warn NOT goo

To search the * character itself, type **, e.g. "/** foo" actually finds "/* foo".

F1: FULLSCREEN MODE ON/OFF   F5: reload changed files                          
F2: horizontal tiling on/off F6: hide all windows                              
F3: swap with previous view  F8: show help
F4: case-sensitive search    F12: open document                                
F3+SHIFT: swap with next     F3+CTRL: copy view to left

Fullscreen versus multi column mode:

To repeat, dview is optimized for searching, and not for endless fondling-around with window borders. Therefore the dview surface has a fixed-window layout:

• Depeche View starts in Full Screen Mode, displaying a large, single window, covering nearly the whole screen. In this mode, you have maximum overview of a single text spot.
   
• as soon as you press the right mouse button on blank space, dview enters the multi column mode, displaying two or three columns side by side. In this mode, you have a comparison overview of up to three spots of text.
   
• switch anytime between these two modes by pressing F1.
   

  <- F1 ->

  
   
• whenever you press the right mouse button, an event is sent to a nearby view (window), e.g. to activate the view, or to search something. if no nearby view exists yet, one is created.

CTRL+(SHIFT+)Home: jump to previous file (or top of all)
CTRL+(SHIFT+)End : jump to next file  (or bottom of all)
SHIFT+LEFT/RIGHT : horizontal motion  (ENTER to reset  )
CTRL+TAB to change tab size (set DVIEW_CONFIG=tabsize:n)
ESCAPE to close latest view, or all, if in first view.  
SHIFT+ESCAPE always closes all views, then exits.       

All ways of searching summarized:

• search a single word shown in the text:
  shift+click on it. it will be searched for immediately.
   
• searching a phrase shown in the text:
  • press SHIFT and keep it pressed.
  • click on the first character or word of interest.
  • click on the last character or word of interest,
    which must be in the same line as the first one.
  • release the SHIFT key.
  • dview will instantly search the whole phrase.
  
  
• typing word(s): simply start typing characters - they go into the find mask. when finished, just stop typing. your word or phrase will be searched for immediately.
   
• using a phrase from the clipboard: if you have a phrase in the clipboard, press SHIFT+INSERT to have it pasted into the find mask. it will be searched for immediately.

Filtered views:

Press CTRL+A to create a filtered view from the current search mask:

Bookmark creation, deletion, and copying to clipboard:

If you found important places within text files, it makes sense to remember them. but you don't have to do this - let the tool remember them for you, through bookmarks.

(de)activate bookmark sets 1 to 9 by pressing CTRL+1 to CTRL+9. By default, set number one is open on startup. whenever you select a text phrase using ALT+LMOUSE (or CTRL+RMOUSE under Linux) within the same line, a bookmark is created.

the bookmark list is shown at the right top:

click on a bookmark anytime to jump back to it's position. click DEL to remove it, or on "..." and then "copybm" to copy the list to clipboard.

if you search something, then create a bookmark, this bookmark also copies a search context. click the little box left to DEL to activate. now, if you click on the bookmark, the find and path fields are restored to their content at the time of bookmarking.

bookmarks are saved:

• in a file with the taget directory name plus "zz-" prefix
• OR: if an sfk snapfile was loaded, with the snapfile's name plus .n.dvbm.
• you may reorder your bookmark slots (ctr+1 to ctr+9) by simply renaming the files, e.g.
  ren zz-src1-bookmarks.1.dvbm zz-src1-bookmarks.5.dvbm.

Exporting and editing bookmark sets:

• export a bookmark set to clipboard by clicking on the long "copy bookmarks to clipboard" button.
   
• enter an editor, open a new, empty file, press SHIFT+INSERT. now you have the bookmarks in your editor:

  :depeche-view-bookmarks,1.0
  DBController::DBController [ line 9 in FooBank\DB\source\DBController.cpp ]
  class BarMug [ line 6 in FooBank\BarDriver\include\BarMug.hpp ]
  class BarDriver [ line 6 in FooBank\BarDriver\include\BarDriver.hpp ]
  ...

  in a format which is human readable (and also suitable for emailing).

• be careful when editing: the only thing allowed is to change the sequence of lines, or to delete lines.
   
• to re-import the list into dview,
  • mark and copy the whole list withing the editor using SHIFT+CURSOR, and finally CTRL+C. now the edited list is within the clipboard.
  • enter dview (activate it's window).
  • press SHIFT+INSERT.
  note that search context information is always lost during export/import, however it's often not needed.

CTRL+Q quick toggles bookmark display off and on, allowing to view the text behind or not. CTRL+S saves bookmark changes without asking back.

Bookmark reordering, indenting, and adding free text remarks:

Config file:

You may change many settings by creating a config file. To create such a file, click on the "..." button, and then on "config". After creation, the file should be opened within a notepad window automatically, but you can load it also with any other text editor. Then keep on reading through the many remark lines (starting with "//") that explain all possible settings.

The config file (dview-config.txt) should be stored in the same directory where dview.exe is located. This way you can, for example, copy both dview.exe and the config onto USB stick, then run dview from that stick, having your personal configuration used instantly.

Under Linux, make sure that dview.exe is located in a directory listed in the WINE PATH. To edit this path, type "wine regedit" then search for PATH (somewhere under System ... Environment).

Running external commands on subfiles:

Under Windows, you can easily run self-defined commmands on the currently selected file by defining small scripts in the config file.

Under Linux, it's basically the same, but you cannot run native Linux commands - only other Windows applications running under WINE, and they must be available in the WINE PATH. To check or edit this path, type "wine regedit" then search for PATH (somewhere under System ... Environment).

Old way of running commands: you may also define commands via environment variables. This is deprecated, but still supported.

 SET DVIEW_CMD_1="notepad $file"

 SET DVIEW_CMD_4="attrib -R $path\*.cpp<newline>notepad.exe $file".

 SET DVIEW_CMD_4="cmd /C "$file""

Fine tuning the Depeche View icon:

if you look at the properties of the icon, you'll find parameters like

    -cfg1 -wrapbin=80 -file -all .doc .xls .ppt .pdf -any                 

    -cfg1 -wrapbin=80 -file -all .doc .xls .ppt .pdf .dll .exe -any

you may also create several icons manually, with different parameters. for example, one icon may contain

    -cfg1 -wrap=80 -file .cpp .hpp -any

Drag and drop without icon:

Configuring a background image:

• Click on the "..." button at the top right.
• Click on the "config" button that appears.
• Click Yes to create a config file.
• A notepad window should appear, allowing instant editing of the config file.
  If not, open the file with any other text editor.
• Search for a line containing "background" and "back.jpg".
• Remove the "//" remark characters at the beginning of that line.
• Replace back.jpg by the name of the .jpg image file you want to display.
  This file must be located in the same directory as dview.exe,
  or in any directory listed in the System PATH variable.
• Save the changed config file (CTRL+S). Re-enter dview.
• Click on the config button again, to have the config reloaded.
• Keep ALT pressed and move your mouse up and down to adjust
  the visibility of the background. Under Linux, you may have to
  reconfigure your window manager to allow the ALT key first.