evalfile is not sufficiently documented.

[Sean1708]

The current docstring for evalfile is

    evalfile(path::AbstractString, args::Vector{String}=String[])

Load the file using [`include`](@ref), evaluate all expressions,
and return the value of the last one.

but there are at least two things that are not well enough documented IMO:

1. The phrase "Load the file using include" does not (IMO) make it clear enough that things defined in the file will not be defined in the calling module, unlike when using include. Of course this is part of the entire point of evalfile, but it requires experimentation and guesswork (or reading the source) to figure that out.
2. It's not clear how to use args in the file. Again one could read the source or use guesswork and experimentation to figure out that it's set to ARGS, but that kind of defeats the point of having documentation.