============================================================================= edit-on(R) Pro by RealObjects Version 5.1.204.0, 2007-09-05 ============================================================================= Important --------- This software and support material is copyrighted, it may only be used with a legally acquired and fully paid license and in accordance with the edit-on Pro Software License Agreement. By installing and using this software, you accept the terms and conditions of the RealObjects edit-on Pro Software License Agreement. For details, see the license.txt file. If you have not purchased a license, you are only allowed to test and evaluate this software to find out how it fits your requirements during the evaluation period which is determined by the "Evaluation Key". To request an "Evaluation Key", visit http://www.realobjects.com. You are not allowed to use this software with an "Evaluation Key" in a production environment. After expiration of the "Evaluation Period", you must permanently remove this software and its support material from your computers, including the Sentry Spelling-Checker Engine and dictionaries. You are not allowed to use the software at all without a license key. To purchase an edit-on Pro license, please visit our website at http://www.realobjects.com Folder Contents --------------- Folder doc/ : edit-on Pro Integration Manual (PDF and HTML-Format) Please make sure that you read the manual! edit-on Pro User Manual (PDF and HTML-Format) Folder eopro/ : Codebase directory, containing the edit-on-pro-5.jar binary archive and the JavaScript API file editonpro.js. Important: The license key file (licensekey.xml) you received, must be placed in this folder. Folder eopro/lex : SSCE spelling checker dictionaries (American English, Brazilian Portuguese, Portuguese, British English, British Medical, Can. English, Legal, Medical, Danish, Dutch, Finnish, French, German, Italian, Norwegian, Spanish, Swedish) Folder samples/ : Developer Samples Folder doc/resources : DTDs and Locale files for advanced integration and customization Folder tools/ : Password encryption tool that can be used to encrypt the password specified in the config.xml for WebDAV connections. Remark: Please be sure that you unzip the complete directory structure. If you use WinZip activate the "Use Folder Names" option when unzipping. VersioTrack Add-on ------------------ VersioTrack is a new add-on for edit-on Pro 5 which enables content contributors and reviewers to reliably identify and visualize differences between document versions and track content changes in real-time in a content creation workflow. It provides a very user friendly way to accept and reject changes on a finely grained basis. You can see VersioTrack live in action in the "VersioTrack Sample" and the "CMS VersioTrack Demo" contained within the edit-on Pro 5 sample package, as well as on our website at http://www.realobjects.com/Online-Demos.456.0.html. To purchase edit-on Pro 5 with VersioTrack or the VersioTrack add-on if you already are an edit-on Pro 5 customer, please visit http://www.realobjects.com/Licensing-Pricing-Buy.891.0.html or contact sales@realobjects.com. Updating to edit-on Pro 5 from edit-on Pro 4 -------------------------------------------- Updating an to edit-on Pro 5 is easy. This new release is binary compatible with edit-on Pro 4 releases. In general, it is not necessary to change anything in your integration code. If you are updating an existing copy, be careful if you have customized any files. Be sure to make a backup copy of your previous installation folder. In general you should overwrite all old files with the newer version and then manually reintroduce any changes afterwards. It is especially important that all contents of the /eopro/ directory are copied (including subfolders) and the editonpro.js is overwritten with the new version. To fully benefit from some of the new features and improvements in edit-on Pro 5, it might be necessary that you modify your existing config.xml, uiconfig.xml or JavaScript integration code. For more information, review the Release Notes below and the Integration Manual. Some configuration settings and APIs are now deprecated. Although they still exist in this build, their use is not recommended anymore because they will most probably no longer be available in future releases. For more information, please review the Integration Manual. Upgrading from previous edit-on Pro versions 2.x/3.x ---------------------------------------------------- * The license keys of previous versions do not work with edit-on Pro 5 and vice versa. * The API of edit-on Pro 5 is not directly compatible with existing integrations of previous versions. Please visit http://www.realobjects.com for information about migrating to edit-on Pro 5. Installation ------------ * Copy the edit-on Pro folder (complete with all subfolders) to your web server. * Copy the license key file you received (licensekey.xml) into the eopro\ folder which contains the edit-on-pro-5.jar file (The "codebase" folder) Please never modify or rename the licensekey file. Without this license file, edit-on Pro will not run. If you copy this file by FTP, please use the binary transfer mode. The license key file is protected by a digital signature, so modifying it will break it. Release Notes and Known Issues ------------------------------ * Make sure to read the Integration Manual, which can be found in the "doc/" directory. * The API of edit-on Pro 5 is not directly compatible with existing integrations of previous edit-on Pro versions 2.x and 3.x. Please visit http://www.realobjects.com for information about migrating to edit-on Pro 5 * Using the .insertCustomTag API is only supported when the selection is within a paragraph. Applying .insertCustomTag on a selection which includes paragraph boundaries may yield wrong results. * The editor is designed to work with documents conforming to the XHTML1 transitional DTD. * The editor is not designed to edit of generic XML documents with arbitrary DTDs. The structure of existing XML documents is not guaranteed to be preserved during import/editing or export. Documents must at least comply with the basic requirements of the XHTML1 transitional DTD. Release History --------------- 5.1.204: First maintenance release of edit-on Pro 5.1 The bug fixes include: * Pressing INCINDENT in a list inserts a blockquote element * Exception when loading a custom DTD containing elements that are not defined as block level or inline element * Character entities above 32767 are erroneously encoded when using setHTMLData() * No scrolling occurs when dragging an image inside the editor The new features include: * insertHTMLData now also functions in SourceView * Added new action: SPLITPARAGRAPH. This action splits the paragraph at the caret position. * Added new action: BR. This action insert a line break (
) at the caret position. * Added new configuration option for actions which allows the integrator to specify certain actions should always be enabled, even when the caret is within read-only elements. To enable this feature, specify the "alwaysenabledinwysiwyg" attribute for the selected actions in the user interface configuration file. See the "Integration Manual" for more details. 5.1.198: First release of edit-on Pro 5.1 The bug fixes include: * Exception when trying to use a server side clean-up process. * The request made when retrieving an image before it is uploaded is not complete. * Values entered in table properties dialog are lost when switching to "Table Accessibility" tab and back to "Standard". * Shortcuts for menubar insert characters into the editor. * Text is bunched up after causing a linebreak in a a large table. * Toolbar and toolbar menus do not look good on Vista with JRE 1.6.0_01. * Toolbar UI colors are messed up using Windows XP & JVM 1.5.0_12. * Nested tables are causing the editor to crash. * Fallback mechanism for character within font names which can not be rendered in the FONTTYPE drop-down. * Shortcuts for menubar insert characters into the editor. * Three digit colour values are expanded to six digits by adding zeroes. * Exception when loading documents which contain images with redirects. * Not possible to resize tables using drag & drop when customtagseditingonly is enabled. The new features include: * New sample: Dynamic DOM Modification Sample - This sample demonstrates how edit-on Pro can be used to edit an entire (X)HTML page using dynamic DOM modification. * Added new actions: INCINDENTBLOCKQUOTE and DECINDENTBLOCKQUOTE. * API function to retrieve a parent element depending on the element name. * Generally improved the loading time of the editor across all Java versions. This is especially noticeable when using Java 1.6. * Added a JavaScript API method to preload the applet into the Java cache. This methods functions entirely in the background. We recommend calling this method on a separate page from the page where the editor is loaded (e.g. the login screen of your application) to minimize the start-up time of the editor. 5.0.175.1: First hotfix release of edit-on Pro 5 * Formatted copy & paste from MS Word was not possible due to missing library 5.0.175: First release of edit-on Pro 5 The new features include: * Optional VersioTrack add-on to compare document versions and track document changes * Compatibility with Prototype JavaScript Library for seamless integration with AJAX technology * Dynamic hiding and resizing of editor using JavaScript API, e.g. hide editor during loading, special effects using AJAX technology * Table auto formatting with customizable templates * Improved table editing and performance * Optional caching and loading of editor's content when back and forth button within browser is used * Automatic hyperlink conversion as you type * Insert inline quote, block quotes and acronyms * Action to insert current date and time in various formats * Support for "lang" attribute for improved content accessibility * Style of current block element will be retained when wrapped into a new block element * Enable/disable anti-aliasing for graphics and text within WYSIWYG view * Extended event handling using standardized methods * Event handlers or actions can be triggered by "invokeAction" * Improved WebDAV support Server Operating Systems Supported ---------------------------------- All Server Operating Sytems (Windows 2000/2003, Linux, Solaris, BSD etc.) which support a HTTP capable server (e.g. Apache, IIS, Tomcat, Domino etc.) can be used. Files with the extension *.xml must be passed to the client "as-is" and must not be processed on the server. Client Operating Systems Supported ---------------------------------- Microsoft Windows XP (It is recommended to install Microsoft XP Service Pack 2) Microsoft Windows Vista Linux 2.x Sun Solaris 8/9/10 Apple Mac OS X 10.4 (All Service Packs and Updates must be installed, Safari and Firefox only, Java Embedding Plugin for Mac OS X from http://javaplugin.sourceforge.net/ must be installed to enable Firefox Java support) Browsers Supported ------------------ Microsoft Internet Explorer 6/7 Firefox 1.5/2.0 Mozilla 1.7 SeaMonkey Netscape 8 Apple Safari 2.0 Opera 8.5/9 Officially Recommended and Supported Java VMs: --------------------------------------------- Sun JRE 1.4.2 with the latest updates (make sure to install the latest Sun JRE Update). Sun JRE 1.5.0 with the latest updates (make sure to install the latest Sun JRE Update). Sun JRE 1.6.0 with the latest updates (make sure to install the latest Sun JRE Update). Apple JRE 1.4.2 (All Service Packs and Updates must be installed). Apple JRE 1.5.0 (All Service Packs and Updates must be installed). To download the latest Java VMs for Windows, Linux and Solaris please visit: Sun JRE: http://java.sun.com/j2se/ To download the latest Java VM for Apple Mac OS X, please use the "Software Update" feature of the operating system. General Requirements & Notes ---------------------------- * Java VM with Java SDK 1.4.2 support or better * Java and JavaScript must be enabled by the user * The security prompt showing that the software was digitally signed by RealObjects must be accepted for proper operation of edit-on Pro. * edit-on Pro 5 has been successfully run on machines with Windows 98, Windows NT and IE 5.x, however we can't officially support for this platform as Microsoft has already stopped "Mainstream Support" for those products. Minimum Hardware Requirements ----------------------------- -------------------------- Windows PC Platform: 1 GHz Intel Pentium or AMD Athlon CPU 128MB RAM Mac OS X PPC Platform: 800 MHz G4 Processor 256 MB RAM Mac OS X Intel Platform: All current Mac OS X Intel platform products with the Intel Core Duo processor fulfill the minimum hardware requirements. In general, hardware requirements depend very much on the platform and on the speed of the JVM implementation and the size/complexity of the documents which are edited. Software Requirements for the Samples ------------------------------------- Webserver (Apache, IIS or other) PHP4 (to run the PHP based samples) Active Server Pages (to run the ASP based samples) .net Framework (to run the ASP.NET based samples) Tomcat/other JSP enabled web servers (to run the JSP based samples) Macromedia Coldfusion Application server (to run the CFML based samples) Notes : * The samples will only run if the directory structure is unmodified. * Your webserver should be configured to use index.htm as the default page. * Navigate to http://yourserver/youreditonprodirectory/samples/index.htm to run the samples. Support ------- For information about technical support please visit http://www.realobjects.com/support Registered Trademark -------------------- edit-on is a registered trademark of RealObjects GmbH, Saarbrücken. Additional Copyrights and other Important Notes ----------------------------------------------- DeltaXML Core Engine Copyright © 2005, 2006 DeltaXML Ltd. Sentry Spelling-Checker Engine Copyright © 2000 Wintertree Software Inc. German Dictionary Copyright © 1999 Wintertree Software Inc. Spanish Dictionary Copyright © 1999 Wintertree Software Inc. French Dictionary Copyright © 1999 Wintertree Software Inc. Swedish Dictionary Copyright © 1999 Wintertree Software Inc. Italian Dictionary Copyright © 1999 Wintertree Software Inc. Dutch Dictionary Copyright © 1999 Wintertree Software Inc. Finish Dictionary Copyright © 1999 Wintertree Software Inc. Medical Dictionary Copyright © 2000 Wintertree Software Inc. Danish Dictionary Copyright © 2000 Wintertree Software Inc. Brazilian Portuguese Copyright © 2000 Wintertree Software Inc. Norwegian Bokmal Dictionary Copyright © 2000 Wintertree Software Inc. Legal Dictionary Copyright © 1999 Wintertree Software Inc. Medical Dictionary Copyright © 1999 Wintertree Software Inc. Portuguese Dictionary Copyright © 1999 Wintertree Software Inc, The Sentry Spelling-Checker Engine and Dictionaries which are part of the edit-on Pro package must not be used without edit-on Pro and must not be used separately in any way. This product includes software developed by The Apache Software Foundation (http://www.apache.org/). This product includes software developed by Mark Wutka (http://www.wutka.com/). Parts (SAC,FLUTE,TIDY) of this software are: Copyright © 1994-2002 World Wide Web Consortium, (Massachusetts Institute of Technology, Institut National de Recherche en Informatique et en Automatique, Keio University). All Rights Reserved. http://www.w3.org/Consortium/Legal/ This W3C work (including software, documents, or other related items) is being provided by the copyright holders under the following license. By obtaining, using and/or copying this work, you (the licensee) agree that you have read, understood, and will comply with the following terms and conditions: Permission to use, copy, modify, and distribute this software and its documentation, with or without modification, for any purpose and without fee or royalty is hereby granted, provided that you include the following on ALL copies of the software and documentation or portions thereof, including modifications, that you make: The full text of this NOTICE in a location viewable to users of the redistributed or derivative work. Any pre-existing intellectual property disclaimers, notices, or terms and conditions. If none exist, a short notice of the following form (hypertext is preferred, text is permitted) should be used within the body of any redistributed or derivative code: "Copyright � [$date-of-software] World Wide Web Consortium, (Massachusetts Institute of Technology, Institut National de Recherche en Informatique et en Automatique, Keio University). All Rights Reserved. http://www.w3.org/Consortium/Legal/" Notice of any changes or modifications to the W3C files, including the date changes were made. (We recommend you provide URIs to the location from which the code is derived.) THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS. COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR DOCUMENTATION. The name and trademarks of copyright holders may NOT be used in advertising or publicity pertaining to the software without specific, written prior permission. Title to copyright in this software and any associated documentation will at all times remain with copyright holders. ============================================================================= Copyright (c) 2000-2007, RealObjects GmbH. All rights reserved. ============================================================================= info@realobjects.com http://www.realobjects.com =============================================================================