Add token documentation for transpose.

Author: Sacha0

base/linalg/adjtrans.jl

@@ -54,6 +54,31 @@ Transpose(A::Transpose) = A.parent
 
 # wrapping lowercase quasi-constructors
 adjoint(A::AbstractVecOrMat) = Adjoint(A)
+"""
+    transpose(A::AbstractMatrix)
+
+Lazy matrix transpose. Mutating the returned object should appropriately mutate `A`. Often,
+but not always, yields `Transpose(A)`, where `Transpose` is a lazy transpose wrapper. Note
+that this operation is recursive.
+
+This operation is intended for linear algebra usage - for general data manipulation see
+[`permutedims`](@ref), which is non-recursive.
+
+# Examples
+```jldoctest
+julia> A = [1 2 3; 4 5 6; 7 8 9]
+3×3 Array{Int64,2}:
+ 1  2  3
+ 4  5  6
+ 7  8  9
+
+julia> transpose(A)
+3×3 Transpose{Int64,Array{Int64,2}}:
+ 1  4  7
+ 2  5  8
+ 3  6  9
+```
+"""
 transpose(A::AbstractVecOrMat) = Transpose(A)
 # unwrapping lowercase quasi-constructors
 adjoint(A::Adjoint) = A.parent