=============================================================================== edit-on(R) JavaBean SDK by RealObjects Version 5.3.335.293, 2011-12-16 =============================================================================== 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.3.335.293: Sixth Maintenance Release of edit-on JavaBean SDK 5.3 The changes include: * The com.realobjects.eop.bean.CleanUpException class is no longer obfuscated. 5.3.334.289: Fifth Maintenance Release of edit-on JavaBean SDK 5.3 The bug fixes include: * Fixed exception when pasting and inserting content within a table. * Fixed exception when inserting an element containing the entity. The new features include: * Added an option to configure whether or not the "Clean up data error" dialog is displayed. 5.3.333.272: Fourth Maintenance Release of edit-on JavaBean SDK 5.3 The bug fixes include: * Applying both underline and strike-through to text is now displayed correctly. * IMAGE LOADER threads now termintate properly. 5.3.332.244: Third Maintenance Release of edit-on JavaBean SDK 5.3 The improvements include: * The background color of tables and table cells is now set using the "background-color" CSS property instead of the "bgcolor" attribute. The bug fixes include: * The "Delete Row" action no longer is enabled outside of tables. * The font-size of text with "vertical-align: sub" and "vertical-align: super" no longer are too small in relation to other text. * Selecting existing bookmark in the "Insert / Edit Hyperlink" dialogs is now possible. * Solved an exception when pasting tables in source view. * The list-style image is now properly inherited in nested lists. * Fixed incorrect behaviour when using tables in lists. 5.3.331.230: Second Maintenance Release of edit-on JavaBean SDK 5.3. The bug fixes include: * The API method "getCurrentElement" returned an empty string when called next to an empty custom inline element. * Fixed an issue when importing tables containing rows where the sum of the width of the cells in the row is larger than the table width. * Solved an issue where assigning a different copy & paste action to a MenuAndToolBarItem could fail under certain circumstances. * Nested styles with an "@" descriptor (e.g. "@page") are no longer removed. 5.3.330.219: First Maintenance Release of edit-on JavaBean SDK 5.3 The bug fixes include: * Solved incorrect behaviour when the DragNDropAction is set to "DRAGNDROPWITHFILTER". * Solved focus problem when using mutliple instances of the component. * An exception should no longer appear sometimes after initialisation. * The table auto format was not applied to cells added subsequently. * It was possible to modify parts of read-only elements with the spellchecker or with the "Find and Replace" functionality. As this was not intented, this is no longer possible. * The HTML Parser has been modified. Missing table elements in the "Source View" will be created automatically. * Fixed OutOfMemory Exception when pasting a document in Source View and switching to WYSIWYG. * The "getParentElementByNameContent" now properly returns "caption" elements if they are found when used to retrieve the content of a "table" element. * It is now possible to set the "colspan" attribute of "table" elements using the method "setElementAttributes" and other similar API methods. * Fixed an issue that could occur when trying to delete a table under specific circumstances. The new features include: * The "windowtext" CSS property is now supported. * Numeric values for the "font-weight" CSS property are now supported. * The WYSIWYG Tab can now be hidden if the Source View is disabled. 5.3.310: Second release of edit-on JavaBean SDK 5.3 * There was an issue when the tooltip for the "alt" attribute of the "img" element was displayed when the image alignment was set. 5.3.309.43: First release of edit-on JavaBean SDK 5.3 The bug fixes include: * The "getSelectedHTMLData" API method no longer resets the "contentChanged" property. * Modifying the Source View no longer resets the value returned by hasContentChanged. * It was not possible to remove attributes of table cells using the cell properties (advanced) dialog. * The "enabledinreadonlymode" attribute had no effect on elements which are read-only due to "customtagseditingonly" being enabled. * Incorrect "id" attributes are now cleaned properly. * An issue that occured when bookmarks where inserted around custom inline elements was solved. * The CSS information of a template set using setTemplate*() was lost when using setHTMLData*() while the "bodyonly" property was set to "true". * The shortcut element was missing from the "uiconfig" DTD. * There was a NullPointer Exception when inserting content without a "head" element and the "documentvalidation" property was not enabled. * The table auto formatting function assigned a wrong value to the "class" attribute specified for "wholetable". * Content copied & pasted from WordPad into the editor was inserted as an image. * A NPE occured when changing the "border" attribute of a "table" to something other than a numeric value. * Splitting elements with an id did not increment the "id" attribute for the split element. * Applying insertHTMLData to selected tables was not possible. * The "Clean style" function no longer removes hyperlinks. * Setting a template in the config had no effect anymore. * Nested @ style rules (such as @page were filtered). * Style declarations defined in a external style sheet referenced in the document were included in the document. * Inserting a table with an unspecified width caused a java.lang.StringIndexOutOfBoundsException. * A rendering error after typing in a a table cell with an empty paragraph was solved. * A paint problem with right aligned paragraphs having a white background color was solved. * REMOVECUSTOMTAG action now also functions for elements with "ro-readonlyelement: true;". * The context menu did not appear for read-only custom elements. * There was a spell checker exception when initializing the EditorBean. * Modifying the value of the "width" and "height" attributes of an "object" element dynamically had no effect that was visible in WYSIWYG mode. * Elements that only contained non-breaking spaces were sometimes removed. * The "text-decoration" style property was not rendered properly when it was set on a "a" element. * When content was copied & pasted or dragged & dropped from a document in Internet Explorer, the entire document was insert instead of only the part that was copied or dragged & dropped. * The vertical alignment of content inside a table row consisting of "th" elements was not properly aligned. * When "cleanuponload" was set to "always", the "encoding" setting defaulted to "UTF-8". The value of the "encoding" property is now properly used instead. * The spell checker still was storing and applying user preferences even if the storing of user preferences was deactivated in the config.xml. * An exception occured when splitting a cell into mutiple columns. * The "insertHTMLData" and "setHTMLData" methods no longer automatically set the focus on the editor. * Empty custom elements sometimes were not appropriately removed when pressing backspace. The new features include: * The tabs in the "Page Properties" dialog can now be configured. * Configurable log level for errors and warnings. * Event listener when adding words to the spellchecker * Added an action which completely removes custom tags, including their content. * It is now possible to jump to a certain bookmark in the editor. * There are now setCaret**** methods that do not request focus. * When importing a document, we now preserve the ordering of an element's attributes. * It is now possible to configure whether or not the default border of the canvas should appear. * The value of the "alt" attribute of the "img" element and the "title" element of the "a" element is now displayed in the tooltip when hovering over these elements. * The "defaultfont" setting now allows the integrator to provide a list of fonts to be used in an order of priority if the first font is not available (in a similar fashion to the CSS property "font-family"). * Added an event handler for "insertHTMLData*()" and setTemplate*() functions 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 (Installing the latest Service Pack is recommended) Microsoft Windows Vista (Installing the latest Service Pack is recommended) Microsoft Windows 7 (Installing the latest Service Pack is recommended) Linux 2.x Sun Solaris 8/9/10 Apple Mac OS X 10.4 or newer (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.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-2011, RealObjects GmbH. All rights reserved. ============================================================================= info@realobjects.com http://www.realobjects.com =============================================================================