ETA: Visual Studio 2010 VB Express エディションでも同じ動作が見られます。
ETA: Visual Studio 2010 C# Express エディションは同じ動作を示しません。
VisualStudio 2008 VB Express エディションでは、次のコメントを指定します。
''' <summary>
''' ...
''' </summary>
''' <remarks>
''' <include file="Comments.xml" path="Section[@name='Part1']/*" />
''' <include file="Comments.xml" path="Section[@name='Part2']/*" />
''' <include file="Comments.xml" path="Section[@name='Part3']/*" />
''' </remarks>
Public Class MyClass
ファイルをコンパイルして .xml を調べると、指定した順序とは逆の順序でコメントが含まれていることがわかります。Part3 は Part2 の前に表示され、Part1 の前に表示されます。
なぜこれが起こっているのか誰にも分かりますか?
到着予定時刻:
追加の動作: インライン コメントが外部インクルードの間に散在している場合、それらはすべて最初に xml に書き込まれ、次にインクルードに (逆の順序で) 書き込まれます。
「非直感的な xml コメント動作をオフにする」というオプションを用意してください。