OpenDoc for OS/2 README ----------------------- OpenDoc for OS/2 provides the ability to create and save a single document by embedding several different "components" (such as graphics, text, and multimedia) into it. Included in this release is the ability to create compound OpenDoc documents using embedding, linking, drag/drop, and scripting functions. This file contains information you need to run OpenDoc standard parts and includes additional information not found in the product documentation. Information specifically addressing the Multimedia OpenDoc parts is not included in this file. OpenDoc for OS/2 Considerations ------------------------------- After you install OpenDoc for OS/2, you should be aware of the following considerations: GRAPHICS PART - Some actions in the graphics part cannot be undone. - If you have a problem updating a graphics part drawing, you can refresh it by using the menu item "Refresh" or by typing Alt+R. - When the page layout part is the root part and has an embedded graphics part, any embedded parts in the graphics part cannot be printed. - The Graphics Part does not copy links via the Save a Copy and Create Draft menu items. Only the link content is copied. TEXT PART - Some actions in the text part cannot be undone. - The text part does not support Open As Window or Transparency in this release. - The amount of text the text part can handle depends on the amount of memory you have. PAGE LAYOUT PART - The page layout part "Snap to grid" option "snaps" (places it along the closest page layout grid lines) existing embedded objects as well as any new ones. - The page layout part does not provide undo/redo capability. - The page layout part does not always clip or repaint correctly. Refresh the page layout part by changing the size of the Document Shell window. - The page layout part does not support clipboard and drag/drop operations for multiple selection of embedded objects. - If you change the page size for a page layout part, embedded parts are also sized. - The page layout part supports up to 29 pages of letter size. This number can change depending on the size of the form you use. SCRIPT EDITOR - When you drag and drop a new file over an existing one, the new file replaces the existing one without prompting you to save it. - The Script Editor requires Object REXX in order to run. The Read Me file in the Information folder describes how to use the SWITCHRX command to switch from classic REXX to Object REXX. RESOURCE EDITOR - Deleting an AETE Resource may cause the Resource Editor to trap. OBJECT REXX - Object REXX does not currently support recording of scripts. - Object REXX does not support object specifiers of test key format (=, <>, <, <=, >. >=). - Object REXX does not support object specifiers of range key format. For example, an event such as: SA[window[1],window[4]]~Close is interpreted as: SA[window[1]]~Close - Object REXX does not support multiple data types for a parameter to an event. - Object REXX does not support parameters of type Insert|onLoc. - Object REXX creates an empty file when executing the Lines() function for a non-existent file. - Object REXX does not support multiple events with the same name and in different suites (for example, Open is in both the Required and Core suites). It always defaults to the first one. PERFORMANCE - This version of OpenDoc has not been completely performance-tuned. This is planned for a future release. LINKING - The text part and page layout parts do not support linking. - On systems where TCP/IP and OpenDoc are both selected during Merlin installation, you may have problems when first creating a link. If this happens, run "ODINST.EXE" from an OS/2 window. ODINST makes sure that the hostname used for linking is in sync with the hostname set during TCP/IP configuration. - If you create links in your documents, they are saved in a file named AVLSRVR.BTO, which is located in the OS2 directory of the boot drive. Occasionally, links may fail for no apparent reason. If so, the AVLSRVR.BTO file might be corrupted. To fix this problem, delete the AVLSRVR.BTO file. Unfortunately, this also deletes all your links. It is highly recommended that you frequently back up the AVSSHELL.BTO file. NOTE: The AVLSRVR.BTO file also becomes corrupted if you power-off while OpenDoc is running. SPEECH - When using Speech Navigation with OpenDoc for OS/2, when you first change activation from one OpenDoc part to another, the speech engine will not listen for the new part's menu items until you click on the new part's menu bar or click outside the OpenDoc Document Shell and then reactivate the part. Once you perform one of these actions, the "What Can I Say" window will be updated and the speech engine will listen for the new part's menu items. - None of the supplied part handlers directly support Speech Dictation. However, you can indirectly dictate into an OpenDoc document following these steps: 1) Open the OpenDoc document, and embed or make active a part that allows data of type "Plain Text." 2) Dictate your text into the VoiceType Dictation Window. 3) Choose "Transfer" from within the Dictation applet, which will give you a special mouse pointer. 4) Click back on the part in the OpenDoc document that accepts "Plain Text." The dictated text will be pasted into the part. MISCELLANEOUS - Always save a document before you attempt to rotate an embedded part, especially if a text part is involved. Rotating parts is not fully supported. - Documents occasionally display as templates after a reboot. If this happens, display the Settings notebooks for the documents and then deselect the "Template" check box. - The part DLL cannot be replaced or deleted until all the OpenDoc documents using it have been closed. - The part registration database is contained in a file named PARTREG.BTO, which is located in the OS2 directory of the boot drive. Occasionally, this file might become corrupted and cause strange behavior in OpenDoc. To fix this problem, delete the PARTREG.BTO file and re-register any parts. The standard parts shipped with OpenDoc can be registered by typing and entering the following commands at an OS/2 command prompt: ODINST STANDARD ODINST MULTIMEDIA (if you have multimedia installed) - The OpenDoc "Properties" window may appear offscreen. Pressing ALT-F7 will allow you to move the window back onscreen. - The Help panels for a "Properties" notebook page are activated after clicking on the page itself. - Whenever you close a document, it is automatically saved without prompting. If you do not want to save any changes, click on "Revert to Saved" before attempting to close the document. - The Document->Open As event is sent to the active part. - Using ALT + mouse button 2 to drag data from an OpenDoc document to the desktop will always copy the data. - Dragging a Shell Plug-in DLL with a type of "Executable" to outside the OpenDoc Shell Plug-Ins folder will prevent it from loading, unless you drag it as a COPY or as a SHADOW. Trademarks ---------- IBM and OS/2 are registered trademarks of the IBM Corporation. OpenDoc is a registered trademark of Apple Computer, Inc. THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. (C) Copyright IBM Corporation 1996. All rights reserved.