[WP] (libstfinv): output reasonable instructions for ID string

src/libs/libstfinv/stfinvfdleastsquares.cc

@@ -92,7 +92,7 @@ namespace stfinv {
   {
     os << stfinvfdleastsquares_summary_usage << std::endl;
     os << std::endl;
-    stfinv::tools::report_engine<STFEngineFDLeastSquares>(os);
+    stfinv::tools::report_engine_ID<STFEngineFDLeastSquares>(os);
   } // void STFEngineFDLeastSquares::classhelp(std::ostream& os)
 
   /*----------------------------------------------------------------------*/
@@ -101,9 +101,9 @@ namespace stfinv {
   {
     os << stfinvfdleastsquares_description_usage << std::endl;
     os << std::endl;
-    Tbase::classusage(os);
+    stfinv::tools::report_engine_ID<STFEngineFDLeastSquares>(os);
     os << std::endl;
-    stfinv::tools::report_engine<STFEngineFDLeastSquares>(os);
+    Tbase::classusage(os);
   } // void STFEngineFDLeastSquares::classusage(std::ostream& os)
 
   /*----------------------------------------------------------------------*/

src/libs/libstfinv/stfinvidentity.cc

@@ -128,7 +128,7 @@ namespace stfinv {
   {
     os << stfinvidentity_summary_usage << std::endl;
     os << std::endl;
-    stfinv::tools::report_engine<STFEngineIdentity>(os);
+    stfinv::tools::report_engine_ID<STFEngineIdentity>(os);
   } // void STFEngineIdentity::classhelp(std::ostream& os)
 
   /*----------------------------------------------------------------------*/
@@ -137,9 +137,9 @@ namespace stfinv {
   {
     os << stfinvidentity_description_usage << std::endl;
     os << std::endl;
-    Tbase::classusage(os);
+    stfinv::tools::report_engine_ID<STFEngineIdentity>(os);
     os << std::endl;
-    stfinv::tools::report_engine<STFEngineIdentity>(os);
+    Tbase::classusage(os);
   } // void STFEngineIdentity::classusage(std::ostream& os)
 
 } // namespace stfinv

src/libs/libstfinv/tools.h

@@ -74,6 +74,20 @@ namespace stfinv {
         os.width(0);
         os << " (" << C::description << ")" << std::endl;
       } // void report_engine(std::ostream& os)
+
+/* ---------------------------------------------------------------------- */
+
+    /*! \brief report engine identifier with heading
+     * \ingroup tools
+     * \param C class to report ID and oneline description
+     * \param os output stream to send output to
+     */
+    template<class C>
+      void report_engine_ID(std::ostream& os)
+      {
+        os << "Identifier to selected this procedure:" << std::endl;
+        report_engine<C>(os);
+      } // void report_engine_ID(std::ostream& os)
     
   } // namespace tools