Skip to content

Conversation

carlossanlop
Copy link
Contributor

No description provided.

@carlossanlop carlossanlop added new-content Indicates PRs that contain new articles waiting-on-reviews Indicates PRs that cannot be merged because of the lack of reviews 🏁 Release: .NET Core 2.x Identifies work items for the .NET Core 2.x releases labels Sep 16, 2019
@carlossanlop carlossanlop added this to the September 2019 milestone Sep 16, 2019
@carlossanlop carlossanlop self-assigned this Sep 16, 2019
Copy link

@rpetrusha rpetrusha left a comment

Choose a reason for hiding this comment

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

I've left a couple of comments and suggestions, @carlossanlop.

@@ -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

@@ -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>

@@ -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.

@@ -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>

@@ -74,7 +74,7 @@
</ReturnValue>
<MemberValue>64</MemberValue>
<Docs>
<summary>To be added.</summary>
<summary>The DLL can move.</summary>
Copy link
Contributor

Choose a reason for hiding this comment

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

This doesn't seem to make sense.

Copy link
Contributor

Choose a reason for hiding this comment

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

Maybe it should be The DLL can be relocated.

@@ -248,7 +248,7 @@
</ReturnValue>
<MemberValue>2</MemberValue>
<Docs>
<summary>To be added.</summary>
<summary>Reserved.</summary>
</Docs>
</Member>
<Member MemberName="TerminalServerAware">
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.

@rpetrusha
Copy link

I think that this is ready to merge, @carlossanlop. I've changed "The DLL can move" to "The DLL can be relocated." I've approved, so let me know if it's ready to merge.

@rpetrusha rpetrusha removed the waiting-on-reviews Indicates PRs that cannot be merged because of the lack of reviews label Oct 11, 2019
@carlossanlop
Copy link
Contributor Author

Your last PR is ready to merge, @rpetrusha :)

@rpetrusha
Copy link

Thanks, @carlossanlop. I'll merge now.

@rpetrusha rpetrusha merged commit 76e7228 into dotnet:master Oct 11, 2019
@carlossanlop carlossanlop deleted the DllCharacteristics branch November 6, 2019 18:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
🏁 Release: .NET Core 2.x Identifies work items for the .NET Core 2.x releases new-content Indicates PRs that contain new articles
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants