<table><tr><td style="">progwolff added a comment.
</td><a style="text-decoration: none; padding: 4px 8px; margin: 0 8px 8px; float: right; color: #464C5C; font-weight: bold; border-radius: 3px; background-color: #F7F7F9; background-image: linear-gradient(to bottom,#fff,#f1f0f1); display: inline-block; border: 1px solid rgba(71,87,120,.2);" href="https://phabricator.kde.org/D12220">View Revision</a></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/D12220#247155" style="background-color: #e7e7e7;
          border-color: #e7e7e7;
          border-radius: 3px;
          padding: 0 4px;
          font-weight: bold;
          color: black;text-decoration: none;">D12220#247155</a>, <a href="https://phabricator.kde.org/p/mwolff/" style="
              border-color: #f1f7ff;
              color: #19558d;
              background-color: #f1f7ff;
                border: 1px solid transparent;
                border-radius: 3px;
                font-weight: bold;
                padding: 0 4px;">@mwolff</a> wrote:</div>
<div style="margin: 0;
          padding: 0;
          border: 0;
          color: rgb(107, 116, 140);"><p>I'm very unsure about this. On one hand, this obviously looks better in your screenshots. On the other hand, what if we encounter comments that are formatted with some other syntax?</p></div>
</blockquote>

<p>Do you have examples for comments in a different syntax? I only know javadoc, which is quite similar.<br />
Maybe there is a way to add the proposed functionality to the clang backend instead. This way we could be sure that the comments we parse are always doxygen comments.</p>

<blockquote style="border-left: 3px solid #a7b5bf; color: #464c5c; font-style: italic; margin: 4px 0 12px 0; padding: 4px 12px; background-color: #f8f9fc;"><p>Most notably consider how your code would lead to broken HTML quite easily, e.g. when only part of a match is encountered (such as only <tt style="background: #ebebeb; font-size: 13px;">\f\[</tt> but no <tt style="background: #ebebeb; font-size: 13px;">\f\]</tt>).</p></blockquote>

<p>I might fix this by applying the Regex on the whole comment instead of single lines.</p>

<blockquote style="border-left: 3px solid #a7b5bf; color: #464c5c; font-style: italic; margin: 4px 0 12px 0; padding: 4px 12px; background-color: #f8f9fc;"><p>Furthermore, you are introducing untranslatable strings that may be odd when rendered (e.g. when the comment is actually German or such).</p></blockquote>

<p>In german language conversations between colleagues I usually hear phrases like "Die Funktion return't einen integer" more often than "Die Funktion gibt eine Ganzzahl zurück". I see your point, but I don't consider it that critical. Most programming languages have english keywords anyway.</p>

<blockquote style="border-left: 3px solid #a7b5bf; color: #464c5c; font-style: italic; margin: 4px 0 12px 0; padding: 4px 12px; background-color: #f8f9fc;"><p>If at all, then I would say we should keep the doxygen strings and just apply formatting, but not change any string conents. So <tt style="background: #ebebeb; font-size: 13px;">@see</tt> will be rendered as <strong><span class="phabricator-remarkup-mention-unknown">@see</span></strong>, instead of <strong>See also:</strong></p></blockquote>

<p>How about making this feature optional with the states "don't parse doxygen comments", "parse doxygen comments, but keep commands", "parse doxygen comments replacing commands"?</p></div></div><br /><div><strong>REPOSITORY</strong><div><div>R32 KDevelop</div></div></div><br /><div><strong>REVISION DETAIL</strong><div><a href="https://phabricator.kde.org/D12220">https://phabricator.kde.org/D12220</a></div></div><br /><div><strong>To: </strong>progwolff, KDevelop<br /><strong>Cc: </strong>mwolff, croick, kdevelop-devel<br /></div>