Doctest output starting with #

[mortenpi]

The following doctest will fail

julia> f(x) = println("# output from f\n$x");

julia> f(42)
# output from f
42

because we consider lines starting # as comments and include in the source part of the doctest, kinda:

Documenter.jl/src/DocTests.jl

Lines 454 to 456 in 3e2090a

	# ANON_FUNC_DECLARATION deals with `x->x` -> `#1 (generic function ....)` on 0.7
	# TODO: Remove this special case and just disallow lines with comments?
	startswith(line, '#') && !occursin(ANON_FUNC_DECLARATION, line) && continue

Arguably, we should only consider the # as part of the doctest source if it is preceded by 7 spaces (our standard heuristic for determining if something is part of the source or output part):

julia> f(x) = println("# output from f\n$x");

julia> f(42)
       # actual comment
# output from f
42

X-ref: JuliaLang/julia#36696

[fredrikekre]

Nice!