Skip to content

Commit dad6596

Browse files
author
Walzer
committed
issue #171, add @brief in class annotate
1 parent 742baf4 commit dad6596

36 files changed

+120
-121
lines changed

cocos2dx/include/CCAtlasNode.h

+1-1
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ THE SOFTWARE.
3232
namespace cocos2d {
3333
class CCTextureAtlas;
3434

35-
/** CCAtlasNode is a subclass of CCNode that implements the CCRGBAProtocol and
35+
/** @brief CCAtlasNode is a subclass of CCNode that implements the CCRGBAProtocol and
3636
CCTextureProtocol protocol
3737
3838
It knows how to render a TextureAtlas object.

cocos2dx/include/CCBitmapFontAtlas.h

+2-2
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,7 @@ namespace cocos2d{
6464
kCCBitmapFontAtlasMaxChars = 2048, //256,
6565
};
6666

67-
/** CCBitmapFontConfiguration has parsed configuration of the the .fnt file
67+
/** @brief CCBitmapFontConfiguration has parsed configuration of the the .fnt file
6868
@since v0.8
6969
*/
7070
class CCX_DLL CCBitmapFontConfiguration : public NSObject
@@ -102,7 +102,7 @@ namespace cocos2d{
102102
void purgeKerningDictionary();
103103
};
104104

105-
/** CCBitmapFontAtlas is a subclass of CCSpriteSheet.
105+
/** @brief CCBitmapFontAtlas is a subclass of CCSpriteSheet.
106106
107107
Features:
108108
- Treats each character like a CCSprite. This means that each individual character can be:

cocos2dx/include/CCGrid3DAction.h

+9-9
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ THE SOFTWARE.
2929
namespace cocos2d
3030
{
3131
/**
32-
CCWaves3D action
32+
@brief CCWaves3D action
3333
*/
3434
class CCX_DLL CCWaves3D : public CCGrid3DAction
3535
{
@@ -57,7 +57,7 @@ namespace cocos2d
5757
float m_fAmplitudeRate;
5858
};
5959

60-
/** CCFlipX3D action */
60+
/** @brief CCFlipX3D action */
6161
class CCX_DLL CCFlipX3D : public CCGrid3DAction
6262
{
6363
public:
@@ -72,7 +72,7 @@ namespace cocos2d
7272
static CCFlipX3D* actionWithDuration(ccTime duration);
7373
};
7474

75-
/** CCFlipY3D action */
75+
/** @brief CCFlipY3D action */
7676
class CCX_DLL CCFlipY3D : public CCFlipX3D
7777
{
7878
public:
@@ -84,7 +84,7 @@ namespace cocos2d
8484
static CCFlipY3D* actionWithDuration(ccTime duration);
8585
};
8686

87-
/** CCLens3D action */
87+
/** @brief CCLens3D action */
8888
class CCX_DLL CCLens3D : public CCGrid3DAction
8989
{
9090
public:
@@ -110,7 +110,7 @@ namespace cocos2d
110110
CGPoint m_lastPosition;
111111
};
112112

113-
/** CCRipple3D action */
113+
/** @brief CCRipple3D action */
114114
class CCX_DLL CCRipple3D : public CCGrid3DAction
115115
{
116116
public:
@@ -142,7 +142,7 @@ namespace cocos2d
142142
float m_fAmplitudeRate;
143143
};
144144

145-
/** CCShaky3D action */
145+
/** @brief CCShaky3D action */
146146
class CCX_DLL CCShaky3D : public CCGrid3DAction
147147
{
148148
public:
@@ -160,7 +160,7 @@ namespace cocos2d
160160
bool m_bShakeZ;
161161
};
162162

163-
/** CCLiquid action */
163+
/** @brief CCLiquid action */
164164
class CCX_DLL CCLiquid : public CCGrid3DAction
165165
{
166166
public:
@@ -186,7 +186,7 @@ namespace cocos2d
186186
float m_fAmplitudeRate;
187187
};
188188

189-
/** CCWaves action */
189+
/** @brief CCWaves action */
190190
class CCX_DLL CCWaves : public CCGrid3DAction
191191
{
192192
public:
@@ -215,7 +215,7 @@ namespace cocos2d
215215
bool m_bHorizontal;
216216
};
217217

218-
/** CCTwirl action */
218+
/** @brief CCTwirl action */
219219
class CCX_DLL CCTwirl : public CCGrid3DAction
220220
{
221221
public:

cocos2dx/include/CCGridAction.h

+5-5
Original file line numberDiff line numberDiff line change
@@ -92,7 +92,7 @@ namespace cocos2d
9292
static CCTiledGrid3DAction* actionWithSize(ccGridSize gridSize, ccTime duration);
9393
};
9494

95-
/** CCAccelDeccelAmplitude action */
95+
/** @brief CCAccelDeccelAmplitude action */
9696
class CCX_DLL CCAccelDeccelAmplitude : public CCIntervalAction
9797
{
9898
public:
@@ -117,7 +117,7 @@ namespace cocos2d
117117
CCIntervalAction *m_pOther;
118118
};
119119

120-
/** CCAccelAmplitude action */
120+
/** @brief CCAccelAmplitude action */
121121
class CCX_DLL CCAccelAmplitude : public CCIntervalAction
122122
{
123123
public:
@@ -142,7 +142,7 @@ namespace cocos2d
142142
CCIntervalAction *m_pOther;
143143
};
144144

145-
/** CCDeccelAmplitude action */
145+
/** @brief CCDeccelAmplitude action */
146146
class CCX_DLL CCDeccelAmplitude : public CCIntervalAction
147147
{
148148
public:
@@ -167,7 +167,7 @@ namespace cocos2d
167167
CCIntervalAction *m_pOther;
168168
};
169169

170-
/** CCStopGrid action.
170+
/** @brief CCStopGrid action.
171171
@warning Don't call this action if another grid action is active.
172172
Call if you want to remove the the grid effect. Example:
173173
CCSequence::actions(Lens::action(...), CCStopGrid::action(...), NULL);
@@ -182,7 +182,7 @@ namespace cocos2d
182182
static CCStopGrid* action(void);
183183
};
184184

185-
/** CCReuseGrid action */
185+
/** @brief CCReuseGrid action */
186186
class CCX_DLL CCReuseGrid : public CCInstantAction
187187
{
188188
public:

cocos2dx/include/CCInstantAction.h

+1-1
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ namespace cocos2d {
4848
virtual CCFiniteTimeAction * reverse(void);
4949
};
5050

51-
/** Show the node
51+
/** @brief Show the node
5252
*/
5353
class CCX_DLL CCShow : public CCInstantAction
5454
{

cocos2dx/include/CCLabel.h

+1-1
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ THE SOFTWARE.
2828

2929
namespace cocos2d{
3030

31-
/** CCLabel is a subclass of CCTextureNode that knows how to render text labels
31+
/** @brief CCLabel is a subclass of CCTextureNode that knows how to render text labels
3232
*
3333
* All features from CCTextureNode are valid in CCLabel
3434
*

cocos2dx/include/CCLabelAtlas.h

+1-1
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ THE SOFTWARE.
2626
#include "CCAtlasNode.h"
2727
namespace cocos2d{
2828

29-
/** CCLabelAtlas is a subclass of CCAtlasNode.
29+
/** @brief CCLabelAtlas is a subclass of CCAtlasNode.
3030
3131
It can be as a replacement of CCLabel since it is MUCH faster.
3232

cocos2dx/include/CCLayer.h

+4-4
Original file line numberDiff line numberDiff line change
@@ -35,13 +35,13 @@ namespace cocos2d {
3535
//
3636
// CCLayer
3737
//
38-
/** CCLayer is a subclass of CCNode that implements the TouchEventsDelegate protocol.
38+
/** @brief CCLayer is a subclass of CCNode that implements the TouchEventsDelegate protocol.
3939
4040
All features from CCNode are valid, plus the following new features:
4141
- It can receive iPhone Touches
4242
- It can receive Accelerometer input
4343
*/
44-
/// @todo public UIAccelerometerDelegate
44+
// @todo public UIAccelerometerDelegate
4545
class CCX_DLL CCLayer : public CCNode, public CCTouchDelegate//, public UIAccelerometerDelegate
4646
{
4747
public:
@@ -84,7 +84,7 @@ class CCX_DLL CCLayer : public CCNode, public CCTouchDelegate//, public UIAccele
8484
//
8585
// CCColorLayer
8686
//
87-
/** CCColorLayer is a subclass of CCLayer that implements the CCRGBAProtocol protocol.
87+
/** @brief CCColorLayer is a subclass of CCLayer that implements the CCRGBAProtocol protocol.
8888
8989
All features from CCLayer are valid, plus the following new features:
9090
- opacity
@@ -136,7 +136,7 @@ private :
136136
void updateColor();
137137
};
138138

139-
/** CCMultipleLayer is a CCLayer with the ability to multiplex it's children.
139+
/** @brief CCMultipleLayer is a CCLayer with the ability to multiplex it's children.
140140
Features:
141141
- It supports one or more children
142142
- Only one children will be active a time

cocos2dx/include/CCMenu.h

+1-1
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ namespace cocos2d{
3535
kMenuStateTrackingTouch
3636
} MenuState;
3737

38-
/** A CCMenu
38+
/** @brief A CCMenu
3939
*
4040
* Features and Limitation:
4141
* - You can add MenuItem objects in runtime using addChild:

cocos2dx/include/CCMenuItem.h

+7-7
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ namespace cocos2d{
3737

3838
#define kItemSize 32
3939

40-
/** CCMenuItem base class
40+
/** @brief CCMenuItem base class
4141
*
4242
* Subclass CCMenuItem (or any subclass) to create your custom CCMenuItem objects.
4343
*/
@@ -70,7 +70,7 @@ namespace cocos2d{
7070
SEL_MunuHandler m_pfnSelector;
7171
};
7272

73-
/** An abstract class for "label" CCMenuItemLabel items
73+
/** @brief An abstract class for "label" CCMenuItemLabel items
7474
Any CCNode that supports the CCLabelProtocol protocol can be added.
7575
Supported nodes:
7676
- CCBitmapFontAtlas
@@ -114,7 +114,7 @@ namespace cocos2d{
114114
float m_fOriginalScale;
115115
};
116116

117-
/** A CCMenuItemAtlasFont
117+
/** @brief A CCMenuItemAtlasFont
118118
Helper class that creates a MenuItemLabel class with a LabelAtlas
119119
*/
120120
class CCX_DLL CCMenuItemAtlasFont : public CCMenuItemLabel
@@ -130,7 +130,7 @@ namespace cocos2d{
130130
bool initFromString(const char *value, const char *charMapFile, int itemWidth, int itemHeight, char startCharMap, SelectorProtocol* target, SEL_MunuHandler selector);
131131
};
132132

133-
/** A CCMenuItemFont
133+
/** @brief A CCMenuItemFont
134134
Helper class that creates a CCMenuItemLabel class with a Label
135135
*/
136136
class CCX_DLL CCMenuItemFont : public CCMenuItemLabel
@@ -154,7 +154,7 @@ namespace cocos2d{
154154
bool initFromString(const char *value, SelectorProtocol* target, SEL_MunuHandler selector);
155155
};
156156

157-
/** CCMenuItemSprite accepts CCNode<CCRGBAProtocol> objects as items.
157+
/** @brief CCMenuItemSprite accepts CCNode<CCRGBAProtocol> objects as items.
158158
The images has 3 different states:
159159
- unselected image
160160
- selected image
@@ -195,7 +195,7 @@ namespace cocos2d{
195195
virtual CCRGBAProtocol* convertToRGBAProtocol() { return (CCRGBAProtocol*)this; }
196196
};
197197

198-
/** CCMenuItemImage accepts images as items.
198+
/** @brief CCMenuItemImage accepts images as items.
199199
The images has 3 different states:
200200
- unselected image
201201
- selected image
@@ -225,7 +225,7 @@ namespace cocos2d{
225225
virtual GLubyte getOpacity();
226226
};
227227

228-
/** A CCMenuItemToggle
228+
/** @brief A CCMenuItemToggle
229229
A simple container class that "toggles" it's inner items
230230
The inner itmes can be any MenuItem
231231
*/

cocos2dx/include/CCMotionStreak.h

+1-1
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ THE SOFTWARE.
2828
namespace cocos2d {
2929
class CCRibbon;
3030
/**
31-
* CCMotionStreak manages a Ribbon based on it's motion in absolute space.
31+
* @brief CCMotionStreak manages a Ribbon based on it's motion in absolute space.
3232
* You construct it with a fadeTime, minimum segment size, texture path, texture
3333
* length and color. The fadeTime controls how long it takes each vertex in
3434
* the streak to fade out, the minimum segment size it how many pixels the

cocos2dx/include/CCNode.h

+1-1
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ enum {
4848
kCCNodeTagInvalid = -1,
4949
};
5050

51-
/** CCNode is the main element. Anything thats gets drawn or contains things that get drawn is a CCNode.
51+
/** @brief CCNode is the main element. Anything thats gets drawn or contains things that get drawn is a CCNode.
5252
The most popular CCNodes are: CCScene, CCLayer, CCSprite, CCMenu.
5353
5454
The main features of a CCNode are:

cocos2dx/include/CCParallaxNode.h

+1-1
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ THE SOFTWARE.
3030
namespace cocos2d {
3131
struct _ccArray;
3232

33-
/** CCParallaxNode: A node that simulates a parallax scroller
33+
/** @brief CCParallaxNode: A node that simulates a parallax scroller
3434
3535
The children will be moved faster / slower than the parent according the the parallax ratio.
3636

0 commit comments

Comments
 (0)