Fixed docu of various interfaces.

include/LLGL/CommandBuffer.h

@@ -241,17 +241,18 @@ class LLGL_EXPORT CommandBuffer : public RenderSystemChild
         virtual void GenerateMips(Texture& texture) = 0;
 
         /**
-        \brief Generates the specified range of MIP-maps for the specified texture.
+        \brief Generates a range of MIP-maps for the specified texture.
         \param[in,out] texture Specifies the texture whose MIP-maps are to be generated.
         This texture must have been created with the binding flags BindFlags::Sampled and BindFlags::ColorAttachment.
         \param[in] subresource Specifies the texture subresource, i.e. the range of MIP-maps that are to be updated.
         \remarks For performance reasons, it is recommended to encode this command outside of a render pass.
         Otherwise, render pass interruptions might be inserted by LLGL.
         \remarks This function guarantees to generate only the MIP-maps in the specified range (specified by \c subresource).
-        However, this function may introduce a performance penalty compared to generating MIP-maps using a texture view.
+        However, this function \e may introduce a performance penalty compared to generating the full MIP chain if texture views are not natively supported by the backend.
         It is therefore recommended to use this function only if the range of MIP-maps is significantly smaller than the entire MIP chain,
         e.g. only a single slice of a large 2D array texture, and use the primary \c GenerateMips function otherwise.
         \see GenerateMips(Texture&)
+        \see RenderingFeatures::hasTextureViews
         */
         virtual void GenerateMips(Texture& texture, const TextureSubresource& subresource) = 0;
 

include/LLGL/PipelineLayout.h

@@ -19,8 +19,7 @@ namespace LLGL
 
 /**
 \brief Pipeline layout interface.
-\remarks An instance of this interface provides all descriptor sets (as called in Vulkan)
-or descriptor heaps (as called in Direct3D 12) for graphics and compute pipelines.
+\remarks An instance of this interface provides a layout for resource binding in a graphics or compute pipeline.
 \see RenderSystem::CreatePipelineLayout
 \see GraphicsPipelineDescriptor::pipelineLayout
 \see ResourceHeapDescriptor::pipelineLayout

include/LLGL/RenderContext.h

@@ -38,7 +38,7 @@ class Display;
 \brief Render context interface.
 \remarks Each render context has its own surface and back buffer (or rather swap-chain) to draw into.
 \see RenderSystem::CreateRenderContext
-\see CommandBuffer::SetRenderTarget(RenderContext&)
+\see CommandBuffer::BeginRenderPass
 */
 class LLGL_EXPORT RenderContext : public RenderTarget
 {

include/LLGL/ResourceHeap.h

@@ -19,8 +19,8 @@ namespace LLGL
 
 /**
 \brief Resource heap interface.
-\remarks An instance of this interface provides a descriptor set (as called in Vulkan)
-or descriptor heap (as called in Direct3D 12) for graphics and compute pipelines.
+\remarks An instance of this interface provides all descriptor sets (as called in Vulkan)
+or descriptor heaps (as called in Direct3D 12) for graphics and compute pipelines.
 \see RenderSystem::CreateResourceHeap
 \see CommandBuffer::SetResourceHeap
 */

include/LLGL/Surface.h

@@ -20,10 +20,10 @@ namespace LLGL
 
 
 /**
-\brief The Surface interface is the base interface for Window (on Desktop platforms) and Canvas (on movile platforms).
+\brief The Surface interface is the base interface for Window (on Desktop platforms) and Canvas (on mobile platforms).
 \remarks Surface provides the minimal required interface for a graphics rendering context,
 such as the access to the native handle, information about the content size (i.e. the client area size),
-and the ability to adapt for a new video mode or an updated pixel format.
+and the ability to adapt for a new video mode or an updated pixel format
 (which is required for multi-sampled framebuffers on a WGL context for instance).
 \see Window
 \see Canvas