minor doc corrections

Author: franckgaga

src/model/linmodel.jl

@@ -188,9 +188,10 @@ end
 
 Construct the model from the discrete state-space matrices `A, Bu, C, Bd, Dd` directly.
 
-This syntax do not modify the state-space representation provided in argument (`minreal`
-is not called). Care must be taken to ensure that the model is controllable and observable.
-The optional parameter `NT` explicitly specifies the number type of the matrices.
+See [`LinModel(::StateSpace)`](@ref) Extended Help for the meaning of the matrices. This
+syntax do not modify the state-space representation provided in argument (`minreal` is not
+called). Care must be taken to ensure that the model is controllable and observable. The
+optional parameter `NT` explicitly specifies the number type of the matrices.
 """
 LinModel{NT}(A, Bu, C, Bd, Dd, Ts) where NT<:Real
 

src/model/nonlinmodel.jl

@@ -40,11 +40,11 @@ functions are defined as:
 ```
 They can be implemented in two possible ways:
 
-- Non-mutating functions (out-of-place): defined them as `f(x, u, d) -> ẋ` and
-  `h(x, d) -> y`. This syntax is simple and intuitive but it allocates more memory.
-- Mutating functions (in-place): defined them as `f!(ẋ, x, u, d) -> nothing` and
-  `h!(y, x, d) -> nothing`. This syntax reduces the allocations and potentially the 
-  computational burden as well.
+1. **Non-mutating functions** (out-of-place): define them as `f(x, u, d) -> ẋ` and
+   `h(x, d) -> y`. This syntax is simple and intuitive but it allocates more memory.
+2. **Mutating functions** (in-place): define them as `f!(ẋ, x, u, d) -> nothing` and
+   `h!(y, x, d) -> nothing`. This syntax reduces the allocations and potentially the 
+   computational burden as well.
 
 `Ts` is the sampling time in second. `nu`, `nx`, `ny` and `nd` are the respective number of 
 manipulated inputs, states, outputs and measured disturbances. 
@@ -99,9 +99,9 @@ NonLinModel with a sample time Ts = 2.0 s, empty solver and:
     ```
     with two possible implementations as well:
 
-    - Non-mutating functions: defined them as `f(x, u, d) -> xnext` and `h(x, d) -> y`.
-    - Mutating functions: defined them as `f!(xnext, x, u, d) -> nothing` and
-      `h!(y, x, d) -> nothing`.
+    1. **Non-mutating functions**: define them as `f(x, u, d) -> xnext` and `h(x, d) -> y`.
+    2. **Mutating functions**: define them as `f!(xnext, x, u, d) -> nothing` and
+       `h!(y, x, d) -> nothing`.
 """
 function NonLinModel{NT}(
     f::Function, h::Function, Ts::Real, nu::Int, nx::Int, ny::Int, nd::Int=0;