whrandom documentation (was Re: Unsorting(randomizing) a sequence)

[Jeremy Hylton]

>>>>> "BW" == Barry A Warsaw <bwarsaw at cnri.reston.va.us> writes:

>>>>> "JH" == Jeremy Hylton <jeremy at cnri.reston.va.us> writes:

  JH> The intended use of the standard library here is for users to
  JH> import random to get access to whrandom.  whrandom implements a
  JH> specific method for generating random numbers.  It could easily
  JH> be replaced with a different, improved module at some time in
  JH> the future.  If user code imports random, it will automatically
  JH> get the benefit of the new implementation.

  BW> In that case, shouldn't the documentation for the whrandom
  BW> module recommend this usage?

  BW>     http://www.python.org/doc/current/lib/module-whrandom.html

Yes.  I module think it makes more sense to put documentation for
methods like random.random in the random module's documentation.  Then 
whrandom could just explain how it is implemented and point people to
the random module docs.

Jeremy