Move things out of helpDB, add some xrefs

base/docs/helpdb/Base.jl

@@ -128,14 +128,6 @@ Neither `convert` nor `cconvert` should take a Julia object and turn it into a `
 """
 cconvert
 
-"""
-    assert(cond)
-
-Throw an [`AssertionError`](@ref) if `cond` is `false`.
-Also available as the macro `@assert expr`.
-"""
-assert
-
 """
     unsafe_copy!(dest::Ptr{T}, src::Ptr{T}, N)
 
@@ -430,13 +422,6 @@ Show every part of the representation of a value.
 """
 dump
 
-"""
-    isinteractive() -> Bool
-
-Determine whether Julia is running an interactive session.
-"""
-isinteractive
-
 """
     display(x)
     display(d::Display, x)
@@ -457,14 +442,6 @@ application/postscript) or `x::Vector{UInt8}` (for binary MIME types).
 """
 display
 
-"""
-    print_shortest(io, x)
-
-Print the shortest possible representation, with the minimum number of consecutive non-zero
-digits, of number `x`, ensuring that it would parse to the exact same number.
-"""
-print_shortest
-
 """
     tuple(xs...)
 
@@ -677,27 +654,6 @@ julia> copysign(-1, 2)
 """
 copysign
 
-"""
-    @show
-
-Show an expression and result, returning the result.
-"""
-:@show
-
-"""
-    showcompact(x)
-
-Show a compact representation of a value.
-
-This is used for printing array elements without repeating type information (which would
-be redundant with that printed once for the whole array), and without line breaks inside
-the representation of an element.
-
-To offer a compact representation different from its standard one, a custom type should
-test `get(io, :compact, false)` in its normal `show` method.
-"""
-showcompact
-
 """
     getfield(value, name::Symbol)
 
@@ -1194,14 +1150,6 @@ Convert a number to a maximum precision representation (typically [`BigInt`](@re
 """
 big
 
-"""
-    quit()
-
-Quit the program indicating that the processes completed successfully. This function calls
-`exit(0)` (see [`exit`](@ref)).
-"""
-quit
-
 """
     typejoin(T, S)
 
@@ -1364,14 +1312,6 @@ proceeding.
 """
 wait
 
-"""
-    atexit(f)
-
-Register a zero-argument function `f()` to be called at process exit. `atexit()` hooks are
-called in last in first out (LIFO) order and run before object finalizers.
-"""
-atexit
-
 """
     copy(x)
 
@@ -1550,13 +1490,6 @@ values such as `NaN`.
 """
 isless
 
-"""
-    showerror(io, e)
-
-Show a descriptive representation of an exception object.
-"""
-showerror
-
 """
     error(message::AbstractString)
 
@@ -1781,21 +1714,6 @@ end
 ```
 """
 get!(f::Function,collection,key)
-
-"""
-    @assert cond [text]
-
-Throw an `AssertionError` if `cond` is `false`. Preferred syntax for writing assertions.
-Message `text` is optionally displayed upon assertion failure.
-
-# Examples
-```jldoctest
-julia> @assert iseven(3) "3 is an odd number!"
-ERROR: AssertionError: 3 is an odd number!
-
-julia> @assert isodd(3) "What even are numbers?"
-```
-"""
 :@assert
 
 """

base/error.jl

@@ -78,7 +78,29 @@ systemerror(p, b::Bool; extrainfo=nothing) = b ? throw(Main.Base.SystemError(str
 
 ## assertion functions and macros ##
 
+
+"""
+    assert(cond)
+
+Throw an [`AssertionError`](@ref) if `cond` is `false`.
+Also available as the macro `@assert expr`.
+"""
 assert(x) = x ? nothing : throw(Main.Base.AssertionError())
+
+"""
+    @assert cond [text]
+
+Throw an [`AssertionError`](@ref) if `cond` is `false`. Preferred syntax for writing assertions.
+Message `text` is optionally displayed upon assertion failure.
+
+# Examples
+```jldoctest
+julia> @assert iseven(3) "3 is an odd number!"
+ERROR: AssertionError: 3 is an odd number!
+
+julia> @assert isodd(3) "What even are numbers?"
+```
+"""
 macro assert(ex, msgs...)
     msg = isempty(msgs) ? ex : msgs[1]
     if isa(msg, AbstractString)

base/grisu/grisu.jl

@@ -182,6 +182,12 @@ function _print_shortest(io::IO, x::AbstractFloat, dot::Bool, mode, n::Int)
     nothing
 end
 
+"""
+    print_shortest(io::IO, x)
+
+Print the shortest possible representation, with the minimum number of consecutive non-zero
+digits, of number `x`, ensuring that it would parse to the exact same number.
+"""
 print_shortest(io::IO, x::AbstractFloat, dot::Bool) = _print_shortest(io, x, dot, SHORTEST, 0)
 print_shortest(io::IO, x::Union{AbstractFloat,Integer}) = print_shortest(io, float(x), false)
 

base/initdefs.jl

@@ -26,11 +26,24 @@ processes completed successfully.
 """
 exit(n) = ccall(:jl_exit, Void, (Int32,), n)
 exit() = exit(0)
+
+"""
+    quit()
+
+Quit the program indicating that the processes completed successfully. This function calls
+`exit(0)` (see [`exit`](@ref)).
+"""
 quit() = exit()
 
 const roottask = current_task()
 
 is_interactive = false
+
+"""
+    isinteractive() -> Bool
+
+Determine whether Julia is running an interactive session.
+"""
 isinteractive() = (is_interactive::Bool)
 
 """
@@ -83,6 +96,12 @@ A string containing the full path to the directory containing the `julia` execut
 
 const atexit_hooks = []
 
+"""
+    atexit(f)
+
+Register a zero-argument function `f()` to be called at process exit. `atexit()` hooks are
+called in last in first out (LIFO) order and run before object finalizers.
+"""
 atexit(f::Function) = (unshift!(atexit_hooks, f); nothing)
 
 function _atexit()

base/replutil.jl

@@ -168,6 +168,11 @@ end
 
 # showing exception objects as descriptive error messages
 
+"""
+    showerror(io, e)
+
+Show a descriptive representation of an exception object.
+"""
 showerror(io::IO, ex) = show(io, ex)
 
 function showerror(io::IO, ex::BoundsError)

base/show.jl

@@ -246,6 +246,11 @@ end
 
 show_supertypes(typ::DataType) = show_supertypes(STDOUT, typ)
 
+"""
+    @show
+
+Show an expression and result, returning the result.
+"""
 macro show(exs...)
     blk = Expr(:block)
     for ex in exs
@@ -1757,6 +1762,20 @@ function showarray(io::IO, X::AbstractArray, repr::Bool = true; header = true)
     end
 end
 
+"""
+    showcompact(x)
+    showcompact(io::IO, x)
+
+Show a compact representation of a value to `io`. If `io` is not specified, the
+default is to print to [`STDOUT`](@ref).
+
+This is used for printing array elements without repeating type information (which would
+be redundant with that printed once for the whole array), and without line breaks inside
+the representation of an element.
+
+To offer a compact representation different from its standard one, a custom type should
+test `get(io, :compact, false)` in its normal [`show`](@ref) method.
+"""
 showcompact(x) = showcompact(STDOUT, x)
 function showcompact(io::IO, x)
     if get(io, :compact, false)