include() not working in an at-block on 0.7/1.0

[korsbo]

Hi,

I'm having trouble updating my package since my documentation is not generated properly anymore.

I make use of your @eval syntax to auto-generate some documentation. This worked fine on 0.6, but not on 0.7 or 1.0.

julia docs/make.jl 
Documenter: setting up build directory.
Documenter: expanding markdown templates.
 !! Warning in src/tutorials/parameterizedfunctions.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:include)

 !! Warning in src/tutorials/parameterizedfunctions.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:keyword_arguments)

 !! Warning in src/tutorials/parameterizedfunctions.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:latexify)

 !! Warning in src/tutorials/DiffEqBiological.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:include)

 !! Warning in src/tutorials/DiffEqBiological.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:keyword_arguments)

 !! Warning in src/tutorials/DiffEqBiological.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:latexify)

 !! Warning in src/tutorials/DiffEqBiological.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:include)

 !! Warning in src/tutorials/DiffEqBiological.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:keyword_arguments)

 !! Warning in src/tutorials/DiffEqBiological.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:latexify)

 !! Duplicate docs found for 'latexalign'. [src/functions/latexalign.md]
 !! Warning in src/arguments.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:include)

 !! Warning in src/arguments.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:keyword_arguments)

 !! Warning in src/arguments.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:latexify)

 !! Warning in src/arguments.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:include)

 !! Warning in src/arguments.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:keyword_arguments)

 !! Warning in src/arguments.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:latexify)

 !! Warning in src/arguments.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:include)

 !! Warning in src/arguments.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:keyword_arguments)

 !! Warning in src/arguments.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:latexify)

 !! Warning in src/arguments.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:include)

 !! Warning in src/arguments.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:keyword_arguments)

 !! Warning in src/arguments.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:latexify)

 !! Warning in src/arguments.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:include)

 !! Warning in src/arguments.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:keyword_arguments)

 !! Warning in src/arguments.md:

Failed to evaluate `@eval` block.

ERROR: UndefVarError(:latexify)

 !! No docs found for 'latexify'. [src/functions/latexify.md]
Documenter: building cross-references.
 !! No doc found for reference '[`latexraw`](@ref)'. [src/functions/latexarray.md]
Documenter: running document checks.
 > checking for missing docstrings.
 !! 4 docstrings potentially missing:

    Latexify.latexraw
    Latexify.mdtable :: Tuple{}
    Latexify.get_md_function :: Tuple
    Latexify.get_latex_function :: Tuple

 !! Skipped doctesting.
 > checking footnote links.
Documenter: populating indices.
Documenter: rendering document.
 !! Invalid local link: unresolved path
    'tutorials/latexalign' in tutorials/parameterizedfunctions.md
Documenter: skipping docs deployment.
  You can set DOCUMENTER_DEBUG to "true" in Travis to see more information.

I have also tried the @example syntax and it inserts the code, but not the expected output from the code.

Thanks!

[korsbo]

I realized that I should provide a real MWE. When creating one that just defined a string, it seemed to work.

```@eval
"This was auto-generated"
```# need a comment here for markdown to be happy

An example of the ones which are not working is:

```@eval
include("src/table_generator.jl")
args = [arg for arg in keyword_arguments if :arrow in arg.env]
latexify(args, env=:mdtable, types=false)
```#

[korsbo]

The more I dig, the more I think that this is my fault. I'll reopen the issue if that does not turn out to be the case.

[korsbo]

The issue seems to come from my call to include. I'm not entirely sure, but it seems like include has changed a bit from 0.6 to 0.7 and that it now evaluates into the wrong scope.

Replacing include(filename) with Base.include(@__MODULE__, filename) did the trick for me.

[mortenpi]

Not sure what's up here, but this is definitely a regression. The includes should just work, but on 1.0 something as simple as

```@eval
include("foo.jl")
```

fails with

Failed to evaluate `@eval` block.                            
                                                                 
ERROR: UndefVarError(:include)

[fredrikekre]

I think modules created from Module(::Symbol) does not have include defined. We should just define that method, like we define an eval method for them.