Add diagm example

Author: jishnub

src/dense.jl

@@ -399,6 +399,8 @@ Construct a matrix with elements of the vector as diagonal elements.
 By default, the matrix is square and its size is given by
 `length(v)`, but a non-square size `m`×`n` can be specified
 by passing `m,n` as the first arguments.
+If the diagonal of the matrix contains more elements than `v`,
+the trailing elements will be zeros.
 
 # Examples
 ```jldoctest
@@ -407,6 +409,13 @@ julia> diagm([1,2,3])
  1  0  0
  0  2  0
  0  0  3
+
+julia> diagm(4, 5, [1,2,3])
+4×5 Matrix{Int64}:
+ 1  0  0  0  0
+ 0  2  0  0  0
+ 0  0  3  0  0
+ 0  0  0  0  0
 ```
 """
 diagm(v::AbstractVector) = diagm(0 => v)