Re: Doxygen Warnings

[Peter Teeson]

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.