-
Notifications
You must be signed in to change notification settings - Fork 745
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
Conversation
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.
sycl/doc/extensions/DiscardQueueEvents/SYCL_EXT_ONEAPI_DISCARD_QUEUE_EVENTS.asciidoc
Outdated
Show resolved
Hide resolved
sycl/doc/extensions/supported/SYCL_EXT_ONEAPI_BACKEND_LEVEL_ZERO.md
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 |
There was a problem hiding this comment.
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 :(
There was a problem hiding this comment.
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.
Change absolute links to relative. Co-authored-by: Pavel Chupin <pavel.v.chupin@intel.com>
Fix the link syntax from @pvchupin's suggestion.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nice! LGTM. 👍
There was a problem hiding this 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.
1d627d4
Conflicts resolved. |
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.