Upgrade documenter, fix doctests (#21473)

* run NEWS-update.jl

#20648 was partially reverted by #20782

* Fix doctest line numbers

* Upgrade Documenter, add linkcheck exception

bugs.kde.org fails to load from nanosoldier for some reason,
gives a CURLE_RECV_ERROR (56) Failure with receiving network data

fix alloc.c dead link in devdocs/init.md

* fix timeit_init macro in test/perf/perfutil.jl

needed to escape its arguments

Author: tkelman

NEWS.md

@@ -410,6 +410,7 @@ Deprecated or removed
 [#12563]: https://github.com/JuliaLang/julia/issues/12563
 [#16213]: https://github.com/JuliaLang/julia/issues/16213
 [#16961]: https://github.com/JuliaLang/julia/issues/16961
+[#16984]: https://github.com/JuliaLang/julia/issues/16984
 [#16986]: https://github.com/JuliaLang/julia/issues/16986
 [#17057]: https://github.com/JuliaLang/julia/issues/17057
 [#17261]: https://github.com/JuliaLang/julia/issues/17261
@@ -450,6 +451,7 @@ Deprecated or removed
 [#19469]: https://github.com/JuliaLang/julia/issues/19469
 [#19533]: https://github.com/JuliaLang/julia/issues/19533
 [#19543]: https://github.com/JuliaLang/julia/issues/19543
+[#19594]: https://github.com/JuliaLang/julia/issues/19594
 [#19598]: https://github.com/JuliaLang/julia/issues/19598
 [#19635]: https://github.com/JuliaLang/julia/issues/19635
 [#19670]: https://github.com/JuliaLang/julia/issues/19670
@@ -492,5 +494,4 @@ Deprecated or removed
 [#20530]: https://github.com/JuliaLang/julia/issues/20530
 [#20543]: https://github.com/JuliaLang/julia/issues/20543
 [#20609]: https://github.com/JuliaLang/julia/issues/20609
-[#20648]: https://github.com/JuliaLang/julia/issues/20648
 [#20889]: https://github.com/JuliaLang/julia/issues/20889

base/array.jl

@@ -853,8 +853,8 @@ julia> deleteat!([6, 5, 4, 3, 2, 1], [true, false, true, false, true, false])
 julia> deleteat!([6, 5, 4, 3, 2, 1], (2, 2))
 ERROR: ArgumentError: indices must be unique and sorted
 Stacktrace:
- [1] _deleteat!(::Array{Int64,1}, ::Tuple{Int64,Int64}) at ./array.jl:862
- [2] deleteat!(::Array{Int64,1}, ::Tuple{Int64,Int64}) at ./array.jl:849
+ [1] _deleteat!(::Array{Int64,1}, ::Tuple{Int64,Int64}) at ./array.jl:873
+ [2] deleteat!(::Array{Int64,1}, ::Tuple{Int64,Int64}) at ./array.jl:860
 ```
 """
 deleteat!(a::Vector, inds) = _deleteat!(a, inds)

base/docs/helpdb/Base.jl

@@ -1945,7 +1945,7 @@ julia> convert(Int, 3.0)
 julia> convert(Int, 3.5)
 ERROR: InexactError()
 Stacktrace:
- [1] convert(::Type{Int64}, ::Float64) at ./float.jl:675
+ [1] convert(::Type{Int64}, ::Float64) at ./float.jl:679
 ```
 
 If `T` is a `AbstractFloat` or `Rational` type,

doc/REQUIRE

@@ -1,3 +1,3 @@
-Compat 0.21.0 0.21.0+
-DocStringExtensions 0.3.2 0.3.2+
-Documenter 0.9.2 0.9.2+
+Compat 0.24.0 0.24.0+
+DocStringExtensions 0.3.3 0.3.3+
+Documenter 0.10.0 0.10.0+

doc/make.jl

@@ -120,6 +120,7 @@ makedocs(
     clean     = false,
     doctest   = "doctest" in ARGS,
     linkcheck = "linkcheck" in ARGS,
+    linkcheck_ignore = ["https://bugs.kde.org/show_bug.cgi?id=136779"], # fails to load from nanosoldier?
     strict    = true,
     checkdocs = :none,
     format    = "pdf" in ARGS ? :latex : :html,

doc/src/manual/constructors.md

@@ -301,7 +301,7 @@ Point{Int64}(1, 2)
 julia> Point{Int64}(1.0,2.5) ## explicit T ##
 ERROR: InexactError()
 Stacktrace:
- [1] convert(::Type{Int64}, ::Float64) at ./float.jl:675
+ [1] convert(::Type{Int64}, ::Float64) at ./float.jl:679
  [2] Point{Int64}(::Float64, ::Float64) at ./none:2
 
 julia> Point{Float64}(1.0, 2.5) ## explicit T ##

doc/src/manual/mathematical-operations.md

@@ -366,10 +366,10 @@ You can also find the numerical precedence for any given operator via the built-
 
 ```jldoctest
 julia> Base.operator_precedence(:+), Base.operator_precedence(:*), Base.operator_precedence(:.)
-(9,11,15)
+(9, 11, 15)
 
 julia> Base.operator_precedence(:+=), Base.operator_precedence(:(=))  # (Note the necessary parens on `:(=)`)
-(1,1)
+(1, 1)
 ```
 
 ## Numerical Conversions
@@ -405,13 +405,13 @@ julia> Int8(127.0)
 julia> Int8(3.14)
 ERROR: InexactError()
 Stacktrace:
- [1] convert(::Type{Int8}, ::Float64) at ./float.jl:654
+ [1] convert(::Type{Int8}, ::Float64) at ./float.jl:658
  [2] Int8(::Float64) at ./sysimg.jl:24
 
 julia> Int8(128.0)
 ERROR: InexactError()
 Stacktrace:
- [1] convert(::Type{Int8}, ::Float64) at ./float.jl:654
+ [1] convert(::Type{Int8}, ::Float64) at ./float.jl:658
  [2] Int8(::Float64) at ./sysimg.jl:24
 
 julia> 127 % Int8
@@ -426,8 +426,8 @@ julia> round(Int8,127.4)
 julia> round(Int8,127.6)
 ERROR: InexactError()
 Stacktrace:
- [1] trunc(::Type{Int8}, ::Float64) at ./float.jl:647
- [2] round(::Type{Int8}, ::Float64) at ./float.jl:333
+ [1] trunc(::Type{Int8}, ::Float64) at ./float.jl:651
+ [2] round(::Type{Int8}, ::Float64) at ./float.jl:337
 ```
 
 See [Conversion and Promotion](@ref conversion-and-promotion) for how to define your own conversions and promotions.

doc/src/manual/types.md

@@ -341,7 +341,7 @@ must be convertible to `Int`:
 julia> Foo((), 23.5, 1)
 ERROR: InexactError()
 Stacktrace:
- [1] convert(::Type{Int64}, ::Float64) at ./float.jl:675
+ [1] convert(::Type{Int64}, ::Float64) at ./float.jl:679
  [2] Foo(::Tuple{}, ::Float64, ::Int64) at ./none:2
 ```
 

test/perf/perfutil.jl

@@ -96,7 +96,7 @@ macro timeit_init(ex,init,name,desc,group...)
                 t[i] = e
             end
         end
-        @output_timings t $name $desc $group
+        @output_timings t $(esc(name)) $(esc(desc)) $(esc(group))
     end
 end