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

Undeprecate legacy multi_ptr #604

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

steffenlarsen
Copy link
Contributor

The legacy decoration for multi_ptr has been made the default template argument of the decoration in multi_ptr to bridge the gap between SYCL 1.2.1 and SYCL 2020 multi_ptr interfaces. However, the legacy decoration and the specialization of multi_ptr with the decoration is deprecated with SYCL 2020. This is confusing to users as they may easily run into deprecation warnings simply due to not specifying the decoration. This commit proposes that we remove the deprecation of legacy in SYCL 2020.

The legacy decoration for multi_ptr has been made the default template
argument of the decoration in multi_ptr to bridge the gap between
SYCL 1.2.1 and SYCL 2020 multi_ptr interfaces. However, the legacy
decoration and the specialization of multi_ptr with the decoration is
deprecated with SYCL 2020. This is confusing to users as they may easily
run into deprecation warnings simply due to not specifying the
decoration. This commit proposes that we remove the deprecation of
legacy in SYCL 2020.

Signed-off-by: Larsen, Steffen <[email protected]>
@steffenlarsen
Copy link
Contributor Author

Note that async_work_group_copy using legacy multi_ptr is still deprecated. We can undeprecate them, but their signatures will be slightly different from the yes-no deprecated ones.

@tomdeakin tomdeakin added the Agenda To be discussed during a SYCL committee meeting label Aug 19, 2024
@VerenaBeckham
Copy link
Contributor

VerenaBeckham commented Aug 22, 2024

How about the statement in programming_interface.adoc:

Note that using [code]#global_ptr#, [code]#local_ptr#, [code]#constant_ptr# or
[code]#private_ptr# without specifying the decoration is deprecated.
The default argument is provided for compatibility with 1.2.1.

Should that also be removed as part of this PR?

@tomdeakin tomdeakin removed the Agenda To be discussed during a SYCL committee meeting label Aug 28, 2024
Signed-off-by: Larsen, Steffen <[email protected]>
@steffenlarsen
Copy link
Contributor Author

How about the statement in programming_interface.adoc:

Note that using [code]#global_ptr#, [code]#local_ptr#, [code]#constant_ptr# or
[code]#private_ptr# without specifying the decoration is deprecated.
The default argument is provided for compatibility with 1.2.1.

Should that also be removed as part of this PR?

Good catch! It has been removed.

Copy link
Contributor

@VerenaBeckham VerenaBeckham left a comment

Choose a reason for hiding this comment

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

I can't comment on whether this change is the right thing to do, but the code LGTM.

@AerialMantis
Copy link
Collaborator

I think we also need to update the change log, that currently states that the legacy option for multi_ptr is deprecated.

  • legacy 1.2.1 interface (deprecated).

Copy link
Collaborator

@AerialMantis AerialMantis left a comment

Choose a reason for hiding this comment

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

I think we might need to update the change log as well, but other than that this change LGTM.

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.

6 participants