Merge branch 'master' of https://github.com/DigitalPulseSoftware/NazaraEngine

Former-commit-id: 3878bde4d067ef921783f256b582af8f6463c19b [formerly 029a8e9081b66daf20a78ba7331a496d89145f44]
Former-commit-id: 47009b49149da0186169afc538618f2ab2973f89

include/Nazara/Audio/Algorithm.inl

@@ -7,11 +7,21 @@
 
 namespace Nz
 {
+	/*!
+	* \ingroup audio
+	* \brief Mixes channels in mono
+	*
+	* \param input Input buffer with multiples channels
+	* \param output Output butter for mono
+	* \param channelCount Number of channels
+	* \param frameCount Number of frames
+	*
+	* \remark The input buffer may be the same as the output one
+	*/
 	template<typename T>
 	void MixToMono(T* input, T* output, unsigned int channelCount, unsigned int frameCount)
 	{
-		///DOC: Le buffer d'entrée peut être le même que le buffer de sortie
-		// Pour éviter l'overflow, on utilise comme accumulateur un type assez grand, (u)int 64 bits pour les entiers, double pour les flottants
+		// To avoid overflow, we use, as an accumulator, a type which is large enough: (u)int 64 bits for integers, double for floatings
 		typedef typename std::conditional<std::is_unsigned<T>::value, UInt64, Int64>::type BiggestInt;
 		typedef typename std::conditional<std::is_integral<T>::value, BiggestInt, double>::type Biggest;
 
@@ -19,7 +29,7 @@ namespace Nz
 		{
 			Biggest acc = Biggest(0);
 			for (unsigned int j = 0; j < channelCount; ++j)
-				acc += input[i*channelCount + j];
+				acc += input[i * channelCount + j];
 
 			output[i] = static_cast<T>(acc / channelCount);
 		}

include/Nazara/Audio/Config.hpp

@@ -27,18 +27,23 @@
 #ifndef NAZARA_CONFIG_AUDIO_HPP
 #define NAZARA_CONFIG_AUDIO_HPP
 
-/// Modifier la configuration d'un module nécessite une recompilation quasi-intégrale de celui-ci et de ceux en héritant
+/*!
+* \defgroup audio (NazaraAudio) Audio module
+*  Audio/System module including classes to handle music, sound, etc...
+*/
 
-// Utilise un manager de mémoire pour gérer les allocations dynamiques (détecte les leaks au prix d'allocations/libérations dynamiques plus lentes)
+/// Each modification of a parameter needs a recompilation of the module
+
+// Use the MemoryManager to manage dynamic allocations (can detect memory leak but allocations/frees are slower)
 #define NAZARA_AUDIO_MANAGE_MEMORY 0
 
-// Active les tests de sécurité supplémentaires (Teste notamment les arguments des fonctions, conseillé pour le développement)
+// Activate the security tests based on the code (Advised for development)
 #define NAZARA_AUDIO_SAFE 1
 
-// Le nombre de buffers utilisés lors du streaming d'objets audio (Au moins deux)
+// The number of buffers used for audio streaming (At least two)
 #define NAZARA_AUDIO_STREAMED_BUFFER_COUNT 2
 
-/// Vérification des valeurs et types de certaines constantes
+/// Checking the values and types of certain constants
 #include <Nazara/Audio/ConfigCheck.hpp>
 
 #if !defined(NAZARA_STATIC)

include/Nazara/Audio/ConfigCheck.hpp

@@ -7,12 +7,12 @@
 #ifndef NAZARA_CONFIG_CHECK_AUDIO_HPP
 #define NAZARA_CONFIG_CHECK_AUDIO_HPP
 
-/// Ce fichier sert à vérifier la valeur des constantes du fichier Config.hpp
+/// This file is used to check the constant values defined in Config.hpp
 
 #include <type_traits>
 #define NazaraCheckTypeAndVal(name, type, op, val, err) static_assert(std::is_ ##type <decltype(name)>::value && name op val, #type err)
 
-// On force la valeur de MANAGE_MEMORY en mode debug
+// We force the value of MANAGE_MEMORY in debug
 #if defined(NAZARA_DEBUG) && !NAZARA_AUDIO_MANAGE_MEMORY
 	#undef NAZARA_AUDIO_MANAGE_MEMORY
 	#define NAZARA_AUDIO_MANAGE_MEMORY 0

include/Nazara/Audio/DebugOff.hpp

@@ -2,7 +2,7 @@
 // This file is part of the "Nazara Engine - Audio module"
 // For conditions of distribution and use, see copyright notice in Config.hpp
 
-// On suppose que Debug.hpp a déjà été inclus, tout comme Config.hpp
+// We assume that Debug.hpp has already been included, same thing for Config.hpp
 #if NAZARA_AUDIO_MANAGE_MEMORY
 	#undef delete
 	#undef new

include/Nazara/Audio/Enums.hpp

@@ -13,7 +13,7 @@ namespace Nz
 	{
 		AudioFormat_Unknown = -1,
 
-		// La valeur entière est le nombre de canaux possédés par ce format
+		// The integer value is the number of channels used by the format
 		AudioFormat_Mono   = 1,
 		AudioFormat_Stereo = 2,
 		AudioFormat_Quad   = 4,

include/Nazara/Audio/OpenAL.hpp

@@ -15,18 +15,18 @@
 #include <Nazara/Core/String.hpp>
 #include <vector>
 
-// Inclusion des headers OpenAL
+// Inclusion of OpenAL headers
 
-// Étant donné que les headers OpenAL ne nous permettent pas de n'avoir que les signatures sans les pointeurs de fonctions
-// Et que je ne souhaite pas les modifier, je suis contraint de les placer dans un espace de nom différent pour ensuite
-// remettre dans l'espace global les choses intéressantes (les typedef notamment)
+// OpenAL headers does not allow us to only get the signatures without the pointers to the functions
+// And I do no want to modify them, I'm obliged to put them in a different namespace
+// to put only interesting things back in the global namespace (specially typedef)
 namespace OpenALDetail
 {
 	#include <AL/al.h>
 	#include <AL/alc.h>
 }
 
-// Si quelqu'un a une meilleure idée ...
+// If someone has a better idea ...
 using OpenALDetail::ALboolean;
 using OpenALDetail::ALbyte;
 using OpenALDetail::ALchar;

include/Nazara/Audio/SoundBuffer.inl

@@ -7,6 +7,13 @@
 
 namespace Nz
 {
+	/*!
+	* \brief Creates a new sound buffer from the arguments
+	* \return A reference to the newly created sound buffer
+	*
+	* \param args Arguments for the sound buffer
+	*/
+
 	template<typename... Args>
 	SoundBufferRef SoundBuffer::New(Args&&... args)
 	{

include/Nazara/Audio/SoundEmitter.hpp

@@ -12,7 +12,7 @@
 #include <Nazara/Audio/Enums.hpp>
 #include <Nazara/Math/Vector3.hpp>
 
-///TODO: Faire hériter SoundEmitter de Node
+///TODO: Inherit SoundEmitter from Node
 
 namespace Nz
 {

include/Nazara/Core/Algorithm.inl

@@ -78,7 +78,7 @@ namespace Nz
 	* \param v Object to hash
 	*
 	* \remark a HashAppend specialization for type T is required
-	*
+	* 
 	* \see ComputeHash
 	*/
 	template<typename T>

include/Nazara/Core/ConfigCheck.hpp

@@ -12,7 +12,7 @@
 #include <type_traits>
 #define NazaraCheckTypeAndVal(name, type, op, val, err) static_assert(std::is_ ##type <decltype(name)>::value && name op val, #type err)
 
-// We fore the value of MANAGE_MEMORY in debug
+// We force the value of MANAGE_MEMORY in debug
 #if defined(NAZARA_DEBUG) && !NAZARA_CORE_MANAGE_MEMORY
 	#undef NAZARA_CORE_MANAGE_MEMORY
 	#define NAZARA_CORE_MANAGE_MEMORY 0

include/Nazara/Core/HandledObject.inl

@@ -10,6 +10,17 @@
 
 namespace Nz
 {
+	/*!
+	* \ingroup core
+	* \class Nz::HandledObject<T>
+	* \brief Core class that represents a handled object
+	*/
+
+	/*!
+	* \brief Constructs a HandledObject object by assignation
+	*
+	* \param object HandledObject to assign into this
+	*/
 	template<typename T>
 	HandledObject<T>::HandledObject(const HandledObject& object)
 	{
@@ -17,6 +28,11 @@ namespace Nz
 		// Don't copy anything, we're a copy of the object, we have no handle right now
 	}
 
+	/*!
+	* \brief Constructs a HandledObject object by move semantic
+	*
+	* \param object HandledObject to move into this
+	*/
 	template<typename T>
 	HandledObject<T>::HandledObject(HandledObject&& object) :
 	m_handles(std::move(object.m_handles))
@@ -25,25 +41,46 @@ namespace Nz
 			handle->OnObjectMoved(static_cast<T*>(this));
 	}
 
+	/*!
+	* \brief Destructs the object and calls UnregisterAllHandles
+	*
+	* \see UnregisterAllHandles
+	*/
 	template<typename T>
 	HandledObject<T>::~HandledObject()
 	{
 		UnregisterAllHandles();
 	}
 
+	/*!
+	* \brief Creates a ObjectHandle for this
+	* \return ObjectHandle to this
+	*/
 	template<typename T>
 	ObjectHandle<T> HandledObject<T>::CreateHandle()
 	{
 		return ObjectHandle<T>(static_cast<T*>(this));
 	}
 
+	/*!
+	* \brief Sets the reference of the HandledObject with the handle from another
+	* \return A reference to this
+	*
+	* \param object The other HandledObject
+	*/
 	template<typename T>
 	HandledObject<T>& HandledObject<T>::operator=(const HandledObject& object)
 	{
 		// Nothing to do
-		return *this;
+		return *this; 
 	}
 
+	/*!
+	* \brief Moves the HandledObject into this
+	* \return A reference to this
+	*
+	* \param object HandledObject to move in this
+	*/
 	template<typename T>
 	HandledObject<T>& HandledObject<T>::operator=(HandledObject&& object)
 	{
@@ -54,13 +91,22 @@ namespace Nz
 		return *this;
 	}
 
+	/*!
+	* \brief Registers a handle
+	*
+	* \param handle Handle to register
+	*
+	* \remark One handle can only be registered once, errors can occur if it's more than once
+	*/
 	template<typename T>
 	void HandledObject<T>::RegisterHandle(ObjectHandle<T>* handle)
 	{
-		///DOC: Un handle ne doit être enregistré qu'une fois, des erreurs se produisent s'il l'est plus d'une fois
 		m_handles.push_back(handle);
 	}
 
+	/*!
+	* \brief Unregisters all handles
+	*/
 	template<typename T>
 	void HandledObject<T>::UnregisterAllHandles()
 	{
@@ -71,10 +117,17 @@ namespace Nz
 		m_handles.clear();
 	}
 
+	/*!
+	* \brief Unregisters a handle
+	*
+	* \param handle Handle to unregister
+	*
+	* \remark One handle can only be unregistered once, crash can occur if it's more than once
+	* \remark Produces a NazaraAssert if handle not registered
+	*/
 	template<typename T>
 	void HandledObject<T>::UnregisterHandle(ObjectHandle<T>* handle) noexcept
 	{
-		///DOC: Un handle ne doit être libéré qu'une fois, et doit faire partie de la liste, sous peine de crash
 		auto it = std::find(m_handles.begin(), m_handles.end(), handle);
 		NazaraAssert(it != m_handles.end(), "Handle not registered");
 
@@ -83,6 +136,14 @@ namespace Nz
 		m_handles.pop_back();
 	}
 
+	/*!
+	* \brief Updates one handle with another
+	*
+	* \param oldHandle Old handle to replace
+	* \param newHandle New handle to take place
+	*
+	* \remark Produces a NazaraAssert if handle not registered
+	*/
 	template<typename T>
 	void HandledObject<T>::UpdateHandle(ObjectHandle<T>* oldHandle, ObjectHandle<T>* newHandle) noexcept
 	{

include/Nazara/Core/ObjectHandle.inl

@@ -9,12 +9,26 @@
 
 namespace Nz
 {
+	/*!
+	* \ingroup core
+	* \class Nz::ObjectHandle
+	* \brief Core class that represents a object handle
+	*/
+
+	/*!
+	* \brief Constructs a ObjectHandle object by default
+	*/
 	template<typename T>
 	ObjectHandle<T>::ObjectHandle() :
 	m_object(nullptr)
 	{
 	}
 
+	/*!
+	* \brief Constructs a ObjectHandle object with a pointer to an object
+	*
+	* \param object Pointer to handle like an object (can be nullptr)
+	*/
 	template<typename T>
 	ObjectHandle<T>::ObjectHandle(T* object) :
 	ObjectHandle()
@@ -22,59 +36,97 @@ namespace Nz
 		Reset(object);
 	}
 
+	/*!
+	* \brief Constructs a ObjectHandle object by assignation
+	*
+	* \param handle ObjectHandle to assign into this
+	*/
 	template<typename T>
-	ObjectHandle<T>::ObjectHandle(const ObjectHandle<T>& handle) :
+	ObjectHandle<T>::ObjectHandle(const ObjectHandle& handle) :
 	ObjectHandle()
 	{
 		Reset(handle);
 	}
 
+	/*!
+	* \brief Constructs a ObjectHandle object by move semantic
+	*
+	* \param handle ObjectHandle to move into this
+	*/
 	template<typename T>
-	ObjectHandle<T>::ObjectHandle(ObjectHandle<T>&& handle) noexcept :
+	ObjectHandle<T>::ObjectHandle(ObjectHandle&& handle) noexcept :
 	ObjectHandle()
 	{
 		Reset(std::move(handle));
 	}
 
+	/*!
+	* \brief Destructs the object and calls reset with nullptr
+	*
+	* \see Reset
+	*/
 	template<typename T>
 	ObjectHandle<T>::~ObjectHandle()
 	{
 		Reset(nullptr);
 	}
 
+	/*!
+	* \brief Gets the underlying object
+	* \return Underlying object
+	*/
 	template<typename T>
 	T* ObjectHandle<T>::GetObject() const
 	{
 		return m_object;
 	}
 
+	/*!
+	* \brief Checks whether the object is valid
+	* \return true if object is not nullptr
+	*/
 	template<typename T>
 	bool ObjectHandle<T>::IsValid() const
 	{
 		return m_object != nullptr;
 	}
 
+	/*!
+	* \brief Resets the content of the ObjectHandle with another object
+	*
+	* \param object Object to handle
+	*/
 	template<typename T>
 	void ObjectHandle<T>::Reset(T* object)
 	{
-		// Si nous avions déjà une entité, nous devons l'informer que nous ne pointons plus sur elle
+		// If we already have an entity, we must alert it that we are not pointing to it anymore
 		if (m_object)
 			m_object->UnregisterHandle(this);
 
 		m_object = object;
 		if (m_object)
-			// On informe la nouvelle entité que nous pointons sur elle
+			// We alert the new entity that we are pointing to it
 			m_object->RegisterHandle(this);
 	}
 
+	/*!
+	* \brief Resets the content of this with another object
+	*
+	* \param handle New object to handle
+	*/
 	template<typename T>
-	void ObjectHandle<T>::Reset(const ObjectHandle<T>& handle)
+	void ObjectHandle<T>::Reset(const ObjectHandle& handle)
 	{
 		Reset(handle.GetObject());
 	}
 
+	/*!
+	* \brief Resets the content of this with another object by move semantic
+	*
+	* \param handle New object to handle to move into this
+	*/
 	template<typename T>
-	void ObjectHandle<T>::Reset(ObjectHandle<T>&& handle) noexcept
+	void ObjectHandle<T>::Reset(ObjectHandle&& handle) noexcept
 	{
 		if (m_object)
 			m_object->UnregisterHandle(this);
@@ -87,12 +139,18 @@ namespace Nz
 		}
 	}
 
+	/*!
+	* \brief Swaps the content of the two ObjectHandle
+	* \return A reference to this
+	*
+	* \param handle ObjectHandle to swap
+	*/
 	template<typename T>
-	ObjectHandle<T>& ObjectHandle<T>::Swap(ObjectHandle<T>& handle)
+	ObjectHandle<T>& ObjectHandle<T>::Swap(ObjectHandle& handle)
 	{
-		// Comme nous inversons les handles, nous devons prévenir les entités
-		// La version par défaut de swap (à base de move) aurait fonctionné,
-		// mais en enregistrant les handles une fois de plus que nécessaire (à cause de la copie temporaire).
+		// As we swap the two handles, we must alert the entities
+		// The default version with swap (move) would be working,
+		// but will register handles one more time (due to temporary copy).
 		if (m_object)
 		{
 			m_object->UnregisterHandle(this);
@@ -105,11 +163,15 @@ namespace Nz
 			handle.m_object->RegisterHandle(this);
 		}
 
-		// On effectue l'échange
+		// We do the swap
 		std::swap(m_object, handle.m_object);
 		return *this;
 	}
 
+	/*!
+	* \brief Gives a string representation
+	* \return A string representation of the object "ObjectHandle(object representation) or Null"
+	*/
 	template<typename T>
 	Nz::String ObjectHandle<T>::ToString() const
 	{
@@ -125,24 +187,44 @@ namespace Nz
 		return ss;
 	}
 
+	/*!
+	* \brief Converts the ObjectHandle to bool
+	* \return true if reference is not nullptr
+	*
+	* \see IsValid
+	*/
 	template<typename T>
 	ObjectHandle<T>::operator bool() const
 	{
 		return IsValid();
 	}
 
+	/*!
+	* \brief Dereferences the ObjectHandle
+	* \return Underlying pointer
+	*/
 	template<typename T>
 	ObjectHandle<T>::operator T*() const
 	{
 		return m_object;
 	}
 
+	/*!
+	* \brief Dereferences the ObjectHandle
+	* \return Underlying pointer
+	*/
 	template<typename T>
 	T* ObjectHandle<T>::operator->() const
 	{
 		return m_object;
 	}
 
+	/*!
+	* \brief Assigns the entity into this
+	* \return A reference to this
+	*
+	* \param entity Pointer to handle like an object (can be nullptr)
+	*/
 	template<typename T>
 	ObjectHandle<T>& ObjectHandle<T>::operator=(T* entity)
 	{
@@ -151,22 +233,37 @@ namespace Nz
 		return *this;
 	}
 
+	/*!
+	* \brief Sets the handle of the ObjectHandle with the handle from another
+	* \return A reference to this
+	*
+	* \param handle The other ObjectHandle
+	*/
 	template<typename T>
-	ObjectHandle<T>& ObjectHandle<T>::operator=(const ObjectHandle<T>& handle)
+	ObjectHandle<T>& ObjectHandle<T>::operator=(const ObjectHandle& handle)
 	{
 		Reset(handle);
 
 		return *this;
 	}
 
+	/*!
+	* \brief Moves the ObjectHandle into this
+	* \return A reference to this
+	*
+	* \param handle ObjectHandle to move in this
+	*/
 	template<typename T>
-	ObjectHandle<T>& ObjectHandle<T>::operator=(ObjectHandle<T>&& handle) noexcept
+	ObjectHandle<T>& ObjectHandle<T>::operator=(ObjectHandle&& handle) noexcept
 	{
 		Reset(std::move(handle));
 
 		return *this;
 	}
 
+	/*!
+	* \brief Action to do on object destruction
+	*/
 	template<typename T>
 	void ObjectHandle<T>::OnObjectDestroyed()
 	{
@@ -174,6 +271,9 @@ namespace Nz
 		m_object = nullptr;
 	}
 
+	/*!
+	* \brief Action to do on object move
+	*/
 	template<typename T>
 	void ObjectHandle<T>::OnObjectMoved(T* newObject)
 	{
@@ -181,114 +281,247 @@ namespace Nz
 		m_object = newObject;
 	}
 
+	/*!
+	* \brief Output operator
+	* \return The stream
+	*
+	* \param out The stream
+	* \param handle The ObjectHandle to output
+	*/
 	template<typename T>
 	std::ostream& operator<<(std::ostream& out, const ObjectHandle<T>& handle)
 	{
 		return handle.ToString();
 	}
 
+	/*!
+	* \brief Checks whether the first object handle is equal to the second object handle
+	* \return true if it is the case
+	*
+	* \param first ObjectHandle to compare in left hand side
+	* \param second ObjectHandle to compare in right hand side
+	*/
 	template<typename T>
 	bool operator==(const ObjectHandle<T>& lhs, const ObjectHandle<T>& rhs)
 	{
 		return lhs.GetObject() == rhs.GetObject();
 	}
 
+	/*!
+	* \brief Checks whether the object is equal to the second object handle
+	* \return true if it is the case
+	*
+	* \param first Object to compare in left hand side
+	* \param second ObjectHandle to compare in right hand side
+	*/
 	template<typename T>
 	bool operator==(const T& lhs, const ObjectHandle<T>& rhs)
 	{
 		return &lhs == rhs.GetObject();
 	}
 
+	/*!
+	* \brief Checks whether the object handle is equal to the second object
+	* \return true if it is the case
+	*
+	* \param first ObjectHandle to compare in left hand side
+	* \param second Object to compare in right hand side
+	*/
 	template<typename T>
 	bool operator==(const ObjectHandle<T>& lhs, const T& rhs)
 	{
 		return lhs.GetObject() == &rhs;
 	}
 
+	/*!
+	* \brief Checks whether the first object handle is equal to the second object handle
+	* \return false if it is the case
+	*
+	* \param first ObjectHandle to compare in left hand side
+	* \param second ObjectHandle to compare in right hand side
+	*/
 	template<typename T>
 	bool operator!=(const ObjectHandle<T>& lhs, const ObjectHandle<T>& rhs)
 	{
 		return !(lhs == rhs);
 	}
 
+	/*!
+	* \brief Checks whether the object is equal to the second object handle
+	* \return false if it is the case
+	*
+	* \param first Object to compare in left hand side
+	* \param second ObjectHandle to compare in right hand side
+	*/
 	template<typename T>
 	bool operator!=(const T& lhs, const ObjectHandle<T>& rhs)
 	{
 		return !(lhs == rhs);
 	}
 
+	/*!
+	* \brief Checks whether the object handle is equal to the second object
+	* \return false if it is the case
+	*
+	* \param first ObjectHandle to compare in left hand side
+	* \param second Object to compare in right hand side
+	*/
 	template<typename T>
 	bool operator!=(const ObjectHandle<T>& lhs, const T& rhs)
 	{
 		return !(lhs == rhs);
 	}
 
+	/*!
+	* \brief Checks whether the first object handle is less than the second object handle
+	* \return true if it is the case
+	*
+	* \param first ObjectHandle to compare in left hand side
+	* \param second ObjectHandle to compare in right hand side
+	*/
 	template<typename T>
 	bool operator<(const ObjectHandle<T>& lhs, const ObjectHandle<T>& rhs)
 	{
 		return lhs.m_object < rhs.m_object;
 	}
 
+	/*!
+	* \brief Checks whether the first object handle is less than the second object handle
+	* \return true if it is the case
+	*
+	* \param first ObjectHandle to compare in left hand side
+	* \param second ObjectHandle to compare in right hand side
+	*/
 	template<typename T>
 	bool operator<(const T& lhs, const ObjectHandle<T>& rhs)
 	{
 		return &lhs < rhs.m_object;
 	}
 
+	/*!
+	* \brief Checks whether the first object handle is less than the second object handle
+	* \return true if it is the case
+	*
+	* \param first ObjectHandle to compare in left hand side
+	* \param second ObjectHandle to compare in right hand side
+	*/
 	template<typename T>
 	bool operator<(const ObjectHandle<T>& lhs, const T& rhs)
 	{
 		return lhs.m_object < &rhs;
 	}
 
+	/*!
+	* \brief Checks whether the first object handle is less or equal than the second object handle
+	* \return true if it is the case
+	*
+	* \param first ObjectHandle to compare in left hand side
+	* \param second ObjectHandle to compare in right hand side
+	*/
 	template<typename T>
 	bool operator<=(const ObjectHandle<T>& lhs, const ObjectHandle<T>& rhs)
 	{
 		return !(lhs > rhs);
 	}
 
+	/*!
+	* \brief Checks whether the first object handle is less or equal than the second object handle
+	* \return true if it is the case
+	*
+	* \param first ObjectHandle to compare in left hand side
+	* \param second ObjectHandle to compare in right hand side
+	*/
 	template<typename T>
 	bool operator<=(const T& lhs, const ObjectHandle<T>& rhs)
 	{
 		return !(lhs > rhs);
 	}
 
+	/*!
+	* \brief Checks whether the first object handle is less or equal than the second object handle
+	* \return true if it is the case
+	*
+	* \param first ObjectHandle to compare in left hand side
+	* \param second ObjectHandle to compare in right hand side
+	*/
 	template<typename T>
 	bool operator<=(const ObjectHandle<T>& lhs, const T& rhs)
 	{
 		return !(lhs > rhs);
 	}
 
+	/*!
+	* \brief Checks whether the first object handle is greather than the second object handle
+	* \return true if it is the case
+	*
+	* \param first ObjectHandle to compare in left hand side
+	* \param second ObjectHandle to compare in right hand side
+	*/
 	template<typename T>
 	bool operator>(const ObjectHandle<T>& lhs, const ObjectHandle<T>& rhs)
 	{
 		return rhs < lhs;
 	}
 
+	/*!
+	* \brief Checks whether the first object handle is greather than the second object handle
+	* \return true if it is the case
+	*
+	* \param first ObjectHandle to compare in left hand side
+	* \param second ObjectHandle to compare in right hand side
+	*/
 	template<typename T>
 	bool operator>(const T& lhs, const ObjectHandle<T>& rhs)
 	{
 		return rhs < lhs;
 	}
 
+	/*!
+	* \brief Checks whether the first object handle is greather than the second object handle
+	* \return true if it is the case
+	*
+	* \param first ObjectHandle to compare in left hand side
+	* \param second ObjectHandle to compare in right hand side
+	*/
 	template<typename T>
 	bool operator>(const ObjectHandle<T>& lhs, const T& rhs)
 	{
 		return rhs < lhs;
 	}
 
+	/*!
+	* \brief Checks whether the first object handle is greather or equal than the second object handle
+	* \return true if it is the case
+	*
+	* \param first ObjectHandle to compare in left hand side
+	* \param second ObjectHandle to compare in right hand side
+	*/
 	template<typename T>
 	bool operator>=(const ObjectHandle<T>& lhs, const ObjectHandle<T>& rhs)
 	{
 		return !(lhs < rhs);
 	}
 
+	/*!
+	* \brief Checks whether the first object handle is greather or equal than the second object handle
+	* \return true if it is the case
+	*
+	* \param first ObjectHandle to compare in left hand side
+	* \param second ObjectHandle to compare in right hand side
+	*/
 	template<typename T>
 	bool operator>=(const T& lhs, const ObjectHandle<T>& rhs)
 	{
 		return !(lhs < rhs);
 	}
 
+	/*!
+	* \brief Checks whether the first object handle is greather or equal than the second object handle
+	* \return true if it is the case
+	*
+	* \param first ObjectHandle to compare in left hand side
+	* \param second ObjectHandle to compare in right hand side
+	*/
 	template<typename T>
 	bool operator>=(const ObjectHandle<T>& lhs, const T& rhs)
 	{
@@ -301,6 +534,12 @@ namespace Nz
 
 namespace std
 {
+	/*!
+	* \brief Swaps two ObjectHandle, specialisation of std
+	*
+	* \param lhs First object handle
+	* \param rhs Second object handle
+	*/
 	template<typename T>
 	void swap(Nz::ObjectHandle<T>& lhs, Nz::ObjectHandle<T>& rhs)
 	{

include/Nazara/Core/ParameterList.hpp

@@ -50,6 +50,8 @@ namespace Nz
 			void SetParameter(const String& name, void* value);
 			void SetParameter(const String& name, void* value, Destructor destructor);
 
+			String ToString() const;
+
 			ParameterList& operator=(const ParameterList& list);
 			ParameterList& operator=(ParameterList&&) = default;
 
@@ -73,7 +75,7 @@ namespace Nz
 				ParameterType type;
 				union Value
 				{
-					// On définit un constructeur/destructeur vide, permettant de mettre des classes dans l'union
+					// We define an empty constructor/destructor, to be able to put classes in the union
 					Value() {}
 					Value(const Value&) {} // Placeholder
 					~Value() {}
@@ -98,4 +100,6 @@ namespace Nz
 	};
 }
 
+std::ostream& operator<<(std::ostream& out, const Nz::ParameterList& parameterList);
+
 #endif // NAZARA_PARAMETERLIST_HPP

include/Nazara/Core/ResourceLoader.inl

@@ -66,7 +66,7 @@ namespace Nz
 			return false;
 		}
 
-		File file(path); // Ouvert seulement en cas de besoin
+		File file(path); // Open only if needed
 
 		bool found = false;
 		for (Loader& loader : Type::s_loaders)

include/Nazara/Graphics/Billboard.inl

@@ -7,6 +7,10 @@
 
 namespace Nz
 {
+	/*!
+	* \brief Constructs a Billboard object by default
+	*/
+
 	inline Billboard::Billboard()
 	{
 		SetColor(Color::White);
@@ -15,6 +19,12 @@ namespace Nz
 		SetSize(64.f, 64.f);
 	}
 
+	/*!
+	* \brief Constructs a Billboard object with a reference to a material
+	*
+	* \param material Reference to a material
+	*/
+
 	inline Billboard::Billboard(MaterialRef material)
 	{
 		SetColor(Color::White);
@@ -23,6 +33,12 @@ namespace Nz
 		SetSize(64.f, 64.f);
 	}
 
+	/*!
+	* \brief Constructs a Billboard object with a pointer to a texture
+	*
+	* \param texture Pointer to a texture
+	*/
+
 	inline Billboard::Billboard(Texture* texture)
 	{
 		SetColor(Color::White);
@@ -31,6 +47,12 @@ namespace Nz
 		SetTexture(texture, true);
 	}
 
+	/*!
+	* \brief Constructs a Billboard object by assignation
+	*
+	* \param billboard Billboard to copy into this
+	*/
+
 	inline Billboard::Billboard(const Billboard& billboard) :
 	InstancedRenderable(billboard),
 	m_color(billboard.m_color),
@@ -41,31 +63,61 @@ namespace Nz
 	{
 	}
 
+	/*!
+	* \brief Gets the color of the billboard
+	* \return Current color
+	*/
+
 	inline const Color& Billboard::GetColor() const
 	{
 		return m_color;
 	}
 
+	/*!
+	* \brief Gets the material of the billboard
+	* \return Current material
+	*/
+
 	inline const MaterialRef& Billboard::GetMaterial() const
 	{
 		return m_material;
 	}
 
+	/*!
+	* \brief Gets the rotation of the billboard
+	* \return Current rotation
+	*/
+
 	inline float Billboard::GetRotation() const
 	{
 		return m_rotation;
 	}
 
+	/*!
+	* \brief Gets the size of the billboard
+	* \return Current size
+	*/
+
 	inline const Vector2f& Billboard::GetSize() const
 	{
 		return m_size;
 	}
 
+	/*!
+	* \brief Sets the color of the billboard
+	*
+	* \param color Color for the billboard
+	*/
+
 	inline void Billboard::SetColor(const Color& color)
 	{
 		m_color = color;
 	}
 
+	/*!
+	* \brief Sets the default material of the billboard (just default material)
+	*/
+
 	inline void Billboard::SetDefaultMaterial()
 	{
 		MaterialRef material = Material::New();
@@ -75,6 +127,13 @@ namespace Nz
 		SetMaterial(std::move(material));
 	}
 
+	/*!
+	* \brief Sets the material of the billboard
+	*
+	* \param material Material for the billboard
+	* \param resizeBillboard Should billboard be resized to the material size (diffuse map)
+	*/
+
 	inline void Billboard::SetMaterial(MaterialRef material, bool resizeBillboard)
 	{
 		m_material = std::move(material);
@@ -86,25 +145,51 @@ namespace Nz
 		}
 	}
 
+	/*!
+	* \brief Sets the rotation of the billboard
+	*
+	* \param rotation Rotation for the billboard
+	*/
+
 	inline void Billboard::SetRotation(float rotation)
 	{
 		m_rotation = rotation;
 		m_sinCos.Set(std::sin(m_rotation), std::cos(m_rotation));
 	}
 
+	/*!
+	* \brief Sets the size of the billboard
+	*
+	* \param size Size for the billboard
+	*/
+
 	inline void Billboard::SetSize(const Vector2f& size)
 	{
 		m_size = size;
 
-		// On invalide la bounding box
+		// We invalidate the bounding volume
 		InvalidateBoundingVolume();
 	}
 
+	/*!
+	* \brief Sets the size of the billboard
+	*
+	* \param sizeX Size in X for the billboard
+	* \param sizeY Size in Y for the billboard
+	*/
+
 	inline void Billboard::SetSize(float sizeX, float sizeY)
 	{
 		SetSize(Vector2f(sizeX, sizeY));
 	}
 
+	/*!
+	* \brief Sets the texture of the billboard
+	*
+	* \param texture Texture for the billboard
+	* \param resizeBillboard Should billboard be resized to the texture size
+	*/
+
 	inline void Billboard::SetTexture(TextureRef texture, bool resizeBillboard)
 	{
 		if (!m_material)
@@ -118,6 +203,13 @@ namespace Nz
 		m_material->SetDiffuseMap(std::move(texture));
 	}
 
+	/*!
+	* \brief Sets the current billboard with the content of the other one
+	* \return A reference to this
+	*
+	* \param billboard The other Billboard
+	*/
+
 	inline Billboard& Billboard::operator=(const Billboard& billboard)
 	{
 		InstancedRenderable::operator=(billboard);
@@ -131,6 +223,13 @@ namespace Nz
 		return *this;
 	}
 
+	/*!
+	* \brief Creates a new billboard from the arguments
+	* \return A reference to the newly created billboard
+	*
+	* \param args Arguments for the billboard
+	*/
+
 	template<typename... Args>
 	BillboardRef Billboard::New(Args&&... args)
 	{

include/Nazara/Graphics/ColorBackground.inl

@@ -7,6 +7,13 @@
 
 namespace Nz
 {
+	/*!
+	* \brief Creates a new color background from the arguments
+	* \return A reference to the newly created color background
+	*
+	* \param args Arguments for the color background
+	*/
+
 	template<typename... Args>
 	ColorBackgroundRef ColorBackground::New(Args&&... args)
 	{

include/Nazara/Graphics/Config.hpp

@@ -27,23 +27,28 @@
 #ifndef NAZARA_CONFIG_GRAPHICS_HPP
 #define NAZARA_CONFIG_GRAPHICS_HPP
 
-/// Chaque modification d'un paramètre du module nécessite une recompilation de celui-ci
+/*!
+* \defgroup graphics (NazaraGraphics) Graphics module
+*  Graphics/System module including classes to handle graphical elements...
+*/
 
-// À partir de combien d'instances d'un même mesh/matériau l'instancing doit-il être utilisé ?
+/// Each modification of a paramater of the module needs a recompilation of the unit
+
+// How much instances are need of a same mesh/material to enable instancing ?
 #define NAZARA_GRAPHICS_INSTANCING_MIN_INSTANCES_COUNT 10
 
-// Utilise un manager de mémoire pour gérer les allocations dynamiques (détecte les leaks au prix d'allocations/libérations dynamiques plus lentes)
+// Use the MemoryManager to manage dynamic allocations (can detect memory leak but allocations/frees are slower)
 #define NAZARA_GRAPHICS_MANAGE_MEMORY 0
 
-// Active les tests de sécurité basés sur le code (Conseillé pour le développement)
+// Activate the security tests based on the code (Advised for development)
 #define NAZARA_GRAPHICS_SAFE 1
 
-/// Chaque modification d'un paramètre ci-dessous implique une modification (souvent mineure) du code
+/// Each modification of a parameter following implies a modification (often minor) of the code
 
-// Le nombre maximum de lumières qu'un shader standard supportera
+// The maximum number of lights in a standard shader
 #define NAZARA_GRAPHICS_MAX_LIGHT_PER_PASS 3
 
-/// Vérification des valeurs et types de certaines constantes
+/// Checking the values and types of certain constants
 #include <Nazara/Graphics/ConfigCheck.hpp>
 
 #if defined(NAZARA_STATIC)

include/Nazara/Graphics/ConfigCheck.hpp

@@ -7,12 +7,12 @@
 #ifndef NAZARA_CONFIG_CHECK_GRAPHICS_HPP
 #define NAZARA_CONFIG_CHECK_GRAPHICS_HPP
 
-/// Ce fichier sert à vérifier la valeur des constantes du fichier Config.hpp
+/// This file is used to check the constant values defined in Config.hpp
 
 #include <type_traits>
 #define NazaraCheckTypeAndVal(name, type, op, val, err) static_assert(std::is_ ##type <decltype(name)>::value && name op val, #type err)
 
-// On force la valeur de MANAGE_MEMORY en mode debug
+// We fore the value of MANAGE_MEMORY in debug
 #if defined(NAZARA_DEBUG) && !NAZARA_GRAPHICS_MANAGE_MEMORY
 	#undef NAZARA_GRAPHICS_MANAGE_MEMORY
 	#define NAZARA_GRAPHICS_MANAGE_MEMORY 0

include/Nazara/Graphics/DebugOff.hpp

@@ -2,7 +2,7 @@
 // This file is part of the "Nazara Engine - Graphics module"
 // For conditions of distribution and use, see copyright notice in Config.hpp
 
-// On suppose que Debug.hpp a déjà été inclus, tout comme Config.hpp
+// We suppose that Debug.hpp is already included, same goes for Config.hpp
 #if NAZARA_GRAPHICS_MANAGE_MEMORY
 	#undef delete
 	#undef new

include/Nazara/Graphics/DeferredBloomPass.hpp

@@ -29,7 +29,7 @@ namespace Nz
 			float GetBrightThreshold() const;
 			Texture* GetTexture(unsigned int i) const;
 
-			bool Process(const SceneData& sceneData, unsigned int firstWorkTexture, unsigned secondWorkTexture) const;
+			bool Process(const SceneData& sceneData, unsigned int firstWorkTexture, unsigned int secondWorkTexture) const;
 			bool Resize(const Vector2ui& dimensions);
 
 			void SetBlurPassCount(unsigned int passCount);

include/Nazara/Graphics/DeferredDOFPass.hpp

@@ -23,7 +23,7 @@ namespace Nz
 			DeferredDOFPass();
 			virtual ~DeferredDOFPass();
 
-			bool Process(const SceneData& sceneData, unsigned int firstWorkTexture, unsigned secondWorkTexture) const;
+			bool Process(const SceneData& sceneData, unsigned int firstWorkTexture, unsigned int secondWorkTexture) const;
 			bool Resize(const Vector2ui& dimensions);
 
 		protected:

include/Nazara/Graphics/DeferredFXAAPass.hpp

@@ -21,7 +21,7 @@ namespace Nz
 			DeferredFXAAPass();
 			virtual ~DeferredFXAAPass();
 
-			bool Process(const SceneData& sceneData, unsigned int firstWorkTexture, unsigned secondWorkTexture) const;
+			bool Process(const SceneData& sceneData, unsigned int firstWorkTexture, unsigned int secondWorkTexture) const;
 
 		protected:
 			RenderStates m_states;

include/Nazara/Graphics/DeferredFinalPass.hpp

@@ -21,7 +21,7 @@ namespace Nz
 			DeferredFinalPass();
 			virtual ~DeferredFinalPass();
 
-			bool Process(const SceneData& sceneData, unsigned int firstWorkTexture, unsigned secondWorkTexture) const;
+			bool Process(const SceneData& sceneData, unsigned int firstWorkTexture, unsigned int secondWorkTexture) const;
 
 		protected:
 			RenderStates m_states;

include/Nazara/Graphics/DeferredFogPass.hpp

@@ -21,7 +21,7 @@ namespace Nz
 			DeferredFogPass();
 			virtual ~DeferredFogPass();
 
-			bool Process(const SceneData& sceneData, unsigned int firstWorkTexture, unsigned secondWorkTexture) const;
+			bool Process(const SceneData& sceneData, unsigned int firstWorkTexture, unsigned int secondWorkTexture) const;
 
 		protected:
 			RenderStates m_states;

include/Nazara/Graphics/DeferredForwardPass.hpp

@@ -21,7 +21,7 @@ namespace Nz
 			virtual ~DeferredForwardPass();
 
 			void Initialize(DeferredRenderTechnique* technique);
-			bool Process(const SceneData& sceneData, unsigned int workTexture, unsigned sceneTexture) const;
+			bool Process(const SceneData& sceneData, unsigned int workTexture, unsigned int sceneTexture) const;
 
 		protected:
 			const ForwardRenderTechnique* m_forwardTechnique;

include/Nazara/Graphics/DeferredGeometryPass.hpp

@@ -21,7 +21,7 @@ namespace Nz
 			DeferredGeometryPass();
 			virtual ~DeferredGeometryPass();
 
-			bool Process(const SceneData& sceneData, unsigned int firstWorkTexture, unsigned secondWorkTexture) const;
+			bool Process(const SceneData& sceneData, unsigned int firstWorkTexture, unsigned int secondWorkTexture) const;
 			bool Resize(const Vector2ui& dimensions);
 
 		protected:

include/Nazara/Graphics/DeferredPhongLightingPass.hpp

@@ -28,7 +28,7 @@ namespace Nz
 
 			bool IsLightMeshesDrawingEnabled() const;
 
-			bool Process(const SceneData& sceneData, unsigned int firstWorkTexture, unsigned secondWorkTexture) const;
+			bool Process(const SceneData& sceneData, unsigned int firstWorkTexture, unsigned int secondWorkTexture) const;
 
 		protected:
 			LightUniforms m_directionalLightUniforms;

include/Nazara/Graphics/DeferredRenderPass.hpp

@@ -38,7 +38,7 @@ namespace Nz
 
 			bool IsEnabled() const;
 
-			virtual bool Process(const SceneData& sceneData, unsigned int workTexture, unsigned sceneTexture) const = 0;
+			virtual bool Process(const SceneData& sceneData, unsigned int workTexture, unsigned int sceneTexture) const = 0;
 			virtual bool Resize(const Vector2ui& GBufferSize);
 
 			DeferredRenderPass& operator=(const DeferredRenderPass&) = delete;

include/Nazara/Graphics/DeferredRenderTechnique.hpp

@@ -67,7 +67,7 @@ namespace Nz
 			};
 
 			std::map<RenderPassType, std::map<int, std::unique_ptr<DeferredRenderPass>>, RenderPassComparator> m_passes;
-			ForwardRenderTechnique m_forwardTechnique; // Doit être initialisé avant la RenderQueue
+			ForwardRenderTechnique m_forwardTechnique; // Must be initialized before the RenderQueue
 			DeferredRenderQueue m_renderQueue;
 			mutable RenderBufferRef m_depthStencilBuffer;
 			mutable RenderTexture m_GBufferRTT;

include/Nazara/Graphics/DepthRenderQueue.inl

@@ -6,6 +6,14 @@
 
 namespace Nz
 {
+
+	/*!
+	* \brief Checks whether the material is suitable to fit in the render queue
+	* \return true If it is the case
+	*
+	* \param material Material to verify
+	*/
+
 	bool DepthRenderQueue::IsMaterialSuitable(const Material* material) const
 	{
 		NazaraAssert(material, "Invalid material");

include/Nazara/Graphics/Enums.hpp

@@ -128,7 +128,7 @@ namespace Nz
 		SceneNodeType_Max = SceneNodeType_User
 	};
 
-	// Ces paramètres sont indépendants du matériau: ils peuvent être demandés à tout moment
+	// These parameters are independant of the material: they can not be asked for the moment
 	enum ShaderFlags
 	{
 		ShaderFlags_None = 0,
@@ -139,7 +139,7 @@ namespace Nz
 		ShaderFlags_TextureOverlay = 0x08,
 		ShaderFlags_VertexColor    = 0x10,
 
-		ShaderFlags_Max = ShaderFlags_VertexColor*2-1
+		ShaderFlags_Max = ShaderFlags_VertexColor * 2 - 1
 	};
 }
 

include/Nazara/Graphics/ForwardRenderQueue.hpp

@@ -159,6 +159,7 @@ namespace Nz
 			std::map<int, Layer> layers;
 
 		private:
+			BillboardData* GetBillboardData(int renderOrder, const Material* material, unsigned int count);
 			Layer& GetLayer(int i); ///TODO: Inline
 
 			void OnIndexBufferInvalidation(const IndexBuffer* indexBuffer);

include/Nazara/Graphics/ForwardRenderTechnique.hpp

@@ -31,7 +31,7 @@ namespace Nz
 			AbstractRenderQueue* GetRenderQueue() override;
 			RenderTechniqueType GetType() const override;
 
-			void SetMaxLightPassPerObject(unsigned int passCount);
+			void SetMaxLightPassPerObject(unsigned int maxLightPassPerObject);
 
 			static bool Initialize();
 			static void Uninitialize();
@@ -70,11 +70,11 @@ namespace Nz
 				LightUniforms lightUniforms;
 				bool hasLightUniforms;
 
-				/// Moins coûteux en mémoire que de stocker un LightUniforms par index de lumière,
-				/// à voir si ça fonctionne chez tout le monde
-				int lightOffset; // "Distance" entre Lights[0].type et Lights[1].type
+				/// Less costly in memory than storing a LightUniforms by index of light,
+				/// this may not work everywhere
+				int lightOffset; // "Distance" between Lights[0].type and Lights[1].type
 
-				// Autre uniformes
+				// Other uniforms
 				int eyePosition;
 				int sceneAmbient;
 				int textureOverlay;

include/Nazara/Graphics/ForwardRenderTechnique.inl

@@ -6,6 +6,16 @@
 
 namespace Nz
 {
+	/*!
+	* \brief Sens the uniforms for light
+	*
+	* \param shader Shader to send uniforms to
+	* \param uniforms Uniforms to send
+	* \param index Index of the light
+	* \param uniformOffset Offset for the uniform
+	* \param availableTextureUnit Unit texture available
+	*/
+
 	inline void ForwardRenderTechnique::SendLightUniforms(const Shader* shader, const LightUniforms& uniforms, unsigned int index, unsigned int uniformOffset, UInt8 availableTextureUnit) const
 	{
 		// If anyone got a better idea..
@@ -104,6 +114,14 @@ namespace Nz
 		}
 	}
 
+	/*!
+	* \brief Computes the score for directional light
+	* \return 0.f
+	*
+	* \param object Sphere symbolising the object
+	* \param light Light to compute
+	*/
+
 	inline float ForwardRenderTechnique::ComputeDirectionalLightScore(const Spheref& object, const AbstractRenderQueue::DirectionalLight& light)
 	{
 		NazaraUnused(object);
@@ -113,18 +131,42 @@ namespace Nz
 		return 0.f;
 	}
 
+	/*!
+	* \brief Computes the score for point light
+	* \return Distance to the light
+	*
+	* \param object Sphere symbolising the object
+	* \param light Light to compute
+	*/
+
 	inline float ForwardRenderTechnique::ComputePointLightScore(const Spheref& object, const AbstractRenderQueue::PointLight& light)
 	{
 		///TODO: Compute a score depending on the light luminosity
 		return object.SquaredDistance(light.position);
 	}
 
+	/*!
+	* \brief Computes the score for spot light
+	* \return Distance to the light
+	*
+	* \param object Sphere symbolising the object
+	* \param light Light to compute
+	*/
+
 	inline float ForwardRenderTechnique::ComputeSpotLightScore(const Spheref& object, const AbstractRenderQueue::SpotLight& light)
 	{
 		///TODO: Compute a score depending on the light luminosity and spot direction
 		return object.SquaredDistance(light.position);
 	}
 
+	/*!
+	* \brief Checks whether the directional light is suitable for the computations
+	* \return true if light is enoughly close
+	*
+	* \param object Sphere symbolising the object
+	* \param light Light to compute
+	*/
+
 	inline bool ForwardRenderTechnique::IsDirectionalLightSuitable(const Spheref& object, const AbstractRenderQueue::DirectionalLight& light)
 	{
 		NazaraUnused(object);
@@ -134,12 +176,28 @@ namespace Nz
 		return true;
 	}
 
+	/*!
+	* \brief Checks whether the point light is suitable for the computations
+	* \return true if light is enoughly close
+	*
+	* \param object Sphere symbolising the object
+	* \param light Light to compute
+	*/
+
 	inline bool ForwardRenderTechnique::IsPointLightSuitable(const Spheref& object, const AbstractRenderQueue::PointLight& light)
 	{
 		// If the object is too far away from this point light, there is not way it could light it
 		return object.SquaredDistance(light.position) <= light.radius * light.radius;
 	}
 
+	/*!
+	* \brief Checks whether the spot light is suitable for the computations
+	* \return true if light is enoughly close
+	*
+	* \param object Sphere symbolising the object
+	* \param light Light to compute
+	*/
+
 	inline bool ForwardRenderTechnique::IsSpotLightSuitable(const Spheref& object, const AbstractRenderQueue::SpotLight& light)
 	{
 		///TODO: Exclude spot lights based on their direction and outer angle?

include/Nazara/Graphics/InstancedRenderable.inl

@@ -4,6 +4,12 @@
 
 namespace Nz
 {
+	/*!
+	* \brief Constructs a InstancedRenderable object by assignation
+	*
+	* \param renderable InstancedRenderable to copy into this
+	*/
+
 	inline InstancedRenderable::InstancedRenderable(const InstancedRenderable& renderable) :
 	RefCounted(),
 	m_boundingVolume(renderable.m_boundingVolume),
@@ -11,22 +17,43 @@ namespace Nz
 	{
 	}
 
+	/*!
+	* \brief Ensures that the bounding volume is up to date
+	*/
+
 	inline void InstancedRenderable::EnsureBoundingVolumeUpdated() const
 	{
 		if (!m_boundingVolumeUpdated)
 			UpdateBoundingVolume();
 	}
 
+	/*!
+	* \brief Invalidates the bounding volume
+	*/
+
 	inline void InstancedRenderable::InvalidateBoundingVolume()
 	{
 		m_boundingVolumeUpdated = false;
 	}
 
+	/*!
+	* \brief Invalidates the instance data based on flags
+	*
+	* \param flags Flags to invalidate
+	*/
+
 	inline void InstancedRenderable::InvalidateInstanceData(UInt32 flags)
 	{
 		OnInstancedRenderableInvalidateData(this, flags);
 	}
 
+	/*!
+	* \brief Sets the current instanced renderable with the content of the other one
+	* \return A reference to this
+	*
+	* \param renderable The other InstancedRenderable
+	*/
+
 	inline InstancedRenderable& InstancedRenderable::operator=(const InstancedRenderable& renderable)
 	{
 		m_boundingVolume = renderable.m_boundingVolume;
@@ -35,6 +62,10 @@ namespace Nz
 		return *this;
 	}
 
+	/*!
+	* \brief Updates the bounding volume
+	*/
+
 	inline void InstancedRenderable::UpdateBoundingVolume() const
 	{
 		MakeBoundingVolume();

include/Nazara/Graphics/Light.inl

@@ -7,6 +7,10 @@
 
 namespace Nz
 {
+	/*!
+	* \brief Constructs a Light object by default
+	*/
+
 	inline Light::Light(const Light& light) :
 	Renderable(light),
 	m_color(light.m_color),
@@ -28,6 +32,12 @@ namespace Nz
 	{
 	}
 
+	/*!
+	* \brief Enables shadow casting
+	*
+	* \param castShadows Should shadows be cast
+	*/
+
 	inline void Light::EnableShadowCasting(bool castShadows)
 	{
 		if (m_shadowCastingEnabled != castShadows)
@@ -37,72 +47,141 @@ namespace Nz
 		}
 	}
 
+	/*!
+	* \brief Ensures that the shadow map is up to date
+	*/
+
 	inline void Light::EnsureShadowMapUpdate() const
 	{
 		if (!m_shadowMapUpdated)
 			UpdateShadowMap();
 	}
 
+	/*!
+	* \brief Gets the ambient factor
+	* \return Current ambient factor
+	*/
+
 	inline float Light::GetAmbientFactor() const
 	{
 		return m_ambientFactor;
 	}
 
+	/*!
+	* \brief Gets the light attenuation (in 1 / R^2)
+	* \return Attenuation
+	*/
+
 	inline float Light::GetAttenuation() const
 	{
 		return m_attenuation;
 	}
 
+	/*!
+	* \brief Gets the color of the light
+	* \return Light color
+	*/
+
 	inline Color Light::GetColor() const
 	{
 		return m_color;
 	}
 
+	/*!
+	* \brief Gets the diffuse factor
+	* \return Current diffuse factor
+	*/
+
 	inline float Light::GetDiffuseFactor() const
 	{
 		return m_diffuseFactor;
 	}
 
+	/*!
+	* \brief Gets the inner angle in spot light
+	* \return Inner angle
+	*/
+
 	inline float Light::GetInnerAngle() const
 	{
 		return m_innerAngle;
 	}
 
+	/*!
+	* \brief Gets the cosine inner angle in spot light
+	* \return Cosine inner angle
+	*/
+
 	inline float Light::GetInnerAngleCosine() const
 	{
 		return m_innerAngleCosine;
 	}
 
+	/*!
+	* \brief Gets the inverse of the radius
+	* \return Inverse of the radius
+	*/
+
 	inline float Light::GetInvRadius() const
 	{
 		return m_invRadius;
 	}
 
+	/*!
+	* \brief Gets the type of the light
+	* \return Light type
+	*/
+
 	inline LightType Light::GetLightType() const
 	{
 		return m_type;
 	}
 
+	/*!
+	* \brief Gets the outer angle in spot light
+	* \return Outer angle
+	*/
+
 	inline float Light::GetOuterAngle() const
 	{
 		return m_outerAngle;
 	}
 
+	/*!
+	* \brief Gets the cosine outer angle in spot light
+	* \return Cosine outer angle
+	*/
+
 	inline float Light::GetOuterAngleCosine() const
 	{
 		return m_outerAngleCosine;
 	}
 
+	/*!
+	* \brief Gets the tangent outer angle in spot light
+	* \return Tangent outer angle
+	*/
+
 	inline float Light::GetOuterAngleTangent() const
 	{
 		return m_outerAngleTangent;
 	}
 
+	/*!
+	* \brief Gets the radius of the light
+	* \return Light radius
+	*/
+
 	inline float Light::GetRadius() const
 	{
 		return m_radius;
 	}
 
+	/*!
+	* \brief Gets the shadow map
+	* \return Reference to the shadow map texture
+	*/
+
 	inline TextureRef Light::GetShadowMap() const
 	{
 		EnsureShadowMapUpdate();
@@ -110,47 +189,97 @@ namespace Nz
 		return m_shadowMap;
 	}
 
+	/*!
+	* \brief Gets the format of the shadow map
+	* \return Shadow map format
+	*/
+
 	inline PixelFormatType Light::GetShadowMapFormat() const
 	{
 		return m_shadowMapFormat;
 	}
 
+	/*!
+	* \brief Gets the size of the shadow map
+	* \return Shadow map size
+	*/
+
 	inline const Vector2ui& Light::GetShadowMapSize() const
 	{
 		return m_shadowMapSize;
 	}
 
+	/*!
+	* \brief Checks whether the shadow casting is enabled
+	* \return true If it is the case
+	*/
+
 	inline bool Light::IsShadowCastingEnabled() const
 	{
 		return m_shadowCastingEnabled;
 	}
 
+	/*!
+	* \brief Sets the ambient factor
+	*
+	* \param factor Ambient factor
+	*/
+
 	inline void Light::SetAmbientFactor(float factor)
 	{
 		m_ambientFactor = factor;
 	}
 
+	/*!
+	* \brief Sets the light attenuation (in 1 / R^2)
+	*
+	* \param attenuation Light attenuation
+	*/
+
 	inline void Light::SetAttenuation(float attenuation)
 	{
 		m_attenuation = attenuation;
 	}
 
+	/*!
+	* \brief Sets the color of the light
+	*
+	* \param color Light color
+	*/
+
 	inline void Light::SetColor(const Color& color)
 	{
 		m_color = color;
 	}
 
+	/*!
+	* \brief Sets the diffuse factor
+	*
+	* \param factor Diffuse factor
+	*/
+
 	inline void Light::SetDiffuseFactor(float factor)
 	{
 		m_diffuseFactor = factor;
 	}
 
+	/*!
+	* \brief Sets the inner angle in spot light
+	* \return innerAngle Inner angle
+	*/
+
 	inline void Light::SetInnerAngle(float innerAngle)
 	{
 		m_innerAngle = innerAngle;
 		m_innerAngleCosine = std::cos(DegreeToRadian(m_innerAngle));
 	}
 
+	/*!
+	* \brief Sets the type of light
+	*
+	* \param type Light type
+	*/
+
 	inline void Light::SetLightType(LightType type)
 	{
 		m_type = type;
@@ -158,6 +287,13 @@ namespace Nz
 		InvalidateShadowMap();
 	}
 
+	/*!
+	* \brief Sets the outer angle in spot light
+	* \return outerAngle Outer angle
+	*
+	* \remark Invalidates the bounding volume
+	*/
+
 	inline void Light::SetOuterAngle(float outerAngle)
 	{
 		m_outerAngle = outerAngle;
@@ -167,6 +303,13 @@ namespace Nz
 		InvalidateBoundingVolume();
 	}
 
+	/*!
+	* \brief Sets the radius of the light
+	* \return radius Light radius
+	*
+	* \remark Invalidates the bounding volume
+	*/
+
 	inline void Light::SetRadius(float radius)
 	{
 		m_radius = radius;
@@ -176,6 +319,15 @@ namespace Nz
 		InvalidateBoundingVolume();
 	}
 
+	/*!
+	* \brief Sets the shadow map format
+	*
+	* \param shadowFormat Shadow map format
+	*
+	* \remark Invalidates the shadow map
+	* \remark Produces a NazaraAssert if format is not a depth type
+	*/
+
 	inline void Light::SetShadowMapFormat(PixelFormatType shadowFormat)
 	{
 		NazaraAssert(PixelFormat::GetContent(shadowFormat) == PixelFormatContent_DepthStencil, "Shadow format type is not a depth format");
@@ -185,6 +337,15 @@ namespace Nz
 		InvalidateShadowMap();
 	}
 
+	/*!
+	* \brief Sets the size of the shadow map
+	*
+	* \param size Shadow map size
+	*
+	* \remark Invalidates the shadow map
+	* \remark Produces a NazaraAssert if size is zero
+	*/
+
 	inline void Light::SetShadowMapSize(const Vector2ui& size)
 	{
 		NazaraAssert(size.x > 0 && size.y > 0, "Shadow map size must have a positive size");
@@ -194,6 +355,15 @@ namespace Nz
 		InvalidateShadowMap();
 	}
 
+	/*!
+	* \brief Sets the current light with the content of the other one
+	* \return A reference to this
+	*
+	* \param light The other Light
+	*
+	* \remark Invalidates the shadow map
+	*/
+
 	inline Light& Light::operator=(const Light& light)
 	{
 		Renderable::operator=(light);
@@ -218,6 +388,10 @@ namespace Nz
 		return *this;
 	}
 
+	/*!
+	* \brief Invalidates the shadow map
+	*/
+
 	inline void Light::InvalidateShadowMap()
 	{
 		m_shadowMapUpdated = false;

include/Nazara/Graphics/Material.hpp

@@ -151,7 +151,7 @@ namespace Nz
 
 			inline Material& operator=(const Material& material);
 
-			static MaterialRef GetDefault();
+			inline static MaterialRef GetDefault();
 			template<typename... Args> static MaterialRef New(Args&&... args);
 
 			// Signals:
@@ -163,7 +163,7 @@ namespace Nz
 			{
 				const Shader* shader;
 				UberShaderInstance* uberInstance = nullptr;
-				int uniforms[MaterialUniform_Max+1];
+				int uniforms[MaterialUniform_Max + 1];
 			};
 
 			void Copy(const Material& material);
@@ -187,7 +187,7 @@ namespace Nz
 			TextureRef m_normalMap;
 			TextureRef m_specularMap;
 			UberShaderConstRef m_uberShader;
-			mutable ShaderInstance m_shaders[ShaderFlags_Max+1];
+			mutable ShaderInstance m_shaders[ShaderFlags_Max + 1];
 			bool m_alphaTestEnabled;
 			bool m_depthSortingEnabled;
 			bool m_lightingEnabled;

include/Nazara/Graphics/Material.inl

@@ -7,11 +7,21 @@
 
 namespace Nz
 {
+	/*!
+	* \brief Constructs a Material object by default
+	*/
+
 	inline Material::Material()
 	{
 		Reset();
 	}
 
+	/*!
+	* \brief Constructs a Material object by assignation
+	*
+	* \param material Material to copy into this
+	*/
+
 	inline Material::Material(const Material& material) :
 	RefCounted(),
 	Resource(material)
@@ -19,11 +29,26 @@ namespace Nz
 		Copy(material);
 	}
 
+	/*!
+	* \brief Destructs the object and calls OnMaterialRelease
+	*
+	* \see OnMaterialRelease
+	*/
+
 	inline Material::~Material()
 	{
 		OnMaterialRelease(this);
 	}
 
+	/*!
+	* \brief Enables a renderer parameter
+	*
+	* \param renderParameter Parameter for the rendering
+	* \param enable Should the parameter be enabled
+	*
+	* \remark Produces a NazaraAssert if enumeration is invalid
+	*/
+
 	inline void Material::Enable(RendererParameter renderParameter, bool enable)
 	{
 		NazaraAssert(renderParameter <= RendererParameter_Max, "Renderer parameter out of enum");
@@ -31,6 +56,14 @@ namespace Nz
 		m_states.parameters[renderParameter] = enable;
 	}
 
+	/*!
+	* \brief Enables the alpha test
+	*
+	* \param alphaTest Should the parameter be enabled
+	*
+	* \remark Invalidates the shaders
+	*/
+
 	inline void Material::EnableAlphaTest(bool alphaTest)
 	{
 		m_alphaTestEnabled = alphaTest;
@@ -38,12 +71,26 @@ namespace Nz
 		InvalidateShaders();
 	}
 
+	/*!
+	* \brief Enables the depth sorting
+	*
+	* \param depthSorting Should the parameter be enabled
+	*/
+
 	inline void Material::EnableDepthSorting(bool depthSorting)
 	{
 		// Has no influence on shaders
 		m_depthSortingEnabled = depthSorting;
 	}
 
+	/*!
+	* \brief Enables the lighting
+	*
+	* \param lighting Should the parameter be enabled
+	*
+	* \remark Invalidates the shaders
+	*/
+
 	inline void Material::EnableLighting(bool lighting)
 	{
 		m_lightingEnabled = lighting;
@@ -51,12 +98,26 @@ namespace Nz
 		InvalidateShaders();
 	}
 
+	/*!
+	* \brief Enables the shadow casting
+	*
+	* \param castShadows Should shadow casting be enabled
+	*/
+
 	inline void Material::EnableShadowCasting(bool castShadows)
 	{
 		// Has no influence on shaders
 		m_shadowCastingEnabled = castShadows;
 	}
 
+	/*!
+	* \brief Enables the shadow on receiving object
+	*
+	* \param receiveShadow Should receiving object have shadows  enabled
+	*
+	* \remark Invalidates the shaders
+	*/
+
 	inline void Material::EnableShadowReceive(bool receiveShadows)
 	{
 		m_shadowReceiveEnabled = receiveShadows;
@@ -64,6 +125,14 @@ namespace Nz
 		InvalidateShaders();
 	}
 
+	/*!
+	* \brief Enables the transformation
+	*
+	* \param transform Should the parameter be enabled
+	*
+	* \remark Invalidates the shaders
+	*/
+
 	inline void Material::EnableTransform(bool transform)
 	{
 		m_transformEnabled = transform;
@@ -71,91 +140,183 @@ namespace Nz
 		InvalidateShaders();
 	}
 
+	/*!
+	* \brief Gets the alpha map
+	* \return Constant reference to the current texture
+	*/
+
 	inline const TextureRef& Material::GetAlphaMap() const
 	{
 		return m_alphaMap;
 	}
 
+	/*!
+	* \brief Gets the alpha threshold
+	* \return The threshold value for the alpha
+	*/
+
 	inline float Material::GetAlphaThreshold() const
 	{
 		return m_alphaThreshold;
 	}
 
+	/*!
+	* \brief Gets the ambient color
+	* \return Ambient color
+	*/
+
 	inline Color Material::GetAmbientColor() const
 	{
 		return m_ambientColor;
 	}
 
+	/*!
+	* \brief Gets the function to compare depth
+	* \return Function comparing the depth of two materials
+	*/
+
 	inline RendererComparison Material::GetDepthFunc() const
 	{
 		return m_states.depthFunc;
 	}
 
+	/*!
+	* \brief Gets the depth material
+	* \return Constant reference to the depth material
+	*/
+
 	inline const MaterialRef& Material::GetDepthMaterial() const
 	{
 		return m_depthMaterial;
 	}
 
+	/*!
+	* \brief Gets the diffuse color
+	* \return Diffuse color
+	*/
+
 	inline Color Material::GetDiffuseColor() const
 	{
 		return m_diffuseColor;
 	}
 
+	/*!
+	* \brief Gets the diffuse sampler
+	* \return Reference to the current texture sampler for the diffuse
+	*/
+
 	inline TextureSampler& Material::GetDiffuseSampler()
 	{
 		return m_diffuseSampler;
 	}
 
+	/*!
+	* \brief Gets the diffuse sampler
+	* \return Constant reference to the current texture sampler for the diffuse
+	*/
+
 	inline const TextureSampler& Material::GetDiffuseSampler() const
 	{
 		return m_diffuseSampler;
 	}
 
+	/*!
+	* \brief Gets the diffuse map
+	* \return Constant reference to the texture
+	*/
+
 	const TextureRef& Material::GetDiffuseMap() const
 	{
 		return m_diffuseMap;
 	}
 
+	/*!
+	* \brief Gets the dst in blend
+	* \return Function for dst blending
+	*/
+
 	inline BlendFunc Material::GetDstBlend() const
 	{
 		return m_states.dstBlend;
 	}
 
+	/*!
+	* \brief Gets the emissive map
+	* \return Constant reference to the texture
+	*/
+
 	inline const TextureRef& Material::GetEmissiveMap() const
 	{
 		return m_emissiveMap;
 	}
 
+	/*!
+	* \brief Gets the face culling
+	* \return Current face culling side
+	*/
+
 	inline FaceSide Material::GetFaceCulling() const
 	{
 		return m_states.faceCulling;
 	}
 
+	/*!
+	* \brief Gets the face filling
+	* \return Current face filling
+	*/
+
 	inline FaceFilling Material::GetFaceFilling() const
 	{
 		return m_states.faceFilling;
 	}
 
+	/*!
+	* \brief Gets the height map
+	* \return Constant reference to the texture
+	*/
+
 	inline const TextureRef& Material::GetHeightMap() const
 	{
 		return m_heightMap;
 	}
 
+	/*!
+	* \brief Gets the normal map
+	* \return Constant reference to the texture
+	*/
+
 	inline const TextureRef& Material::GetNormalMap() const
 	{
 		return m_normalMap;
 	}
 
+	/*!
+	* \brief Gets the render states
+	* \return Constant reference to the render states
+	*/
+
 	inline const RenderStates& Material::GetRenderStates() const
 	{
 		return m_states;
 	}
 
+	/*!
+	* \brief Gets the shader of this material
+	* \return Constant pointer to the ubershader used
+	*/
+
 	inline const UberShader* Material::GetShader() const
 	{
 		return m_uberShader;
 	}
 
+	/*!
+	* \brief Gets the shader instance based on the flag
+	* \return Constant pointer to the ubershader instance
+	*
+	* \param flags Flag of the shader
+	*/
+
 	inline const UberShaderInstance* Material::GetShaderInstance(UInt32 flags) const
 	{
 		const ShaderInstance& instance = m_shaders[flags];
@@ -165,81 +326,165 @@ namespace Nz
 		return instance.uberInstance;
 	}
 
+	/*!
+	* \brief Gets the shininess
+	* \return Current shininess
+	*/
+
 	inline float Material::GetShininess() const
 	{
 		return m_shininess;
 	}
 
+	/*!
+	* \brief Gets the specular color
+	* \return Specular color
+	*/
+
 	inline Color Material::GetSpecularColor() const
 	{
 		return m_specularColor;
 	}
 
+	/*!
+	* \brief Gets the specular map
+	* \return Constant reference to the texture
+	*/
+
 	inline const TextureRef& Material::GetSpecularMap() const
 	{
 		return m_specularMap;
 	}
 
+	/*!
+	* \brief Gets the specular sampler
+	* \return Reference to the current texture sampler for the specular
+	*/
+
 	inline TextureSampler& Material::GetSpecularSampler()
 	{
 		return m_specularSampler;
 	}
 
+	/*!
+	* \brief Gets the specular sampler
+	* \return Constant reference to the current texture sampler for the specular
+	*/
+
 	inline const TextureSampler& Material::GetSpecularSampler() const
 	{
 		return m_specularSampler;
 	}
 
+	/*!
+	* \brief Gets the src in blend
+	* \return Function for src blending
+	*/
+
 	inline BlendFunc Material::GetSrcBlend() const
 	{
 		return m_states.srcBlend;
 	}
 
+	/*!
+	* \brief Checks whether this material has an alpha map
+	* \return true If it is the case
+	*/
+
 	inline bool Material::HasAlphaMap() const
 	{
 		return m_alphaMap.IsValid();
 	}
 
+	/*!
+	* \brief Checks whether this material has a depth material
+	* \return true If it is the case
+	*/
+
 	inline bool Material::HasDepthMaterial() const
 	{
 		return m_depthMaterial.IsValid();
 	}
 
+	/*!
+	* \brief Checks whether this material has a diffuse map
+	* \return true If it is the case
+	*/
+
 	inline bool Material::HasDiffuseMap() const
 	{
 		return m_diffuseMap.IsValid();
 	}
 
+	/*!
+	* \brief Checks whether this material has a emissive map
+	* \return true If it is the case
+	*/
+
 	inline bool Material::HasEmissiveMap() const
 	{
 		return m_emissiveMap.IsValid();
 	}
 
+	/*!
+	* \brief Checks whether this material has a height map
+	* \return true If it is the case
+	*/
+
 	inline bool Material::HasHeightMap() const
 	{
 		return m_heightMap.IsValid();
 	}
 
+	/*!
+	* \brief Checks whether this material has a normal map
+	* \return true If it is the case
+	*/
+
 	inline bool Material::HasNormalMap() const
 	{
 		return m_normalMap.IsValid();
 	}
 
+	/*!
+	* \brief Checks whether this material has a specular map
+	* \return true If it is the case
+	*/
+
 	inline bool Material::HasSpecularMap() const
 	{
 		return m_specularMap.IsValid();
 	}
 
+	/*!
+	* \brief Checks whether this material has alpha test enabled
+	* \return true If it is the case
+	*/
+
 	inline bool Material::IsAlphaTestEnabled() const
 	{
 		return m_alphaTestEnabled;
 	}
 
+	/*!
+	* \brief Checks whether this material has depth sorting enabled
+	* \return true If it is the case
+	*/
+
 	inline bool Material::IsDepthSortingEnabled() const
 	{
 		return m_depthSortingEnabled;
 	}
 
+	/*!
+	* \brief Checks whether this material has the render parameter enabled
+	* \return true If it is the case
+	*
+	* \param parameter Parameter for the rendering
+	*
+	* \remark Produces a NazaraAssert if enumeration is invalid
+	*/
+
 	inline bool Material::IsEnabled(RendererParameter parameter) const
 	{
 		NazaraAssert(parameter <= RendererParameter_Max, "Renderer parameter out of enum");
@@ -247,41 +492,93 @@ namespace Nz
 		return m_states.parameters[parameter];
 	}
 
+	/*!
+	* \brief Checks whether this material has lightning enabled
+	* \return true If it is the case
+	*/
+
 	inline bool Material::IsLightingEnabled() const
 	{
 		return m_lightingEnabled;
 	}
 
+	/*!
+	* \brief Checks whether this material cast shadow
+	* \return true If it is the case
+	*/
+
 	inline bool Material::IsShadowCastingEnabled() const
 	{
 		return m_shadowCastingEnabled;
 	}
 
+	/*!
+	* \brief Checks whether this material receive shadow
+	* \return true If it is the case
+	*/
+
 	inline bool Material::IsShadowReceiveEnabled() const
 	{
 		return m_shadowReceiveEnabled;
 	}
 
+	/*!
+	* \brief Checks whether this material has transformation enabled
+	* \return true If it is the case
+	*/
+
 	inline bool Material::IsTransformEnabled() const
 	{
 		return m_transformEnabled;
 	}
 
+	/*!
+	* \brief Loads the material from file
+	* \return true if loading is successful
+	*
+	* \param filePath Path to the file
+	* \param params Parameters for the material
+	*/
+
 	inline bool Material::LoadFromFile(const String& filePath, const MaterialParams& params)
 	{
 		return MaterialLoader::LoadFromFile(this, filePath, params);
 	}
 
+	/*!
+	* \brief Loads the material from memory
+	* \return true if loading is successful
+	*
+	* \param data Raw memory
+	* \param size Size of the memory
+	* \param params Parameters for the material
+	*/
+
 	inline bool Material::LoadFromMemory(const void* data, std::size_t size, const MaterialParams& params)
 	{
 		return MaterialLoader::LoadFromMemory(this, data, size, params);
 	}
 
+	/*!
+	* \brief Loads the material from stream
+	* \return true if loading is successful
+	*
+	* \param stream Stream to the material
+	* \param params Parameters for the material
+	*/
+
 	inline bool Material::LoadFromStream(Stream& stream, const MaterialParams& params)
 	{
 		return MaterialLoader::LoadFromStream(this, stream, params);
 	}
 
+	/*!
+	* \brief Sets the alpha map by name
+	* \return true If successful
+	*
+	* \param textureName Named texture
+	*/
+
 	inline bool Material::SetAlphaMap(const String& textureName)
 	{
 		TextureRef texture = TextureLibrary::Query(textureName);
@@ -299,6 +596,15 @@ namespace Nz
 		return true;
 	}
 
+	/*!
+	* \brief Sets the alpha map with a reference to a texture
+	* \return true If successful
+	*
+	* \param alphaMap Texture
+	*
+	* \remark Invalidates the shaders
+	*/
+
 	inline void Material::SetAlphaMap(TextureRef alphaMap)
 	{
 		m_alphaMap = std::move(alphaMap);
@@ -306,31 +612,69 @@ namespace Nz
 		InvalidateShaders();
 	}
 
+	/*!
+	* \brief Sets the alpha threshold
+	*
+	* \param alphaThreshold Threshold for the alpha
+	*/
+
 	inline void Material::SetAlphaThreshold(float alphaThreshold)
 	{
 		m_alphaThreshold = alphaThreshold;
 	}
 
+	/*!
+	* \brief Sets the color for ambient
+	*
+	* \param ambient Color for ambient
+	*/
+
 	inline void Material::SetAmbientColor(const Color& ambient)
 	{
 		m_ambientColor = ambient;
 	}
 
+	/*!
+	* \brief Sets the depth functor
+	*
+	* \param depthFunc
+	*/
+
 	inline void Material::SetDepthFunc(RendererComparison depthFunc)
 	{
 		m_states.depthFunc = depthFunc;
 	}
 
+	/*!
+	* \brief Sets the depth material
+	* \return true If successful
+	*
+	* \param depthMaterial Material for depth
+	*/
+
 	inline void Material::SetDepthMaterial(MaterialRef depthMaterial)
 	{
 		m_depthMaterial = std::move(depthMaterial);
 	}
 
+	/*!
+	* \brief Sets the color for diffuse
+	*
+	* \param diffuse Color for diffuse
+	*/
+
 	inline void Material::SetDiffuseColor(const Color& diffuse)
 	{
 		m_diffuseColor = diffuse;
 	}
 
+	/*!
+	* \brief Sets the diffuse map by name
+	* \return true If successful
+	*
+	* \param textureName Named texture
+	*/
+
 	inline bool Material::SetDiffuseMap(const String& textureName)
 	{
 		TextureRef texture = TextureLibrary::Query(textureName);
@@ -348,6 +692,15 @@ namespace Nz
 		return true;
 	}
 
+	/*!
+	* \brief Sets the diffuse map with a reference to a texture
+	* \return true If successful
+	*
+	* \param diffuseMap Texture
+	*
+	* \remark Invalidates the shaders
+	*/
+
 	inline void Material::SetDiffuseMap(TextureRef diffuseMap)
 	{
 		m_diffuseMap = std::move(diffuseMap);
@@ -355,16 +708,35 @@ namespace Nz
 		InvalidateShaders();
 	}
 
+	/*!
+	* \brief Sets the diffuse sampler
+	*
+	* \param sampler Diffuse sample
+	*/
+
 	inline void Material::SetDiffuseSampler(const TextureSampler& sampler)
 	{
 		m_diffuseSampler = sampler;
 	}
 
+	/*!
+	* \brief Sets the dst in blend
+	*
+	* \param func Function for dst blending
+	*/
+
 	inline void Material::SetDstBlend(BlendFunc func)
 	{
 		m_states.dstBlend = func;
 	}
 
+	/*!
+	* \brief Sets the emissive map by name
+	* \return true If successful
+	*
+	* \param textureName Named texture
+	*/
+
 	inline bool Material::SetEmissiveMap(const String& textureName)
 	{
 		TextureRef texture = TextureLibrary::Query(textureName);
@@ -382,6 +754,15 @@ namespace Nz
 		return true;
 	}
 
+	/*!
+	* \brief Sets the emissive map with a reference to a texture
+	* \return true If successful
+	*
+	* \param emissiveMap Texture
+	*
+	* \remark Invalidates the shaders
+	*/
+
 	inline void Material::SetEmissiveMap(TextureRef emissiveMap)
 	{
 		m_emissiveMap = std::move(emissiveMap);
@@ -389,16 +770,35 @@ namespace Nz
 		InvalidateShaders();
 	}
 
+	/*!
+	* \brief Sets the face culling
+	*
+	* \param faceSide Face to cull
+	*/
+
 	inline void Material::SetFaceCulling(FaceSide faceSide)
 	{
 		m_states.faceCulling = faceSide;
 	}
 
+	/*!
+	* \brief Sets the face filling
+	*
+	* \param filling Face to fill
+	*/
+
 	inline void Material::SetFaceFilling(FaceFilling filling)
 	{
 		m_states.faceFilling = filling;
 	}
 
+	/*!
+	* \brief Sets the height map by name
+	* \return true If successful
+	*
+	* \param textureName Named texture
+	*/
+
 	inline bool Material::SetHeightMap(const String& textureName)
 	{
 		TextureRef texture = TextureLibrary::Query(textureName);
@@ -416,6 +816,15 @@ namespace Nz
 		return true;
 	}
 
+	/*!
+	* \brief Sets the height map with a reference to a texture
+	* \return true If successful
+	*
+	* \param heightMap Texture
+	*
+	* \remark Invalidates the shaders
+	*/
+
 	inline void Material::SetHeightMap(TextureRef heightMap)
 	{
 		m_heightMap = std::move(heightMap);
@@ -423,6 +832,13 @@ namespace Nz
 		InvalidateShaders();
 	}
 
+	/*!
+	* \brief Sets the normal map by name
+	* \return true If successful
+	*
+	* \param textureName Named texture
+	*/
+
 	inline bool Material::SetNormalMap(const String& textureName)
 	{
 		TextureRef texture = TextureLibrary::Query(textureName);
@@ -440,6 +856,15 @@ namespace Nz
 		return true;
 	}
 
+	/*!
+	* \brief Sets the normal map with a reference to a texture
+	* \return true If successful
+	*
+	* \param normalMap Texture
+	*
+	* \remark Invalidates the shaders
+	*/
+
 	inline void Material::SetNormalMap(TextureRef normalMap)
 	{
 		m_normalMap = std::move(normalMap);
@@ -447,11 +872,25 @@ namespace Nz
 		InvalidateShaders();
 	}
 
+	/*!
+	* \brief Sets the render states
+	*
+	* \param states States for the rendering
+	*/
+
 	inline void Material::SetRenderStates(const RenderStates& states)
 	{
 		m_states = states;
 	}
 
+	/*!
+	* \brief Sets the shader with a constant reference to a ubershader
+	*
+	* \param uberShader Uber shader to apply
+	*
+	* \remark Invalidates the shaders
+	*/
+
 	inline void Material::SetShader(UberShaderConstRef uberShader)
 	{
 		m_uberShader = std::move(uberShader);
@@ -459,6 +898,13 @@ namespace Nz
 		InvalidateShaders();
 	}
 
+	/*!
+	* \brief Sets the shader by name
+	* \return true If successful
+	*
+	* \param uberShaderName Named shader
+	*/
+
 	inline bool Material::SetShader(const String& uberShaderName)
 	{
 		UberShaderConstRef uberShader = UberShaderLibrary::Get(uberShaderName);
@@ -469,16 +915,35 @@ namespace Nz
 		return true;
 	}
 
+	/*!
+	* \brief Sets the shininess of the material
+	*
+	* \param shininess Value of the shininess
+	*/
+
 	inline void Material::SetShininess(float shininess)
 	{
 		m_shininess = shininess;
 	}
 
+	/*!
+	* \brief Sets the color for specular
+	*
+	* \param specular Color
+	*/
+
 	inline void Material::SetSpecularColor(const Color& specular)
 	{
 		m_specularColor = specular;
 	}
 
+	/*!
+	* \brief Sets the specular map by name
+	* \return true If successful
+	*
+	* \param textureName Named texture
+	*/
+
 	inline bool Material::SetSpecularMap(const String& textureName)
 	{
 		TextureRef texture = TextureLibrary::Query(textureName);
@@ -496,6 +961,15 @@ namespace Nz
 		return true;
 	}
 
+	/*!
+	* \brief Sets the specular map with a reference to a texture
+	* \return true If successful
+	*
+	* \param specularMap Texture
+	*
+	* \remark Invalidates the shaders
+	*/
+
 	inline void Material::SetSpecularMap(TextureRef specularMap)
 	{
 		m_specularMap = std::move(specularMap);
@@ -503,16 +977,35 @@ namespace Nz
 		InvalidateShaders();
 	}
 
+	/*!
+	* \brief Sets the specular sampler
+	*
+	* \param sampler Specular sample
+	*/
+
 	inline void Material::SetSpecularSampler(const TextureSampler& sampler)
 	{
 		m_specularSampler = sampler;
 	}
 
+	/*!
+	* \brief Sets the src in blend
+	*
+	* \param func Function for src blending
+	*/
+
 	inline void Material::SetSrcBlend(BlendFunc func)
 	{
 		m_states.srcBlend = func;
 	}
 
+	/*!
+	* \brief Sets the current material with the content of the other one
+	* \return A reference to this
+	*
+	* \param material The other Material
+	*/
+
 	inline Material& Material::operator=(const Material& material)
 	{
 		Resource::operator=(material);
@@ -521,17 +1014,33 @@ namespace Nz
 		return *this;
 	}
 
+	/*!
+	* \brief Gets the default material
+	* \return Reference to the default material
+	*/
+
 	inline MaterialRef Material::GetDefault()
 	{
 		return s_defaultMaterial;
 	}
 
+	/*!
+	* \brief Invalidates the shaders
+	*/
+
 	inline void Material::InvalidateShaders()
 	{
 		for (ShaderInstance& instance : m_shaders)
 			instance.uberInstance = nullptr;
 	}
 
+	/*!
+	* \brief Creates a new material from the arguments
+	* \return A reference to the newly created material
+	*
+	* \param args Arguments for the material
+	*/
+
 	template<typename... Args>
 	MaterialRef Material::New(Args&&... args)
 	{

include/Nazara/Graphics/Model.hpp

@@ -68,8 +68,6 @@ namespace Nz
 			bool SetMaterial(unsigned int skinIndex, const String& subMeshName, Material* material);
 			void SetMaterial(unsigned int skinIndex, unsigned int matIndex, Material* material);
 			virtual void SetMesh(Mesh* mesh);
-			bool SetSequence(const String& sequenceName);
-			void SetSequence(unsigned int sequenceIndex);
 			void SetSkin(unsigned int skin);
 			void SetSkinCount(unsigned int skinCount);
 

include/Nazara/Graphics/Model.inl

@@ -7,6 +7,13 @@
 
 namespace Nz
 {
+	/*!
+	* \brief Creates a new Model from the arguments
+	* \return A reference to the newly created model
+	*
+	* \param args Arguments for the model
+	*/
+
 	template<typename... Args>
 	ModelRef Model::New(Args&&... args)
 	{

include/Nazara/Graphics/ParticleDeclaration.hpp

@@ -62,16 +62,16 @@ namespace Nz
 
 				/*
 				** -Lynix:
-				** Il serait aussi possible de préciser le stride de façon indépendante, ce que je ne permets pas
-				** pour décomplexifier l'interface en enlevant quelque chose que je juge inutile.
-				** Si vous pensez que ça peut être utile, n'hésitez pas à me le faire savoir !
+				** It would be also possible to precise the stride by an independant way, what I don't allow
+				** to decomplexify the interface of something I consider useless.
+				** If you think that could be useful, don't hesitate to make me aware !
 				*/
 			};
 
-			Component m_components[ParticleComponent_Max+1];
+			Component m_components[ParticleComponent_Max + 1];
 			unsigned int m_stride;
 
-			static ParticleDeclaration s_declarations[ParticleLayout_Max+1];
+			static ParticleDeclaration s_declarations[ParticleLayout_Max + 1];
 			static ParticleDeclarationLibrary::LibraryMap s_library;
 	};
 }

include/Nazara/Graphics/ParticleMapper.inl

@@ -7,10 +7,20 @@
 
 namespace Nz
 {
+	/*!
+	* \brief Gets a pointer to iterate through same components
+	* \return SparsePtr pointing to same components
+	*
+	* \param component Component to get in the declaration
+	*
+	* \remark The same components are not continguous but separated by sizeof(ParticleSize)
+	* \remark Produces a NazaraError if component is disabled
+	*/
+
 	template <typename T>
 	SparsePtr<T> ParticleMapper::GetComponentPtr(ParticleComponent component)
 	{
-		// Ensuite le composant qui nous intéresse
+		// Then the component that are interesting
 		bool enabled;
 		ComponentType type;
 		unsigned int offset;
@@ -18,7 +28,7 @@ namespace Nz
 
 		if (enabled)
 		{
-			///TODO: Vérifier le rapport entre le type de l'attribut et le type template ?
+			///TODO: Check the ratio between the type of the attribute and the template type ?
 			return SparsePtr<T>(m_ptr + offset, m_declaration->GetStride());
 		}
 		else
@@ -28,10 +38,20 @@ namespace Nz
 		}
 	}
 
+	/*!
+	* \brief Gets a pointer to iterate through same components
+	* \return SparsePtr pointing to same components
+	*
+	* \param component Component to get in the declaration
+	*
+	* \remark The same components are not continguous but separated by sizeof(ParticleSize)
+	* \remark Produces a NazaraError if component is disabled
+	*/
+
 	template <typename T>
 	SparsePtr<const T> ParticleMapper::GetComponentPtr(ParticleComponent component) const
 	{
-		// Ensuite le composant qui nous intéresse
+		// Then the component that are interesting
 		bool enabled;
 		ComponentType type;
 		unsigned int offset;
@@ -39,7 +59,7 @@ namespace Nz
 
 		if (enabled)
 		{
-			///TODO: Vérifier le rapport entre le type de l'attribut et le type template ?
+			///TODO: Check the ratio between the type of the attribute and the template type ?
 			return SparsePtr<const T>(m_ptr + offset, m_declaration->GetStride());
 		}
 		else

include/Nazara/Graphics/Renderable.inl

@@ -4,17 +4,31 @@
 
 namespace Nz
 {
+	/*!
+	* \brief Ensures that the bounding volume is up to date
+	*/
+
 	inline void Renderable::EnsureBoundingVolumeUpdated() const
 	{
 		if (!m_boundingVolumeUpdated)
 			UpdateBoundingVolume();
 	}
 
+	/*!
+	* \brief Invalidates the bounding volume
+	*/
+
 	inline void Renderable::InvalidateBoundingVolume()
 	{
 		m_boundingVolumeUpdated = false;
 	}
 
+	/*!
+	* \brief Updates the bounding volume by a matrix
+	*
+	* \param transformMatrix Matrix transformation for our bounding volume
+	*/
+
 	inline void Renderable::UpdateBoundingVolume() const
 	{
 		MakeBoundingVolume();

include/Nazara/Graphics/SkyboxBackground.inl

@@ -7,31 +7,62 @@
 
 namespace Nz
 {
+	/*!
+	* \brief Gets the movement offset
+	* \return Offset of the movement
+	*/
+
 	inline const Vector3f& Nz::SkyboxBackground::GetMovementOffset() const
 	{
 		return m_movementOffset;
 	}
 
+	/*!
+	* \brief Gets the movement scale
+	* \return Scale of the movement
+	*/
+
 	inline float SkyboxBackground::GetMovementScale() const
 	{
 		return m_movementScale;
 	}
 
+	/*!
+	* \brief Gets the texture of the background
+	* \return Texture of the background
+	*/
+
 	inline const TextureRef& SkyboxBackground::GetTexture() const
 	{
 		return m_texture;
 	}
 
+	/*!
+	* \brief Gets the texture sampler of the background
+	* \return A reference to the texture sampler of the background
+	*/
+
 	inline TextureSampler& SkyboxBackground::GetTextureSampler()
 	{
 		return m_sampler;
 	}
 
+	/*!
+	* \brief Gets the texture sampler of the background
+	* \return A constant reference to the texture sampler of the background
+	*/
+
 	inline const TextureSampler& SkyboxBackground::GetTextureSampler() const
 	{
 		return m_sampler;
 	}
 
+	/*!
+	* \brief Sets the movement offset
+	*
+	* \param offset Offset of the movement
+	*/
+
 	inline void SkyboxBackground::SetMovementOffset(const Vector3f& offset)
 	{
 		NazaraAssert(std::isfinite(offset.x) && std::isfinite(offset.y) && std::isfinite(offset.z), "Offset must be a finite vector");
@@ -39,6 +70,12 @@ namespace Nz
 		m_movementOffset = offset;
 	}
 
+	/*!
+	* \brief Sets the movement scale
+	*
+	* \param scale Scale of the movement
+	*/
+
 	inline void SkyboxBackground::SetMovementScale(float scale)
 	{
 		NazaraAssert(std::isfinite(scale), "Scale must be a finite value");
@@ -46,6 +83,12 @@ namespace Nz
 		m_movementScale = scale;
 	}
 
+	/*!
+	* \brief Sets the texture of the background
+	*
+	* \param cubemapTexture Texture of the background
+	*/
+
 	inline void SkyboxBackground::SetTexture(TextureRef cubemapTexture)
 	{
 		NazaraAssert(!cubemapTexture || cubemapTexture->IsValid(), "Invalid texture");
@@ -54,11 +97,24 @@ namespace Nz
 		m_texture = std::move(cubemapTexture);
 	}
 
+	/*!
+	* \brief Sets the texture sampler of the background
+	*
+	* \param sampler Texture sampler of the background
+	*/
+
 	void SkyboxBackground::SetTextureSampler(const TextureSampler& sampler)
 	{
 		m_sampler = sampler;
 	}
 
+	/*!
+	* \brief Creates a new skybox background from the arguments
+	* \return A reference to the newly created skybox background
+	*
+	* \param args Arguments for the skybox background
+	*/
+
 	template<typename... Args>
 	SkyboxBackgroundRef SkyboxBackground::New(Args&&... args)
 	{

include/Nazara/Graphics/Sprite.inl

@@ -8,6 +8,10 @@
 
 namespace Nz
 {
+	/*!
+	* \brief Constructs a Sprite object by default
+	*/
+
 	inline Sprite::Sprite() :
 	m_color(Color::White),
 	m_textureCoords(0.f, 0.f, 1.f, 1.f),
@@ -16,6 +20,12 @@ namespace Nz
 		SetDefaultMaterial();
 	}
 
+	/*!
+	* \brief Constructs a Sprite object with a reference to a material
+	*
+	* \param material Reference to a material
+	*/
+
 	inline Sprite::Sprite(MaterialRef material) :
 	m_color(Color::White),
 	m_textureCoords(0.f, 0.f, 1.f, 1.f),
@@ -24,6 +34,12 @@ namespace Nz
 		SetMaterial(std::move(material), true);
 	}
 
+	/*!
+	* \brief Constructs a Sprite object with a pointer to a texture
+	*
+	* \param texture Pointer to a texture
+	*/
+
 	inline Sprite::Sprite(Texture* texture) :
 	m_color(Color::White),
 	m_textureCoords(0.f, 0.f, 1.f, 1.f),
@@ -32,6 +48,12 @@ namespace Nz
 		SetTexture(texture, true);
 	}
 
+	/*!
+	* \brief Constructs a Sprite object by assignation
+	*
+	* \param sprite Sprite to copy into this
+	*/
+
 	inline Sprite::Sprite(const Sprite& sprite) :
 	InstancedRenderable(sprite),
 	m_color(sprite.m_color),
@@ -41,26 +63,52 @@ namespace Nz
 	{
 	}
 
+	/*!
+	* \brief Gets the color of the sprite
+	* \return Current color
+	*/
+
 	inline const Color& Sprite::GetColor() const
 	{
 		return m_color;
 	}
 
+	/*!
+	* \brief Gets the material of the sprite
+	* \return Current material
+	*/
+
 	inline const MaterialRef& Sprite::GetMaterial() const
 	{
 		return m_material;
 	}
 
+	/*!
+	* \brief Gets the size of the sprite
+	* \return Current size
+	*/
+
 	inline const Vector2f& Sprite::GetSize() const
 	{
 		return m_size;
 	}
 
+	/*!
+	* \brief Gets the texture coordinates of the sprite
+	* \return Current texture coordinates
+	*/
+
 	inline const Rectf& Sprite::GetTextureCoords() const
 	{
 		return m_textureCoords;
 	}
 
+	/*!
+	* \brief Sets the color of the billboard
+	*
+	* \param color Color for the billboard
+	*/
+
 	inline void Sprite::SetColor(const Color& color)
 	{
 		m_color = color;
@@ -68,6 +116,10 @@ namespace Nz
 		InvalidateVertices();
 	}
 
+	/*!
+	* \brief Sets the default material of the sprite (just default material)
+	*/
+
 	inline void Sprite::SetDefaultMaterial()
 	{
 		MaterialRef material = Material::New();
@@ -77,6 +129,13 @@ namespace Nz
 		SetMaterial(std::move(material));
 	}
 
+	/*!
+	* \brief Sets the material of the sprite
+	*
+	* \param material Material for the sprite
+	* \param resizeSprite Should sprite be resized to the material size (diffuse map)
+	*/
+
 	inline void Sprite::SetMaterial(MaterialRef material, bool resizeSprite)
 	{
 		m_material = std::move(material);
@@ -88,6 +147,12 @@ namespace Nz
 		}
 	}
 
+	/*!
+	* \brief Sets the size of the sprite
+	*
+	* \param size Size for the sprite
+	*/
+
 	inline void Sprite::SetSize(const Vector2f& size)
 	{
 		m_size = size;
@@ -97,11 +162,25 @@ namespace Nz
 		InvalidateVertices();
 	}
 
+	/*!
+	* \brief Sets the size of the sprite
+	*
+	* \param sizeX Size in X for the sprite
+	* \param sizeY Size in Y for the sprite
+	*/
+
 	inline void Sprite::SetSize(float sizeX, float sizeY)
 	{
 		SetSize(Vector2f(sizeX, sizeY));
 	}
 
+	/*!
+	* \brief Sets the texture of the sprite
+	*
+	* \param texture Texture for the sprite
+	* \param resizeSprite Should sprite be resized to the texture size
+	*/
+
 	inline void Sprite::SetTexture(TextureRef texture, bool resizeSprite)
 	{
 		if (!m_material)
@@ -115,12 +194,27 @@ namespace Nz
 		m_material->SetDiffuseMap(std::move(texture));
 	}
 
+	/*!
+	* \brief Sets the texture coordinates of the sprite
+	*
+	* \param coords Texture coordinates
+	*/
+
 	inline void Sprite::SetTextureCoords(const Rectf& coords)
 	{
 		m_textureCoords = coords;
 		InvalidateVertices();
 	}
 
+	/*!
+	* \brief Sets the texture rectangle of the sprite
+	*
+	* \param rect Rectangles symbolizing the size of the texture
+	*
+	* \remark Produces a NazaraAssert if material is invalid
+	* \remark Produces a NazaraAssert if material has no diffuse map
+	*/
+
 	inline void Sprite::SetTextureRect(const Rectui& rect)
 	{
 		NazaraAssert(m_material, "Sprite has no material");
@@ -128,12 +222,19 @@ namespace Nz
 
 		Texture* diffuseMap = m_material->GetDiffuseMap();
 
-		float invWidth = 1.f/diffuseMap->GetWidth();
-		float invHeight = 1.f/diffuseMap->GetHeight();
+		float invWidth = 1.f / diffuseMap->GetWidth();
+		float invHeight = 1.f / diffuseMap->GetHeight();
 
-		SetTextureCoords(Rectf(invWidth*rect.x, invHeight*rect.y, invWidth*rect.width, invHeight*rect.height));
+		SetTextureCoords(Rectf(invWidth * rect.x, invHeight * rect.y, invWidth * rect.width, invHeight * rect.height));
 	}
 
+	/*!
+	* \brief Sets the current sprite with the content of the other one
+	* \return A reference to this
+	*
+	* \param sprite The other Sprite
+	*/
+
 	inline Sprite& Sprite::operator=(const Sprite& sprite)
 	{
 		InstancedRenderable::operator=(sprite);
@@ -143,18 +244,29 @@ namespace Nz
 		m_textureCoords = sprite.m_textureCoords;
 		m_size = sprite.m_size;
 
-		// On ne copie pas les sommets finaux car il est très probable que nos paramètres soient modifiés et qu'ils doivent être régénérés de toute façon
+		// We do not copy final vertices because it's highly probable that our parameters are modified and they must be regenerated
 		InvalidateBoundingVolume();
 		InvalidateVertices();
 
 		return *this;
 	}
 
+	/*!
+	* \brief Invalidates the vertices
+	*/
+
 	inline void Sprite::InvalidateVertices()
 	{
 		InvalidateInstanceData(0);
 	}
 
+	/*!
+	* \brief Creates a new sprite from the arguments
+	* \return A reference to the newly created sprite
+	*
+	* \param args Arguments for the sprite
+	*/
+
 	template<typename... Args>
 	SpriteRef Sprite::New(Args&&... args)
 	{

include/Nazara/Graphics/TextSprite.inl

@@ -7,6 +7,10 @@
 
 namespace Nz
 {
+	/*!
+	* \brief Constructs a TextSprite object by default
+	*/
+
 	inline TextSprite::TextSprite() :
 	m_color(Color::White),
 	m_scale(1.f)
@@ -14,12 +18,24 @@ namespace Nz
 		SetDefaultMaterial();
 	}
 
+	/*!
+	* \brief Constructs a TextSprite object with a drawer
+	*
+	* \param drawer Drawer used to compose text on the sprite
+	*/
+
 	inline TextSprite::TextSprite(const AbstractTextDrawer& drawer) :
 	TextSprite()
 	{
 		Update(drawer);
 	}
 
+	/*!
+	* \brief Constructs a TextSprite object by assignation
+	*
+	* \param sprite TextSprite to copy into this
+	*/
+
 	inline TextSprite::TextSprite(const TextSprite& sprite) :
 	InstancedRenderable(sprite),
 	m_renderInfos(sprite.m_renderInfos),
@@ -40,6 +56,10 @@ namespace Nz
 		}
 	}
 
+	/*!
+	* \brief Clears the data
+	*/
+
 	inline void TextSprite::Clear()
 	{
 		m_atlases.clear();
@@ -48,21 +68,42 @@ namespace Nz
 		m_renderInfos.clear();
 	}
 
+	/*!
+	* \brief Gets the color of the text sprite
+	* \return Current color
+	*/
+
 	inline const Color& TextSprite::GetColor() const
 	{
 		return m_color;
 	}
 
+	/*!
+	* \brief Gets the material of the text sprite
+	* \return Current material
+	*/
+
 	inline const MaterialRef& TextSprite::GetMaterial() const
 	{
 		return m_material;
 	}
 
+	/*!
+	* \brief Gets the current scale of the text sprite
+	* \return Current scale
+	*/
+
 	inline float TextSprite::GetScale() const
 	{
 		return m_scale;
 	}
 
+	/*!
+	* \brief Sets the color of the text sprite
+	*
+	* \param color Color for the text sprite
+	*/
+
 	inline void TextSprite::SetColor(const Color& color)
 	{
 		m_color = color;
@@ -70,6 +111,11 @@ namespace Nz
 		InvalidateVertices();
 	}
 
+	/*!
+	* \brief Sets the default material of the text sprite (just default material)
+	*/
+
+
 	inline void TextSprite::SetDefaultMaterial()
 	{
 		MaterialRef material = Material::New();
@@ -83,11 +129,23 @@ namespace Nz
 		SetMaterial(material);
 	}
 
+	/*!
+	* \brief Sets the material of the text sprite
+	*
+	* \param material Material for the text sprite
+	*/
+
 	inline void TextSprite::SetMaterial(MaterialRef material)
 	{
 		m_material = std::move(material);
 	}
 
+	/*!
+	* \brief Sets the current scale of the text sprite
+	*
+	* \param scale Scale of the text sprite
+	*/
+
 	inline void TextSprite::SetScale(float scale)
 	{
 		m_scale = scale;
@@ -95,10 +153,12 @@ namespace Nz
 		InvalidateVertices();
 	}
 
-	inline void TextSprite::InvalidateVertices()
-	{
-		InvalidateInstanceData(0);
-	}
+	/*!
+	* \brief Sets the current text sprite with the content of the other one
+	* \return A reference to this
+	*
+	* \param text sprite The other TextSprite
+	*/
 
 	inline TextSprite& TextSprite::operator=(const TextSprite& text)
 	{
@@ -130,6 +190,22 @@ namespace Nz
 		return *this;
 	}
 
+	/*!
+	* \brief Invalidates the vertices
+	*/
+
+	inline void TextSprite::InvalidateVertices()
+	{
+		InvalidateInstanceData(0);
+	}
+
+	/*!
+	* \brief Creates a new text sprite from the arguments
+	* \return A reference to the newly created text sprite
+	*
+	* \param args Arguments for the text sprite
+	*/
+
 	template<typename... Args>
 	TextSpriteRef TextSprite::New(Args&&... args)
 	{

include/Nazara/Graphics/TextureBackground.inl

@@ -7,11 +7,22 @@
 
 namespace Nz
 {
+	/*!
+	* \brief Gets the texture of the background
+	* \return Texture of the background
+	*/
+
 	inline const TextureRef& TextureBackground::GetTexture() const
 	{
 		return m_texture;
 	}
 
+	/*!
+	* \brief Sets the texture of the background
+	*
+	* \param texture Texture of the background
+	*/
+
 	inline void TextureBackground::SetTexture(TextureRef texture)
 	{
 		NazaraAssert(!texture || texture->IsValid(), "Invalid texture");
@@ -19,6 +30,13 @@ namespace Nz
 		m_texture = std::move(texture);
 	}
 
+	/*!
+	* \brief Creates a new texture background from the arguments
+	* \return A reference to the newly created texture background
+	*
+	* \param args Arguments for the texture background
+	*/
+
 	template<typename... Args>
 	TextureBackgroundRef TextureBackground::New(Args&&... args)
 	{

include/Nazara/Math/Frustum.inl

@@ -491,8 +491,8 @@ namespace Nz
 	*
 	* \remark If volume is infinite, IntersectionSide_Intersecting is returned
 	* \remark If volume is null, IntersectionSide_Outside is returned
-	* \remark If enumeration of the volume is not defined in Extend, a NazaraError is thrown and false is returned
-	* \remark If enumeration of the intersection is not defined in IntersectionSide, a NazaraError is thrown and false is returned. This should not never happen for a user of the library
+	* \remark If enumeration of the volume is not defined in Extend, a NazaraError is thrown and IntersectionSide_Outside is returned
+	* \remark If enumeration of the intersection is not defined in IntersectionSide, a NazaraError is thrown and IntersectionSide_Outside is returned. This should not never happen for a user of the library
 	*/
 
 	template<typename T>

include/Nazara/Math/Sphere.inl

@@ -485,7 +485,7 @@ namespace Nz
 	template<typename T>
 	T Sphere<T>::SquaredDistance(const Vector3<T>& point) const
 	{
-		return Vector3f::Distance(point, GetPosition()) - radius * radius;
+		return Vector3f::SquaredDistance(point, GetPosition() + (point - GetPosition()).Normalize() * radius);
 	}
 
 	/*!

include/Nazara/Network/AbstractSocket.inl

@@ -6,31 +6,62 @@
 
 namespace Nz
 {
+	/*!
+	* \brief Gets the last error
+	* \return Socket error
+	*/
+
 	inline SocketError AbstractSocket::GetLastError() const
 	{
 		return m_lastError;
 	}
 
+	/*!
+	* \brief Gets the internal socket handle
+	* \return Socket handle
+	*/
+
 	inline SocketHandle AbstractSocket::GetNativeHandle() const
 	{
 		return m_handle;
 	}
 
+	/*!
+	* \brief Gets the internal state
+	* \return Socket state
+	*/
+
 	inline SocketState AbstractSocket::GetState() const
 	{
 		return m_state;
 	}
 
+	/*!
+	* \brief Gets the internal type
+	* \return Socket type
+	*/
+
 	inline SocketType AbstractSocket::GetType() const
 	{
 		return m_type;
 	}
 
+	/*!
+	* \brief Checks whether the blocking is enabled
+	* \return true If successful
+	*/
+
 	inline bool AbstractSocket::IsBlockingEnabled() const
 	{
 		return m_isBlockingEnabled;
 	}
 
+	/*!
+	* \brief Updates the state of the socket
+	*
+	* \param newState Next state for the socket
+	*/
+
 	inline void AbstractSocket::UpdateState(SocketState newState)
 	{
 		if (m_state != newState)

include/Nazara/Network/Config.hpp

@@ -27,17 +27,22 @@
 #ifndef NAZARA_CONFIG_NETWORK_HPP
 #define NAZARA_CONFIG_NETWORK_HPP
 
-/// Chaque modification d'un paramètre du module nécessite une recompilation de celui-ci
+/*!
+* \defgroup network (NazaraNetwork) Network module
+*  Network/System module including classes to handle networking elements...
+*/
 
-// Utilise le MemoryManager pour gérer les allocations dynamiques (détecte les leaks au prix d'allocations/libérations dynamiques plus lentes)
+/// Each modification of a paramater of the module needs a recompilation of the unit
+
+// Use the MemoryManager to manage dynamic allocations (can detect memory leak but allocations/frees are slower)
 #define NAZARA_NETWORK_MANAGE_MEMORY 0
 
-// Active les tests de sécurité basés sur le code (Conseillé pour le développement)
+// Activate the security tests based on the code (Advised for development)
 #define NAZARA_NETWORK_SAFE 1
 
-/// Chaque modification d'un paramètre ci-dessous implique une modification (souvent mineure) du code
+/// Each modification of a parameter following implies a modification (often minor) of the code
 
-/// Vérification des valeurs et types de certaines constantes
+/// Checking the values and types of certain constants
 #include <Nazara/Network/ConfigCheck.hpp>
 
 #if defined(NAZARA_STATIC)

include/Nazara/Network/ConfigCheck.hpp

@@ -7,11 +7,11 @@
 #ifndef NAZARA_CONFIG_CHECK_NETWORK_HPP
 #define NAZARA_CONFIG_CHECK_NETWORK_HPP
 
-/// Ce fichier sert à vérifier la valeur des constantes du fichier Config.hpp
+/// This file is used to check the constant values defined in Config.hpp
 
 #include <type_traits>
 
-// On force la valeur de MANAGE_MEMORY en mode debug
+// We fore the value of MANAGE_MEMORY in debug
 #if defined(NAZARA_DEBUG) && !NAZARA_NETWORK_MANAGE_MEMORY
 	#undef NAZARA_NETWORK_MANAGE_MEMORY
 	#define NAZARA_NETWORK_MANAGE_MEMORY 0

include/Nazara/Network/DebugOff.hpp

@@ -2,7 +2,7 @@
 // This file is part of the "Nazara Engine - Network module"
 // For conditions of distribution and use, see copyright notice in Config.hpp
 
-// On suppose que Debug.hpp a déjà été inclus, tout comme Config.hpp
+// We suppose that Debug.hpp is already included, same goes for Config.hpp
 #if NAZARA_NETWORK_MANAGE_MEMORY
 	#undef delete
 	#undef new

include/Nazara/Network/IpAddress.inl

@@ -9,11 +9,22 @@
 
 namespace Nz
 {
+	/*!
+	* \brief Constructs a IpAddress object by default
+	*/
+
 	inline IpAddress::IpAddress() :
 	m_isValid(false)
 	{
 	}
 
+	/*!
+	* \brief Constructs a IpAddress object with an IP and a port
+	*
+	* \param ip IPv4 address
+	* \param port Port of the IP
+	*/
+
 	inline IpAddress::IpAddress(const IPv4& ip, UInt16 port) :
 	m_ipv4(ip),
 	m_protocol(NetProtocol_IPv4),
@@ -22,6 +33,13 @@ namespace Nz
 	{
 	}
 
+	/*!
+	* \brief Constructs a IpAddress object with an IP and a port
+	*
+	* \param ip IPv6 address
+	* \param port Port of the IP
+	*/
+
 	inline IpAddress::IpAddress(const IPv6& ip, UInt16 port) :
 	m_ipv6(ip),
 	m_protocol(NetProtocol_IPv6),
@@ -30,46 +48,100 @@ namespace Nz
 	{
 	}
 
+	/*!
+	* \brief Constructs a IpAddress object with an IP and a port
+	*
+	* \param ip IPv4 address (a.b.c.d)
+	* \param port Port of the IP
+	*/
+
 	inline IpAddress::IpAddress(const UInt8& a, const UInt8& b, const UInt8& c, const UInt8& d, UInt16 port) :
 	IpAddress(IPv4{a, b, c, d}, port)
 	{
 	}
 
+	/*!
+	* \brief Constructs a IpAddress object with an IP and a port
+	*
+	* \param ip IPv6 address (a.b.c.d.e.f.g.h)
+	* \param port Port of the IP
+	*/
+
 	inline IpAddress::IpAddress(const UInt16& a, const UInt16& b, const UInt16& c, const UInt16& d, const UInt16& e, const UInt16& f, const UInt16& g, const UInt16& h, UInt16 port) :
 	IpAddress(IPv6{a, b, c, d, e, f, g, h}, port)
 	{
 	}
 
+	/*!
+	* Constructs a IpAddress object with a C-string
+	*
+	* \param address Hostname or textual IP address
+	*/
+
 	inline IpAddress::IpAddress(const char* address)
 	{
 		BuildFromAddress(address);
 	}
 
+	/*!
+	* Constructs a IpAddress object with a string
+	*
+	* \param address Hostname or textual IP address
+	*/
+
 	inline IpAddress::IpAddress(const String& address)
 	{
 		BuildFromAddress(address.GetConstBuffer());
 	}
 
+	/*!
+	* \brief Gets the port
+	* \return Port attached to the IP address
+	*/
+
 	inline UInt16 IpAddress::GetPort() const
 	{
 		return m_port;
 	}
 
+	/*!
+	* \brief Gets the net protocol
+	* \return Protocol attached to the IP address
+	*/
+
 	inline NetProtocol IpAddress::GetProtocol() const
 	{
 		return m_protocol;
 	}
 
+	/*!
+	* \brief Checks whether the IP address is valid
+	* \return true If successful
+	*/
+
 	inline bool IpAddress::IsValid() const
 	{
 		return m_isValid;
 	}
 
+	/*!
+	* \brief Sets the port
+	*
+	* \param port Port attached to the IP address
+	*/
+
 	inline void IpAddress::SetPort(UInt16 port)
 	{
 		m_port = port;
 	}
 
+	/*!
+	* \brief Converts IpAddress to IPv4
+	* \return Corresponding IPv4
+	*
+	* \remark Produces a NazaraAssert if net protocol is not IPv4
+	*/
+
 	inline IpAddress::IPv4 IpAddress::ToIPv4() const
 	{
 		NazaraAssert(m_isValid && m_protocol == NetProtocol_IPv4, "Address is not a valid IPv4");
@@ -77,6 +149,13 @@ namespace Nz
 		return m_ipv4;
 	}
 
+	/*!
+	* \brief Converts IpAddress to IPv6
+	* \return Corresponding IPv6
+	*
+	* \remark Produces a NazaraAssert if net protocol is not IPv6
+	*/
+
 	inline IpAddress::IPv6 IpAddress::ToIPv6() const
 	{
 		NazaraAssert(m_isValid && m_protocol == NetProtocol_IPv6, "IP is not a valid IPv6");
@@ -84,6 +163,13 @@ namespace Nz
 		return m_ipv6;
 	}
 
+	/*!
+	* \brief Converts IpAddress to UInt32
+	* \return Corresponding UInt32
+	*
+	* \remark Produces a NazaraAssert if net protocol is not IPv4
+	*/
+
 	inline UInt32 IpAddress::ToUInt32() const
 	{
 		NazaraAssert(m_isValid && m_protocol == NetProtocol_IPv4, "Address is not a valid IPv4");
@@ -94,17 +180,40 @@ namespace Nz
 		       UInt32(m_ipv4[3]) << 0;
 	}
 
+	/*!
+	* \brief Converts IpAddress to boolean
+	* \return true If IpAddress is valid
+	*
+	* \see IsValid
+	*/
+
 	inline IpAddress::operator bool() const
 	{
 		return IsValid();
 	}
 
+	/*!
+	* \brief Output operator
+	* \return The stream
+	*
+	* \param out The stream
+	* \param address The address to output
+	*/
+
 	inline std::ostream& operator<<(std::ostream& out, const IpAddress& address)
 	{
 		out << "IpAddress(" << address.ToString() << ')';
 		return out;
 	}
 
+	/*!
+	* \brief Compares the IpAddress to other one
+	* \return true if the ip addresses are the same
+	*
+	* \param first First ip address to compare
+	* \param second Second ip address to compare with
+	*/
+
 	inline bool operator==(const IpAddress& first, const IpAddress& second)
 	{
 		// We need to check the validity of each address before comparing them
@@ -146,11 +255,27 @@ namespace Nz
 		return true;
 	}
 
+	/*!
+	* \brief Compares the IpAddress to other one
+	* \return false if the ip addresses are the same
+	*
+	* \param first First ip address to compare
+	* \param second Second ip address to compare with
+	*/
+
 	inline bool operator!=(const IpAddress& first, const IpAddress& second)
 	{
 		return !operator==(first, second);
 	}
 
+	/*!
+	* \brief Compares the IpAddress to other one
+	* \return true if this ip address is inferior to the other one
+	*
+	* \param first First ip address to compare
+	* \param second Second ip address to compare with
+	*/
+
 	inline bool operator<(const IpAddress& first, const IpAddress& second)
 	{
 		// If the second address is invalid, there's no way we're lower than it
@@ -196,16 +321,40 @@ namespace Nz
 		return false; //< Same address
 	}
 
+	/*!
+	* \brief Compares the IpAddress to other one
+	* \return true if this ip address is inferior or equal to the other one
+	*
+	* \param first First ip address to compare
+	* \param second Second ip address to compare with
+	*/
+
 	inline bool operator<=(const IpAddress& first, const IpAddress& second)
 	{
 		return !operator<(second, first);
 	}
 
+	/*!
+	* \brief Compares the IpAddress to other one
+	* \return true if this ip address is greather to the other one
+	*
+	* \param first First ip address to compare
+	* \param second Second ip address to compare with
+	*/
+
 	inline bool operator>(const IpAddress& first, const IpAddress& second)
 	{
 		return second < first;
 	}
 
+	/*!
+	* \brief Compares the IpAddress to other one
+	* \return true if this ip address is greather or equal to the other one
+	*
+	* \param first First ip address to compare
+	* \param second Second ip address to compare with
+	*/
+
 	inline bool operator>=(const IpAddress& first, const IpAddress& second)
 	{
 		return !operator<(first, second);
@@ -217,6 +366,13 @@ namespace std
 	template<>
 	struct hash<Nz::IpAddress>
 	{
+		/*!
+		* \brief Converts IpAddress to hash
+		* \return Hash of the IpAddress
+		*
+		* \param ip IpAddress to hash
+		*/
+
 		size_t operator()(const Nz::IpAddress& ip) const
 		{
 			if (!ip)
@@ -224,7 +380,7 @@ namespace std
 
 			// This is SDBM adapted for IP addresses, tested to generate the least collisions possible
 			// (It doesn't mean it cannot be improved though)
-			std::size_t h = 0;
+			std::size_t hash = 0;
 			switch (ip.GetProtocol())
 			{
 				case Nz::NetProtocol_Any:
@@ -233,20 +389,20 @@ namespace std
 
 				case Nz::NetProtocol_IPv4:
 				{
-					h = ip.ToUInt32() + (h << 6) + (h << 16) - h;
+					hash = ip.ToUInt32() + (hash << 6) + (hash << 16) - hash;
 					break;
 				}
 				case Nz::NetProtocol_IPv6:
 				{
 					Nz::IpAddress::IPv6 v6 = ip.ToIPv6();
 					for (std::size_t i = 0; i < v6.size(); i++)
-						h = v6[i] + (h << 6) + (h << 16) - h;
+						hash = v6[i] + (hash << 6) + (hash << 16) - hash;
 
 					break;
 				}
 			}
 
-			return ip.GetPort() + (h << 6) + (h << 16) - h;
+			return ip.GetPort() + (hash << 6) + (hash << 16) - hash;
 		}
 	};
 }

include/Nazara/Network/NetPacket.inl

@@ -9,21 +9,46 @@
 
 namespace Nz
 {
+	/*!
+	* \brief Constructs a NetPacket object by default
+	*/
+
 	inline NetPacket::NetPacket() :
 	m_netCode(NetCode_Invalid)
 	{
 	}
 
+	/*!
+	* \brief Constructs a NetPacket object with a packet number and a minimal capacity
+	*
+	* \param netCode Packet number
+	* \param minCapacity Minimal capacity of the packet
+	*/
+
 	inline NetPacket::NetPacket(UInt16 netCode, std::size_t minCapacity)
 	{
 		Reset(netCode, minCapacity);
 	}
 
+	/*!
+	* \brief Constructs a NetPacket object with a packet number and raw memory
+	*
+	* \param netCode Packet number
+	* \param ptr Raw memory
+	* \param size Size of the memory
+	*/
+
 	inline NetPacket::NetPacket(UInt16 netCode, const void* ptr, std::size_t size)
 	{
 		Reset(netCode, ptr, size);
 	}
 
+	/*!
+	* \brief Constructs a NetPacket object with another one by move semantic
+	*
+	* \param packet NetPacket to move into this
+	*/
+
 	inline NetPacket::NetPacket(NetPacket&& packet) :
 	ByteStream(std::move(packet)),
 	m_buffer(std::move(packet.m_buffer)),
@@ -35,12 +60,23 @@ namespace Nz
 		SetStream(&m_memoryStream);
 	}
 
+	/*!
+	* \brief Destructs the object
+	*/
+
 	inline NetPacket::~NetPacket()
 	{
 		FlushBits(); //< Needs to be done here as the stream will be freed before ByteStream calls it
 		FreeStream();
 	}
 
+	/*!
+	* \brief Gets the raw buffer
+	* \return Constant raw buffer
+	*
+	* \remark Produces a NazaraAssert if internal buffer is invalid
+	*/
+
 	inline const UInt8* NetPacket::GetConstData() const
 	{
 		NazaraAssert(m_buffer, "Invalid buffer");
@@ -48,6 +84,13 @@ namespace Nz
 		return m_buffer->GetConstBuffer();
 	}
 
+	/*!
+	* \brief Gets the raw buffer
+	* \return Raw buffer
+	*
+	* \remark Produces a NazaraAssert if internal buffer is invalid
+	*/
+
 	inline UInt8* NetPacket::GetData() const
 	{
 		NazaraAssert(m_buffer, "Invalid buffer");
@@ -55,6 +98,11 @@ namespace Nz
 		return m_buffer->GetBuffer();
 	}
 
+	/*!
+	* \brief Gets the size of the data
+	* \return Size of the data
+	*/
+
 	inline size_t NetPacket::GetDataSize() const
 	{
 		if (m_buffer)
@@ -63,22 +111,46 @@ namespace Nz
 			return 0;
 	}
 
+	/*!
+	* \brief Gets the packet number
+	* \return Packet number
+	*/
+
 	inline UInt16 NetPacket::GetNetCode() const
 	{
 		return m_netCode;
 	}
 
+	/*!
+	* \brief Resets the packet
+	*/
+
 	inline void NetPacket::Reset()
 	{
 		FreeStream();
 	}
 
+	/*!
+	* \brief Resets the packet with a packet number and a minimal capacity
+	*
+	* \param netCode Packet number
+	* \param minCapacity Minimal capacity of the packet
+	*/
+
 	inline void NetPacket::Reset(UInt16 netCode, std::size_t minCapacity)
 	{
 		InitStream(HeaderSize + minCapacity, HeaderSize, OpenMode_ReadWrite);
 		m_netCode = netCode;
 	}
 
+	/*!
+	* \brief Resets the packet with a packet number and raw memory
+	*
+	* \param netCode Packet number
+	* \param ptr Raw memory
+	* \param size Size of the memory
+	*/
+
 	inline void NetPacket::Reset(UInt16 netCode, const void* ptr, std::size_t size)
 	{
 		InitStream(HeaderSize + size, HeaderSize, OpenMode_ReadOnly);
@@ -88,6 +160,14 @@ namespace Nz
 		m_netCode = netCode;
 	}
 
+	/*!
+	* \brief Resizes the packet
+	*
+	* \param newSize Size for the resizing operation
+	*
+	* \remark Produces a NazaraAssert if internal buffer is invalid
+	*/
+
 	inline void NetPacket::Resize(std::size_t newSize)
 	{
 		NazaraAssert(m_buffer, "Invalid buffer");
@@ -95,11 +175,24 @@ namespace Nz
 		m_buffer->Resize(newSize);
 	}
 
+	/*!
+	* \brief Sets the packet number
+	*
+	* \param netCode Packet number
+	*/
+
 	inline void NetPacket::SetNetCode(UInt16 netCode)
 	{
 		m_netCode = netCode;
 	}
 
+	/*!
+	* \brief Moves the NetPacket into this
+	* \return A reference to this
+	*
+	* \param packet NetPacket to move in this
+	*/
+
 	inline NetPacket& Nz::NetPacket::operator=(NetPacket&& packet)
 	{
 		FreeStream();

include/Nazara/Network/RUdpConnection.inl

@@ -8,31 +8,66 @@
 
 namespace Nz
 {
+	/*!
+	* \brief Closes the connection
+	*/
+
 	inline void RUdpConnection::Close()
 	{
 		m_socket.Close();
 	}
 
+	/*!
+	* \brief Disconnects the connection
+	*
+	* \see Close
+	*/
+
 	inline void RUdpConnection::Disconnect()
 	{
 		Close();
 	}
 
+	/*!
+	* \brief Gets the bound address
+	* \return IpAddress we are linked to
+	*/
+
 	inline IpAddress RUdpConnection::GetBoundAddress() const
 	{
 		return m_socket.GetBoundAddress();
 	}
 
+	/*!
+	* \brief Gets the port of the bound address
+	* \return Port we are linked to
+	*/
+
 	inline UInt16 RUdpConnection::GetBoundPort() const
 	{
 		return m_socket.GetBoundPort();
 	}
 
+	/*!
+	* \brief Gets the last error
+	* \return Socket error
+	*/
+
 	inline SocketError RUdpConnection::GetLastError() const
 	{
 		return m_lastError;
 	}
 
+	/*!
+	* \brief Listens to a socket
+	* \return true If successfully bound
+	*
+	* \param protocol Net protocol to listen to
+	* \param port Port to listen to
+	*
+	* \remark Produces a NazaraAssert if protocol is unknown or any
+	*/
+
 	inline bool RUdpConnection::Listen(NetProtocol protocol, UInt16 port)
 	{
 		NazaraAssert(protocol != NetProtocol_Any, "Any protocol not supported for Listen"); //< TODO
@@ -59,16 +94,36 @@ namespace Nz
 		return Listen(any);
 	}
 
+	/*!
+	* \brief Sets the protocol id
+	*
+	* \param protocolId Protocol ID like NNet
+	*/
+
 	inline void RUdpConnection::SetProtocolId(UInt32 protocolId)
 	{
 		m_protocol = protocolId;
 	}
 
+	/*!
+	* \brief Sets the time before ack
+	*
+	* \param Time before acking to send many together (in ms)
+	*/
+
 	inline void RUdpConnection::SetTimeBeforeAck(UInt32 ms)
 	{
 		m_forceAckSendTime = ms * 1000; //< Store in microseconds for easier handling
 	}
-	
+
+	/*!
+	* \brief Computes the difference of sequence
+	* \return Delta between the two sequences
+	*
+	* \param sequence First sequence
+	* \param sequence2 Second sequence
+	*/
+
 	inline unsigned int RUdpConnection::ComputeSequenceDifference(SequenceIndex sequence, SequenceIndex sequence2)
 	{
 		unsigned int difference;
@@ -77,9 +132,16 @@ namespace Nz
 		else
 			difference = sequence - sequence2;
 
-		return 0;
+		return difference;
 	}
 
+	/*!
+	* \brief Checks whether the peer has pending packets
+	* \return true If it is the case
+	*
+	* \param peer Data relative to the peer
+	*/
+
 	inline bool RUdpConnection::HasPendingPackets(PeerData& peer)
 	{
 		for (unsigned int priority = PacketPriority_Highest; priority <= PacketPriority_Lowest; ++priority)
@@ -94,6 +156,14 @@ namespace Nz
 		return false;
 	}
 
+	/*!
+	* \brief Checks whether the ack is more recent
+	* \return true If it is the case
+	*
+	* \param ack First sequence
+	* \param ack2 Second sequence
+	*/
+
 	inline bool RUdpConnection::IsAckMoreRecent(SequenceIndex ack, SequenceIndex ack2)
 	{
 		constexpr SequenceIndex maxDifference = std::numeric_limits<SequenceIndex>::max() / 2;
@@ -106,6 +176,13 @@ namespace Nz
 			return false; ///< Same ack
 	}
 
+	/*!
+	* \brief Checks whether the connection is reliable
+	* \return true If it is the case
+	*
+	* \remark Produces a NazaraError if enumeration is invalid
+	*/
+
 	inline bool RUdpConnection::IsReliable(PacketReliability reliability)
 	{
 		switch (reliability)
@@ -122,6 +199,14 @@ namespace Nz
 		return false;
 	}
 
+	/*!
+	* \brief Simulates the loss of packets on network
+	*
+	* \param packetLoss Ratio of packet loss according to bernoulli distribution
+	*
+	* \remark Produces a NazaraAssert if packetLoss is not in between 0.0 and 1.0
+	*/
+
 	inline void RUdpConnection::SimulateNetwork(double packetLoss)
 	{
 		NazaraAssert(packetLoss >= 0.0 && packetLoss <= 1.0, "Packet loss must be in range [0..1]");

include/Nazara/Network/TcpClient.hpp

@@ -79,8 +79,8 @@ namespace Nz
 			PendingPacket m_pendingPacket;
 			UInt64 m_keepAliveInterval;
 			UInt64 m_keepAliveTime;
-			bool m_isKeepAliveEnabled;
 			bool m_isLowDelayEnabled;
+			bool m_isKeepAliveEnabled;
 	};
 }
 

include/Nazara/Network/TcpClient.inl

@@ -7,6 +7,10 @@
 
 namespace Nz
 {
+	/*!
+	* \brief Constructs a TcpClient object by default
+	*/
+
 	inline TcpClient::TcpClient() :
 	AbstractSocket(SocketType_TCP),
 	Stream(StreamOption_Sequential),
@@ -17,31 +21,62 @@ namespace Nz
 	{
 	}
 
+	/*!
+	* \brief Disconnects the connection
+	*
+	* \see Close
+	*/
+
 	inline void TcpClient::Disconnect()
 	{
 		Close();
 	}
 
+	/*!
+	* \brief Gets the interval between two keep alive pings
+	* \return Interval in milliseconds between two pings
+	*/
+
 	inline UInt64 TcpClient::GetKeepAliveInterval() const
 	{
 		return m_keepAliveInterval;
 	}
 
+	/*!
+	* \brief Gets the time before expiration of connection
+	* \return Time in milliseconds before expiration
+	*/
+
 	inline UInt64 TcpClient::GetKeepAliveTime() const
 	{
 		return m_keepAliveTime;
 	}
 
+	/*!
+	* \brief Gets the remote address
+	* \return Address of peer
+	*/
+
 	inline IpAddress TcpClient::GetRemoteAddress() const
 	{
 		return m_peerAddress;
 	}
 
+	/*!
+	* \brief Checks whether low delay is enabled
+	* \return true If it is the case
+	*/
+
 	inline bool TcpClient::IsLowDelayEnabled() const
 	{
 		return m_isLowDelayEnabled;
 	}
 
+	/*!
+	* \brief Checks whether the keep alive flag is enabled
+	* \return true If it is the case
+	*/
+
 	inline bool TcpClient::IsKeepAliveEnabled() const
 	{
 		return m_isKeepAliveEnabled;

include/Nazara/Network/TcpServer.inl

@@ -7,27 +7,58 @@
 
 namespace Nz
 {
+	/*!
+	* \brief Constructs a TcpServer object by default
+	*/
+
 	inline TcpServer::TcpServer() :
 	AbstractSocket(SocketType_TCP)
 	{
 	}
 
+	/*!
+	* \brief Constructs a TcpServer object with another one by move semantic
+	*
+	* \param tcpServer TcpServer to move into this
+	*/
+
 	inline TcpServer::TcpServer(TcpServer&& tcpServer) :
 	AbstractSocket(std::move(tcpServer)),
 	m_boundAddress(std::move(tcpServer.m_boundAddress))
 	{
 	}
 
+	/*!
+	* \brief Gets the bound address
+	* \return IpAddress we are linked to
+	*/
+
 	inline IpAddress TcpServer::GetBoundAddress() const
 	{
 		return m_boundAddress;
 	}
 
+	/*!
+	* \brief Gets the port of the bound address
+	* \return Port we are linked to
+	*/
+
 	inline UInt16 TcpServer::GetBoundPort() const
 	{
 		return m_boundAddress.GetPort();
 	}
 
+	/*!
+	* \brief Listens to a socket
+	* \return State of the socket
+	*
+	* \param protocol Net protocol to listen to
+	* \param port Port to listen to
+	* \param queueSize Size of the queue
+	*
+	* \remark Produces a NazaraAssert if protocol is unknown or any
+	*/
+
 	inline SocketState TcpServer::Listen(NetProtocol protocol, UInt16 port, unsigned int queueSize)
 	{
 		NazaraAssert(protocol != NetProtocol_Any, "Any protocol not supported for Listen"); //< TODO

include/Nazara/Network/UdpSocket.hpp

@@ -49,7 +49,6 @@ namespace Nz
 			void OnOpened() override;
 
 			IpAddress m_boundAddress;
-			SocketState m_state;
 			bool m_isBroadCastingEnabled;
 	};
 }

include/Nazara/Network/UdpSocket.inl

@@ -6,24 +6,46 @@
 
 namespace Nz
 {
+	/*!
+	* \brief Constructs a UdpSocket object by default
+	*/
+
 	inline UdpSocket::UdpSocket() :
 	AbstractSocket(SocketType_UDP)
 	{
 	}
 
+	/*!
+	* \brief Constructs a UdpSocket object with a net protocol
+	*
+	* \param protocol Net protocol to use
+	*/
+
 	inline UdpSocket::UdpSocket(NetProtocol protocol) :
 	UdpSocket()
 	{
 		Create(protocol);
 	}
 
+	/*!
+	* \brief Constructs a UdpSocket object with another one by move semantic
+	*
+	* \param udpSocket UdpSocket to move into this
+	*/
+
 	inline UdpSocket::UdpSocket(UdpSocket&& udpSocket) :
 	AbstractSocket(std::move(udpSocket)),
-	m_boundAddress(std::move(udpSocket.m_boundAddress)),
-	m_state(udpSocket.m_state)
+	m_boundAddress(std::move(udpSocket.m_boundAddress))
 	{
 	}
 
+	/*!
+	* \brief Binds a specific port
+	* \return State of the socket
+	*
+	* \param port Port to bind
+	*/
+
 	inline SocketState UdpSocket::Bind(UInt16 port)
 	{
 		IpAddress any;
@@ -47,6 +69,13 @@ namespace Nz
 		return Bind(any);
 	}
 
+	/*!
+	* \brief Creates a UDP socket
+	* \return true If successful
+	*
+	* \param protocol Net protocol to use
+	*/
+
 	bool UdpSocket::Create(NetProtocol protocol)
 	{
 		NazaraAssert(protocol != NetProtocol_Unknown, "Invalid protocol");
@@ -54,21 +83,41 @@ namespace Nz
 		return Open(protocol);
 	}
 
+	/*!
+	* \brief Gets the bound address
+	* \return IpAddress we are linked to
+	*/
+
 	inline IpAddress UdpSocket::GetBoundAddress() const
 	{
 		return m_boundAddress;
 	}
 
+	/*!
+	* \brief Gets the port of the bound address
+	* \return Port we are linked to
+	*/
+
 	inline UInt16 UdpSocket::GetBoundPort() const
 	{
 		return m_boundAddress.GetPort();
 	}
 
+	/*!
+	* \brief Gets the state of the socket
+	* \return State of the socket
+	*/
+
 	inline SocketState UdpSocket::GetState() const
 	{
 		return m_state;
 	}
 
+	/*!
+	* \brief Checks whether the broadcasting is enabled
+	* \return true If it is the case
+	*/
+
 	inline bool UdpSocket::IsBroadcastingEnabled() const
 	{
 		return m_isBroadCastingEnabled;