Add notes in the doxygen comments about setRandomNumberSeed resulting in a

"truly" random seed being generated from the wall clock upon Context creation.

openmmapi/include/openmm/AndersenThermostat.h

@@ -114,6 +114,9 @@ public:
      * the other hand, no guarantees are made about the behavior of simulations that use the same seed.
      * In particular, Platforms are permitted to use non-deterministic algorithms which produce different
      * results on successive runs, even if those runs were initialized identically.
+     *
+     * If seed is set to 0 (which is the default value assigned), a new seed is generated from the system
+     * clock when a Context is created from this Force.
      */
     void setRandomNumberSeed(int seed) {
         randomNumberSeed = seed;

openmmapi/include/openmm/BrownianIntegrator.h

@@ -99,6 +99,9 @@ public:
      * the other hand, no guarantees are made about the behavior of simulations that use the same seed.
      * In particular, Platforms are permitted to use non-deterministic algorithms which produce different
      * results on successive runs, even if those runs were initialized identically.
+     *
+     * If seed is set to 0 (which is the default value assigned), a new seed is generated from the system
+     * clock when a Context is created from this Force.
      */
     void setRandomNumberSeed(int seed) {
         randomNumberSeed = seed;

openmmapi/include/openmm/CustomIntegrator.h

@@ -444,6 +444,9 @@ public:
      * the other hand, no guarantees are made about the behavior of simulations that use the same seed.
      * In particular, Platforms are permitted to use non-deterministic algorithms which produce different
      * results on successive runs, even if those runs were initialized identically.
+     *
+     * If seed is set to 0 (which is the default value assigned), a new seed is generated from the system
+     * clock when a Context is created from this Force.
      */
     void setRandomNumberSeed(int seed) {
         randomNumberSeed = seed;

openmmapi/include/openmm/LangevinIntegrator.h

@@ -99,6 +99,9 @@ public:
      * the other hand, no guarantees are made about the behavior of simulations that use the same seed.
      * In particular, Platforms are permitted to use non-deterministic algorithms which produce different
      * results on successive runs, even if those runs were initialized identically.
+     *
+     * If seed is set to 0 (which is the default value assigned), a new seed is generated from the system
+     * clock when a Context is created from this Force.
      */
     void setRandomNumberSeed(int seed) {
         randomNumberSeed = seed;

openmmapi/include/openmm/MonteCarloAnisotropicBarostat.h

@@ -167,6 +167,9 @@ public:
      * the other hand, no guarantees are made about the behavior of simulations that use the same seed.
      * In particular, Platforms are permitted to use non-deterministic algorithms which produce different
      * results on successive runs, even if those runs were initialized identically.
+     *
+     * If seed is set to 0 (which is the default value assigned), a new seed is generated from the system
+     * clock when a Context is created from this Force.
      */
     void setRandomNumberSeed(int seed) {
         randomNumberSeed = seed;

openmmapi/include/openmm/MonteCarloBarostat.h

@@ -123,6 +123,9 @@ public:
      * the other hand, no guarantees are made about the behavior of simulations that use the same seed.
      * In particular, Platforms are permitted to use non-deterministic algorithms which produce different
      * results on successive runs, even if those runs were initialized identically.
+     *
+     * If seed is set to 0 (which is the default value assigned), a new seed is generated from the system
+     * clock when a Context is created from this Force.
      */
     void setRandomNumberSeed(int seed) {
         randomNumberSeed = seed;

openmmapi/include/openmm/MonteCarloMembraneBarostat.h

@@ -220,6 +220,9 @@ public:
      * the other hand, no guarantees are made about the behavior of simulations that use the same seed.
      * In particular, Platforms are permitted to use non-deterministic algorithms which produce different
      * results on successive runs, even if those runs were initialized identically.
+     *
+     * If seed is set to 0 (which is the default value assigned), a new seed is generated from the system
+     * clock when a Context is created from this Force.
      */
     void setRandomNumberSeed(int seed) {
         randomNumberSeed = seed;

openmmapi/include/openmm/VariableLangevinIntegrator.h

@@ -121,6 +121,9 @@ public:
      * the other hand, no guarantees are made about the behavior of simulations that use the same seed.
      * In particular, Platforms are permitted to use non-deterministic algorithms which produce different
      * results on successive runs, even if those runs were initialized identically.
+     *
+     * If seed is set to 0 (which is the default value assigned), a new seed is generated from the system
+     * clock when a Context is created from this Force.
      */
     void setRandomNumberSeed(int seed) {
         randomNumberSeed = seed;