From 153f5cafa19da4e4c0cf21e9c909958359ed8ebd Mon Sep 17 00:00:00 2001 From: marha Date: Wed, 19 May 2010 09:25:26 +0000 Subject: libX11 git update 19/10/2010 --- libX11/man/xkb/Makefile.am | 468 ++++++++--------- libX11/man/xkb/Makefile.in | 708 -------------------------- libX11/man/xkb/XkbFreeGeometry.man | 181 +++---- libX11/man/xkb/XkbGetBounceKeysDelay.man | 424 +++++++-------- libX11/man/xkb/XkbGetDetectableAutorepeat.man | 184 +++---- libX11/man/xkb/XkbGetSlowKeysDelay.man | 430 ++++++++-------- libX11/man/xkb/XkbGetState.man | 110 ++-- libX11/man/xkb/XkbKeyActionEntry.man | 274 +++++----- libX11/man/xkb/XkbSetBounceKeysDelay.man | 414 +++++++-------- libX11/man/xkb/XkbSetDetectableAutorepeat.man | 210 ++++---- 10 files changed, 1348 insertions(+), 2055 deletions(-) delete mode 100644 libX11/man/xkb/Makefile.in (limited to 'libX11/man/xkb') diff --git a/libX11/man/xkb/Makefile.am b/libX11/man/xkb/Makefile.am index a4eaa6bd1..f388248ec 100644 --- a/libX11/man/xkb/Makefile.am +++ b/libX11/man/xkb/Makefile.am @@ -1,234 +1,234 @@ -# Have to fake out automake by calling our man pages "DATA" since "MANS" won't -# accept .3x as a valid man page suffix - -libmandir = $(LIB_MAN_DIR) - -LIB_MAN_DIR_SUFFIX = $(LIB_MAN_DIR:@mandir@/man%=%) - -libman_PRE = \ - XkbActionCtrls.man \ - XkbAddDeviceLedInfo.man \ - XkbAddGeomColor.man \ - XkbAddGeomDoodad.man \ - XkbAddGeomKey.man \ - XkbAddGeomKeyAlias.man \ - XkbAddGeomOutline.man \ - XkbAddGeomOverlay.man \ - XkbAddGeomOverlayKey.man \ - XkbAddGeomOverlayRow.man \ - XkbAddGeomProperty.man \ - XkbAddGeomRow.man \ - XkbAddGeomSection.man \ - XkbAddGeomShape.man \ - XkbAddSymInterpret.man \ - XkbAllocClientMap.man \ - XkbAllocCompatMap.man \ - XkbAllocControls.man \ - XkbAllocDeviceInfo.man \ - XkbAllocDeviceLedInfo.man \ - XkbAllocGeomColors.man \ - XkbAllocGeomDoodads.man \ - XkbAllocGeomKeyAliases.man \ - XkbAllocGeomKeys.man \ - XkbAllocGeomOutlines.man \ - XkbAllocGeomOverlayKey.man \ - XkbAllocGeomOverlayRows.man \ - XkbAllocGeomOverlays.man \ - XkbAllocGeomPoints.man \ - XkbAllocGeomProps.man \ - XkbAllocGeomRows.man \ - XkbAllocGeomSectionDoodads.man \ - XkbAllocGeomSections.man \ - XkbAllocGeomShapes.man \ - XkbAllocGeometry.man \ - XkbAllocIndicatorMaps.man \ - XkbAllocKeyboard.man \ - XkbAllocNames.man \ - XkbAllocServerMap.man \ - XkbApplyCompatMapToKey.man \ - XkbBell.man \ - XkbBellEvent.man \ - XkbChangeControls.man \ - XkbChangeDeviceInfo.man \ - XkbChangeEnabledControls.man \ - XkbChangeIndicators.man \ - XkbChangeMap.man \ - XkbChangeNames.man \ - XkbChangeTypesOfKey.man \ - XkbComputeRowBounds.man \ - XkbComputeSectionBounds.man \ - XkbComputeShapeBounds.man \ - XkbComputeShapeTop.man \ - XkbCopyKeyType.man \ - XkbCopyKeyTypes.man \ - XkbDeviceBell.man \ - XkbDeviceBellEvent.man \ - XkbFindOverlayForKey.man \ - XkbForceBell.man \ - XkbForceDeviceBell.man \ - XkbFreeClientMap.man \ - XkbFreeCompatMap.man \ - XkbFreeComponentList.man \ - XkbFreeControls.man \ - XkbFreeDeviceInfo.man \ - XkbFreeGeomColors.man \ - XkbFreeGeomDoodads.man \ - XkbFreeGeomKeyAliases.man \ - XkbFreeGeomKeys.man \ - XkbFreeGeomOutlines.man \ - XkbFreeGeomOverlayKeys.man \ - XkbFreeGeomOverlayRows.man \ - XkbFreeGeomOverlays.man \ - XkbFreeGeomPoints.man \ - XkbFreeGeomProperties.man \ - XkbFreeGeomRows.man \ - XkbFreeGeomSections.man \ - XkbFreeGeomShapes.man \ - XkbFreeGeometry.man \ - XkbFreeIndicatorMaps.man \ - XkbFreeKeyboard.man \ - XkbFreeNames.man \ - XkbFreeServerMap.man \ - XkbGetAccessXTimeout.man \ - XkbGetAutoRepeatRate.man \ - XkbGetAutoResetControls.man \ - XkbGetBounceKeysDelay.man \ - XkbGetCompatMap.man \ - XkbGetControls.man \ - XkbGetControlsChanges.man \ - XkbGetDetectableAutorepeat.man \ - XkbGetDeviceButtonActions.man \ - XkbGetDeviceInfo.man \ - XkbGetDeviceInfoChanges.man \ - XkbGetDeviceLedInfo.man \ - XkbGetGeometry.man \ - XkbGetIndicatorChanges.man \ - XkbGetIndicatorMap.man \ - XkbGetIndicatorState.man \ - XkbGetKeyActions.man \ - XkbGetKeyBehaviors.man \ - XkbGetKeyExplicitComponents.man \ - XkbGetKeyModifierMap.man \ - XkbGetKeySyms.man \ - XkbGetKeyTypes.man \ - XkbGetKeyVirtualModMap.man \ - XkbGetKeyboard.man \ - XkbGetKeyboardByName.man \ - XkbGetMap.man \ - XkbGetNameChanges.man \ - XkbGetNamedGeometry.man \ - XkbGetNamedIndicator.man \ - XkbGetNames.man \ - XkbGetSlowKeysDelay.man \ - XkbGetState.man \ - XkbGetStickyKeysOptions.man \ - XkbGetUpdatedMap.man \ - XkbGetVirtualMods.man \ - XkbGetXlibControls.man \ - XkbIgnoreExtension.man \ - XkbInitCanonicalKeyTypes.man \ - XkbKeyAction.man \ - XkbKeyActionEntry.man \ - XkbKeyActionsPtr.man \ - XkbKeyGroupInfo.man \ - XkbKeyGroupWidth.man \ - XkbKeyGroupsWidth.man \ - XkbKeyHasActions.man \ - XkbKeyNumActions.man \ - XkbKeyNumGroups.man \ - XkbKeyNumSyms.man \ - XkbKeySymEntry.man \ - XkbKeySymsOffset.man \ - XkbKeySymsPtr.man \ - XkbKeyType.man \ - XkbKeyTypeIndex.man \ - XkbKeyTypesForCoreSymbols.man \ - XkbKeycodeToKeysym.man \ - XkbKeysymToModifiers.man \ - XkbLatchGroup.man \ - XkbLatchModifiers.man \ - XkbLibraryVersion.man \ - XkbListComponents.man \ - XkbLockGroup.man \ - XkbLockModifiers.man \ - XkbLookupKeyBinding.man \ - XkbLookupKeySym.man \ - XkbModActionVMods.man \ - XkbNoteControlsChanges.man \ - XkbNoteDeviceChanges.man \ - XkbNoteIndicatorChanges.man \ - XkbNoteNameChanges.man \ - XkbOpenDisplay.man \ - XkbOutOfRangeGroupInfo.man \ - XkbOutOfRangeGroupNumber.man \ - XkbPtrActionX.man \ - XkbPtrActionY.man \ - XkbQueryExtension.man \ - XkbRefreshKeyboardMapping.man \ - XkbResizeDeviceButtonActions.man \ - XkbResizeKeyActions.man \ - XkbResizeKeySyms.man \ - XkbResizeKeyType.man \ - XkbSAActionSetCtrls.man \ - XkbSAGroup.man \ - XkbSAPtrDfltValue.man \ - XkbSARedirectSetVMods.man \ - XkbSARedirectSetVModsMask.man \ - XkbSARedirectVMods.man \ - XkbSARedirectVModsMask.man \ - XkbSAScreen.man \ - XkbSASetGroup.man \ - XkbSASetPtrDfltValue.man \ - XkbSASetScreen.man \ - XkbSelectEventDetails.man \ - XkbSelectEvents.man \ - XkbSetAccessXTimeout.man \ - XkbSetAutoRepeatRate.man \ - XkbSetAutoResetControls.man \ - XkbSetBounceKeysDelay.man \ - XkbSetCompatMap.man \ - XkbSetControls.man \ - XkbSetDebuggingFlags.man \ - XkbSetDetectableAutorepeat.man \ - XkbSetDeviceButtonActions.man \ - XkbSetDeviceInfo.man \ - XkbSetIgnoreLockMods.man \ - XkbSetIndicatorMap.man \ - XkbSetMap.man \ - XkbSetModActionVMods.man \ - XkbSetNamedIndicator.man \ - XkbSetNames.man \ - XkbSetPtrActionX.man \ - XkbSetPtrActionY.man \ - XkbSetServerInternalMods.man \ - XkbSetXlibControls.man \ - XkbTranslateKeyCode.man \ - XkbTranslateKeySym.man \ - XkbUpdateMapFromCore.man \ - XkbVirtualModsToReal.man - -# What we actually install - -if MANPAGES -libman_DATA = $(libman_PRE:man=@LIB_MAN_SUFFIX@) -endif - -EXTRA_DIST = $(libman_PRE) - -CLEANFILES = $(libman_DATA) - -include $(top_srcdir)/cpprules.in - -SUFFIXES += .$(LIB_MAN_SUFFIX) .man - -XORGRELSTRING = @PACKAGE_STRING@ - XORGMANNAME = X Version 11 - -MANDEFS = -D__libmansuffix__=$(LIB_MAN_SUFFIX) \ - -D__xorgversion__="\"$(XORGRELSTRING)\" \"$(XORGMANNAME)\"" - -CPP_MAN_FLAGS = $(MANDEFS) $(EXTRAMANDEFS) - -.man.$(LIB_MAN_SUFFIX): - $(AM_V_GEN)$(RAWCPP) $(RAWCPPFLAGS) $(CPP_MAN_FLAGS) < $< | $(CPP_SED_MAGIC) > $@ - +# Have to fake out automake by calling our man pages "DATA" since "MANS" won't +# accept .3x as a valid man page suffix + +libmandir = $(LIB_MAN_DIR) + +LIB_MAN_DIR_SUFFIX = $(LIB_MAN_DIR:@mandir@/man%=%) + +libman_PRE = \ + XkbActionCtrls.man \ + XkbAddDeviceLedInfo.man \ + XkbAddGeomColor.man \ + XkbAddGeomDoodad.man \ + XkbAddGeomKey.man \ + XkbAddGeomKeyAlias.man \ + XkbAddGeomOutline.man \ + XkbAddGeomOverlay.man \ + XkbAddGeomOverlayKey.man \ + XkbAddGeomOverlayRow.man \ + XkbAddGeomProperty.man \ + XkbAddGeomRow.man \ + XkbAddGeomSection.man \ + XkbAddGeomShape.man \ + XkbAddSymInterpret.man \ + XkbAllocClientMap.man \ + XkbAllocCompatMap.man \ + XkbAllocControls.man \ + XkbAllocDeviceInfo.man \ + XkbAllocDeviceLedInfo.man \ + XkbAllocGeomColors.man \ + XkbAllocGeomDoodads.man \ + XkbAllocGeomKeyAliases.man \ + XkbAllocGeomKeys.man \ + XkbAllocGeomOutlines.man \ + XkbAllocGeomOverlayKey.man \ + XkbAllocGeomOverlayRows.man \ + XkbAllocGeomOverlays.man \ + XkbAllocGeomPoints.man \ + XkbAllocGeomProps.man \ + XkbAllocGeomRows.man \ + XkbAllocGeomSectionDoodads.man \ + XkbAllocGeomSections.man \ + XkbAllocGeomShapes.man \ + XkbAllocGeometry.man \ + XkbAllocIndicatorMaps.man \ + XkbAllocKeyboard.man \ + XkbAllocNames.man \ + XkbAllocServerMap.man \ + XkbApplyCompatMapToKey.man \ + XkbBell.man \ + XkbBellEvent.man \ + XkbChangeControls.man \ + XkbChangeDeviceInfo.man \ + XkbChangeEnabledControls.man \ + XkbChangeIndicators.man \ + XkbChangeMap.man \ + XkbChangeNames.man \ + XkbChangeTypesOfKey.man \ + XkbComputeRowBounds.man \ + XkbComputeSectionBounds.man \ + XkbComputeShapeBounds.man \ + XkbComputeShapeTop.man \ + XkbCopyKeyType.man \ + XkbCopyKeyTypes.man \ + XkbDeviceBell.man \ + XkbDeviceBellEvent.man \ + XkbFindOverlayForKey.man \ + XkbForceBell.man \ + XkbForceDeviceBell.man \ + XkbFreeClientMap.man \ + XkbFreeCompatMap.man \ + XkbFreeComponentList.man \ + XkbFreeControls.man \ + XkbFreeDeviceInfo.man \ + XkbFreeGeomColors.man \ + XkbFreeGeomDoodads.man \ + XkbFreeGeomKeyAliases.man \ + XkbFreeGeomKeys.man \ + XkbFreeGeomOutlines.man \ + XkbFreeGeomOverlayKeys.man \ + XkbFreeGeomOverlayRows.man \ + XkbFreeGeomOverlays.man \ + XkbFreeGeomPoints.man \ + XkbFreeGeomProperties.man \ + XkbFreeGeomRows.man \ + XkbFreeGeomSections.man \ + XkbFreeGeomShapes.man \ + XkbFreeGeometry.man \ + XkbFreeIndicatorMaps.man \ + XkbFreeKeyboard.man \ + XkbFreeNames.man \ + XkbFreeServerMap.man \ + XkbGetAccessXTimeout.man \ + XkbGetAutoRepeatRate.man \ + XkbGetAutoResetControls.man \ + XkbGetBounceKeysDelay.man \ + XkbGetCompatMap.man \ + XkbGetControls.man \ + XkbGetControlsChanges.man \ + XkbGetDetectableAutoRepeat.man \ + XkbGetDeviceButtonActions.man \ + XkbGetDeviceInfo.man \ + XkbGetDeviceInfoChanges.man \ + XkbGetDeviceLedInfo.man \ + XkbGetGeometry.man \ + XkbGetIndicatorChanges.man \ + XkbGetIndicatorMap.man \ + XkbGetIndicatorState.man \ + XkbGetKeyActions.man \ + XkbGetKeyBehaviors.man \ + XkbGetKeyExplicitComponents.man \ + XkbGetKeyModifierMap.man \ + XkbGetKeySyms.man \ + XkbGetKeyTypes.man \ + XkbGetKeyVirtualModMap.man \ + XkbGetKeyboard.man \ + XkbGetKeyboardByName.man \ + XkbGetMap.man \ + XkbGetNameChanges.man \ + XkbGetNamedGeometry.man \ + XkbGetNamedIndicator.man \ + XkbGetNames.man \ + XkbGetSlowKeysDelay.man \ + XkbGetState.man \ + XkbGetStickyKeysOptions.man \ + XkbGetUpdatedMap.man \ + XkbGetVirtualMods.man \ + XkbGetXlibControls.man \ + XkbIgnoreExtension.man \ + XkbInitCanonicalKeyTypes.man \ + XkbKeyAction.man \ + XkbKeyActionEntry.man \ + XkbKeyActionsPtr.man \ + XkbKeyGroupInfo.man \ + XkbKeyGroupWidth.man \ + XkbKeyGroupsWidth.man \ + XkbKeyHasActions.man \ + XkbKeyNumActions.man \ + XkbKeyNumGroups.man \ + XkbKeyNumSyms.man \ + XkbKeySymEntry.man \ + XkbKeySymsOffset.man \ + XkbKeySymsPtr.man \ + XkbKeyType.man \ + XkbKeyTypeIndex.man \ + XkbKeyTypesForCoreSymbols.man \ + XkbKeycodeToKeysym.man \ + XkbKeysymToModifiers.man \ + XkbLatchGroup.man \ + XkbLatchModifiers.man \ + XkbLibraryVersion.man \ + XkbListComponents.man \ + XkbLockGroup.man \ + XkbLockModifiers.man \ + XkbLookupKeyBinding.man \ + XkbLookupKeySym.man \ + XkbModActionVMods.man \ + XkbNoteControlsChanges.man \ + XkbNoteDeviceChanges.man \ + XkbNoteIndicatorChanges.man \ + XkbNoteNameChanges.man \ + XkbOpenDisplay.man \ + XkbOutOfRangeGroupInfo.man \ + XkbOutOfRangeGroupNumber.man \ + XkbPtrActionX.man \ + XkbPtrActionY.man \ + XkbQueryExtension.man \ + XkbRefreshKeyboardMapping.man \ + XkbResizeDeviceButtonActions.man \ + XkbResizeKeyActions.man \ + XkbResizeKeySyms.man \ + XkbResizeKeyType.man \ + XkbSAActionSetCtrls.man \ + XkbSAGroup.man \ + XkbSAPtrDfltValue.man \ + XkbSARedirectSetVMods.man \ + XkbSARedirectSetVModsMask.man \ + XkbSARedirectVMods.man \ + XkbSARedirectVModsMask.man \ + XkbSAScreen.man \ + XkbSASetGroup.man \ + XkbSASetPtrDfltValue.man \ + XkbSASetScreen.man \ + XkbSelectEventDetails.man \ + XkbSelectEvents.man \ + XkbSetAccessXTimeout.man \ + XkbSetAutoRepeatRate.man \ + XkbSetAutoResetControls.man \ + XkbSetBounceKeysDelay.man \ + XkbSetCompatMap.man \ + XkbSetControls.man \ + XkbSetDebuggingFlags.man \ + XkbSetDetectableAutoRepeat.man \ + XkbSetDeviceButtonActions.man \ + XkbSetDeviceInfo.man \ + XkbSetIgnoreLockMods.man \ + XkbSetIndicatorMap.man \ + XkbSetMap.man \ + XkbSetModActionVMods.man \ + XkbSetNamedIndicator.man \ + XkbSetNames.man \ + XkbSetPtrActionX.man \ + XkbSetPtrActionY.man \ + XkbSetServerInternalMods.man \ + XkbSetXlibControls.man \ + XkbTranslateKeyCode.man \ + XkbTranslateKeySym.man \ + XkbUpdateMapFromCore.man \ + XkbVirtualModsToReal.man + +# What we actually install + +if MANPAGES +libman_DATA = $(libman_PRE:man=@LIB_MAN_SUFFIX@) +endif + +EXTRA_DIST = $(libman_PRE) + +CLEANFILES = $(libman_DATA) + +include $(top_srcdir)/cpprules.in + +SUFFIXES += .$(LIB_MAN_SUFFIX) .man + +XORGRELSTRING = @PACKAGE_STRING@ + XORGMANNAME = X Version 11 + +MANDEFS = -D__libmansuffix__=$(LIB_MAN_SUFFIX) \ + -D__xorgversion__="\"$(XORGRELSTRING)\" \"$(XORGMANNAME)\"" + +CPP_MAN_FLAGS = $(MANDEFS) $(EXTRAMANDEFS) + +.man.$(LIB_MAN_SUFFIX): + $(AM_V_GEN)$(RAWCPP) $(RAWCPPFLAGS) $(CPP_MAN_FLAGS) < $< | $(CPP_SED_MAGIC) > $@ + diff --git a/libX11/man/xkb/Makefile.in b/libX11/man/xkb/Makefile.in deleted file mode 100644 index 2cef92d8e..000000000 --- a/libX11/man/xkb/Makefile.in +++ /dev/null @@ -1,708 +0,0 @@ -# Makefile.in generated by automake 1.11.1 from Makefile.am. -# @configure_input@ - -# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, -# 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, -# Inc. -# This Makefile.in is free software; the Free Software Foundation -# gives unlimited permission to copy and/or distribute it, -# with or without modifications, as long as this notice is preserved. - -# This program is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY, to the extent permitted by law; without -# even the implied warranty of MERCHANTABILITY or FITNESS FOR A -# PARTICULAR PURPOSE. - -@SET_MAKE@ - -# Have to fake out automake by calling our man pages "DATA" since "MANS" won't -# accept .3x as a valid man page suffix - -# -*- Makefile -*- -# Rules for generating files using the C pre-processor -# (Replaces CppFileTarget from Imake) - -VPATH = @srcdir@ -pkgdatadir = $(datadir)/@PACKAGE@ -pkgincludedir = $(includedir)/@PACKAGE@ -pkglibdir = $(libdir)/@PACKAGE@ -pkglibexecdir = $(libexecdir)/@PACKAGE@ -am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd -install_sh_DATA = $(install_sh) -c -m 644 -install_sh_PROGRAM = $(install_sh) -c -install_sh_SCRIPT = $(install_sh) -c -INSTALL_HEADER = $(INSTALL_DATA) -transform = $(program_transform_name) -NORMAL_INSTALL = : -PRE_INSTALL = : -POST_INSTALL = : -NORMAL_UNINSTALL = : -PRE_UNINSTALL = : -POST_UNINSTALL = : -build_triplet = @build@ -host_triplet = @host@ -DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in \ - $(top_srcdir)/cpprules.in -subdir = man/xkb -ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -am__aclocal_m4_deps = $(top_srcdir)/acinclude.m4 \ - $(top_srcdir)/configure.ac -am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ - $(ACLOCAL_M4) -mkinstalldirs = $(install_sh) -d -CONFIG_HEADER = $(top_builddir)/src/config.h \ - $(top_builddir)/include/X11/XlibConf.h -CONFIG_CLEAN_FILES = -CONFIG_CLEAN_VPATH_FILES = -AM_V_GEN = $(am__v_GEN_$(V)) -am__v_GEN_ = $(am__v_GEN_$(AM_DEFAULT_VERBOSITY)) -am__v_GEN_0 = @echo " GEN " $@; -AM_V_at = $(am__v_at_$(V)) -am__v_at_ = $(am__v_at_$(AM_DEFAULT_VERBOSITY)) -am__v_at_0 = @ -SOURCES = -DIST_SOURCES = -am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; -am__vpath_adj = case $$p in \ - $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \ - *) f=$$p;; \ - esac; -am__strip_dir = f=`echo $$p | sed -e 's|^.*/||'`; -am__install_max = 40 -am__nobase_strip_setup = \ - srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*|]/\\\\&/g'` -am__nobase_strip = \ - for p in $$list; do echo "$$p"; done | sed -e "s|$$srcdirstrip/||" -am__nobase_list = $(am__nobase_strip_setup); \ - for p in $$list; do echo "$$p $$p"; done | \ - sed "s| $$srcdirstrip/| |;"' / .*\//!s/ .*/ ./; s,\( .*\)/[^/]*$$,\1,' | \ - $(AWK) 'BEGIN { files["."] = "" } { files[$$2] = files[$$2] " " $$1; \ - if (++n[$$2] == $(am__install_max)) \ - { print $$2, files[$$2]; n[$$2] = 0; files[$$2] = "" } } \ - END { for (dir in files) print dir, files[dir] }' -am__base_list = \ - sed '$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;s/\n/ /g' | \ - sed '$$!N;$$!N;$$!N;$$!N;s/\n/ /g' -am__installdirs = "$(DESTDIR)$(libmandir)" -DATA = $(libman_DATA) -DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) -ACLOCAL = @ACLOCAL@ -ADMIN_MAN_DIR = @ADMIN_MAN_DIR@ -ADMIN_MAN_SUFFIX = @ADMIN_MAN_SUFFIX@ -AMTAR = @AMTAR@ -AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@ -APP_MAN_DIR = @APP_MAN_DIR@ -APP_MAN_SUFFIX = @APP_MAN_SUFFIX@ -AR = @AR@ -AUTOCONF = @AUTOCONF@ -AUTOHEADER = @AUTOHEADER@ -AUTOMAKE = @AUTOMAKE@ -AWK = @AWK@ -BIGFONT_CFLAGS = @BIGFONT_CFLAGS@ -BIGFONT_LIBS = @BIGFONT_LIBS@ -CC = @CC@ -CCDEPMODE = @CCDEPMODE@ -CC_FOR_BUILD = @CC_FOR_BUILD@ -CFLAGS = @CFLAGS@ -CHANGELOG_CMD = @CHANGELOG_CMD@ -CPP = @CPP@ -CPPFLAGS = @CPPFLAGS@ -CWARNFLAGS = @CWARNFLAGS@ -CXX = @CXX@ -CXXCPP = @CXXCPP@ -CXXDEPMODE = @CXXDEPMODE@ -CXXFLAGS = @CXXFLAGS@ -CYGPATH_W = @CYGPATH_W@ -DEFS = @DEFS@ -DEPDIR = @DEPDIR@ -DOLT_BASH = @DOLT_BASH@ -DRIVER_MAN_DIR = @DRIVER_MAN_DIR@ -DRIVER_MAN_SUFFIX = @DRIVER_MAN_SUFFIX@ -DSYMUTIL = @DSYMUTIL@ -ECHO = @ECHO@ -ECHO_C = @ECHO_C@ -ECHO_N = @ECHO_N@ -ECHO_T = @ECHO_T@ -EGREP = @EGREP@ -EXEEXT = @EXEEXT@ -F77 = @F77@ -FFLAGS = @FFLAGS@ -FILE_MAN_DIR = @FILE_MAN_DIR@ -FILE_MAN_SUFFIX = @FILE_MAN_SUFFIX@ -GREP = @GREP@ -GROFF = @GROFF@ -I18N_MODULE_LIBS = @I18N_MODULE_LIBS@ -INSTALL = @INSTALL@ -INSTALL_CMD = @INSTALL_CMD@ -INSTALL_DATA = @INSTALL_DATA@ -INSTALL_PROGRAM = @INSTALL_PROGRAM@ -INSTALL_SCRIPT = @INSTALL_SCRIPT@ -INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ -KEYSYMDEF = @KEYSYMDEF@ -LAUNCHD = @LAUNCHD@ -LDFLAGS = @LDFLAGS@ -LIBOBJS = @LIBOBJS@ -LIBS = @LIBS@ -LIBTOOL = @LIBTOOL@ -LIB_MAN_DIR = @LIB_MAN_DIR@ -LIB_MAN_SUFFIX = @LIB_MAN_SUFFIX@ -LINT = @LINT@ -LINTLIB = @LINTLIB@ -LINT_FLAGS = @LINT_FLAGS@ -LN_S = @LN_S@ -LTCOMPILE = @LTCOMPILE@ -LTCXXCOMPILE = @LTCXXCOMPILE@ -LTLIBOBJS = @LTLIBOBJS@ -MAINT = @MAINT@ -MAKEINFO = @MAKEINFO@ -MALLOC_ZERO_CFLAGS = @MALLOC_ZERO_CFLAGS@ -MISC_MAN_DIR = @MISC_MAN_DIR@ -MISC_MAN_SUFFIX = @MISC_MAN_SUFFIX@ -MKDIR_P = @MKDIR_P@ -NMEDIT = @NMEDIT@ -OBJEXT = @OBJEXT@ -PACKAGE = @PACKAGE@ -PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ -PACKAGE_NAME = @PACKAGE_NAME@ -PACKAGE_STRING = @PACKAGE_STRING@ -PACKAGE_TARNAME = @PACKAGE_TARNAME@ -PACKAGE_URL = @PACKAGE_URL@ -PACKAGE_VERSION = @PACKAGE_VERSION@ -PATH_SEPARATOR = @PATH_SEPARATOR@ -PERL = @PERL@ -PKG_CONFIG = @PKG_CONFIG@ -PS2PDF = @PS2PDF@ -RANLIB = @RANLIB@ -RAWCPP = @RAWCPP@ -RAWCPPFLAGS = @RAWCPPFLAGS@ -SED = sed -SET_MAKE = @SET_MAKE@ -SHELL = @SHELL@ -STRIP = @STRIP@ -VERSION = @VERSION@ -WCHAR32 = @WCHAR32@ -X11_CFLAGS = @X11_CFLAGS@ -X11_DATADIR = @X11_DATADIR@ -X11_EXTRA_DEPS = @X11_EXTRA_DEPS@ -X11_LIBDIR = @X11_LIBDIR@ -X11_LIBS = @X11_LIBS@ -X11_LOCALEDATADIR = @X11_LOCALEDATADIR@ -X11_LOCALEDIR = @X11_LOCALEDIR@ -X11_LOCALELIBDIR = @X11_LOCALELIBDIR@ -XDMCP_CFLAGS = @XDMCP_CFLAGS@ -XDMCP_LIBS = @XDMCP_LIBS@ -XERRORDB = @XERRORDB@ -XKBPROTO_REQUIRES = @XKBPROTO_REQUIRES@ -XKEYSYMDB = @XKEYSYMDB@ -XLOCALEDATADIR = @XLOCALEDATADIR@ -XLOCALEDIR = @XLOCALEDIR@ -XLOCALELIBDIR = @XLOCALELIBDIR@ -XMALLOC_ZERO_CFLAGS = @XMALLOC_ZERO_CFLAGS@ -XTHREADLIB = @XTHREADLIB@ -XTHREAD_CFLAGS = @XTHREAD_CFLAGS@ -XTMALLOC_ZERO_CFLAGS = @XTMALLOC_ZERO_CFLAGS@ -abs_builddir = @abs_builddir@ -abs_srcdir = @abs_srcdir@ -abs_top_builddir = @abs_top_builddir@ -abs_top_srcdir = @abs_top_srcdir@ -ac_ct_CC = @ac_ct_CC@ -ac_ct_CXX = @ac_ct_CXX@ -ac_ct_F77 = @ac_ct_F77@ -am__include = @am__include@ -am__leading_dot = @am__leading_dot@ -am__quote = @am__quote@ -am__tar = @am__tar@ -am__untar = @am__untar@ -bindir = @bindir@ -build = @build@ -build_alias = @build_alias@ -build_cpu = @build_cpu@ -build_os = @build_os@ -build_vendor = @build_vendor@ -builddir = @builddir@ -datadir = @datadir@ -datarootdir = @datarootdir@ -docdir = @docdir@ -dvidir = @dvidir@ -exec_prefix = @exec_prefix@ -host = @host@ -host_alias = @host_alias@ -host_cpu = @host_cpu@ -host_os = @host_os@ -host_vendor = @host_vendor@ -htmldir = @htmldir@ -includedir = @includedir@ -infodir = @infodir@ -install_sh = @install_sh@ -libdir = @libdir@ -libexecdir = @libexecdir@ -localedir = @localedir@ -localstatedir = @localstatedir@ -mandir = @mandir@ -mkdir_p = @mkdir_p@ -oldincludedir = @oldincludedir@ -pdfdir = @pdfdir@ -prefix = @prefix@ -program_transform_name = @program_transform_name@ -psdir = @psdir@ -sbindir = @sbindir@ -sharedstatedir = @sharedstatedir@ -srcdir = @srcdir@ -sysconfdir = @sysconfdir@ -target_alias = @target_alias@ -top_build_prefix = @top_build_prefix@ -top_builddir = @top_builddir@ -top_srcdir = @top_srcdir@ -libmandir = $(LIB_MAN_DIR) -LIB_MAN_DIR_SUFFIX = $(LIB_MAN_DIR:@mandir@/man%=%) -libman_PRE = \ - XkbActionCtrls.man \ - XkbAddDeviceLedInfo.man \ - XkbAddGeomColor.man \ - XkbAddGeomDoodad.man \ - XkbAddGeomKey.man \ - XkbAddGeomKeyAlias.man \ - XkbAddGeomOutline.man \ - XkbAddGeomOverlay.man \ - XkbAddGeomOverlayKey.man \ - XkbAddGeomOverlayRow.man \ - XkbAddGeomProperty.man \ - XkbAddGeomRow.man \ - XkbAddGeomSection.man \ - XkbAddGeomShape.man \ - XkbAddSymInterpret.man \ - XkbAllocClientMap.man \ - XkbAllocCompatMap.man \ - XkbAllocControls.man \ - XkbAllocDeviceInfo.man \ - XkbAllocDeviceLedInfo.man \ - XkbAllocGeomColors.man \ - XkbAllocGeomDoodads.man \ - XkbAllocGeomKeyAliases.man \ - XkbAllocGeomKeys.man \ - XkbAllocGeomOutlines.man \ - XkbAllocGeomOverlayKey.man \ - XkbAllocGeomOverlayRows.man \ - XkbAllocGeomOverlays.man \ - XkbAllocGeomPoints.man \ - XkbAllocGeomProps.man \ - XkbAllocGeomRows.man \ - XkbAllocGeomSectionDoodads.man \ - XkbAllocGeomSections.man \ - XkbAllocGeomShapes.man \ - XkbAllocGeometry.man \ - XkbAllocIndicatorMaps.man \ - XkbAllocKeyboard.man \ - XkbAllocNames.man \ - XkbAllocServerMap.man \ - XkbApplyCompatMapToKey.man \ - XkbBell.man \ - XkbBellEvent.man \ - XkbChangeControls.man \ - XkbChangeDeviceInfo.man \ - XkbChangeEnabledControls.man \ - XkbChangeIndicators.man \ - XkbChangeMap.man \ - XkbChangeNames.man \ - XkbChangeTypesOfKey.man \ - XkbComputeRowBounds.man \ - XkbComputeSectionBounds.man \ - XkbComputeShapeBounds.man \ - XkbComputeShapeTop.man \ - XkbCopyKeyType.man \ - XkbCopyKeyTypes.man \ - XkbDeviceBell.man \ - XkbDeviceBellEvent.man \ - XkbFindOverlayForKey.man \ - XkbForceBell.man \ - XkbForceDeviceBell.man \ - XkbFreeClientMap.man \ - XkbFreeCompatMap.man \ - XkbFreeComponentList.man \ - XkbFreeControls.man \ - XkbFreeDeviceInfo.man \ - XkbFreeGeomColors.man \ - XkbFreeGeomDoodads.man \ - XkbFreeGeomKeyAliases.man \ - XkbFreeGeomKeys.man \ - XkbFreeGeomOutlines.man \ - XkbFreeGeomOverlayKeys.man \ - XkbFreeGeomOverlayRows.man \ - XkbFreeGeomOverlays.man \ - XkbFreeGeomPoints.man \ - XkbFreeGeomProperties.man \ - XkbFreeGeomRows.man \ - XkbFreeGeomSections.man \ - XkbFreeGeomShapes.man \ - XkbFreeGeometry.man \ - XkbFreeIndicatorMaps.man \ - XkbFreeKeyboard.man \ - XkbFreeNames.man \ - XkbFreeServerMap.man \ - XkbGetAccessXTimeout.man \ - XkbGetAutoRepeatRate.man \ - XkbGetAutoResetControls.man \ - XkbGetBounceKeysDelay.man \ - XkbGetCompatMap.man \ - XkbGetControls.man \ - XkbGetControlsChanges.man \ - XkbGetDetectableAutorepeat.man \ - XkbGetDeviceButtonActions.man \ - XkbGetDeviceInfo.man \ - XkbGetDeviceInfoChanges.man \ - XkbGetDeviceLedInfo.man \ - XkbGetGeometry.man \ - XkbGetIndicatorChanges.man \ - XkbGetIndicatorMap.man \ - XkbGetIndicatorState.man \ - XkbGetKeyActions.man \ - XkbGetKeyBehaviors.man \ - XkbGetKeyExplicitComponents.man \ - XkbGetKeyModifierMap.man \ - XkbGetKeySyms.man \ - XkbGetKeyTypes.man \ - XkbGetKeyVirtualModMap.man \ - XkbGetKeyboard.man \ - XkbGetKeyboardByName.man \ - XkbGetMap.man \ - XkbGetNameChanges.man \ - XkbGetNamedGeometry.man \ - XkbGetNamedIndicator.man \ - XkbGetNames.man \ - XkbGetSlowKeysDelay.man \ - XkbGetState.man \ - XkbGetStickyKeysOptions.man \ - XkbGetUpdatedMap.man \ - XkbGetVirtualMods.man \ - XkbGetXlibControls.man \ - XkbIgnoreExtension.man \ - XkbInitCanonicalKeyTypes.man \ - XkbKeyAction.man \ - XkbKeyActionEntry.man \ - XkbKeyActionsPtr.man \ - XkbKeyGroupInfo.man \ - XkbKeyGroupWidth.man \ - XkbKeyGroupsWidth.man \ - XkbKeyHasActions.man \ - XkbKeyNumActions.man \ - XkbKeyNumGroups.man \ - XkbKeyNumSyms.man \ - XkbKeySymEntry.man \ - XkbKeySymsOffset.man \ - XkbKeySymsPtr.man \ - XkbKeyType.man \ - XkbKeyTypeIndex.man \ - XkbKeyTypesForCoreSymbols.man \ - XkbKeycodeToKeysym.man \ - XkbKeysymToModifiers.man \ - XkbLatchGroup.man \ - XkbLatchModifiers.man \ - XkbLibraryVersion.man \ - XkbListComponents.man \ - XkbLockGroup.man \ - XkbLockModifiers.man \ - XkbLookupKeyBinding.man \ - XkbLookupKeySym.man \ - XkbModActionVMods.man \ - XkbNoteControlsChanges.man \ - XkbNoteDeviceChanges.man \ - XkbNoteIndicatorChanges.man \ - XkbNoteNameChanges.man \ - XkbOpenDisplay.man \ - XkbOutOfRangeGroupInfo.man \ - XkbOutOfRangeGroupNumber.man \ - XkbPtrActionX.man \ - XkbPtrActionY.man \ - XkbQueryExtension.man \ - XkbRefreshKeyboardMapping.man \ - XkbResizeDeviceButtonActions.man \ - XkbResizeKeyActions.man \ - XkbResizeKeySyms.man \ - XkbResizeKeyType.man \ - XkbSAActionSetCtrls.man \ - XkbSAGroup.man \ - XkbSAPtrDfltValue.man \ - XkbSARedirectSetVMods.man \ - XkbSARedirectSetVModsMask.man \ - XkbSARedirectVMods.man \ - XkbSARedirectVModsMask.man \ - XkbSAScreen.man \ - XkbSASetGroup.man \ - XkbSASetPtrDfltValue.man \ - XkbSASetScreen.man \ - XkbSelectEventDetails.man \ - XkbSelectEvents.man \ - XkbSetAccessXTimeout.man \ - XkbSetAutoRepeatRate.man \ - XkbSetAutoResetControls.man \ - XkbSetBounceKeysDelay.man \ - XkbSetCompatMap.man \ - XkbSetControls.man \ - XkbSetDebuggingFlags.man \ - XkbSetDetectableAutorepeat.man \ - XkbSetDeviceButtonActions.man \ - XkbSetDeviceInfo.man \ - XkbSetIgnoreLockMods.man \ - XkbSetIndicatorMap.man \ - XkbSetMap.man \ - XkbSetModActionVMods.man \ - XkbSetNamedIndicator.man \ - XkbSetNames.man \ - XkbSetPtrActionX.man \ - XkbSetPtrActionY.man \ - XkbSetServerInternalMods.man \ - XkbSetXlibControls.man \ - XkbTranslateKeyCode.man \ - XkbTranslateKeySym.man \ - XkbUpdateMapFromCore.man \ - XkbVirtualModsToReal.man - - -# What we actually install -@MANPAGES_TRUE@libman_DATA = $(libman_PRE:man=@LIB_MAN_SUFFIX@) -EXTRA_DIST = $(libman_PRE) -CLEANFILES = $(libman_DATA) -SUFFIXES = .pre .$(LIB_MAN_SUFFIX) .man -WCHAR32_FLAGS = -DWCHAR32=@WCHAR32@ -CPP_FILES_FLAGS = $(WCHAR32_FLAGS) - -# Translate XCOMM into pound sign with sed, rather than passing -DXCOMM=XCOMM -# to cpp, because that trick does not work on all ANSI C preprocessors. -# Delete line numbers from the cpp output (-P is not portable, I guess). -# Allow XCOMM to be preceded by whitespace and provide a means of generating -# output lines with trailing backslashes. -# Allow XHASH to always be substituted, even in cases where XCOMM isn't. -CPP_SED_MAGIC = $(SED) -e '/^\# *[0-9][0-9]* *.*$$/d' \ - -e '/^\#line *[0-9][0-9]* *.*$$/d' \ - -e '/^[ ]*XCOMM$$/s/XCOMM/\#/' \ - -e '/^[ ]*XCOMM[^a-zA-Z0-9_]/s/XCOMM/\#/' \ - -e '/^[ ]*XHASH/s/XHASH/\#/' \ - -e 's,X11_LOCALEDATADIR,$(X11_LOCALEDATADIR),g' \ - -e '/\@\@$$/s/\@\@$$/\\/' - -XORGRELSTRING = @PACKAGE_STRING@ -XORGMANNAME = X Version 11 -MANDEFS = -D__libmansuffix__=$(LIB_MAN_SUFFIX) \ - -D__xorgversion__="\"$(XORGRELSTRING)\" \"$(XORGMANNAME)\"" - -CPP_MAN_FLAGS = $(MANDEFS) $(EXTRAMANDEFS) -all: all-am - -.SUFFIXES: -.SUFFIXES: .pre .$(LIB_MAN_SUFFIX) .man -$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir)/cpprules.in $(am__configure_deps) - @for dep in $?; do \ - case '$(am__configure_deps)' in \ - *$$dep*) \ - ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \ - && { if test -f $@; then exit 0; else break; fi; }; \ - exit 1;; \ - esac; \ - done; \ - echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign man/xkb/Makefile'; \ - $(am__cd) $(top_srcdir) && \ - $(AUTOMAKE) --foreign man/xkb/Makefile -.PRECIOUS: Makefile -Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status - @case '$?' in \ - *config.status*) \ - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ - *) \ - echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ - cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ - esac; - -$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh - -$(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps) - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh -$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps) - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh -$(am__aclocal_m4_deps): - -mostlyclean-libtool: - -rm -f *.lo - -clean-libtool: - -rm -rf .libs _libs -install-libmanDATA: $(libman_DATA) - @$(NORMAL_INSTALL) - test -z "$(libmandir)" || $(MKDIR_P) "$(DESTDIR)$(libmandir)" - @list='$(libman_DATA)'; test -n "$(libmandir)" || list=; \ - for p in $$list; do \ - if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \ - echo "$$d$$p"; \ - done | $(am__base_list) | \ - while read files; do \ - echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(libmandir)'"; \ - $(INSTALL_DATA) $$files "$(DESTDIR)$(libmandir)" || exit $$?; \ - done - -uninstall-libmanDATA: - @$(NORMAL_UNINSTALL) - @list='$(libman_DATA)'; test -n "$(libmandir)" || list=; \ - files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \ - test -n "$$files" || exit 0; \ - echo " ( cd '$(DESTDIR)$(libmandir)' && rm -f" $$files ")"; \ - cd "$(DESTDIR)$(libmandir)" && rm -f $$files -tags: TAGS -TAGS: - -ctags: CTAGS -CTAGS: - - -distdir: $(DISTFILES) - @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ - topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ - list='$(DISTFILES)'; \ - dist_files=`for file in $$list; do echo $$file; done | \ - sed -e "s|^$$srcdirstrip/||;t" \ - -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \ - case $$dist_files in \ - */*) $(MKDIR_P) `echo "$$dist_files" | \ - sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \ - sort -u` ;; \ - esac; \ - for file in $$dist_files; do \ - if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ - if test -d $$d/$$file; then \ - dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \ - if test -d "$(distdir)/$$file"; then \ - find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ - fi; \ - if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ - cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \ - find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ - fi; \ - cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \ - else \ - test -f "$(distdir)/$$file" \ - || cp -p $$d/$$file "$(distdir)/$$file" \ - || exit 1; \ - fi; \ - done -check-am: all-am -check: check-am -all-am: Makefile $(DATA) -installdirs: - for dir in "$(DESTDIR)$(libmandir)"; do \ - test -z "$$dir" || $(MKDIR_P) "$$dir"; \ - done -install: install-am -install-exec: install-exec-am -install-data: install-data-am -uninstall: uninstall-am - -install-am: all-am - @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am - -installcheck: installcheck-am -install-strip: - $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ - install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ - `test -z '$(STRIP)' || \ - echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install -mostlyclean-generic: - -clean-generic: - -test -z "$(CLEANFILES)" || rm -f $(CLEANFILES) - -distclean-generic: - -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) - -test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES) - -maintainer-clean-generic: - @echo "This command is intended for maintainers to use" - @echo "it deletes files that may require special tools to rebuild." -clean: clean-am - -clean-am: clean-generic clean-libtool mostlyclean-am - -distclean: distclean-am - -rm -f Makefile -distclean-am: clean-am distclean-generic - -dvi: dvi-am - -dvi-am: - -html: html-am - -html-am: - -info: info-am - -info-am: - -install-data-am: install-libmanDATA - -install-dvi: install-dvi-am - -install-dvi-am: - -install-exec-am: - -install-html: install-html-am - -install-html-am: - -install-info: install-info-am - -install-info-am: - -install-man: - -install-pdf: install-pdf-am - -install-pdf-am: - -install-ps: install-ps-am - -install-ps-am: - -installcheck-am: - -maintainer-clean: maintainer-clean-am - -rm -f Makefile -maintainer-clean-am: distclean-am maintainer-clean-generic - -mostlyclean: mostlyclean-am - -mostlyclean-am: mostlyclean-generic mostlyclean-libtool - -pdf: pdf-am - -pdf-am: - -ps: ps-am - -ps-am: - -uninstall-am: uninstall-libmanDATA - -.MAKE: install-am install-strip - -.PHONY: all all-am check check-am clean clean-generic clean-libtool \ - distclean distclean-generic distclean-libtool distdir dvi \ - dvi-am html html-am info info-am install install-am \ - install-data install-data-am install-dvi install-dvi-am \ - install-exec install-exec-am install-html install-html-am \ - install-info install-info-am install-libmanDATA install-man \ - install-pdf install-pdf-am install-ps install-ps-am \ - install-strip installcheck installcheck-am installdirs \ - maintainer-clean maintainer-clean-generic mostlyclean \ - mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ - uninstall uninstall-am uninstall-libmanDATA - - -.pre: - $(AM_V_GEN)$(RAWCPP) $(RAWCPPFLAGS) $(CPP_FILES_FLAGS) < $< | $(CPP_SED_MAGIC) > $@ - -.man.$(LIB_MAN_SUFFIX): - $(AM_V_GEN)$(RAWCPP) $(RAWCPPFLAGS) $(CPP_MAN_FLAGS) < $< | $(CPP_SED_MAGIC) > $@ - -# Tell versions [3.59,3.63) of GNU make to not export all variables. -# Otherwise a system limit (for SysV at least) may be exceeded. -.NOEXPORT: diff --git a/libX11/man/xkb/XkbFreeGeometry.man b/libX11/man/xkb/XkbFreeGeometry.man index 6ce7986a3..636b16ce4 100644 --- a/libX11/man/xkb/XkbFreeGeometry.man +++ b/libX11/man/xkb/XkbFreeGeometry.man @@ -1,90 +1,91 @@ -.\" Copyright 1999 Sun Microsystems, Inc. All rights reserved. -.\" -.\" Permission is hereby granted, free of charge, to any person obtaining a -.\" copy of this software and associated documentation files (the "Software"), -.\" to deal in the Software without restriction, including without limitation -.\" the rights to use, copy, modify, merge, publish, distribute, sublicense, -.\" and/or sell copies of the Software, and to permit persons to whom the -.\" Software is furnished to do so, subject to the following conditions: -.\" -.\" The above copyright notice and this permission notice (including the next -.\" paragraph) shall be included in all copies or substantial portions of the -.\" Software. -.\" -.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL -.\" THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -.\" LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -.\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER -.\" DEALINGS IN THE SOFTWARE. -.\" -.TH XkbFreeGeometry __libmansuffix__ __xorgversion__ "XKB FUNCTIONS" -.SH NAME -XkbFreeGeometry \- Free an entire geometry -.SH SYNOPSIS -.HP -.B void XkbFreeGeometry -.BI "(\^XkbGeometryPtr " "geom" "\^," -.BI "unsigned int " "which" "\^," -.BI "Bool " "free_all" "\^);" -.if n .ti +5n -.if t .ti +.5i -.SH ARGUMENTS -.TP -.I \- geom -geometry to be freed -.TP -.I \- which -mask of geometry components to be freed -.TP -.I \- free_all -True => the entire geometry is freed -.SH DESCRIPTION -.LP -Xkb provides a number of functions to allocate and free subcomponents of a -keyboard geometry. Use these functions to create or modify keyboard geometries. -Note that these functions merely allocate space for the new element(s), and it -is up to you to fill in the values explicitly in your code. These allocation -functions increase -.I sz_* -but never touch -.I num_* -(unless there is an allocation failure, in which case they reset both -.I sz_* -and -.I num_* -to zero). These functions return Success if they succeed, BadAlloc if they are -not able to allocate space, or BadValue if a parameter is not as expected. - -The values of -.I which -and -.I free_all -determine how much of the specified geometry is freed. The valid values for -.I which -are: - -.nf - #define XkbGeomPropertiesMask (1<<0) - #define XkbGeomColorsMask (1<<1) - #define XkbGeomShapesMask (1<<2) - #define XkbGeomSectionsMask (1<<3) - #define XkbGeomDoodadsMask (1<<4) - #define XkbGeomAllMask (0x1f) - -.fi -If -.I free_all -is True, the entire geometry is freed regardless of the value of -.I which. -Otherwise, the portions of the geometry specified by -.I which -are freed. -.SH DIAGNOSTICS -.TP 15 -.B BadAlloc -Unable to allocate storage -.TP 15 -.B BadValue -An argument is out of range +.\" Copyright 1999 Sun Microsystems, Inc. All rights reserved. +.\" +.\" Permission is hereby granted, free of charge, to any person obtaining a +.\" copy of this software and associated documentation files (the "Software"), +.\" to deal in the Software without restriction, including without limitation +.\" the rights to use, copy, modify, merge, publish, distribute, sublicense, +.\" and/or sell copies of the Software, and to permit persons to whom the +.\" Software is furnished to do so, subject to the following conditions: +.\" +.\" The above copyright notice and this permission notice (including the next +.\" paragraph) shall be included in all copies or substantial portions of the +.\" Software. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL +.\" THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +.\" LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +.\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER +.\" DEALINGS IN THE SOFTWARE. +.\" +.TH XkbFreeGeometry __libmansuffix__ __xorgversion__ "XKB FUNCTIONS" +.SH NAME +XkbFreeGeometry \- Free an entire geometry +.SH SYNOPSIS +.HP +.B void XkbFreeGeometry +.BI "(\^XkbGeometryPtr " "geom" "\^," +.BI "unsigned int " "which" "\^," +.BI "Bool " "free_all" "\^);" +.if n .ti +5n +.if t .ti +.5i +.SH ARGUMENTS +.TP +.I \- geom +geometry to be freed +.TP +.I \- which +mask of geometry components to be freed +.TP +.I \- free_all +True => the entire geometry is freed +.SH DESCRIPTION +.LP +Xkb provides a number of functions to allocate and free subcomponents of a +keyboard geometry. Use these functions to create or modify keyboard geometries. +Note that these functions merely allocate space for the new element(s), and it +is up to you to fill in the values explicitly in your code. These allocation +functions increase +.I sz_* +but never touch +.I num_* +(unless there is an allocation failure, in which case they reset both +.I sz_* +and +.I num_* +to zero). These functions return Success if they succeed, BadAlloc if they are +not able to allocate space, or BadValue if a parameter is not as expected. + +The values of +.I which +and +.I free_all +determine how much of the specified geometry is freed. The valid values for +.I which +are: + +.nf + #define XkbGeomPropertiesMask (1<<0) + #define XkbGeomColorsMask (1<<1) + #define XkbGeomShapesMask (1<<2) + #define XkbGeomSectionsMask (1<<3) + #define XkbGeomDoodadsMask (1<<4) + #define XkbGeomKeyAliasesMask (1<<5) + #define XkbGeomAllMask (0x3f) + +.fi +If +.I free_all +is True, the entire geometry is freed regardless of the value of +.I which. +Otherwise, the portions of the geometry specified by +.I which +are freed. +.SH DIAGNOSTICS +.TP 15 +.B BadAlloc +Unable to allocate storage +.TP 15 +.B BadValue +An argument is out of range diff --git a/libX11/man/xkb/XkbGetBounceKeysDelay.man b/libX11/man/xkb/XkbGetBounceKeysDelay.man index be1b19d53..0eebb9c94 100644 --- a/libX11/man/xkb/XkbGetBounceKeysDelay.man +++ b/libX11/man/xkb/XkbGetBounceKeysDelay.man @@ -1,212 +1,212 @@ -'\" t -.\" Copyright 1999 Sun Microsystems, Inc. All rights reserved. -.\" -.\" Permission is hereby granted, free of charge, to any person obtaining a -.\" copy of this software and associated documentation files (the "Software"), -.\" to deal in the Software without restriction, including without limitation -.\" the rights to use, copy, modify, merge, publish, distribute, sublicense, -.\" and/or sell copies of the Software, and to permit persons to whom the -.\" Software is furnished to do so, subject to the following conditions: -.\" -.\" The above copyright notice and this permission notice (including the next -.\" paragraph) shall be included in all copies or substantial portions of the -.\" Software. -.\" -.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL -.\" THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -.\" LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -.\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER -.\" DEALINGS IN THE SOFTWARE. -.\" -.TH XkbGetBounceKeysDelay __libmansuffix__ __xorgversion__ "XKB FUNCTIONS" -.SH NAME -XkbGetBounceKeysDelay \- Queries the current BounceKeys delay for a keyboard -device. -.SH SYNOPSIS -.HP -.B Bool XkbGetBounceKeysDelay -.BI "(\^Display *" "display" "\^," -.BI "unsigned int " "device_spec" "\^," -.BI "unsigned int *" "delay_rtrn" "\^);" -.if n .ti +5n -.if t .ti +.5i -.SH ARGUMENTS -.TP -.I \- display -connection to X server -.TP -.I \- device_spec -device ID, or XkbUseCoreKbd -.TP -.I \- delay_rtrn -backfilled with bounce keys delay, ms -.SH DESCRIPTION -.LP -The server can generate XkbAccessXNotify events for some of the global keyboard -controls. -The detail field describes what AccessX event just occurred and can be any of -the values in -Table 1. - -.TS -c s -l l -l lw(4i). -Table 1 AccessXNotify Events -_ -detail Reason -_ -XkbAXN_SKPress T{ -A key was pressed when SlowKeys was enabled. -T} -XkbAXN_SKAccept T{ -A key was accepted (held longer than the SlowKeys delay). -T} -XkbAXN_SKRelease T{ -An accepted SlowKeys key was released. -T} -XkbAXN_SKReject T{ -A key was rejected (released before the SlowKeys delay expired). -T} -XkbAXN_BKAccept T{ -A key was accepted by BounceKeys. -T} -XkbAXN_BKReject T{ -A key was rejected (pressed before the BounceKeys delay expired). -T} -XkbAXN_AXKWarning T{ -AccessXKeys is about to turn on/off StickyKeys or BounceKeys. -T} -.TE - - -The -.I keycode -field reports the keycode of the key for which the event occurred. If the action -is related to -.I SlowKeys, -the -.I slowKeysDelay -field contains the current SlowKeys acceptance delay. If the action is related -to BounceKeys, -the -.I debounceDelay -field contains the current BounceKeys debounce delay. - -Selecting for AccessX Events - -To receive XkbAccessXNotify events under all possible conditions, use -.I XkbSelectEvents -and pass XkbAccesXNotifyMask in both -.I bits_to_change -and -.I values_for_bits. - -To receive XkbStateNotify events only under certain conditions, use -.I XkbSelectEventDetails -using XkbAccessXNotify as the -.I event_type -and specifying the desired state changes in -.I bits_to_change -and -.I values_for_bits -using mask bits from Table 2. - -.TS -c s s -l l l -l l lw(3i). -Table 2 AccessXNotify Event Details -_ -XkbAccessXNotify Event Details Value Circumstances -_ -XkbAXN_SKPressMask (1<<0) T{ -Slow key press notification wanted -T} -XkbAXN_SKAcceptMask (1<<1) T{ -Slow key accept notification wanted -T} -XkbAXN_SKRejectMask (1<<2) T{ -Slow key reject notification wanted -T} -XkbAXN_SKReleaseMask (1<<3) T{ -Slow key release notification wanted -T} -XkbAXN_BKAcceptMask (1<<4) T{ -Bounce key accept notification wanted -T} -XkbAXN_BKRejectMask (1<<5) T{ -Bounce key reject notification wanted -T} -XkbAXN_AXKWarningMask (1<<6) T{ -AccessX warning notification wanted -T} -XkbAXN_AllEventsMask (0x7f) T{ -All AccessX features notifications wanted -T} -.TE - -Some users may accidentally "bounce" on a key when they release it. They press -it once, then accidentally press it again after they release it. The BounceKeys -control temporarily disables a key after it has been pressed, effectively -"debouncing" the keyboard. The period of time the key is disabled after it is -released is known as the -.I BounceKeys delay. -BounceKeys is a boolean control. - -When the BounceKeys control is active, the server reports acceptance or -rejection of any key to interested clients by sending an appropriate -AccessXNotify event (see STRUCTURES). - -.I XkbGetBounceKeysDelay -requests the attributes of the BounceKeys control from the server, waits for a -reply, and backfills -.I delay_rtrn -with the BounceKeys delay attribute. -.I XkbGetBounceKeysDelay -returns True if successful; if a compatible version of the Xkb extension is not -available in the server -.I XkbGetSlowKeysDelay -returns False. -.SH "RETURN VALUES" -.TP 15 -True -The -.I XkbGetBounceKeysDelay -function returns True when it successfully requests the attributes of the -BounceKeys control from the server, waits for a -reply, and backfills -.I delay_rtrn -with the BounceKeys delay attribute. -.TP 15 -False -The -.I XkbGetBounceKeysDelay -function returns False if a compatible version of the Xkb extension is not -available in the server. -.SH STRUCTURES -.LP -The structure for the XkbAccessXNotify event type is as follows: - -.nf -typedef struct { - int type; /\(** Xkb extension base event code */ - unsigned long serial; /\(** X server serial number for event */ - Bool send_event; /\(** True => synthetically generated */ - Display * display; /\(** server connection where event generated */ - Time time; /\(** server time when event generated */ - int xkb_type; /\(** XkbAccessXNotify */ - int device; /\(** Xkb device ID, will not be XkbUseCoreKbd -*/ - int detail; /\(** XkbAXN_* */ - KeyCode keycode; /\(** key of event */ - int slowKeysDelay; /\(** current SlowKeys delay */ - int debounceDelay; /\(** current debounce delay */ -} XkbAccessXNotifyEvent; - -.fi -.SH "SEE ALSO" -.BR XkbGetSlowKeysDelay (__libmansuffix__) - +'\" t +.\" Copyright 1999 Sun Microsystems, Inc. All rights reserved. +.\" +.\" Permission is hereby granted, free of charge, to any person obtaining a +.\" copy of this software and associated documentation files (the "Software"), +.\" to deal in the Software without restriction, including without limitation +.\" the rights to use, copy, modify, merge, publish, distribute, sublicense, +.\" and/or sell copies of the Software, and to permit persons to whom the +.\" Software is furnished to do so, subject to the following conditions: +.\" +.\" The above copyright notice and this permission notice (including the next +.\" paragraph) shall be included in all copies or substantial portions of the +.\" Software. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL +.\" THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +.\" LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +.\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER +.\" DEALINGS IN THE SOFTWARE. +.\" +.TH XkbGetBounceKeysDelay __libmansuffix__ __xorgversion__ "XKB FUNCTIONS" +.SH NAME +XkbGetBounceKeysDelay \- Queries the current BounceKeys delay for a keyboard +device. +.SH SYNOPSIS +.HP +.B Bool XkbGetBounceKeysDelay +.BI "(\^Display *" "display" "\^," +.BI "unsigned int " "device_spec" "\^," +.BI "unsigned int *" "delay_rtrn" "\^);" +.if n .ti +5n +.if t .ti +.5i +.SH ARGUMENTS +.TP +.I \- display +connection to X server +.TP +.I \- device_spec +device ID, or XkbUseCoreKbd +.TP +.I \- delay_rtrn +backfilled with bounce keys delay, ms +.SH DESCRIPTION +.LP +The server can generate XkbAccessXNotify events for some of the global keyboard +controls. +The detail field describes what AccessX event just occurred and can be any of +the values in +Table 1. + +.TS +c s +l l +l lw(4i). +Table 1 AccessXNotify Events +_ +detail Reason +_ +XkbAXN_SKPress T{ +A key was pressed when SlowKeys was enabled. +T} +XkbAXN_SKAccept T{ +A key was accepted (held longer than the SlowKeys delay). +T} +XkbAXN_SKRelease T{ +An accepted SlowKeys key was released. +T} +XkbAXN_SKReject T{ +A key was rejected (released before the SlowKeys delay expired). +T} +XkbAXN_BKAccept T{ +A key was accepted by BounceKeys. +T} +XkbAXN_BKReject T{ +A key was rejected (pressed before the BounceKeys delay expired). +T} +XkbAXN_AXKWarning T{ +AccessXKeys is about to turn on/off StickyKeys or BounceKeys. +T} +.TE + + +The +.I keycode +field reports the keycode of the key for which the event occurred. If the action +is related to +.I SlowKeys, +the +.I slowKeysDelay +field contains the current SlowKeys acceptance delay. If the action is related +to BounceKeys, +the +.I debounceDelay +field contains the current BounceKeys debounce delay. + +Selecting for AccessX Events + +To receive XkbAccessXNotify events under all possible conditions, use +.I XkbSelectEvents +and pass XkbAccesXNotifyMask in both +.I bits_to_change +and +.I values_for_bits. + +To receive XkbStateNotify events only under certain conditions, use +.I XkbSelectEventDetails +using XkbAccessXNotify as the +.I event_type +and specifying the desired state changes in +.I bits_to_change +and +.I values_for_bits +using mask bits from Table 2. + +.TS +c s s +l l l +l l lw(3i). +Table 2 AccessXNotify Event Details +_ +XkbAccessXNotify Event Details Value Circumstances +_ +XkbAXN_SKPressMask (1<<0) T{ +Slow key press notification wanted +T} +XkbAXN_SKAcceptMask (1<<1) T{ +Slow key accept notification wanted +T} +XkbAXN_SKRejectMask (1<<2) T{ +Slow key reject notification wanted +T} +XkbAXN_SKReleaseMask (1<<3) T{ +Slow key release notification wanted +T} +XkbAXN_BKAcceptMask (1<<4) T{ +Bounce key accept notification wanted +T} +XkbAXN_BKRejectMask (1<<5) T{ +Bounce key reject notification wanted +T} +XkbAXN_AXKWarningMask (1<<6) T{ +AccessX warning notification wanted +T} +XkbAllAccessXEventsMask (0x7f) T{ +All AccessX features notifications wanted +T} +.TE + +Some users may accidentally "bounce" on a key when they release it. They press +it once, then accidentally press it again after they release it. The BounceKeys +control temporarily disables a key after it has been pressed, effectively +"debouncing" the keyboard. The period of time the key is disabled after it is +released is known as the +.I BounceKeys delay. +BounceKeys is a boolean control. + +When the BounceKeys control is active, the server reports acceptance or +rejection of any key to interested clients by sending an appropriate +AccessXNotify event (see STRUCTURES). + +.I XkbGetBounceKeysDelay +requests the attributes of the BounceKeys control from the server, waits for a +reply, and backfills +.I delay_rtrn +with the BounceKeys delay attribute. +.I XkbGetBounceKeysDelay +returns True if successful; if a compatible version of the Xkb extension is not +available in the server +.I XkbGetSlowKeysDelay +returns False. +.SH "RETURN VALUES" +.TP 15 +True +The +.I XkbGetBounceKeysDelay +function returns True when it successfully requests the attributes of the +BounceKeys control from the server, waits for a +reply, and backfills +.I delay_rtrn +with the BounceKeys delay attribute. +.TP 15 +False +The +.I XkbGetBounceKeysDelay +function returns False if a compatible version of the Xkb extension is not +available in the server. +.SH STRUCTURES +.LP +The structure for the XkbAccessXNotify event type is as follows: + +.nf +typedef struct { + int type; /\(** Xkb extension base event code */ + unsigned long serial; /\(** X server serial number for event */ + Bool send_event; /\(** True => synthetically generated */ + Display * display; /\(** server connection where event generated */ + Time time; /\(** server time when event generated */ + int xkb_type; /\(** XkbAccessXNotify */ + int device; /\(** Xkb device ID, will not be XkbUseCoreKbd +*/ + int detail; /\(** XkbAXN_* */ + KeyCode keycode; /\(** key of event */ + int slowKeysDelay; /\(** current SlowKeys delay */ + int debounceDelay; /\(** current debounce delay */ +} XkbAccessXNotifyEvent; + +.fi +.SH "SEE ALSO" +.BR XkbGetSlowKeysDelay (__libmansuffix__) + diff --git a/libX11/man/xkb/XkbGetDetectableAutorepeat.man b/libX11/man/xkb/XkbGetDetectableAutorepeat.man index 8e5e7784a..f4e7e9c80 100644 --- a/libX11/man/xkb/XkbGetDetectableAutorepeat.man +++ b/libX11/man/xkb/XkbGetDetectableAutorepeat.man @@ -1,92 +1,92 @@ -.\" Copyright 1999 Sun Microsystems, Inc. All rights reserved. -.\" -.\" Permission is hereby granted, free of charge, to any person obtaining a -.\" copy of this software and associated documentation files (the "Software"), -.\" to deal in the Software without restriction, including without limitation -.\" the rights to use, copy, modify, merge, publish, distribute, sublicense, -.\" and/or sell copies of the Software, and to permit persons to whom the -.\" Software is furnished to do so, subject to the following conditions: -.\" -.\" The above copyright notice and this permission notice (including the next -.\" paragraph) shall be included in all copies or substantial portions of the -.\" Software. -.\" -.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL -.\" THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -.\" LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -.\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER -.\" DEALINGS IN THE SOFTWARE. -.\" -.TH XkbGetDetectableAutorepeat __libmansuffix__ __xorgversion__ "XKB FUNCTIONS" -.SH NAME -XkbGetDetectableAutorepeat \- Determines whether or not the server supports -DetectableAutorepeat -.SH SYNOPSIS -.HP -.B Bool XkbGetDetectableAutorepeat -.BI "(\^Display *" "display" "\^," -.BI "Bool *" "supported_rtrn" "\^);" -.if n .ti +5n -.if t .ti +.5i -.SH ARGUMENTS -.TP -.I \- display -connection to X server -.TP -.I \- supported_rtrn -backfilled True if DetectableAutorepeat supported -.SH DESCRIPTION -.LP -Auto-repeat is the generation of multiple key events by a keyboard when the user -presses a key and holds it down. Keyboard hardware and device-dependent X server -software often implement auto-repeat by generating multiple KeyPress events with no -intervening KeyRelease event. The standard behavior of the X server is to generate -a KeyRelease event for every KeyPress event. If the keyboard hardware and -device-dependent software of the X server implement auto-repeat by generating -multiple KeyPress events, the device-independent part of the X server by default -synthetically generates a KeyRelease event after each KeyPress event. This provides -predictable behavior for X clients, but does not allow those clients to detect the -fact that a key is auto-repeating. - -Xkb allows clients to request -.I detectable auto-repeat. -If a client requests and the server supports DetectableAutorepeat, Xkb generates -KeyRelease events only when the key is physically released. If DetectableAutorepeat -is not supported or has not been requested, the server synthesizes a KeyRelease -event for each repeating KeyPress event it generates. - -DetectableAutorepeat, unlike other controls, is not contained in the XkbControlsRec -structure, nor can it be enabled or disabled via the EnabledControls control. -Instead, query and set DetectableAutorepeat using -.I XkbGetDetectableAutorepeat -and -.I XkbSetDetectableAutorepeat. - -DetectableAutorepeat is a condition that applies to all keyboard devices for a -client's connection to a given X server; it cannot be selectively set for some -devices and not for others. For this reason, none of the Xkb library functions -involving DetectableAutorepeat involve a device specifier. - -.I XkbGetDetectableAutorepeat -queries the server for the current state of DetectableAutorepeat and waits for a -reply. If -.I supported_rtrn -is not NULL, it backfills -.I supported_rtrn -with True if the server supports DetectableAutorepeat, and False otherwise. -.I XkbGetDetectableAutorepeat -returns the current state of DetectableAutorepeat for the requesting client: -True if DetectableAutorepeat is set, and False otherwise. -.SH "RETURN VALUES" -.TP 15 -True -The -.I XkbGetDetectableAutorepeat -function returns True if the server supports DetectableAutorepeat. -.TP 15 -False -The -.I XkbGetDetectableAutorepeat -function returns False if the server does not support DetectableAutorepeat. +.\" Copyright 1999 Sun Microsystems, Inc. All rights reserved. +.\" +.\" Permission is hereby granted, free of charge, to any person obtaining a +.\" copy of this software and associated documentation files (the "Software"), +.\" to deal in the Software without restriction, including without limitation +.\" the rights to use, copy, modify, merge, publish, distribute, sublicense, +.\" and/or sell copies of the Software, and to permit persons to whom the +.\" Software is furnished to do so, subject to the following conditions: +.\" +.\" The above copyright notice and this permission notice (including the next +.\" paragraph) shall be included in all copies or substantial portions of the +.\" Software. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL +.\" THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +.\" LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +.\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER +.\" DEALINGS IN THE SOFTWARE. +.\" +.TH XkbGetDetectableAutoRepeat __libmansuffix__ __xorgversion__ "XKB FUNCTIONS" +.SH NAME +XkbGetDetectableAutoRepeat \- Determines whether or not the server supports +DetectableAutoRepeat +.SH SYNOPSIS +.HP +.B Bool XkbGetDetectableAutoRepeat +.BI "(\^Display *" "display" "\^," +.BI "Bool *" "supported_rtrn" "\^);" +.if n .ti +5n +.if t .ti +.5i +.SH ARGUMENTS +.TP +.I \- display +connection to X server +.TP +.I \- supported_rtrn +backfilled True if DetectableAutoRepeat supported +.SH DESCRIPTION +.LP +Auto-repeat is the generation of multiple key events by a keyboard when the user +presses a key and holds it down. Keyboard hardware and device-dependent X server +software often implement auto-repeat by generating multiple KeyPress events with no +intervening KeyRelease event. The standard behavior of the X server is to generate +a KeyRelease event for every KeyPress event. If the keyboard hardware and +device-dependent software of the X server implement auto-repeat by generating +multiple KeyPress events, the device-independent part of the X server by default +synthetically generates a KeyRelease event after each KeyPress event. This provides +predictable behavior for X clients, but does not allow those clients to detect the +fact that a key is auto-repeating. + +Xkb allows clients to request +.I detectable auto-repeat. +If a client requests and the server supports DetectableAutoRepeat, Xkb generates +KeyRelease events only when the key is physically released. If DetectableAutoRepeat +is not supported or has not been requested, the server synthesizes a KeyRelease +event for each repeating KeyPress event it generates. + +DetectableAutoRepeat, unlike other controls, is not contained in the XkbControlsRec +structure, nor can it be enabled or disabled via the EnabledControls control. +Instead, query and set DetectableAutoRepeat using +.I XkbGetDetectableAutoRepeat +and +.I XkbSetDetectableAutoRepeat. + +DetectableAutoRepeat is a condition that applies to all keyboard devices for a +client's connection to a given X server; it cannot be selectively set for some +devices and not for others. For this reason, none of the Xkb library functions +involving DetectableAutoRepeat involve a device specifier. + +.I XkbGetDetectableAutoRepeat +queries the server for the current state of DetectableAutoRepeat and waits for a +reply. If +.I supported_rtrn +is not NULL, it backfills +.I supported_rtrn +with True if the server supports DetectableAutoRepeat, and False otherwise. +.I XkbGetDetectableAutoRepeat +returns the current state of DetectableAutoRepeat for the requesting client: +True if DetectableAutoRepeat is set, and False otherwise. +.SH "RETURN VALUES" +.TP 15 +True +The +.I XkbGetDetectableAutoRepeat +function returns True if the server supports DetectableAutoRepeat. +.TP 15 +False +The +.I XkbGetDetectableAutoRepeat +function returns False if the server does not support DetectableAutoRepeat. diff --git a/libX11/man/xkb/XkbGetSlowKeysDelay.man b/libX11/man/xkb/XkbGetSlowKeysDelay.man index 74c52d17e..ad9a0cd67 100644 --- a/libX11/man/xkb/XkbGetSlowKeysDelay.man +++ b/libX11/man/xkb/XkbGetSlowKeysDelay.man @@ -1,215 +1,215 @@ -'\" t -.\" Copyright 1999 Sun Microsystems, Inc. All rights reserved. -.\" -.\" Permission is hereby granted, free of charge, to any person obtaining a -.\" copy of this software and associated documentation files (the "Software"), -.\" to deal in the Software without restriction, including without limitation -.\" the rights to use, copy, modify, merge, publish, distribute, sublicense, -.\" and/or sell copies of the Software, and to permit persons to whom the -.\" Software is furnished to do so, subject to the following conditions: -.\" -.\" The above copyright notice and this permission notice (including the next -.\" paragraph) shall be included in all copies or substantial portions of the -.\" Software. -.\" -.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL -.\" THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -.\" LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -.\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER -.\" DEALINGS IN THE SOFTWARE. -.\" -.TH XkbGetSlowKeysDelay __libmansuffix__ __xorgversion__ "XKB FUNCTIONS" -.SH NAME -XkbGetSlowKeysDelay \- Gets the SlowKeys acceptance delay for a keyboard device -.SH SYNOPSIS -.HP -.B Bool XkbGetSlowKeysDelay -.BI "(\^Display *" "display" "\^," -.BI "unsigned int " "device_spec" "\^," -.BI "unsigned int *" "delay_rtrn" "\^);" -.if n .ti +5n -.if t .ti +.5i -.SH ARGUMENTS -.TP -.I \- display -connection to X server -.TP -.I \- device_spec -device ID, or XkbUseCoreKbd -.TP -.I \- delay_rtrn -backfilled with SlowKeys delay, ms -.SH DESCRIPTION -.LP -Some users may accidentally bump keys while moving a hand or typing stick toward -the key they want. Usually, the keys that are accidentally bumped are just hit -for a very short period of time. The SlowKeys control helps filter these -accidental bumps by telling the server to wait a specified period, called the -.I SlowKeys acceptance delay, -before delivering key events. If the key is released before this period elapses, -no key events are generated. Users can then bump any number of keys on their way -to the one they want without accidentally getting those characters. Once they -have reached the key they want, they can then hold the desired key long enough -for the computer to accept it. SlowKeys is a boolean control with one -configurable attribute. - -When the SlowKeys control is active, the server reports the initial key press, -subsequent acceptance or rejection, and release of any key to interested clients -by sending an appropriate AccessXNotify event (see section 10.6.4). - -The server can generate XkbAccessXNotify events for some of the global keyboard -controls. -The detail field describes what AccessX event just occurred and can be any of -the values in -Table 1. -The server can generate XkbAccessXNotify events for some of the global keyboard -controls. -The detail field describes what AccessX event just occurred and can be any of -the values in -Table 1. - -.TS -c s -l l -l lw(4i). -Table 1 AccessXNotify Events -_ -detail Reason -_ -XkbAXN_SKPress T{ -A key was pressed when SlowKeys was enabled. -T} -XkbAXN_SKAccept T{ -A key was accepted (held longer than the SlowKeys delay). -T} -XkbAXN_SKRelease T{ -An accepted SlowKeys key was released. -T} -XkbAXN_SKReject T{ -A key was rejected (released before the SlowKeys delay expired). -T} -XkbAXN_BKAccept T{ -A key was accepted by BounceKeys. -T} -XkbAXN_BKReject T{ -A key was rejected (pressed before the BounceKeys delay expired). -T} -XkbAXN_AXKWarning T{ -AccessXKeys is about to turn on/off StickyKeys or BounceKeys. -T} -.TE - - -The -.I keycode -field reports the keycode of the key for which the event occurred. If the action -is related to -.I SlowKeys, -the -.I slowKeysDelay -field contains the current SlowKeys acceptance delay. If the action is related -to BounceKeys, -the -.I debounceDelay -field contains the current BounceKeys debounce delay. - -Selecting for AccessX Events - -To receive XkbAccessXNotify events under all possible conditions, use -.I XkbSelectEvents -and pass XkbAccesXNotifyMask in both -.I bits_to_change -and -.I values_for_bits. - -To receive XkbStateNotify events only under certain conditions, use -.I XkbSelectEventDetails -using XkbAccessXNotify as the -.I event_type -and specifying the desired state changes in -.I bits_to_change -and -.I values_for_bits -using mask bits from Table 2. - -.TS -c s s -l l l -l l lw(3i). -Table 2 AccessXNotify Event Details -_ -XkbAccessXNotify Event Details Value Circumstances -_ -XkbAXN_SKPressMask (1<<0) T{ -Slow key press notification wanted -T} -XkbAXN_SKAcceptMask (1<<1) T{ -Slow key accept notification wanted -T} -XkbAXN_SKRejectMask (1<<2) T{ -Slow key reject notification wanted -T} -XkbAXN_SKReleaseMask (1<<3) T{ -Slow key release notification wanted -T} -XkbAXN_BKAcceptMask (1<<4) T{ -Bounce key accept notification wanted -T} -XkbAXN_BKRejectMask (1<<5) T{ -Bounce key reject notification wanted -T} -XkbAXN_AXKWarningMask (1<<6) T{ -AccessX warning notification wanted -T} -XkbAXN_AllEventsMask (0x7f) T{ -All AccessX features notifications wanted -T} -.TE - -.I XkbGetSlowKeysDelay -requests the attributes of the SlowKeys control from the server, waits for a -reply and backfills -.I delay_rtrn -with the SlowKeys delay attribute. -.I XkbGetSlowKeysDelay -returns True if successful; , -.I XkbGetSlowKeysDelay -returns False. -.SH "RETURN VALUES" -.TP 15 -True -The -.I XkbGetSlowKeysDelay -function returns True if the request of the Slowkeys control from the server was -successful. -.I -.TP 15 -False -The -.I XkbGetSlowKeysDelay -function returns False if a compatible version of the Xkb extension is not -available in the server. -.SH STRUCTURES -.LP -The structure for the XkbAccessXNotify event type is as follows: - -.nf -typedef struct { - int type; /\(** Xkb extension base event code */ - unsigned long serial; /\(** X server serial number for event */ - Bool send_event; /\(** True => synthetically generated */ - Display * display; /\(** server connection where event generated */ - Time time; /\(** server time when event generated */ - int xkb_type; /\(** XkbAccessXNotify */ - int device; /\(** Xkb device ID, will not be XkbUseCoreKbd -*/ - int detail; /\(** XkbAXN_* */ - KeyCode keycode; /\(** key of event */ - int slowKeysDelay; /\(** current SlowKeys delay */ - int debounceDelay; /\(** current debounce delay */ -} XkbAccessXNotifyEvent; - -.fi - +'\" t +.\" Copyright 1999 Sun Microsystems, Inc. All rights reserved. +.\" +.\" Permission is hereby granted, free of charge, to any person obtaining a +.\" copy of this software and associated documentation files (the "Software"), +.\" to deal in the Software without restriction, including without limitation +.\" the rights to use, copy, modify, merge, publish, distribute, sublicense, +.\" and/or sell copies of the Software, and to permit persons to whom the +.\" Software is furnished to do so, subject to the following conditions: +.\" +.\" The above copyright notice and this permission notice (including the next +.\" paragraph) shall be included in all copies or substantial portions of the +.\" Software. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL +.\" THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +.\" LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +.\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER +.\" DEALINGS IN THE SOFTWARE. +.\" +.TH XkbGetSlowKeysDelay __libmansuffix__ __xorgversion__ "XKB FUNCTIONS" +.SH NAME +XkbGetSlowKeysDelay \- Gets the SlowKeys acceptance delay for a keyboard device +.SH SYNOPSIS +.HP +.B Bool XkbGetSlowKeysDelay +.BI "(\^Display *" "display" "\^," +.BI "unsigned int " "device_spec" "\^," +.BI "unsigned int *" "delay_rtrn" "\^);" +.if n .ti +5n +.if t .ti +.5i +.SH ARGUMENTS +.TP +.I \- display +connection to X server +.TP +.I \- device_spec +device ID, or XkbUseCoreKbd +.TP +.I \- delay_rtrn +backfilled with SlowKeys delay, ms +.SH DESCRIPTION +.LP +Some users may accidentally bump keys while moving a hand or typing stick toward +the key they want. Usually, the keys that are accidentally bumped are just hit +for a very short period of time. The SlowKeys control helps filter these +accidental bumps by telling the server to wait a specified period, called the +.I SlowKeys acceptance delay, +before delivering key events. If the key is released before this period elapses, +no key events are generated. Users can then bump any number of keys on their way +to the one they want without accidentally getting those characters. Once they +have reached the key they want, they can then hold the desired key long enough +for the computer to accept it. SlowKeys is a boolean control with one +configurable attribute. + +When the SlowKeys control is active, the server reports the initial key press, +subsequent acceptance or rejection, and release of any key to interested clients +by sending an appropriate AccessXNotify event (see section 10.6.4). + +The server can generate XkbAccessXNotify events for some of the global keyboard +controls. +The detail field describes what AccessX event just occurred and can be any of +the values in +Table 1. +The server can generate XkbAccessXNotify events for some of the global keyboard +controls. +The detail field describes what AccessX event just occurred and can be any of +the values in +Table 1. + +.TS +c s +l l +l lw(4i). +Table 1 AccessXNotify Events +_ +detail Reason +_ +XkbAXN_SKPress T{ +A key was pressed when SlowKeys was enabled. +T} +XkbAXN_SKAccept T{ +A key was accepted (held longer than the SlowKeys delay). +T} +XkbAXN_SKRelease T{ +An accepted SlowKeys key was released. +T} +XkbAXN_SKReject T{ +A key was rejected (released before the SlowKeys delay expired). +T} +XkbAXN_BKAccept T{ +A key was accepted by BounceKeys. +T} +XkbAXN_BKReject T{ +A key was rejected (pressed before the BounceKeys delay expired). +T} +XkbAXN_AXKWarning T{ +AccessXKeys is about to turn on/off StickyKeys or BounceKeys. +T} +.TE + + +The +.I keycode +field reports the keycode of the key for which the event occurred. If the action +is related to +.I SlowKeys, +the +.I slowKeysDelay +field contains the current SlowKeys acceptance delay. If the action is related +to BounceKeys, +the +.I debounceDelay +field contains the current BounceKeys debounce delay. + +Selecting for AccessX Events + +To receive XkbAccessXNotify events under all possible conditions, use +.I XkbSelectEvents +and pass XkbAccesXNotifyMask in both +.I bits_to_change +and +.I values_for_bits. + +To receive XkbStateNotify events only under certain conditions, use +.I XkbSelectEventDetails +using XkbAccessXNotify as the +.I event_type +and specifying the desired state changes in +.I bits_to_change +and +.I values_for_bits +using mask bits from Table 2. + +.TS +c s s +l l l +l l lw(3i). +Table 2 AccessXNotify Event Details +_ +XkbAccessXNotify Event Details Value Circumstances +_ +XkbAXN_SKPressMask (1<<0) T{ +Slow key press notification wanted +T} +XkbAXN_SKAcceptMask (1<<1) T{ +Slow key accept notification wanted +T} +XkbAXN_SKRejectMask (1<<2) T{ +Slow key reject notification wanted +T} +XkbAXN_SKReleaseMask (1<<3) T{ +Slow key release notification wanted +T} +XkbAXN_BKAcceptMask (1<<4) T{ +Bounce key accept notification wanted +T} +XkbAXN_BKRejectMask (1<<5) T{ +Bounce key reject notification wanted +T} +XkbAXN_AXKWarningMask (1<<6) T{ +AccessX warning notification wanted +T} +XkbAllAccessXEventsMask (0x7f) T{ +All AccessX features notifications wanted +T} +.TE + +.I XkbGetSlowKeysDelay +requests the attributes of the SlowKeys control from the server, waits for a +reply and backfills +.I delay_rtrn +with the SlowKeys delay attribute. +.I XkbGetSlowKeysDelay +returns True if successful; , +.I XkbGetSlowKeysDelay +returns False. +.SH "RETURN VALUES" +.TP 15 +True +The +.I XkbGetSlowKeysDelay +function returns True if the request of the Slowkeys control from the server was +successful. +.I +.TP 15 +False +The +.I XkbGetSlowKeysDelay +function returns False if a compatible version of the Xkb extension is not +available in the server. +.SH STRUCTURES +.LP +The structure for the XkbAccessXNotify event type is as follows: + +.nf +typedef struct { + int type; /\(** Xkb extension base event code */ + unsigned long serial; /\(** X server serial number for event */ + Bool send_event; /\(** True => synthetically generated */ + Display * display; /\(** server connection where event generated */ + Time time; /\(** server time when event generated */ + int xkb_type; /\(** XkbAccessXNotify */ + int device; /\(** Xkb device ID, will not be XkbUseCoreKbd +*/ + int detail; /\(** XkbAXN_* */ + KeyCode keycode; /\(** key of event */ + int slowKeysDelay; /\(** current SlowKeys delay */ + int debounceDelay; /\(** current debounce delay */ +} XkbAccessXNotifyEvent; + +.fi + diff --git a/libX11/man/xkb/XkbGetState.man b/libX11/man/xkb/XkbGetState.man index d591b1e0a..8e408b1ad 100644 --- a/libX11/man/xkb/XkbGetState.man +++ b/libX11/man/xkb/XkbGetState.man @@ -1,55 +1,55 @@ -.\" Copyright 1999 Sun Microsystems, Inc. All rights reserved. -.\" -.\" Permission is hereby granted, free of charge, to any person obtaining a -.\" copy of this software and associated documentation files (the "Software"), -.\" to deal in the Software without restriction, including without limitation -.\" the rights to use, copy, modify, merge, publish, distribute, sublicense, -.\" and/or sell copies of the Software, and to permit persons to whom the -.\" Software is furnished to do so, subject to the following conditions: -.\" -.\" The above copyright notice and this permission notice (including the next -.\" paragraph) shall be included in all copies or substantial portions of the -.\" Software. -.\" -.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL -.\" THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -.\" LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -.\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER -.\" DEALINGS IN THE SOFTWARE. -.\" -.TH XkbGetState __libmansuffix__ __xorgversion__ "XKB FUNCTIONS" -.SH NAME -XkbGetState \- Obtains the keyboard state -.SH SYNOPSIS -.HP -.B Bool XkbGetState -.BI "(\^Display *" "display" "\^," -.BI "unsigned int " "device_spec" "\^," -.BI "XkbStatePtr " "state_return" "\^);" -.if n .ti +5n -.if t .ti +.5i -.SH ARGUMENTS -.TP -.I display -connection to the X server -.TP -.I device_spec -device ID, or XkbUseCoreKbd -.TP -.I state_return -backfilled with Xkb state -.SH DESCRIPTION -.LP -The -.I XkbGetState -function queries the server for the current keyboard state, waits -for a reply, and then backfills -.I state_return -with the results. - -All group values are expressed as group indices in the range [0..3]. Modifiers -and the compatibility modifier state values are expressed as the bitwise union -of the core X11 modifier masks. The pointer button state is reported as in the -core X11 protocol. +.\" Copyright 1999 Sun Microsystems, Inc. All rights reserved. +.\" +.\" Permission is hereby granted, free of charge, to any person obtaining a +.\" copy of this software and associated documentation files (the "Software"), +.\" to deal in the Software without restriction, including without limitation +.\" the rights to use, copy, modify, merge, publish, distribute, sublicense, +.\" and/or sell copies of the Software, and to permit persons to whom the +.\" Software is furnished to do so, subject to the following conditions: +.\" +.\" The above copyright notice and this permission notice (including the next +.\" paragraph) shall be included in all copies or substantial portions of the +.\" Software. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL +.\" THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +.\" LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +.\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER +.\" DEALINGS IN THE SOFTWARE. +.\" +.TH XkbGetState __libmansuffix__ __xorgversion__ "XKB FUNCTIONS" +.SH NAME +XkbGetState \- Obtains the keyboard state +.SH SYNOPSIS +.HP +.B Status XkbGetState +.BI "(\^Display *" "display" "\^," +.BI "unsigned int " "device_spec" "\^," +.BI "XkbStatePtr " "state_return" "\^);" +.if n .ti +5n +.if t .ti +.5i +.SH ARGUMENTS +.TP +.I display +connection to the X server +.TP +.I device_spec +device ID, or XkbUseCoreKbd +.TP +.I state_return +backfilled with Xkb state +.SH DESCRIPTION +.LP +The +.I XkbGetState +function queries the server for the current keyboard state, waits +for a reply, and then backfills +.I state_return +with the results. + +All group values are expressed as group indices in the range [0..3]. Modifiers +and the compatibility modifier state values are expressed as the bitwise union +of the core X11 modifier masks. The pointer button state is reported as in the +core X11 protocol. diff --git a/libX11/man/xkb/XkbKeyActionEntry.man b/libX11/man/xkb/XkbKeyActionEntry.man index 5acc7e837..6f3e451bf 100644 --- a/libX11/man/xkb/XkbKeyActionEntry.man +++ b/libX11/man/xkb/XkbKeyActionEntry.man @@ -1,137 +1,137 @@ -.\" Copyright 1999 Sun Microsystems, Inc. All rights reserved. -.\" -.\" Permission is hereby granted, free of charge, to any person obtaining a -.\" copy of this software and associated documentation files (the "Software"), -.\" to deal in the Software without restriction, including without limitation -.\" the rights to use, copy, modify, merge, publish, distribute, sublicense, -.\" and/or sell copies of the Software, and to permit persons to whom the -.\" Software is furnished to do so, subject to the following conditions: -.\" -.\" The above copyright notice and this permission notice (including the next -.\" paragraph) shall be included in all copies or substantial portions of the -.\" Software. -.\" -.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL -.\" THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -.\" LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -.\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER -.\" DEALINGS IN THE SOFTWARE. -.\" -.TH XkbKeyActionEntry __libmansuffix__ __xorgversion__ "XKB FUNCTIONS" -.SH NAME -XkbKeyActionEntry \- Returns the key action corresponding to group grp and shift -level lvl from the -two-dimensional table of key actions associated with the key corresponding to -keycode -.SH SYNOPSIS -.HP -.B XkbAction XkbKeyActionEntry -.BI "(\^XkbDescPtr " "xkb" "\^," -.BI "KeyCode " "keycode" "\^," -.BI "int " "shift" "\^," -.BI "int " "grp" "\^);" -.if n .ti +5n -.if t .ti +.5i -.SH ARGUMENTS -.TP -.I \- xkb -Xkb description of interest -.TP -.I \- keycode -keycode of interest -.TP -.I \- shift -shift level within group -.TP -.I \- grp -group index for group of interest -.SH DESCRIPTION -.LP -A key action defines the effect key presses and releases have on the internal -state of the server. For example, -the expected key action associated with pressing the Shift key is to set the -Shift modifier. There is zero or one -key action associated with each keysym bound to each key. - -Just as the entire list of key symbols for the keyboard mapping is held in the -.I syms -field of the client map, the entire list of key actions for the keyboard mapping -is held in the -.I acts -array of the server map. The total size of -.I acts -is specified by -.I size_acts, -and the number of entries is specified by -.I num_acts. - -The -.I key_acts -array, indexed by keycode, describes the actions associated with a key. The -.I key_acts -array has -.I min_key_code -unused entries at the start to allow direct indexing using a keycode. If a -.I key_acts -entry is zero, it means the key does not have any actions associated with it. If -an entry is not zero, the entry -represents an index into the -.I acts -field of the server map, much as the -.I offset -field of a KeySymMapRec structure is an index into the -.I syms -field of the client map. - -The reason the -.I acts -field is a linear list of XkbActions is to reduce the memory consumption -associated with a keymap. Because Xkb -allows individual keys to have multiple shift levels and a different number of -groups per key, a single -two-dimensional array of KeySyms would potentially be very large and sparse. -Instead, Xkb provides a small -two-dimensional array of XkbActions for each key. To store all of these -individual arrays, Xkb concatenates each -array together in the -.I acts -field of the server map. - -The key action structures consist only of fields of type char or unsigned char. -This is done to optimize data -transfer when the server sends bytes over the wire. If the fields are anything -but bytes, the server has to sift -through all of the actions and swap any nonbyte fields. Because they consist of -nothing but bytes, it can just -copy them out. - -.I XkbKeyActionEntry -returns the key action corresponding to group -.I grp -and shift level -.I lvl -from the two-dimensional table of key actions associated with the key -corresponding to -.I keycode. -.SH STRUCTURES -.LP -The KeySymMapRec structure is defined as follows: -.nf - - #define XkbNumKbdGroups 4 - #define XkbMaxKbdGroup (XkbNumKbdGroups-1) - - typedef struct { /\(** map to keysyms for a single keycode -*/ - unsigned char kt_index[XkbNumKbdGroups]; /\(** key type index for -each group */ - unsigned char group_info; /\(** # of groups and out of range group -handling */ - unsigned char width; /\(** max # of shift levels for key */ - unsigned short offset; /\(** index to keysym table in syms array -*/ -} XkbSymMapRec, *XkbSymMapPtr; - -.fi +.\" Copyright 1999 Sun Microsystems, Inc. All rights reserved. +.\" +.\" Permission is hereby granted, free of charge, to any person obtaining a +.\" copy of this software and associated documentation files (the "Software"), +.\" to deal in the Software without restriction, including without limitation +.\" the rights to use, copy, modify, merge, publish, distribute, sublicense, +.\" and/or sell copies of the Software, and to permit persons to whom the +.\" Software is furnished to do so, subject to the following conditions: +.\" +.\" The above copyright notice and this permission notice (including the next +.\" paragraph) shall be included in all copies or substantial portions of the +.\" Software. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL +.\" THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +.\" LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +.\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER +.\" DEALINGS IN THE SOFTWARE. +.\" +.TH XkbKeyActionEntry __libmansuffix__ __xorgversion__ "XKB FUNCTIONS" +.SH NAME +XkbKeyActionEntry \- Returns a pointer to the key action corresponding to +group grp and shift level lvl from the two-dimensional table of key actions +associated with the key corresponding to +keycode +.SH SYNOPSIS +.HP +.B XkbAction * XkbKeyActionEntry +.BI "(\^XkbDescPtr " "xkb" "\^," +.BI "KeyCode " "keycode" "\^," +.BI "int " "shift" "\^," +.BI "int " "grp" "\^);" +.if n .ti +5n +.if t .ti +.5i +.SH ARGUMENTS +.TP +.I \- xkb +Xkb description of interest +.TP +.I \- keycode +keycode of interest +.TP +.I \- shift +shift level within group +.TP +.I \- grp +group index for group of interest +.SH DESCRIPTION +.LP +A key action defines the effect key presses and releases have on the internal +state of the server. For example, +the expected key action associated with pressing the Shift key is to set the +Shift modifier. There is zero or one +key action associated with each keysym bound to each key. + +Just as the entire list of key symbols for the keyboard mapping is held in the +.I syms +field of the client map, the entire list of key actions for the keyboard mapping +is held in the +.I acts +array of the server map. The total size of +.I acts +is specified by +.I size_acts, +and the number of entries is specified by +.I num_acts. + +The +.I key_acts +array, indexed by keycode, describes the actions associated with a key. The +.I key_acts +array has +.I min_key_code +unused entries at the start to allow direct indexing using a keycode. If a +.I key_acts +entry is zero, it means the key does not have any actions associated with it. If +an entry is not zero, the entry +represents an index into the +.I acts +field of the server map, much as the +.I offset +field of a KeySymMapRec structure is an index into the +.I syms +field of the client map. + +The reason the +.I acts +field is a linear list of XkbActions is to reduce the memory consumption +associated with a keymap. Because Xkb +allows individual keys to have multiple shift levels and a different number of +groups per key, a single +two-dimensional array of KeySyms would potentially be very large and sparse. +Instead, Xkb provides a small +two-dimensional array of XkbActions for each key. To store all of these +individual arrays, Xkb concatenates each +array together in the +.I acts +field of the server map. + +The key action structures consist only of fields of type char or unsigned char. +This is done to optimize data +transfer when the server sends bytes over the wire. If the fields are anything +but bytes, the server has to sift +through all of the actions and swap any nonbyte fields. Because they consist of +nothing but bytes, it can just +copy them out. + +.I XkbKeyActionEntry +returns the key action corresponding to group +.I grp +and shift level +.I lvl +from the two-dimensional table of key actions associated with the key +corresponding to +.I keycode. +.SH STRUCTURES +.LP +The KeySymMapRec structure is defined as follows: +.nf + + #define XkbNumKbdGroups 4 + #define XkbMaxKbdGroup (XkbNumKbdGroups-1) + + typedef struct { /\(** map to keysyms for a single keycode +*/ + unsigned char kt_index[XkbNumKbdGroups]; /\(** key type index for +each group */ + unsigned char group_info; /\(** # of groups and out of range group +handling */ + unsigned char width; /\(** max # of shift levels for key */ + unsigned short offset; /\(** index to keysym table in syms array +*/ +} XkbSymMapRec, *XkbSymMapPtr; + +.fi diff --git a/libX11/man/xkb/XkbSetBounceKeysDelay.man b/libX11/man/xkb/XkbSetBounceKeysDelay.man index 98cd1d5dd..5563c0c69 100644 --- a/libX11/man/xkb/XkbSetBounceKeysDelay.man +++ b/libX11/man/xkb/XkbSetBounceKeysDelay.man @@ -1,207 +1,207 @@ -'\" t -.\" Copyright 1999 Sun Microsystems, Inc. All rights reserved. -.\" -.\" Permission is hereby granted, free of charge, to any person obtaining a -.\" copy of this software and associated documentation files (the "Software"), -.\" to deal in the Software without restriction, including without limitation -.\" the rights to use, copy, modify, merge, publish, distribute, sublicense, -.\" and/or sell copies of the Software, and to permit persons to whom the -.\" Software is furnished to do so, subject to the following conditions: -.\" -.\" The above copyright notice and this permission notice (including the next -.\" paragraph) shall be included in all copies or substantial portions of the -.\" Software. -.\" -.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL -.\" THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -.\" LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -.\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER -.\" DEALINGS IN THE SOFTWARE. -.\" -.TH XkbSetBounceKeysDelay __libmansuffix__ __xorgversion__ "XKB FUNCTIONS" -.SH NAME -XkbSetBounceKeysDelay \- Sets the BounceKeys delay for a keyboard device -.SH SYNOPSIS -.HP -.B Bool XkbSetBounceKeysDelay -.BI "(\^Display *" "display" "\^," -.BI "unsigned int " "device_spec" "\^," -.BI "unsigned int *" "delay" "\^);" -.if n .ti +5n -.if t .ti +.5i -.SH ARGUMENTS -.TP -.I \- display -connection to X server -.TP -.I \- device_spec -device ID, or XkbUseCoreKbd -.TP -.I \- delay -backfilled with bounce keys delay, ms -.SH DESCRIPTION -.LP -The server can generate XkbAccessXNotify events for some of the global keyboard -controls. -The detail field describes what AccessX event just occurred and can be any of -the values in -Table 1. - -.TS -c s -l l -l lw(4i). -Table 1 AccessXNotify Events -_ -detail Reason -_ -XkbAXN_SKPress T{ -A key was pressed when SlowKeys was enabled. -T} -XkbAXN_SKAccept T{ -A key was accepted (held longer than the SlowKeys delay). -T} -XkbAXN_SKRelease T{ -An accepted SlowKeys key was released. -T} -XkbAXN_SKReject T{ -A key was rejected (released before the SlowKeys delay expired). -T} -XkbAXN_BKAccept T{ -A key was accepted by BounceKeys. -T} -XkbAXN_BKReject T{ -A key was rejected (pressed before the BounceKeys delay expired). -T} -XkbAXN_AXKWarning T{ -AccessXKeys is about to turn on/off StickyKeys or BounceKeys. -T} -.TE - -The -.I keycode -field reports the keycode of the key for which the event occurred. If the action -is related to -.I SlowKeys, -the -.I slowKeysDelay -field contains the current SlowKeys acceptance delay. If the action is related -to BounceKeys, -the -.I debounceDelay -field contains the current BounceKeys debounce delay. - -Selecting for AccessX Events - -To receive XkbAccessXNotify events under all possible conditions, use -.I XkbSelectEvents -and pass XkbAccesXNotifyMask in both -.I bits_to_change -and -.I values_for_bits. - -To receive XkbStateNotify events only under certain conditions, use -.I XkbSelectEventDetails -using XkbAccessXNotify as the -.I event_type -and specifying the desired state changes in -.I bits_to_change -and -.I values_for_bits -using mask bits from Table 2. - -.TS -c s s -l l l -l l lw(3i). -Table 2 AccessXNotify Event Details -_ -XkbAccessXNotify Event Details Value Circumstances -_ -XkbAXN_SKPressMask (1<<0) T{ -Slow key press notification wanted -T} -XkbAXN_SKAcceptMask (1<<1) T{ -Slow key accept notification wanted -T} -XkbAXN_SKRejectMask (1<<2) T{ -Slow key reject notification wanted -T} -XkbAXN_SKReleaseMask (1<<3) T{ -Slow key release notification wanted -T} -XkbAXN_BKAcceptMask (1<<4) T{ -Bounce key accept notification wanted -T} -XkbAXN_BKRejectMask (1<<5) T{ -Bounce key reject notification wanted -T} -XkbAXN_AXKWarningMask (1<<6) T{ -AccessX warning notification wanted -T} -XkbAXN_AllEventsMask (0x7f) T{ -All AccessX features notifications wanted -T} -.TE - -Some users may accidentally "bounce" on a key when they release it. They press -it once, then accidentally press it again after they release it. The BounceKeys -control temporarily disables a key after it has been pressed, effectively -"debouncing" the keyboard. The period of time the key is disabled after it is -released is known as the -.I BounceKeys delay. -BounceKeys is a boolean control. - -When the BounceKeys control is active, the server reports acceptance or -rejection of any key to interested clients by sending an appropriate -AccessXNotify event. - -.I XkbSetBounceKeysDelay -sends a request to configure the BounceKeys control to the server. It does not -wait for a reply and normally returns True. Specifying a value of zero for the -delay parameter causes -.I XkbSetBounceKeysDelay -to generate a BadValue protocol error. If a compatible version of the Xkb -extension is not available in the server, -.I XkbSetBounceKeysDelay -returns False. -.SH "RETURN VALUES" -.TP 15 -True -The -.I XkbSetBounceKeysDelay -function returns True when it sends a request to configure the BounceKeys -control to the server. -.TP 15 -False -The -.I XkbSetBounceKeysDelay -function returns False if a compatible version of the Xkb extension is not -available in the server. -.SH STRUCTURES -.LP -The structure for the XkbAccessXNotify event type is as follows: - -.nf -typedef struct { - int type; /\(** Xkb extension base event code */ - unsigned long serial; /\(** X server serial number for event */ - Bool send_event; /\(** True => synthetically generated */ - Display * display; /\(** server connection where event generated */ - Time time; /\(** server time when event generated */ - int xkb_type; /\(** XkbAccessXNotify */ - int device; /\(** Xkb device ID, will not be XkbUseCoreKbd -*/ - int detail; /\(** XkbAXN_* */ - KeyCode keycode; /\(** key of event */ - int slowKeysDelay; /\(** current SlowKeys delay */ - int debounceDelay; /\(** current debounce delay */ -} XkbAccessXNotifyEvent; - -.fi -.SH DIAGNOSTICS -.TP 15 -.B BadValue -An argument is out of range +'\" t +.\" Copyright 1999 Sun Microsystems, Inc. All rights reserved. +.\" +.\" Permission is hereby granted, free of charge, to any person obtaining a +.\" copy of this software and associated documentation files (the "Software"), +.\" to deal in the Software without restriction, including without limitation +.\" the rights to use, copy, modify, merge, publish, distribute, sublicense, +.\" and/or sell copies of the Software, and to permit persons to whom the +.\" Software is furnished to do so, subject to the following conditions: +.\" +.\" The above copyright notice and this permission notice (including the next +.\" paragraph) shall be included in all copies or substantial portions of the +.\" Software. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL +.\" THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +.\" LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +.\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER +.\" DEALINGS IN THE SOFTWARE. +.\" +.TH XkbSetBounceKeysDelay __libmansuffix__ __xorgversion__ "XKB FUNCTIONS" +.SH NAME +XkbSetBounceKeysDelay \- Sets the BounceKeys delay for a keyboard device +.SH SYNOPSIS +.HP +.B Bool XkbSetBounceKeysDelay +.BI "(\^Display *" "display" "\^," +.BI "unsigned int " "device_spec" "\^," +.BI "unsigned int *" "delay" "\^);" +.if n .ti +5n +.if t .ti +.5i +.SH ARGUMENTS +.TP +.I \- display +connection to X server +.TP +.I \- device_spec +device ID, or XkbUseCoreKbd +.TP +.I \- delay +backfilled with bounce keys delay, ms +.SH DESCRIPTION +.LP +The server can generate XkbAccessXNotify events for some of the global keyboard +controls. +The detail field describes what AccessX event just occurred and can be any of +the values in +Table 1. + +.TS +c s +l l +l lw(4i). +Table 1 AccessXNotify Events +_ +detail Reason +_ +XkbAXN_SKPress T{ +A key was pressed when SlowKeys was enabled. +T} +XkbAXN_SKAccept T{ +A key was accepted (held longer than the SlowKeys delay). +T} +XkbAXN_SKRelease T{ +An accepted SlowKeys key was released. +T} +XkbAXN_SKReject T{ +A key was rejected (released before the SlowKeys delay expired). +T} +XkbAXN_BKAccept T{ +A key was accepted by BounceKeys. +T} +XkbAXN_BKReject T{ +A key was rejected (pressed before the BounceKeys delay expired). +T} +XkbAXN_AXKWarning T{ +AccessXKeys is about to turn on/off StickyKeys or BounceKeys. +T} +.TE + +The +.I keycode +field reports the keycode of the key for which the event occurred. If the action +is related to +.I SlowKeys, +the +.I slowKeysDelay +field contains the current SlowKeys acceptance delay. If the action is related +to BounceKeys, +the +.I debounceDelay +field contains the current BounceKeys debounce delay. + +Selecting for AccessX Events + +To receive XkbAccessXNotify events under all possible conditions, use +.I XkbSelectEvents +and pass XkbAccesXNotifyMask in both +.I bits_to_change +and +.I values_for_bits. + +To receive XkbStateNotify events only under certain conditions, use +.I XkbSelectEventDetails +using XkbAccessXNotify as the +.I event_type +and specifying the desired state changes in +.I bits_to_change +and +.I values_for_bits +using mask bits from Table 2. + +.TS +c s s +l l l +l l lw(3i). +Table 2 AccessXNotify Event Details +_ +XkbAccessXNotify Event Details Value Circumstances +_ +XkbAXN_SKPressMask (1<<0) T{ +Slow key press notification wanted +T} +XkbAXN_SKAcceptMask (1<<1) T{ +Slow key accept notification wanted +T} +XkbAXN_SKRejectMask (1<<2) T{ +Slow key reject notification wanted +T} +XkbAXN_SKReleaseMask (1<<3) T{ +Slow key release notification wanted +T} +XkbAXN_BKAcceptMask (1<<4) T{ +Bounce key accept notification wanted +T} +XkbAXN_BKRejectMask (1<<5) T{ +Bounce key reject notification wanted +T} +XkbAXN_AXKWarningMask (1<<6) T{ +AccessX warning notification wanted +T} +XkbAllAccessXEventsMask (0x7f) T{ +All AccessX features notifications wanted +T} +.TE + +Some users may accidentally "bounce" on a key when they release it. They press +it once, then accidentally press it again after they release it. The BounceKeys +control temporarily disables a key after it has been pressed, effectively +"debouncing" the keyboard. The period of time the key is disabled after it is +released is known as the +.I BounceKeys delay. +BounceKeys is a boolean control. + +When the BounceKeys control is active, the server reports acceptance or +rejection of any key to interested clients by sending an appropriate +AccessXNotify event. + +.I XkbSetBounceKeysDelay +sends a request to configure the BounceKeys control to the server. It does not +wait for a reply and normally returns True. Specifying a value of zero for the +delay parameter causes +.I XkbSetBounceKeysDelay +to generate a BadValue protocol error. If a compatible version of the Xkb +extension is not available in the server, +.I XkbSetBounceKeysDelay +returns False. +.SH "RETURN VALUES" +.TP 15 +True +The +.I XkbSetBounceKeysDelay +function returns True when it sends a request to configure the BounceKeys +control to the server. +.TP 15 +False +The +.I XkbSetBounceKeysDelay +function returns False if a compatible version of the Xkb extension is not +available in the server. +.SH STRUCTURES +.LP +The structure for the XkbAccessXNotify event type is as follows: + +.nf +typedef struct { + int type; /\(** Xkb extension base event code */ + unsigned long serial; /\(** X server serial number for event */ + Bool send_event; /\(** True => synthetically generated */ + Display * display; /\(** server connection where event generated */ + Time time; /\(** server time when event generated */ + int xkb_type; /\(** XkbAccessXNotify */ + int device; /\(** Xkb device ID, will not be XkbUseCoreKbd +*/ + int detail; /\(** XkbAXN_* */ + KeyCode keycode; /\(** key of event */ + int slowKeysDelay; /\(** current SlowKeys delay */ + int debounceDelay; /\(** current debounce delay */ +} XkbAccessXNotifyEvent; + +.fi +.SH DIAGNOSTICS +.TP 15 +.B BadValue +An argument is out of range diff --git a/libX11/man/xkb/XkbSetDetectableAutorepeat.man b/libX11/man/xkb/XkbSetDetectableAutorepeat.man index 7666b2ba8..2507985b1 100644 --- a/libX11/man/xkb/XkbSetDetectableAutorepeat.man +++ b/libX11/man/xkb/XkbSetDetectableAutorepeat.man @@ -1,105 +1,105 @@ -.\" Copyright 1999 Sun Microsystems, Inc. All rights reserved. -.\" -.\" Permission is hereby granted, free of charge, to any person obtaining a -.\" copy of this software and associated documentation files (the "Software"), -.\" to deal in the Software without restriction, including without limitation -.\" the rights to use, copy, modify, merge, publish, distribute, sublicense, -.\" and/or sell copies of the Software, and to permit persons to whom the -.\" Software is furnished to do so, subject to the following conditions: -.\" -.\" The above copyright notice and this permission notice (including the next -.\" paragraph) shall be included in all copies or substantial portions of the -.\" Software. -.\" -.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL -.\" THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -.\" LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -.\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER -.\" DEALINGS IN THE SOFTWARE. -.\" -.TH XkbSetDetectableAutorepeat __libmansuffix__ __xorgversion__ "XKB FUNCTIONS" -.SH NAME -XkbSetDetectableAutorepeat \- Sets DetectableAutorepeat -.SH SYNTAX -.HP -.B Bool XkbSetDetectableAutorepeat -.BI "(\^Display *" "display" "\^," -.BI "Bool " "detectable" "\^," -.BI "Bool *" "supported_rtrn" "\^);" -.if n .ti +5n -.if t .ti +.5i -.SH ARGUMENTS -.TP -.I \- display -connection to X server -.TP -.I \- detectable -True => set DetectableAutorepeat -.TP -.I \- supported_rtrn -backfilled True if DetectableAutorepeat supported -.SH DESCRIPTION -.LP -Auto-repeat is the generation of multiple key events by a keyboard when the user -presses a key and holds it down. Keyboard hardware and device-dependent X server -software often implement auto-repeat by generating multiple KeyPress events with -no intervening KeyRelease event. The standard behavior of the X server is to -generate a KeyRelease event for every KeyPress event. If the keyboard hardware -and device-dependent software of the X server implement auto-repeat by -generating multiple KeyPress events, the device-independent part of the X server -by default synthetically generates a KeyRelease event after each KeyPress event. -This provides predictable behavior for X clients, but does not allow those -clients to detect the fact that a key is auto-repeating. - -Xkb allows clients to request -.I detectable auto-repeat. -If a client requests and the server supports DetectableAutorepeat, Xkb generates -KeyRelease events only when the key is physically released. If -DetectableAutorepeat is not supported or has not been requested, the server -synthesizes a KeyRelease event for each repeating KeyPress event it generates. - -DetectableAutorepeat, unlike other controls, is not contained in the -XkbControlsRec structure, nor can it be enabled or disabled via the -EnabledControls control. Instead, query and set DetectableAutorepeat using -.I XkbGetDetectableAutorepeat -and -.I XkbSetDetectableAutorepeat. - -DetectableAutorepeat is a condition that applies to all keyboard devices for a -client's connection to a given X server; it cannot be selectively set for some -devices and not for others. For this reason, none of the Xkb library functions -involving DetectableAutorepeat involve a device specifier. - -This request affects all keyboard activity for the requesting client only; other -clients still see the expected nondetectable auto-repeat behavior, unless they -have requested otherwise. - -.I XkbSetDetectableAutorepeat -sends a request to the server to set DetectableAutorepeat on for the current -client if -.I detectable -is True, and off if -.I detectable -is False; it then waits for a reply. If -.I supported_rtrn -is not NULL, -.I XkbSetDetectableAutorepeat -backfills -.I supported_rtrn -with True if the server supports DetectableAutorepeat, and False if it does not. -.I XkbSetDetectableAutorepeat -returns the current state of DetectableAutorepeat for the requesting client: -True if DetectableAutorepeat is set, and False otherwise. -.SH "RETURN VALUES" -.TP 15 -True -The -.I XkbSetDetectableAutorepeat -function returns True if DetectableAutorepeat is set. -.TP 15 -False -The -.I XkbSetDetectableAutorepeat -function returns False if DetectableAutorepeat is not set. +.\" Copyright 1999 Sun Microsystems, Inc. All rights reserved. +.\" +.\" Permission is hereby granted, free of charge, to any person obtaining a +.\" copy of this software and associated documentation files (the "Software"), +.\" to deal in the Software without restriction, including without limitation +.\" the rights to use, copy, modify, merge, publish, distribute, sublicense, +.\" and/or sell copies of the Software, and to permit persons to whom the +.\" Software is furnished to do so, subject to the following conditions: +.\" +.\" The above copyright notice and this permission notice (including the next +.\" paragraph) shall be included in all copies or substantial portions of the +.\" Software. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL +.\" THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +.\" LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +.\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER +.\" DEALINGS IN THE SOFTWARE. +.\" +.TH XkbSetDetectableAutoRepeat __libmansuffix__ __xorgversion__ "XKB FUNCTIONS" +.SH NAME +XkbSetDetectableAutoRepeat \- Sets DetectableAutoRepeat +.SH SYNTAX +.HP +.B Bool XkbSetDetectableAutoRepeat +.BI "(\^Display *" "display" "\^," +.BI "Bool " "detectable" "\^," +.BI "Bool *" "supported_rtrn" "\^);" +.if n .ti +5n +.if t .ti +.5i +.SH ARGUMENTS +.TP +.I \- display +connection to X server +.TP +.I \- detectable +True => set DetectableAutoRepeat +.TP +.I \- supported_rtrn +backfilled True if DetectableAutoRepeat supported +.SH DESCRIPTION +.LP +Auto-repeat is the generation of multiple key events by a keyboard when the user +presses a key and holds it down. Keyboard hardware and device-dependent X server +software often implement auto-repeat by generating multiple KeyPress events with +no intervening KeyRelease event. The standard behavior of the X server is to +generate a KeyRelease event for every KeyPress event. If the keyboard hardware +and device-dependent software of the X server implement auto-repeat by +generating multiple KeyPress events, the device-independent part of the X server +by default synthetically generates a KeyRelease event after each KeyPress event. +This provides predictable behavior for X clients, but does not allow those +clients to detect the fact that a key is auto-repeating. + +Xkb allows clients to request +.I detectable auto-repeat. +If a client requests and the server supports DetectableAutoRepeat, Xkb generates +KeyRelease events only when the key is physically released. If +DetectableAutoRepeat is not supported or has not been requested, the server +synthesizes a KeyRelease event for each repeating KeyPress event it generates. + +DetectableAutoRepeat, unlike other controls, is not contained in the +XkbControlsRec structure, nor can it be enabled or disabled via the +EnabledControls control. Instead, query and set DetectableAutoRepeat using +.I XkbGetDetectableAutoRepeat +and +.I XkbSetDetectableAutoRepeat. + +DetectableAutoRepeat is a condition that applies to all keyboard devices for a +client's connection to a given X server; it cannot be selectively set for some +devices and not for others. For this reason, none of the Xkb library functions +involving DetectableAutoRepeat involve a device specifier. + +This request affects all keyboard activity for the requesting client only; other +clients still see the expected nondetectable auto-repeat behavior, unless they +have requested otherwise. + +.I XkbSetDetectableAutoRepeat +sends a request to the server to set DetectableAutoRepeat on for the current +client if +.I detectable +is True, and off if +.I detectable +is False; it then waits for a reply. If +.I supported_rtrn +is not NULL, +.I XkbSetDetectableAutoRepeat +backfills +.I supported_rtrn +with True if the server supports DetectableAutoRepeat, and False if it does not. +.I XkbSetDetectableAutoRepeat +returns the current state of DetectableAutoRepeat for the requesting client: +True if DetectableAutoRepeat is set, and False otherwise. +.SH "RETURN VALUES" +.TP 15 +True +The +.I XkbSetDetectableAutoRepeat +function returns True if DetectableAutoRepeat is set. +.TP 15 +False +The +.I XkbSetDetectableAutoRepeat +function returns False if DetectableAutoRepeat is not set. -- cgit v1.2.3