[gnome-user-docs] g-h/mouse-middleclick: More explanation, final

[Shaun McCance <shaunm src gnome org>]

commit a4211c6339393331a4460e2a454af39e0c07f0e4
Author: Shaun McCance <shaunm gnome org>
Date:   Tue Apr 5 14:46:06 2011 -0400

    g-h/mouse-middleclick: More explanation, final
    
    Got to be careful to not confuse primary selection with
    the clipboard. More explanation on how to middle-click.
    And what it does in Nautilus.

 gnome-help/C/mouse-middleclick.page |   63 +++++++++++++++++++++-------------
 1 files changed, 39 insertions(+), 24 deletions(-)
---
diff --git a/gnome-help/C/mouse-middleclick.page b/gnome-help/C/mouse-middleclick.page
index 3d2d731..837f4d8 100644
--- a/gnome-help/C/mouse-middleclick.page
+++ b/gnome-help/C/mouse-middleclick.page
@@ -3,9 +3,9 @@
       id="mouse-middleclick">
 
 <info>
- <desc>Copy/paste, close tabs, open urls.. </desc>
+ <desc>Use the middle mouse button to paste text or open tabs.</desc>
 
- <revision pkgversion="3.0" version="1.0" date="2011-03-19" status="review"/>
+ <revision pkgversion="3.0" date="2011-04-05" status="final"/>
  
  <link type="guide" xref="tips" />
 
@@ -13,31 +13,46 @@
   <name>Tiffany Antopolski</name>
   <email>tiffany antopolski gmail com</email>
  </credit>
+ <credit type="author">
+   <name>Shaun McCance</name>
+   <email>shaunm gnome org</email>
+ </credit>
  <license><p>Creative Commons Share Alike 3.0</p></license>
 </info>
 
 <title>Middle click</title>
 
-<p>Your desktop has a built in copy and paste function:</p>
-<steps>
-<item><p>Highlight the text you want to copy.</p></item>
-<item><p>Go to where you want to paste it and press the middle mouse button.</p></item>
-<item><p>The text is pasted at the mouse position.</p>
-<p>The text must be highlighted when you middle click in order to paste.  </p></item>
-</steps>  
-
-<list>
-<item><p>You can middle click on a hyperlink in a browser to have it open in a new tab.</p></item>
-<item><p>In <app>Firefox</app> middle clicking on a tab will immediately close it.</p></item>
-</list>
-<section id="two-button">
- <title>Two button mouse</title>
- <p>To perform a "middle click" on a two button mouse, click both mouse buttons at the same time.</p>
-<p>On a laptop, clicking both pads simultaneously will simulate middle click behavior.</p>
-</section>
-
-<section id="scroll-wheel">
- <title>Scroll Wheel</title>
- <p>Clicking the scroll wheel will mimic the middle click.</p>
-</section>
+<p>Many mice and some touchpads have a middle mouse button. On a mouse
+with a scroll wheel, you can usually press directly down on the scroll
+wheel to middle-click. If you don't have a middle mouse button, you
+can press the left and right mouse buttons at the same time to
+middle-click.</p>
+
+<p>Many applications use middle-click for advanced click shortcuts.
+One common shortcut is to paste selected text. (This is sometimes
+called primary selection paste.) Select the text you want to paste,
+then go to where you want to paste it and middle-click. The selected
+text is pasted at the mouse position.</p>
+
+<p>Pasting text with your middle mouse button is completely separate
+from the normal clipboard. Selecting text does not copy it to your
+clipboard. This quick method of pasting only works with the middle
+mouse button.</p>
+
+<p>Most web browsers allow you to open links in tabs quickly with
+the middle mouse button. Just click any link with your middle mouse
+button, and it will open in a new tab. Be careful clicking the link
+in the <app>Firefox</app> web browser, though. In <app>Firefox</app>,
+if you middle-click anywhere except on a link, it will try to load
+your selected text as a URL, as if you used middle-click to paste
+it to the location bar and pressed <key>Enter</key>.</p>
+
+<p>In the file manager, middle-click serves two roles. If you
+middle-click a folder, it will open in a new tab. This mimics the
+behavior of popular web browsers. If you middle-click a file, it
+will open the file, just as if you had double-clicked.</p>
+
+<p>Some specialized applications allow you to use the middle mouse
+button for other functions. Search your application's help for
+<em>middle-click</em> or <em>middle mouse button</em>.</p>
 </page>