Typos

Source/Urho3D/AngelScript/Script.cpp

@@ -49,7 +49,7 @@ class ScriptResourceRouter : public ResourceRouter
     {
     }
 
-    /// Check if request is for an AngelScript file and reroute to compiled version if necessary (.as file not available)
+    /// Check if request is for an AngelScript file and reroute to compiled version if necessary (.as file not available).
     void Route(String& name, ResourceRequest requestType) override
     {
         String extension = GetExtension(name);

Source/Urho3D/AngelScript/ScriptAPI.h

@@ -56,7 +56,7 @@ void RegisterNetworkAPI(asIScriptEngine* engine);
 void RegisterDatabaseAPI(asIScriptEngine* engine);
 #endif
 #ifdef URHO3D_IK
-/// Register the inverse kinematics library to script
+/// Register the inverse kinematics library to script.
 void RegisterIKAPI(asIScriptEngine* engine);
 #endif
 #ifdef URHO3D_PHYSICS

Source/Urho3D/AngelScript/ScriptEventListener.h

@@ -52,7 +52,7 @@ struct DelayedCall
 class URHO3D_API ScriptEventListener
 {
 public:
-    /// Destruct
+    /// Destruct.
     virtual ~ScriptEventListener() = default;
 
     /// Add a scripted event handler.

Source/Urho3D/AngelScript/ScriptFile.h

@@ -113,7 +113,7 @@ public:
     /// Return whether script compiled successfully.
     bool IsCompiled() const { return compiled_; }
 
-    /// Clean up an event invoker object when its associated script object no longer exists
+    /// Clean up an event invoker object when its associated script object no longer exists.
     void CleanupEventInvoker(asIScriptObject* object);
 
 private:
@@ -146,7 +146,7 @@ private:
     HashMap<asITypeInfo*, HashMap<String, asIScriptFunction*> > methods_;
     /// Delayed function calls.
     Vector<DelayedCall> delayedCalls_;
-    /// Event helper objects for handling procedural or non-ScriptInstance script events
+    /// Event helper objects for handling procedural or non-ScriptInstance script events.
     HashMap<asIScriptObject*, SharedPtr<ScriptEventInvoker> > eventInvokers_;
     /// Byte code for asynchronous loading.
     SharedArrayPtr<unsigned char> loadByteCode_;

Source/Urho3D/AngelScript/ScriptInstance.h

@@ -202,7 +202,7 @@ private:
     Vector<DelayedCall> delayedCalls_;
     /// Attributes, including script object variables.
     Vector<AttributeInfo> attributeInfos_;
-    /// Storage for unapplied node and component ID attributes
+    /// Storage for unapplied node and component ID attributes.
     HashMap<AttributeInfo*, unsigned> idAttributes_;
     /// Storage for attributes while script object is being hot-reloaded.
     HashMap<String, Variant> storedAttributes_;

Source/Urho3D/Audio/Sound.h

@@ -105,7 +105,7 @@ public:
     /// Return whether is compressed.
     bool IsCompressed() const { return compressed_; }
 
-    /// Fix interpolation by copying data from loop start to loop end (looped), or adding silence (oneshot.) Called internally, does not normally need to be called, unless the sound data is modified manually on the fly.
+    /// Fix interpolation by copying data from loop start to loop end (looped), or adding silence (oneshot). Called internally, does not normally need to be called, unless the sound data is modified manually on the fly.
     void FixInterpolation();
 
 private:

Source/Urho3D/Audio/SoundListener.h

@@ -27,7 +27,7 @@
 namespace Urho3D
 {
 
-/// %Sound listener component
+/// %Sound listener component.
 class URHO3D_API SoundListener : public Component
 {
     URHO3D_OBJECT(SoundListener, Component);

Source/Urho3D/Audio/SoundSource.h

@@ -43,7 +43,7 @@ class URHO3D_API SoundSource : public Component
 public:
     /// Construct.
     explicit SoundSource(Context* context);
-    /// Destruct. Remove self from the audio subsystem
+    /// Destruct. Remove self from the audio subsystem.
     ~SoundSource() override;
     /// Register object factory.
     static void RegisterObject(Context* context);
@@ -120,7 +120,7 @@ public:
     void SetPositionAttr(int value);
     /// Return sound attribute.
     ResourceRef GetSoundAttr() const;
-    /// Set sound playing attribute
+    /// Set sound playing attribute.
     void SetPlayingAttr(bool value);
     /// Return sound position attribute.
     int GetPositionAttr() const;

Source/Urho3D/Container/FlagSet.h

@@ -46,13 +46,13 @@ template <class E>
 class FlagSet
 {
 public:
-    /// Enum type
+    /// Enum type.
     using Enum = E;
-    /// Integer type
+    /// Integer type.
     using Integer = typename std::underlying_type<Enum>::type;
 
 public:
-    /// Ctor by integer
+    /// Ctor by integer.
     explicit FlagSet(Integer value)
         : value_(value)
     {
@@ -232,7 +232,7 @@ public:
     unsigned ToHash() const { return static_cast<unsigned>(value_); }
 
 protected:
-    /// Value
+    /// Value.
     Integer value_ = 0;
 };
 

Source/Urho3D/Container/HashMap.h

@@ -777,7 +777,7 @@ private:
     /// Compare two nodes.
     static bool CompareNodes(Node*& lhs, Node*& rhs) { return lhs->pair_.first_ < rhs->pair_.first_; }
 
-    /// Compute a hash based on the key and the bucket size
+    /// Compute a hash based on the key and the bucket size.
     unsigned Hash(const T& key) const { return MakeHash(key) & (NumBuckets() - 1); }
 };
 

Source/Urho3D/Container/HashSet.h

@@ -637,7 +637,7 @@ private:
     /// Compare two nodes.
     static bool CompareNodes(Node*& lhs, Node*& rhs) { return lhs->key_ < rhs->key_; }
 
-    /// Compute a hash based on the key and the bucket size
+    /// Compute a hash based on the key and the bucket size.
     unsigned Hash(const T& key) const { return MakeHash(key) & (NumBuckets() - 1); }
 };
 

Source/Urho3D/Container/LinkedList.h

@@ -143,7 +143,7 @@ public:
         return false;
     }
 
-    /// Erase an element when the previous element is known (optimization.) Return true if successful.
+    /// Erase an element when the previous element is known (optimization). Return true if successful.
     bool Erase(T* element, T* previous)
     {
         if (previous && previous->next_ == element)

Source/Urho3D/Container/Str.h

@@ -505,7 +505,7 @@ public:
     /// Compare two C strings.
     static int Compare(const char* lhs, const char* rhs, bool caseSensitive);
 
-    /// Position for "not found."
+    /// Position for "not found".
     static const unsigned NPOS = 0xffffffff;
     /// Initial dynamic allocation size.
     static const unsigned MIN_CAPACITY = 8;

Source/Urho3D/Container/Vector.h

@@ -79,7 +79,7 @@ public:
         DoInsertElements(0, vector.Begin(), vector.End(), CopyTag{});
     }
 
-    /// Copy-construct from another vector (iterator version)
+    /// Copy-construct from another vector (iterator version).
     Vector(ConstIterator start, ConstIterator end)
     {
         DoInsertElements(0, start, end, CopyTag{});

Source/Urho3D/Core/Context.h

@@ -133,13 +133,13 @@ public:
     /// Return subsystem by type.
     Object* GetSubsystem(StringHash type) const;
 
-    /// Return global variable based on key
+    /// Return global variable based on key.
     const Variant& GetGlobalVar(StringHash key) const;
 
     /// Return all global variables.
     const VariantMap& GetGlobalVars() const { return globalVars_; }
 
-    /// Set global variable with the respective key and value
+    /// Set global variable with the respective key and value.
     void SetGlobalVar(StringHash key, const Variant& value);
 
     /// Return all subsystems.

Source/Urho3D/Core/Object.h

@@ -126,7 +126,7 @@ public:
     void UnsubscribeFromEvents(Object* sender);
     /// Unsubscribe from all events.
     void UnsubscribeFromAllEvents();
-    /// Unsubscribe from all events except those listed, and optionally only those with userdata (script registered events.)
+    /// Unsubscribe from all events except those listed, and optionally only those with userdata (script registered events).
     void UnsubscribeFromAllEventsExcept(const PODVector<StringHash>& exceptions, bool onlyUserData);
     /// Send event to all subscribers.
     void SendEvent(StringHash eventType);
@@ -142,11 +142,11 @@ public:
 
     /// Return execution context.
     Context* GetContext() const { return context_; }
-    /// Return global variable based on key
+    /// Return global variable based on key.
     const Variant& GetGlobalVar(StringHash key) const;
-    /// Return all global variables
+    /// Return all global variables.
     const VariantMap& GetGlobalVars() const;
-    /// Set global variable with the respective key and value
+    /// Set global variable with the respective key and value.
     void SetGlobalVar(StringHash key, const Variant& value);
     /// Return subsystem by type.
     Object* GetSubsystem(StringHash type) const;
@@ -293,7 +293,7 @@ protected:
     void* userData_;
 };
 
-/// Template implementation of the event handler invoke helper (stores a function pointer of specific class.)
+/// Template implementation of the event handler invoke helper (stores a function pointer of specific class).
 template <class T> class EventHandlerImpl : public EventHandler
 {
 public:

Source/Urho3D/Core/ProcessUtils.h

@@ -65,7 +65,7 @@ URHO3D_API String GetConsoleInput();
 URHO3D_API String GetPlatform();
 /// Return the number of physical CPU cores.
 URHO3D_API unsigned GetNumPhysicalCPUs();
-/// Return the number of logical CPUs (different from physical if hyperthreading is used.)
+/// Return the number of logical CPUs (different from physical if hyperthreading is used).
 URHO3D_API unsigned GetNumLogicalCPUs();
 /// Set minidump write location as an absolute path. If empty, uses default (UserProfile/AppData/Roaming/urho3D/crashdumps) Minidumps are only supported on MSVC compiler.
 URHO3D_API void SetMiniDumpDir(const String& pathName);

Source/Urho3D/Core/Profiler.h

@@ -227,7 +227,7 @@ protected:
     unsigned intervalFrames_;
 };
 
-/// Helper class for automatically beginning and ending a profiling block
+/// Helper class for automatically beginning and ending a profiling block.
 class URHO3D_API AutoProfileBlock
 {
 public:

Source/Urho3D/Core/StringUtils.h

@@ -107,7 +107,7 @@ URHO3D_API Matrix3x4 ToMatrix3x4(const char* source);
 URHO3D_API Matrix4 ToMatrix4(const String& source);
 /// Parse a Matrix4 from a C string.
 URHO3D_API Matrix4 ToMatrix4(const char* source);
-/// Convert a pointer to string (returns hexadecimal.)
+/// Convert a pointer to string (returns hexadecimal).
 URHO3D_API String ToString(void* value);
 /// Convert an unsigned integer to string as hexadecimal.
 URHO3D_API String ToStringHex(unsigned value);

Source/Urho3D/Core/Variant.h

@@ -597,7 +597,7 @@ public:
         return *this;
     }
 
-    /// Assign from a StringHash (convert to integer.)
+    /// Assign from a StringHash (convert to integer).
     Variant& operator =(const StringHash& rhs)
     {
         SetType(VAR_INT);

Source/Urho3D/Core/WorkQueue.h

@@ -132,7 +132,7 @@ private:
     List<SharedPtr<WorkItem> > poolItems_;
     /// Work item collection. Accessed only by the main thread.
     List<SharedPtr<WorkItem> > workItems_;
-    /// Work item prioritized queue for worker threads. Pointers are guaranteed to be valid (point to workItems.)
+    /// Work item prioritized queue for worker threads. Pointers are guaranteed to be valid (point to workItems).
     List<WorkItem*> queue_;
     /// Worker queue mutex.
     Mutex queueMutex_;

Source/Urho3D/Database/ODBC/ODBCConnection.h

@@ -40,7 +40,7 @@ public:
     DbConnection(Context* context, const String& connectionString);
     /// Destruct.
     virtual ~DbConnection() override;
-    /// Finalize all prepared statements, close all BLOB handles, and finish all sqlite3_backup objects
+    /// Finalize all prepared statements, close all BLOB handles, and finish all sqlite3_backup objects.
     void Finalize();
 
     /// Execute an SQL statements immediately. Send E_DBCURSOR event for each row in the resultset when useCursorEvent parameter is set to true.

Source/Urho3D/Database/SQLite/SQLiteConnection.h

@@ -40,7 +40,7 @@ public:
     DbConnection(Context* context, const String& connectionString);
     /// Destruct.
     ~DbConnection() override;
-    /// Finalize all prepared statements, close all BLOB handles, and finish all sqlite3_backup objects
+    /// Finalize all prepared statements, close all BLOB handles, and finish all sqlite3_backup objects.
     void Finalize();
 
     /// Execute an SQL statements immediately. Send E_DBCURSOR event for each row in the resultset when useCursorEvent parameter is set to true.

Source/Urho3D/Engine/Console.h

@@ -182,7 +182,7 @@ private:
     Vector<String> autoComplete_;
     /// Command auto complete current position.
     unsigned autoCompletePosition_;
-    /// Store the original line which is being auto-completed
+    /// Store the original line which is being auto-completed.
     String autoCompleteLine_;
 
     /// Flag when printing messages to prevent endless loop.

Source/Urho3D/Engine/DebugHud.h

@@ -90,7 +90,7 @@ public:
     /// Return maximum profiler block depth.
     unsigned GetProfilerMaxDepth() const { return profilerMaxDepth_; }
 
-    /// Return profiler accumulation interval in seconds
+    /// Return profiler accumulation interval in seconds.
     float GetProfilerInterval() const;
 
     /// Return whether showing 3D geometry primitive/batch count only.

Source/Urho3D/Engine/Engine.h

@@ -48,7 +48,7 @@ public:
     bool InitializeResourceCache(const VariantMap& parameters, bool removeOld = true);
     /// Run one frame.
     void RunFrame();
-    /// Create the console and return it. May return null if engine configuration does not allow creation (headless mode.)
+    /// Create the console and return it. May return null if engine configuration does not allow creation (headless mode).
     Console* CreateConsole();
     /// Create the debug hud.
     DebugHud* CreateDebugHud();
@@ -62,7 +62,7 @@ public:
     void SetTimeStepSmoothing(int frames);
     /// Set whether to pause update events and audio when minimized.
     void SetPauseMinimized(bool enable);
-    /// Set whether to exit automatically on exit request (window close button.)
+    /// Set whether to exit automatically on exit request (window close button).
     void SetAutoExit(bool enable);
     /// Override timestep of the next frame. Should be called in between RunFrame() calls.
     void SetNextTimeStep(float seconds);

Source/Urho3D/Graphics/AnimatedModel.cpp

@@ -701,7 +701,7 @@ void AnimatedModel::SetSkeleton(const Skeleton& skeleton, bool createBones)
 
     if (isMaster_)
     {
-        // Check if bone structure has stayed compatible (reloading the model.) In that case retain the old bones and animations
+        // Check if bone structure has stayed compatible (reloading the model). In that case retain the old bones and animations
         if (skeleton_.GetNumBones() == skeleton.GetNumBones())
         {
             Vector<Bone>& destBones = skeleton_.GetModifiableBones();

Source/Urho3D/Graphics/AnimatedModel.h

@@ -61,7 +61,7 @@ public:
     void Update(const FrameInfo& frame) override;
     /// Calculate distance and prepare batches for rendering. May be called from worker thread(s), possibly re-entrantly.
     void UpdateBatches(const FrameInfo& frame) override;
-    /// Prepare geometry for rendering. Called from a worker thread if possible (no GPU update.)
+    /// Prepare geometry for rendering. Called from a worker thread if possible (no GPU update).
     void UpdateGeometry(const FrameInfo& frame) override;
     /// Return whether a geometry update is necessary, and if it can happen in a worker thread.
     UpdateGeometryType GetUpdateGeometryType() override;
@@ -162,7 +162,7 @@ public:
     /// Return per-geometry bone mappings.
     const Vector<PODVector<unsigned> >& GetGeometryBoneMappings() const { return geometryBoneMappings_; }
 
-    /// Return per-geometry skin matrices. If empty, uses global skinning
+    /// Return per-geometry skin matrices. If empty, uses global skinning.
     const Vector<PODVector<Matrix3x4> >& GetGeometrySkinMatrices() const { return geometrySkinMatrices_; }
 
     /// Recalculate the bone bounding box. Normally called internally, but can also be manually called if up-to-date information before rendering is necessary.
@@ -185,7 +185,7 @@ private:
     void RemoveRootBone();
     /// Mark animation and skinning to require an update.
     void MarkAnimationDirty();
-    /// Mark animation and skinning to require a forced update (blending order changed.)
+    /// Mark animation and skinning to require a forced update (blending order changed).
     void MarkAnimationOrderDirty();
     /// Mark morphs to require an update.
     void MarkMorphsDirty();

Source/Urho3D/Graphics/Animation.h

@@ -92,7 +92,7 @@ struct URHO3D_API AnimationTrack
     String name_;
     /// Name hash.
     StringHash nameHash_;
-    /// Bitmask of included data (position, rotation, scale.)
+    /// Bitmask of included data (position, rotation, scale).
     AnimationChannelFlags channelMask_{};
     /// Keyframes.
     Vector<AnimationKeyFrame> keyFrames_;

Source/Urho3D/Graphics/AnimationController.h

@@ -125,7 +125,7 @@ public:
     bool SetLooped(const String& name, bool enable);
     /// Set animation speed. Return true on success.
     bool SetSpeed(const String& name, float speed);
-    /// Set animation autofade at end (non-looped animations only.) Zero time disables. Return true on success.
+    /// Set animation autofade at end (non-looped animations only). Zero time disables. Return true on success.
     bool SetAutoFade(const String& name, float fadeOutTime);
     /// Set whether an animation auto-removes on completion.
     bool SetRemoveOnCompletion(const String& name, bool removeOnCompletion);

Source/Urho3D/Graphics/AnimationState.cpp

@@ -53,7 +53,7 @@ AnimationState::AnimationState(AnimatedModel* model, Animation* animation) :
     layer_(0),
     blendingMode_(ABM_LERP)
 {
-    // Set default start bone (use all tracks.)
+    // Set default start bone (use all tracks)
     SetStartBone(nullptr);
 }
 

Source/Urho3D/Graphics/AnimationState.h

@@ -52,7 +52,7 @@ struct AnimationStateTrack
 {
     /// Construct with defaults.
     AnimationStateTrack();
-    /// Destruct
+    /// Destruct.
     ~AnimationStateTrack();
 
     /// Animation track.
@@ -104,9 +104,9 @@ public:
     /// Return animation.
     Animation* GetAnimation() const { return animation_; }
 
-    /// Return animated model this state belongs to (model mode.)
+    /// Return animated model this state belongs to (model mode).
     AnimatedModel* GetModel() const;
-    /// Return root scene node this state controls (node hierarchy mode.)
+    /// Return root scene node this state controls (node hierarchy mode).
     Node* GetNode() const;
     /// Return start bone.
     Bone* GetStartBone() const;
@@ -155,9 +155,9 @@ private:
     /// Apply track.
     void ApplyTrack(AnimationStateTrack& stateTrack, float weight, bool silent);
 
-    /// Animated model (model mode.)
+    /// Animated model (model mode).
     WeakPtr<AnimatedModel> model_;
-    /// Root scene node (node hierarchy mode.)
+    /// Root scene node (node hierarchy mode).
     WeakPtr<Node> node_;
     /// Animation.
     SharedPtr<Animation> animation_;

Source/Urho3D/Graphics/Batch.h

@@ -273,7 +273,7 @@ public:
     StringHash psExtraDefinesHash_;
 };
 
-/// Queue for shadow map draw calls
+/// Queue for shadow map draw calls.
 struct ShadowBatchQueue
 {
     /// Shadow map camera.
@@ -297,9 +297,9 @@ struct LightBatchQueue
     bool negative_;
     /// Shadow map depth texture.
     Texture2D* shadowMap_;
-    /// Lit geometry draw calls, base (replace blend mode)
+    /// Lit geometry draw calls, base (replace blend mode).
     BatchQueue litBaseBatches_;
-    /// Lit geometry draw calls, non-base (additive)
+    /// Lit geometry draw calls, non-base (additive).
     BatchQueue litBatches_;
     /// Shadow map split queues.
     Vector<ShadowBatchQueue> shadowSplits_;

Source/Urho3D/Graphics/BillboardSet.h

@@ -74,7 +74,7 @@ public:
     void ProcessRayQuery(const RayOctreeQuery& query, PODVector<RayQueryResult>& results) override;
     /// Calculate distance and prepare batches for rendering. May be called from worker thread(s), possibly re-entrantly.
     void UpdateBatches(const FrameInfo& frame) override;
-    /// Prepare geometry for rendering. Called from a worker thread if possible (no GPU update.)
+    /// Prepare geometry for rendering. Called from a worker thread if possible (no GPU update).
     void UpdateGeometry(const FrameInfo& frame) override;
     /// Return whether a geometry update is necessary, and if it can happen in a worker thread.
     UpdateGeometryType GetUpdateGeometryType() override;
@@ -91,7 +91,7 @@ public:
     void SetSorted(bool enable);
     /// Set whether billboards have fixed size on screen (measured in pixels) regardless of distance to camera. Default false.
     void SetFixedScreenSize(bool enable);
-    /// Set how the billboards should rotate in relation to the camera. Default is to follow camera rotation on all axes (FC_ROTATE_XYZ.)
+    /// Set how the billboards should rotate in relation to the camera. Default is to follow camera rotation on all axes (FC_ROTATE_XYZ).
     void SetFaceCameraMode(FaceCameraMode mode);
     /// Set minimal angle between billboard normal and look-at direction.
     void SetMinAngle(float angle);
@@ -191,9 +191,9 @@ private:
     bool bufferSizeDirty_;
     /// Vertex buffer needs rewrite flag.
     bool bufferDirty_;
-    /// Force update flag (ignore animation LOD momentarily.)
+    /// Force update flag (ignore animation LOD momentarily).
     bool forceUpdate_;
-    /// Update billboard geometry type
+    /// Update billboard geometry type.
     bool geometryTypeUpdate_;
     /// Sorting flag. Triggers a vertex buffer rewrite for each view this billboard set is rendered from.
     bool sortThisFrame_;

Source/Urho3D/Graphics/Camera.h

@@ -88,7 +88,7 @@ public:
     void SetOrthographic(bool enable);
     /// Set automatic aspect ratio based on viewport dimensions. Enabled by default.
     void SetAutoAspectRatio(bool enable);
-    /// Set projection offset. It needs to be calculated as (offset in pixels) / (viewport dimensions.)
+    /// Set projection offset. It needs to be calculated as (offset in pixels) / (viewport dimensions).
     void SetProjectionOffset(const Vector2& offset);
     /// Set reflection mode.
     void SetUseReflection(bool enable);
@@ -101,7 +101,7 @@ public:
     /// Set vertical flipping mode. Called internally by View to resolve OpenGL / Direct3D9 rendertarget sampling differences.
     void SetFlipVertical(bool enable);
     /// Set custom projection matrix, which should be specified in D3D convention with depth range 0 - 1. Disables auto aspect ratio.
-    /** Change any of the standard view parameters (FOV, far clip, zoom etc.) to revert to the standard projection.
+    /** Change any of the standard view parameters (FOV, far clip, zoom, etc.) to revert to the standard projection.
         Note that the custom projection is not serialized or replicated through the network.
      */
     void SetProjection(const Matrix4& projection);

Source/Urho3D/Graphics/DebugRenderer.h

@@ -131,7 +131,7 @@ public:
     /// Add a sphere sector. Angle ranges from 0 to 360. Identity Quaternion yields the filled portion of the sector upwards.
     void AddSphereSector(const Sphere& sphere, const Quaternion& rotation, float angle,
         bool drawLines, const Color& color, bool depthTest = true);
-    /// Add a cylinder
+    /// Add a cylinder.
     void AddCylinder(const Vector3& position, float radius, float height, const Color& color, bool depthTest = true);
     /// Add a skeleton.
     void AddSkeleton(const Skeleton& skeleton, const Color& color, bool depthTest = true);

Source/Urho3D/Graphics/DecalSet.h

@@ -89,7 +89,7 @@ struct Decal
 
     /// Decal age timer.
     float timer_;
-    /// Maximum time to live in seconds (0 = infinite)
+    /// Maximum time to live in seconds (0 = infinite).
     float timeToLive_;
     /// Local-space bounding box.
     BoundingBox boundingBox_;
@@ -120,7 +120,7 @@ public:
     void ProcessRayQuery(const RayOctreeQuery& query, PODVector<RayQueryResult>& results) override;
     /// Calculate distance and prepare batches for rendering. May be called from worker thread(s), possibly re-entrantly.
     void UpdateBatches(const FrameInfo& frame) override;
-    /// Prepare geometry for rendering. Called from a worker thread if possible (no GPU update.)
+    /// Prepare geometry for rendering. Called from a worker thread if possible (no GPU update).
     void UpdateGeometry(const FrameInfo& frame) override;
     /// Return whether a geometry update is necessary, and if it can happen in a worker thread.
     UpdateGeometryType GetUpdateGeometryType() override;
@@ -206,7 +206,7 @@ private:
     void UpdateBuffers();
     /// Recalculate skinning.
     void UpdateSkinning();
-    /// Update the batch (geometry type, shader data.)
+    /// Update the batch (geometry type, shader data).
     void UpdateBatch();
     /// Find bones after loading.
     void AssignBoneNodes();

Source/Urho3D/Graphics/Drawable.h

@@ -127,7 +127,7 @@ public:
     void OnSetEnabled() override;
     /// Process octree raycast. May be called from a worker thread.
     virtual void ProcessRayQuery(const RayOctreeQuery& query, PODVector<RayQueryResult>& results);
-    /// Update before octree reinsertion. Is called from a worker thread
+    /// Update before octree reinsertion. Is called from a worker thread.
     virtual void Update(const FrameInfo& frame) { }
     /// Calculate distance and prepare batches for rendering. May be called from worker thread(s), possibly re-entrantly.
     virtual void UpdateBatches(const FrameInfo& frame);

Source/Urho3D/Graphics/GPUObject.h

@@ -32,9 +32,9 @@ class Graphics;
 /// API-specific GPU object representation.
 union GPUObjectHandle
 {
-    /// Object pointer (Direct3D.)
+    /// Object pointer (Direct3D).
     void* ptr_;
-    /// Object name (OpenGL.)
+    /// Object name (OpenGL).
     unsigned name_;
 };
 

Source/Urho3D/Graphics/Graphics.h

@@ -194,7 +194,7 @@ public:
     void SetTexture(unsigned index, Texture* texture);
     /// Bind texture unit 0 for update. Called by Texture. Used only on OpenGL.
     void SetTextureForUpdate(Texture* texture);
-    /// Dirty texture parameters of all textures (when global settings change.)
+    /// Dirty texture parameters of all textures (when global settings change).
     void SetTextureParametersDirty();
     /// Set default texture filtering mode. Called by Renderer before rendering.
     void SetDefaultTextureFilterMode(TextureFilterMode mode);
@@ -279,7 +279,7 @@ public:
     /// Return window height in pixels.
     int GetHeight() const { return height_; }
 
-    /// Return multisample mode (1 = no multisampling.)
+    /// Return multisample mode (1 = no multisampling).
     int GetMultiSample() const { return multiSample_; }
 
     /// Return window size in pixels.
@@ -300,10 +300,10 @@ public:
     /// Return whether vertical sync is on.
     bool GetVSync() const { return vsync_; }
 
-    /// Return refresh rate when using vsync in fullscreen
+    /// Return refresh rate when using vsync in fullscreen.
     int GetRefreshRate() const { return refreshRate_; }
 
-    /// Return the current monitor index. Effective on in fullscreen
+    /// Return the current monitor index. Effective on in fullscreen.
     int GetMonitor() const { return monitor_; }
 
     /// Return whether triple buffering is enabled.
@@ -637,7 +637,7 @@ private:
     String windowTitle_;
     /// Window icon image.
     WeakPtr<Image> windowIcon_;
-    /// External window, null if not in use (default.)
+    /// External window, null if not in use (default).
     void* externalWindow_{};
     /// Window width in pixels.
     int width_{};
@@ -657,9 +657,9 @@ private:
     bool highDPI_{};
     /// Vertical sync flag.
     bool vsync_{};
-    /// Refresh rate in Hz. Only used in fullscreen, 0 when windowed
+    /// Refresh rate in Hz. Only used in fullscreen, 0 when windowed.
     int refreshRate_{};
-    /// Monitor index. Only used in fullscreen, 0 when windowed
+    /// Monitor index. Only used in fullscreen, 0 when windowed.
     int monitor_{};
     /// Triple buffering flag.
     bool tripleBuffer_{};

Source/Urho3D/Graphics/GraphicsDefs.h

@@ -33,7 +33,7 @@ namespace Urho3D
 
 class Vector3;
 
-/// Graphics capability support level. Web platform (Emscripten) also uses OpenGL ES, but is considered a desktop platform capability-wise
+// Graphics capability support level. Web platform (Emscripten) also uses OpenGL ES, but is considered a desktop platform capability-wise
 #if defined(IOS) || defined(TVOS) || defined(__ANDROID__) || defined(__arm__) || defined(__aarch64__)
 #define MOBILE_GRAPHICS
 #else

Source/Urho3D/Graphics/Light.h

@@ -109,7 +109,7 @@ struct URHO3D_API CascadeParameters
 
     /// Far clip values of the splits.
     Vector4 splits_;
-    /// The point relative to the total shadow range where shadow fade begins (0.0 - 1.0)
+    /// The point relative to the total shadow range where shadow fade begins (0.0 - 1.0).
     float fadeStart_{};
     /// Automatic depth bias adjustment strength.
     float biasAutoAdjust_{};

Source/Urho3D/Graphics/Material.h

@@ -317,7 +317,7 @@ private:
     bool specular_{};
     /// Flag for whether is subscribed to animation updates.
     bool subscribed_{};
-    /// Flag to suppress parameter hash and memory use recalculation when setting multiple shader parameters (loading or resetting the material.)
+    /// Flag to suppress parameter hash and memory use recalculation when setting multiple shader parameters (loading or resetting the material).
     bool batchedParameterUpdate_{};
     /// XML file used while loading.
     SharedPtr<XMLFile> loadXMLFile_;

Source/Urho3D/Graphics/Octree.h

@@ -35,7 +35,7 @@ class Octree;
 static const int NUM_OCTANTS = 8;
 static const unsigned ROOT_INDEX = M_MAX_UNSIGNED;
 
-/// %Octree octant
+/// %Octree octant.
 class URHO3D_API Octant
 {
 public:
@@ -152,11 +152,11 @@ protected:
     Octant* parent_;
     /// Octree root.
     Octree* root_;
-    /// Octant index relative to its siblings or ROOT_INDEX for root octant
+    /// Octant index relative to its siblings or ROOT_INDEX for root octant.
     unsigned index_;
 };
 
-/// %Octree component. Should be added only to the root scene node
+/// %Octree component. Should be added only to the root scene node.
 class URHO3D_API Octree : public Component, public Octant
 {
     URHO3D_OBJECT(Octree, Component);

Source/Urho3D/Graphics/OctreeQuery.h

@@ -207,7 +207,7 @@ struct URHO3D_API RayQueryResult
     Vector3 position_;
     /// Hit normal in world space. Negation of ray direction if per-triangle data not available.
     Vector3 normal_;
-    /// Hit texture position
+    /// Hit texture position.
     Vector2 textureUV_;
     /// Distance from ray origin.
     float distance_{};

Source/Urho3D/Graphics/OpenGL/OGLGraphicsImpl.h

@@ -80,7 +80,7 @@ class Context;
 using ConstantBufferMap = HashMap<unsigned, SharedPtr<ConstantBuffer> >;
 using ShaderProgramMap = HashMap<Pair<ShaderVariation*, ShaderVariation*>, SharedPtr<ShaderProgram> >;
 
-/// Cached state of a frame buffer object
+/// Cached state of a frame buffer object.
 struct FrameBufferObject
 {
     /// Frame buffer handle.

Source/Urho3D/Graphics/ParticleEffect.h

@@ -156,9 +156,9 @@ public:
     void SetConstantForce(const Vector3& force);
     /// Set particle velocity damping force.
     void SetDampingForce(float force);
-    /// Set emission active period length (0 = infinite.)
+    /// Set emission active period length (0 = infinite).
     void SetActiveTime(float time);
-    /// Set emission inactive period length (0 = infinite.)
+    /// Set emission inactive period length (0 = infinite).
     void SetInactiveTime(float time);
     /// Set minimum emission rate.
     void SetMinEmissionRate(float rate);
@@ -188,14 +188,14 @@ public:
     void SetSizeAdd(float sizeAdd);
     /// Set particle size multiplicative modifier.
     void SetSizeMul(float sizeMul);
-    /// Set how the particles should rotate in relation to the camera. Default is to follow camera rotation on all axes (FC_ROTATE_XYZ.)
+    /// Set how the particles should rotate in relation to the camera. Default is to follow camera rotation on all axes (FC_ROTATE_XYZ).
     void SetFaceCameraMode(FaceCameraMode mode);
 
     /// Add a color frame sorted in the correct position based on time.
     void AddColorTime(const Color& color, float time);
     /// Add a color frame sorted in the correct position based on time.
     void AddColorFrame(const ColorFrame& colorFrame);
-    /// Remove color frame at index
+    /// Remove color frame at index.
     void RemoveColorFrame(unsigned index);
     /// Set color animation of particles.
     void SetColorFrames(const Vector<ColorFrame>& colorFrames);
@@ -210,7 +210,7 @@ public:
     void AddTextureTime(const Rect& uv, float time);
     /// Add a texture frame sorted in the correct position based on time.
     void AddTextureFrame(const TextureFrame& textureFrame);
-    /// Remove texture frame at index
+    /// Remove texture frame at index.
     void RemoveTextureFrame(unsigned index);
     /// Set particle texture animation.
     void SetTextureFrames(const Vector<TextureFrame>& textureFrames);
@@ -265,10 +265,10 @@ public:
     /// Return particle velocity damping force.
     float GetDampingForce() const { return dampingForce_; }
 
-    /// Return emission active period length (0 = infinite.)
+    /// Return emission active period length (0 = infinite).
     float GetActiveTime() const { return activeTime_; }
 
-    /// Return emission inactive period length (0 = infinite.)
+    /// Return emission inactive period length (0 = infinite).
     float GetInactiveTime() const { return inactiveTime_; }
 
     /// Return minimum emission rate.

Source/Urho3D/Graphics/RenderPath.h

@@ -241,7 +241,7 @@ public:
     /// Return command at index, or null if does not exist.
     RenderPathCommand* GetCommand(unsigned index) { return index < commands_.Size() ? &commands_[index] : nullptr; }
 
-    /// Return a shader parameter (first appearance in any command.)
+    /// Return a shader parameter (first appearance in any command).
     const Variant& GetShaderParameter(const String& name) const;
 
     /// Rendertargets.

Source/Urho3D/Graphics/Renderer.cpp

@@ -1500,7 +1500,7 @@ void Renderer::UpdateQueuedViewport(unsigned index)
 
     auto* octree = scene->GetComponent<Octree>();
 
-    // Update octree (perform early update for drawables which need that, and reinsert moved drawables.)
+    // Update octree (perform early update for drawables which need that, and reinsert moved drawables).
     // However, if the same scene is viewed from multiple cameras, update the octree only once
     if (!updatedOctrees_.Contains(octree))
     {

Source/Urho3D/Graphics/Renderer.h

@@ -214,11 +214,11 @@ public:
     void SetShadowQuality(ShadowQuality quality);
     /// Set shadow softness, only works when SHADOWQUALITY_BLUR_VSM is used.
     void SetShadowSoftness(float shadowSoftness);
-    /// Set shadow parameters when VSM is used, they help to reduce light bleeding. LightBleeding must be in [0, 1[
+    /// Set shadow parameters when VSM is used, they help to reduce light bleeding. LightBleeding must be in [0, 1].
     void SetVSMShadowParameters(float minVariance, float lightBleedingReduction);
-    /// Set VSM shadow map multisampling level. Default 1 (no multisampling.)
+    /// Set VSM shadow map multisampling level. Default 1 (no multisampling).
     void SetVSMMultiSample(int multiSample);
-    /// Set post processing filter to the shadow map
+    /// Set post processing filter to the shadow map.
     void SetShadowMapFilter(Object* instance, ShadowMapFilter functionPtr);
     /// Set reuse of shadow maps. Default is true. If disabled, also transparent geometry can be shadowed.
     void SetReuseShadowMaps(bool enable);
@@ -240,11 +240,11 @@ public:
     void SetOccluderSizeThreshold(float screenSize);
     /// Set whether to thread occluder rendering. Default false.
     void SetThreadedOcclusion(bool enable);
-    /// Set shadow depth bias multiplier for mobile platforms to counteract possible worse shadow map precision. Default 1.0 (no effect.)
+    /// Set shadow depth bias multiplier for mobile platforms to counteract possible worse shadow map precision. Default 1.0 (no effect).
     void SetMobileShadowBiasMul(float mul);
-    /// Set shadow depth bias addition for mobile platforms to counteract possible worse shadow map precision. Default 0.0 (no effect.)
+    /// Set shadow depth bias addition for mobile platforms to counteract possible worse shadow map precision. Default 0.0 (no effect).
     void SetMobileShadowBiasAdd(float add);
-    /// Set shadow normal offset multiplier for mobile platforms to counteract possible worse shadow map precision. Default 1.0 (no effect.)
+    /// Set shadow normal offset multiplier for mobile platforms to counteract possible worse shadow map precision. Default 1.0 (no effect).
     void SetMobileNormalOffsetMul(float mul);
     /// Force reload of shaders.
     void ReloadShaders();
@@ -375,7 +375,7 @@ public:
     /// Return the shadowed pointlight indirection cube map.
     TextureCube* GetIndirectionCubeMap() const { return indirectionCubeMap_; }
 
-    /// Return the instancing vertex buffer
+    /// Return the instancing vertex buffer.
     VertexBuffer* GetInstancingBuffer() const { return dynamicInstancing_ ? instancingBuffer_.Get() : nullptr; }
 
     /// Return the frame update parameters.
@@ -461,7 +461,7 @@ private:
     void ResetShadowMaps();
     /// Remove all occlusion and screen buffers.
     void ResetBuffers();
-    /// Find variations for shadow shaders
+    /// Find variations for shadow shaders.
     String GetShadowVariations() const;
     /// Handle screen mode event.
     void HandleScreenMode(StringHash eventType, VariantMap& eventData);
@@ -506,9 +506,9 @@ private:
     HashMap<int, SharedPtr<Texture2D> > colorShadowMaps_;
     /// Shadow map allocations by resolution.
     HashMap<int, PODVector<Light*> > shadowMapAllocations_;
-    /// Instance of shadow map filter
+    /// Instance of shadow map filter.
     Object* shadowMapFilterInstance_{};
-    /// Function pointer of shadow map filter
+    /// Function pointer of shadow map filter.
     ShadowMapFilter shadowMapFilter_{};
     /// Screen buffers by resolution and format.
     HashMap<unsigned long long, Vector<SharedPtr<Texture> > > screenBuffers_;
@@ -574,9 +574,9 @@ private:
     unsigned numOcclusionBuffers_{};
     /// Number of temporary shadow cameras in use.
     unsigned numShadowCameras_{};
-    /// Number of primitives (3D geometry only.)
+    /// Number of primitives (3D geometry only).
     unsigned numPrimitives_{};
-    /// Number of batches (3D geometry only.)
+    /// Number of batches (3D geometry only).
     unsigned numBatches_{};
     /// Frame number on which shaders last changed.
     unsigned shadersChangedFrameNumber_{M_MAX_UNSIGNED};

Source/Urho3D/Graphics/RibbonTrail.h

@@ -81,7 +81,7 @@ public:
     void Update(const FrameInfo &frame) override;
     /// Calculate distance and prepare batches for rendering. May be called from worker thread(s), possibly re-entrantly.
     void UpdateBatches(const FrameInfo& frame) override;
-    /// Prepare geometry for rendering. Called from a worker thread if possible (no GPU update.)
+    /// Prepare geometry for rendering. Called from a worker thread if possible (no GPU update).
     void UpdateGeometry(const FrameInfo& frame) override;
     /// Return whether a geometry update is necessary, and if it can happen in a worker thread.
     UpdateGeometryType GetUpdateGeometryType() override;
@@ -197,7 +197,7 @@ private:
     void UpdateBufferSize();
     /// Rewrite RibbonTrail vertex buffer.
     void UpdateVertexBuffer(const FrameInfo& frame);
-    /// Update/Rebuild tail mesh only if position changed (called by UpdateBatches())
+    /// Update/Rebuild tail mesh only if position changed (called by UpdateBatches()).
     void UpdateTail(float timeStep);
     /// Geometry.
     SharedPtr<Geometry> geometry_;
@@ -211,7 +211,7 @@ private:
     bool bufferSizeDirty_;
     /// Vertex buffer needs rewrite flag.
     bool bufferDirty_;
-    /// Previous position of tail
+    /// Previous position of tail.
     Vector3 previousPosition_;
     /// Distance between points. Basically is tail length.
     float vertexDistance_;
@@ -229,7 +229,7 @@ private:
     float endScale_;
     /// Last scene timestep.
     float lastTimeStep_;
-    /// Lifetime
+    /// Lifetime.
     float lifetime_;
     /// Number of columns for every tails.
     unsigned tailColumn_;
@@ -241,7 +241,7 @@ private:
     Vector3 previousOffset_;
     /// Trail pointers for sorting.
     Vector<TrailPoint*> sortedPoints_;
-    /// Force update flag (ignore animation LOD momentarily.)
+    /// Force update flag (ignore animation LOD momentarily).
     bool forceUpdate_;
     /// Currently emitting flag.
     bool emitting_;

Source/Urho3D/Graphics/ShaderVariation.h

@@ -113,7 +113,7 @@ public:
     /// Return whether uses a parameter. Not applicable on OpenGL, where this information is contained in ShaderProgram instead.
     bool HasParameter(StringHash param) const { return parameters_.Contains(param); }
 
-    /// Return whether uses a texture unit (only for pixel shaders.) Not applicable on OpenGL, where this information is contained in ShaderProgram instead.
+    /// Return whether uses a texture unit (only for pixel shaders). Not applicable on OpenGL, where this information is contained in ShaderProgram instead.
     bool HasTextureUnit(TextureUnit unit) const { return useTextureUnits_[unit]; }
 
     /// Return all parameter definitions. Not applicable on OpenGL, where this information is contained in ShaderProgram instead.

Source/Urho3D/Graphics/TerrainPatch.h

@@ -48,7 +48,7 @@ public:
     void ProcessRayQuery(const RayOctreeQuery& query, PODVector<RayQueryResult>& results) override;
     /// Calculate distance and prepare batches for rendering. May be called from worker thread(s), possibly re-entrantly.
     void UpdateBatches(const FrameInfo& frame) override;
-    /// Prepare geometry for rendering. Called from a worker thread if possible (no GPU update.)
+    /// Prepare geometry for rendering. Called from a worker thread if possible (no GPU update).
     void UpdateGeometry(const FrameInfo& frame) override;
     /// Return whether a geometry update is necessary, and if it can happen in a worker thread.
     UpdateGeometryType GetUpdateGeometryType() override;

Source/Urho3D/Graphics/View.h

@@ -68,9 +68,9 @@ struct LightQueryResult
     unsigned shadowCasterEnd_[MAX_LIGHT_SPLITS];
     /// Combined bounding box of shadow casters in light projection space. Only used for focused spot lights.
     BoundingBox shadowCasterBox_[MAX_LIGHT_SPLITS];
-    /// Shadow camera near splits (directional lights only.)
+    /// Shadow camera near splits (directional lights only).
     float shadowNearSplits_[MAX_LIGHT_SPLITS];
-    /// Shadow camera far splits (directional lights only.)
+    /// Shadow camera far splits (directional lights only).
     float shadowFarSplits_[MAX_LIGHT_SPLITS];
     /// Shadow map split count.
     unsigned numSplits_;
@@ -214,7 +214,7 @@ private:
     void ExecuteRenderPathCommands();
     /// Set rendertargets for current render command.
     void SetRenderTargets(RenderPathCommand& command);
-    /// Set textures for current render command. Return whether depth write is allowed (depth-stencil not bound as a texture.)
+    /// Set textures for current render command. Return whether depth write is allowed (depth-stencil not bound as a texture).
     bool SetTextures(RenderPathCommand& command);
     /// Perform a quad rendering command.
     void RenderQuad(RenderPathCommand& command);
@@ -240,7 +240,7 @@ private:
     void ProcessShadowCasters(LightQueryResult& query, const PODVector<Drawable*>& drawables, unsigned splitIndex);
     /// Set up initial shadow camera view(s).
     void SetupShadowCameras(LightQueryResult& query);
-    /// Set up a directional light shadow camera
+    /// Set up a directional light shadow camera.
     void SetupDirLightShadowCamera(Camera* shadowCamera, Light* light, float nearSplit, float farSplit);
     /// Finalize shadow camera view after shadow casters and the shadow map are known.
     void
@@ -257,7 +257,7 @@ private:
     void FindZone(Drawable* drawable);
     /// Return material technique, considering the drawable's LOD distance.
     Technique* GetTechnique(Drawable* drawable, Material* material);
-    /// Check if material should render an auxiliary view (if it has a camera attached.)
+    /// Check if material should render an auxiliary view (if it has a camera attached).
     void CheckMaterialForAuxView(Material* material);
     /// Set shader defines for a batch queue if used.
     void SetQueueShaderDefines(BatchQueue& queue, const RenderPathCommand& command);

Source/Urho3D/Graphics/Viewport.h

@@ -83,7 +83,7 @@ public:
     /// Return whether to draw debug geometry.
     bool GetDrawDebug() const { return drawDebug_; }
 
-    /// Return the culling camera. If null, the viewport camera will be used for culling (normal case.)
+    /// Return the culling camera. If null, the viewport camera will be used for culling (normal case).
     Camera* GetCullCamera() const;
 
     /// Return ray corresponding to normalized screen coordinates.

Source/Urho3D/Graphics/Zone.h

@@ -47,7 +47,7 @@ public:
 
     /// Set local-space bounding box. Will be used as an oriented bounding box to test whether objects or the camera are inside.
     void SetBoundingBox(const BoundingBox& box);
-    /// Set ambient color
+    /// Set ambient color.
     void SetAmbientColor(const Color& color);
     /// Set fog color.
     void SetFogColor(const Color& color);

Source/Urho3D/IK/IKConstraint.h

@@ -59,7 +59,7 @@ public:
 private:
     friend class IKSolver;
 
-    /// Intended to be used only by IKSolver
+    /// Intended to be used only by IKSolver.
     void SetIKConstraintNode(ik_node_t* constraintNode);
 
     ik_node_t* ikConstraintNode_;

Source/Urho3D/IK/IKConverters.h

@@ -30,13 +30,13 @@
 
 namespace Urho3D {
 
-/// Converts from an Urho3D Vector3 to an IK vec3_t
+/// Converts from an Urho3D Vector3 to an IK vec3_t.
 vec3_t Vec3Urho2IK(const Vector3& urho);
-/// Converts from an IK vec3_t to an Urho3D Vector3
+/// Converts from an IK vec3_t to an Urho3D Vector3.
 Vector3 Vec3IK2Urho(const vec3_t* ik);
-/// Converts from an Urho3D quaternion to an IK quat_t
+/// Converts from an Urho3D quaternion to an IK quat_t.
 quat_t QuatUrho2IK(const Quaternion& urho);
-/// Converts from an IK quat_t to an Urho3D quaternion
+/// Converts from an IK quat_t to an Urho3D quaternion.
 Quaternion QuatIK2Urho(const quat_t* ik);
 
 }

Source/Urho3D/IK/IKEffector.h

@@ -70,9 +70,9 @@ public:
     /// Registers this class as an object factory.
     static void RegisterObject(Context* context);
 
-    /// Test if a certain feature is enabled (see IKEffector::Feature)
+    /// Test if a certain feature is enabled (see IKEffector::Feature).
     bool GetFeature(Feature feature) const;
-    /// Enable or disable a certain feature (see IKEffector::Feature)
+    /// Enable or disable a certain feature (see IKEffector::Feature).
     void SetFeature(Feature feature, bool enable);
 
     /// Retrieves the node that is being used as a target. Can be NULL.
@@ -116,9 +116,9 @@ public:
     /// Sets the current target rotation. If the effector has a target node then this will have no effect.
     void SetTargetRotation(const Quaternion& targetRotation);
 
-    /// Required for the editor, get the target rotation in euler angles
+    /// Required for the editor, get the target rotation in euler angles.
     Vector3 GetTargetRotationEuler() const;
-    /// Required for the editor, sets the target rotation in euler angles
+    /// Required for the editor, sets the target rotation in euler angles.
     void SetTargetRotationEuler(const Vector3& targetRotation);
 
     /// Returns the number of segments that will be affected by this effector. 0 Means all nodes between this effector and the next IKSolver.
@@ -138,7 +138,7 @@ public:
      */
     void SetWeight(float weight);
 
-    /// How strongly the target node's rotation influences the solution
+    /// How strongly the target node's rotation influences the solution.
     float GetRotationWeight() const;
 
     /*!
@@ -171,15 +171,15 @@ public:
 private:
     friend class IKSolver;
 
-    /// Intended to be used only by IKSolver
+    /// Intended to be used only by IKSolver.
     void SetIKSolver(IKSolver* solver);
-    /// Intended to be used only by IKSolver
+    /// Intended to be used only by IKSolver.
     void SetIKEffectorNode(ik_node_t* effectorNode);
-    /// Intended to be used by IKSolver. Copies the positions/rotations of the target node into the effector
+    /// Intended to be used by IKSolver. Copies the positions/rotations of the target node into the effector.
     void UpdateTargetNodePosition();
 
 public:
-    /// Need these wrapper functions flags of GetFeature/SetFeature can be correctly exposed to the editor and to AngelScript and lua
+    /// Need these wrapper functions flags of GetFeature/SetFeature can be correctly exposed to the editor and to AngelScript and lua.
     bool GetWEIGHT_NLERP() const;
     bool GetINHERIT_PARENT_ROTATION() const;
     void SetWEIGHT_NLERP(bool enable);

Source/Urho3D/IK/IKSolver.h

@@ -172,7 +172,7 @@ public:
     /// Registers this class to the context.
     static void RegisterObject(Context* context);
 
-    /// Returns the active algorithm
+    /// Returns the active algorithm.
     Algorithm GetAlgorithm() const;
 
     /*!
@@ -192,9 +192,9 @@ public:
      */
     void SetAlgorithm(Algorithm algorithm);
 
-    /// Test if a certain feature is enabled (see IKSolver::Feature)
+    /// Test if a certain feature is enabled (see IKSolver::Feature).
     bool GetFeature(Feature feature) const;
-    /// Enable or disable a certain feature (see IKSolver::Feature)
+    /// Enable or disable a certain feature (see IKSolver::Feature).
     void SetFeature(Feature feature, bool enable);
 
     /// Returns the configured maximum number of iterations.
@@ -313,22 +313,22 @@ private:
 
     /// Indicates that the internal structures of the IK library need to be updated. See the documentation of ik_solver_rebuild_chain_trees() for more info on when this happens.
     void MarkChainsNeedUpdating();
-    /// Indicates that the tree structure has changed in some way and needs updating (nodes added or removed, components added or removed)
+    /// Indicates that the tree structure has changed in some way and needs updating (nodes added or removed, components added or removed).
     void MarkTreeNeedsRebuild();
     /// Returns false if calling Solve() would cause the IK library to abort. Urho3D's error handling philosophy is to log an error and continue, not crash.
     bool IsSolverTreeValid() const;
 
-    /// Subscribe to drawable update finished event here
+    /// Subscribe to drawable update finished event here.
     void OnSceneSet(Scene* scene) override;
-    /// Destroys and creates the tree
+    /// Destroys and creates the tree.
     void OnNodeSet(Node* node) override;
 
     /// Creates the ik library node and sets the current rotation/position and user data correctly.
     ik_node_t* CreateIKNodeFromUrhoNode(const Node* node);
 
-    /// Destroys the solver's tree
+    /// Destroys the solver's tree.
     void DestroyTree();
-    /// Builds the solver's tree to match the scene graph's tree. If a tree already exists, it is first destroyed
+    /// Builds the solver's tree to match the scene graph's tree. If a tree already exists, it is first destroyed.
     void RebuildTree();
     /// Builds a chain of nodes up to the node of the specified effector component.
     bool BuildTreeToEffector(IKEffector* effector);
@@ -345,10 +345,10 @@ private:
     void HandleComponentRemoved(StringHash eventType, VariantMap& eventData);
     void HandleNodeAdded(StringHash eventType, VariantMap& eventData);
     void HandleNodeRemoved(StringHash eventType, VariantMap& eventData);
-    /// Invokes the IK solver
+    /// Invokes the IK solver.
     void HandleSceneDrawableUpdateFinished(StringHash eventType, VariantMap& eventData);
 
-    /// Need these wrapper functions flags of GetFeature/SetFeature can be correctly exposed to the editor and to AngelScript and lua
+    // Need these wrapper functions flags of GetFeature/SetFeature can be correctly exposed to the editor and to AngelScript and lua
 public:
     bool GetJOINT_ROTATIONS() const;
     bool GetTARGET_ROTATIONS() const;

Source/Urho3D/IO/FileSystem.cpp

@@ -903,7 +903,7 @@ void FileSystem::ScanDirInternal(Vector<String>& result, String path, const Stri
 
 void FileSystem::HandleBeginFrame(StringHash eventType, VariantMap& eventData)
 {
-    /// Go through the execution queue and post + remove completed requests
+    // Go through the execution queue and post + remove completed requests
     for (List<AsyncExecRequest*>::Iterator i = asyncExecQueue_.Begin(); i != asyncExecQueue_.End();)
     {
         AsyncExecRequest* request = *i;

Source/Urho3D/IO/FileSystem.h

@@ -136,13 +136,13 @@ URHO3D_API String GetExtension(const String& fullPath, bool lowercaseExtension =
 URHO3D_API String GetFileNameAndExtension(const String& fileName, bool lowercaseExtension = false);
 /// Replace the extension of a file name with another.
 URHO3D_API String ReplaceExtension(const String& fullPath, const String& newExtension);
-/// Add a slash at the end of the path if missing and convert to internal format (use slashes.)
+/// Add a slash at the end of the path if missing and convert to internal format (use slashes).
 URHO3D_API String AddTrailingSlash(const String& pathName);
-/// Remove the slash from the end of a path if exists and convert to internal format (use slashes.)
+/// Remove the slash from the end of a path if exists and convert to internal format (use slashes).
 URHO3D_API String RemoveTrailingSlash(const String& pathName);
 /// Return the parent path, or the path itself if not available.
 URHO3D_API String GetParentPath(const String& path);
-/// Convert a path to internal format (use slashes.)
+/// Convert a path to internal format (use slashes).
 URHO3D_API String GetInternalPath(const String& pathName);
 /// Convert a path to the format required by the operating system.
 URHO3D_API String GetNativePath(const String& pathName);

Source/Urho3D/IO/FileWatcher.h

@@ -55,7 +55,7 @@ public:
     void SetDelay(float interval);
     /// Add a file change into the changes queue.
     void AddChange(const String& fileName);
-    /// Return a file change (true if was found, false if not.)
+    /// Return a file change (true if was found, false if not).
     bool GetNextChange(String& dest);
 
     /// Return the path being watched, or empty if not watching.

Source/Urho3D/Input/Input.h

@@ -154,7 +154,7 @@ public:
     void ResetMouseVisible();
     /// Set whether the mouse is currently being grabbed by an operation.
     void SetMouseGrabbed(bool grab, bool suppressEvent = false);
-    /// Reset the mouse grabbed to the last unsuppressed SetMouseGrabbed call
+    /// Reset the mouse grabbed to the last unsuppressed SetMouseGrabbed call.
     void ResetMouseGrabbed();
     /// Set the mouse mode.
     /** Set the mouse mode behaviour.
@@ -175,7 +175,7 @@ public:
      *  outside the window, and perform custom rendering (with SetMouseVisible(false)) inside.
     */
     void SetMouseMode(MouseMode mode, bool suppressEvent = false);
-    /// Reset the last mouse mode that wasn't suppressed in SetMouseMode
+    /// Reset the last mouse mode that wasn't suppressed in SetMouseMode.
     void ResetMouseMode();
     /// Add screen joystick.
     /** Return the joystick instance ID when successful or negative on error.
@@ -288,7 +288,7 @@ public:
     bool IsMouseVisible() const { return mouseVisible_; }
     /// Return whether the mouse is currently being grabbed by an operation.
     bool IsMouseGrabbed() const { return mouseGrabbed_; }
-    /// Return whether the mouse is locked to the window
+    /// Return whether the mouse is locked to the window.
     bool IsMouseLocked() const;
 
     /// Return the mouse mode.
@@ -372,9 +372,9 @@ private:
     HashSet<int> scancodePress_;
     /// Active finger touches.
     HashMap<int, TouchState> touches_;
-    /// List that maps between event touch IDs and normalised touch IDs
+    /// List that maps between event touch IDs and normalised touch IDs.
     List<int> availableTouchIDs_;
-    /// Mapping of touch indices
+    /// Mapping of touch indices.
     HashMap<int, int> touchIDMap_;
     /// String for text input.
     String textInput_;
@@ -392,7 +392,7 @@ private:
     IntVector2 mouseMove_;
     /// Mouse wheel movement since last frame.
     int mouseMoveWheel_;
-    /// Input coordinate scaling. Non-unity when window and backbuffer have different sizes (e.g. Retina display.)
+    /// Input coordinate scaling. Non-unity when window and backbuffer have different sizes (e.g. Retina display).
     Vector2 inputScale_;
     /// SDL window ID.
     unsigned windowID_;

Source/Urho3D/LuaScript/pkgs/Graphics/GraphicsDefs.pkg

@@ -206,7 +206,7 @@ enum FaceCameraMode
     FC_DIRECTION
 };
 
-/// Shadow type
+// Shadow type
 enum ShadowQuality
 {
     SHADOWQUALITY_SIMPLE_16BIT = 0,

Source/Urho3D/Math/BoundingBox.h

@@ -71,7 +71,7 @@ public:
     {
     }
 
-    /// Construct from minimum and maximum floats (all dimensions same.)
+    /// Construct from minimum and maximum floats (all dimensions same).
     BoundingBox(float min, float max) noexcept :
         min_(Vector3(min, min, min)),
         max_(Vector3(max, max, max))
@@ -159,7 +159,7 @@ public:
         max_ = max;
     }
 
-    /// Define from minimum and maximum floats (all dimensions same.)
+    /// Define from minimum and maximum floats (all dimensions same).
     void Define(float min, float max)
     {
         min_ = Vector3(min, min, min);

Source/Urho3D/Math/Color.h

@@ -50,7 +50,7 @@ public:
     /// Mask for 0xAARRGGBB layout.
     static const ChannelMask ARGB;
 
-    /// Construct with default values (opaque white.)
+    /// Construct with default values (opaque white).
     Color() noexcept :
         r_(1.0f),
         g_(1.0f),

Source/Urho3D/Math/MathDefs.h

@@ -86,11 +86,11 @@ inline T Min(T lhs, U rhs) { return lhs < rhs ? lhs : rhs; }
 template <class T, class U>
 inline T Max(T lhs, U rhs) { return lhs > rhs ? lhs : rhs; }
 
-/// Return absolute value of a value
+/// Return absolute value of a value.
 template <class T>
 inline T Abs(T value) { return value >= 0.0 ? value : -value; }
 
-/// Return the sign of a float (-1, 0 or 1.)
+/// Return the sign of a float (-1, 0 or 1).
 template <class T>
 inline T Sign(T value) { return value > 0.0 ? 1.0 : (value < 0.0 ? -1.0 : 0.0); }
 
@@ -112,7 +112,7 @@ inline unsigned FloatToRawIntBits(float value)
 /// Check whether a floating point value is NaN.
 template <class T> inline bool IsNaN(T value) { return std::isnan(value); }
 
-/// Check whether a floating point value is positive or negative infinity
+/// Check whether a floating point value is positive or negative infinity.
 template <class T> inline bool IsInf(T value) { return std::isinf(value); }
 
 /// Clamp a number to a range.
@@ -280,7 +280,7 @@ inline unsigned CountSetBits(unsigned value)
 /// Update a hash with the given 8-bit value using the SDBM algorithm.
 inline constexpr unsigned SDBMHash(unsigned hash, unsigned char c) { return c + (hash << 6u) + (hash << 16u) - hash; }
 
-/// Return a random float between 0.0 (inclusive) and 1.0 (exclusive.)
+/// Return a random float between 0.0 (inclusive) and 1.0 (exclusive).
 inline float Random() { return Rand() / 32768.0f; }
 
 /// Return a random float between 0.0 and range, inclusive from both ends.

Source/Urho3D/Math/Quaternion.h

@@ -104,13 +104,13 @@ public:
         FromAngleAxis(angle, Vector3::FORWARD);
     }
 
-    /// Construct from Euler angles (in degrees.) Equivalent to Y*X*Z.
+    /// Construct from Euler angles (in degrees). Equivalent to Y*X*Z.
     Quaternion(float x, float y, float z) noexcept
     {
         FromEulerAngles(x, y, z);
     }
 
-    /// Construct from Euler angles (in degrees.)
+    /// Construct from Euler angles (in degrees).
     explicit Quaternion(const Vector3& angles) noexcept
     {
         FromEulerAngles(angles.x_, angles.y_, angles.z_);
@@ -298,7 +298,7 @@ public:
 
     /// Define from an angle (in degrees) and axis.
     void FromAngleAxis(float angle, const Vector3& axis);
-    /// Define from Euler angles (in degrees.) Equivalent to Y*X*Z.
+    /// Define from Euler angles (in degrees). Equivalent to Y*X*Z.
     void FromEulerAngles(float x, float y, float z);
     /// Define from the rotation difference between two direction vectors.
     void FromRotationTo(const Vector3& start, const Vector3& end);

Source/Urho3D/Math/Rect.h

@@ -260,9 +260,9 @@ public:
     /// Maximum vector.
     Vector2 max_;
 
-    /// Rect in the range (-1, -1) - (1, 1)
+    /// Rect in the range (-1, -1) - (1, 1).
     static const Rect FULL;
-    /// Rect in the range (0, 0) - (1, 1)
+    /// Rect in the range (0, 0) - (1, 1).
     static const Rect POSITIVE;
     /// Zero-sized rect.
     static const Rect ZERO;

Source/Urho3D/Math/Vector2.h

@@ -389,7 +389,7 @@ public:
     static const Vector2 ONE;
 };
 
-/// Multiply Vector2 with a scalar
+/// Multiply Vector2 with a scalar.
 inline Vector2 operator *(float lhs, const Vector2& rhs) { return rhs * lhs; }
 
 /// Multiply IntVector2 with a scalar.

Source/Urho3D/Navigation/NavigationEvents.h

@@ -97,7 +97,7 @@ URHO3D_EVENT(E_CROWD_AGENT_REPOSITION, CrowdAgentReposition)
     URHO3D_PARAM(P_TIMESTEP, TimeStep); // float
 }
 
-/// Crowd agent has been repositioned, specific to a node
+/// Crowd agent has been repositioned, specific to a node.
 URHO3D_EVENT(E_CROWD_AGENT_NODE_REPOSITION, CrowdAgentNodeReposition)
 {
     URHO3D_PARAM(P_NODE, Node); // Node pointer

Source/Urho3D/Navigation/NavigationMesh.h

@@ -236,7 +236,7 @@ public:
     /// Return navigation mesh bounding box padding.
     const Vector3& GetPadding() const { return padding_; }
 
-    /// Get the current cost of an area
+    /// Get the current cost of an area.
     float GetAreaCost(unsigned areaID) const;
 
     /// Return whether has been initialized with valid navigation data.
@@ -350,7 +350,7 @@ protected:
     bool drawOffMeshConnections_;
     /// Debug draw NavArea components.
     bool drawNavAreas_;
-    /// NavAreas for this NavMesh
+    /// NavAreas for this NavMesh.
     Vector<WeakPtr<NavArea> > areas_;
 };
 

Source/Urho3D/Navigation/OffMeshConnection.h

@@ -51,9 +51,9 @@ public:
     void SetRadius(float radius);
     /// Set bidirectional flag. Default true.
     void SetBidirectional(bool enabled);
-    /// Set a user assigned mask
+    /// Set a user assigned mask.
     void SetMask(unsigned newMask);
-    /// Sets the assigned area Id for the connection
+    /// Sets the assigned area Id for the connection.
     void SetAreaID(unsigned newAreaID);
 
     /// Return endpoint node.
@@ -65,10 +65,10 @@ public:
     /// Return whether is bidirectional.
     bool IsBidirectional() const { return bidirectional_; }
 
-    /// Return the user assigned mask
+    /// Return the user assigned mask.
     unsigned GetMask() const { return mask_; }
 
-    /// Return the user assigned area ID
+    /// Return the user assigned area ID.
     unsigned GetAreaID() const { return areaId_; }
 
 private:
@@ -84,9 +84,9 @@ private:
     bool bidirectional_;
     /// Endpoint changed flag.
     bool endPointDirty_;
-    /// Flags mask to represent properties of this mesh
+    /// Flags mask to represent properties of this mesh.
     unsigned mask_;
-    /// Area id to be used for this off mesh connection's internal poly
+    /// Area id to be used for this off mesh connection's internal poly.
     unsigned areaId_;
 };
 

Source/Urho3D/Network/Connection.h

@@ -54,7 +54,7 @@ class PackageFile;
 /// Queued remote event.
 struct RemoteEvent
 {
-    /// Remote sender node ID (0 if not a remote node event.)
+    /// Remote sender node ID (0 if not a remote node event).
     unsigned senderID_;
     /// Event type.
     StringHash eventType_;
@@ -94,7 +94,7 @@ struct PackageUpload
     SharedPtr<File> file_;
     /// Current fragment index.
     unsigned fragment_;
-    /// Total number of fragments
+    /// Total number of fragments.
     unsigned totalFragments_;
 };
 
@@ -265,7 +265,7 @@ private:
     void ProcessExistingNode(Node* node, NodeReplicationState& nodeState);
     /// Process a SyncPackagesInfo message from server.
     void ProcessPackageInfo(int msgID, MemoryBuffer& msg);
-    /// Check a package list received from server and initiate package downloads as necessary. Return true on success, or false if failed to initialze downloads (cache dir not set)
+    /// Check a package list received from server and initiate package downloads as necessary. Return true on success, or false if failed to initialze downloads (cache dir not set).
     bool RequestNeededPackages(unsigned numPackages, MemoryBuffer& msg);
     /// Initiate a package download.
     void RequestPackage(const String& name, unsigned fileSize, unsigned checksum);
@@ -320,13 +320,13 @@ private:
     SLNet::AddressOrGUID* address_;
     /// Raknet peer object.
     SLNet::RakPeerInterface* peer_;
-    /// Temporary variable to hold packet count in the next second, x - packets in, y - packets out
+    /// Temporary variable to hold packet count in the next second, x - packets in, y - packets out.
     IntVector2 tempPacketCounter_;
-    /// Packet count in the last second, x - packets in, y - packets out
+    /// Packet count in the last second, x - packets in, y - packets out.
     IntVector2 packetCounter_;
-    /// Packet count timer which resets every 1s
+    /// Packet count timer which resets every 1s.
     Timer packetCounterTimer_;
-    /// Last heard timer, resets when new packet is incoming
+    /// Last heard timer, resets when new packet is incoming.
     Timer lastHeardTimer_;
 };
 

Source/Urho3D/Network/HttpRequest.h

@@ -33,7 +33,7 @@
 namespace Urho3D
 {
 
-/// HTTP connection state
+/// HTTP connection state.
 enum HttpRequestState
 {
     HTTP_INITIALIZING = 0,

Source/Urho3D/Network/NetworkPriority.h

@@ -40,11 +40,11 @@ public:
     /// Register object factory.
     static void RegisterObject(Context* context);
 
-    /// Set base priority. Default 100 (send updates at full frequency.)
+    /// Set base priority. Default 100 (send updates at full frequency).
     void SetBasePriority(float priority);
-    /// Set priority reduction distance factor. Default 0 (no effect.)
+    /// Set priority reduction distance factor. Default 0 (no effect).
     void SetDistanceFactor(float factor);
-    /// Set minimum priority. Default 0 (no updates when far away enough.)
+    /// Set minimum priority. Default 0 (no updates when far away enough).
     void SetMinPriority(float priority);
     /// Set whether updates to owner should be sent always at full rate. Default true.
     void SetAlwaysUpdateOwner(bool enable);

Source/Urho3D/Network/Protocol.h

@@ -27,7 +27,7 @@ namespace Urho3D
 
 /// Client->server: send VariantMap of identity and authentication data.
 static const int MSG_IDENTITY = 0x87;
-/// Client->server: send controls (buttons and mouse movement.)
+/// Client->server: send controls (buttons and mouse movement).
 static const int MSG_CONTROLS = 0x88;
 /// Client->server: scene has been loaded and client is ready to proceed.
 static const int MSG_SCENELOADED = 0x89;

Source/Urho3D/Physics/CollisionShape.cpp

@@ -192,7 +192,7 @@ public:
     bool useQuantize_;
 
 private:
-    /// Shared vertex/index data used in the collision
+    /// Shared vertex/index data used in the collision.
     Vector<SharedArrayPtr<unsigned char> > dataArrays_;
 };
 

Source/Urho3D/Physics/RaycastVehicle.h

@@ -59,7 +59,7 @@ public:
     void SetSteeringValue(int wheel, float steeringValue);
     /// Set suspension stiffness for particular wheel.
     void SetWheelSuspensionStiffness(int wheel, float stiffness);
-    /// Set wheel max suspension force. Good results are often obtained by a value that is about 3x to 4x the vehicle weight. 
+    /// Set wheel max suspension force. Good results are often obtained by a value that is about 3x to 4x the vehicle weight.
     void SetWheelMaxSuspensionForce(int wheel, float force);
     /// Set wheel damping relaxation.
     void SetWheelDampingRelaxation(int wheel, float damping);
@@ -71,7 +71,7 @@ public:
     void SetWheelRollInfluence(int wheel, float rollInfluence);
     /// Set engine force for the wheel.
     void SetEngineForce(int wheel, float force);
-    /// Set hand brake (wheel rotation blocking force.)
+    /// Set hand brake (wheel rotation blocking force).
     void SetBrake(int wheel, float force);
     /// Set wheel radius.
     void SetWheelRadius(int wheel, float wheelRadius);
@@ -79,7 +79,7 @@ public:
     void ResetWheels();
     /// Set sliding factor 0 <= x <= 1. The less the value, more sliding.
     void SetWheelSkidInfo(int wheel, float factor);
-    /// True if wheel touches ground (raycast hits something.)
+    /// True if wheel touches ground (raycast hits something).
     bool WheelIsGrounded(int wheel) const;
     /// Set maximum suspension travel value.
     void SetMaxSuspensionTravel(int wheel, float maxSuspensionTravel);
@@ -118,7 +118,7 @@ public:
     float GetSteeringValue(int wheel) const;
     /// Get suspension stiffness for particular wheel.
     float GetWheelSuspensionStiffness(int wheel) const;
-    /// Get wheel max suspension force. 
+    /// Get wheel max suspension force.
     float GetWheelMaxSuspensionForce(int wheel) const;
     /// Get wheel damping relaxation.
     float GetWheelDampingRelaxation(int wheel) const;
@@ -184,17 +184,17 @@ public:
 private:
     /// If the RigidBody should be activated.
     bool activate_;
-    /// Hull RigidBody
+    /// Hull RigidBody.
     WeakPtr<RigidBody> hullBody_;
-    /// Opaque Bullet data hidden from public
+    /// Opaque Bullet data hidden from public.
     RaycastVehicleData* vehicleData_;
     /// Coordinate system.
     IntVector3 coordinateSystem_;
-    /// Nodes of all wheels
+    /// Nodes of all wheels.
     Vector<Node*> wheelNodes_;
-    /// All wheels original rotations. These are applied in addition to wheel rotations by btRaycastVehicle
+    /// All wheels original rotations. These are applied in addition to wheel rotations by btRaycastVehicle.
     Vector<Quaternion> origRotation_;
-    /// Revolutions per minute value for in-air motor wheels. FIXME: set this one per wheel
+    /// Revolutions per minute value for in-air motor wheels. FIXME: set this one per wheel.
     float inAirRPM_;
     /// Per-wheel extra settings.
     Vector<float> skidInfoCumulative_;

Source/Urho3D/Physics/RigidBody.h

@@ -213,7 +213,7 @@ public:
     /// Return whether this RigidBody is acting as a trigger.
     bool IsTrigger() const { return trigger_; }
 
-    /// Return whether rigid body is active (not sleeping.)
+    /// Return whether rigid body is active (not sleeping).
     bool IsActive() const;
 
     /// Return collision layer.

Source/Urho3D/Resource/Decompress.cpp

@@ -831,7 +831,7 @@ void FlipBlockVertical(unsigned char* dest, const unsigned char* src, Compressed
         break;
 
     default:
-        /// ETC1 & PVRTC not yet implemented
+        // ETC1 & PVRTC not yet implemented
         break;
     }
 }
@@ -896,7 +896,7 @@ void FlipBlockHorizontal(unsigned char* dest, const unsigned char* src, Compress
         break;
 
     default:
-        /// ETC1 & PVRTC not yet implemented
+        // ETC1 & PVRTC not yet implemented
         break;
     }
 }

Source/Urho3D/Resource/Image.h

@@ -195,7 +195,7 @@ public:
     SDL_Surface* GetSDLSurface(const IntRect& rect = IntRect::ZERO) const;
     /// Precalculate the mip levels. Used by asynchronous texture loading.
     void PrecalculateLevels();
-    /// Whether this texture has an alpha channel
+    /// Whether this texture has an alpha channel.
     bool HasAlphaChannel() const;
     /// Copy contents of the image into the defined rect, scaling if necessary. This image should already be large enough to include the rect. Compressed and 3D images are not supported.
     bool SetSubimage(const Image* image, const IntRect& rect);

Source/Urho3D/Resource/ResourceCache.h

@@ -140,7 +140,7 @@ public:
     SharedPtr<File> GetFile(const String& name, bool sendEventOnFailure = true);
     /// Return a resource by type and name. Load if not loaded yet. Return null if not found or if fails, unless SetReturnFailedResources(true) has been called. Can be called only from the main thread.
     Resource* GetResource(StringHash type, const String& name, bool sendEventOnFailure = true);
-    /// Load a resource without storing it in the resource cache. Return null if not found or if fails. Can be called from outside the main thread if the resource itself is safe to load completely (it does not possess for example GPU data.)
+    /// Load a resource without storing it in the resource cache. Return null if not found or if fails. Can be called from outside the main thread if the resource itself is safe to load completely (it does not possess for example GPU data).
     SharedPtr<Resource> GetTempResource(StringHash type, const String& name, bool sendEventOnFailure = true);
     /// Background load a resource. An event will be sent when complete. Return true if successfully stored to the load queue, false if eg. already exists. Can be called from outside the main thread.
     bool BackgroundLoadResource(StringHash type, const String& name, bool sendEventOnFailure = true, Resource* caller = nullptr);

Source/Urho3D/Resource/XMLElement.h

@@ -201,7 +201,7 @@ public:
     bool HasAttribute(const String& name) const;
     /// Return whether has an attribute.
     bool HasAttribute(const char* name) const;
-    /// Return inner value, or empty if missing for nodes like <node>value</node>
+    /// Return inner value, or empty if missing for nodes like <node>value</node>.
     String GetValue() const;
     /// Return attribute, or empty if missing.
     String GetAttribute(const String& name = String::EMPTY) const;

Source/Urho3D/Scene/Node.h

@@ -120,7 +120,7 @@ public:
     void SetTags(const StringVector& tags);
     /// Add a tag.
     void AddTag(const String& tag);
-    /// Add tags with the specified separator, by default ;
+    /// Add tags with the specified separator (; by default).
     void AddTags(const String& tags, char separator = ';');
     /// Add tags.
     void AddTags(const StringVector& tags);
@@ -215,7 +215,7 @@ public:
     void SetWorldTransform(const Vector3& position, const Quaternion& rotation, float scale);
     /// Set position, rotation, and scale in world space as an atomic opration.
     void SetWorldTransform(const Vector3& position, const Quaternion& rotation, const Vector3& scale);
-    /// Set position, rotation, and scale in world space as an atomic operation from a transformation matrix
+    /// Set position, rotation, and scale in world space as an atomic operation from a transformation matrix.
     void SetWorldTransform(const Matrix3x4& worldTransform);
 
     /// Set both position and rotation in world space as an atomic operation (for Urho2D).
@@ -681,7 +681,7 @@ protected:
 private:
     /// Parent scene node.
     Node* parent_;
-    /// Scene (root node.)
+    /// Scene (root node).
     Scene* scene_;
     /// Unique ID within the scene.
     unsigned id_;

Source/Urho3D/Scene/Scene.h

@@ -60,13 +60,13 @@ struct AsyncProgress
     SharedPtr<File> file_;
     /// XML file for XML mode.
     SharedPtr<XMLFile> xmlFile_;
-    /// JSON file for JSON mode
+    /// JSON file for JSON mode.
     SharedPtr<JSONFile> jsonFile_;
 
     /// Current XML element for XML mode.
     XMLElement xmlElement_;
 
-    /// Current JSON child array and for JSON mode
+    /// Current JSON child array and for JSON mode.
     unsigned jsonIndex_;
 
     /// Current load mode.
@@ -146,7 +146,7 @@ public:
     void Clear(bool clearReplicated = true, bool clearLocal = true);
     /// Enable or disable scene update.
     void SetUpdateEnabled(bool enable);
-    /// Set update time scale. 1.0 = real time (default.)
+    /// Set update time scale. 1.0 = real time (default).
     void SetTimeScale(float scale);
     /// Set elapsed time in seconds. This can be used to prevent inaccuracy in the timer if the scene runs for a long time.
     void SetElapsedTime(float time);
@@ -160,7 +160,7 @@ public:
     void AddRequiredPackageFile(PackageFile* package);
     /// Clear required package files.
     void ClearRequiredPackageFiles();
-    /// Register a node user variable hash reverse mapping (for editing.)
+    /// Register a node user variable hash reverse mapping (for editing).
     void RegisterVar(const String& name);
     /// Unregister a node user variable hash reverse mapping.
     void UnregisterVar(const String& name);

Source/Urho3D/Scene/Serializable.h

@@ -204,7 +204,7 @@ SharedPtr<AttributeAccessor> MakeVariantAttributeAccessor(TGetFunction getFuncti
     [](const ClassName& self, Urho3D::Variant& value) { value = self.getFunction(); }, \
     [](ClassName& self, const Urho3D::Variant& value) { self.setFunction(value.Get<typeName>()); })
 
-/// Make member enum attribute accessor
+/// Make member enum attribute accessor.
 #define URHO3D_MAKE_MEMBER_ENUM_ATTRIBUTE_ACCESSOR(variable) Urho3D::MakeVariantAttributeAccessor<ClassName>( \
     [](const ClassName& self, Urho3D::Variant& value) { value = static_cast<int>(self.variable); }, \
     [](ClassName& self, const Urho3D::Variant& value) { self.variable = static_cast<decltype(self.variable)>(value.Get<int>()); })

Source/Urho3D/Scene/SplinePath.h

@@ -78,7 +78,7 @@ public:
     /// Get the movement Speed.
     float GetSpeed() const { return speed_; }
 
-    /// Get the length of SplinePath;
+    /// Get the length of SplinePath.
     float GetLength() const { return length_; }
 
     /// Get the parent Node's last position on the spline.

Source/Urho3D/Scene/UnknownComponent.h

@@ -93,7 +93,7 @@ private:
     String typeName_;
     /// XML format attribute infos.
     Vector<AttributeInfo> xmlAttributeInfos_;
-    /// XML format attribute data (as strings)
+    /// XML format attribute data (as strings).
     Vector<String> xmlAttributes_;
     /// Binary attributes.
     PODVector<unsigned char> binaryAttributes_;

Source/Urho3D/UI/Cursor.cpp

@@ -52,8 +52,8 @@ static const char* shapeNames[] =
     "BusyArrow"
 };
 
-/// OS cursor shape lookup table matching cursor shape enumeration
 #if !defined(__ANDROID__) && !defined(IOS) && !defined(TVOS)
+// OS cursor shape lookup table matching cursor shape enumeration
 static const int osCursorLookup[CS_MAX_SHAPES] =
 {
     SDL_SYSTEM_CURSOR_ARROW,    // CS_NORMAL

Source/Urho3D/UI/FileSelector.h

@@ -38,7 +38,7 @@ class UIElement;
 class Window;
 class XMLFile;
 
-/// %File selector's list entry (file or directory.)
+/// %File selector's list entry (file or directory).
 struct FileSelectorEntry
 {
     /// Name.
@@ -136,7 +136,7 @@ private:
     void HandlePathChanged(StringHash eventType, VariantMap& eventData);
     /// Handle file selected from the list.
     void HandleFileSelected(StringHash eventType, VariantMap& eventData);
-    /// Handle file doubleclicked from the list (enter directory / OK the file selection.)
+    /// Handle file doubleclicked from the list (enter directory / OK the file selection).
     void HandleFileDoubleClicked(StringHash eventType, VariantMap& eventData);
     /// Handle file list key pressed.
     void HandleFileListKey(StringHash eventType, VariantMap& eventData);

Source/Urho3D/UI/Font.cpp

@@ -41,7 +41,7 @@ namespace Urho3D
 
 namespace
 {
-    /// Convert float to 26.6 fixed-point (as used internally by FreeType)
+    // Convert float to 26.6 fixed-point (as used internally by FreeType)
     inline int FloatToFixed(float value)
     {
         return (int)(value * 64);

Source/Urho3D/UI/ListView.cpp

@@ -122,7 +122,7 @@ public:
         overlayContainer_->SetChildOffset(IntVector2(-x + panelBorder.left_, -y + panelBorder.top_));
     }
 
-    /// Handle mouse click on overlays by toggling the expansion state of the corresponding item
+    /// Handle mouse click on overlays by toggling the expansion state of the corresponding item.
     void HandleUIMouseClick(StringHash eventType, VariantMap& eventData)
     {
         using namespace UIMouseClick;

Source/Urho3D/UI/ListView.h

@@ -192,7 +192,7 @@ private:
     void HandleItemFocusChanged(StringHash eventType, VariantMap& eventData);
     /// Handle focus changed.
     void HandleFocusChanged(StringHash eventType, VariantMap& eventData);
-    /// Update subscription to UI click events
+    /// Update subscription to UI click events.
     void UpdateUIClickSubscription();
 };
 

Source/Urho3D/UI/Menu.h

@@ -65,7 +65,7 @@ public:
     void SetPopupOffset(int x, int y);
     /// Force the popup to show or hide.
     void ShowPopup(bool enable);
-    /// Set accelerator key (set zero key code to disable.)
+    /// Set accelerator key (set zero key code to disable).
     void SetAccelerator(int key, int qualifiers);
 
     /// Return popup element.

Source/Urho3D/UI/ProgressBar.h

@@ -50,7 +50,7 @@ public:
     /// Set orientation type.
     void SetOrientation(Orientation orientation);
 
-    /// Set ProgressBar range maximum value (minimum value is always 0.)
+    /// Set ProgressBar range maximum value (minimum value is always 0).
     void SetRange(float range);
 
     /// Set ProgressBar current value.
@@ -91,12 +91,12 @@ protected:
     void UpdateProgressBar();
 
     /// ProgressBar knob.
-    SharedPtr <BorderImage> knob_;
-    /// ProgressBar text
-    SharedPtr <Text> loadingText_;
+    SharedPtr<BorderImage> knob_;
+    /// ProgressBar text.
+    SharedPtr<Text> loadingText_;
     /// Orientation.
     Orientation orientation_;
-    /// ProgressBar text style
+    /// ProgressBar text style.
     String loadingPercentStyle_;
     /// ProgressBar range.
     float range_;

Source/Urho3D/UI/ScrollBar.h

@@ -52,7 +52,7 @@ public:
 
     /// Set orientation type.
     void SetOrientation(Orientation orientation);
-    /// Set slider range maximum value (minimum value is always 0.)
+    /// Set slider range maximum value (minimum value is always 0).
     void SetRange(float range);
     /// Set slider current value.
     void SetValue(float value);

Source/Urho3D/UI/ScrollView.h

@@ -79,7 +79,7 @@ public:
     /// Set scroll deceleration.
     void SetScrollDeceleration(float deceleration) { scrollDeceleration_ = deceleration; }
 
-    /// Set scroll snap epsilon
+    /// Set scroll snap epsilon.
     void SetScrollSnapEpsilon(float snap) { scrollSnapEpsilon_ = snap; }
 
     /// Set whether child elements should be disabled while touch scrolling.
@@ -121,7 +121,7 @@ public:
     /// Return scroll deceleration.
     float GetScrollDeceleration() const { return scrollDeceleration_; }
 
-    /// Return scroll snap epsilon
+    /// Return scroll snap epsilon.
     float GetScrollSnapEpsilon() const { return scrollSnapEpsilon_; }
 
     /// Return whether child element will be disabled while touch scrolling.
@@ -173,21 +173,21 @@ protected:
     bool ignoreEvents_;
     /// Resize content widget width to match panel. Internal flag, used by the ListView class.
     bool resizeContentWidth_;
-    /// Scroll deceleration
+    /// Scroll deceleration.
     float scrollDeceleration_;
-    /// Scroll snap epsilon
+    /// Scroll snap epsilon.
     float scrollSnapEpsilon_;
-    /// Used to trigger scroll smoothing when false;
+    /// Used to trigger scroll smoothing when false.
     bool scrollTouchDown_;
-    /// Used to prevent touch scroll - scroll bar conflict
+    /// Used to prevent touch scroll - scroll bar conflict.
     bool barScrolling_;
     /// Used to determine if child elements should be disabled while touch scrolling, to prevent their trigger.
     bool autoDisableChildren_;
     /// Used to determine if children have been disabled.
     bool scrollChildrenDisable_;
-    /// Distance moved with touch scrolling
+    /// Distance moved with touch scrolling.
     float touchDistanceSum_;
-    /// Threshold to trigger auto disable children
+    /// Threshold to trigger auto disable children.
     float autoDisableThreshold_;
 
 private:

Source/Urho3D/UI/Slider.h

@@ -66,7 +66,7 @@ public:
 
     /// Set orientation type.
     void SetOrientation(Orientation orientation);
-    /// Set slider range maximum value (minimum value is always 0.)
+    /// Set slider range maximum value (minimum value is always 0).
     void SetRange(float range);
     /// Set slider current value.
     void SetValue(float value);