NAME
        NewFontContents -- Create a fontcontents image for a font. (v34)

   SYNOPSIS
        fontContentsHeader = NewFontContents(fontsLock,fontName)
       D0                                   A0        A1

        struct fontcontentsheader *newfontcontents( bptr, char * );

   FUNCTION
        This function creates a new array of fontcontents entries
        that describe all the fonts associated with the fontName,
        specifically, all those in the font directory whose name
        is that of the font sans the ".font" suffix.

   INPUTS
        fontsLock - a DOS lock on the FONTS: directory (or other
            directory where the font contents file and associated
            font directory resides).
        fontName - the font name, with the ".font" suffix, which
            is also the name of the font contents file.

   RESULT
        fontContentsHeader - a struct fontcontentsheader pointer.

   EXCEPTIONS
        This command was first made available as of version 34.

        D0 is zero if the fontName is does not have a ".font" suffix,
        if the fontName is too long, if a DOS error occurred, or if
        memory could not be allocated for the fontContentsHeader.

   SEE ALSO
        disposefontcontents() to free the structure acquired here.