Hello Wolfgang,
The otftotfm documentation is exemplary!
It is, indeed.
I would like to volunteer to help writing such docs for texfont or otfinstall. But it is very difficult to get the information. Not all of us are able to read sourcecode in perl and ruby and lua.
Well, as propably many tools around, otfinstall is a tool which arose for my personal needs. As soon as it worked, I stopped putting time into it. If I can see any demand, I will pick it up again. But there is luatex/mkiv waiting behind the corner. Then all this will be obsolete anyway. So in my (and a some other people's elses) opinion, putting any non-trivial effort in pdftex/mkii based solutions is a waste of time. Better install luatex and write a font guide for luatex. Patrick