Add docstring for TOML stdlib module

[jam-khan]

This is a PR for the issue #52725.

Thanks!

[stevengj]

Looks good to me, thanks for contributing!

[fredrikekre]

This isn't TOML.jl though, just the Base internal TOML parser. The docstring should discourage use of Base.TOML and point to the TOML.jl standard library.

whoops wrong place

[stevengj]

Whoops, right, I didn't notice that the docstring was in the wrong place. Base.ispublic(Base, :TOML) == false, so this internal module doesn't need a docstring.

Just move this docstring to stdlib/TOML/src/TOML.jl.

(It wouldn't hurt to add a docstring to base/toml_parser.jl along the lines of what @fredrikekre suggested, too, e.g. "`Base.TOML` is an internal, undocumented TOML parser; users should call the TOML.jl standard library instead.")

[jam-khan]

Hi, Thanks for pointing it out @fredrikekre. I moved the docstring to TOML.jl and added another docstring in toml_parser.jl to discourage its use.

need to fix blank line

[stevengj]

Now that #52723 is merged, you'll need to update

julia/stdlib/TOML/test/runtests.jl

Lines 29 to 33 in f286d44

	@testset "Docstrings" begin
	undoc = Docs.undocumented_names(TOML)
	@test_broken isempty(undoc)
	@test undoc == [:TOML]
	end

to

@testset "Docstrings" begin
    @test isempty(Docs.undocumented_names(TOML))
end

[jam-khan]

Hi, I have updated the runtests.jl. Thanks!

[stevengj]

LGTM, thanks!