home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / C7OS21.ZIP / README.OS2 < prev    next >
Text File  |  1992-05-08  |  12KB  |  299 lines
  1.  
  2.                                README.OS2 File
  3.                Release Notes for Microsoft(R) C/C++, Version 7.0
  4.                            OS/2 Hosted Add-on Kit
  5.                   (C) Copyright Microsoft Corporation, 1992
  6.  
  7.      This document contains release notes for the OS/2 Hosted Add-on Kit
  8.      for Microsoft C/C++ version 7.0.
  9.  
  10.  
  11. ===============================< CONTENTS >================================
  12.  
  13.  
  14.      This document has the following sections:
  15.  
  16.           Part 1: Product Description
  17.  
  18.           Part 2: Setup Information
  19.  
  20.           Part 3: Product Notes
  21.  
  22.  
  23. ======================< Part 1: Product Description >======================
  24.  
  25.  
  26.      Terms
  27.      -----
  28.  
  29.      Throughout this document, the term "C7 for OS/2" refers to the OS/2
  30.      Hosted Add-on Kit. The components of C7 for OS/2 are listed below
  31.      under "Product Components."
  32.  
  33.      The term "C7 for MS-DOS and Windows" refers to the Microsoft C/C++
  34.      version 7.0 package for MS-DOS(R) and Microsoft Windows(TM), including
  35.      the Microsoft Windows Software Development Kit (SDK).
  36.  
  37.  
  38.      Introduction
  39.      ------------
  40.  
  41.      C7 for OS/2 runs with OS/2 version 1.x. It will create applications
  42.      targeted for the MS-DOS and Microsoft Windows operating systems only.
  43.      It will not create applications that run with the OS/2 operating system.
  44.  
  45.      C7 for OS/2 is an add-on package to C7 for MS-DOS and Windows. C7 for
  46.      MS-DOS and Windows must be installed before C7 for OS/2 can be used to
  47.      create applications.
  48.  
  49.  
  50.      System Requirements
  51.      -------------------
  52.  
  53.      The hardware requirements for C7 for OS/2 are the same as the hardware
  54.      requirements for C7 for MS-DOS and Windows (listed on page 18 of the
  55.      Microsoft C/C++ Getting Started book).
  56.  
  57.      The OS/2 operating system, version 1.1 or later, is required.
  58.  
  59.  
  60.      Package Contents
  61.      ----------------
  62.  
  63.      Check your C7 for OS/2 package to see if everything is there. If any
  64.      pieces are missing or if you have problems with the disks, contact
  65.      Microsoft Customer Service (1-800-426-9400). In the package, you 
  66.      should find the following items:
  67.  
  68.      -  Two disks. The files contained on these disks are listed in the
  69.         PACKING.OS2 file on disk 1.
  70.  
  71.      -  This document (also available on disk 1 in the README.OS2 file).
  72.  
  73.      -  The C7 for OS/2 License Agreement.
  74.  
  75.  
  76.      Product Components
  77.      ------------------
  78.  
  79.      C7 for OS/2 contains the following components:
  80.  
  81.      -  OS/2 hosted C/C++ compiler
  82.  
  83.         The OS/2 hosted compilers have the same names as their MS-DOS
  84.         hosted counterparts, with the following exceptions:
  85.  
  86.         MS-DOS hosted     OS/2 hosted      Compiler
  87.         -------------     -----------      --------
  88.         C13216.EXE        C11616.EXE       pass 1 compiler
  89.         C1XX3216.EXE      C1XX1616.EXE     C++ pass 1 compiler
  90.         C23216.EXE        C21616.EXE       pass 2 compiler
  91.         C33216.EXE        C31616.EXE       pass 3 compiler
  92.  
  93.      -  OS/2 hosted utilities
  94.  
  95.         The utilities provided with C7 for OS/2 have the same usage and
  96.         function as their counterparts in C7 for MS-DOS and Windows. The C7
  97.         for OS/2 utilities installed in the BINP subdirectory can be run
  98.         only with OS/2. The utilities in the BINB subdirectory are bound
  99.         executable files that can be run with MS-DOS or OS/2.
  100.  
  101.      -  OS/2 hosted Programmer's WorkBench (PWB)
  102.  
  103.         The OS/2 hosted version of PWB is the same as the MS-DOS hosted
  104.         version included with C7 for MS-DOS and Windows, with a few
  105.         exceptions that are described in Part 3 below.
  106.  
  107.      -  This C7 for OS/2 Release Notes file.
  108.  
  109.  
  110. =====================< Part 2: Setup Information >=========================
  111.  
  112.  
  113.      You must install C7 for MS-DOS and Windows before you can use C7 for
  114.      OS/2. The C7 for OS/2 setup program does not create libraries or 
  115.      header files. The C7 for MS-DOS and Windows setup programs create all 
  116.      the libraries and other required files.
  117.  
  118.  
  119.      Targeting Microsoft Windows
  120.      ---------------------------
  121.  
  122.      If you want to use C7 for OS/2 to create applications for the
  123.      Microsoft Windows operating system (or both Windows and MS-DOS):
  124.  
  125.        1. Boot under MS-DOS and start Windows version 3.0 or later.
  126.        2. From the Program Manager, run the SETUP program for C7 for
  127.           MS-DOS and Windows. Install the compiler, targeting Windows.
  128.           Create the libraries you will use.
  129.        3. Exit Windows.
  130.        4. Run the INSTALL program for the Windows 3.1 Software Development
  131.           Kit (SDK) to install the SDK.
  132.        5. Delete any C7 for MS-DOS and Windows components you do not plan 
  133.           to use. If you do not plan to compile or test any programs in 
  134.           MS-DOS or Windows, you can delete the BIN, DEBUG, and NODEBUG
  135.           subdirectories under the C700 directory. If there are any Windows
  136.           or MS-DOS hosted utilities that you do not plan to use, consult
  137.           the PACKING.TXT (not PACKING.OS2) file to determine which files 
  138.           you can delete.
  139.        6. Run the SETUP program for C7 for OS/2 to install C7 for OS/2. The
  140.           C7 for OS/2 SETUP program runs with MS-DOS or with OS/2 in an
  141.           MS-DOS or OS/2 session. If you are using OS/2 version 1.1, you
  142.           must run SETUP in an MS-DOS session.
  143.  
  144.  
  145.      Targeting MS-DOS Only
  146.      ---------------------
  147.  
  148.      If you want to use C7 for OS/2 to create applications for the MS-DOS
  149.      operating system only:
  150.  
  151.        1. Boot under OS/2 or MS-DOS. Exit Windows if it is running.
  152.        2. Run the CSETUP program for C7 for MS-DOS and Windows. Run CSETUP
  153.           using the /X option; this will prevent CSETUP from modifying your
  154.           MS-DOS configuration files.
  155.        3. Delete any C7 for MS-DOS and Windows components you do not plan 
  156.           to use. If you do not plan to compile or test any programs in 
  157.           MS-DOS, you can delete the BIN subdirectory under the C700 
  158.           directory. If there are any MS-DOS hosted utilities that you do 
  159.           not plan to use, consult the PACKING.TXT (not PACKING.OS2) file 
  160.           to determine which files you can delete.
  161.        4. Run the SETUP program for C7 for OS/2 to install C7 for OS/2. The
  162.           C7 for OS/2 SETUP program runs with MS-DOS or with OS/2 in an
  163.           MS-DOS or OS/2 session. If you are using OS/2 version 1.1, you
  164.           must run SETUP in an MS-DOS session.
  165.  
  166.  
  167.      Setting Environment Variables
  168.      -----------------------------
  169.  
  170.      You must set your OS/2 environment variables before using C7 for OS/2.
  171.      The INCLUDE, INIT, LIB, PATH, TMP, and HELPFILES variables must be
  172.      set. These variables are explained on page 18 of the Microsoft C/C++
  173.      Getting Started book. The LIBPATH variable may also need to be 
  174.      changed.
  175.  
  176.      During installation of C7 for MS-DOS and Windows, a file named
  177.      AUTOEXEC.C70 is created in the INIT subdirectory of the C7 for MS-DOS
  178.      and Windows directory (C:\C700 by default). You can use the 
  179.      environment variables set in that file as a model for the settings you 
  180.      make in your OS/2 CONFIG.SYS file or another command file.
  181.  
  182.      -  The INCLUDE, LIB, and HELPFILES variables should be the same in C7
  183.         for OS/2 and C7 for MS-DOS and Windows. For example:
  184.  
  185.              SET INCLUDE=C:\C700\INCLUDE;C:\C700\MFC\INCLUDE
  186.              SET LIB=C:\C700\LIB;C:\C700\MFC\LIB
  187.              SET HELPFILES=C:\C700\HELP\*.HLP
  188.  
  189.      -  The INIT variable should be the same in C7 for OS/2 and C7 for
  190.         MS-DOS and Windows if you want to keep the same settings for the
  191.         Programmer's WorkBench in each operating system. For example:
  192.  
  193.              SET INIT=C:\C700\INIT
  194.  
  195.      -  The PATH variable should contain the BINP and BINB subdirectories
  196.         under the base directory that you specified when you installed C7
  197.         for OS/2 (C:\C700 by default). Make sure the BIN subdirectory under
  198.         the C700 base directory is not on your path. For example:
  199.  
  200.              PATH=C:\C700\BINP;C:\C700\BINP;C:\OS2;C:\OS2\SYSTEM
  201.  
  202.      -  The MSHELP.DLL file is installed in the DLL subdirectory under the
  203.         base C700 directory. OS/2 must be able to find this file. Either
  204.         copy MSHELP.DLL to a directory specified by the LIBPATH variable,
  205.         or add the DLL subdirectory under the C700 directory to the LIBPATH
  206.         variable entry. For example:
  207.  
  208.              LIBPATH=C:\OS2\DLL;C:\C700\DLL
  209.  
  210.  
  211. =======================< Part 3: Product Notes >===========================
  212.  
  213.  
  214.      Programmer's WorkBench (PWB)
  215.      ----------------------------
  216.  
  217.      To use PWB, you must use OS/2 version 1.2 or later.
  218.  
  219.      The OS/2 version of PWB is slightly different from the MS-DOS version.
  220.      Some tasks, such as Build and Search, are run as background processes.
  221.      You can use PWB while it carries out a search or is building a
  222.      program.
  223.  
  224.      For some tasks, the OS/2 hosted version of PWB is not as fast as the
  225.      MS-DOS hosted version. For example, the functions for arranging PWB
  226.      windows take longer with OS/2 than with MS-DOS.
  227.  
  228.      The PWB extensions for MS-DOS cannot be used with OS/2. C7 for OS/2
  229.      provides OS/2 specific PWB extensions. The OS/2 files have the
  230.      extension .PXT, instead of the .MXT extension used by the MS-DOS
  231.      version of PWB.
  232.  
  233.      Extensions to PWB version 2.0 cannot be created with C7 for OS/2.
  234.  
  235.      Three functions are provided in the OS/2 version to cancel background
  236.      processes. These are described below:
  237.  
  238.      -  Cancel Build
  239.  
  240.         Usage:   arg meta compile
  241.  
  242.         The Cancel Build function (on the Run menu) stops the current
  243.         background build or compile and flushes any queued build
  244.         operations.
  245.  
  246.      -  Cancel Search
  247.  
  248.         Usage:   cancelsearch
  249.  
  250.         Returns: TRUE if there was a search in progress and it was
  251.                  canceled; otherwise, it returns FALSE.
  252.  
  253.         The Cancel Search function (on the Search menu) cancels the
  254.         background search. The search log contains the partial results of
  255.         the aborted search and is not flushed.
  256.  
  257.      -  Cancel Print
  258.  
  259.         Usage:   meta arg print
  260.  
  261.         The Cancel Print (on the File menu) cancels the current print job.
  262.  
  263.  
  264.      Using Precompiled Headers
  265.      -------------------------
  266.  
  267.      Precompiled headers that have been compiled using C7 for MS-DOS and
  268.      Windows cannot be used by C7 for OS/2. You must compile the header
  269.      again using C7 for OS/2 before it can be included as a precompiled 
  270.      header for C7 for OS/2.
  271.  
  272.  
  273.      Building Windows Help Files
  274.      ---------------------------
  275.  
  276.      The Windows Help Compilers (HC31.EXE and HC30.EXE) supplied with the
  277.      SDK cannot be run with OS/2. You may be able to use a Help Compiler in
  278.      an MS-DOS session if your OS/2 configuration provides enough memory to
  279.      the MS-DOS session. If you cannot use the Help Compiler in an MS-DOS 
  280.      session with OS/2, reboot under MS-DOS to use the Help Compiler.
  281.  
  282.      Because the Help Compiler does not run with OS/2, you cannot build the
  283.      HELPEX example using the makefile provided with the SDK.
  284.  
  285.  
  286.      How to Get Product Assistance
  287.      -----------------------------
  288.  
  289.      Consult the Product Assistance Request form at the back of the C/C++
  290.      Run-Time Library Reference.
  291.  
  292.  
  293. ===========================================================================
  294.  
  295.      Microsoft and MS-DOS are registered trademarks, and Windows is a 
  296.      trademark of Microsoft Corporation.
  297.  
  298.      OS/2 is a registered trademark licensed to Microsoft Corporation.
  299.