Is the Atmel Studio 7 Doxygen feature broken?

Go To Last Post
7 posts / 0 new
Author
Message
#1
  • 1
  • 2
  • 3
  • 4
  • 5
Total votes: 0

I have Doxygen on my computer, it works fine, I have followed the instructions in the Atmel START User Guide.

Generate Doxygen output

 

Some projects contains documenation formatted for Doxygen.

 

Note: Doxygen must be installed, download from http://www.doxygen.org. You will be asked to configure Studio to locate Doxygen executable, this defaults to C:\Program Files\doxygen\bin\doxygen.exe

 

Click on the Doxygen button to generate documentationDoxygen will run and the generated documentation will open in a window.

 

Tip: The generated files can be fount uder the folder doxygen/generator/html and doxygen/generator/xml. These are not added to the project. There is a seperate Doxygen extension for Studio that can be used if more control is needed. It can be found here https://gallery.atmel.com

I highlight a file in my project that has Doxygen snippets and click on the Doxygen button and nothing happens!  No window opens, and I cannot find the folder referenced by Tip: anywhere on my computer.  This behavior is the same whether or not the separate Doxygen extension is installed or not.

 

Is there something else I am supposed to do to get this to work?

"I may make you feel but I can't make you think" - Jethro Tull - Thick As A Brick

"void transmigratus(void) {transmigratus();} // recursio infinitus" - larryvc

"It's much more practical to rely on the processing powers of the real debugger, i.e. the one between the keyboard and chair." - JW wek3

"When you arise in the morning think of what a privilege it is to be alive: to breathe, to think, to enjoy, to love." -  Marcus Aurelius

Last Edited: Thu. Mar 22, 2018 - 06:48 PM
  • 1
  • 2
  • 3
  • 4
  • 5
Total votes: 0

I just ran Doxygen from Project->Doygen...  on a LUFA example project and it worked fine.  Versions below:

 

Greg Muth

Portland, OR, US

Xplained/Pro/Mini Boards mostly

 

Make Xmega Great Again!

 

  • 1
  • 2
  • 3
  • 4
  • 5
Total votes: 0

That is definitely using the separate Doxygen extension, and has a different location in options to set up the pointer to Doxygen.exe.   Also, if the extension is not loaded then the Tools->Options->Documentation-Doxgen Settings section doesn't even exist.  Thanks for the workaround.

 

​Here we definitely have apples and oranges.

 

Could you try it as I did by clicking on the Doxygen Icon in the Solution Explorer toolbar as the START User Guide instructs.  Supposedly the pointer to Doxygen.exe first needs to be set up in Tools->Options->Atmel Start->Doxygen.

 

I am sure you will find it is broken too.  Have a feeling all the budget has been allocated to getting MPLAB X up and running for AVR and SAM, far too many bugs to count for AS7 at this point.

 

 

@Microchip, It would be to your benefit to at least remove the non-working instructions in the START User Guide and perhaps link the Doxygen Icon in the Solution Explorer toolbar to the same object as Project->Doxygen...

"I may make you feel but I can't make you think" - Jethro Tull - Thick As A Brick

"void transmigratus(void) {transmigratus();} // recursio infinitus" - larryvc

"It's much more practical to rely on the processing powers of the real debugger, i.e. the one between the keyboard and chair." - JW wek3

"When you arise in the morning think of what a privilege it is to be alive: to breathe, to think, to enjoy, to love." -  Marcus Aurelius

Last Edited: Fri. Mar 23, 2018 - 05:14 AM
  • 1
  • 2
  • 3
  • 4
  • 5
Total votes: 0

@larryvc wrote:

Could you try it as I did by clicking on the Doxygen Icon in the Solution Explorer

I did and nothing happened.  I noticed the Doxygen button is disabled when I select the project, but active if I select the solution, Dependencies, Output Files, or Library. 

 

 

Greg Muth

Portland, OR, US

Xplained/Pro/Mini Boards mostly

 

Make Xmega Great Again!

 

  • 1
  • 2
  • 3
  • 4
  • 5
Total votes: 0

Greg_Muth wrote:
I did and nothing happened.  I noticed the Doxygen button is disabled when I select the project, but active if I select the solution, Dependencies, Output Files, or Library.

It appears like there was some effort to integrate the Doxygen extension directly into AS7 but at some point that work got side tracked and they left it half completed.  Odd that they would actually put instructions in the Atmel START User Guide though so perhaps it is broken.

 

Frustrating to say the least.

"I may make you feel but I can't make you think" - Jethro Tull - Thick As A Brick

"void transmigratus(void) {transmigratus();} // recursio infinitus" - larryvc

"It's much more practical to rely on the processing powers of the real debugger, i.e. the one between the keyboard and chair." - JW wek3

"When you arise in the morning think of what a privilege it is to be alive: to breathe, to think, to enjoy, to love." -  Marcus Aurelius

Last Edited: Fri. Mar 23, 2018 - 04:48 PM
  • 1
  • 2
  • 3
  • 4
  • 5
Total votes: 0

Have you raised a support ticket to ask for clarification about this?

  • 1
  • 2
  • 3
  • 4
  • 5
Total votes: 0

clawson wrote:

Have you raised a support ticket to ask for clarification about this?

Not yet, but I will later today.  Was hoping that either Jacob, Charles, or Morten, might take notice of the thread first.

"I may make you feel but I can't make you think" - Jethro Tull - Thick As A Brick

"void transmigratus(void) {transmigratus();} // recursio infinitus" - larryvc

"It's much more practical to rely on the processing powers of the real debugger, i.e. the one between the keyboard and chair." - JW wek3

"When you arise in the morning think of what a privilege it is to be alive: to breathe, to think, to enjoy, to love." -  Marcus Aurelius