Skip to content

Commit 73bdedc

Browse files
committed
Update docstring for sy/hetrf.
1 parent 385f465 commit 73bdedc

File tree

2 files changed

+14
-8
lines changed

2 files changed

+14
-8
lines changed

base/linalg/lapack.jl

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4683,13 +4683,16 @@ factorization.
46834683
sysv!(uplo::Char, A::StridedMatrix, B::StridedVecOrMat)
46844684

46854685
"""
4686-
sytrf!(uplo, A) -> (A, ipiv)
4686+
sytrf!(uplo, A) -> (A, ipiv, info)
46874687
46884688
Computes the Bunch-Kaufman factorization of a symmetric matrix `A`. If
46894689
`uplo = U`, the upper half of `A` is stored. If `uplo = L`, the lower
46904690
half is stored.
46914691
4692-
Returns `A`, overwritten by the factorization, and a pivot vector `ipiv`.
4692+
Returns `A`, overwritten by the factorization, a pivot vector `ipiv`, and
4693+
the error code `info` which is a non-negative integer. If `info` is positive
4694+
the matrix is singular and the diagonal part of the factorization is exactly
4695+
zero at position `info`.
46934696
"""
46944697
sytrf!(uplo::Char, A::StridedMatrix)
46954698

@@ -4725,13 +4728,16 @@ factorization.
47254728
hesv!(uplo::Char, A::StridedMatrix, B::StridedVecOrMat)
47264729

47274730
"""
4728-
hetrf!(uplo, A) -> (A, ipiv)
4731+
hetrf!(uplo, A) -> (A, ipiv, info)
47294732
47304733
Computes the Bunch-Kaufman factorization of a Hermitian matrix `A`. If
47314734
`uplo = U`, the upper half of `A` is stored. If `uplo = L`, the lower
47324735
half is stored.
47334736
4734-
Returns `A`, overwritten by the factorization, and a pivot vector.
4737+
Returns `A`, overwritten by the factorization, a pivot vector `ipiv`, and
4738+
the error code `info` which is a non-negative integer. If `info` is positive
4739+
the matrix is singular and the diagonal part of the factorization is exactly
4740+
zero at position `info`.
47354741
"""
47364742
hetrf!(uplo::Char, A::StridedMatrix)
47374743

doc/stdlib/linalg.rst

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2061,13 +2061,13 @@ set of functions in future releases.
20612061
20622062
Finds the solution to ``A * X = B`` for symmetric matrix ``A``\ . If ``uplo = U``\ , the upper half of ``A`` is stored. If ``uplo = L``\ , the lower half is stored. ``B`` is overwritten by the solution ``X``\ . ``A`` is overwritten by its Bunch-Kaufman factorization. ``ipiv`` contains pivoting information about the factorization.
20632063

2064-
.. function:: sytrf!(uplo, A) -> (A, ipiv)
2064+
.. function:: sytrf!(uplo, A) -> (A, ipiv, info)
20652065

20662066
.. Docstring generated from Julia source
20672067
20682068
Computes the Bunch-Kaufman factorization of a symmetric matrix ``A``\ . If ``uplo = U``\ , the upper half of ``A`` is stored. If ``uplo = L``\ , the lower half is stored.
20692069

2070-
Returns ``A``\ , overwritten by the factorization, and a pivot vector ``ipiv``\ .
2070+
Returns ``A``\ , overwritten by the factorization, a pivot vector ``ipiv``\ , and the error code ``info`` which is a non-negative integer. If ``info`` is positive the matrix is singular and the diagonal part of the factorization is exactly zero at position ``info``
20712071

20722072
.. function:: sytri!(uplo, A, ipiv)
20732073

@@ -2087,13 +2087,13 @@ set of functions in future releases.
20872087
20882088
Finds the solution to ``A * X = B`` for Hermitian matrix ``A``\ . If ``uplo = U``\ , the upper half of ``A`` is stored. If ``uplo = L``\ , the lower half is stored. ``B`` is overwritten by the solution ``X``\ . ``A`` is overwritten by its Bunch-Kaufman factorization. ``ipiv`` contains pivoting information about the factorization.
20892089

2090-
.. function:: hetrf!(uplo, A) -> (A, ipiv)
2090+
.. function:: hetrf!(uplo, A) -> (A, ipiv, info)
20912091

20922092
.. Docstring generated from Julia source
20932093
20942094
Computes the Bunch-Kaufman factorization of a Hermitian matrix ``A``\ . If ``uplo = U``\ , the upper half of ``A`` is stored. If ``uplo = L``\ , the lower half is stored.
20952095

2096-
Returns ``A``\ , overwritten by the factorization, and a pivot vector.
2096+
Returns ``A``\ , overwritten by the factorization, a pivot vector ``ipiv``\ , and the error code ``info`` which is a non-negative integer. If ``info`` is positive the matrix is singular and the diagonal part of the factorization is exactly zero at position ``info``\ .
20972097

20982098
.. function:: hetri!(uplo, A, ipiv)
20992099

0 commit comments

Comments
 (0)