[Comments] Fix include path in order to remove some warnings in visual studio

Author: mrvux

Source/SharpDX.Animation/PriorityComparison.cs

@@ -30,7 +30,7 @@ internal partial interface PriorityComparison
         /// <param name="newStoryboard">No documentation.</param>	
         /// <param name="priorityEffect">No documentation.</param>	
         /// <returns>No documentation.</returns>	
-        /// <include file='.\..\Documentation\CodeComments.xml' path="/comments/comment[@id='IUIAnimationPriorityComparison::HasPriority']/*"/>	
+        /// <include file='Documentation\CodeComments.xml' path="/comments/comment[@id='IUIAnimationPriorityComparison::HasPriority']/*"/>	
         /// <unmanaged>HRESULT IUIAnimationPriorityComparison::HasPriority([In] IUIAnimationStoryboard* scheduledStoryboard,[In] IUIAnimationStoryboard* newStoryboard,[In] UI_ANIMATION_PRIORITY_EFFECT priorityEffect)</unmanaged>	
         bool HasPriority( SharpDX.Animation.Storyboard scheduledStoryboard, SharpDX.Animation.Storyboard newStoryboard, SharpDX.Animation.PriorityEffect priorityEffect);
     }

Source/SharpDX.Animation/Storyboard.cs

@@ -35,7 +35,7 @@ public Storyboard(Manager manager)
             manager.CreateStoryboard(this);
         }
 
-        /// <include file='.\..\Documentation\CodeComments.xml' path="/comments/comment[@id='IUIAnimationStoryboard::RepeatBetweenKeyframes']/*"/>	
+        /// <include file='Documentation\CodeComments.xml' path="/comments/comment[@id='IUIAnimationStoryboard::RepeatBetweenKeyframes']/*"/>	
         /// <unmanaged>HRESULT IUIAnimationStoryboard::RepeatBetweenKeyframes([In] __MIDL___MIDL_itf_UIAnimation_0000_0002_0003* startKeyframe,[In] __MIDL___MIDL_itf_UIAnimation_0000_0002_0003* endKeyframe,[In] int repetitionCount)</unmanaged>	
         public void RepeatBetweenKeyframes(SharpDX.Animation.KeyFrame startKeyframe, SharpDX.Animation.KeyFrame endKeyframe, RepeatCount repetitionCount)
         {

Source/SharpDX.D3DCompiler/ShaderBytecode.cs

@@ -957,6 +957,10 @@ internal static ShaderMacro[] PrepareMacros(ShaderMacro[] macros)
             return macroArray;
         }
 
