Provided by: libmotif-dev_2.3.3-5ubuntu1_amd64 bug

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  deallocates  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)