add new section about 'input feedback' sounds and move a couple of sounds there

1 files changed, 204 insertions, 170 deletions

diff --git a/spec/sound-naming-spec.xml b/spec/sound-naming-spec.xml
index ec7aa88..9d63860 100644
--- a/spec/sound-naming-spec.xml
+++ b/spec/sound-naming-spec.xml
@@ -105,7 +105,14 @@ usage.
 	    <entry>Actions</entry>
 	    <entry>
 	      Sounds that give the user feedback on their
-	      actions. Sounds on window opening / closing for example.
+	      actions.
+	    </entry>
+	    <entry>action</entry>
+	  </row>
+	  <row>
+	    <entry>Input Feedback</entry>
+	    <entry>
+	      Sounds that give direct response to input events from the user, such as mouse clicks or key presses.
 	    </entry>
 	    <entry>action</entry>
 	  </row>
@@ -489,6 +496,18 @@ usage.
 		A user configured alarm elapsed.
 	      </entry>
 	    </row>
+	    <row>
+	      <entry>window-attention-active</entry>
+	      <entry>
+		An active/visible window demands attention.
+	      </entry>
+	    </row>
+	    <row>
+	      <entry>window-attention-inactive</entry>
+	      <entry>
+		An inactive/invisible window demands attention.
+	      </entry>
+	    </row>
 	  </tbody>
 	</tgroup>
       </table>
@@ -497,10 +516,10 @@ usage.
     <sect2 id="actions">
       <title>Actions</title>
       <para>
-	Actions sounds are used as feedback for an immediate user operation.
+	Action sounds are used as feedback for user operations.
       </para>
 
-      <table id="support-table">
+      <table id="actions-table">
 	<title>Standard Action Sounds</title>
 	<tgroup cols="2">
 	  <thead>
@@ -529,438 +548,452 @@ usage.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>window-close</entry>
-	      <entry>
-		The sound used when an existing window is closed.
-	      </entry>
-	    </row>
-	    <row>
-	      <entry>window-slide-in</entry>
+	      <entry>bell-terminal</entry>
 	      <entry>
-		The sound used when a window is slided in by some means. Example: panel.
+		The sound to use as a terminal bell.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>window-slide-out</entry>
+	      <entry>bell-window-system</entry>
 	      <entry>
-		The sound used when a window is slided out by some means. Example: panel.
+		The sound to use as a generic bell for X11 or other window systems.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>window-minimized</entry>
+	      <entry>trash-empty</entry>
 	      <entry>
-		The sound used when an existing window is minimized.
+		The sound used when the user empties the trash.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>window-unminimized</entry>
+	      <entry>item-deleted</entry>
 	      <entry>
-		The sound used when an existing window is unminimized.
+		The sound used when a item is deleted.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>window-maximized</entry>
+	      <entry>file-trash</entry>
 	      <entry>
-		The sound used when an existing window is maximized.
+		The sound used when a file or folder is sent to the
+		trash.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>window-unmaximized</entry>
+	      <entry>camera-shutter</entry>
 	      <entry>
-		The sound used when an existing window is unmaximized.
+		A photo has been shot.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>window-inactive-click</entry>
+	      <entry>camera-focus</entry>
 	      <entry>
-		The sound used when the user clicks on an inactive window.
+		A camera has the focus.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>window-attention-active</entry>
+	      <entry>screen-capture</entry>
 	      <entry>
-		An active/visible window demands attention.
+		A screenshot was made.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>window-attention-inactive</entry>
+	      <entry>count-down</entry>
 	      <entry>
-		An inactive/invisible window demands attention.
+		A countdown (e.g. for a photo shooting) sound that is repeated each second.
 	      </entry>
 	    </row>
-	    <row>
-	      <entry>window-move-start</entry>
+            <row>
+              <entry>completion-sucess</entry>
 	      <entry>
-		A window move started.
+                A text completion was attempted and was successful.
 	      </entry>
 	    </row>
-	    <row>
-	      <entry>window-move-end</entry>
+            <row>
+              <entry>completion-fail</entry>
 	      <entry>
-		A window move ended.
+                A text completion was attempted and was not successful.
 	      </entry>
 	    </row>
-	    <row>
-	      <entry>window-resize-start</entry>
+            <row>
+              <entry>completion-partial</entry>
 	      <entry>
-		A window resize started.
+                A text completion was attempted and was partially successful.
 	      </entry>
 	    </row>
-	    <row>
-	      <entry>window-resize-end</entry>
+            <row>
+              <entry>completion-rotation</entry>
 	      <entry>
-		A window resize ended.
+                A text completion was attempted and the list of available options reached the end and completion started from the beginning.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>desktop-switch-left</entry>
+	      <entry>audio-volume-change</entry>
 	      <entry>
