enabling-debug-mode.dita 1.6 KB

1234567891011121314151617181920212223242526272829303132333435363738
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
  3. <!--This file is part of the DITA Open Toolkit project. See the accompanying LICENSE.md file for applicable licenses.-->
  4. <task id="t-enabling-debug-mode">
  5. <title>Enabling debug mode</title>
  6. <shortdesc>When the debug mode is enabled, additional diagnostic information is written to the log file. This
  7. information, which includes environment variables and stack trace data, can help you determine the root cause of a
  8. problem.</shortdesc>
  9. <taskbody>
  10. <steps>
  11. <step>
  12. <cmd>From the command prompt, add the following parameters:</cmd>
  13. <choicetable>
  14. <chhead>
  15. <choptionhd>Application</choptionhd>
  16. <chdeschd>Parameters</chdeschd>
  17. </chhead>
  18. <chrow>
  19. <choption><cmdname>dita</cmdname> command</choption>
  20. <chdesc><parmname>-d</parmname> or <parmname>-debug</parmname></chdesc>
  21. </chrow>
  22. <chrow>
  23. <choption>Ant</choption>
  24. <chdesc><codeph>-v -Dargs.debug=yes</codeph></chdesc>
  25. </chrow>
  26. <!--<chrow importance="deprecated">
  27. <choption>Command-line tool</choption>
  28. <chdesc><codeph>/d</codeph> or <codeph>-debug</codeph></chdesc>
  29. </chrow>-->
  30. </choicetable>
  31. <info>
  32. <p>You also can add a <xmlelement>property</xmlelement> element to an Ant target in your build file, for
  33. example: <codeblock>&lt;property name="args.debug" value="yes"/></codeblock></p></info>
  34. </step>
  35. </steps>
  36. </taskbody>
  37. </task>