Update docstring formatting

- Add syntax highlighting tags
- Add headers for examples
- Add backticks for monospace content

Author: abhro

docs/src/basicUsage.md

@@ -344,7 +344,7 @@ If `TermInterface` is loaded (below), the `operation` method returns the outermo
 
 The `Basic` type is a Julia type wrapping an underlying symengine object. When a Julia method is called on symbolic objects, the method almost always resolves to some call (via `ccall`) into the `libsymengine` C++ library. The design typically involves mutating a newly constructed `Basic` variable. Some allocations can be saved by calling the mutating version of the operations:
 
-```
+```julia
 @vars x
 a = Basic()
 SymEngine.sin!(a, x)
@@ -359,7 +359,7 @@ There is an extension for `TermInterface` (and `SymbolicUtils`) which should all
 
 
 ```@example symengine
-using SymbolicUtils;
+using SymbolicUtils
 @vars x
 simplify(sin(x)^2 + cos(x)^2)
 ```

docs/src/index.md

@@ -10,7 +10,7 @@ This site contains the documentation and `julia` language bindings for the [Syme
 ## Installation
 The package and dependencies can be obtained with standard `Pkg` calls.
 
-```julia
+```julia-repl
 julia> Pkg.add("SymEngine")
 ```
 

src/dense-matrix.jl

@@ -171,7 +171,7 @@ LinearAlgebra.factorize(M::CDenseMatrix) = factorize(convert(Matrix, M))
 """
 LU decomposition for CDenseMatrix, dense matrices of symbolic values
 
-Also: lufact(a, val{:false}) for non-pivoting lu factorization
+Also: `lufact(a, Val{:false})` for non-pivoting lu factorization
 """
 function LinearAlgebra.lu(a::CDenseMatrix)
     l, u = dense_matrix_LU(a)

src/subs.jl

@@ -8,8 +8,9 @@
 
 Substitute values into a symbolic expression.
 
-Examples
-```
+### Examples
+
+```julia
 @vars x y
 ex = x^2 + y^2
 subs(ex, x, 1) # 1 + y^2
@@ -131,7 +132,7 @@ walk_expression(b) = convert(Expr, b)
 """
     lambdify(ex, vars=[]; cse=false)
 
-evaluates a symbolless expression or returns a function
+Evaluates a symbol-less expression or returns a function
 """
 function lambdify(ex, vars=[])
     if length(vars) == 0
@@ -174,7 +175,7 @@ end
 function _lambdify(ex::Expr, vars)
     try
         fn = eval(Expr(:function,
-                  Expr(:call, gensym(), map(Symbol,vars)...),
+                       Expr(:call, gensym(), map(Symbol,vars)...),
                        ex))
         (args...) -> invokelatest(fn, args...) # https://github.com/JuliaLang/julia/pull/19784
     catch err

src/types.jl

@@ -137,8 +137,9 @@ _symbol(s::Symbol) = _symbol(string(s))
 
 Construct symbolic value.
 
-Examples:
-```
+### Examples
+
+```julia
 a = symbols(:a)
 x = symbols("x")
 x,y = symbols("x y")
@@ -162,7 +163,7 @@ end
 
 Macro to define 1 or more variables or symbolic function
 
-Example
+### Examples
 ```
 @vars x y z
 @vars x[1:4]