Skip to content

Commit c7a0292

Browse files
author
Alessio Linares
committed
added a bit of documentation
1 parent 72e82d9 commit c7a0292

17 files changed

+78
-4
lines changed

Core.h

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,4 +15,14 @@
1515
#include "Core/Transform.h"
1616
#include "Core/Vector2d.h"
1717
#include "Core/Vector3d.h"
18-
#endif
18+
#endif
19+
20+
/**
21+
* \defgroup core Hummingbird Core
22+
* \brief Core classes of the Hummingbird Framework.
23+
*/
24+
/**
25+
* \defgroup core-components Components
26+
* \brief Function and Data component
27+
* \ingroup core
28+
*/

Core/Clock.h

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,6 @@
55

66
namespace hb
77
{
8-
//! A class for measuring time intervals
98
class Clock
109
{
1110
public:
@@ -27,3 +26,10 @@ namespace hb
2726
};
2827
}
2928
#endif
29+
30+
/**
31+
* \class hb::Clock
32+
* \ingroup core
33+
*
34+
* A class for measuring time intervals
35+
*/

Core/Color.h

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,3 +33,10 @@ namespace hb
3333
}
3434

3535
#endif
36+
37+
/**
38+
* \struct hb::Color
39+
* \ingroup core
40+
*
41+
* Struct representing a color RGBA of floats [0, 1]
42+
*/

Core/DataComponent.h

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,10 @@
44

55
namespace hb
66
{
7+
/*!
8+
\class DataComponent
9+
\ingroup core-components
10+
*/
711
template <typename T>
812
class DataComponent : public GameObject::Component
913
{

Core/DataRepository.h

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,10 @@
55

66
namespace hb
77
{
8+
/*!
9+
\class DataRepository
10+
\ingroup core
11+
*/
812
class DataRepository
913
{
1014
public:

Core/FunctionComponent.h

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,10 @@
66

77
namespace hb
88
{
9+
/*!
10+
\class FunctionComponent
11+
\ingroup core-components
12+
*/
913
class FunctionComponent : public GameObject::Component
1014
{
1115
public:

Core/Game.h

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,10 @@
1111

1212
namespace hb
1313
{
14+
/*!
15+
\class Game
16+
\ingroup core
17+
*/
1418
class Game
1519
{
1620
public:

Core/GameObject.cpp

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,7 @@ m_marked_to_destroy(false)
7272
}
7373

7474

75-
GameObject::GameObject(const std::initializer_list<GameObject::Component*>& components):
75+
GameObject::GameObject(const std::initializer_list<Component*>& components):
7676
GameObject()
7777
{
7878
for (Component* c : components)

Core/GameObject.h

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,10 @@
1212

1313
namespace hb
1414
{
15+
/*!
16+
\class GameObject
17+
\ingroup core
18+
*/
1519
class GameObject : public Transform
1620
{
1721
public:

Core/Makefile

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ OBJ := $(addprefix ./,$(SOURCES:./%.cpp=%.o))
1212
all: $(OBJ)
1313

1414
%.o: %.cpp
15-
$(CC) -c -o $@ $< $(CFLAGS) -O3
15+
$(CC) -c -o $@ $< $(CFLAGS)
1616
ar rvs $(STATIC_LIB_NAME).a $@
1717

1818
.PHONY: clean

Core/Plugin.h

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,10 @@
66

77
namespace hb
88
{
9+
/*!
10+
\class Plugin
11+
\ingroup core
12+
*/
913
class Plugin
1014
{
1115
public:

Core/Resource.h

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,10 @@
44

55
namespace hb
66
{
7+
/*!
8+
\class Resource
9+
\ingroup core
10+
*/
711
template <typename ResourceType, typename ResourceId, typename ResourceManager>
812
class Resource
913
{

Core/ResourceManager.h

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,10 @@
55

66
namespace hb
77
{
8+
/*!
9+
\class ResourceManager
10+
\ingroup core
11+
*/
812
template <typename ManagerType, typename Resource, typename ResourceId, typename Hash = std::hash<ResourceId>>
913
class ResourceManager
1014
{

Core/Time.h

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,10 @@
33

44
namespace hb
55
{
6+
/*!
7+
\class Time
8+
\ingroup core
9+
*/
610
class Time
711
{
812
public:

Core/Transform.h

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,10 @@
44

55
namespace hb
66
{
7+
/*!
8+
\class Transform
9+
\ingroup core
10+
*/
711
class Transform
812
{
913
public:

Core/Vector2d.h

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,3 +57,10 @@ hb::Vector2d& operator /=(hb::Vector2d& left, double right);
5757
bool operator ==(const hb::Vector2d& left, const hb::Vector2d& right);
5858
bool operator !=(const hb::Vector2d& left, const hb::Vector2d& right);
5959
#endif
60+
61+
/**
62+
* \class hb::Vector2d
63+
* \ingroup core
64+
*
65+
* A 2d vector of doubles
66+
*/

Core/Vector3d.h

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,10 @@
77

88
namespace hb
99
{
10+
/*!
11+
\class Vector3d
12+
\ingroup core
13+
*/
1014
class Vector3d
1115
{
1216
public:

0 commit comments

Comments
 (0)