Docs: include top-level module documentation in helpdb.jl

[kmsquire]

Top-level documentation exists for a number of modules in Base, including Sort, Profile, Collections, and Test, but that documentation does not appear in helpdb.jl (cf. #2242). It would be nice to include it.

(Hopefully this issue will be superseded by an upgraded documentation system.)

Edit: To clarify, the submodule function documentation is included, but no help is available for the modules themselves:

julia> help(Profile)
No help information found.

julia> help(Base.Profile)
No help information found.

[timholy]

Not quite:

julia> help("@profile")
Loading help data...
Base.@profile()

   "@profile <expression>" runs your expression while taking
   periodic backtraces.  These are appended to an internal buffer of
   backtraces.

julia> help(Profile.print)
Base.print(x)

   Write (to the default output stream) a canonical (un-decorated)
   text representation of a value if there is one, otherwise call
   "show".

Base.Profile.print([io::IO = STDOUT], [data::Vector]; format = :tree, C = false, combine = true, cols = tty_cols())

   Prints profiling results to "io" (by default, "STDOUT"). If you
   do not supply a "data" vector, the internal buffer of accumulated
   backtraces will be used.  "format" can be ":tree" or ":flat".
   If "C==true", backtraces from C and Fortran code are shown.
   "combine==true" merges instruction pointers that correspond to
   the same line of code.  "cols" controls the width of the display.

Base.Profile.print([io::IO = STDOUT], data::Vector, lidict::Dict; format = :tree, combine = true, cols = tty_cols())

   Prints profiling results to "io". This variant is used to examine
   results exported by a previous call to "Profile.retrieve()".
   Supply the vector "data" of backtraces and a dictionary
   "lidict" of line information.

[kmsquire]

Sorry, wasn't clear. Clarified in the text, but basically,

julia> help(Profile)
No help information found.

julia> help(Base.Profile)
No help information found.

[nolta]

What do you want help(FFTW) help(Sort) to print out? The entire manual page?

[kmsquire]

No, just what's at the top of the sort.rst file.

[nolta]

Ok. But this brings up the larger question of why are we exporting Sort in the first place? Isn't the importall .Sort sufficient?

[jakebolewski]

This doesn't seem relevant anymore.