Re: Doxygen Warnings P.S.

[Peter Teeson]

HI Jürgen

Still an issue ion my Mac His Sierra OS version 10.13.6

(1) Launched Terminal and checked out APL

Last login: Mon Sep  7 13:36:57 on ttys001

Gandalf:~ pteeson$ cd /Volumes/Data/GNUapl-1.8_1345 

Gandalf:GNUapl-1.8_1345 pteeson$ svn co svn://svn.savannah.gnu.org/apl/trunk

…..

Checked out revision 1345.

Gandalf:GNUapl-1.8_1345 pteeson$

(2)Used the Mac Doxygen GUI to open the checked out doxyfile in trunk
Made a dir in /trunk called myhtml and used it as the output dir for daxygen
(to preserve the checked out set in html)

Also added DOT_PATH as /usr/local/bin

(3) Doxygen version used: 1.8.18 

The following warnings still show up in the log,,,

Searching for member function documentation...

Prefix.cc:871: warning: documented symbol 'void Prefix::reduce____' was not declared or defined.

Prefix.cc:880: warning: documented symbol 'void Prefix::reduce_LPAR_B_RPAR_' was not declared or defined.

Prefix.cc:892: warning: documented symbol 'void Prefix::reduce_LPAR_F_C_RPAR' was not declared or defined.

Prefix.cc:913: warning: documented symbol 'void Prefix::reduce_N___' was not declared or defined.

Prefix.cc:931: warning: documented symbol 'void Prefix::reduce_MISC_F_B_' was not declared or defined.

Prefix.cc:1083: warning: documented symbol 'void Prefix::reduce_MISC_F_C_B' was not declared or defined.

Prefix.cc:1140: warning: documented symbol 'void Prefix::reduce_A_F_B_' was not declared or defined.

Prefix.cc:1159: warning: documented symbol 'void Prefix::reduce_A_M_B_' was not declared or defined.

Prefix.cc:1170: warning: documented symbol 'void Prefix::reduce_A_F_C_B' was not declared or defined.

Prefix.cc:1193: warning: documented symbol 'void Prefix::reduce_A_M_C_B' was not declared or defined.

Prefix.cc:1204: warning: documented symbol 'void Prefix::reduce_F_M__' was not declared or defined.

Prefix.cc:1217: warning: documented symbol 'void Prefix::reduce_M_M__' was not declared or defined.

Prefix.cc:1234: warning: documented symbol 'void Prefix::reduce_F_M_C_' was not declared or defined.

Prefix.cc:1256: warning: documented symbol 'void Prefix::reduce_M_M_C_' was not declared or defined.

Prefix.cc:1273: warning: documented symbol 'void Prefix::reduce_F_C_M_' was not declared or defined.

Prefix.cc:1299: warning: documented symbol 'void Prefix::reduce_M_C_M_' was not declared or defined.

Prefix.cc:1316: warning: documented symbol 'void Prefix::reduce_F_C_M_C' was not declared or defined.

Prefix.cc:1350: warning: documented symbol 'void Prefix::reduce_M_C_M_C' was not declared or defined.

Prefix.cc:1367: warning: documented symbol 'void Prefix::reduce_F_D_B_' was not declared or defined.

Prefix.cc:1415: warning: documented symbol 'void Prefix::reduce_F_D_G_' was not declared or defined.

Prefix.cc:1426: warning: documented symbol 'void Prefix::reduce_F_D_M_' was not declared or defined.

Prefix.cc:1437: warning: documented symbol 'void Prefix::reduce_M_D_G_' was not declared or defined.

Prefix.cc:1448: warning: documented symbol 'void Prefix::reduce_M_D_M_' was not declared or defined.

Prefix.cc:1462: warning: documented symbol 'void Prefix::reduce_F_D_C_B' was not declared or defined.

Prefix.cc:1532: warning: documented symbol 'void Prefix::reduce_A_C__' was not declared or defined.

Prefix.cc:1570: warning: documented symbol 'void Prefix::reduce_V_C__' was not declared or defined.

Prefix.cc:1580: warning: documented symbol 'void Prefix::reduce_V_C_ASS_B' was not declared or defined.

Prefix.cc:1636: warning: documented symbol 'void Prefix::reduce_F_V__' was not declared or defined.

Prefix.cc:1648: warning: documented symbol 'void Prefix::reduce_A_ASS_B_' was not declared or defined.

Prefix.cc:1663: warning: documented symbol 'void Prefix::reduce_V_ASS_B_' was not declared or defined.

Prefix.cc:1682: warning: documented symbol 'void Prefix::reduce_V_ASS_F_' was not declared or defined.

Prefix.cc:1701: warning: documented symbol 'void Prefix::reduce_RBRA___' was not declared or defined.

Prefix.cc:1719: warning: documented symbol 'void Prefix::reduce_LBRA_I__' was not declared or defined.

Prefix.cc:1762: warning: documented symbol 'void Prefix::reduce_LBRA_B_I_' was not declared or defined.

Prefix.cc:1802: warning: documented symbol 'void Prefix::reduce_A_B__' was not declared or defined.

Prefix.cc:1814: warning: documented symbol 'void Prefix::reduce_V_RPAR_ASS_B' was not declared or defined.

