Improve docu of solve()

Author: ufechner7

docs/src/functions.md

@@ -6,7 +6,7 @@ CurrentModule = VortexStepMethod
 add_section!
 ```
 
-## Functions for setting the inflow conditions and solving
+## Setting the inflow conditions and solving
 ```@docs
 set_va!
 solve

src/solver.jl

@@ -75,11 +75,24 @@ struct Solver
 end
 
 """
-    solve(solver::Solver, body_aero::BodyAerodynamics, gamma_distribution=nothing; log=false, reference_point=zeros(MVec3))
+    solve(solver::Solver, body_aero::BodyAerodynamics, gamma_distribution=nothing; 
+          log=false, reference_point=zeros(MVec3))
 
 Main solving routine for the aerodynamic model. Reference point is in the kite body (KB) frame.
+
+# Arguments:
+- solver::Solver: The solver to use, could be a VSM or LLT solver. See: [Solver](@ref)
+- body_aero::BodyAerodynamics: The aerodynamic body. See: [BodyAerodynamics](@ref)
+- gamma_distribution
+
+# Keyword Arguments:
+- log=false: If true, print the number of iterations and other info.
+- reference_point=zeros(MVec3)
 """
-function solve(solver::Solver, body_aero::BodyAerodynamics, gamma_distribution=nothing; log=false, reference_point=zeros(MVec3))
+function solve(solver::Solver, body_aero::BodyAerodynamics, gamma_distribution=nothing; 
+               log=false, reference_point=zeros(MVec3))
+    
+    # check arguments
     isnothing(body_aero.panels[1].va) && throw(ArgumentError("Inflow conditions are not set, use set_va!(body_aero, va)"))
 
     # Initialize variables