XkbAllocGeomOverlayRows(3Xkb)	XKBLIB FUNCTION  XkbAllocGeomOverlayRows(3Xkb)



NAME
       XkbAllocGeomOverlayRows - Allocate rows in a overlay

SYNOPSIS
       Status XkbAllocGeomOverlayRows ( overlay, num_needed )

	     XkbSectionPtr overlay;
	     int num_needed;

ARGUMENTS
       - overlay
	      section for which rows should be allocated

       - num_needed
	      number of new rows 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.

       XkbAllocGeomOverlayRows	allocates num_needed rows and adds them to the
       overlay.  No initialization of the rows is done.

       To free rows in an overlay, use XkbFreeGeomOverlayRows.

DIAGNOSTICS
       BadAlloc       Unable to allocate storage

       BadValue       An argument is out of range

SEE ALSO
       XkbFreeGeomOverlayRows(3)



X Version 11			  Release 6.1	 XkbAllocGeomOverlayRows(3Xkb)

NAME - SYNOPSIS - ARGUMENTS - DESCRIPTION - DIAGNOSTICS - SEE ALSO -