Update docstrings of Recur and PixelShuffle

Author: Saransh-cpp

src/layers/recurrent.jl

@@ -80,7 +80,7 @@ julia> rnn(3)
 julia> rnn.state
 5
 
-julia> rnn.(1:10)  # apply to a sequence
+julia> rnn(1:10)  # apply to a sequence
 10-element Vector{Int64}:
   1
   2
@@ -118,7 +118,12 @@ julia> rnn.state
 1×1 Matrix{Int64}:
  5
 
-julia> rnn(reshape(1:10, 1, 1, :))  # apply to a sequence of (features, batch, time)
+julia> vec = rnn(reshape(1:10, 1, 1, :));  # apply to a sequence of (features, batch, time)
+
+julia> size(vec)
+(1, 1, 10)
+
+julia> vec 
 1×1×10 Array{Int64, 3}:
 [:, :, 1] =
  1

src/layers/upsample.jl

@@ -84,10 +84,57 @@ See [`NNlib.pixel_shuffle`](@ref).
 ```jldoctest
 julia> p = PixelShuffle(2);
 
-julia> xs = rand(2, 2, 4, 1); # an image with 4 channels having 2X2 pixels in each channel
-
-julia> p(xs) |> size  # upsampled image with only 1 channel
-(4, 4, 1, 1)
+julia> xs = [2row + col + channel/10 for row in 1:2, col in 1:2, channel in 1:4, n in 1:1]
+2×2×4×1 Array{Float64, 4}:
+[:, :, 1, 1] =
+ 3.1  4.1
+ 5.1  6.1
+
+[:, :, 2, 1] =
+ 3.2  4.2
+ 5.2  6.2
+
+[:, :, 3, 1] =
+ 3.3  4.3
+ 5.3  6.3
+
+[:, :, 4, 1] =
+ 3.4  4.4
+ 5.4  6.4
+
+julia> p(xs)
+4×4×1×1 Array{Float64, 4}:
+[:, :, 1, 1] =
+ 3.1  3.3  4.1  4.3
+ 3.2  3.4  4.2  4.4
+ 5.1  5.3  6.1  6.3
+ 5.2  5.4  6.2  6.4
+
+julia> xs = [3row + col + channel/10 for row in 1:2, col in 1:3, channel in 1:4, n in 1:1]
+2×3×4×1 Array{Float64, 4}:
+[:, :, 1, 1] =
+ 4.1  5.1  6.1
+ 7.1  8.1  9.1
+
+[:, :, 2, 1] =
+ 4.2  5.2  6.2
+ 7.2  8.2  9.2
+
+[:, :, 3, 1] =
+ 4.3  5.3  6.3
+ 7.3  8.3  9.3
+
+[:, :, 4, 1] =
+ 4.4  5.4  6.4
+ 7.4  8.4  9.4
+
+julia> p(xs)
+4×6×1×1 Array{Float64, 4}:
+[:, :, 1, 1] =
+ 4.1  4.3  5.1  5.3  6.1  6.3
+ 4.2  4.4  5.2  5.4  6.2  6.4
+ 7.1  7.3  8.1  8.3  9.1  9.3
+ 7.2  7.4  8.2  8.4  9.2  9.4
 ```
 """
 struct PixelShuffle