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

[SYCL][DOC] Move supported extension docs #5421

Merged
merged 5 commits into from
Feb 1, 2022

Conversation

gmlueck
Copy link
Contributor

@gmlueck gmlueck commented Jan 28, 2022

Move the supported extensions to the "sycl/doc/extensions/supported"
directory, and add a README explaining the content of that directory.
Each extension document has also been renamed to match the name of
its feature-test macro.

Links to these extensions have been removed from the table in
"sycl/doc/extensions/README.md" because we want to avoid the
possibility of that table getting out-of-date with the directory
contents. Instead, users can see the list of supported extensions
by listing the content of the directory.

Move the supported extensions to the "sycl/doc/extensions/supported"
directory, and add a README explaining the content of that directory.
Each extension document has also been renamed to match the name of
its feature-test macro.

Links to these extensions have been removed from the table in
"sycl/doc/extensions/README.md" because we want to avoid the
possibility of that table getting out-of-date with the directory
contents.  Instead, users can see the list of supported extensions
by listing the content of the directory.
@gmlueck gmlueck requested a review from a team January 28, 2022 21:15
@gmlueck gmlueck requested review from a team as code owners January 28, 2022 21:15
@gmlueck gmlueck requested a review from steffenlarsen January 28, 2022 21:15
sycl/doc/MultiTileCardWithLevelZero.md Outdated Show resolved Hide resolved
sycl/doc/CompileTimeProperties.md Outdated Show resolved Hide resolved
sycl/doc/extensions/ExplicitSIMD/README.md Outdated Show resolved Hide resolved
sycl/doc/extensions/Matrix/dpcpp-joint-matrix.asciidoc Outdated Show resolved Hide resolved
sycl/plugins/level_zero/pi_level_zero.cpp Outdated Show resolved Hide resolved
@@ -22,7 +22,7 @@ Requirements

Links
-----
.. _Spec: https://github.com/intel/llvm/blob/sycl/sycl/doc/extensions/DataFlowPipes/data_flow_pipes.asciidoc
.. _Spec: https://github.com/intel/llvm/blob/sycl/sycl/doc/extensions/supported/SYCL_EXT_INTEL_DATAFLOW_PIPES.asciidoc
Copy link
Contributor

Choose a reason for hiding this comment

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

Not sure how to make relative link here :(

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I also don't know reStructuredText that well. When I look at the HTML rendering of this file in GitHub, all the content in this area of the document is missing. It seems like the GitHub renderer doesn't understand the .. code directive. So, there are bigger problems than the absolute vs. relative URL link.

gmlueck and others added 3 commits January 31, 2022 09:22
Change absolute links to relative.

Co-authored-by: Pavel Chupin <pavel.v.chupin@intel.com>
Fix the link syntax from @pvchupin's suggestion.
@gmlueck gmlueck requested review from bader and pvchupin January 31, 2022 15:42
pvchupin
pvchupin previously approved these changes Jan 31, 2022
steffenlarsen
steffenlarsen previously approved these changes Jan 31, 2022
Copy link
Contributor

@steffenlarsen steffenlarsen left a comment

Choose a reason for hiding this comment

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

Nice! LGTM. 👍

againull
againull previously approved these changes Jan 31, 2022
kbobrovs
kbobrovs previously approved these changes Feb 1, 2022
bader
bader previously approved these changes Feb 1, 2022
Copy link
Contributor

@bader bader left a comment

Choose a reason for hiding this comment

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

Please, resolve merge conflicts.

@gmlueck
Copy link
Contributor Author

gmlueck commented Feb 1, 2022

Please, resolve merge conflicts.

Conflicts resolved.

@bader bader merged commit 2521592 into intel:sycl Feb 1, 2022
@gmlueck gmlueck deleted the gmlueck/mv-supported-extensions branch February 1, 2022 16:17
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