Skip to content
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 12 additions & 12 deletions xml/System.Reflection.PortableExecutable/DllCharacteristics.xml
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@
</ReturnValue>

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we add a type summary, something like "Describes the characteristics of a dynamic link library."?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The type summary sounds good to me, I will apply it.
@GrabYourPitchforks @steveharter as the area owners, do you agree with the type summary?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually, @tmat please take a look at this PR as well.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

<MemberValue>4096</MemberValue>
<Docs>
<summary>To be added.</summary>
<summary>The image must run inside an AppContainer.</summary>
</Docs>
</Member>
<Member MemberName="DynamicBase">
Expand All @@ -74,7 +74,7 @@
</ReturnValue>
<MemberValue>64</MemberValue>
<Docs>
<summary>To be added.</summary>
<summary>DLL can move.</summary>

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<summary>DLL can move.</summary>
<summary>The DLL can move.</summary>

</Docs>
</Member>
<Member MemberName="HighEntropyVirtualAddressSpace">
Expand All @@ -98,7 +98,7 @@
</ReturnValue>
<MemberValue>32</MemberValue>
<Docs>
<summary>To be added.</summary>
<summary>The image can handle a high entropy 64-bit virtual address space.</summary>
</Docs>
</Member>
<Member MemberName="NoBind">
Expand All @@ -123,7 +123,7 @@
</ReturnValue>
<MemberValue>2048</MemberValue>
<Docs>
<summary>To be added.</summary>
<summary>Do not bind this image.</summary>
</Docs>
</Member>
<Member MemberName="NoIsolation">
Expand All @@ -148,7 +148,7 @@
</ReturnValue>
<MemberValue>512</MemberValue>
<Docs>
<summary>To be added.</summary>
<summary>The image understands isolation and doesn't want it.</summary>
</Docs>
</Member>
<Member MemberName="NoSeh">
Expand All @@ -173,7 +173,7 @@
</ReturnValue>
<MemberValue>1024</MemberValue>
<Docs>
<summary>To be added.</summary>
<summary>The image does not use SEH. No SE handler may reside in this image.</summary>
</Docs>
</Member>
<Member MemberName="NxCompatible">
Expand All @@ -198,7 +198,7 @@
</ReturnValue>
<MemberValue>256</MemberValue>
<Docs>
<summary>To be added.</summary>
<summary>The image is NX compatible.</summary>
</Docs>
</Member>
<Member MemberName="ProcessInit">
Expand All @@ -223,7 +223,7 @@
</ReturnValue>
<MemberValue>1</MemberValue>
<Docs>
<summary>To be added.</summary>
<summary>Reserved.</summary>
</Docs>
</Member>
<Member MemberName="ProcessTerm">
Expand All @@ -248,7 +248,7 @@
</ReturnValue>
<MemberValue>2</MemberValue>
<Docs>
<summary>To be added.</summary>
<summary>Reserved.</summary>
</Docs>
</Member>
<Member MemberName="TerminalServerAware">

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we have a description for TerminalServerAware?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not in the source comments: src/System.Reflection.Metadata/src/System/Reflection/PortableExecutable/PEFileFlags.cs#L113

This enum value was introduced in the very first commit of .NET Core: dotnet/corefx@f11305d

So the API is as old as Framework. But judging by the value, and a quick search I did for these terms, this is my proposed description, @rpetrusha:

The image is Terminal Server aware.

@GrabYourPitchforks @steveharter as the area owners, is this description good enough for you?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems reasonable to me, but I am not an expert.

Expand Down Expand Up @@ -298,7 +298,7 @@
</ReturnValue>
<MemberValue>4</MemberValue>
<Docs>
<summary>To be added.</summary>
<summary>Reserved.</summary>
</Docs>
</Member>
<Member MemberName="ThreadTerm">
Expand All @@ -323,7 +323,7 @@
</ReturnValue>
<MemberValue>8</MemberValue>
<Docs>
<summary>To be added.</summary>
<summary>Reserved.</summary>
</Docs>
</Member>
<Member MemberName="WdmDriver">
Expand All @@ -348,7 +348,7 @@
</ReturnValue>
<MemberValue>8192</MemberValue>
<Docs>
<summary>To be added.</summary>
<summary>Driver uses WDM model.</summary>

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<summary>Driver uses WDM model.</summary>
<summary>The driver uses the WDM model.</summary>

</Docs>
</Member>
</Members>
Expand Down