New OS/2 Unicode API programming reference
July 25, 2006 by Alex Taylor
From: "Alex Taylor" posted on comp.os.os2.announce
I've undertaken to revamp and update the abysmal Toolkit documentation for the OS/2 Unicode API (a.k.a. Universal Language Support).
The work is still in progress, but my first updated release is ready for the public: http://www.cs-club.org/~alex/os2/toolkits/uls/index.html
You can browse it online, or download the zipped HTML file.
This is based on the IBM UNIAPI.HTM document from the 4.5x toolkit, but includes the following improvements:
* Completely reformatted the HTML (including a simple built-in stylesheet) to make it actually readable. It should remain compatible with all old web browsers, of course.
* Added a section describing API return codes.
* Several incorrect, poorly-expressed or just plain misleading function descriptions have been fixed. And some previously missing descriptions have been added (in particular, UniStrToUcs -- the IBM version actually had a duplicate description for UniUconvToUcs pasted in under this heading instead).
* Many clarifications, improvements, and helpful comments have been added.
* Some of the sample code has been replaced or rewritten with code that actually works.
* All this, and I actually managed to reduce the size of the HTML file by about 20 KB (mostly by deleting redundant code added by whatever idiot HTML editor IBM used to originally create it).
* Add a section for the ULS keyboard functions (which were inexplicably removed from the documentation after the 4.0 Toolkit).
Since it's directly derived from IBM's own documentation, I suppose there's a bit of a legal question mark over it... but I frankly doubt that IBM will care.
-- Alex Taylor http://www.cs-club.org/~alex