-		The sound used when the window manager switches to another desktop which is located to the left of the current screen.
+		The test sound that is used to make volume changes noticeable by the user when he uses a volume slider.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>desktop-switch-right</entry>
+	      <entry>audio-channel-left</entry>
 	      <entry>
-		The sound used when the window manager switches to another desktop which is located to the right of the current screen.
+		The test sound for identifying the left speaker. A mono file with a voice saying "left".
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>window-switch</entry>
+	      <entry>audio-channel-right</entry>
 	      <entry>
-		The sound used when the window manager switches to another window.
+		The test sound for identifying the right speaker. A mono file with a voice saying "right".
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>notebook-tab-changed</entry>
+	      <entry>audio-channel-front-left</entry>
 	      <entry>
-		The sound used when a notebook tab is changed.
+		The test sound for identifying the front-left speaker. A mono file with a voice saying "front left".
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>bell-terminal</entry>
+	      <entry>audio-channel-front-right</entry>
 	      <entry>
-		The sound to use as a terminal bell.
+		The test sound for identifying the front-right speaker. A mono file with a voice saying "front right".
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>bell-window-system</entry>
+	      <entry>audio-channel-front-center</entry>
 	      <entry>
-		The sound to use as a generic bell for X11 or other window systems.
+		The test sound for identifying the front-center speaker. A mono file with a voice saying "front center".
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>dialog-ok</entry>
+	      <entry>audio-channel-rear-left</entry>
 	      <entry>
-		The sound used when a windows is closed by clicking on the OK button for a window.
+		The test sound for identifying the front-left speaker. A mono file with a voice saying "rear left".
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>dialog-cancel</entry>
+	      <entry>audio-channel-rear-right</entry>
 	      <entry>
-		The sound used when a windows is closed by clicking on the Cancel button for a window.
+		The test sound for identifying the front-right speaker. A mono file with a voice saying "rear right".
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>drag-start</entry>
+	      <entry>audio-channel-rear-center</entry>
 	      <entry>
-		The sound used when drag of a file/item is started.
+		The test sound for identifying the front-center speaker. A mono file with a voice saying "rear center".
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>drag-accept</entry>
+	      <entry>audio-channel-lfe</entry>
 	      <entry>
-		The sound used when a file/item drag is accepted by a window,
-		such as a folder or IM conversation.
+		The test sound for identifying the lfe/subwoofer speaker. A mono file with a voice saying "subwoofer", alternatively a low frequency noise.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>drag-fail</entry>
+	      <entry>audio-channel-side-left</entry>
 	      <entry>
-		The sound used when a file/item drag is not accepted by a window,
-		such as a folder or IM conversation.
+		The test sound for identifying the side-left speaker. A mono file with a voice saying "side left".
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>trash-empty</entry>
+	      <entry>audio-channel-side-right</entry>
 	      <entry>
-		The sound used when the user empties the trash.
+		The test sound for identifying the side-right speaker. A mono file with a voice saying "side right".
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>item-deleted</entry>
+	      <entry>audio-test-signal</entry>
 	      <entry>
-		The sound used when a item is deleted.
+		The test sound for testing audio.
 	      </entry>
 	    </row>
+	  </tbody>
+	</tgroup>
+      </table>
+    </sect2>
+
+    <sect2 id="inputfeedback">
+      <title>Input Feedback</title>
+      <para>
+	Actions sounds are used as feedback for user input events,
+	such as mouse clicks, or key presses. In contrast to the
+	sounds listed as "Actions" these sounds contain much less
+	context information are are solely used to give the user
+	audible feedback to input events the user himself directly
+	caused.
+      </para>
+
+      <table id="inputfeedback-table">
+	<title>Standard Input Feedback Sounds</title>
+	<tgroup cols="2">
+	  <thead>
 	    <row>
-	      <entry>item-selected</entry>
-	      <entry>
-		The sound used when an item is selected.
-	      </entry>
+	      <entry>Name</entry>
+	      <entry>Description</entry>
 	    </row>
+	  </thead>
+	  <tbody>
 	    <row>
-	      <entry>file-trash</entry>
+	      <entry>window-close</entry>
 	      <entry>
-		The sound used when a file or folder is sent to the
-		trash.
+		The sound used when an existing window is closed.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>link-pressed</entry>
+	      <entry>window-slide-in</entry>
 	      <entry>
-		The sound used when a link in a web or help browser is pressed.
+		The sound used when a window is slided in by some means. Example: panel.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>link-released</entry>
+	      <entry>window-slide-out</entry>
 	      <entry>
-		The sound used when a link in a web or help browser is releaed.
+		The sound used when a window is slided out by some means. Example: panel.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>button-pressed</entry>
+	      <entry>window-minimized</entry>
 	      <entry>
