[Fontconfig] Questions on the fontconfig documentation

[David Kotishadze]

Hello everyone!

I work for the Institute for System Programming of the Russian Academy 
of Sciences (ISP RAS). In collaboration with the Linux Foundation (LF) 
we are developing conformance tests for the interfaces included in the 
Linux Standard Base (LSB). In particular I am developing the tests for 
the fontconfig library. So I have some questions regarding the 
fontconfig documentation and I would appreciate if the developers of 
fontconfig could give me comments on the following matters.

1) FcNameRegisterObjectTypes + FcNameUnregisterObjectTypes + 
FcNameGetObjectType

When registering object type with the same type and the same name more 
then once, lets consider twice, you should unregister this object type 
twice if you want the function FcNameGetObjectType not to return it. so 
here comes the question: Is this a feature or a bug of the fontconfig? 
The documentation says nothing on the question.

(The same problem is with FcNameConstant+get+register+unregister)

2) Could you give more detailed information how FcCharSetFirstPage and 
FcCharSetNextPage work please, because the documentation on those ones 
is pretty unclear.

3) There are functions, which are included in the LSB and are not 
documented on the "http://fontconfig.org/fontconfig-devel/". Here is the 
list of such functions:

FcFontSetList
FcFontSetMatch
FcFontSetPrint
FcFontSetSort
FcFontSetSortDestroy
FcValueEqual
FcValuePrint
FcStrSetEqual
FcStrCmp
FcPatternAddFTFace
FcPatternAddLangSet
FcPatternDuplicate
FcPatternGetFTFace
FcPatternGetLangSet
FcPatternReference
FcConfigEnableHome
FcConfigHome
FcFreeTypeCharSetAndSpacing
FcLangSetAdd
FcLangSetCompare
FcLangSetContains
FcLangSetCopy
FcLangSetCreate
FcLangSetDestroy
FcLangSetEqual
FcLangSetHasLang
FcLangSetHash

Could you say which of them are not documented by an oversight and which 
   of them have to be excluded from the LSB as private functions of the 
fontconfig library.

4) IMHO There are some misprints both in documentation and in source of 
the fontconfig.

a) In the documentation of the function FcUtf8ToUcs4 
(http://fontconfig.org/fontconfig-devel/r3058.html) there should be 
"must" instead of "nust" in this part of the text "src nust be at least 
len bytes long."

b) IMHO the name of those two functions should be 
FcConfigSetRescanInterval and FcConfigGetRescanInterval instead of 
FcConfigSetRescanInverval and FcConfigGetRescanInverval. There is "v" 
instead of "t" in the word Inverval (should be Interval). This misprint 
is in both the documentation as the source of the library. 
(http://fontconfig.org/fontconfig-devel/r1943.html)

--
Regards,
David Kotishadze

Linux Verification Center, ISP RAS
web:    http://www.linuxtesting.org
e-mail: ssdk at ispras.ru