<table><tr><td style="">kossebau added a comment.
</td></tr></table><br /><div><div><blockquote style="border-left: 3px solid #8C98B8;
          color: #6B748C;
          font-style: italic;
          margin: 4px 0 12px 0;
          padding: 8px 12px;
          background-color: #F8F9FC;">
<div style="font-style: normal;
          padding-bottom: 4px;">In <a href="https://phabricator.kde.org/T3755#55412" style="background-color: #e7e7e7;
          border-color: #e7e7e7;
          border-radius: 3px;
          padding: 0 4px;
          font-weight: bold;
          color: black;text-decoration: none;" rel="noreferrer">T3755#55412</a>, <a href="https://phabricator.kde.org/p/staniek/" style="
              border-color: #f1f7ff;
              color: #19558d;
              background-color: #f1f7ff;
                border: 1px solid transparent;
                border-radius: 3px;
                font-weight: bold;
                padding: 0 4px;" rel="noreferrer">@staniek</a> wrote:</div>
<div style="margin: 0;
          padding: 0;
          border: 0;
          color: rgb(107, 116, 140);"><p>Are we sure?</p>

<p>For example KDevelop has kdevplatform <a href="https://api.kde.org/extragear-api/kdevelop-apidocs/index.html" class="remarkup-link" target="_blank" rel="noreferrer">https://api.kde.org/extragear-api/kdevelop-apidocs/index.html</a>, just released yesterday, but Calligra does not:</p>

<p><a href="https://api.kde.org/bundled-apps-api/calligra-apidocs/" class="remarkup-link" target="_blank" rel="noreferrer">https://api.kde.org/bundled-apps-api/calligra-apidocs/</a></p></div>
</blockquote>

<p>This is because the pages generated below kdevelop-apidocs include both repos kdevelop and kdevplatform. The script there is not run on each repo separately, but run at the checkout of both.<br />
But only kdevplatform has a Mainpage.dox file. So by that old kdelibs script system of just generating documentation for things in the folders below the deepest Mainpage.dox files this results in what can be seen.</p>

<p>The script also used to do the same before with the repos krita, kexi & calligra, generating all documentation for all of them in one go below calligra-apidocs.<br />
Which of course resulted in a mess, due to the forked classes and also was wrong with krita no longer being a Calligra project.<br />
So <a href="https://phabricator.kde.org/p/winterz/" style="
              border-color: #f1f7ff;
              color: #19558d;
              background-color: #f1f7ff;
                border: 1px solid transparent;
                border-radius: 3px;
                font-weight: bold;
                padding: 0 4px;" rel="noreferrer">@winterz</a> on my request changed the setup to generate the documentation for all three repos separately. Due to kexi having KUndo duplicated and also having a different code layout, I decided against still generating kexi & calligra docs together.</p>

<p>The only thing still missing for that setup is being listed on <a href="https://api.kde.org/other.php" class="remarkup-link" target="_blank" rel="noreferrer">https://api.kde.org/other.php</a></p>

<p>But indeed this is just for now, as intermediate solution. Someone  needs to look into a future-proof setup for the separate contributor-oriented complete source-code covering generation of API dox. Not me, too much to do already, only available for giving over-smart comments ;)</p>

<p><a href="https://phabricator.kde.org/p/staniek/" style="
              border-color: #f1f7ff;
              color: #19558d;
              background-color: #f1f7ff;
                border: 1px solid transparent;
                border-radius: 3px;
                font-weight: bold;
                padding: 0 4px;" rel="noreferrer">@staniek</a> I would recommend to move src/Mainpage.dox to the toplevel dir (and adopting the EXCLUDE entry). Because right now this results in the additional subsection "Kexi" on <a href="https://api.kde.org/bundled-apps-api/kexi-apidocs/" class="remarkup-link" target="_blank" rel="noreferrer">https://api.kde.org/bundled-apps-api/kexi-apidocs/</a> without any use.</p></div></div><br /><div><strong>TASK DETAIL</strong><div><a href="https://phabricator.kde.org/T3755" rel="noreferrer">https://phabricator.kde.org/T3755</a></div></div><br /><div><strong>EMAIL PREFERENCES</strong><div><a href="https://phabricator.kde.org/settings/panel/emailpreferences/" rel="noreferrer">https://phabricator.kde.org/settings/panel/emailpreferences/</a></div></div><br /><div><strong>To: </strong>kossebau<br /><strong>Cc: </strong>piggz, kossebau, Calligra-Devel-list, bcooksley, ochurlaud, sysadmin, staniek, blazquez<br /></div>