docs: add info about itrans

---
type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes.
report:
  - task: lint_filenames
    status: passed
  - task: lint_editorconfig
    status: passed
  - task: lint_markdown
    status: na
  - task: lint_package_json
    status: na
  - task: lint_repl_help
    status: passed
  - task: lint_javascript_src
    status: passed
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: na
  - task: lint_javascript_benchmarks
    status: na
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: na
  - task: lint_c_examples
    status: na
  - task: lint_c_benchmarks
    status: na
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: passed
  - task: lint_typescript_tests
    status: na
  - task: lint_license_headers
    status: passed
---

Author: aayush0325

lib/node_modules/@stdlib/lapack/base/dgtts2/docs/repl.txt

@@ -15,7 +15,10 @@
         either 'row-major' or 'column-major'.
 
     itrans: integer
-        Specifies the form of the system of equations.
+        Specifies the form of the system of equations. To solve A * X = B
+        (no transpose) use itrans = 0, to solve A**T * X = B (transpose)
+        use itrans = 1, to solve A**T * X = B (conjugate transpose = transpose)
+        use itrans = 2.
 
     N: integer
         Order of the matrix `A`.
@@ -92,7 +95,10 @@
     Parameters
     ----------
     tr: integer
-        Specifies the form of the system of equations.
+        Specifies the form of the system of equations. To solve A * X = B
+        (no transpose) use itrans = 0, to solve A**T * X = B (transpose)
+        use itrans = 1, to solve A**T * X = B (conjugate transpose = transpose)
+        use itrans = 2.
 
     N: integer
         Order of the matrix `A`.

lib/node_modules/@stdlib/lapack/base/dgtts2/docs/types/index.d.ts

@@ -29,6 +29,12 @@ interface Routine {
 	/**
 	* Solves a system of linear equations with a tri diagonal matrix using the LU factorization.
 	*
+	* ## Notes
+	*
+	* -   To solve A * X = B (no transpose), use itrans = 0.
+	* -   To solve AT * X = B (transpose), use itrans = 1.
+	* -   To solve AT * X = B (conjugate transpose = transpose), use itrans = 2.
+	*
 	* @param order - storage layout of B
 	* @param itrans - specifies the form of the system of equations (0: no transpose, 1: transpose, 2: conjugate transpose)
 	* @param N - order of the matrix A
@@ -61,6 +67,12 @@ interface Routine {
 	/**
 	* Solves a system of linear equations with alternative indexing semantics.
 	*
+	* ## Notes
+	*
+	* -   To solve A * X = B (no transpose), use itrans = 0.
+	* -   To solve AT * X = B (transpose), use itrans = 1.
+	* -   To solve AT * X = B (conjugate transpose = transpose), use itrans = 2.
+	*
 	* @param itrans - specifies the form of the system of equations
 	* @param N - order of the matrix A
 	* @param nrhs - number of right-hand sides
@@ -105,6 +117,12 @@ interface Routine {
 /**
 * Solves a system of linear equations with a tri diagonal matrix using the LU factorization.
 *
+* ## Notes
+*
+* -   To solve A * X = B (no transpose), use itrans = 0.
+* -   To solve AT * X = B (transpose), use itrans = 1.
+* -   To solve AT * X = B (conjugate transpose = transpose), use itrans = 2.
+*
 * @param order - storage layout of B
 * @param itrans - system equation form specification
 * @param N - matrix order

lib/node_modules/@stdlib/lapack/base/dgtts2/lib/base.js

@@ -229,7 +229,13 @@ function noTranspose( N, nrhs, DL, sdl, odl, D, sd, od, DU, sdu, odu, DU2, sdu2,
 // MAIN //
 
 /**
-* Solves a system of linear equations with a tri diagonal matrix using the LU factorization.
+* Solves a system of linear equations with a tri diagonal matrix using the LU factorization computed by `dgttrf`.
+*
+* ## Notes
+*
+* -   To solve A * X = B (no transpose), use itrans = 0.
+* -   To solve AT * X = B (transpose), use itrans = 1.
+* -   To solve AT * X = B (conjugate transpose = transpose), use itrans = 2.
 *
 * @param {integer} itrans - specifies the form of the system of equations
 * @param {NonNegativeInteger} N - order of the matrix A

lib/node_modules/@stdlib/lapack/base/dgtts2/lib/dgtts2.js

@@ -30,6 +30,12 @@ var base = require( './base.js' );
 /**
 * Solves a system of linear equations with a tri diagonal matrix using the LU factorization computed by `dgttrf`.
 *
+* ## Notes
+*
+* -   To solve A * X = B (no transpose), use itrans = 0.
+* -   To solve AT * X = B (transpose), use itrans = 1.
+* -   To solve AT * X = B (conjugate transpose = transpose), use itrans = 2.
+*
 * @param {string} order - storage layout of B
 * @param {integer} itrans - specifies the form of the system of equations
 * @param {NonNegativeInteger} N - order of the matrix A

lib/node_modules/@stdlib/lapack/base/dgtts2/lib/ndarray.js

@@ -28,6 +28,12 @@ var base = require( './base.js' );
 /**
 * Solves a system of linear equations with a tri diagonal matrix using the LU factorization and alternative indexing semantics.
 *
+* ## Notes
+*
+* -   To solve A * X = B (no transpose), use itrans = 0.
+* -   To solve AT * X = B (transpose), use itrans = 1.
+* -   To solve AT * X = B (conjugate transpose = transpose), use itrans = 2.
+*
 * @param {integer} itrans - specifies the form of the system of equations
 * @param {NonNegativeInteger} N - order of the matrix A
 * @param {NonNegativeInteger} nrhs - number of right-hand sides, i.e., the number of columns of the matrix B