Deprecate HLSL compilation support Update the README and CHANGES See https://github.com/KhronosGroup/glslang/issues/4210
diff --git a/CHANGES b/CHANGES index 68df5f8..a4c519f 100644 --- a/CHANGES +++ b/CHANGES
@@ -1,7 +1,9 @@ Revision history for Shaderc v2026.3-dev 2026-04-24 - - Start development + - Deprecate HLSL compilation. + - Add build option SHADERC_ENABLE_HLSL to build Shaderc without + HLSL support. v2026.2 2026-04-24 - Test GL_EXT_descriptor_heap
diff --git a/README.md b/README.md index bc10b01..a7c7855 100644 --- a/README.md +++ b/README.md
@@ -6,10 +6,10 @@ - [`glslc`](glslc), a command line compiler for GLSL/HLSL to SPIR-V, and - [`libshaderc`](libshaderc), a library API for accessing `glslc` functionality. -**Note:** The fact that that `libshaderc` is not named `libshaderc_glslc` is a -quirk of history, and a known inconsistency. Changing it would require a -significant amount of renaming and breaking of downstream projects, so it is -being left as is. +***NOTE*** The ability to compile HLSL is *deprecated*, since it is +deprecated in Glslang. +See Glslang [issue #4210](https://github.com/KhronosGroup/glslang/issues/4210). +This ability will be removed at a future date. `glslc` wraps around core functionality in [glslang][khr-glslang] and [SPIRV-Tools][spirv-tools]. `glslc` and its library aims to @@ -159,6 +159,18 @@ See [the libshaderc README](libshaderc/README.md) for more on using the library API in your project. +#### HLSL deprecation + +As noted above, Glslang has deprecated support for compiling HLSL, and will +remove it at some point in the future. + +You can build Shaderc today without HLSL support. +To do so: + +- For the CMake build, invoke `cmake` with option `-DSHADERC_ENABLE_HLSL=OFF`, or `-DSHADERC_ENABLE_HLSL=0`. +- For the Android `ndk-build`, set environment variable `SHADERC_ENABLE_HLSL` to + `0` when invoking `ndk-build` + ### Tools you'll need For building, testing, and profiling Shaderc, the following tools should be