Return to readme CVS log

Up to [OS/2 SDKs] / os2sdk

Annotation of os2sdk/readme, revision 1.1.1.1

1.1       root        1: C-Language Header Files for MS OS/2
                      2: ===================================
                      3: 
                      4: The MS OS/2 C-language header files contain the definitions you need to
                      5: use the functions, data types, structures, and constants described in the
                      6: Microsoft Operating System/2 Programmer's Reference. 
                      7: 
                      8: When you include the OS2.H file, the C preprocessor automatically defines
                      9: many, but not all, of the most commonly used MS OS/2 functions. The OS2.H
                     10: header file is the first file of a set of files that contains the MS OS/2
                     11: function definitions. Each file contains definitions for the functions,
                     12: data types, structures, and constants associated with a specific group of
                     13: MS OS/2 functions. To minimize the time required to process the many
                     14: header files, each function group is conditionally processed depending on
                     15: whether a corresponding constant is defined within the program source
                     16: file. The following is a list of these constants with descriptions of the
                     17: function groups they represent: 
                     18: 
                     19: Constant Meaning
                     20: INCL_BASE              Includes all MS OS/2 1.0 system function 
                     21:                        definitions. 
                     22: INCL_DOS               Includes all MS OS/2 1.0 kernel function 
                     23:                        definitions (Dos). 
                     24: INCL_SUB               Includes all MS OS/2 1.0 video, keyboard, 
                     25:                        and mouse functions (Vio, Kbd, and Mou). 
                     26: INCL_DOSDATETIME       Includes all date/time and timer functions. 
                     27: INCL_DOSDEVICES                Includes the device and IOPL support functions. 
                     28: INCL_DOSERRORS         Includes the MS OS/2 error constants. 
                     29: INCL_DOSFILEMGR                Includes all file-management functions. 
                     30: INCL_DOSINFOSEG                Includes all information-segment functions. 
                     31: INCL_DOSMEMMGR         Includes all memory-management functions. 
                     32: INCL_DOSMISC           Includes miscellaneous functions.
                     33: INCL_DOSMODULEMGR      Includes all module-manager functions. 
                     34: INCL_DOSMONITORS       Includes all monitor functions. 
                     35: INCL_DOSNLS            Includes national-language-support functions. 
                     36: INCL_DOSPROCESS                Includes all process- and thread-support functions. 
                     37: INCL_DOSQUEUES         Includes all queue functions. 
                     38: INCL_DOSRESOURCES      Includes resource-support functions (not
                     39:                        available in MS OS/2 1.0). 
                     40: INCL_DOSSEMAPHORES     Includes all semaphore functions. 
                     41: INCL_DOSSESMGR         Includes all session-manager functions. 
                     42: INCL_DOSSIGNALS                Includes all signal functions. 
                     43: INCL_NOCOMMON          Excludes any function group not explicitly defined. 
                     44: 
                     45: To use a function within your program function, you simply define the
                     46: corresponding constant by using the #define directive before including the
                     47: OS2.H file. 
                     48: 
                     49: 
                     50: 
                     51: C-Language Library Files for MS OS/2
                     52: ====================================
                     53: 
                     54: The MS OS/2 C-language Run-Time Libraries contain the necessary code to
                     55: make your C program an OS/2 executable, including run-time routines such
                     56: as "printf()" which you may have used in your program. The example
                     57: programs in this toolkit assume that you have Microsoft C 5.10 and that
                     58: you have run its SETUP program to install libraries for MS-DOS (real-mode)
                     59: as well as MS OS/2 (protected-mode).  If you have done this, you will have
                     60: run-time libraries named SLIBCEP.LIB, LLIBCEP.LIB, etc.  This is what this
                     61: toolkit expects.  If you have told MS C 5.10 SETUP that you wish to write
                     62: only Protected Mode programs, it will have created the protected mode
                     63: libraries (required by this toolkit) using the names SLIBCE.LIB, LLIBCE.LIB,
                     64: etc., instead of SLIBCEP.LIB, LLIBCEP.LIB, etc.  In this case, you will have
                     65: to rename those libraries from SLIBCE.LIB to SLIBCEP.LIB, etc. in order for
                     66: the makefiles in this toolkit to work.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.