X11R7.4 - man page for xkballocgeomdoodads (x11r4 section 3)

XkbAllocGeomDoodads(3)			  XKB FUNCTIONS 		   XkbAllocGeomDoodads(3)

NAME
       XkbAllocGeomDoodads - Allocate doodads that are global to a keyboard geometry

SYNOPSIS
       Status XkbAllocGeomDoodads ( geom, num_needed )
	     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 geome-
       try. Use these functions to create or modify keyboard geometries.  Note that  these  func-
       tions  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 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 BadValue 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.2.1 		   XkbAllocGeomDoodads(3)