-		The sound used when a button is pressed.
+		The sound used when an existing window is minimized.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>button-released</entry>
+	      <entry>window-unminimized</entry>
 	      <entry>
-		The sound used when a button is released.
+		The sound used when an existing window is unminimized.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>menu-click</entry>
+	      <entry>window-maximized</entry>
 	      <entry>
-		The sound used when a menu item is clicked.
+		The sound used when an existing window is maximized.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>button-toggle-on</entry>
+	      <entry>window-unmaximized</entry>
 	      <entry>
-		The sound used when a toggle/check/radio button is activated.
+		The sound used when an existing window is unmaximized.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>button-toggle-off</entry>
+	      <entry>window-inactive-click</entry>
 	      <entry>
-		The sound used when a toggle/check/radio button is deactivated.
+		The sound used when the user clicks on an inactive window.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>expander-toggle-on</entry>
+	      <entry>window-move-start</entry>
 	      <entry>
-		The sound used when an expander is activated.
+		A window move started.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>expander-toggle-off</entry>
+	      <entry>window-move-end</entry>
 	      <entry>
-		The sound used when an expander is deactivated.
+		A window move ended.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>menu-popup</entry>
+	      <entry>window-resize-start</entry>
 	      <entry>
-		The sound used when a menu is popped up.
+		A window resize started.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>menu-popdown</entry>
+	      <entry>window-resize-end</entry>
 	      <entry>
-		The sound used when a menu is popped down.
+		A window resize ended.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>menu-replace</entry>
+	      <entry>desktop-switch-left</entry>
 	      <entry>
-		The sound used when replacing an active menu with another menu.
+		The sound used when the window manager switches to another desktop which is located to the left of the current screen.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>tooltip-popup</entry>
+	      <entry>desktop-switch-right</entry>
 	      <entry>
-		The sound used when a tooltip is popped up.
+		The sound used when the window manager switches to another desktop which is located to the right of the current screen.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>tooltip-popdown</entry>
+	      <entry>window-switch</entry>
 	      <entry>
-		The sound used when a tooltip is popped down.
+		The sound used when the window manager switches to another window.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>camera-shutter</entry>
+	      <entry>notebook-tab-changed</entry>
 	      <entry>
-		A photo has been shot.
+		The sound used when a notebook tab is changed.
 	      </entry>
 	    </row>
-	    <row>
-	      <entry>camera-focus</entry>
+            <row>
+              <entry>scroll-up</entry>
 	      <entry>
-		A camera has the focus.
+                Some window was scrolled up.
 	      </entry>
 	    </row>
-	    <row>
-	      <entry>screen-capture</entry>
+            <row>
+              <entry>scroll-down</entry>
 	      <entry>
-		A screenshot was made.
+                Some window was scrolled down.
 	      </entry>
 	    </row>
-	    <row>
-	      <entry>count-down</entry>
+            <row>
+              <entry>scroll-left</entry>
 	      <entry>
-		A countdown (e.g. for a photo shooting) sound that is repeated each second.
+                Some window was scrolled left.
 	      </entry>
 	    </row>
             <row>
-              <entry>completion-sucess</entry>
+              <entry>scroll-right</entry>
 	      <entry>
-                A text completion was attempted and was successful.
+                Some window was scrolled right.
 	      </entry>
 	    </row>
             <row>
-              <entry>completion-fail</entry>
+              <entry>scroll-up-end</entry>
 	      <entry>
-                A text completion was attempted and was not successful.
+                Some window was scrolled up and reached the end of the scrollbar.
 	      </entry>
 	    </row>
             <row>
-              <entry>completion-partial</entry>
+              <entry>scroll-down-end</entry>
 	      <entry>
-                A text completion was attempted and was partially successful.
+                Some window was scrolled down and reached the end of the scrollbar.
 	      </entry>
 	    </row>
             <row>
-              <entry>completion-rotation</entry>
+              <entry>scroll-left-end</entry>
 	      <entry>
-                A text completion was attempted and the list of available options reached the end and completion started from the beginning.
+                Some window was scrolled left and reached the end of the scrollbar.
 	      </entry>
 	    </row>
             <row>
-              <entry>scroll-up</entry>
+              <entry>scroll-right-end</entry>
 	      <entry>
-                Some window was scrolled up.
+                Some window was scrolled right and reached the end of the scrollbar.
 	      </entry>
 	    </row>
-            <row>
-              <entry>scroll-down</entry>
+	    <row>
+	      <entry>dialog-ok</entry>
 	      <entry>
-                Some window was scrolled down.
+		The sound used when a windows is closed by clicking on the OK button for a window.
 	      </entry>
 	    </row>
-            <row>
-              <entry>scroll-left</entry>
+	    <row>
+	      <entry>dialog-cancel</entry>
 	      <entry>
-                Some window was scrolled left.
+		The sound used when a windows is closed by clicking on the Cancel button for a window.
 	      </entry>
 	    </row>
