Dear Doxygen-Users,
I was trying to create a multi-project documentation with cmake and
doxygen and the tag-files feature but needed a long time for setting it
up because of wrong urls for external files.
(C:/Users/Documents/..../<some_class>.html instead of file:///C:/Users...)
My structure looks as follows:
/root
Doxyfile
/libA
DoxyFile
/libB
DoxyFile
... other libs
/build
/libA/html /* Documentation for LibA only
/libB/html
/html /* Here should be the summary page over all libs
I generated the docs of the libraries succesfully and wanted to create
an overview page according to
http://www.stack.nl/~dimitri/doxygen/manual/external.html and references
between dependent libraries.
Because I used CMake I could created the DoxyFile via the configure_file
feature which copies a template and expands variables.
I generated a TAG File in the build output folder of each library named
<libraryname>.tag to be unique.
In the depending libraries I used this files via
TAG_FILES = <full_path_to_tagfile>=<full_path_to_library_html>
i.e C:/Users/.../libA.tag=C:/Users/.../build/libA/html
doxygen generated the documentation successfully but when I tried to
follow a link to an external file or class (marked as [external] in the
files list) I got an error that the specified document doesn't exist.
When I looked at the specified URL I recognised that the file://
specifier was missing in front of the path.
After a long period of searching bugs in my configuration and googling I
could fix the problem through prepending file:/// to the html path
TAG_FILES = <full_path_to_tagfile>=file:///<full_path_to_library_html>
I am not sure whether this is intended to be like this.
Has anyone done this before?
Kind regards
Fabian Saccilotto
My System:
Doxygen 1.8.4
CMake 2.8.11
Windows 8
------------------------------------------------------------------------------
Get 100% visibility into Java/.NET code with AppDynamics Lite!
It's a free troubleshooting tool designed for production.
Get down to code-level detail for bottlenecks, with <2% overhead.
Download for free and get started troubleshooting in minutes.
http://pubads.g.doubleclick.net/gampad/clk?id=48897031&iu=/4140/ostg.clktrk
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
