MantisBT - CMake
View Issue Details
0004016CMakeCMakepublic2006-11-02 11:402016-06-10 14:30
Benjamin.Roy 
Brad King 
lowminoralways
closedmoved 
 
 
0004016: Parsing error when generate a doxygen config file with CMake
Initialy using a FILES(... ...APPEND) command an get the following bug:
syntax error in cmake code at
/udd/broy/workspace/MPTKtrunk/CMake/GenerateDoc.cmake:52:
syntax error, unexpected cal_SYMBOL, expecting $end (1476), when parsing string "# If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is
# available from the path. This tool is part of Graphviz, a graph visualization
# toolkit from AT&T and Lucent Bell Labs. The other options in this section
# have no effect if this option is set to NO (the default)

HAVE_DOT = YES

# If the CLASS_GRAPH and HAVE_DOT tags are set to YES then doxygen
# will generate a graph for each documented class showing the direct and
# indirect inheritance relations. Setting this tag to YES will force the
# the CLASS_DIAGRAMS tag to NO.

CLASS_GRAPH = YES


# The tag DOT_PATH can be used to specify the path where the dot tool can be
# found. If left blank, it is assumed the dot tool can be found in the path.

DOT_PATH = ${DOT_PATH}

# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute)
# base path where the generated documentation will be put.
# If a relative path is entered, it will be relative to the location
# where doxygen was started. If left blank the current directory will be used.

OUTPUT_DIRECTORY = ${MPTK_SOURCE_DIR}/doc/refman

# The INPUT tag can be used to specify the files and/or directories that contain
# documented source files. You may enter file names like myfile.cpp or
# directories like /usr/src/myproject. Separate the files or directories
# with spaces.

INPUT = ${MPTK_SOURCE_DIR}/src/libdsp_windows \
                        ${MPTK_SOURCE_DIR}/src/libmptk \
                        ${MPTK_SOURCE_DIR}/src/libmptk/atom_classes \
                        ${MPTK_SOURCE_DIR}/src/utils \
                        ${MPTK_SOURCE_DIR}/src/tests

# The EXCLUDE tag can be used to specify files and/or directories that should
# excluded from the INPUT source files. This way you can easily exclude a
# subdirectory from a directory tree whose root is specified with the INPUT tag.
EXCLUDE = ${MPTK_SOURCE_DIR}/src/libmptk/mptk.h"
--------------------------------------------------
The config file is correctly wrote and the doc is generated without any troubles, but i've got this error which is not really aesthetic for my end-users...
--------------------------------------------------
Fix it with the advise of Brad, using a CONFIG_FILES( ... ... @ONLY) command and some different input Doxygen config files replacing:
DOT_PATH = ${DOT_PATH}
With the syntax:
DOT_PATH = @DOT_PATH@

Reporting this bug on the demand of Brad. Cause " However a separate problem is that CMake should have reported a better error in the first place."

Thanks
No tags attached.
Issue History
2012-08-13 10:37Brad KingStatusassigned => backlog
2012-08-13 10:37Brad KingNote Added: 0030546
2016-06-10 14:27Kitware RobotNote Added: 0041328
2016-06-10 14:27Kitware RobotStatusbacklog => resolved
2016-06-10 14:27Kitware RobotResolutionopen => moved
2016-06-10 14:30Kitware RobotStatusresolved => closed

Notes
(0030546)
Brad King   
2012-08-13 10:37   
Sending issues I'm not actively working on to the backlog to await someone with time for them.

If an issue you care about is sent to the backlog when you feel it should have been addressed in a different manner, please bring it up on the CMake mailing list for discussion. Sign up for the mailing list here, if you're not already on it:

 http://www.cmake.org/mailman/listinfo/cmake [^]

It's easy to re-activate a bug here if you can find a CMake developer or contributor who has the bandwidth to take it on.
(0041328)
Kitware Robot   
2016-06-10 14:27   
Resolving issue as `moved`.

This issue tracker is no longer used. Further discussion of this issue may take place in the current CMake Issues page linked in the banner at the top of this page.