Date:  Tue, 25 Jul 2006 11:45:39 -0400
From:  madodel <madodel at ptdprolog.net>
Subject:  [VOICENWS] Net: New OS/2 Unicode API programming reference

++ From the VOICE OS/2-eCS News Service   http://www.os2voice.org ++

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).


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

-- 

  Warpstock 2006 - Windsor, Ontario, Canada, Oct. 12-15th, 
http://www.warpstock.org
  Warpstock Europe - Cologne, Germany, Nov. 17-19th,  http://www.warpstock.net

  [Moderator's note:  All posts are sent without guarantee to the
   accuracy of the content.  We try to verify details and URLs but
   this is an entirely volunteer run list, so 100% fact checking and
   the quality/useability of products announced here is impossible.

   If you respond to this post please remove the DESPAM from the
   poster's email addresses.   Please do not send requests for information
   about a specific post to the moderator unless it is an update or I
sent it.]









-- 

To unsubscribe yourself from this list, send the following message
to majormajor at os2voice.org

     unsubscribe news your.email.address at here
     end

Or, visit http://www.os2voice.org/MailingLists.html

If you have an announcement you would like posted to the VOICE 
News list, please send it to submit at os2voice.org or go to 
http://www.os2voice.org/fSubNews.html . Please include a 
valid reply address and a real contact name.  If you wish to comment
on this post, please reply to feedback at os2voice.org