Jump to content

Introduction to the OS/2 API Documentation

From EDM2
Revision as of 07:52, 24 December 2004 by Prokushev (talk | contribs)

by Prokushev, Daniel.Lee.Kruse

Introduction

OS/2 and eComStation API not available for public domain. If for OS/2 users is only possible way to get API documentation via buying OS/2 Toolkit then eComStation users in better situation - OS/2 Toolkit shipped in the box. Anyway, OS/2 Toolkit documentation contain errors, not all API documented etc. Lot of parts just missed. eComStation comes with newer interfaces, but they not described in any eComStation official documentation.

In 1996 The OS/2 API project was started. But copyright issues not allowed to extend project after maintainers lost interest in it. So, all work from the OS/2 API project was lost.

After EDM/2 was relaunched in 2004 Daniel.Lee.Kruse started OS/2 API Documentation pages. Wiki provided good chance to make this project live.

API entry definition

Each API entry must be described and documented in common and standard representation form.

Messages definition

Messages also can be interpreted as API entry. Usually you calls API function WinSendMsg and recieves result. Each message has some specific parameters and return codes. So, message also must be represented in some form.

SOM Interface definition

SOM interfaces has different description format. Mainly, Interface Definition Language describes SOM interface fully, but not in easy to understand form (without IDL background knowlidges). Also another specifig things, like no export entries for methods, no exact known location, etc.