=============================================================================== edit-on(R) JavaBean SDK by RealObjects Version 5.1.290.0, 2007-11-07 =============================================================================== 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 JavaBean SDK Software License Agreement. By installing and using this software, you accept the terms and conditions of the RealObjects JavaBean SDK Software License Agreement. For details, see the license.txt file. After you finish the evaluation you must permanently remove this software and its support material from your computers, including the Sentry Spelling-Checker Engine and dictionaries. To purchase an edit-on JavaBean SDK license, please visit our website at http://www.realobjects.com Folder Contents --------------- Folder doc\ : contains two subfolders "manual" and API "JavaDoc". Folder doc\manual : edit-on JavaBean SDK Integration Manual (PDF-Format). Please make sure that you read this manual! Folder doc\javadoc : Java Doc style API description of the edit-on JavaBean SDK. Folder eobean\ : contains the edit-on JavaBean SDK Java archive for use with Swing based applications. Folder sample_application\ : contains the edit-on JavaBean SDK - Sample Application (jar archive, startup scripts for Linux and MS Windows and the source code) Folder sample_application\src : contains the Java source code of the edit-on JavaBean SDK - Sample Application Remark: Please be sure that you unzip the complete directory structure. If you use WinZip activate the "Use Folder Names" option when unzipping. Installation ------------ * Add the JavaBean SDK jar archive to your classpath before compiling against it. * If you are using a JavaBean capable Java IDE you can deploy the edit-on JavaBean SDK within the UI Form Editor of the IDE (for details on that please refer to the edit-on JavaBean SDK Integration Manual). Please never modify the licensekey string. Without this licensekey string, edit-on JavaBean SDK will run in a demo mode that lasts for exactly 2 minutes after starting an application containing the JavaBean SDK EditorBean class. After this period has expired, it is no longer possible to extract content from the editing component of the Javabean SDK. The license key string is protected by a digital signature, so modifying it will break it. Execution of the Sample Application ----------------------------------- * Please make sure to have an executable java file (Java Virtual Machine of the Java Runtime Environment) added in the path of executables of your OS (e.g. on Windows and Unix add the folder containing it to the PATH environment variable) before executing the provided startup scripts * The sample applications can be run via two provided startup scripts "run.sh" for Unix based systems and "run.bat" for MS Windows * On Mac OS X the samples can be started from Terminal through the "run.sh" shell script Rebuilding the Sample Applications ---------------------------------- If you are familiar with Jakarta Ant feel free to use the "build.xml" to (re-)build the samples which can be found in the folder sample_application. The recommended version of Jakarta Ant is 1.5.1 or higher. Upgrading from edit-on JavaBean SDK 4 ------------------------------------- * The license key strings of edit-on JavaBean SDK 4 do not work with edit-on JavaBean SDK 5 and vice-versa. Release History --------------- 5.1.290: Second Maintenance Release of edit-on JavaBean SDK 5 * Added new setting for custom actions: enabledinreadonlymode. When this attribute is set to true, the action may be executed within custom tags which are editable in read-only mode. * Added two new actions: SPLITPARAGRAPH and BR. * Added table AutoFormat templates to the configuration of the sample application 5.1.289: First Maintenance Release of edit-on JavaBean SDK 5 The bug fixes include: * Cursor is blinking in the editor bean that doesn't have focus when using multiple instances of the edit-on JavaBean * Caret location and caret blinking location are not the same after certain mouse click actions * Rendering error after typing in a a table cell with an empty paragraph * Calling clear() when the EditorBean is in WYSIWYGAreaOnly mode causes exception 5.1.282: First release of edit-on JavaBean SDK 5 The new features include: * Table auto formatting with customizable templates * Improved table editing and performance * 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 * Event handlers or actions can be triggered by "invokeAction" * Added new actions: INCINDENTBLOCKQUOTE and DECINDENTBLOCKQUOTE. * API function to retrieve a parent element depending on the element name. Release Notes and Known Issues ------------------------------ * This version accepts and produces well-formed XHTML only. Non-well-formed code will not be processed by the editor. The editor can clean up minor errors (e.g. lack of closing tags,..) within non-well-formed code using the W3C HTML Tidy technology which is an integral part of the bean. The W3C HTML Tidy clean up process can be activated or deactivated (see manual). * Make sure to read the Integration Manual (PDF Format), which can be found in the "doc/manual" directory. * 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. * HTML format pasting from e.g. Word/Excel etc. only works with JRE 1.4.2 or newer in Windows. * Support for generic XML documents/content is limited. The structure of existing XML documents is not guaranteed to be preserved during import/editing or export. * In HTML source view, Unicode characters >127 aren't displayed correctly when e.g. loading a document containing such characters and switching to HTML source view. They only are displayed correctly if typed in directly. This is caused a bug reported at Sun's Java bug parade, Bug ID 4727926. For details on this issue, refer to this URL http://developer.java.sun.com/developer/bugParade/bugs/4727926.html . * insertImage API method automatically (XHTML-) encodes attribute values for src and alt. For all other methods this should be done before passing content to them. 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) To download the latest Java VMs please visit: Sun JRE: http://java.sun.com/j2se/ 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). Min. 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. 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 Important Notes ----------------------------------------- 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 =============================================================================