[linalg.syn,linalg.algs.blas2] Reorder presentation to show overloads with alpha first

Author: jensmaurer

source/numerics.tex

@@ -10866,31 +10866,31 @@
                                 InVec1 x, InVec2 y, InOutMat A);
 
   // \ref{linalg.algs.blas2.symherrank1}, symmetric or Hermitian rank-1 matrix update
-  template<@\exposconcept{in-vector}@ InVec, @\exposconcept{possibly-packed-inout-matrix}@ InOutMat, class Triangle>
-    void symmetric_matrix_rank_1_update(InVec x, InOutMat A, Triangle t);
-  template<class ExecutionPolicy,
-           @\exposconcept{in-vector}@ InVec, @\exposconcept{possibly-packed-inout-matrix}@ InOutMat, class Triangle>
-    void symmetric_matrix_rank_1_update(ExecutionPolicy&& exec,
-                                        InVec x, InOutMat A, Triangle t);
   template<class Scalar, @\exposconcept{in-vector}@ InVec, @\exposconcept{possibly-packed-inout-matrix}@ InOutMat, class Triangle>
     void symmetric_matrix_rank_1_update(Scalar alpha, InVec x, InOutMat A, Triangle t);
   template<class ExecutionPolicy,
            class Scalar, @\exposconcept{in-vector}@ InVec, @\exposconcept{possibly-packed-inout-matrix}@ InOutMat, class Triangle>
     void symmetric_matrix_rank_1_update(ExecutionPolicy&& exec,
                                         Scalar alpha, InVec x, InOutMat A, Triangle t);
-
   template<@\exposconcept{in-vector}@ InVec, @\exposconcept{possibly-packed-inout-matrix}@ InOutMat, class Triangle>
-    void hermitian_matrix_rank_1_update(InVec x, InOutMat A, Triangle t);
+    void symmetric_matrix_rank_1_update(InVec x, InOutMat A, Triangle t);
   template<class ExecutionPolicy,
            @\exposconcept{in-vector}@ InVec, @\exposconcept{possibly-packed-inout-matrix}@ InOutMat, class Triangle>
