I have been trying to use the DoxyBlocks plugin to generate documentation, however, when I press "Extract documentation" it reports:
Extracting documentation for StringTools.
DoxyBlocks is working, please wait a few moments...
Found existing doxyfile...
Success.
Your documents are in: C:\Lib\StringTools\doxygen\
Done.
but the only file in C:\Lib\StringTools\doxygen\ is doxyfile (no documentation is produced).
If I run doxygen command-line, it works fine (producing html).
Is there a setting I am missing?
(I have doxygen version 1.7.5.1 and Code::Blocks svn r7632 on Windows XP and Windows Vista 32 bit.)
Hi,
I'm having (exactly) the same issue, and I can't find what I've done wrong...
Doxywizard ran successfully, I've got a valid doxyfile in my doxygen output directory, but Ctrl+Alt+E / DoxyBlocks>Extract Documentation do absolutely nothing.
And it shows the same message than Alpha quoted above...
Thanks by advance for any help o/
Derjik: What cb version/os are you running?
oBFusCATed: I'm running C::B 12.11 on Windows 7.
The most intriguing fact is that:
-My doxyfile IS valid (I can extract the documentation _via_ the doxywizard in the Run tab)
-DoxyBlocks seems to find it, but does -strictly- nothing...
Should I try with a nightly build ?
Quote from: Derjik on February 03, 2013, 12:01:56 AM
Should I try with a nightly build ?
There is no nightly newer than 12.11, so no.
Oh, okay :(
So, what should I try/check/configure ? As I said, I can't find what I've missed in the configuration :(
EDIT: I talked with some friends of mine today, and they're experiencing the exact same issue.
Ctrl+Alt+E (or DoxyBlocks>Extract Documentation) creates (or reads) a doxyfile, but does nothing else...
Thx by advance for any further help o/
Can you provide a simple project that can be used to reproduce the problem?
I'm not using doxygen, so I can't debug the problem directly.
Here it is. :)
(okay the code is ridiculously useless, but: [1] everything works fine via DoxyWizard; [2] "Extract Documentation" detects the doxyfile, and... nothing happens.)
Thanks again :)
EDIT: Gawd...
I just downloaded my (own) zip, extracted it on my desktop (in a new folder, just to test it...), and __NOW__ Ctrl Alt E works... confusing and embarrassing ><
Maybe it only works if my project is on C:, then... (yes, I forgot to say I work in a "data" partition (D:), and my OS+programs are in C:)
EDIT2: Ooookay. Now I extracted the same project in another folder on my D: partition, and DoxyBlocks doesn't extract anything at all.
Temporary conclusion: The "Ctrl + Alt + E" / "DoxyBlocks > Extract Documentation" feature does only work if your project is located on the same partition than... C::B, or Doxygen, I don't know. Maybe it only works in C:, strictly.
I won't transfer my project on C:, because we have good reasons to separate user data from system & programs, but at least I "know" what does precisely not work.
Thank you for your clues on it. Shall I (we?) do a bug report ?
If so, where should we post it ? :x
Hm, do you have spaces or other special characters in the path on D:?
Unfortunately this sounds like a windows issue and I'm running linux, so I can't help.
You'll have to wait for a windows dev to come up and try to reproduce it and try to fix it.
Or you can try to find the reason yourself, by compiling C::B and using a debugger to debug it :)
The project was under a "Mes Documents" (yes, I'm french :3) folder, and when I managed to have it in a path without spaces, DoxyBlocks worked fine.
So you're right, special characters prevent DoxyBlocks from generating docs (but it can still "read" the doxyfile, strangely).
EDIT: I finally managed to rename "Mes Documents" to "Mes_Documents" and everything works fine now :)
Thanks for the help, anyway :D
(I think I'll explain the "bug" on the DoxyBlocks thread later)(and try to find the bug origin after finishing the school project I'm working on)
OK, I was able to reproduce the problem on linux, too.
I'll see if I can get it fixed.
But there is another problem, the doxygen config file is unusable on linux, because the INPUT variable is specified using windows directory separators '\' instead of '/'.
Can you try to replace '\' with '/' in the paths and try to run doxygen on windows to see if it works?
Anyone willing to test if this patch works: http://cmpt.benbmp.org/codeblocks/patches/doxyblocks.path.spaces.patch ?
Wow, you're fast :-X
I placed '/' instead of '\' in all my input paths and file locations, and the extraction still works fine on Windows. (and the output is still coherent and conform, including cross-reference links etc.)
Also, I don't really know how (if possible) to patch a C::B plugin on Windows... (but I'm searching, so if I succeed I'll give feedback about your patch :) )
In svn and will be available in the next night build.