update documentation and test file for AL algorithm

Author: BenjaminPINEAU

src/AL_alg.jl

@@ -116,6 +116,7 @@ If adopted, the Hessian is accessed as an abstract operator and need not be the
 - `init_subtol::T = T(0.1)`: initial subproblem tolerance;
 - `factor_decrease_subtol::T = T(1/4)`: multiplicative factor to decrease the subproblem tolerance;
 - `dual_safeguard = (nlp::AugLagModel) -> nothing`: in-place function to modify, as needed, the dual estimate.
+- `sub_kwargs::NamedTuple = NamedTuple()`: a named tuple containing the keyword arguments to be sent to the subsolver. The solver will fail if invalid keyword arguments are provided to the subsolver. For example, if the subsolver is R2Solver, you can pass sub_kwargs = (max_iter = 100, σmin = 1e-6,)
 
 # Output
 

test/test_AL.jl

@@ -5,7 +5,7 @@ problem_list = [:hs8]
   for problem in problem_list
     nlp = eval(problem)(backend = :optimized)
     for h in (NormL1(1.0),)
-      stats = AL(nlp, h, subsolver = R2Solver, atol = 1e-3, verbose = 1, subsolver_max_iter = 1000)
+      stats = AL(nlp, h, subsolver = R2Solver, atol = 1e-3, verbose = 1, sub_kwargs = (max_iter = 1000,))
       @test stats.status == :first_order
       @test stats.primal_feas <= 1e-2
       @test stats.dual_feas <= 1e-2
@@ -18,7 +18,7 @@ problem_list = [:hs8]
         subsolver = R2NSolver,
         atol = 1e-3,
         verbose = 1,
-        subsolver_max_iter = 1000,
+        sub_kwargs = (max_iter = 1000,),
       )
       @test stats.status == :first_order
       @test stats.primal_feas <= 1e-2