2 files changed, 119 insertions, 0 deletions
diff --git a/docs/Makefile.am b/docs/Makefile.am
index cfbb431f4..979e1f1f6 100644
--- a/docs/Makefile.am
+++ b/docs/Makefile.am
@@ -10,4 +10,5 @@ EXTRA_DIST = \
 	smoketests.html \
 	state-machines.txt \
 	style-guide.html \
+	key_mouse_navigation.txt \
 	$(NULL)
diff --git a/docs/key_mouse_navigation.txt b/docs/key_mouse_navigation.txt
new file mode 100644
index 000000000..0153be6b9
--- /dev/null
+++ b/docs/key_mouse_navigation.txt
@@ -0,0 +1,118 @@
+This document describes the keyboard and mouse navigation model used
+in the default Nautilus views in detail. This is useful as a a guide
+for people implementing a Nautilus view or something else that wants
+to have a feel that is compatible with Nautilus.
+
+Icon view:
+----------
+
+Keyboard:
+=========
+
+When the focus is on the icon view you can move the currently selected
+icon by using:
+
+arrow keys - moves one step in the direction
+tab - moves to the "next" icon in order (i.e. at the end of one row,
+      go to the first icon the next row)
+shift-tab - moves to the "previous" icon in order
+home - moves to the first icon
+end - moves to the last icon
+  
+In order to allow multiple selection the above navigation keys can be
+combined with the Control key to move the keyboard focus without
+affecting the current selection.
+
+To select an icon position the keyboard focus on it and press
+ctlr-space. ctrl-space with no keyboard focus produces a keyboard
+focus at the first selected icon, or the first one if none are selected.
+
+In addition the following keyboard shortcuts are availible:
+
+Return, Keypad Return - Activate the selected objects
+Space (without control) - Activate the selected objects
+Escape - Undo icon stretching
+
+alt left - go back
+alt right - go forward
+alt up - go up a directory
+alt down - enter directory / activate selection
+
+Other key presses are used for typeahead search
+
+In rename mode:
+Escape - Cancel rename
+Return, Keypad Return - Finish rename
+
+TODO:
+Add text about which icon is used for selection/keyboard focus when
+there is none and e.g. arrow keys are pressed.
+
+BUGS:
+I can't seem to get the context menu using the keyboard
+escape cancel rename doesn't seem to work
+escape to undo stretch doesn't seem to work
+
+Mouse:
+======
+
+In double click mode:
+
+Clicking on an icon selects it and deselects all others on
+BUTTON_PRESS. Dragging does the default dnd file operation.
+
+Clicking on blank space deselect all selected icons. Doesn't allow
+dragging.
+
+Double clicking (both clicks on the same icon) with no modifiers
+activates the clicked file. (And deselects the others due to the first
+click.)
+
+Clicking when Control (Shift can also be used, which is not written
+out below) is held down can be used to do multiple selections.
+
+Control-click on empty space does nothing.
+Control-click on unselected icon selects it on BUTTON_PRESS
+Control-click on selected icon de-selects it on BUTTON_RELEASE
+Control-double click does nothing
+Control can be held down while starting a drag
+
+While doing a drag modifers affect the operation the drag causes:
+Control - Copy the files
+Shift - Move the files
+Alt - Open a menu with the availible alternatives
+
+All the basic clicks are typically done with the left button, but can
+be done with the other buttons to. [Do we want this?] However some of
+the buttons also have special operations:
+
+Right-click on a selected icon opens the context menu for the selected
+icons.
+Right-click on empty space opens the context menu for the directory.
+Middle-button drag always opens the menu with possible operations on
+drop.
+
+In single click mode:
+
+[TODO: Add stuff here]
+
+BUGS:
+middle button opens context menu! WTH?
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+