clarification on the meaning of `VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT`

§ 7.1.2 currently defines VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT as

[...] specifies the execution of all graphics pipeline stages, and is equivalent to the logical OR of [list of bits]

At the same time, VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT is defined as (emphasis mine)

[...] specifies all operations performed by all commands supported on the queue it is used with.

While ALL_COMMANDS explicitely mentions that only supported features are included, ALL_GRAPHICS doesn't; furthermore, it is specified as being equivalent to a logical OR of all the specific bits. Since a stage mask must not contain unsupported features, this could be interpreted as that ALL_GRAPHICS cannot be used unless all specific features are supported by the device.

The validation layers do interpret ALL_GRAPHICS to only include supported features, which is most likely what is intended.

If that is the case, the wording should be changed to make clear that it's the logical OR of all supported bits.

Start by reading § 7.1.2 and the definitions of VK_PIPELINE_STAGE_2_ALL_GRAPHICS_BIT and VK_PIPELINE_STAGE_2_ALL_COMMANDS_BIT. Compare the wording with the validation layers' interpretation described in the issue. Done when the specification clearly states whether ALL_GRAPHICS covers all supported graphics stages and no longer suggests unsupported stages are required.