[windows] Doxyfiles contain deprecated items causing "warning 560: Unknown Doxygen command"
eabase opened this issue · comments
Doxyfile contains several items that doxygen claims to be unknown.
I can only assume they are very old and have been deprecatred long ago.
(Please correct me if I'm worng.)
To fix, run:
# After 1st cmake
doxygen -u .\swig\csharp\docs\DoxyfileThe input files are:
# In files:
./docs/Doxyfile.in
./swig/csharp/docs/Doxyfile.in# doxygen.exe -x_noenv
warning: Tag 'CLASS_DIAGRAMS' at line 2124 of file 'Doxyfile.in' has become obsolete.
warning: Tag 'COLS_IN_ALPHA_INDEX' at line 1046 of file 'Doxyfile.in' has become obsolete.
warning: Tag 'DOCBOOK_PROGRAMLISTING' at line 1931 of file 'Doxyfile.in' has become obsolete.
warning: Tag 'DOT_FONTNAME' at line 2175 of file 'Doxyfile.in' has become obsolete.
warning: Tag 'DOT_FONTSIZE' at line 2182 of file 'Doxyfile.in' has become obsolete.
warning: Tag 'DOT_TRANSPARENT' at line 2403 of file 'Doxyfile.in' has become obsolete.
warning: Tag 'FORMULA_TRANSPARENT' at line 1463 of file 'Doxyfile.in' has become obsolete.
warning: Tag 'HTML_TIMESTAMP' at line 1182 of file 'Doxyfile.in' has become obsolete.
warning: Tag 'LATEX_SOURCE_CODE' at line 1751 of file 'Doxyfile.in' has become obsolete.
warning: Tag 'LATEX_TIMESTAMP' at line 1767 of file 'Doxyfile.in' has become obsolete.
warning: Tag 'MSCGEN_PATH' at line 2133 of file 'Doxyfile.in' has become obsolete.
warning: Tag 'PERL_PATH' at line 2111 of file 'Doxyfile.in' has become obsolete.
warning: Tag 'RTF_SOURCE_CODE' at line 1833 of file 'Doxyfile.in' has become obsolete.
warning: Tag 'TCL_SUBST' at line 237 of file 'Doxyfile.in' has become obsolete.
To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
# Difference with default Doxyfile 1.13.2 (26342b775ea25e6fefb53220926b20702c56fcb3)
PROJECT_NAME = SoapySDR
PROJECT_NUMBER = @SOAPY_SDR_VERSION@
PROJECT_BRIEF = "Vendor and platform neutral SDR interface library"
PROJECT_LOGO = @CMAKE_CURRENT_SOURCE_DIR@/soapy_sdr_logo.png
OUTPUT_DIRECTORY = @CMAKE_CURRENT_BINARY_DIR@
ABBREVIATE_BRIEF =
STRIP_FROM_PATH = "@SOAPY_SDR_INCLUDE_ROOT@"
TIMESTAMP = YES
EXTRACT_ALL = YES
EXTRACT_STATIC = YES
CASE_SENSE_NAMES = YES
WARN_LOGFILE = @CMAKE_CURRENT_BINARY_DIR@/warn.log
INPUT = @SOAPY_SDR_INCLUDE_ROOT@
FILE_PATTERNS =
EXCLUDE_PATTERNS = SoapySDR::Detail
EXAMPLE_PATTERNS =
DISABLE_INDEX = NO
GENERATE_TREEVIEW = NO
MATHJAX_RELPATH = http://cdn.mathjax.org/mathjax/latest
GENERATE_LATEX = NO
LATEX_CMD_NAME = latex
LATEX_BIB_STYLE = plain
MACRO_EXPANSION = YES
HAVE_DOT = @HAVE_DOT@
COLLABORATION_GRAPH = NO
INCLUDE_GRAPH = NO
INCLUDED_BY_GRAPH = NO
DIRECTORY_GRAPH = NO
DOT_PATH = @DOXYGEN_DOT_PATH@
DOT_GRAPH_MAX_NODES = 1000
DOT_MULTI_TARGETS = YES
@zuckschwerdt
Awesome! TY.
There's still an issue here. You say:
which has been replaced by TIMESTAMP in release 1.9.7 (release date 18-05-2023) but is still honored (with 1.11.1).
But latest doxygen is ~ 1.13.2, so I still get:
CUSTOMBUILD : warning : Tag 'HTML_TIMESTAMP' at line 1150 of file 'C:/xxxx/SoapySDR/build/docs/Doxyfile' has become obsolete. [C:\xxxx\SoapySDR\build\docs\docs.vcxproj]In addition, your PR didn't address similar issues in the file:
..\swig\csharp\docs\Doxyfile.in.
https://github.com/pothosware/SoapySDR/blob/master/swig/csharp/docs/Doxyfile.in
Then we have the warning 560: Unknown Doxygen command for all the parblock and endparblock entries in the 2 files:
./include/SoapySDR/Device.h # not used?
./include/SoapySDR/Device.hpp # warning 560See warnings here:
SoapySDRCSHARP_wrap.cxx
C:\xxxx\SoapySDR\include\SoapySDR\Device.hpp(234): warning 560: Unknown Doxygen command: parblock. [C:\xxxx\SoapySDR\build\swig\python\python3\_SoapySDR3.vcxproj]
C:\xxxx\SoapySDR\include\SoapySDR\Device.hpp(252): warning 560: Unknown Doxygen command: endparblock. [C:\xxxx\SoapySDR\build\swig\python\python3\_SoapySDR3.vcxproj]
C:\xxxx\SoapySDR\include\SoapySDR\Device.hpp(255): warning 560: Unknown Doxygen command: parblock. [C:\xxxx\SoapySDR\build\swig\python\python3\_SoapySDR3.vcxproj]
C:\xxxx\SoapySDR\include\SoapySDR\Device.hpp(259): warning 560: Unknown Doxygen command: endparblock. [C:\xxxx\SoapySDR\build\swig\python\python3\_SoapySDR3.vcxproj]
C:\xxxx\SoapySDR\include\SoapySDR\Device.hpp(261): warning 560: Unknown Doxygen command: parblock. [C:\xxxx\SoapySDR\build\swig\python\python3\_SoapySDR3.vcxproj]
C:\xxxx\SoapySDR\include\SoapySDR\Device.hpp(265): warning 560: Unknown Doxygen command: endparblock. [C:\mydev\gitclones\SoapySDR\build\swig\python\python3\_SoapySDR3.vcxproj]
The warning about HTML_TIMESTAMP is expect and will stay. It's only one single warning.
The \parblock seem broken in the headers, I'll fix those.
Actually the warning 560: Unknown Doxygen command: parblock is a Swig warning and must be addressed in the Swig project.
Why would Swig warn about Doxygen stuff?
What is the problem exactly?
I'm happy to file report at Swig, if you point me the right direction...
Swig has a Doxygen parser, search "warning 560: Unknown Doxygen command"