Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[futures.async] Avoid note within a sentence. #4232

Merged
merged 1 commit into from Sep 28, 2020

Conversation

jensmaurer
Copy link
Member

@jensmaurer jensmaurer commented Sep 24, 2020

Partially addresses #4228

After this is merged, check page break in [futures.task.members].

@jensmaurer jensmaurer added this to the C++20 milestone Sep 24, 2020
@@ -7184,6 +7180,11 @@
\end{note}
Copy link
Contributor

Choose a reason for hiding this comment

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

What about this other note -- would it also work better outside the list?

Copy link
Member Author

Choose a reason for hiding this comment

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

Maybe. I'm trying to limit the size of the changes this late in the process.

Copy link
Member

Choose a reason for hiding this comment

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

We could further limit the size of the changes by turning these bullets into proper sentences. (There's already a period before the first note.) Eg:

Synchronization: The following apply regardless of the provided policy argument:

  • The invocation of async synchronizes with the invocation of f.
    [Note:...]
  • The completion of the function f is sequenced before the shared state is made ready.
    [Note:...]

For master we could be a bit more aggressive:

Synchronization: The invocation of async synchronizes with the invocation of f. The completion of the function f is sequenced before the shared state is made ready.
[Note: These apply regardless of the provided policy argument, and even if the corresponding future object is moved to another thread. However, f might not be called at all, so its completion might never happen.]

Copy link
Contributor

Choose a reason for hiding this comment

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

I like both parts of this.

@jensmaurer
Copy link
Member Author

This is now the minimal fix against C++20. Please check.

@jensmaurer
Copy link
Member Author

The larger fix for C++23 is in #4244.

@zygoloid zygoloid merged commit 1661a8a into cplusplus:c++20 Sep 28, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants