diff --git a/help/C/config-mouse.xml b/help/C/config-mouse.xml index 3e8b5516e..833c3707d 100644 --- a/help/C/config-mouse.xml +++ b/help/C/config-mouse.xml @@ -1,117 +1,241 @@ + Mouse - + + Introduction - - The mouse capplet in the GNOME Control - Center helps to configure properties of the mouse, - such as: whether you're left handed or right handed, sensitivity, - and mouse speed. - + + The mouse capplet in the GNOME Control + Center helps to configure properties of the mouse. These + are: + + + + for the General tab: mouse acceleration, + mouse sensitivity, double-click timout, drag and drop treshold, + pointer location and left handed or right handed mouse usage + + + + for the Accessibility tab: simulated + secondary click and dwell click + + - - The Buttons Tab - - The buttons tab controls properties for the mouse buttons. - - + + + The <guilabel>General</guilabel> Tab + + The General tab offers the commonly used + settings of the mouse. + + Mouse Orientation - - A mouse behaves differently based on whether the user is right - or left handed. If they're right handed, the left button is the - action button, while the right button is the menu button. The - mouse also typically sits on the right hand side of the desk. - If the user is left handed, they use the right button as the - action button, while the left button is the menu button. It - also sits on the left hand of the desk. - - - To configure the hand orientation, select the - Left-handed mouse button. If you're - right handed, deselect that button. Press - Apply to apply your changes. - + + A user controls the mouse differently based on him being right or + left handed. + + If he is right handed, the mouse typically sits on the right hand + side of the desk. The primary button (action button) is on the left of + the mouse, so that he can press it with his index finger, while the + secondary button (menu button) is on the right. + + However, if he is left handed, the mouse sits on the left hand + side of the desk. Consequently, in order to allow him to operate the + primary button with his index finger of his left hand, the primary and + the secondary button of the mouse have to be swapped. + + That is the purpose of the Mouse Orientation + setting: select the Right-handed button if you + are right handed, or the Left-handed button if + you are left handed. When using the setting appropriate to him, the user + has the primary button under his index finger. - - Double-click Delay - - Double-clicking speed can be configured, to let you set how - fast you want to double-click. This can be good for disabled - people who can't click fast. - - - Select the delay you wish to use on the slider. The more - right it is, the longer the delay allowed. - - - You can test the speed by double-clicking on the cake at - right. The candle will light on fire if it detected a - double-click. - + + + Locate Pointer + + Sometimes, the user loses where the pointer is. If he selects the + Show position of pointer when the Control key is + pressed, he can make the pointer reappear by pressing the + control key. - - - The Mouse Cursors Tab - - Cursors are the part on the desktop that represents where the - mouse is. The cursor can be changed for easier use. - - - Cursor Themes - - Gnome's mouse cursors can be - configured to look different. For example, if you have a dark - desktop, you may want to use the white cursor. - - - To select a theme, simply click the theme you wish to use and - click Apply. You will need to logout - for this change to occur. - + + + Pointer Speed + + Every user has different favorites regarding the relation between + the movement of the mouse and the movement of the pointer. In order to + tune it to his taste, he can use the Acceleration + and the Sensitivity settings: + + + + Acceleration: it sets the linear factor + between mouse movement and pointer movement + + + + Sensitivity: it sets the threshold speed + at which the mouse will start accelerating + + + + For example, by setting the sensitivity to its lowest, the mouse + will move all the time with no acceleration adjustment; in this case, + there is a perfect mouse distance to pixel distance ratio. - - Locating Cursors Option - - Sometimes, you'll lose where the cursor is. If you select the - Show position of cursor when the Control key is - pressed, the cursor will be animated when you - press and release the control key. - - - - - The Motion Tab - - The mouse cursor can be set to move at different speeds and - sensitivities. The following options are available for you to - edit: - - - Speed - - The mouse pointer can move at different speeds across the - screen. Everyone has their favorite speed, so the ability to - configure this is important. - - - - To set your mouse speed, move the bar to either faster or slower - in the Mouse speed section. Afterwards, - click Apply to test the speed. Once you - select your desired speed, click Close. - - - + + Drag and Drop - - Drag and drop is clicking an object, and dragging it to - another place on the screen, causing an event to occur. - - - You need to drag it a certain amount of distance before the - system will recognize it as a drag and drop operation. To - configure how far to drag it, move the slider left or right. - + + Drag and drop is clicking an object, and dragging it to another + place on the screen, causing an event to occur. + + You need to drag it a certain amount of distance before the system + will recognize it as a drag and drop operation. To configure how far to + drag it, move the Treshold slider left or + right. + + + + Double-click Delay + + When a user performs two clicks with the primary button, the + system considers them as a double-click or as two single clicks + depending on the delay that has elapsed between the two clicks. + + With the Timeout slider, the user can set the + maximum delay that can elapse between the two clicks for them to be + still considered as a double-click. If the delay between the two clicks + is greater than the maximum delay that has been set, the two clicks are + considered as two single clicks instead of a double click. + + Consequently: the shorter the timeout, the less time can elapse + between the two clicks of a double-click. + + The user can test the timeout that he has set by clicking on the + light bulb, that will light on, if a double-click is detected. - + + + The Accessibility Tab + + The Accessibility tab brings additional + functions to the mouse. It allows the the user to perform a secondary + click by using the primary button; it also allows him to perform all the + different click types without using any hardware button. + + + Simulated Secondary Click + + There are users that can use only one mouse button. By activating + the Simulated Secondary Click, these users have a + direct way to perform secondary clicks with their unique mouse button. + In fact, the secondary click occurs automatically when the user keeps + the primary button pressed for a determined delay without moving the + mouse. + + The Simulated Secondary Click also offers a + slider named Delay to configure how long the user + has to press the button and keep the mouse motionless, before the + secondary click is automatically performed. + + + + Dwell Click + + There are users that cannot use any hardware button. By activating + the Dwell Click, they can have the mouse perform + the various clicks without pressing any mousebutton. The click types + that can be performed are: single click, double-click, drag click and + secondary click. + + To make the mouse perform the clicks without a mousebutton being + pressed, the user has to put a mark in the box named Initiate + click when stopping pointer movement. How the click is + completed and how the click type is chosen depends on what dwell mode + the user is using. The two available modes are: + + + + automatic click completion with click type chosen + beforehand + + + + click completion and click type choice by a mouse gesture + after click initiation + + + + With the Delay slider, the user can configure + how long the pointer has to be motionless for the click to be + initiated. + + For people that have trouble to keep the mouse motionless, there + is the Motion Treshold slider. When the slider is + set towards low, even little mouse movements are considered; however, by + setting a higher treshold, the mouse has to traverse a bigger distance + before it is considered as moving. + + As said above, the user can choose between two modes for the click + type choice and click completion: + + + Dwell Click With Automatic Click Completion And Click Type + Choice Beforehand + + This mode is active when the user selects Choose type + of click beforehand. In fact, after the mouse has been + motionless for the above predefined delay, the system will + automatically perform the click type that is selected in the Click + Type Window. + + After the click has occurred, the single click type will be + automatically restored. In order to choose another click type, the + user has to perform an automatic click on the + button in the Click Type Window that + corresponds to its click type choice. + + To make the Click Type Window appear on the screen, the user has + to put a mark into the checkbox named Show click type + window. Some users might prefer to use the Dwell + Click panel applet instead of the Click Type Window. The + advantage of the panel applet is that it does not cover any open + window on the desktop. + + + + Dwell Click With Click Type Choice And Click Completion By A + Mouse Gesture + + This mode is used when the user selects Choose type of + click with mouse gestures. In fact, after the mouse has + been motionless for the above predefined delay, the shape of the + pointer will change for a little while: + + + + If the user moves the mouse while it is showing the + alternative shape, a click is performed and the pointer returns to + its normal shape. The type of click performed depends on the + direction of the movement of the mouse. + + + + If the mouse stays motionless until the pointer returns to + its normal shape, the user can move the mouse without a click + being performed. The next dwell click can be performed when the + mouse stops moving again. + + + + The user also has the possibility to match click type with + movement direction by using the 4 popups available + under this mode. + + + + \ No newline at end of file diff --git a/help/ChangeLog b/help/ChangeLog index 0f230f219..c0a5aa72a 100644 --- a/help/ChangeLog +++ b/help/ChangeLog @@ -1,3 +1,9 @@ +2008-01-14 Denis Washington + + * C/config-mouse.xml: + Updated to reflect the changes to the mouse capplet, e.g. the new + Accessibility tab. + 2007-12-31 Yannig Marchegay * oc.po: Updated Occitan translation.