home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / odrtime.zip / OPENPACK / README.OPD < prev   
Text File  |  1995-12-14  |  14KB  |  392 lines
  1.  
  2.          OpenDoc for OS/2 README
  3.          -----------------------
  4.  
  5.    OpenDoc for OS/2 provides the ability to create and save a
  6.    single document by embedding several different "components"
  7.    (such as graphics, text, and multimedia) into it.
  8.  
  9.    Included in this release is the ability to create compound
  10.    OpenDoc documents using embedding, linking, drag/drop, and
  11.    scripting functions.
  12.  
  13.    This file contains information you need to run OpenDoc
  14.    and includes additional information not found in the
  15.    product documentation.  Multimedia OpenDoc for OS/2 is
  16.    available in a separate package; it is NOT included in this
  17.    one.
  18.  
  19.    This README file is divided into the following categories:
  20.  
  21.    - Before You Install OpenDoc for OS/2
  22.       Hardware and Software Requirements
  23.       Installation Restrictions
  24.    - Installing OpenDoc for OS/2
  25.       Unpacking the opendoc.bbs File
  26.       Starting the Installation
  27.    - CID-Enabled Installation
  28.    - Uninstalling OpenDoc for OS/2
  29.    - OpenDoc for OS/2 Considerations
  30.    - Trademarks
  31.  
  32.  Before You Install OpenDoc for OS/2
  33.  -----------------------------------
  34.  
  35.   Hardware and Software Requirements
  36.   ----------------------------------
  37.   - The OS/2 Warp FixPak XR_W016 must be installed before you
  38.     can install OpenDoc for OS/2.
  39.  
  40.   - The OpenDoc for OS/2 base package is 9 MB in size.
  41.     You need 13 MB of free space available before you
  42.     can unpack the opendoc.bbs file.  To install the files,
  43.     you need an additional 21 MB of free space.
  44.  
  45.   - OpenDoc can be installed on an Intel 486 with 8 MB of memory
  46.     and 33 MHz.  However, a Pentium with 16 MB of memory and
  47.     75 MHz is highly recommended.
  48.  
  49.   - The SWAPPER.DAT file might grow during this installation.
  50.     To do a full installation on a system with 8 MB of RAM, at
  51.     least 16 MB of disk space should be available to SWAPPER.DAT.
  52.     Systems with more RAM require less disk space. (For
  53.     example, a system with 16 MB RAM requires 10 MB of
  54.     disk space for a full installation).
  55.  
  56.   Installation Restrictions
  57.   -------------------------
  58.   - If a previous version of OpenDoc has been installed, it is
  59.     recommended that you format your OS/2 boot partition and
  60.     reinstall OS/2 before installing this version of OpenDoc.
  61.  
  62.     *****************************************************
  63.                     WARNING
  64.     *****************************************************
  65.     If you have a pre-release version of OpenDoc installed on
  66.     your machine you MUST REMOVE IT before installing this
  67.     feature.
  68.     *******************************************************
  69.  
  70.   - The Software Installer will not display if the environment
  71.     variable "remote_install_state" is in the CONFIG.SYS file
  72.     (outside of a CID install).  If the Software Installer fails
  73.     to display, edit your CONFIG.SYS file.  If the variable
  74.     exists, delete it.  You will have to reboot your system before
  75.     continuing the installation.
  76.  
  77.  Opendoc for OS/2 Installation Instructions
  78.  ------------------------------------------
  79.  
  80.   Unpacking the opendoc.bbs File
  81.   ------------------------------
  82.   Before you install Opendoc you must first unpack the
  83.   the opendoc.bbs file if you downloaded the file from a
  84.   bulletin board.  You need at least 13 MB of free space
  85.   available to unpack the opendoc.bbs file.
  86.  
  87.   For example, if the opendoc.bbs file is on drive D
  88.   and you want to unpack the files to drive E, type
  89.   the following command at an OS/2 command prompt and
  90.   then press Enter:
  91.  
  92.      unpack2  d:\opendoc.bbs  e:  /c
  93.  
  94.   This creates an e:\openpack directory.  You install
  95.   OpenDoc for OS/2 from this directory.
  96.  
  97.   Starting the Installation
  98.   -------------------------
  99.   To begin the installation, type the following commands
  100.   at an OS/2 command prompt and press Enter after each:
  101.  
  102.        e:
  103.        cd \openpack
  104.  
  105.   Then type the following command and press Enter:
  106.  
  107.        instod
  108.  
  109.   NOTE:  The files unpacked from the opendoc.bbs file will be
  110.   transferred to the directory you specify during installation.
  111.   You need an additional 21 MB of free space on the drive
  112.   you specify in order to successfully install Opendoc for OS/2.
  113.  
  114.  CID-Enabled Installation
  115.  ------------------------
  116.  To CID-enable the OpenDoc for OS/2 installation, you
  117.  must do the following:
  118.  
  119.   1. Create a response file that contains the following keywords:
  120.      --------------------------
  121.      FILE      = X:\OPENDOC
  122.      COMP      = Product Folder
  123.      COMP      = OpenDoc Base
  124.      CFGUPDATE = AUTO
  125.      OVERWRITE = YES
  126.      __________________________
  127.  
  128.      where X is the boot drive.
  129.  
  130.      NOTE: A sample response file, OPENDOC.RSP, is provided
  131.      in the OPENPACK directory (where you unpacked the
  132.      opendoc.bbs file).  This file is also located in the
  133.      \IBMOS2\OPENPAK directory if you have the Developer
  134.      Connection for OS/2.  You should copy this file from
  135.      the CD to the OPENPACK directory on your hard file before
  136.      proceeding with step 2.
  137.  
  138.   2. At an OS/2 command prompt, change to the OPENPACK directory,
  139.      and then type the following command-line parameters to invoke
  140.      CID:
  141.  
  142.      NOTE: You must supply values for the items enclosed in
  143.      angle brackets.  Other items must be typed exactly as
  144.      shown.
  145.  
  146.      EPFINSTS /A:I
  147.               /C:<DRIVE:\PATH>\OPENDOC.ICF
  148.               /L1:<DRIVE:\PATH\ERROR LOG FILE NAME>
  149.               /L2:<DRIVE:\PATH\HISTORY LOG FILE NAME>
  150.               /O:DRIVE
  151.               /P:"OpenDoc for OS/2"
  152.               /R:<DRIVE:\PATH\RESPONSE FILE NAME>
  153.               /S:<DRIVE:\SOURCE PATH>
  154.               /X
  155.  
  156.   For more information on CID-enabled installation, please refer
  157.   to the "Software Installer Document Version 1.3 for OS/2."
  158.  
  159.  Uninstalling OpenDoc for OS/2
  160.  -----------------------------
  161.  If you want to uninstall OpenDoc for OS/2 version 1.0, you must
  162.  perform the following steps in order:
  163.  
  164.   1. Uninstall Multimedia OpenDoc for OS/2 if it is installed.
  165.      (See the Multimedia OpenDoc for OS/2 "readme.mm" file for
  166.      more information).
  167.  
  168.   2. Close all open OpenDoc documents.
  169.  
  170.   3. Delete the "OpenDoc Templates" and the "OpenDoc Shell
  171.      Plugins" folders from the Desktop.
  172.  
  173.   4. Delete the PARTREG.BTO, AVLSRVR.BTO, OPENDOC.INI, and
  174.      OSA.INI files (if they exist) from the OS2 directory on
  175.      your boot drive.
  176.  
  177.   5. Remove all references to OPENDOC from the CONFIG.SYS
  178.      file (these references are all clause removals).
  179.  
  180.   6. Reboot your computer.
  181.  
  182.   7. If you installed via the Developer Connection CDs, select
  183.      the Developer Connection Object on your Desktop and find the
  184.      object for OpenDoc for OS/2.  When you double-click on it,
  185.      the Software Installer version for OpenDoc is displayed.
  186.  
  187.   8. If you installed from a package on a bulletin board service,
  188.      go to the OPENPACK directory and type:
  189.  
  190.        instod
  191.  
  192.      The Software Installer version for OpenDoc is displayed.
  193.  
  194.   9. Select "Continue" on the first screen.  On the second screen,
  195.      select "Delete and Re-install" and then click on the
  196.      "Continue" push button.  Finally, on the last screen select
  197.      "OpenDoc Base" and then click on the "Delete" push button.
  198.  
  199.  OpenDoc for OS/2 Considerations
  200.  -------------------------------
  201.  After you install OpenDoc for OS/2, you should be aware of the
  202.  following considerations:
  203.  
  204.   GRAPHICS PART
  205.  
  206.   - Some actions in the graphics part cannot be undone.
  207.  
  208.   - When you open the graphics part in another window you
  209.     should only edit its content; editing embedded parts
  210.     is not fully supported.
  211.  
  212.   - If you have a problem updating a graphics part drawing,
  213.     you can refresh it by using the menu item "Refresh" or by
  214.     typing Alt+R.
  215.  
  216.   - If your drag button is set as mouse button 1, a graphics
  217.     part moves embedded parts if you try to resize them.
  218.  
  219.   TEXT PART
  220.  
  221.   - If your drag button is set as mouse button 1, a text part
  222.     moves embedded parts if you try to resize them.
  223.  
  224.   - The amount of text the text part can handle depends on the
  225.     amount of memory you have.  This is a temporary restriction
  226.     for this release.
  227.  
  228.   PAGE LAYOUT PART
  229.  
  230.   - The menu bar choices are not always correct when you
  231.     reactivate the page layout part.  Click on the menu bar again
  232.     to display the correct page layout part menu.
  233.  
  234.   - The page layout part "Snap to grid" option "snaps" (places it
  235.     along the closest page layout grid lines) existing embedded
  236.     objects as well as any new ones.
  237.  
  238.   - The page layout part does not always clip or repaint the
  239.     toolbar or scroll bars correctly.  Refresh the page
  240.     layout part by changing the size of the Document Shell
  241.     window.
  242.  
  243.   - If nothing happens when you click on icons on the toolbar,
  244.     the selected operations are not available at the time.
  245.  
  246.   - When you attempt to rotate a page layout part, press and hold
  247.     mouse button 1 rather than clicking it.
  248.  
  249.   - The page layout part does not support clipboard and drag/drop
  250.     operations for multiple selection of embedded objects.
  251.  
  252.   - If you change the page size for a page layout part, embedded
  253.     parts are also sized.
  254.  
  255.   - In order to scroll the page layout part you must first click
  256.     in the document area.
  257.  
  258.   - The page layout part supports up to 29 pages of letter size.
  259.     This number can change depending on the size of the form
  260.     you use.
  261.  
  262.   - The page layout part does not always refresh its drawing
  263.     area.
  264.  
  265.   - Print the page layout part by using the "Print" menu bar
  266.     option instead of dragging the page layout part to a
  267.     Workplace Shell printer object.  This ensures that the document
  268.     prints on the correct printer.
  269.  
  270.  -  When the page layout part is the root part and has an
  271.     embedded graphics part, any embedded parts in the graphics
  272.     part cannot be printed.
  273.  
  274.   SCRIPT EDITOR
  275.  
  276.   - When you drag and drop a new file over an existing one, the
  277.     new file replaces the existing one without prompting you to
  278.     save it.
  279.  
  280.   OBJECT REXX
  281.  
  282.   - Object REXX does not currently support recording of scripts.
  283.  
  284.   - Object REXX does not support object specifiers of test key
  285.     format (=, <>, <, <=, >. >=).
  286.  
  287.   - Object REXX does not support object specifiers of range key
  288.     format.  For example, an event such as:
  289.  
  290.       SA[window[1],window[4]]~Close
  291.  
  292.     is interpreted as:
  293.  
  294.       SA[window[1]]~Close
  295.  
  296.   - Object REXX does not support multiple data types for a
  297.     parameter to an event.
  298.  
  299.   - Object REXX does not support parameters of type Insert|onLoc.
  300.  
  301.   - Object REXX creates an empty file when executing the Lines()
  302.     function for a non-existent file.
  303.  
  304.  -  Object REXX does not support multiple events with the same
  305.     name and in different suites (for example, Open is in both
  306.     the Required and Core suites).  It always defaults to the
  307.     first one.
  308.  
  309.   PERFORMANCE
  310.  
  311.   - This version of OpenDoc has not been completely
  312.     performance-tuned.  This is planned for a future release.
  313.  
  314.   MISCELLANEOUS
  315.  
  316.   - Documents created using previous versions of OpenDoc cannot
  317.     be used with this version.
  318.  
  319.   - Always save a document before you attempt to rotate an
  320.     embedded part, especially if a text part is involved.
  321.     Rotating parts is not fully supported.
  322.  
  323.   - Always wait until one document has completely started
  324.     before starting another one.
  325.  
  326.   - Before you shutdown OS/2, ensure that you close all OpenDoc
  327.     documents.  If you don't do this, it is likely that the
  328.     documents might display as templates the next time you start
  329.     the operating system.  If this happens, display the
  330.     Settings notebooks for the documents and then deselect the
  331.     "Template" check box.
  332.  
  333.   - The part DLL cannot be replaced or deleted until all the
  334.     OpenDoc documents using it have been closed.
  335.  
  336.   - The part registration database is contained in a file
  337.     named PARTREG.BTO, which is located in the OS2 directory of
  338.     the boot drive.  Occasionally, this file might become
  339.     corrupted and cause strange behavior in OpenDoc.  To
  340.     fix this problem, delete the PARTREG.BTO file and
  341.     re-register any parts.  The standard parts shipped with
  342.     OpenDoc can be registered by typing and entering the
  343.     following commands at an OS/2 command prompt:
  344.  
  345.       ODINST STANDARD
  346.  
  347.       ODINST MULTIMEDIA   (if you have multimedia installed)
  348.  
  349.   - If you create links in your documents, they are saved
  350.     in a file named AVLSRVR.BTO, which is located in the OS2
  351.     directory of the boot drive.  Occasionally, links may
  352.     fail for no apparent reason.  If so, the AVLSRVR.BTO file
  353.     might be corrupted.  To fix this problem, delete the
  354.     AVLSRVR.BTO file.  Unfortunately, this also deletes
  355.     all your links.  It is highly recommended that you
  356.     frequently back up the AVSSHELL.BTO file.
  357.  
  358.     NOTE: The AVLSRVR.BTO file also becomes corrupted if you
  359.     power-off while OpenDoc is running.
  360.  
  361.   - If you hide the OpenDoc "Properties" window, it cannot be
  362.     retrieved.  Close the document from the Window List
  363.     and start it again.
  364.  
  365.   - Whenever you close a document, it is automatically
  366.     saved without prompting.  If you do not want to save
  367.     any changes, click on "Revert to Saved" before attempting
  368.     to close the document.
  369.  
  370.   - When you click on the following menu items: Open As, Icon,
  371.     Tree, Details, or Window, the window displayed is a blank
  372.     entry in the Window List.
  373.  
  374.  Trademarks
  375.  ----------
  376.  
  377.    IBM and OS/2 are trademarks of the IBM Corporation.
  378.  
  379.    OpenDoc is a trademark of Apple Computer, Inc.
  380.  
  381.    THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF
  382.    ANY KIND.  IBM DISCLAIMS ALL WARRANTIES, WHETHER
  383.    EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION,
  384.    THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR
  385.    PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE
  386.    INFORMATION IN THIS DOCUMENT.  BY FURNISHING THIS
  387.    DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR
  388.    COPYRIGHTS.
  389.  
  390.    (C) Copyright IBM Corporation 1995.  All rights
  391.    reserved.
  392.