Documenter.jl: Running external commands asynchronously in `@example` blocks

General Usage
1

Hello, I am trying to run the following @example block in a Documenter page:

pinocchio = PipeBuffer()
listener = run(`go-sendxmpp -n -p plopiplop -u pinocchio@localhost -l`, devnull, pinocchio, stderr, wait = false)

But the Documenter process hangs when generating the example (the last Documenter Debug output is this block). Everything runs smoothly when I just execute the code manually. Are there any limitations on running external programs asynchronously in Documenter?

Thanks!

2

Well, I found the solution! Although it is not entirely clear to me why, using a pipeline instead of directly setting the IO through run does the trick:

pinocchio = PipeBuffer()
listener = run(
    pipeline(
        `go-sendxmpp -n -p plopiplop -u pinocchio@localhost -l`,
        stdin = devnull, stdout = pinocchio, stderr = devnull
    ), wait = false
)