DragonFly On-Line Manual Pages
XkbAllocGeomDoodads(3) XKB FUNCTIONS XkbAllocGeomDoodads(3)
NAME
XkbAllocGeomDoodads - Allocate doodads that are global to a keyboard
geometry
SYNOPSIS
Status XkbAllocGeomDoodads (XkbGeometryPtr geom, int num_needed);
ARGUMENTS
- geom geometry for which doodads should be allocated
- num_needed
number of new doodads required
DESCRIPTION
Xkb provides a number of functions to allocate and free subcomponents
of a keyboard geometry. Use these functions to create or modify key-
board geometries. Note that these functions merely allocate space for
the new element(s), and it is up to you to fill in the values explic-
itly in your code. These allocation functions increase sz_* but never
touch num_* (unless there is an allocation failure, in which case they
reset both sz_* and num_* to zero). These functions return Success if
they succeed, BadAlloc if they are not able to allocate space, or Bad-
Value if a parameter is not as expected.
XkbAllocGeomDoodads allocates num_needed doodads and adds them to the
specified geometry geom. No initialization of the doodads is done.
DIAGNOSTICS
BadAlloc Unable to allocate storage
BadValue An argument is out of range
X Version 11 libX11 1.6.7 XkbAllocGeomDoodads(3)