KhronosGroup / OpenCL-Registry

OpenCL API and Extension Registry.
112 stars 42 forks source link

Dead links in OpenCL registry #146

Open outofcontrol opened 6 months ago

outofcontrol commented 6 months ago

The following table lists 32 pages that have a broken link (404) on them, mostly in the /OpenCL/sdk/3.0 area:

Page Anchor Text Link URL HTTP Status Code (link page)
https://registry.khronos.org/OpenCL/ Specification https://registry.khronos.org/OpenCL/specs/opencl-2.0-openclc.pdf 404 Not found
https://registry.khronos.org/OpenCL/ https://registry.khronos.org/feeds/ 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clCloneKernel.html CL_VERSION_2_1 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_1.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clCreateBuffer.html CL_VERSION_3_0 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_3_0.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clCreateBufferWithProperties.html CL_VERSION_3_0 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_3_0.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clCreateCommandQueueWithProperties.html CL_VERSION_2_0 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_0.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clCreateImage.html CL_VERSION_3_0 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_3_0.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clCreateImageWithProperties.html CL_VERSION_3_0 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_3_0.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clCreatePipe.html CL_VERSION_2_0 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_0.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clCreateProgramWithIL.html CL_VERSION_2_1 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_1.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clCreateSamplerWithProperties.html CL_VERSION_2_0 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_0.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clEnqueueSVMFree.html CL_VERSION_2_0 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_0.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clEnqueueSVMMap.html CL_VERSION_2_0 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_0.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clEnqueueSVMMemFill.html CL_VERSION_2_0 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_0.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clEnqueueSVMMemcpy.html CL_VERSION_2_0 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_0.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clEnqueueSVMMigrateMem.html CL_VERSION_2_1 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_1.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clEnqueueSVMUnmap.html CL_VERSION_2_0 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_0.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clGetDeviceAndHostTimer.html CL_VERSION_2_1 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_1.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clGetHostTimer.html CL_VERSION_2_1 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_1.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clGetKernelSubGroupInfo.html CL_VERSION_2_1 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_1.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clGetPipeInfo.html CL_VERSION_2_0 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_0.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clSVMAlloc.html CL_VERSION_2_0 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_0.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clSVMFree.html CL_VERSION_2_0 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_0.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clSetContextDestructorCallback.html CL_VERSION_3_0 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_3_0.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clSetDefaultDeviceCommandQueue.html CL_VERSION_2_1 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_1.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clSetKernelArgSVMPointer.html CL_VERSION_2_0 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_0.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clSetKernelExecInfo.html CL_VERSION_2_0 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_0.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clSetProgramReleaseCallback.html CL_VERSION_2_2 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_2.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/clSetProgramSpecializationConstant.html CL_VERSION_2_2 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_2.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/cl_mem_properties.html CL_VERSION_3_0 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_3_0.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/cl_pipe_properties.html CL_VERSION_2_0 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_0.html 404 Not found
https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/cl_queue_properties.html CL_VERSION_2_0 https://registry.khronos.org/OpenCL/sdk/3.0/docs/man/html/CL_VERSION_2_0.html 404 Not found
bashbaug commented 6 months ago

Darn, I thought we fixed these with https://github.com/KhronosGroup/OpenCL-Docs/pull/983, but it looks like we only did so for the CL_VERSION_1_X enums and not for the newer 2.x or 3.0 enums. Good news is that most of these should be easy to fix.

I'll take a closer look at the first two, since they appear to be different.

bashbaug commented 6 months ago

I can fix the first link - this one was actually reported before in #126.

@outofcontrol the second seems to be common to the Khronos footer though, so it is not OpenCL-specific. Is this something you could look into? It's this that is causing the problem:

image

outofcontrol commented 6 months ago

Thanks @bashbaug I should have caught that. The feeds broken link is now fixed.

bashbaug commented 6 months ago

For future reference, the removal of the OpenCL C 2.0 PDF spec was discussed in internal OpenCL-Docs issue 158.

I think we decided in today's OpenCL teleconference to put the removed file back, which means merging PR #148. This is most consistent with the other OpenCL specifications, where older versions are still available for reference purposes. I'll wait for a review approval before merging it, though.

bashbaug commented 6 months ago

I just merged #148. @outofcontrol can you please check if there are any remaining broken links? Thanks!

edit: to clarify: Can you please check if there any broken links on the OpenCL registry webpage? We'll need to do a bit more work to fix the broken links in the OpenCL reference pages.

outofcontrol commented 5 months ago

I just merged #148. @outofcontrol can you please check if there are any remaining broken links? Thanks!

edit: to clarify: Can you please check if there any broken links on the OpenCL registry webpage? We'll need to do a bit more work to fix the broken links in the OpenCL reference pages.

Still seeing a total of 30 pages within the /OpenCL/sdk/3.0docs/man/html tree with 404 links to:

Do you want those pages listed here or via email?

bashbaug commented 3 months ago

@outofcontrol we've updated the reference pages for the 3.0.16 spec release so I think all of the CL_VERSION_X_Y links should be fixed now. Could you please re-run the link checker to confirm and to ensure we haven't broken anything else in the process? Thanks!