Prefix.cc:1868: warning: documented symbol 'void Prefix::reduce_END_VOID__' was not declared or defined.

Prefix.cc:1894: warning: documented symbol 'void Prefix::reduce_END_B__' was not declared or defined.

Prefix.cc:1920: warning: documented symbol 'void Prefix::reduce_END_A_GOTO_B' was not declared or defined.

Prefix.cc:2008: warning: documented symbol 'void Prefix::reduce_END_GOTO_B_' was not declared or defined.

Prefix.cc:2105: warning: documented symbol 'void Prefix::reduce_END_GOTO__' was not declared or defined.

Prefix.cc:2151: warning: documented symbol 'void Prefix::reduce_RETC_VOID__' was not declared or defined.

Prefix.cc:2161: warning: documented symbol 'void Prefix::reduce_RETC___' was not declared or defined.

Prefix.cc:2242: warning: documented symbol 'void Prefix::reduce_RETC_B__' was not declared or defined.

Prefix.cc:2264: warning: documented symbol 'void Prefix::reduce_RETC_A_GOTO_B' was not declared or defined.

Prefix.cc:2274: warning: documented symbol 'void Prefix::reduce_RETC_GOTO_B_' was not declared or defined.

Prefix.cc:2299: warning: documented symbol 'void Prefix::reduce_RETC_GOTO__' was not declared or defined.

….

Simple_string.hh:255: warning: Member Hswap(UCS_string &, UCS_string &) (friend) of class Simple_string is not documented.

On Sep 7, 2020, at 11:51 AM, Peter Teeson <peter.teeson@me.com> wrote:

Thanks for the reply… I had made my own Doxyfile.

And I did run with /src as the source directory.

Will give iy another try using the provided file and run from top lever dir.

But I was trying to just document the pure interpreter itself. Not all the extras.

On Sep 7, 2020, at 6:39 AM, Dr. Jürgen Sauermann <mail@xn--jrgen-sauermann-zvb.de> wrote:

Hi Peter,

looks like this is caused by your Doxygen configuration.
Doxygen should be run in the top-level directory where a
modified Doxygen file is located.

ArrayIterator.cc is actually an obsolete file, I have removed it in SVN 1344.

The missing pieces in Prefix.cc are most likely caused by Doxygen not reading
Prefix.def which requires

FILE_PATTERNS = *.cc *.def *.hh

in file Doxyfile.

Best regards,
Jürgen

On 9/6/20 8:09 PM, Peter Teeson wrote:

First of all thank you Jürgen for the magnificent effort you put into documenting as well as coding GNU APL.

In my experience trying to get coders to document their masterpieces is analogous to herding cats!

But you have done an exemplary job of the highest quality. So I am just sending this as an FYI.

respect….

Peter

Below is from GNUapl_1.8-1342 on which I have run Doxygen on the src and a few warnings have popped up in 2 files: 

ArrayIterator.cc:26: warning: documented symbol 'ArrayIteratorBase::ArrayIteratorBase' was not declared or defined.

Prefix.cc:871: warning: documented symbol 'void Prefix::reduce____' was not declared or defined.

Prefix.cc:880: warning: documented symbol 'void Prefix::reduce_LPAR_B_RPAR_' was not declared or defined.

Prefix.cc:892: warning: documented symbol 'void Prefix::reduce_LPAR_F_C_RPAR' was not declared or defined.

Prefix.cc:913: warning: documented symbol 'void Prefix::reduce_N___' was not declared or defined.

Prefix.cc:931: warning: documented symbol 'void Prefix::reduce_MISC_F_B_' was not declared or defined.

Prefix.cc:1083: warning: documented symbol 'void Prefix::reduce_MISC_F_C_B' was not declared or defined.

Prefix.cc:1140: warning: documented symbol 'void Prefix::reduce_A_F_B_' was not declared or defined.

Prefix.cc:1159: warning: documented symbol 'void Prefix::reduce_A_M_B_' was not declared or defined.

Prefix.cc:1170: warning: documented symbol 'void Prefix::reduce_A_F_C_B' was not declared or defined.

Prefix.cc:1193: warning: documented symbol 'void Prefix::reduce_A_M_C_B' was not declared or defined.

Prefix.cc:1204: warning: documented symbol 'void Prefix::reduce_F_M__' was not declared or defined.

Prefix.cc:1217: warning: documented symbol 'void Prefix::reduce_M_M__' was not declared or defined.

Prefix.cc:1234: warning: documented symbol 'void Prefix::reduce_F_M_C_' was not declared or defined.

Prefix.cc:1256: warning: documented symbol 'void Prefix::reduce_M_M_C_' was not declared or defined.

Prefix.cc:1273: warning: documented symbol 'void Prefix::reduce_F_C_M_' was not declared or defined.

Prefix.cc:1299: warning: documented symbol 'void Prefix::reduce_M_C_M_' was not declared or defined.

Prefix.cc:1316: warning: documented symbol 'void Prefix::reduce_F_C_M_C' was not declared or defined.

Prefix.cc:1350: warning: documented symbol 'void Prefix::reduce_M_C_M_C' was not declared or defined.