FMGETCOMMENT(3W)					      FMGETCOMMENT(3W)

NAME    [Toc]    [Back]

     fmgetcomment - return a comment associated	with a font

SYNOPSIS    [Toc]    [Back]

     #include <fmclient.h>

     long fmgetcomment(fh, slen, str);
     fmfonthandle fh;
     long slen;
     char *str;

DESCRIPTION    [Toc]    [Back]

     This function was made obsolete by	changes	to the IRIS Font Manager.  The
     function was replaced by a	stub that does not do anything.	 What follows
     is	a description of what this function did	under the NeWS windowing
     system.

     fmgetcomment gets the comment associated with the font fh.	This routine
     writes that comment to the	location (array) pointed to by the str
     character pointer.	You must use the slen parameter	to tell	fmgetcomment
     the longest string	it can write to	the str	array.	fmgetcomment does not
     write more	characters than	specified by slen. Normally, returned function
     value for fmgetcomment is the length of the string	it writes to str.
     But, if fmgetcomment cannot find the font fh , or if no comment exists
     for the font, the returned	value of the function is -1.

SEE ALSO    [Toc]    [Back]

     fminit(3W), fmfindfont(3W), fmscalefont(3W).

NOTE    [Toc]    [Back]

     This routine is available only in immediate mode.


									PPPPaaaaggggeeee 1111