Fix #17070, move docs out of HelpDB too.

base/docs/helpdb/Base.jl

@@ -8761,18 +8761,6 @@ Letter: Lowercase.
 """
 islower
 
-"""
-    read(stream::IO, nb=typemax(Int); all=true)
-
-Read at most `nb` bytes from `stream`, returning a `Vector{UInt8}` of the bytes read.
-
-If `all` is `true` (the default), this function will block repeatedly trying to read all
-requested bytes, until an error or end-of-file occurs. If `all` is `false`, at most one
-`read` call is performed, and the amount of data returned is device-dependent. Note that not
-all stream types support the `all` option.
-"""
-read
-
 """
     eig(A,[irange,][vl,][vu,][permute=true,][scale=true]) -> D, V
 

base/io.jl

@@ -342,7 +342,11 @@ function readbytes!(s::IO, b::AbstractArray{UInt8}, nb=length(b))
     return nr
 end
 
-# read up to nb bytes from s, returning a Vector{UInt8} of bytes read.
+"""
+    read(s::IO, nb=typemax(Int))
+
+Read at most `nb` bytes from `s`, returning a `Vector{UInt8}` of the bytes read.
+"""
 function read(s::IO, nb=typemax(Int))
     # Let readbytes! grow the array progressively by default
     # instead of taking of risk of over-allocating

base/iostream.jl

@@ -246,6 +246,16 @@ function read(s::IOStream)
     resize!(b, nr)
 end
 
+"""
+    read(s::IOStream, nb::Integer; all=true)
+
+Read at most `nb` bytes from `s`, returning a `Vector{UInt8}` of the bytes read.
+
+If `all` is `true` (the default), this function will block repeatedly trying to read all
+requested bytes, until an error or end-of-file occurs. If `all` is `false`, at most one
+`read` call is performed, and the amount of data returned is device-dependent. Note that not
+all stream types support the `all` option.
+"""
 function read(s::IOStream, nb::Integer; all::Bool=true)
     b = Array{UInt8}(nb)
     nr = readbytes!(s, b, nb, all=all)

doc/stdlib/io-network.rst

@@ -168,11 +168,17 @@ General I/O
 
    See ``read`` for a description of the ``all`` option.
 
-.. function:: read(stream::IO, nb=typemax(Int); all=true)
+.. function:: read(s::IO, nb=typemax(Int))
 
    .. Docstring generated from Julia source
 
-   Read at most ``nb`` bytes from ``stream``\ , returning a ``Vector{UInt8}`` of the bytes read.
+   Read at most ``nb`` bytes from ``s``\ , returning a ``Vector{UInt8}`` of the bytes read.
+
+.. function:: read(s::IOStream, nb::Integer; all=true)
+
+   .. Docstring generated from Julia source
+
+   Read at most ``nb`` bytes from ``s``\ , returning a ``Vector{UInt8}`` of the bytes read.
 
    If ``all`` is ``true`` (the default), this function will block repeatedly trying to read all requested bytes, until an error or end-of-file occurs. If ``all`` is ``false``\ , at most one ``read`` call is performed, and the amount of data returned is device-dependent. Note that not all stream types support the ``all`` option.