Error opening map file

来源：互联网发布：windows汇编和普通汇编编辑：程序博客网时间：2024/05/02 00:06

Error opening map file *.map for inclusion in the docs! +doxygen +eclipse

This problem is due to Short Names tag

set the Short Names tag to YES and things will be fine.

18 comments:

Anonymous said...: god bless you!! you saved me!!; March 27, 2008 8:35 PM
Anonymous said...: That made it work for me!
Thanks!; March 28, 2008 4:36 PM
Vinz said...: Thank's you! You have solved my problem.

Why don't you report the "bug" and your solution to eclox developes?; March 30, 2008 8:20 PM
Mihir said...: I don;t think this is a bug. although changing the default parameter can solve this.

I will try to report it.

Thanks for the suggestion.; March 31, 2008 3:14 PM
Aaron said...: thanks, worked; April 5, 2008 5:11 AM
Nikhil Manohar. said...: Thanks Man!
That saved my time!!
Thanks! :); April 8, 2008 3:49 PM
Anonymous said...: Thanks a lot a man,
I start believing in Doxygen.; May 2, 2008 2:22 PM
Anonymous said...: I love you very much good Sir. This information is very valuable to me.; June 1, 2008 11:42 AM
Anonymous said...: Thank you very much.
After changing this option it started working for me.; July 10, 2008 4:37 PM
Anonymous said...: Thank you very much!
After changing this options it started working for me.; July 10, 2008 4:39 PM
Thorsten said...: you saved me as well. I did a
grep -i "short" Doxyfile
and found
SHORT_NAMES = NO

after replacing it, doxygen finally worked.; September 6, 2008 8:16 PM
tom said...: where can I find the "Short Names" tag so I can change it? I'm looking in the "Expert" tab of Doxywizard the doxygen GUI. mnay thanks,; September 20, 2008 7:51 AM
Anonymous said...: Under Expert->"Project" tab, there's a check box called "SHORT_NAMES". This box, disabled by default, should be *checked*.; September 26, 2008 1:15 AM
Anonymous said...: Tjohoooo! It workes!; October 8, 2008 1:51 AM
Anonymous said...: Works perfectly now! Awesome!; October 17, 2008 8:12 AM
Anonymous said...: For me it worked only after I have set:

FULL_PATH_NAMES = NO
SHORT_NAMES = NO

Hope this helps someone...; October 30, 2008 12:23 AM
Mihir said...: You can add comments to this bug at:

http://bugzilla.gnome.org/show_bug.cgi?id=525273

doxygen | general | Ver: 1.5.5

Gingko changed:

What |Removed |Added
----------------------------------------------------------------------------
CC| |from_bugzilla@nospam.homelin
| |ux.org

------- Comment #3 from Gingko 2008-11-28 09:22 UTC -------
Hello,

I had this bug several times on several computers without ever understanding
why. On many places on Internet I saw users reporting having "fixed" it using
the SHORT_NAMES option (try this search:
http://www.google.com/search?q=%22Error+opening+map+file%22+SHORT_NAMES ), but
this didn't make sense to me.

But I finally ran in a strange situation which probably makes me finding the
real reason of this problem :
I have two folders which contain two side by side forks of the same project.
Each of them have their own configuration files, but these configuration files
are absolutely identical. There was no apparent reason for that but ... when
generating their respective Doxygen documentation, one of these projects had
the bug and the second one not !

Thinking a lot, I tried several things, and I ended with the following :
cleaning all Doxygen generated files (in the "html" folder) in the faulty
project was enough for removing the bug (that is, after doing that, the new
generation ran with no error).

I think now that the problem is the following :

It looks like that Doxygen has an incremental feature (that is, if you generate
the same documentation several times, only changed files will be reprocessed,
thus improving speed). But that way, if the previous generation was faulty,
several things will not get fixed. Especially if "map" files were missing
because there was an error in the previous generation. And the main reason for
having "map" files missing is trying to generate graphics without having
"graphViz" installed.

So probably many users proceed on the following way when using "Doxygen" for
the first time :

(1) They download and install Doxygen.
(2) They try to use it for documenting some of their own projects.
(3) At a given time, they try to enable the "dot" (graphViz) for generating the
project.
(4) They get a lot of errors because graphViz was not installed. Of course it
wasn't, it is not included with Doxyfile! But they didn't read that yet so they
return to the manual and they see that they now need to download and install
graphViz (alternatively, maybe they have installed it, but not correctly).
(5) After having fixed the graphViz installation problem, they run Doxygen
again on the same project.
(6) Things seem to work a little better, but now they have plenty of these
"Error opening map file *.map for inclusion in the docs!". The reason is that
the previous generation left a corrupted documentation in the folder, but they
don't know it.
(7) They search on Internet the reason of this error and they find that many
people have fixed it by setting the SHORT_NAMES option to YES.
(8) They try this, and it works. They are happy.

But what they don't know is that if the SHORT_NAMES trick works, it is not
because this option was the reason of the bug, but rather that it completely
changes almost all the names inside the folder, so the previous generation is
not seen: a completely new set of files is generated (actually leaving the
previous files orphan in the folder, which could be seen as another bug as they
uselessly take space; but this is another problem).

If they had begun their first try by setting the SHORT_NAMES option to YES,
they would have now to set it to NO for getting the same result.

So the correct workaround is cleaning the previous generation rather than
changing the "SHORT_NAMES" option if you see this "Error opening map file *.map
for inclusion in the docs!" message.

... and the bug fix could be trying to regenerate the picture if some "map"
file is found missing during an incremental regeneration rather than issuing an
error and ignoring this part of the project.

Gilles; November 29, 2008 11:04 AM
Peter K. said...: Yet again, THANKS!; December 18, 2008 10:45 PM