Unix/Linux Go Back    

OpenSolaris 2009.06 - man page for gok (opensolaris section 1)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)

gok(1)					  User Commands 				   gok(1)

       gok - GNOME on-screen keyboard

       gok  [--access-method=name] [--editor] [--extras] [--geometry=geometry] [--help] [--input-
       device=device]  [--keyboard=keyboard]  [--list-accessmethods]  [--list-actions]	[--login]
       [--remembergeometry]    [--scan-action=string]	 [--select-action=string]    [--settings]
       [--usage] [--valuator-sensitivity=double] [gnome-std-options]

       The GNOME On-screen Keyboard (GOK) is a dynamic on-screen keyboard for UNIX and	UNIX-like
       operating systems. gok enables users to control their computer without having to rely on a
       standard keyboard or mouse. Many individuals must control the computer  using  alternative
       input  methods.	With  the right hardware support and gok, individuals have full access to
       applications that support the AT SPI, and therefore, full access to the functionality that
       these applications provide.

       The following options are supported:

       -a, --access-method=name        Use  the specified access method. name is a string and can
				       be  found  in  the  various  access  method  files  (.xam)
				       assigned  to the "name" property of the <gok:accessmethod>
				       tag. Note that this is not necessarily  the  same  as  the
				       name of the .xam file, see --list-accessmethods.

       -e, --editor		       Start the GOK keyboard editor.

       --extras 		       Use special, but possibly unstable, gok functionality.

       --geometry=geometry	       If --geometry is not specified, gok remembers its position
				       between invocations and starts in  the  same  position  as
				       when last shut down.

				       If  --geometry  is  specified, gok positions itself within
				       the rectangular area of screen described by the given  X11
				       geometry specification, but does not remember its position
				       when shut down.	This behavior can  be  changed	with  the
				       --remembergeometry  option,  which  forces gok to remember
				       its position  when  shut  down,	even  when  started  with

       --help			       Displays the command line options.

       -i, --input-device=device       Use the specified input device.

       -k, --keyboard=keyboard	       Start GOK with the specified keyboard.

       --list-accessmethods	       List  the access methods that can used as options to other

       --list-actions		       List the actions that can used as options to  other  argu-

       -l, --login		       Specify that GOK is used to log in.

       --remembergeometry	       Can  be	used  with  the  --geometry option. Forces GOK to
				       remember its position when shut down, even if started with
				       the --geometry option. See --geometry.

       --scan-action=string	       Start  GOK  and	hook  this action to scan operations. See

       --select-action=string	       Start GOK and hook this action to select  operations.  See

       -s, --settings		       Open the settings dialog box when GOK starts.

       --usage			       Displays a brief usage message.

       ---valuator-sensitivity=double  A multiplier to be applied to input device valuator events
				       before processing.

       gnome-std-options	       Standard options available for use with most GNOME  appli-
				       cations.  See gnome-std-options(5) for more information.

       GOK  features  Direct  Selection, Dwell Selection, Automatic Scanning and Inverse Scanning
       access methods, and includes word completion.

       GOK includes an alphanumeric keyboard and a keyboard  for  launching  applications.   Key-
       boards  are specified in XML, enabling existing keyboards to be modified and new keyboards
       to be created. The access methods are also specified in XML, providing the ability to mod-
       ify  existing  access  methods  and create new ones. GOK is not limited to presenting key-
       boards that have been designed by hand, and can dynamically create keyboards to	adapt  to
       the user's current situation.

       GOK  can  redisplay  components	of  the  user interfaces of running applications directly
       within GOK as keyboards. This provides efficient access to elements of the user interface,
       removing  the  need to navigate the interface indirectly though keyboard accelerators. GOK
       supports the redisplay of application menus and toolbars. GOK contains a window	activator
       keyboard  that lists the current windows on the desktop and provides the ability to switch
       between them.

       Users have the option of setting key width, height, and spacing	as  well  as  visual  and
       auditory feedback on highlighting and selection. GOK can be further customized if you have
       programming skills, and contributions are welcome.

       If you build GOK from source, you can find some documentation about the internal GOK  APIs
       in the  gok/docs/reference/html directory.

       Note:  Although	GOK  can  be  operated via the "core pointer" device, that is, the system
       mouse or a device that controls the primary onscreen pointer, this mode	of  operation  is
       not supported or recommended for most users. This is because the operating system and pri-
       mary GUI toolkits reserve the core pointer for their own use, resulting in conflicts  with
       GOK  that  can  "lock  out"  a  GOK  user who cannot activate the keyboard or use the core
       pointer to "point and click" in the usual way. GOK can be operated via  "auxiliary"  input
       devices,  which	act  as  secondary or additional button or pointing devices.  See the GOK
       online reference manual and the GNOME Accessibility Guide for more information on  how  to
       configure GOK to use auxiliary input devices.

       Example 1: Specifying an Access Method to Use for GOK

       example% gok --access-method=dwellselection

       Example 2: Automatically Open the GOK Preferences Dialog When GOK Starts

       example% gok --settings

       The following exit values are returned:

       0	Application exited successfully.

       1	Application exited with error.

       2	GOK cannot be initialized from configuration data.

       The following files are used by this application:

       /usr/bin/gok		       Executable for GNOME on-screen keyboard

       /usr/share/gok/*.kbd	       GOK branching keyboards (C locale)

       /usr/share/gok/*.xam	       Access Method definition files

       /usr/share/gok/locale/*.kbd     Localized GOK branching keyboards

       /usr/share/gok/dictionary.txt   Primary GOK word-completion dictionary

       /usr/share/gok/*.png	       Image files for GOK branching keyboards

       /usr/share/gok/goksound*.wav    Example GOK audio feedback

       /usr/share/gok.rc	       GtkRC file defining GOK color scheme

       See attributes(5) for descriptions of the following attributes:

       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       |Availability		     |SUNWgnome-a11y-gok	   |
       |Interface stability	     |Volatile			   |

       attributes(5), gnome-std-options(5)

       GOK online reference manual.

       Latest version of the GNOME Accessibility Guide for your platform.

       Latest version of the GNOME Desktop User Guide for your platform.


       Written by Bill Haneman and David Bolter, Sun Microsystems Inc., 2004, 2006, 2007.

SunOS 5.11				   12 Nov 2007					   gok(1)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums

All times are GMT -4. The time now is 03:54 AM.