man pages for XKB API's in libX11

Alan Coopersmith alan.coopersmith at sun.com
Mon May 14 17:38:30 PDT 2007


I think they're part of the set the Sun doc writers converted from
the API specs in xc/doc to man page format when we imported X11R6.4
to Solaris 7 many years ago - we've already contributed back a bunch
of these, I just hadn't realized there was a huge pile we hadn't yet
hiding in the libX11 man pages.    (Unfortunately, after that was the
dot-com-bubble-burst, and our doc writers for X got cut in the Sun
layoffs that followed, so we don't have them done for things newer
than 6.4.)

	-Alan Coopersmith-           alan.coopersmith at sun.com
	 Sun Microsystems, Inc. - X Window System Engineering

Egbert Eich wrote:
> Alan,
> 
> do you know where these man pages came from?
> Were these part of the old X.Org SI but were never integrated
> into the new X.Org tree?
> When this 'integration' happened a lot of useless stuff was
> migrated - like the broken Xinerama extension bits which we 
> nuked again before the 6.7 release because they broke the 
> already deployed protocol.
> Apart from this a few bug fixes got migrated. So I wonder
> if there is still more 'useful' stuff lingering around 
> someplace. 
> Documentation is always appreciated ;)
> 
> Cheers,
> 	Egbert.
> 
> Alan Coopersmith writes:
>  > I realized today that we had a huge set (over 200) man pages for
>  > the XKB API's in libX11 in Solaris that somehow weren't in X.Org's
>  > sources, so I've pushed them upstream.    Given the sheer size I
>  > haven't done much checking on them, so anyone who wants to review
>  > and double check them is welcome to do so.
>  > 
>  > The biggest issue I've noticed so far is their Synopsis sections
>  > all still use K&R C function definitions instead of C89 prototypes.
>  > Someone clever with perl/python/etc. could probably whip up a script
>  > to fix that - I won't have time in the near future to do so, so
>  > volunteers are again encouraged to finish off this step.
>  > 
>  > 	-Alan Coopersmith-           alan.coopersmith at sun.com
>  > 	 Sun Microsystems, Inc. - X Window System Engineering
>  > 
>  > -------- Original Message --------
>  > Subject: libX11: Changes to 'master'
>  > Date: Sat, 28 Apr 2007 00:43:13 -0700 (PDT)
>  > From: alanc at kemper.freedesktop.org (Alan Coopersmith)
>  > To: xorg-commit at lists.freedesktop.org
>  > 
>  >   configure.ac                             |    1
>  >   man/Makefile.am                          |    2
>  >   man/xkb/Makefile.am                      |  234 +++++++++++++++++
>  >   man/xkb/XkbActionCtrls.man               |  146 +++++++++++
>  >   man/xkb/XkbAddDeviceLedInfo.man          |  131 ++++++++++
>  >   man/xkb/XkbAddGeomColor.man              |  110 ++++++++
>  >   man/xkb/XkbAddGeomDoodad.man             |  123 +++++++++
>  >   man/xkb/XkbAddGeomKey.man                |   86 ++++++
>  >   man/xkb/XkbAddGeomKeyAlias.man           |   99 +++++++
>  >   man/xkb/XkbAddGeomOutline.man            |   94 +++++++
>  >   man/xkb/XkbAddGeomOverlay.man            |  105 ++++++++
>  >   man/xkb/XkbAddGeomOverlayKey.man         |   95 +++++++
>  >   man/xkb/XkbAddGeomOverlayRow.man         |  100 +++++++
>  >   man/xkb/XkbAddGeomProperty.man           |  100 +++++++
>  >   man/xkb/XkbAddGeomRow.man                |   88 ++++++
>  >   man/xkb/XkbAddGeomSection.man            |  137 ++++++++++
>  >   man/xkb/XkbAddGeomShape.man              |  103 +++++++
>  >   man/xkb/XkbAddSymInterpret.man           |   81 ++++++
>  >   man/xkb/XkbAllocClientMap.man            |  178 +++++++++++++
>  >   man/xkb/XkbAllocCompatMap.man            |  122 +++++++++
>  >   man/xkb/XkbAllocControls.man             |  150 +++++++++++
>  >   man/xkb/XkbAllocDeviceInfo.man           |  114 ++++++++
>  >   man/xkb/XkbAllocDeviceLedInfo.man        |  125 +++++++++
>  >   man/xkb/XkbAllocGeomColors.man           |   82 ++++++
>  >   man/xkb/XkbAllocGeomDoodads.man          |   81 ++++++
>  >   man/xkb/XkbAllocGeomKeyAliases.man       |   86 ++++++
>  >   man/xkb/XkbAllocGeomKeys.man             |   80 ++++++
>  >   man/xkb/XkbAllocGeomOutlines.man         |   86 ++++++
>  >   man/xkb/XkbAllocGeomOverlayKey.man       |   76 +++++
>  >   man/xkb/XkbAllocGeomOverlayRows.man      |   85 ++++++
>  >   man/xkb/XkbAllocGeomOverlays.man         |   75 +++++
>  >   man/xkb/XkbAllocGeomPoints.man           |   80 ++++++
>  >   man/xkb/XkbAllocGeomProps.man            |   83 ++++++
>  >   man/xkb/XkbAllocGeomRows.man             |   80 ++++++
>  >   man/xkb/XkbAllocGeomSectionDoodads.man   |   87 ++++++
>  >   man/xkb/XkbAllocGeomSections.man         |   85 ++++++
>  >   man/xkb/XkbAllocGeomShapes.man           |   86 ++++++
>  >   man/xkb/XkbAllocGeometry.man             |   97 +++++++
>  >   man/xkb/XkbAllocIndicatorMaps.man        |   75 +++++
>  >   man/xkb/XkbAllocKeyboard.man             |   62 ++++
>  >   man/xkb/XkbAllocNames.man                |  132 ++++++++++
>  >   man/xkb/XkbAllocServerMap.man            |  135 ++++++++++
>  >   man/xkb/XkbApplyCompatMapToKey.man       |  376 ++++++++++++++++++++++++++++
>  >   man/xkb/XkbBell.man                      |  344 ++++++++++++++++++++++++++
>  >   man/xkb/XkbBellEvent.man                 |  341 ++++++++++++++++++++++++++
>  >   man/xkb/XkbChangeControls.man            |  336 +++++++++++++++++++++++++
>  >   man/xkb/XkbChangeDeviceInfo.man          |   88 ++++++
>  >   man/xkb/XkbChangeEnabledControls.man     |  180 +++++++++++++
>  >   man/xkb/XkbChangeIndicators.man          |  172 +++++++++++++
>  >   man/xkb/XkbChangeMap.man                 |  149 +++++++++++
>  >   man/xkb/XkbChangeNames.man               |  200 +++++++++++++++
>  >   man/xkb/XkbChangeTypesOfKey.man          |  222 ++++++++++++++++
>  >   man/xkb/XkbComputeRowBounds.man          |   64 ++++
>  >   man/xkb/XkbComputeSectionBounds.man      |   62 ++++
>  >   man/xkb/XkbComputeShapeBounds.man        |   92 +++++++
>  >   man/xkb/XkbComputeShapeTop.man           |   87 ++++++
>  >   man/xkb/XkbCopyKeyType.man               |  106 ++++++++
>  >   man/xkb/XkbCopyKeyTypes.man              |  130 +++++++++
>  >   man/xkb/XkbDeviceBell.man                |  313 +++++++++++++++++++++++
>  >   man/xkb/XkbDeviceBellEvent.man           |  344 ++++++++++++++++++++++++++
>  >   man/xkb/XkbFindOverlayForKey.man         |   66 +++++
>  >   man/xkb/XkbForceBell.man                 |  326 ++++++++++++++++++++++++
>  >   man/xkb/XkbForceDeviceBell.man           |  319 ++++++++++++++++++++++++
>  >   man/xkb/XkbFreeClientMap.man             |  215 ++++++++++++++++
>  >   man/xkb/XkbFreeCompatMap.man             |  178 +++++++++++++
>  >   man/xkb/XkbFreeComponentList.man         |   54 ++++
>  >   man/xkb/XkbFreeControls.man              |  127 +++++++++
>  >   man/xkb/XkbFreeDeviceInfo.man            |  190 ++++++++++++++
>  >   man/xkb/XkbFreeGeomColors.man            |   96 +++++++
>  >   man/xkb/XkbFreeGeomDoodads.man           |   92 +++++++
>  >   man/xkb/XkbFreeGeomKeyAliases.man        |  105 ++++++++
>  >   man/xkb/XkbFreeGeomKeys.man              |   74 +++++
>  >   man/xkb/XkbFreeGeomOutlines.man          |   74 +++++
>  >   man/xkb/XkbFreeGeomOverlayKeys.man       |  102 +++++++
>  >   man/xkb/XkbFreeGeomOverlayRows.man       |  102 +++++++
>  >   man/xkb/XkbFreeGeomOverlays.man          |  102 +++++++
>  >   man/xkb/XkbFreeGeomPoints.man            |  102 +++++++
>  >   man/xkb/XkbFreeGeomProperties.man        |  101 +++++++
>  >   man/xkb/XkbFreeGeomRows.man              |  102 +++++++
>  >   man/xkb/XkbFreeGeomSections.man          |  102 +++++++
>  >   man/xkb/XkbFreeGeomShapes.man            |  101 +++++++
>  >   man/xkb/XkbFreeGeometry.man              |  104 +++++++
>  >   man/xkb/XkbFreeIndicatorMaps.man         |   58 ++++
>  >   man/xkb/XkbFreeKeyboard.man              |   76 +++++
>  >   man/xkb/XkbFreeNames.man                 |  107 ++++++++
>  >   man/xkb/XkbFreeServerMap.man             |  201 +++++++++++++++
>  >   man/xkb/XkbGetAccessXTimeout.man         |  162 ++++++++++++
>  >   man/xkb/XkbGetAutoRepeatRate.man         |  100 +++++++
>  >   man/xkb/XkbGetAutoResetControls.man      |  105 ++++++++
>  >   man/xkb/XkbGetBounceKeysDelay.man        |  226 +++++++++++++++++
>  >   man/xkb/XkbGetCompatMap.man              |  130 +++++++++
>  >   man/xkb/XkbGetControls.man               |  176 +++++++++++++
>  >   man/xkb/XkbGetControlsChanges.man        |  244 ++++++++++++++++++
>  >   man/xkb/XkbGetDetectableAutorepeat.man   |  104 +++++++
>  >   man/xkb/XkbGetDeviceButtonActions.man    |  132 ++++++++++
>  >   man/xkb/XkbGetDeviceInfo.man             |  265 ++++++++++++++++++++
>  >   man/xkb/XkbGetDeviceInfoChanges.man      |   76 +++++
>  >   man/xkb/XkbGetDeviceLedInfo.man          |  171 +++++++++++++
>  >   man/xkb/XkbGetGeometry.man               |   84 ++++++
>  >   man/xkb/XkbGetIndicatorChanges.man       |  169 ++++++++++++
>  >   man/xkb/XkbGetIndicatorMap.man           |  101 +++++++
>  >   man/xkb/XkbGetIndicatorState.man         |   93 +++++++
>  >   man/xkb/XkbGetKeyActions.man             |  108 ++++++++
>  >   man/xkb/XkbGetKeyBehaviors.man           |  106 ++++++++
>  >   man/xkb/XkbGetKeyExplicitComponents.man  |  168 ++++++++++++
>  >   man/xkb/XkbGetKeyModifierMap.man         |  109 ++++++++
>  >   man/xkb/XkbGetKeySyms.man                |  115 ++++++++
>  >   man/xkb/XkbGetKeyTypes.man               |   98 +++++++
>  >   man/xkb/XkbGetKeyVirtualModMap.man       |  119 +++++++++
>  >   man/xkb/XkbGetKeyboard.man               |  106 ++++++++
>  >   man/xkb/XkbGetKeyboardByName.man         |  405 +++++++++++++++++++++++++++++++
>  >   man/xkb/XkbGetMap.man                    |  335 +++++++++++++++++++++++++
>  >   man/xkb/XkbGetNameChanges.man            |   84 ++++++
>  >   man/xkb/XkbGetNamedGeometry.man          |  173 +++++++++++++
>  >   man/xkb/XkbGetNamedIndicator.man         |  138 ++++++++++
>  >   man/xkb/XkbGetNames.man                  |  149 +++++++++++
>  >   man/xkb/XkbGetSlowKeysDelay.man          |  229 +++++++++++++++++
>  >   man/xkb/XkbGetState.man                  |   69 +++++
>  >   man/xkb/XkbGetStickyKeysOptions.man      |  129 +++++++++
>  >   man/xkb/XkbGetUpdatedMap.man             |  276 +++++++++++++++++++++
>  >   man/xkb/XkbGetVirtualMods.man            |  222 ++++++++++++++++
>  >   man/xkb/XkbGetXlibControls.man           |   71 +++++
>  >   man/xkb/XkbIgnoreExtension.man           |   89 ++++++
>  >   man/xkb/XkbInitCanonicalKeyTypes.man     |   98 +++++++
>  >   man/xkb/XkbKeyAction.man                 |  147 +++++++++++
>  >   man/xkb/XkbKeyActionEntry.man            |  153 +++++++++++
>  >   man/xkb/XkbKeyActionsPtr.man             |  146 +++++++++++
>  >   man/xkb/XkbKeyGroupInfo.man              |  210 ++++++++++++++++
>  >   man/xkb/XkbKeyGroupWidth.man             |   86 ++++++
>  >   man/xkb/XkbKeyGroupsWidth.man            |   76 +++++
>  >   man/xkb/XkbKeyHasActions.man             |  137 ++++++++++
>  >   man/xkb/XkbKeyNumActions.man             |  125 +++++++++
>  >   man/xkb/XkbKeyNumGroups.man              |  322 ++++++++++++++++++++++++
>  >   man/xkb/XkbKeyNumSyms.man                |   77 +++++
>  >   man/xkb/XkbKeySymEntry.man               |   95 +++++++
>  >   man/xkb/XkbKeySymsOffset.man             |   78 +++++
>  >   man/xkb/XkbKeySymsPtr.man                |   78 +++++
>  >   man/xkb/XkbKeyType.man                   |   84 ++++++
>  >   man/xkb/XkbKeyTypeIndex.man              |   70 +++++
>  >   man/xkb/XkbKeyTypesForCoreSymbols.man    |  248 ++++++++++++++++++
>  >   man/xkb/XkbKeycodeToKeysym.man           |   76 +++++
>  >   man/xkb/XkbKeysymToModifiers.man         |   64 ++++
>  >   man/xkb/XkbLatchGroup.man                |   97 +++++++
>  >   man/xkb/XkbLatchModifiers.man            |  120 +++++++++
>  >   man/xkb/XkbLibraryVersion.man            |  104 +++++++
>  >   man/xkb/XkbListComponents.man            |  181 +++++++++++++
>  >   man/xkb/XkbLockGroup.man                 |   95 +++++++
>  >   man/xkb/XkbLockModifiers.man             |  118 +++++++++
>  >   man/xkb/XkbLookupKeyBinding.man          |  104 +++++++
>  >   man/xkb/XkbLookupKeySym.man              |   89 ++++++
>  >   man/xkb/XkbModActionVMods.man            |   58 ++++
>  >   man/xkb/XkbNoteControlsChanges.man       |  214 ++++++++++++++++
>  >   man/xkb/XkbNoteDeviceChanges.man         |  149 +++++++++++
>  >   man/xkb/XkbNoteIndicatorChanges.man      |  137 ++++++++++
>  >   man/xkb/XkbNoteNameChanges.man           |  106 ++++++++
>  >   man/xkb/XkbOpenDisplay.man               |  170 +++++++++++++
>  >   man/xkb/XkbOutOfRangeGroupInfo.man       |  196 +++++++++++++++
>  >   man/xkb/XkbOutOfRangeGroupNumber.man     |  197 +++++++++++++++
>  >   man/xkb/XkbPtrActionX.man                |  114 ++++++++
>  >   man/xkb/XkbPtrActionY.man                |  114 ++++++++
>  >   man/xkb/XkbQueryExtension.man            |  146 +++++++++++
>  >   man/xkb/XkbRefreshKeyboardMapping.man    |   78 +++++
>  >   man/xkb/XkbResizeDeviceButtonActions.man |  105 ++++++++
>  >   man/xkb/XkbResizeKeyActions.man          |  114 ++++++++
>  >   man/xkb/XkbResizeKeySyms.man             |  112 ++++++++
>  >   man/xkb/XkbResizeKeyType.man             |  155 +++++++++++
>  >   man/xkb/XkbSAActionSetCtrls.man          |  162 ++++++++++++
>  >   man/xkb/XkbSAGroup.man                   |   67 +++++
>  >   man/xkb/XkbSAPtrDfltValue.man            |  117 ++++++++
>  >   man/xkb/XkbSARedirectSetVMods.man        |  121 +++++++++
>  >   man/xkb/XkbSARedirectSetVModsMask.man    |  134 ++++++++++
>  >   man/xkb/XkbSARedirectVMods.man           |  126 +++++++++
>  >   man/xkb/XkbSARedirectVModsMask.man       |  127 +++++++++
>  >   man/xkb/XkbSAScreen.man                  |  112 ++++++++
>  >   man/xkb/XkbSASetGroup.man                |   72 +++++
>  >   man/xkb/XkbSASetPtrDfltValue.man         |  116 ++++++++
>  >   man/xkb/XkbSASetScreen.man               |  109 ++++++++
>  >   man/xkb/XkbSelectEventDetails.man        |  163 ++++++++++++
>  >   man/xkb/XkbSelectEvents.man              |  186 ++++++++++++++
>  >   man/xkb/XkbSetAccessXTimeout.man         |  215 ++++++++++++++++
>  >   man/xkb/XkbSetAutoRepeatRate.man         |  114 ++++++++
>  >   man/xkb/XkbSetAutoResetControls.man      |  116 ++++++++
>  >   man/xkb/XkbSetBounceKeysDelay.man        |  221 ++++++++++++++++
>  >   man/xkb/XkbSetCompatMap.man              |  219 ++++++++++++++++
>  >   man/xkb/XkbSetControls.man               |  181 +++++++++++++
>  >   man/xkb/XkbSetDebuggingFlags.man         |  193 ++++++++++++++
>  >   man/xkb/XkbSetDetectableAutorepeat.man   |  119 +++++++++
>  >   man/xkb/XkbSetDeviceButtonActions.man    |  112 ++++++++
>  >   man/xkb/XkbSetDeviceInfo.man             |  235 +++++++++++++++++
>  >   man/xkb/XkbSetIgnoreLockMods.man         |  214 ++++++++++++++++
>  >   man/xkb/XkbSetIndicatorMap.man           |  194 ++++++++++++++
>  >   man/xkb/XkbSetMap.man                    |  397 ++++++++++++++++++++++++++++++
>  >   man/xkb/XkbSetModActionVMods.man         |   69 +++++
>  >   man/xkb/XkbSetNamedIndicator.man         |  141 ++++++++++
>  >   man/xkb/XkbSetNames.man                  |  226 +++++++++++++++++
>  >   man/xkb/XkbSetPtrActionX.man             |  120 +++++++++
>  >   man/xkb/XkbSetPtrActionY.man             |  120 +++++++++
>  >   man/xkb/XkbSetServerInternalMods.man     |  218 ++++++++++++++++
>  >   man/xkb/XkbSetXlibControls.man           |  119 +++++++++
>  >   man/xkb/XkbTranslateKeyCode.man          |   89 ++++++
>  >   man/xkb/XkbTranslateKeySym.man           |  101 +++++++
>  >   man/xkb/XkbUpdateMapFromCore.man         |  130 +++++++++
>  >   man/xkb/XkbVirtualModsToReal.man         |  144 +++++++++++
>  >   203 files changed, 27757 insertions(+)
>  > 
>  > New commits:
>  > commit 9824b40d2af4ca2376512c1be7743da0d5065900
>  > Author: Alan Coopersmith <alan.coopersmith at sun.com>
>  > Date:   Sat Apr 28 00:42:18 2007 -0700
>  > 
>  >      Fix typo in nroff macro in XkbAddGeomOverlayKey.man
>  > 
>  > commit f93849dcc68bd5042ea0884e5190dc7c35b31d68
>  > Author: Alan Coopersmith <alan.coopersmith at sun.com>
>  > Date:   Sat Apr 28 00:30:55 2007 -0700
>  > 
>  >      Protect C comments and #defines in XKB man pages from being mangled by cpp
>  > 
>  > commit f2f27d4763c7665e422fab10b96b4cf5ad6c0a6f
>  > Author: Alan Coopersmith <alan.coopersmith at sun.com>
>  > Date:   Sat Apr 28 00:14:50 2007 -0700
>  > 
>  >      Add Makefile to process/install XKB man pages
>  > 
>  > commit d9954c6f6f3a8c406b946acd0d034ff83c656156
>  > Author: Dennis Arellano <Dennis.Arellano at Sun.COM>
>  > Date:   Thu Aug 19 00:00:00 1999 -0700
>  > 
>  >      Add man pages for XKB API's
>  > 
>  >      Man pages originally written for X11R6.4 integration to Solaris 7 11/99
>  >      Sun bug id 4258344: Add new XKB API manpages for 6.4 upgrade
>  >      <http://bugs.opensolaris.org/bugdatabase/view_bug.do?bug_id=4258344>
>  > 
>  >      (Volunteer needed to convert prototypes in man pages to ANSI C style...)
>  > 
>  > _______________________________________________
>  > xorg-commit mailing list
>  > xorg-commit at lists.freedesktop.org
>  > http://lists.freedesktop.org/mailman/listinfo/xorg-commit
>  > 
>  > _______________________________________________
>  > xorg mailing list
>  > xorg at lists.freedesktop.org
>  > http://lists.freedesktop.org/mailman/listinfo/xorg





More information about the xorg mailing list