+        /// <summary>
+        /// Disposes all resource for the allocated object
+        /// </summary>
+        /// <remarks>This is kept for backwards compatibility only, this actually does nothing in that case</remarks>
         public void Dispose()
         {
             // Just to keep backward compatibility
@@ -965,9 +969,7 @@ public void Dispose()
         /// <summary>
         /// Gets the shader type and version string from the provided bytecode.
         /// </summary>
-        /// <param name="shaderBytecode">The shader bytecode data.</param>
         /// <returns>The type and version string of the provided shader bytecode.</returns>
-        /// <exception cref="ArgumentNullException">Is thrown when <paramref name="shaderBytecode"/> is null.</exception>
         /// <exception cref="ArgumentException">Is thrown when bytecode contains invalid data or the version could not be read.</exception>
         /// <exception cref="IndexOutOfRangeException">Is thrown when bytecode contains invalid data.</exception>
         public ShaderProfile GetVersion()

Source/SharpDX.DXGI/SwapChain.cs

@@ -67,7 +67,7 @@ public T GetBackBuffer<T>(int index) where T : ComObject
         /// <remarks>	
         /// <p>You cannot use <strong>GetFrameStatistics</strong> for swap chains that both use the bit-block transfer (bitblt) presentation model and draw in windowed mode.</p><p>You can only use <strong>GetFrameStatistics</strong> for swap chains that either use the flip presentation model or draw in full-screen mode. You set the <strong><see cref="SharpDX.DXGI.SwapEffect.FlipSequential"/></strong> value in the <strong>SwapEffect</strong> member of the <strong><see cref="SharpDX.DXGI.SwapChainDescription1"/></strong> structure to specify that the swap chain uses the flip presentation model.</p>	
         /// </remarks>	
-        /// <include file='.\..\Documentation\CodeComments.xml' path="/comments/comment[@id='IDXGISwapChain::GetFrameStatistics']/*"/>	
+        /// <include file='Documentation\CodeComments.xml' path="/comments/comment[@id='IDXGISwapChain::GetFrameStatistics']/*"/>	
         /// <msdn-id>bb174573</msdn-id>	
         /// <unmanaged>GetFrameStatistics</unmanaged>	
         /// <unmanaged-short>GetFrameStatistics</unmanaged-short>	
@@ -119,7 +119,7 @@ public bool IsFullScreen
         /// <remarks>	
         /// <p>Starting with Direct3D 11.1, we recommend to instead use <strong><see cref="SharpDX.DXGI.SwapChain1.Present1"/></strong> because you can then use dirty rectangles and the scroll rectangle in the swap chain presentation and as such use less memory bandwidth and as a result less system power. For more info about using dirty rectangles and the scroll rectangle in swap chain presentation, see Using dirty rectangles and the scroll rectangle in swap chain presentation.</p><p>For the best performance when flipping swap-chain buffers in a full-screen application, see Full-Screen Application Performance Hints.</p><p>Because calling <strong>Present</strong> might cause the render thread to wait on the message-pump thread, be careful when calling this method in an application that uses multiple threads. For more details, see Multithreading Considerations.</p><table> <tr><td> <p>Differences between Direct3D 9 and Direct3D 10:</p> <p>Specifying <strong><see cref="SharpDX.DXGI.PresentFlags.Test"/></strong> in the <em>Flags</em> parameter is analogous to <strong>IDirect3DDevice9::TestCooperativeLevel</strong> in Direct3D 9.</p> </td></tr> </table><p>?</p><p>For flip presentation model swap chains that you create with the <strong><see cref="SharpDX.DXGI.SwapEffect.FlipSequential"/></strong> value set, a successful presentation unbinds back buffer 0 from the graphics pipeline, except for when you pass the <strong><see cref="SharpDX.DXGI.PresentFlags.DoNotSequence"/></strong> flag in the <em>Flags</em> parameter.</p><p>For info about how data values change when you present content to the screen, see Converting data for the color space.</p>	
         /// </remarks>	
-        /// <include file='.\..\Documentation\CodeComments.xml' path="/comments/comment[@id='IDXGISwapChain::Present']/*"/>	
+        /// <include file='Documentation\CodeComments.xml' path="/comments/comment[@id='IDXGISwapChain::Present']/*"/>	
         /// <msdn-id>bb174576</msdn-id>	
         /// <unmanaged>HRESULT IDXGISwapChain::Present([In] unsigned int SyncInterval,[In] DXGI_PRESENT_FLAGS Flags)</unmanaged>	
         /// <unmanaged-short>IDXGISwapChain::Present</unmanaged-short>	

Source/SharpDX.DXGI/SwapChain1.cs

@@ -77,7 +77,7 @@ public SwapChain1(Factory2 factory, ComObject device, ref SwapChainDescription1
         /// <remarks>	
         /// An application can use Present1 to optimize presentation by specifying scroll and dirty rectangles. When the runtime has information about these rectangles, the runtime can then perform necessary bitblts during presentation more efficiently and pass this metadata to the Desktop Window Manager (DWM). The DWM can then use the metadata to optimize presentation and pass the metadata to indirect displays and terminal servers to optimize traffic over the wire. An application must confine its modifications to only the dirty regions that it passes to Present1, as well as modify the entire dirty region to avoid undefined resource contents from being exposed.For flip presentation model swap chains that you create with the <see cref="SharpDX.DXGI.SwapEffect.FlipSequential"/> value set, a successful presentation results in an unbind of back buffer 0 from the graphics pipeline, except for when you pass the <see cref="SharpDX.DXGI.PresentFlags.DoNotSequence"/> flag in the Flags parameter.Flip presentation model queueSuppose the following frames with sync-interval values are queued from oldest (A) to newest (E) before you call Present1.A: 3, B: 0, C: 0, D: 1, E: 0When you call Present1, the runtime shows frame A for 3 vertical blank intervals, then frame D for 1 vertical blank interval, and then frame E until you submit a new presentation. The runtime discards frames C and D.	
         /// </remarks>	
-        /// <include file='.\..\Documentation\CodeComments.xml' path="/comments/comment[@id='IDXGISwapChain1::Present1']/*"/>	
+        /// <include file='Documentation\CodeComments.xml' path="/comments/comment[@id='IDXGISwapChain1::Present1']/*"/>	
         /// <unmanaged>HRESULT IDXGISwapChain1::Present1([In] unsigned int SyncInterval,[In] unsigned int PresentFlags,[In] const void* pPresentParameters)</unmanaged>	
         public unsafe Result Present(int syncInterval, PresentFlags presentFlags, PresentParameters presentParameters)
         {

Source/SharpDX.DXGI/SwapChain2.cs

@@ -24,8 +24,6 @@ public partial class SwapChain2
         /// <summary>	
         /// <p>[This documentation is preliminary and is subject to change.]</p><p>Gets the source region used for the swap chain.</p><p>Use <strong>GetSourceSize</strong> to get the portion of the swap chain from which the operating system presents. The source rectangle is always defined by the region [0, 0, Width, Height]. Use <strong>SetSourceSize</strong> to set this portion of the swap chain. </p>	
         /// </summary>	
-        /// <param name="widthRef">No documentation.</param>	
-        /// <param name="heightRef">No documentation.</param>	
         /// <returns><p> This method can return error codes that are described in the DXGI_ERROR topic.</p></returns>	
         /// <include file='.\Documentation\CodeComments.xml' path="/comments/comment[@id='IDXGISwapChain2::GetSourceSize']/*"/>	
         /// <msdn-id>dn280408</msdn-id>	

Source/SharpDX.Direct2D1/DirectWrite/BitmapRenderTarget.cs

@@ -43,7 +43,7 @@ public partial class BitmapRenderTarget
         /// }	
         /// </pre><p>The <em>baselineOriginX</em>, <em>baslineOriginY</em>, <em>measuringMethod</em>, and <em>glyphRun</em> parameters are provided (as arguments) when the callback method is invoked.  The <em>renderingParams</em>, <em>textColor</em> and <em>blackBoxRect</em> are not.</p><p>Default rendering params can be retrieved by using the <strong><see cref="SharpDX.DirectWrite.Factory.CreateMonitorRenderingParams"/></strong> method.</p><p></p>	
         /// </remarks>	
-        /// <include file='..\..\Documentation\CodeComments.xml' path="/comments/comment[@id='IDWriteBitmapRenderTarget::DrawGlyphRun']/*"/>	
+        /// <include file='Documentation\CodeComments.xml' path="/comments/comment[@id='IDWriteBitmapRenderTarget::DrawGlyphRun']/*"/>	
         /// <msdn-id>dd368167</msdn-id>	
         /// <unmanaged>HRESULT IDWriteBitmapRenderTarget::DrawGlyphRun([In] float baselineOriginX,[In] float baselineOriginY,[In] DWRITE_MEASURING_MODE measuringMode,[In] const DWRITE_GLYPH_RUN* glyphRun,[In] IDWriteRenderingParams* renderingParams,[In] int textColor,[Out, Optional] RECT* blackBoxRect)</unmanaged>	
         /// <unmanaged-short>IDWriteBitmapRenderTarget::DrawGlyphRun</unmanaged-short>	

Source/SharpDX.Direct2D1/DirectWrite/TextAnalysisSink1.cs

@@ -35,7 +35,7 @@ public partial interface TextAnalysisSink1
         /// <param name="isSideways"><dd>  <p>Whether the glyphs are rotated on their side, which is the default case for CJK and the case stacked Latin</p> </dd></param>	
         /// <param name="isRightToLeft"><dd>  <p>Whether the script should be shaped as right-to-left. For Arabic stacked top-to-bottom, even when the adjusted bidi level is coerced to an even level, this will still be true.</p> </dd></param>	
         /// <returns><p>Returns a successful code or an error code to abort analysis.</p></returns>	
-        /// <include file='..\..\Documentation\CodeComments.xml' path="/comments/comment[@id='IDWriteTextAnalysisSink1::SetGlyphOrientation']/*"/>	
+        /// <include file='Documentation\CodeComments.xml' path="/comments/comment[@id='IDWriteTextAnalysisSink1::SetGlyphOrientation']/*"/>	
         /// <msdn-id>Hh780425</msdn-id>	
         /// <unmanaged>HRESULT IDWriteTextAnalysisSink1::SetGlyphOrientation([In] unsigned int textPosition,[In] unsigned int textLength,[In] DWRITE_GLYPH_ORIENTATION_ANGLE glyphOrientationAngle,[In] unsigned char adjustedBidiLevel,[In] BOOL isSideways,[In] BOOL isRightToLeft)</unmanaged>	
         /// <unmanaged-short>IDWriteTextAnalysisSink1::SetGlyphOrientation</unmanaged-short>	

Source/SharpDX.Direct2D1/DirectWrite/TextAnalysisSource1.cs

@@ -35,7 +35,7 @@ public partial interface TextAnalysisSource1
         /// <remarks>	
         /// <p>The text analyzer calls back to this to get the desired glyph orientation and resolved bidi level, which it uses along with the script properties of the text to determine the actual orientation of each character, which it reports back to the client via the sink SetGlyphOrientation method.</p>	
         /// </remarks>	
-        /// <include file='..\..\Documentation\CodeComments.xml' path="/comments/comment[@id='IDWriteTextAnalysisSource1::GetVerticalGlyphOrientation']/*"/>	
+        /// <include file='Documentation\CodeComments.xml' path="/comments/comment[@id='IDWriteTextAnalysisSource1::GetVerticalGlyphOrientation']/*"/>	
         /// <msdn-id>Hh780427</msdn-id>	
         /// <unmanaged>HRESULT IDWriteTextAnalysisSource1::GetVerticalGlyphOrientation([In] unsigned int textPosition,[Out] unsigned int* textLength,[Out] DWRITE_VERTICAL_GLYPH_ORIENTATION* glyphOrientation,[Out] unsigned char* bidiLevel)</unmanaged>	
         /// <unmanaged-short>IDWriteTextAnalysisSource1::GetVerticalGlyphOrientation</unmanaged-short>	

Source/SharpDX.Direct2D1/DirectWrite/TextAnalyzer1.cs

@@ -32,7 +32,7 @@ public partial class TextAnalyzer1
         /// <param name="textLength"><dd>  <p>Length to analyze.</p> </dd></param>	
         /// <param name="analysisSink"><dd>  <p>Length to analyze.</p> </dd></param>	
         /// <returns><p>If this method succeeds, it returns <strong><see cref="SharpDX.Result.Ok"/></strong>. Otherwise, it returns an <strong><see cref="SharpDX.Result"/></strong> error code.</p></returns>	
-        /// <include file='..\..\Documentation\CodeComments.xml' path="/comments/comment[@id='IDWriteTextAnalyzer1::AnalyzeVerticalGlyphOrientation']/*"/>	
+        /// <include file='Documentation\CodeComments.xml' path="/comments/comment[@id='IDWriteTextAnalyzer1::AnalyzeVerticalGlyphOrientation']/*"/>	
         /// <msdn-id>Hh780429</msdn-id>	
         /// <unmanaged>HRESULT IDWriteTextAnalyzer1::AnalyzeVerticalGlyphOrientation([In] IDWriteTextAnalysisSource1* analysisSource,[In] unsigned int textPosition,[In] unsigned int textLength,[In] IDWriteTextAnalysisSink1* analysisSink)</unmanaged>	
         /// <unmanaged-short>IDWriteTextAnalyzer1::AnalyzeVerticalGlyphOrientation</unmanaged-short>