[Solver] Deprecate computeResidual method as it is unused (#5737)

* [Solver] Remove `computeResidual` method as it is unused

* Revert "[Solver] Remove `computeResidual` method as it is unused"

This reverts commit eb015a0.

* deprecate instead of removing

Author: alxbilger

Sofa/framework/Core/src/sofa/core/behavior/BaseConstraintCorrection.h

@@ -115,6 +115,7 @@ class SOFA_CORE_API BaseConstraintCorrection : public virtual objectmodel::BaseO
     /// Compute the residual in the newton iterations due to the constraints forces
     /// i.e. compute Vecid::force() += J^t lambda
     /// the result is accumulated in Vecid::force()
+    SOFA_ATTRIBUTE_DEPRECATED__COMPUTERESIDUAL()
     virtual void computeResidual(const core::ExecParams* /*params*/, linearalgebra::BaseVector * /*lambda*/) ;
 
     virtual void applyContactForce(const linearalgebra::BaseVector *f) = 0;

Sofa/framework/Core/src/sofa/core/behavior/ConstraintSolver.h

@@ -90,6 +90,7 @@ class SOFA_CORE_API ConstraintSolver : public virtual objectmodel::BaseObject
     /// Compute the residual in the newton iterations due to the constraints forces
     /// i.e. compute Vecid::force() += J^t lambda
     /// the result is accumulated in Vecid::force()
+    SOFA_ATTRIBUTE_DEPRECATED__COMPUTERESIDUAL()
     virtual void computeResidual(const core::ExecParams* /*params*/)
     {
         dmsg_error() << "ComputeResidual is not implemented in " << this->getName() ;

Sofa/framework/Core/src/sofa/core/behavior/LinearSolver.h

@@ -125,6 +125,7 @@ class SOFA_CORE_API LinearSolver : public BaseLinearSolver
     /// Compute the residual in the newton iterations due to the constraints forces
     /// i.e. compute mparams->dF() = J^t lambda
     /// the result is written in mparams->dF()
+    SOFA_ATTRIBUTE_DEPRECATED__COMPUTERESIDUAL()
     virtual void computeResidual(const core::ExecParams* /*params*/, linearalgebra::BaseVector* /*f*/) {
         msg_error() << "computeResidual has not been implemented.";
     }

Sofa/framework/Core/src/sofa/core/config.h.in

@@ -153,4 +153,11 @@ SOFA_ATTRIBUTE_DEPRECATED("v25.12", "v26.06", "Use getContactDistance or setCont
 #else
 #define SOFA_ATTRIBUTE_RENAMED__COLLISIONMODEL_PROXIMITY() \
     SOFA_ATTRIBUTE_DEPRECATED("v25.12", "v26.12", "Data 'proximity' has been renamed to 'contactDistance'")
-#endif
+#endif
+
+#ifdef SOFA_BUILD_SOFA_CORE
+#define SOFA_ATTRIBUTE_DEPRECATED__COMPUTERESIDUAL()
+#else
+#define SOFA_ATTRIBUTE_DEPRECATED__COMPUTERESIDUAL() \
+    SOFA_ATTRIBUTE_DEPRECATED("v25.12", "v26.06", "The method computeResidual is not used")
+#endif