Integration of equations in Docs.

[amitjamadagni]

The current documentation does not include equations, this would require LaTeX in Docile. The issue hopes to get some references along these lines. Any pointers on these would also be helpful.

[amitjamadagni]

An update : I had posted this in the Docile gitter room and here is the reply :

The markdown parser should display LaTeX equations with a purple highlight in the REPL. Since $ and \ aren't treated as plain characters in docstrings you'll need to escape them with \ or you could define a string macro in your module to do it for you:

macro L_str(text) 
text 
end

and then apply it to docstrings like so:

L""" 
Some maths: 

$$\int_a^b f(x) \, dx = 0$$ 
""" 
f(x) = x 

For static documentation generation the markdown output should preserve LaTeX syntax. The generated markdown files can then be passed to any program the handles LaTeX equations correctly, such as pandoc. I'm not sure how well mkdocs with ReadTheDocs will do currently.

[amitjamadagni]

The QuODE types had duplication in the documentation. Again getting help from gitter room of Docile they have presented three options :

• String the ops and then use in the loop

for op in [:a, :b, :c]
    text = "$(op)"
    @eval begin
        @doc $(text) ->
        $(op)(x) = x
    end
end

• Have a common doc for QuODESolvers and then create a Dict for each of the subtypes

@doc """
...
""" ->
abstract QuODESolvers <: QuPropagatorMethod

const type_to_method = @compat Dict{Any, Any}(#...

const subtypedocs = @compat Dict(#...

for op in keys(type_to_method)
    text = subtypedocs[op]
    @eval  begin
        @doc $(text) ->
        immutable $op <: QuODESolvers
            options::Dict{Symbol, Any}
        end
        $op() = $op(Dict())
    end
end

• Double interpolate the variable, same as first but not using text variable

for op in [:a, :b, :c]
    @eval begin
        @doc "$($(op))" ->
        $(op)(x) = x
    end
end