require docstring is stale

[KristofferC]

julia/base/loading.jl

Lines 831 to 851 in 53db863

	"""
	require(module::Symbol)
	This function is part of the implementation of `using` / `import`, if a module is not
	already defined in `Main`. It can also be called directly to force reloading a module,
	regardless of whether it has been loaded before (for example, when interactively developing
	libraries).
	Loads a source file, in the context of the `Main` module, on every active node, searching
	standard locations for files. `require` is considered a top-level operation, so it sets the
	current `include` path but does not use it to search for files (see help for `include`).
	This function is typically used to load library code, and is implicitly called by `using` to
	load packages.
	When searching for files, `require` first looks for package code in the global array
	`LOAD_PATH`. `require` is case-sensitive on all platforms, including those with
	case-insensitive filesystems like macOS and Windows.
	For more details regarding code loading, see the manual.
	"""
	function require(into::Module, mod::Symbol)

     require(module::Symbol) 

doesn't match with the function signature it documents,

It can also be called directly to force reloading a module, regardless of whether it has been loaded before (for example, when interactively developing libraries).

is AFAIU not true,

Loads a source file, in the context of the Main module, on every active node, searching standard locations for files.

specifying Main here seems incorrect

[StefanKarpinski]

Should definitely be fixed but there's fairly low urgency since this is not an exported function.

[iamed2]

It's in the docs though: https://docs.julialang.org/en/latest/base/base/#Base.require

[StefanKarpinski]

Deleting it would be the quickest path to fixing the situation 😬

[henriquebecker91]

Yet, it was not done in an year and half. I also have stumbled on this and complained in Discourse. In the end, i found the solution for my problem was to use an include_string(@__MODULE__, "import X"); invokelatest(method_that_uses_X, method_args...), so I am not sure require is really useful for an external user (not the Julia developers, I mean) in some case.