Developer forums (C::B DEVELOPMENT STRICTLY!) > Development
SDK Reference Manual
rickg22:
Wow, it's FANTASTIC! :D This file should be included in the SDK releases!
mandrav:
Very nice work, takeshimiya :D
Yiannis.
takeshimiya:
I'm glad all of you liked it :)
Now, for the improving part:
I've found these bugs:
Current bugs of DoxyS
-----------------------------------------
- Doesn't support text formatting on brief descriptions (not very important).
- The function parameter documentation ///< works well on .h but not on .cpp files.
Current bugs of the C::B comments
-----------------------------------------
- For example on cbplugin.h, at the
virtual void BuildModuleMenu() function, the behaviour of DoxyS is always to take
the brief description from the first line (ie. you don't need @brief or \brief),
but if you are used to, it's better to put the cmd @brief then.
- Also always remember to put /// instead of // to document the code, for
example not like on "compiler.h" at the struct RegExStruct.
- Also try to remember when documenting variables in structs or classes:
int m_iMemberVarShortDoc; ///< Short single line documentation
instead of
int m_iMemberVarShortDoc; // Short single line documentation
- Documenting what is not documented =)
-----------------------------------------
I would like to fix the "C::B comment bugs" but I don't have CVS access (I never used CVS).
Anyways some are easy to fix (most of them are a replace from // to ///),
So Yiannis or rickg22, who do you recommend to fix them?
mandrav:
I will do this. I 'm gradually adding documentation to as-yet-undocumented base SDK classes anyway.
Yiannis.
takeshimiya:
Great :), then the only thing left are the examples and hand-written text.
rickg22 or anyone that knows well how the SDK works, when you find the time, try to make some examples (either in cpp/h very commented or in a plain txt), and some explanation of basic things (like a quick start).
Well, I think that's all to have a helpful sdk manual. =)
Navigation
[0] Message Index
[#] Next page
[*] Previous page
Go to full version