


XmFontListAdd(3X)					    XmFontListAdd(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmFFoonnttLLiissttAAdddd	- A font list function that creates a new font list

SYNOPSIS


  ##iinncclluuddee <<XXmm//XXmm..hh>>
  XXmmFFoonnttLLiisstt XXmmFFoonnttLLiissttAAdddd ((_o_l_d_l_i_s_t, _f_o_n_t, _c_h_a_r_s_e_t))
       XXmmFFoonnttLLiisstt  _o_l_d_l_i_s_t;;
       XXFFoonnttSSttrruucctt *_f_o_n_t;;
       XXmmSSttrriinnggCChhaarrSSeett_c_h_a_r_s_e_t;;

DESCRIPTION
  XXmmFFoonnttLLiissttAAdddd	creates	a new font list	consisting of the contents of the
  _o_l_d_l_i_s_t and the new font-list	element	being added.  This function deallo-
  cates	the _o_l_d_l_i_s_t after extracting the required information; therefore, do
  not reference	_o_l_d_l_i_s_t	thereafter.

  NNoottee::	This function is obsolete and exists for compatibility with previous
  releases.  It	has been replaced by XXmmFFoonnttLLiissttAAppppeennddEEnnttrryy.

  _o_l_d_l_i_s_tSpecifies a pointer to	the font list to which an entry	will be
	 added.

  _f_o_n_t	 Specifies a pointer to	a font structure for which the new font	list
	 is generated.	This is	the structure returned by the XLib XXLLooaadd--
	 QQuueerryyFFoonntt function.

  _c_h_a_r_s_e_tSpecifies the character set identifier	for the	font.  This can	be
	 XXmmSSTTRRIINNGG__DDEEFFAAUULLTT__CCHHAARRSSEETT, but this value does not comply with the
	 AES, and it may be removed in future versions of Motif.  If the
	 value is XXmmSSTTRRIINNGG__DDEEFFAAUULLTT__CCHHAARRSSEETT, the	routine	derives	the character
	 set from the current language environment.

RETURN VALUE
  Returns NULL if _o_l_d_l_i_s_t is NULL; returns _o_l_d_l_i_s_t if _f_o_n_t or _c_h_a_r_s_e_t is
  NULL;	otherwise, returns a new font list.

RELATED	INFORMATION
  XXmmFFoonnttLLiisstt((33XX)) and XXmmFFoonnttLLiissttAAppppeennddEEnnttrryy((33XX)).


















