Page MenuHomePhabricator

[Documentation] Remove dummy chartExample documentation
Closed, ResolvedPublic

Description

Error FODC0002 in file:///home/ubuntu/jenkins-agent/MITK/Continuous/Ubuntu18.04/build/MITK-build/Plugins/org.mitk.gui.qt.chartExample/documentation/UserManual/html/index.qhp, at line 11, column 14: Opening and ending tag mismatch.
index.qhp
<toc>
  <section title="ChartExample" ref="index.html">
    <section title="Overview" ref="org_mitk_gui_qt_chartExample.html#org_mitk_gui_qt_chartExampleOverview" />
  </section>
  </section>
</toc>

Event Timeline

kislinsk created this task.
kislinsk moved this task from Backlog to Documentation on the MITK (v2021.02) board.

Moving the table of contents above any imageMacros did not work. Next try is to (temporarily) remove the imageMacros and if it works, look into the imageMacro.

"imageMacro{3}=\image html \1 \2 \n \image latex \1 \2 width=\3cm"

Side note: the imageMacro is defined four times.

  • Documentation/doxygen.conf.in
  • Documentation/doxygen_developers_guide.conf.in
  • Documentation/doxygen_plugin_manual.conf.in
  • Documentation/doxygen_users_guide.conf.in

Okay, two red herrings here:

  • It's probably not related to the imageMacro
  • <toc>...</toc> is also generated in qhp files when there is no \tableofcontents

I think it is probably related to T27563: I noticed that the page id (Manual.dox) is the same as the defgroup id (modules.dox). Both are supposed to be unique, though. I will correct the ids in the documentation and the code and try again...

Deleted branch bugfix/T27607-chartExample-UserManual.

I surrendered and deleted the chartExample documentation as it simply was a copy of the dummy documentation anyway (in other words: no documentation). The Ubuntu and macOS dartclients now complain because of the geometrytools plugin. Hence, the Windows dartclient probably reports a complete list as it continues to generate the documentation.

kislinsk renamed this task from [Documentation] Fix chartExample user manual to [Documentation] Remove dummy chartExample documentation.Jul 27 2020, 1:20 PM

Deleted branch bugfix/T27607-chartExample-UserManual.