Attaching docs to call overloading (self::Objectt)(a,b,c)

[vchuravy]

This code errors with the cryptic message:

ERROR: LoadError: UndefVarError: self not defined
 in category(::Base.Docs.Binding) at /home/wallnuss/.julia/v0.6/Documenter/src/DocSystem.jl:383
 in runner(::Type{Documenter.Expanders.AutoDocsBlocks}, ::Base.Markdown.Code, ::Documenter.Documents.Page, ::Documenter.Documents.Document) at /home/wallnuss/.julia/v0.6/Documenter/src/Expanders.jl:327
 in dispatch(::Type{Documenter.Expanders.ExpanderPipeline}, ::Base.Markdown.Code, ::Documenter.Documents.Page, ::Documenter.Documents.Document) at /home/wallnuss/.julia/v0.6/Documenter/src/Selectors.jl:164
 in expand(::Documenter.Documents.Document) at /home/wallnuss/.julia/v0.6/Documenter/src/Expanders.jl:29
 in dispatch(::Type{Documenter.Builder.DocumentPipeline}, ::Documenter.Documents.Document) at /home/wallnuss/.julia/v0.6/Documenter/src/Selectors.jl:164
 in cd(::Documenter.##2#3{Documenter.Documents.Document}, ::String) at ./file.jl:59
 in #makedocs#1(::Bool, ::Array{Any,1}, ::Function) at /home/wallnuss/.julia/v0.6/Documenter/src/Documenter.jl:156
 in (::Documenter.#kw##makedocs)(::Array{Any,1}, ::Documenter.#makedocs) at ./<missing>:0
 in include_from_node1(::String) at ./loading.jl:426
 in process_options(::Base.JLOptions) at ./client.jl:262
 in _start() at ./client.jl:318
while loading /home/wallnuss/src/MXNet.jl/docs/make.jl, in expression starting on line 3

 """
      call(self :: SymbolicNode, args :: SymbolicNode...)
      call(self :: SymbolicNode; kwargs...)

  Make a new node by composing `self` with `args`. Or the arguments
  can be specified using keyword arguments.
"""
@compat function (self::SymbolicNode)(args :: SymbolicNode...)
end

see dmlc/MXNet.jl#118

[MichaelHatherly]

Documenting call syntax is not supported by the docsystem at the moment, since there isn't a particular named object that the docstring should be attached to, i.e. it is trying to document an instance of a named object SymbolicNode rather than SymbolicNode itself. I've not yet come up with a decent approach to supporting this without needing to special case a bunch of things in the docsystem.

[MichaelHatherly]

(Closing since there's not much that can be done within Documenter itself to change this).