Merge pull request #17801 from JuliaLang/brj/bc-news

Add user-extensible bounds checks to NEWS.

NEWS.md

@@ -43,6 +43,10 @@ New language features
     operator names like `Base.≤` should now use `Base.:≤` (prefixed by `@compat`
     if you need 0.4 compatibility via the `Compat` package).
 
+  * User-extensible bounds check elimination is now possible with the new
+    `@boundscheck` macro ([#14474]). This macro marks bounds checking code blocks,
+    which the compiler may remove when encountered inside an `@inbounds` call.
+
 Experimental language features
 ------------------------------
 
@@ -401,7 +405,7 @@ Deprecated or removed
     provides a `@functorize` macro.
 
   * `bitunpack(B)` and `bitpack(A)` have been deprecated in favor of
-    Array(B)` and `BitArray(A)`, respectively ([#16010]).
+    `Array(B)` and `BitArray(A)`, respectively ([#16010]).
 
   * `xdump` is removed, and `dump` now simply shows the full representation of a value.
     `dump` should not be overloaded, since it is for examining concrete structure ([#4163]).
@@ -521,6 +525,7 @@ Language tooling improvements
 [#14424]: https://github.com/JuliaLang/julia/issues/14424
 [#14458]: https://github.com/JuliaLang/julia/issues/14458
 [#14469]: https://github.com/JuliaLang/julia/issues/14469
+[#14474]: https://github.com/JuliaLang/julia/issues/14474
 [#14519]: https://github.com/JuliaLang/julia/issues/14519
 [#14608]: https://github.com/JuliaLang/julia/issues/14608
 [#14623]: https://github.com/JuliaLang/julia/issues/14623

base/promotion.jl

@@ -218,7 +218,7 @@ min(x::Real, y::Real) = min(promote(x,y)...)
 minmax(x::Real, y::Real) = minmax(promote(x, y)...)
 
 # "Promotion" that takes a function into account. These are meant to be
-# used mainly by broadcast methods, so it is adviced against overriding them
+# used mainly by broadcast methods, so it is advised against overriding them
 if isdefined(Core, :Inference)
     function _promote_op(op, T::Type)
         G = Tuple{Generator{Tuple{T},typeof(op)}}

doc/devdocs/julia.rst

@@ -22,7 +22,6 @@
    sysimg
    llvm
    stdio
-   promote-op
    boundscheck
    locks
    offset-arrays

doc/manual/conversion-and-promotion.rst

@@ -274,8 +274,8 @@ the catch-all method definitions given in
     *(x::Number, y::Number) = *(promote(x,y)...)
     /(x::Number, y::Number) = /(promote(x,y)...)
 
-In certain cases, the result type also depends on the operator; how to
-handle such scenarios is described :ref:`elsewhere <devdocs-promote-op>`.
+In certain cases, the result type also depends on the operator;
+such scenarios are handled by the ``promote_op`` function.
 
 These method definitions say that in the absence of more specific rules
 for adding, subtracting, multiplying and dividing pairs of numeric