Talk:OS2 API: Difference between revisions
RE: API def format |
IO functions under control programming or topical I/O section |
||
| Line 10: | Line 10: | ||
I had in mind that each API call would be a single page sectioned out. For example, the API call and its parameters, then a section with the parameters explained with constants listed - if any. Another section with example code. Maybe a section with closely related functions. A section detailing the return codes of that API call. | I had in mind that each API call would be a single page sectioned out. For example, the API call and its parameters, then a section with the parameters explained with constants listed - if any. Another section with example code. Maybe a section with closely related functions. A section detailing the return codes of that API call. | ||
Thanks. Daniel Lee Kruse | Thanks. Daniel Lee Kruse | ||
== Keyboard, mouse, video function list question == | |||
Should the mouse, keyboard, and video sections go under the control programming section? Or maybe we ought to have an I/O section and place them there along with netlabs' usb api. -Daniel Lee Kruse | |||
Revision as of 17:59, 14 December 2004
Please don't make this available to the outside world just yet. I'm still considering layout and content for the opening page. Thanks. Daniel Lee Kruse
API definition format
How about describing API in an language-neutral format? I mean not in C notation but in something like SOM IDL? Because C API defination hard to read and some info missed (like ordinals and module names).
API def format
Language-neutral format is a good idea. Having never seen SOM IDL I have no idea what that would look like. Could you please post an example or two?
I had in mind that each API call would be a single page sectioned out. For example, the API call and its parameters, then a section with the parameters explained with constants listed - if any. Another section with example code. Maybe a section with closely related functions. A section detailing the return codes of that API call. Thanks. Daniel Lee Kruse
Keyboard, mouse, video function list question
Should the mouse, keyboard, and video sections go under the control programming section? Or maybe we ought to have an I/O section and place them there along with netlabs' usb api. -Daniel Lee Kruse