Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

How to document Ruby code using Doxygen?

Question: How can I document Ruby code using Doxygen?

Disclaimer: I know ruby already has a system for documentation built in and there are probably other ways to do it as well, but the specific constraint I am operating under is how to get Doxygen to do the job (assuming it is possible).

like image 666
dreftymac Avatar asked Jun 29 '09 18:06

dreftymac


People also ask

How do I comment out a code in doxygen C++?

Once specified, you can generate the comment stub by typing the respective “///” or “/**” above a function, or by using the (Ctrl+/) shortcut.

What is @brief in doxygen?

Putting the command @brief will generate a short description of the function when you generate the doxygen documentation. That short description can be extended if you want.

How do I create a doxygen comment?

To create a Doxygen comment from scratch: Type one of the following symbols: /// , //! , /** or /*! and press Enter .


1 Answers

Short answer, no. Long answer, still no. Doxygen will come to Ruby eventually, but I don't have the sense that it's going to happen any time soon. In the short term, you're stuck with either RDoc or YARD.

like image 194
Pesto Avatar answered Sep 18 '22 13:09

Pesto