[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#291405: additional justification - doxytag deprecated



An additional justification for my original request is that the
doxytag utility is listed as deprecated by the doxygen docs.

Furthermore, if we're speaking about doxygen, here's an
entry from http://www.stack.nl/~dimitri/doxygen/faq.html,
ending with a request from the Doxygen author for a database
of the STL `dummy' classes. If you consider fulfilling
the present wishlist bug and include the proper tags pointing
to the real docs, the doxygen author will likely be interested 
to know about it.

	Doxygen is unware of the STL classes, so it does not know that class A
	relates to class B in the following example

	#include <vector>

	using namespace std;

	class B {};

	class A 
	{
	  public:
		vector<B> m_bvec;
	};

	To overcome this problem you could provide the definition of the vector
	class to doxygen (by including the file that defines it at the INPUT tag in
	the config file). Since STL header files are often messy, a (possibly)
	better approach is to include a dummy definition of a vector class to the
	input. Here is an example of a dummy STL file for the vector class:

	namespace std {
	  /*! STL vector class */
	  template<class T> class vector { public: T element; };
	}

	I'm still looking for someone who can provide me with definitions for all
	(relevant) STL classes.



Reply to: