Documenter.jl: no docs found for ... in `@docs` block

General Usage
1

I’m utterly baffled. If I use the following code, Documenter.jl successfully finds all of my markdown documentation and populates an html file:

'''@autodocs
Modules = [PsychoJL]
Private = false
Order = [:function, :type]
'''

[backticks are not showing up in the post, so I used single quotes]

But, if I try to target a subset of functions and replace that code block with the following,

'''@docs
InitPsychoJL()
waitTime()
'''

I get the following error, despite @autodocs being able to successfully find waitTime()! Any idea what’s up?

[ Info: SetupBuildDirectory: setting up build directory.
[ Info: Doctest: running doctests.
[ Info: ExpandTemplates: expanding markdown templates.
┌ Error: no docs found for 'waitTime()' in `@docs` block in src/InitializationAndTiming.md:1-4
│ ```@docs
│ InitPsychoJL()
│ waitTime()
│ ```
└ @ Documenter ~/.julia/packages/Documenter/1HwWe/src/utilities/utilities.jl:44
[ Info: CrossReferences: building cross-references.
[ Info: CheckDocument: running document checks.
[ Info: Populate: populating indices.
ERROR: `makedocs` encountered an error [:docs_block] -- terminating build before rendering.
Stacktrace:
 [1] error(s::String)
   @ Base ./error.jl:35
 [2] runner(::Type{Documenter.Builder.RenderDocument}, doc::Documenter.Document)
   @ Documenter ~/.julia/packages/Documenter/1HwWe/src/builder_pipeline.jl:253
 [3] dispatch(::Type{Documenter.Builder.DocumentPipeline}, x::Documenter.Document)
   @ Documenter.Selectors ~/.julia/packages/Documenter/1HwWe/src/utilities/Selectors.jl:170
 [4] #83
   @ ~/.julia/packages/Documenter/1HwWe/src/makedocs.jl:248 [inlined]
 [5] withenv(::Documenter.var"#83#85"{Documenter.Document}, ::Pair{String, Nothing}, ::Vararg{Pair{String, Nothing}})
   @ Base ./env.jl:256
 [6] #82
   @ ~/.julia/packages/Documenter/1HwWe/src/makedocs.jl:247 [inlined]
 [7] cd(f::Documenter.var"#82#84"{Documenter.Document}, dir::String)
   @ Base.Filesystem ./file.jl:112
 [8] #makedocs#81
   @ Documenter ~/.julia/packages/Documenter/1HwWe/src/makedocs.jl:247 [inlined]
 [9] top-level scope
   @ ~/.julia/dev/PsychoJL/docs/make.jl:7

\

2

Doh! I was sloppy and didn’t put the full function definition in! It should have been:

‘’‘@docs
InitPsychoJL()
waitTime(win::Window, time::Float64)
‘’’

…instead of just waitTime()