svn commit: r42828 - head/en_US.ISO8859-1/books/handbook/x11

[Benjamin Kaduk]

On Fri, 4 Oct 2013, Dru Lavigne wrote:

> Author: dru
> Date: Fri Oct  4 17:54:01 2013
> New Revision: 42828
> URL: http://svnweb.freebsd.org/changeset/doc/42828
>
> Modified: head/en_US.ISO8859-1/books/handbook/x11/chapter.xml
> ==============================================================================
> --- head/en_US.ISO8859-1/books/handbook/x11/chapter.xml	Fri Oct  4 17:29:34 2013	(r42827)
> +++ head/en_US.ISO8859-1/books/handbook/x11/chapter.xml	Fri Oct  4 17:54:01 2013	(r42828)
>
> -      <para>This confuses some people, because the X terminology is
> -	exactly backward to what they expect.  They expect the
> -	<quote>X server</quote> to be the big powerful machine down
> -	the hall, and the <quote>X client</quote> to be the machine
> -	on their desk.</para>

I do still run into people experiencing confusion on this point.
I've lost track of the full scope/contents of this chapter, but this 
paragraph might be worth keeping as a note.

> -      <para>It is important to remember that the X server is the
> -	machine with the monitor and keyboard, and the X clients are
> -	the programs that display the windows.</para>
> -
[...]
> +	<para>One focus policy is called
> +	  <quote>click-to-focus</quote>.  In this model, a window becomes active
> +	  upon receiving a mouse click.  In the
> +	  <quote>focus-follows-mouse</quote> policy, the window that is under the mouse pointer
> +	  has focus and the focus is changed by pointing at
> +	  another window.  In the <quote>sloppy-focus</quote> model, if
> +	  the mouse is moved over the root window, no window has the focus and
> +	  any keystrokes are lost.  With sloppy-focus, focus
> +	  is only changed when the cursor enters a new
> +	  window, and not when exiting the current

This text gives me the impression that "sloppy-focus" both can eat 
keystrokes when focus is on the root window and takes measures to avoiding 
keystrokes (by only changing focus on window entry), which are hard to 
reconcile with each other.  If this is indeed the case, perhaps more 
explanation is needed.  (I think, though, that the text is not quite 
right.)

-Ben

> +	  window.  In the <quote>click-to-focus</quote> policy, the active window is selected by mouse click.
> +	  The window may then be raised and
> +	  appear in front of all other windows.  All keystrokes
> +	  will now be directed to this window, even if the
> +	  cursor is moved to another window.</para>