REPL helpmode for "=" returns error

[aaron-jesse-ol]

help?> =
ERROR: LoadError: Invalid @var syntax `unexpected "="`.
Stacktrace:
 [1] splitexpr(::Any) at ./docs/bindings.jl:28
 [2] bindingexpr(::Any) at ./docs/bindings.jl:17
 [3] lookup_doc(::Expr) at /build/julia/src/julia/usr/share/julia/stdlib/v1.0/REPL/src/docview.jl:137
 [4] @doc(::LineNumberNode, ::Module, ::Expr, ::Vararg{Expr,N} where N) at ./boot.jl:451
in expression starting at /build/julia/src/julia/usr/share/julia/stdlib/v1.0/REPL/src/docview.jl:301

Looking at basedocs.jl, it seems like there isn't actually a docstring for =, so maybe parsing it isn't important. OTOH at least one user (me) has thought this would be the quick way to get answers about how = works in Julia.

Julia Version 1.0.0
Commit 5d4eaca0c9 (2018-08-08 20:58 UTC)
Platform Info:
  OS: Linux (x86_64-pc-linux-gnu)
  CPU: Intel(R) Core(TM) i7-5500U CPU @ 2.40GHz
  WORD_SIZE: 64
  LIBM: libopenlibm
  LLVM: libLLVM-6.0.0 (ORCJIT, broadwell)
Environment:
  JULIA_EDITOR = atom -a
  JULIA_NUM_THREADS = 2

[fredrikekre]

Docs for = should definitely be added.

[aaron-jesse-ol]

Would that I were competent to do so myself. I'll just also note that it seems like the parsing issue lies with splitexpr, and the way it tries to look up a symbol using getfield(Base, :symbol), which isn't valid for a variety of more special symbols, like =, ., or @.

[fredrikekre]

Right, thats why some things are documented using the kw_str string macro, for example

julia/base/docs/basedocs.jl

Lines 29 to 37 in 6fa3e45

	"""
	using
	`using Foo` will load the module or package `Foo` and make its [`export`](@ref)ed names
	available for direct use. Names can also be used via dot syntax (e.g. `Foo.foo` to access
	the name `foo`), whether they are `export`ed or not.
	See the [manual section about modules](@ref modules) for details.
	"""
	kw"using"

So this work:

julia> import Base.BaseDocs.@kw_str

julia> """
           =

       Assignment operator.
       """
       kw"="

help?> =
search: => == === >= <= != !==

  =

  Assignment operator.

[aaron-jesse-ol]

Ah, great. Then I'll at least draft a doc.

[fredrikekre]

#30745