KhronosGroup / KhronosGroup/SYCL-Docs

Are `fast_length()` and `fast_normalize()` deprecated?

Open
#880 4 comments 1 reaction 0 assignees View on GitHub
clarification
Dominant language
JavaScript
Stars
158
Forks
80
Avg merge
7d 6h
Merged PRs (30d)
5

Description

### Specification Version

SYCL Next (Source)

### Section Number(s)

Also in SYCL 2020:

* [`fast_length()`](https://registry.khronos.org/SYCL/specs/sycl-2020/html/sycl-2020.html#api:fast_length)
* [`fast_normalize()`](https://registry.khronos.org/SYCL/specs/sycl-2020/html/sycl-2020.html#api:fast_normalize)

### Issue Description

#833 deprecated the `sycl::half_precision::` namespace. `fast_length()` and `fast_normalize()` are in the `sycl::` namespace, but are specified in terms of `half_precision` square roots. Either `fast_length()` and `fast_normalize()` need to be redefined without reference to `half_precision`, or they need to also be deprecated.

### Code Example (Optional)

_No response_

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with the linked SYCL 2020 sections for fast_length() and fast_normalize(), then review issue #833 on the deprecated sycl::half_precision namespace. Determine whether these functions should be redefined without half_precision or also deprecated; the specification is done when this ambiguity is resolved and the relevant wording is updated.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.