[7432] in comp.os.os2.announce archive
New OS/2 Unicode API programming reference
daemon@ATHENA.MIT.EDU (Alex Taylor)
Mon Jul 24 14:45:12 2006
To: os2ann.DISCUSS@bloom-picayune.mit.edu
Date: 23 Jul 2006 18:01:03 -0500
From: "Alex Taylor" <mail.me@reply.to.address.rackshack.net>
Reply-To: alextaylor41@rogers.com
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).
Still TODO:
* 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
Remove hat to reply (reply-to address).
