DocSystem

DocSystem

Provides a consistent interface to retreiving DocStr objects from the Julia docsystem in both 0.4 and 0.5.

source

Converts an object to a Base.Docs.Binding object.

binding(any)

Supported inputs are:

  • Binding
  • DataType
  • Function
  • Module
  • Symbol

Note that unsupported objects will throw an ArgumentError.

source
convertmeta(meta)

Converts a 0.4-style docstring cache into a 0.5 one.

The original docstring cache is not modified.

source
docstr(md; kws...)

Construct a DocStr object from a Markdown.MD object.

The optional keyword arguments are used to add new data to the DocStr's .data dictionary.

source
getdocs(binding)
getdocs(binding, typesig; compare, modules, aliases)

Find all DocStr objects that match the provided arguments:

  • binding: the name of the object.
  • typesig: the signature of the object. Default: Union{}.
  • compare: how to compare signatures? Exact (==) or subtypes (<:). Default: <:.
  • modules: which modules to search through. Default: all modules.
  • aliases: check aliases of binding when nothing is found. Default: true.

Returns a Vector{DocStr} ordered by definition order in 0.5 and by type_morespecific in 0.4.

source
getdocs(object)
getdocs(object, typesig; kws...)

Accepts objects of any type and tries to convert them to Bindings before searching for the Binding in the docsystem.

Note that when conversion fails this method returns an empty Vector{DocStr}.

source

Construct a MultiDoc object from the provided argument.

Valid inputs are:

  • Markdown.MD
  • Docs.FuncDoc
  • Docs.TypeDoc
source