     MICROSOFT WINDOWS SOFTWARE DEVELOPMENT KIT SAMPLE

     This sample demonstrates how to use CMAKE to maintain a Microsoft
     Windows application that is built with the programs: CL, RC, and
     LINK.


     TO RUN CMAKE:

     1. Check the LINK response file, "hw.lrf", to be sure that the
        paths of the libraries, "libw.lib" and "slibcew.lib", are
        correct.
     2. Execute CMAKE by entering the command

        cmake

        No parameters are required.


     NOTE THE FOLLOWING:

     1. The commands (and comments) in the make file, "makefile".
        CMAKE will deduce all dependencies from these commands.

        See: The Make File for CMAKE
               CL
               * When is a CL Command Required?
               RC
                 RC/C - Compile a Resource-Script File
                 * When is an RC/C Command Required?
               RC
                 RC/A - Add a Resource File to an Executable File
                 * When is an RC/A Command Required?
               LINK
               * When is a LINK Command Required?
             in the help file.

     2. The format of the LINK response file, "hw.lnk".  CMAKE requires
        that a response file (of a particular form) be used with the
        LINK command.

        See: The Make File for CMAKE
               LINK
               * The LINK Command Line
             in the help file.

        Since CMAKE does not use the LIB environment variable, the
        paths of the windows libraries, "libw.lib" and "slibcew.lib"
        must be provided.

     3. The use and placement of the comment

        /* CMAKE - INCLUDE END */

        in the files, "hw.c" and "hw.rc".

        In the file, "hw.c", this comment is placed after all #include
        statements.  Although this comment is not required in C-source
        files, it serves as an end-of-file mark for CMAKE, and thus
        prevents CMAKE from searching the entire source file for
        #include statements.

        See: Optimizing Performance
             * Use the End-of-Includes Comment in Your Source Files
             The Make File for CMAKE
               CL
               * Switches for CL
               * How CMAKE Processes a C-Source File
             in the help file.

        In the file, "hw.rc", this comment is placed after all #include
        statements and resource-include statements (i.e. ICON, BITMAP,
        CURSOR, FONT, or user-defined resource statements).  This
        comment is required in this file.

        See: The Make File for CMAKE
               RC
                 RC/C - Compile a Resource-Script File
                   Helpful Hints
                   * Controlling Resource-Script File Processing
                 * Switches for RC
                 * How CMAKE Processes a Resource-Script File
             Optimizing Performance
             * Use the End-of-Includes Comment in Your Source Files
             in the help file.