-            <row>
-              <entry>scroll-right</entry>
+	    <row>
+	      <entry>drag-start</entry>
 	      <entry>
-                Some window was scrolled right.
+		The sound used when drag of a file/item is started.
 	      </entry>
 	    </row>
-            <row>
-              <entry>scroll-up-end</entry>
+	    <row>
+	      <entry>drag-accept</entry>
 	      <entry>
-                Some window was scrolled up and reached the end of the scrollbar.
+		The sound used when a file/item drag is accepted by a window,
+		such as a folder or IM conversation.
 	      </entry>
 	    </row>
-            <row>
-              <entry>scroll-down-end</entry>
+	    <row>
+	      <entry>drag-fail</entry>
 	      <entry>
-                Some window was scrolled down and reached the end of the scrollbar.
+		The sound used when a file/item drag is not accepted by a window,
+		such as a folder or IM conversation.
 	      </entry>
 	    </row>
-            <row>
-              <entry>scroll-left-end</entry>
+	    <row>
+	      <entry>link-pressed</entry>
 	      <entry>
-                Some window was scrolled left and reached the end of the scrollbar.
+		The sound used when a link in a web or help browser is pressed.
 	      </entry>
 	    </row>
-            <row>
-              <entry>scroll-right-end</entry>
+	    <row>
+	      <entry>link-released</entry>
 	      <entry>
-                Some window was scrolled right and reached the end of the scrollbar.
+		The sound used when a link in a web or help browser is releaed.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>audio-volume-change</entry>
+	      <entry>button-pressed</entry>
 	      <entry>
-		The test sound that is used to make volume changes noticeable by the user when he uses a volume slider.
+		The sound used when a button is pressed.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>audio-channel-left</entry>
+	      <entry>button-released</entry>
 	      <entry>
-		The test sound for identifying the left speaker. A mono file with a voice saying "left".
+		The sound used when a button is released.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>audio-channel-right</entry>
+	      <entry>menu-click</entry>
 	      <entry>
-		The test sound for identifying the right speaker. A mono file with a voice saying "right".
+		The sound used when a menu item is clicked.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>audio-channel-front-left</entry>
+	      <entry>button-toggle-on</entry>
 	      <entry>
-		The test sound for identifying the front-left speaker. A mono file with a voice saying "front left".
+		The sound used when a toggle/check/radio button is activated.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>audio-channel-front-right</entry>
+	      <entry>button-toggle-off</entry>
 	      <entry>
-		The test sound for identifying the front-right speaker. A mono file with a voice saying "front right".
+		The sound used when a toggle/check/radio button is deactivated.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>audio-channel-front-center</entry>
+	      <entry>expander-toggle-on</entry>
 	      <entry>
-		The test sound for identifying the front-center speaker. A mono file with a voice saying "front center".
+		The sound used when an expander is activated.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>audio-channel-rear-left</entry>
+	      <entry>expander-toggle-off</entry>
 	      <entry>
-		The test sound for identifying the front-left speaker. A mono file with a voice saying "rear left".
+		The sound used when an expander is deactivated.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>audio-channel-rear-right</entry>
+	      <entry>menu-popup</entry>
 	      <entry>
-		The test sound for identifying the front-right speaker. A mono file with a voice saying "rear right".
+		The sound used when a menu is popped up.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>audio-channel-rear-center</entry>
+	      <entry>menu-popdown</entry>
 	      <entry>
-		The test sound for identifying the front-center speaker. A mono file with a voice saying "rear center".
+		The sound used when a menu is popped down.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>audio-channel-lfe</entry>
+	      <entry>menu-replace</entry>
 	      <entry>
-		The test sound for identifying the lfe/subwoofer speaker. A mono file with a voice saying "subwoofer", alternatively a low frequency noise.
+		The sound used when replacing an active menu with another menu.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>audio-channel-side-left</entry>
+	      <entry>tooltip-popup</entry>
 	      <entry>
-		The test sound for identifying the side-left speaker. A mono file with a voice saying "side left".
+		The sound used when a tooltip is popped up.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>audio-channel-side-right</entry>
+	      <entry>tooltip-popdown</entry>
 	      <entry>
-		The test sound for identifying the side-right speaker. A mono file with a voice saying "side right".
+		The sound used when a tooltip is popped down.
 	      </entry>
 	    </row>
 	    <row>
-	      <entry>audio-test-signal</entry>
+	      <entry>item-selected</entry>
 	      <entry>
-		The test sound for testing audio.
+		The sound used when an item is selected.
 	      </entry>
 	    </row>
 	  </tbody>
@@ -968,6 +1001,7 @@ usage.
       </table>
     </sect2>
 
+
     <sect2 id="games">
       <title>Game</title>
       <para>