* COMPONENT_NAME: IBM C and C++ Compilers, Version 3.6.5 * * FUNCTIONS: README for OS/2 * * (C) COPYRIGHT International Business Machines Corp. 1994,1998 * * All Rights Reserved. * Licensed Materials - Property of IBM * * US Government Users Restricted Rights - Use, duplication or * disclosure restricted by GSA ADP Schedule Contract with IBM Corp. * ******************************************************************** This file contains important information about the IBM C and C++ Compilers product. You should read the following notes before you install and use this product. CONTENT ------- o Usage Notes o Trademark Information USAGE NOTES ----------- 1. Linker/Librarian a) The librarian (ILib) now accepts options and input files in any order (free format). If you want to use old build scripts or make files, replace "ILib" with "ILib /nofreeformat". Note: The option /nofreeformat must precede all other options and input files that are specified to ILib. b) IBM VisualAge C++ Professional 4.0 allows function and symbol names of up to 64000 characters long . The ILink and ILIB utility have been enhanced in IBM C and C++ Compilers V3.6.5 to handle objects and libraries with these long names. However, entry names for exporting modules and importing modules are limited to 255 characters. Only the internal names within modules can be longer than 255 characters. Users can use module definition (.DEF) files to resolve entry names from long internal names. 2. Debugger Closing the process list dialog with Alt-F4 will cause the debugger to crash. The process list dialog must be closed by clicking the Cancel button. 3. Compiler a) The default setting for the /qarch option, which specifies the architecture on which the executable program will be run, has been changed from /qarch=x86 (any 32-bit x86 architecture) to /qarch=486 (any architecture supporting the 486 instruction set). b) The default setting for the /Gi option (generate fast integer code) has been changed from /Gi- to /Gi+. c) If the /Op- option (disable stack pointer optimizations) was being used to force the stack to be chained, note that a new option (/Oq) has been added that specifically controls stack chaining. Using /Op+ /Oq+ when the stack must be chained will produce better code than using /Op-. 4. C++ Run-time Libraries a) The iostream library that was part of IBM C and C++ Compilers 3.6.0 was not compatible with earlier products such as VisualAge for C++ 3.0. This has now been fixed. 5. NMAKE a) NMAKE and NMAKE32 The new functionality for NMAKE described in the OS/2 Warp Developer's Toolkit Tools Reference (transformation macros, built-in commands, etc.) is provided in the NMAKE32 command. The NMAKE command does not have this new funcionality. b) NMAKE32 There is a problem in NMAKE32 that prevents environment variables from being set by macro definitions from the command line or macro assignments within the make file. For example: Command line: nmake "INCLUDE=e:\mypath" Make file: INCLUDE=e:\mypath Each of these will only set the macro INCLUDE to e:\mypath, but will not set the INCLUDE environment variable picked up by the compiler. 6. Integrated Resource Editor (IRE) When using an S3 display driver with more than 256 colors set, the bitmaps in the IRE "New Dialog/Window" dialog show up in black and white. 7. IBM Open Class Libraries a) Motif: This release of the Open Class Library now contains Motif support for IToolBar, IToolBarButton, ICustomButton, and the other related toolbar and custom button classes. b) Source Files: Please note that the Open Class source files are provide for reference and debugging use only. It is not currently possible to regenerate the Open Class libraries from these sources and the compiler provided with this release. c) DLLs You can improve first-time application start-up time by preloading the Open Class DLLs as follows: i) Create a program object for the Hello1 IOC sample (...\samples\iclui\hello1\hello1.exe) ii) Put the program object into the system's startup folder If the program object is configured to "start minimized", the sample window will not display when the system is started. d) Notification IDs in ilistcvw.hpp and icombovw.hpp moved: The following notification IDs have been moved: - From ilistcvw.hpp to ilistbas.hpp: ICollectionViewListBox<Element,Collection> itemChangedId, itemsId, extendedSelectChangedId; to IBaseListBox - From icombovw.hpp to icombobs.hpp: ICollectionViewComboBox<Element,Collection> itemChangedId itemsId to IBaseComboBox They have been moved because there are problems with notification IDs residing within template classes (static data members have problems with templates because with templates there could be multiple instances of the data member throughout the application). They have been moved to the base classes so that there will only be one instance of the notification ids in the application. However these notifications are not sent by the base class, only by the collection listbox and combobox classes. Do not use these notifications except when using the collection listbox or combobox. e) Information regarding support of bidirectional languages in Open Class can be found on the support page of the VAC++ web site at http://www.software.ibm.com/ad/visualage_c++ f) To optimize the IString+= operation, the IBuffer/IDBCSBuffer class now allocates memory in 32-byte chunks. To turn this optimization off, you can set the static boolean IBuffer::is32BytesAligned to false. By default, if IBuffer::setDefaultBuffer() is called, the boolean is set to false unconditionally. DBCS (Double Byte Character Set) NOTES ----------------------------------------- o When using the English version of this product on a DBCS language environment (such as OS/2 V4.0J), you need to change the LANG environment variable in SETENV.CMD (for OS/2) manually. (If you don't make this change, you may not build DBCS application correctly, because the compiler assumes an English environment.) ============================================================================ Part 2. Help System Search Server ============================================================================ 1.0 Searching HTML Help ----------------------- The search system consists of a search engine and a search server. The search system is stored in its own directory because it may be used by other products. 2.0 Using the HTML Search System -------------------------------- 2.1 Browser requirements IBM C and C++ HTML help requires a frames-supporting browser such as Netscape Navigator Version for OS/2 Version 4.04. The browser that you use must not have proxy handling enabled for the localhost port. Be sure to turn off proxy handling for localhost in the browser you use. 2.2 Starting and Stopping the Server If the search server is not running, you can restart it by double clicking on the Help Home Page icon in the product folder. 2.1 Search Limitations for Single Byte Search (English only) ------------------------------------------------------------ Sometimes simple search queries can return incorrectly ranked results. For example, if you simply type 'IFrameWindow' into the search form you will see results from the class description, but these results may be ranked lower than less relevant documents. That's because by default, the search engine is set up for "fuzzy" searches: more complex queries that include word stemming for different variants of a word or a phrase. For best results in these cases, scope your searches by picking the appropriate category of information (like "IBM Open Class Library"). For even more control over results ranking, precede your search term with a plus sign and surround the term with quotation marks (for example, +"IFrameWindow"). Select "Exact" instead of fuzzy search from the drop-down box on the search form. For more details, see Search Help available from the search page. TRADEMARKS ---------- The following terms are trademarks of International Business Machines Corporation in the United States or other countries or both: IBM Open Class OS/2 VisualAge Other terms used in this README, which may be denoted by a double asterisk (**), are trademarks or service marks o...
Amiga7878