added gemc_unit namespace

Author: maureeungaro

guts/examples/string_vector_from_string.cc

@@ -8,8 +8,8 @@ using namespace std;
 
 
 /**
- * @file string_vector_from_string.cc
- * @brief Example program demonstrating tokenization via gutilities helpers.
+ * \file string_vector_from_string.cc
+ * \brief Example program demonstrating tokenization via gutilities helpers.
  *
  * This example reads a single command-line argument containing a whitespace-separated list
  * of tokens (typically provided in quotes) and prints each token on its own line.
@@ -25,7 +25,7 @@ using namespace std;
  */
 
 /**
- * @brief Program entry point.
+ * \brief Program entry point.
  *
  * Expected usage:
  * - Exactly one argument containing a whitespace-separated list of tokens.
@@ -34,9 +34,9 @@ using namespace std;
  * - If the argument count is incorrect, prints a fatal-style message and returns failure.
  * - Otherwise tokenizes the string and prints each resulting token.
  *
- * @param argc Argument count.
- * @param argv Argument vector.
- * @return \c EXIT_SUCCESS on success, \c EXIT_FAILURE on incorrect usage.
+ * \param argc Argument count.
+ * \param argv Argument vector.
+ * \return \c EXIT_SUCCESS on success, \c EXIT_FAILURE on incorrect usage.
  */
 int main(int argc, char* argv[]) {
 	if (argc != 2) {

guts/gthreads.h

@@ -10,8 +10,8 @@
 #include <thread>
 
 /**
- * @file gthreads.h
- * @brief Small compatibility wrapper providing a jthread-like type.
+ * \file gthreads.h
+ * \brief Small compatibility wrapper providing a jthread-like type.
  *
  * This header defines \c jthread_alias, which maps to:
  * - \c std::jthread when the standard library provides it (C++20 and library support), or
@@ -32,7 +32,7 @@
 
 /**
  * @typedef jthread_alias
- * @brief Alias to \c std::jthread when available.
+ * \brief Alias to \c std::jthread when available.
  *
  * When \c std::jthread exists, it provides automatic joining and cooperative cancellation
  * (via stop tokens) in the standard way.
@@ -46,7 +46,7 @@ using jthread_alias = std::jthread;
 
 /**
  * @class jthread_alias
- * @brief Fallback RAII "join-on-destruction" thread wrapper.
+ * \brief Fallback RAII "join-on-destruction" thread wrapper.
  *
  * This class is used when \c std::jthread is not available in the standard library.
  *
@@ -72,7 +72,7 @@ using jthread_alias = std::jthread;
 class jthread_alias
 {
 	/**
-	 * @brief Owned thread instance.
+	 * \brief Owned thread instance.
 	 *
 	 * Invariant: \c t_ is either default-constructed (not joinable), moved-from (not joinable),
 	 * or represents a running/finished thread that may be joinable.
@@ -81,19 +81,19 @@ class jthread_alias
 
 public:
 	/**
-	 * @brief Construct an empty (non-joinable) wrapper.
+	 * \brief Construct an empty (non-joinable) wrapper.
 	 *
 	 * After default construction, \ref jthread_alias::joinable "joinable()" returns @c false.
 	 */
 	jthread_alias() noexcept = default;
 
 	/**
-	 * @brief Start a new thread by forwarding arguments to the underlying \c std::thread.
+	 * \brief Start a new thread by forwarding arguments to the underlying \c std::thread.
 	 *
 	 * @tparam F Callable type.
 	 * @tparam Args Argument pack forwarded to @p f.
-	 * @param f Callable to run in the new thread.
-	 * @param args Arguments passed to @p f.
+	 * \param f Callable to run in the new thread.
+	 * \param args Arguments passed to @p f.
 	 *
 	 * @note This constructor is \c explicit to avoid accidental implicit thread starts.
 	 */
@@ -109,7 +109,7 @@ class jthread_alias
 	jthread_alias& operator=(const jthread_alias&) = delete;
 
 	/**
-	 * @brief Join the underlying thread on destruction if still joinable.
+	 * \brief Join the underlying thread on destruction if still joinable.
 	 *
 	 * This mirrors the "safe by default" behavior typically sought with \c std::jthread.
 	 *
@@ -118,13 +118,13 @@ class jthread_alias
 	~jthread_alias() { if (t_.joinable()) t_.join(); }
 
 	/**
-	 * @brief Check whether the underlying thread can be joined.
-	 * @return @c true if joinable, @c false otherwise.
+	 * \brief Check whether the underlying thread can be joined.
+	 * \return @c true if joinable, @c false otherwise.
 	 */
 	bool joinable() const noexcept { return t_.joinable(); }
 
 	/**
-	 * @brief Join the underlying thread.
+	 * \brief Join the underlying thread.
 	 *
 	 * Preconditions match \c std::thread::join.
 	 *
@@ -134,30 +134,30 @@ class jthread_alias
 	void join() { t_.join(); }
 
 	/**
-	 * @brief Detach the underlying thread.
+	 * \brief Detach the underlying thread.
 	 *
 	 * After detaching, the wrapper no longer represents a joinable thread, and the destructor
 	 * will not join.
 	 */
 	void detach() { t_.detach(); }
 
 	/**
-	 * @brief Get the underlying thread id.
-	 * @return The \c std::thread::id of the owned thread.
+	 * \brief Get the underlying thread id.
+	 * \return The \c std::thread::id of the owned thread.
 	 */
 	std::thread::id get_id() const noexcept { return t_.get_id(); }
 
 	/**
-	 * @brief Access the native handle of the underlying thread.
-	 * @return Native handle as returned by \c std::thread::native_handle.
+	 * \brief Access the native handle of the underlying thread.
+	 * \return Native handle as returned by \c std::thread::native_handle.
 	 *
 	 * @note This is provided for integration with low-level platform APIs when needed.
 	 */
 	auto native_handle() { return t_.native_handle(); }
 
 	/**
-	 * @brief Swap the underlying thread with another wrapper.
-	 * @param other Wrapper to swap with.
+	 * \brief Swap the underlying thread with another wrapper.
+	 * \param other Wrapper to swap with.
 	 *
 	 * After swapping, each wrapper owns the other's prior thread.
 	 */

guts/gutilities.cc

@@ -5,6 +5,10 @@
 // Numbers / strings with units / io interface to CLHEP units
 #include "CLHEP/Units/PhysicalConstants.h"
 
+// geant4
+#include "G4UImanager.hh"
+
+
 // c++
 // algorithm for 'transform'
 #include <algorithm>
@@ -172,7 +176,7 @@ string fillDigits(const string& word, const string& c, int ndigits) {
 #include <locale.h>   // strtod_l / _strtod_l
 
 /**
- * @brief Parse an entire numeric string as a double using the "C" numeric locale.
+ * \brief Parse an entire numeric string as a double using the "C" numeric locale.
  *
  * This translation-unit local helper exists to make numeric parsing robust against the
  * process locale (for example when a user's environment uses a comma decimal separator).
@@ -181,9 +185,9 @@ string fillDigits(const string& word, const string& c, int ndigits) {
  * - Parsing succeeds only if the entire input is consumed (no trailing characters).
  * - The conversion uses the "C" numeric locale, independent of the process locale.
  *
- * @param sv String view containing the numeric text.
- * @param out Parsed value on success.
- * @return @c true when the full string was successfully parsed; @c false otherwise.
+ * \param sv String view containing the numeric text.
+ * \param out Parsed value on success.
+ * \return @c true when the full string was successfully parsed; @c false otherwise.
  *
  * @note This is a private helper function. Refer to it textually as \c parse_double_clocale
  *       (no \ref to private symbols).