XmFontListAppendEntry(3X)

NAME
     XmFontListAppendEntry  -- A  font  list function that appends an entry to a
     font list

SYNOPSIS
     #include <Xm/Xm.h>

     XmFontList XmFontListAppendEntry (oldlist, entry)
          XmFontList  oldlist;
          XmFontListEntryentry;


VERSION
     This page documents version 1.2 of the Motif library.

DESCRIPTION
     XmFontListAppendEntry creates a new font list that contains the contents of
     oldlist.  This function copies the contents of the font  list  entry  being
     added  into  this new font list.  If oldlist is NULL, XmFontListAppendEntry
     creates a new font list containing only the single entry specified.

     This function deallocates the original font list after extracting  the  re-
     quired  information.  The caller must free the font list entry by using Xm-
     FontListEntryFree.


     oldlistSpecifies the font list to be added to

     entry  Specifies the font list entry to be added


RETURN VALUE
     If entry is NULL, returns oldlist; otherwise, returns a new font list.

RELATED INFORMATION
     XmFontList(3X), XmFontListEntryCreate(3X), XmFontListEntryFree(3X), Xm-
     FontListEntryLoad(3X), XmFontListFree(3X), and XmFontListRemoveEntry(3X).

                                                       XmFontListAppendEntry(3X)