properties_read(3) [freebsd man page]

PROPERTIES(3)						   BSD Library Functions Manual 					     PROPERTIES(3)

NAME

     properties_read, property_find, properties_free -- functions to allow creating simple property lists from ASCII file data

LIBRARY

     System Utilities Library (libutil, -lutil)

SYNOPSIS

     #include <libutil.h>

     properties
     properties_read(int fd);

     char *
     property_find(properties list, const char *name);

     void
     properties_free(properties list);

DESCRIPTION

     typedef struct _properties {
	     struct _properties *next;
	     char *name;
	     char *value;
     } *properties;

     The function properties_read() reads name = value pairs from the file descriptor passed in fd and returns the head of a new property list,
     assuming that the file's contents have been parsed properly, or NULL in case of error.

     The property_find() function returns the associated value string for the property named name if found, otherwise NULL.  The value returned
     may be up to PROPERTY_MAX_VALUE bytes in length.

     The properties_free() function is used to free the structure returned by properties_read() when it is no longer needed.

FILE FORMAT

     Each property in the file is assumed to have the format of name = value where name is an alphanumeric string (and any punctuation not includ-
     ing the `=' character) and value is an arbitrary string of text terminated by a newline character.  If newlines are desired, the entire value
     should be enclosed in { } (curly-bracket) characters.  Any line beginning with a # or ; character is assumed to be a comment and will be
     ignored.

AUTHORS

     Jordan Hubbard

BUGS

     Simplistic.

BSD
								  October 7, 1998							       BSD

XkbAddGeomProperty(3)						   XKB FUNCTIONS					     XkbAddGeomProperty(3)

NAME

       XkbAddGeomProperty - Add one property to an existing keyboard geometry description

SYNOPSIS

       XkbPropertyPtr XkbAddGeomProperty (XkbGeometryPtr geom, char *name, char *value);

ARGUMENTS

       - geom geometry to be updated

       - name name of the new property

       - value
	      value for the new property

DESCRIPTION

       Xkb  provides functions to add a single new element to the top-level keyboard geometry. In each case the num_ * fields of the corresponding
       structure is incremented by 1. These functions do not change sz_* unless there is no more room in the array. Some of these  functions  fill
       in  the	values	of the element's structure from the arguments. For other functions, you must explicitly write code to fill the structure's
       elements.

       The top-level geometry description includes a list of geometry properties.  A geometry property associates  an  arbitrary  string  with	an
       equally	arbitrary  name.  Programs  that display images of keyboards can use geometry properties as hints, but they are not interpreted by
       Xkb. No other geometry structures refer to geometry properties.

       XkbAddGeomProperty adds one property with the specified name and value to the  keyboard	geometry  specified  by  geom.	XkbAddGeomProperty
       returns NULL if any of the parameters is empty or if it was not able to allocate space for the property. To allocate space for an arbitrary
       number of properties, use the XkbAllocGeomProps function.

STRUCTURES

	   typedef struct _XkbProperty {
	       char *	      name;	  /* property name */
	       char *	      value;	  /* property value */
	   } XkbPropertyRec,*XkbPropertyPtr;

SEE ALSO

       XkbAllocGeomProps(3)

X Version 11							   libX11 1.6.0 					     XkbAddGeomProperty(3)