chiark / gitweb /
documentation/doxygen: Doxygen 1.9.3 warns about \return for void.
authorVladimír Vondruš <mosra@centrum.cz>
Sun, 9 Jan 2022 18:25:46 +0000 (19:25 +0100)
committerVladimír Vondruš <mosra@centrum.cz>
Sun, 9 Jan 2022 22:50:21 +0000 (23:50 +0100)
And quite intensely. Don't do that, then.

documentation/test_doxygen/compound_detailed/File.h
documentation/test_doxygen/compound_detailed/namespaceWarning.html

index 016ee61d73530bb3eb5c99aacdf7a6a57864c37d..a240960fe42d270df42e851e7b063b53b1409e37 100644 (file)
@@ -227,14 +227,15 @@ namespace Warning {
 /**
 @brief Wrong
 @param wrong This parameter is not here
-@return Returns nothing.
-@return Returns nothing, but second time. This is ignored.
+@return Returns something.
+@return Returns something, but second time. This is ignored.
 
 Function details.
 
-@return Returns nothing, third time, in a different paragraph. Ignored as well.
+@return Returns something, third time, in a different paragraph. Ignored as
+    well.
 */
-void bar();
+int bar();
 
 }
 
index 653b039d85a53707f19c48aa155d6a1600035240..5048c17d1c43eda9a73fd4502d34c812ae7ad62d 100644 (file)
           <h2><a href="#func-members">Functions</a></h2>
           <dl class="m-doc">
             <dt>
-              <span class="m-doc-wrap-bumper">void <a href="#a084dfc535219dee446df1c710e215839" class="m-doc">bar</a>(</span><span class="m-doc-wrap">)</span>
+              <span class="m-doc-wrap-bumper">auto <a href="#aa4af36dc837a6d7b064dc12bd59b2bd5" class="m-doc">bar</a>(</span><span class="m-doc-wrap">) -&gt; int</span>
             </dt>
             <dd>Wrong.</dd>
           </dl>
         </section>
         <section>
           <h2>Function documentation</h2>
-          <section class="m-doc-details" id="a084dfc535219dee446df1c710e215839"><div>
+          <section class="m-doc-details" id="aa4af36dc837a6d7b064dc12bd59b2bd5"><div>
             <h3>
-              <span class="m-doc-wrap-bumper">void Warning::<wbr /></span><span class="m-doc-wrap"><span class="m-doc-wrap-bumper"><a href="#a084dfc535219dee446df1c710e215839" class="m-doc-self">bar</a>(</span><span class="m-doc-wrap">)</span></span>
+              <span class="m-doc-wrap-bumper">int Warning::<wbr /></span><span class="m-doc-wrap"><span class="m-doc-wrap-bumper"><a href="#aa4af36dc837a6d7b064dc12bd59b2bd5" class="m-doc-self">bar</a>(</span><span class="m-doc-wrap">)</span></span>
             </h3>
             <p>Wrong.</p>
             <table class="m-table m-fullwidth m-flat">
               <tfoot>
                 <tr>
                   <th style="width: 1%">Returns</th>
-                  <td>Returns nothing.</td>
+                  <td>Returns something.</td>
                 </tr>
               </tfoot>
             </table>