fmcommen(3W)

NAME
     fmgetcomment - return a comment associated with a font

SYNOPSIS
     #include <fmclient.h>

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

DESCRIPTION
     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
     fminit(3W), fmfindfont(3W), fmscalefont(3W).

NOTE
     This routine is available only in immediate mode.