other-errors.dita 2.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
  3. <!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
  4. <reference id="troubleshooting" xml:lang="en-US">
  5. <title>Other error messages</title>
  6. <shortdesc>In addition to error messages generated by the DITA Open Toolkit, you might also encounter error messages
  7. generated by Java or other tools.</shortdesc>
  8. <refbody>
  9. <section id="out-of-memory-error">
  10. <title>Out of Memory error</title>
  11. <p>In some cases, you might receive a message stating the build has failed due to an <msgph>Out of Memory</msgph>
  12. error. Try the following approaches to resolve the problem:</p>
  13. <ol>
  14. <li>Increase the memory available to Java.</li>
  15. <li>Reduce memory consumption by setting the <option>generate-debug-attributes</option> option to
  16. <codeph>false</codeph>. This option is set in the <filepath>lib/configuration.properties</filepath> file.
  17. This will disable debug attribute generation (used to trace DITA-OT error messages back to source files) and
  18. will reduce memory consumption.</li>
  19. <li>Set <codeph>dita.preprocess.reloadstylesheet</codeph> Ant property to <codeph>true</codeph>. This will allow
  20. the XSLT processor to release memory when converting multiple files.</li>
  21. <li>Run the transformation again.</li>
  22. </ol>
  23. </section>
  24. <section id="unsupported-class-version-error">
  25. <title>UnsupportedClassVersionError</title>
  26. <p>If you receive a <codeph>java.lang.UnsupportedClassVersionError</codeph> error message with an
  27. <codeph>Unsupported major.minor version</codeph> and a list of Java classes, make sure your system meets the
  28. minimum Java requirements as listed in the <cite>Release Notes</cite> and installation instructions.</p>
  29. </section>
  30. <section id="tools-jar-error">
  31. <title>Unable to locate tools.jar</title>
  32. <p>If a Java Runtime Environment (JRE) is used when building output via Ant, the <msgph>Unable to locate
  33. tools.jar</msgph> error may appear. This message is safe to ignore, since DITA-OT does not rely on any of the
  34. functions in this library. If a Java Development Kit (JDK) is also installed, setting the
  35. <varname>JAVA_HOME</varname> environment variable to the location of the JDK will prevent this message from
  36. appearing.</p>
  37. </section>
  38. </refbody>
  39. </reference>