-    void hermitian_matrix_rank_1_update(ExecutionPolicy&& exec,
+    void symmetric_matrix_rank_1_update(ExecutionPolicy&& exec,
                                         InVec x, InOutMat A, Triangle t);
+
   template<class Scalar, @\exposconcept{in-vector}@ InVec, @\exposconcept{possibly-packed-inout-matrix}@ InOutMat, class Triangle>
     void hermitian_matrix_rank_1_update(Scalar alpha, InVec x, InOutMat A, Triangle t);
   template<class ExecutionPolicy,
            class Scalar, @\exposconcept{in-vector}@ InVec, @\exposconcept{possibly-packed-inout-matrix}@ InOutMat, class Triangle>
     void hermitian_matrix_rank_1_update(ExecutionPolicy&& exec,
                                         Scalar alpha, InVec x, InOutMat A, Triangle t);
+  template<@\exposconcept{in-vector}@ InVec, @\exposconcept{possibly-packed-inout-matrix}@ InOutMat, class Triangle>
+    void hermitian_matrix_rank_1_update(InVec x, InOutMat A, Triangle t);
+  template<class ExecutionPolicy,
+           @\exposconcept{in-vector}@ InVec, @\exposconcept{possibly-packed-inout-matrix}@ InOutMat, class Triangle>
+    void hermitian_matrix_rank_1_update(ExecutionPolicy&& exec,
+                                        InVec x, InOutMat A, Triangle t);
 
   // \ref{linalg.algs.blas2.rank2}, symmetric and Hermitian rank-2 matrix updates
 
@@ -14384,27 +14384,6 @@
 \complexity
 \bigoh{\tcode{x.extent(0)} \times \tcode{x.extent(0)}}.
 
-\begin{itemdecl}
-template<@\exposconcept{in-vector}@ InVec, @\exposconcept{possibly-packed-inout-matrix}@ InOutMat, class Triangle>
-  void symmetric_matrix_rank_1_update(InVec x, InOutMat A, Triangle t);
-template<class ExecutionPolicy,
-         @\exposconcept{in-vector}@ InVec, @\exposconcept{possibly-packed-inout-matrix}@ InOutMat, class Triangle>
-  void symmetric_matrix_rank_1_update(ExecutionPolicy&& exec, InVec x, InOutMat A, Triangle t);
-\end{itemdecl}
-
-\begin{itemdescr}
-\pnum
-These functions perform
-a symmetric rank-1 update of the symmetric matrix \tcode{A},
-taking into account the \tcode{Triangle} parameter
-that applies to \tcode{A}\iref{linalg.general}.
-
-\pnum
-\effects
-Computes a matrix $A'$ such that $A' = A + x x^T$
-and assigns each element of $A'$ to the corresponding element of $A$.
-\end{itemdescr}
-
 \begin{itemdecl}
 template<class Scalar, @\exposconcept{in-vector}@ InVec, @\exposconcept{possibly-packed-inout-matrix}@ InOutMat, class Triangle>
   void symmetric_matrix_rank_1_update(Scalar alpha, InVec x, InOutMat A, Triangle t);
@@ -14430,23 +14409,23 @@
 
 \begin{itemdecl}
 template<@\exposconcept{in-vector}@ InVec, @\exposconcept{possibly-packed-inout-matrix}@ InOutMat, class Triangle>
-  void hermitian_matrix_rank_1_update(InVec x, InOutMat A, Triangle t);
+  void symmetric_matrix_rank_1_update(InVec x, InOutMat A, Triangle t);
 template<class ExecutionPolicy,
          @\exposconcept{in-vector}@ InVec, @\exposconcept{possibly-packed-inout-matrix}@ InOutMat, class Triangle>
-  void hermitian_matrix_rank_1_update(ExecutionPolicy&& exec, InVec x, InOutMat A, Triangle t);
+  void symmetric_matrix_rank_1_update(ExecutionPolicy&& exec, InVec x, InOutMat A, Triangle t);
 \end{itemdecl}
 
 \begin{itemdescr}
 \pnum
 These functions perform
-a Hermitian rank-1 update of the Hermitian matrix \tcode{A},
+a symmetric rank-1 update of the symmetric matrix \tcode{A},
 taking into account the \tcode{Triangle} parameter
 that applies to \tcode{A}\iref{linalg.general}.
 
 \pnum
 \effects
-Computes a matrix $A'$ such that $A' = A + x x^H$ and
-assigns each element of $A'$ to the corresponding element of $A$.
+Computes a matrix $A'$ such that $A' = A + x x^T$
+and assigns each element of $A'$ to the corresponding element of $A$.
 \end{itemdescr}
 
 \begin{itemdecl}
@@ -14472,6 +14451,27 @@
 and assigns each element of $A'$ to the corresponding element of $A$.
 \end{itemdescr}
 
+\begin{itemdecl}
+template<@\exposconcept{in-vector}@ InVec, @\exposconcept{possibly-packed-inout-matrix}@ InOutMat, class Triangle>
+  void hermitian_matrix_rank_1_update(InVec x, InOutMat A, Triangle t);
+template<class ExecutionPolicy,
+         @\exposconcept{in-vector}@ InVec, @\exposconcept{possibly-packed-inout-matrix}@ InOutMat, class Triangle>
+  void hermitian_matrix_rank_1_update(ExecutionPolicy&& exec, InVec x, InOutMat A, Triangle t);
+\end{itemdecl}
+
+\begin{itemdescr}
+\pnum
+These functions perform
+a Hermitian rank-1 update of the Hermitian matrix \tcode{A},
+taking into account the \tcode{Triangle} parameter
+that applies to \tcode{A}\iref{linalg.general}.
+
+\pnum
+\effects
+Computes a matrix $A'$ such that $A' = A + x x^H$ and
+assigns each element of $A'$ to the corresponding element of $A$.
+\end{itemdescr}
+
 \rSec3[linalg.algs.blas2.rank2]{Symmetric and Hermitian rank-2 matrix updates}
 
 \pnum