diff --git a/src/transform/bound_array_accessors.h b/src/transform/bound_array_accessors.h index 7c97a8b773..899e7d3ef5 100644 --- a/src/transform/bound_array_accessors.h +++ b/src/transform/bound_array_accessors.h @@ -39,9 +39,6 @@ class BoundArrayAccessors : public Transform { ~BoundArrayAccessors() override; /// Runs the transform on `program`, returning the transformation result. - /// @note Users of Tint should register the transform with transform manager - /// and invoke its Run(), instead of directly calling the transform's Run(). - /// Calling Run() directly does not perform program state cleanup operations. /// @param program the source program to transform /// @returns the transformation result Output Run(const Program* program) override; diff --git a/src/transform/emit_vertex_point_size.h b/src/transform/emit_vertex_point_size.h index edd07fa527..210cd5106a 100644 --- a/src/transform/emit_vertex_point_size.h +++ b/src/transform/emit_vertex_point_size.h @@ -33,9 +33,6 @@ class EmitVertexPointSize : public Transform { ~EmitVertexPointSize() override; /// Runs the transform on `program`, returning the transformation result. - /// @note Users of Tint should register the transform with transform manager - /// and invoke its Run(), instead of directly calling the transform's Run(). - /// Calling Run() directly does not perform program state cleanup operations. /// @param program the source program to transform /// @returns the transformation result Output Run(const Program* program) override; diff --git a/src/transform/first_index_offset.h b/src/transform/first_index_offset.h index ffbf496790..b8983ae81a 100644 --- a/src/transform/first_index_offset.h +++ b/src/transform/first_index_offset.h @@ -69,9 +69,6 @@ class FirstIndexOffset : public Transform { ~FirstIndexOffset() override; /// Runs the transform on `program`, returning the transformation result. - /// @note Users of Tint should register the transform with transform manager - /// and invoke its Run(), instead of directly calling the transform's Run(). - /// Calling Run() directly does not perform program state cleanup operations. /// @param program the source program to transform /// @returns the transformation result Output Run(const Program* program) override; diff --git a/src/transform/hlsl.h b/src/transform/hlsl.h index 193e54bc30..a313c93f67 100644 --- a/src/transform/hlsl.h +++ b/src/transform/hlsl.h @@ -34,9 +34,6 @@ class Hlsl : public Transform { ~Hlsl() override; /// Runs the transform on `program`, returning the transformation result. - /// @note Users of Tint should register the transform with transform manager - /// and invoke its Run(), instead of directly calling the transform's Run(). - /// Calling Run() directly does not perform program state cleanup operations. /// @param program the source program to transform /// @returns the transformation result Output Run(const Program* program) override; diff --git a/src/transform/manager.h b/src/transform/manager.h index 0816ce0f0a..f2f43417f0 100644 --- a/src/transform/manager.h +++ b/src/transform/manager.h @@ -26,9 +26,10 @@ namespace tint { namespace transform { -/// Manager for the provided passes. The passes will be execute in the -/// appended order. If any pass fails the manager will return immediately and -/// the error can be retrieved with the error() method. +/// A collection of Transforms that act as a single Transform. +/// The inner transforms will execute in the appended order. +/// If any inner transform fails the manager will return immediately and +/// the error can be retrieved with the Output's diagnostics. class Manager : public Transform { public: /// Constructor diff --git a/src/transform/msl.h b/src/transform/msl.h index b437608965..d98ae6ca29 100644 --- a/src/transform/msl.h +++ b/src/transform/msl.h @@ -30,9 +30,6 @@ class Msl : public Transform { ~Msl() override; /// Runs the transform on `program`, returning the transformation result. - /// @note Users of Tint should register the transform with transform manager - /// and invoke its Run(), instead of directly calling the transform's Run(). - /// Calling Run() directly does not perform program state cleanup operations. /// @param program the source program to transform /// @returns the transformation result Output Run(const Program* program) override; diff --git a/src/transform/spirv.h b/src/transform/spirv.h index 5f79d81dcb..cb67e738ec 100644 --- a/src/transform/spirv.h +++ b/src/transform/spirv.h @@ -34,9 +34,6 @@ class Spirv : public Transform { ~Spirv() override; /// Runs the transform on `program`, returning the transformation result. - /// @note Users of Tint should register the transform with transform manager - /// and invoke its Run(), instead of directly calling the transform's Run(). - /// Calling Run() directly does not perform program state cleanup operations. /// @param program the source program to transform /// @returns the transformation result Output Run(const Program* program) override; diff --git a/src/transform/transform.h b/src/transform/transform.h index c3f05c19f7..3516259183 100644 --- a/src/transform/transform.h +++ b/src/transform/transform.h @@ -54,9 +54,6 @@ class Transform { }; /// Runs the transform on `program`, returning the transformation result. - /// @note Users of Tint should register the transform with transform manager - /// and invoke its Run(), instead of directly calling the transform's Run(). - /// Calling Run() directly does not perform program state cleanup operations. /// @param program the source program to transform /// @returns the transformation result virtual Output Run(const Program* program) = 0; diff --git a/src/transform/vertex_pulling.h b/src/transform/vertex_pulling.h index 3db054d866..215052e458 100644 --- a/src/transform/vertex_pulling.h +++ b/src/transform/vertex_pulling.h @@ -160,9 +160,6 @@ class VertexPulling : public Transform { void SetPullingBufferBindingGroup(uint32_t number); /// Runs the transform on `program`, returning the transformation result. - /// @note Users of Tint should register the transform with transform manager - /// and invoke its Run(), instead of directly calling the transform's Run(). - /// Calling Run() directly does not perform program state cleanup operations. /// @param program the source program to transform /// @returns the transformation result Output Run(const Program* program) override;