hpux man page for xmfontlistadd

XmFontListAdd(library call)											       XmFontListAdd(library call)

NAME
       XmFontListAdd -- A font list function that creates a new font list

SYNOPSIS
       #include <Xm/Xm.h>
       XmFontList XmFontListAdd(
       XmFontList oldlist,
       XFontStruct *font,
       XmStringCharSet charset);

DESCRIPTION
       XmFontListAdd  creates a new font list consisting of the contents of oldlist and the new font list element being added. This function deal-
       locates oldlist after extracting the required information; therefore, do not reference oldlist thereafter.

       NOTE: This function is obsolete and exists for compatibility with previous releases. It has been replaced by XmFontListAppendEntry.

       oldlist	 Specifies a pointer to the font list to which an entry will be added.

       font	 Specifies a pointer to a font structure for which the new font list is generated. This is the	structure  returned  by  the  XLib
		 XLoadQueryFont function.

       charset	 Specifies  the  character set identifier for the font.  This can be XmSTRING_DEFAULT_CHARSET, but this value does not comply with
		 the AES, and it may be removed in future versions of Motif.  If the value is XmSTRING_DEFAULT_CHARSET, the  routine  derives  the
		 character set from the current language environment.

RETURN
       Returns NULL if oldlist is NULL; returns oldlist if font or charset is NULL; otherwise, returns a new font list.

RELATED
       XmFontList(3) and XmFontListAppendEntry(3).

														       XmFontListAdd(library call)