diff --git a/src/core/random-variable.h b/src/core/random-variable.h
index cf1525762..50bb3c463 100644
--- a/src/core/random-variable.h
+++ b/src/core/random-variable.h
@@ -53,12 +53,18 @@ public:
    * ExponentialVariable y(120); //as long as the seed stays the same
    * \endcode
    * \param seed
+   *
+   * Note, while the underlying RNG takes six integer values as a seed;
+   * it is sufficient to set these all to the same integer, so we provide
+   * a simpler interface here that just takes one integer.
    */ 
   static void SetSeed (uint32_t seed);
  
   /**
    * \brief Get the seed value
    * \return the seed value
+   *
+   * Note:  returns the first of the six seed values used in the underlying RNG
    */
    static uint32_t GetSeed ();