See also Frequently Asked Questions.
Problems which are solved by upgrading XXE
and/or the Java™ runtime are not listed here. Therefore, the first
thing to do if you have problems is to upgrade XXE to latest
version and to upgrade Java to latest supported version (no beta
- Known problems whatever the platform
- Known problems on Windows
- Known problems on the Mac
- Known problems on Linux
- Known Java™ Web Start problems
- XXE is much too small on a computer having a very high
resolution (HiDPI) screen, for example, on a Windows computer having an
UHD (“4K”) screen.
Workaround: upgrade to version
Note that on a Linux computer having a HiDPI screen, HiDPI
is often not automatically detected. You'll have to use the new
"Display scaling" controls found in the General section of
the Preferences dialog box.
- When an external application changes the contents of the clipboard,
XXE may fail to detect this change.
change the editing context of XXE, for example, by moving
the caret to another XML node.
- Backwards regular expression search (facility found in the Search
tool) is slow to the point of letting the user think that
XXE has stopped working.
Workaround: upgrade to
version 7.4.1+. This feature is still a bit slow but it's
- When XXE is started in a directory which has an
UNC filename (example: \\home\jsmith), opening
documents is very slow or fails with strange error messages such as
"Cannot open file XXX:
Workaround: when XXE is
started in a directory which has an UNC filename, loading
the XML catalog XXE_install_dir/addon/config/catalog.xml
silently fails. Therefore, the workaround is to start XXE
in a directory which has not an UNC filename, for example:
In order to do this:
- Right-click on the XMLmind XML Editor “icon”
that you use to start XXE. For example, right-click on
the XMLmind XML Editor menu item found in the Start
menu > All Programs > XMLmind XML Editor
- This will display a popup menu. Then select the
Properties menu item.
- This will display a dialog box. Then select the Shortcut
Tab and change the Start in field to, for example,
- After that, always start XXE using this modified
- On the Mac, double-clicking on a file which should be opened by
XXE (e.g. a ".dita" file) starts the application
(or brings its window to front if it's already started) but does not
cause the file to be opened in the editor.
No workaround. Seems to be
a Java™ bug ([macosx]
OpenFilesHandler does not receive fileopen events),
unfortunately not fixed in Java 9.
- Changing the settings of the media player
embedded in the styled view or switching from one CSS stylesheet to
another while the media player is playing audio or video sometimes
causes Java to crash and burn (not only XXE; Java
No workaround. Seems to be a Java™ bug which is
specific to macOS (this does not happen on Windows and on
- When using a Oracle Java™ 1.7+ runtime to run
XXE, printing the document being edited by the means of the
File|Print menu item crashes the
Workaround: upgrade to latest Oracle Java 1.8+ or
downgrade to latest Apple Java 1.6.
- XXE looks blurry on a Mac having a Retina®
Workaround: upgrade to version 6.5+.
- Known problems related to the clipboard:
- XXE randomly hangs for a couple of minutes. This
seems to happen only on Linux with a
JavaTM runtime 1.6+. This often happens
when OpenOffice/LibreOffice is also
Workaround: using an external application, update
the contents of the system clipboard by copying to it (i.e.
by using Ctrl-C) a small piece of text.
- Copying text or images from XXE to OpenOffice/LibreOffice works fine but
the opposite operation often hangs XXE (or at best
makes it very, very, slow).
Workaround: the workaround to
unblock XXE is to copy a piece of text to the clipboard
using any application other than OpenOffice/LibreOffice.
- Copying images from XXE to the Gimp works fine but the opposite
operation will not work.
- XXE becomes unusable after the computer wakes up from
sleep mode. The following exception is printed on the console
cannot be cast to sun.java2d.xr.XRSurfaceData".
other than downgrading to Java™ 7 or Java™ 6. This is bug JDK-7172749.
- When using window managers other than the KDE or Gnome standard
window managers, the XXE main window is displayed at a
wrong place with a wrong size.
Workaround: Java™ seems to
be tested only against the Gnome and KDE standard window managers.
Therefore, you unfortunately need to use another window
- Many Web browsers will simply download the
file without attempting to open it in the associated javaws
program (Java™ Web Start launcher).
asked if you want to really want open
javaws, please answer yes.
Confirm that you
want to always open ".jnlp" files:
Note that once the
xxe.jnlp file has been downloaded and saved somewhere by
the Web browser, the Web browser is no longer needed to start
XXE. Simply double-click
xxe.jnlp, this should
javaws and XXE should
Mac OS X only:
- Java™ Web Start is not really usable on Mac OS X 10.8+.
Mac OS X refuses to “run” the
downloaded from the Web because this simple, short, XML file has not
been digitally signed.
change the security settings of Mac OS X to "Allow apps downloaded
- By default, XXE uses Mac OS X native file chooser to
let the user select a file. When deployed using Java Web Start, for an
unknown reason, this Mac OS X native file chooser becomes
Workaround: use menu item
Options|Preferences, Open section and uncheck
"Use the native file chooser in preference to the multi-platform file
chooser" in the Preferences dialog box.
© 2017-2018 XMLmind Software. Updated on 2018/5/20.
Oracle and Java are registered trademarks of Oracle and/or
Other names may be trademarks of their respective owners.
Acrobat and PostScript are trademarks of Adobe Systems