How to display docstring output for function with multiple methods?

[nathanrboyer]

I like the feature where a function defined in a cell shows its docstring as the output. However, I am having trouble getting that to work when multiple methods are required.

The Pluto FAQ says to write multiple methods in a begin-end block, but then I get no output.

Contrary to the FAQ information, the method definitions seem to work okay in separate cells, but then I get a second output. I can suppress the second output with ;, but this puts a weird gap in my sequence of docstrings. Does the FAQ information need to be updated?

[fonsp]

Hey! There is no obvious way to do it, but this what I do:

begin
	f(x::String) = x
	f(x::Int) = x + 1

	@doc """
	```julia
	f(x::Union{String,Int})
	```

	Return something like `x`.
	
	""" f

end

---

Maybe you could also write your own macro? But docstrings are a bit tricky to work with in macros.

[nathanrboyer]

It still works without the explicit @doc macro. You just have to have the documented function be the last item in the begin block.