From: Myknees AT aol DOT com
Message-ID: <a6b1ce1c.34d4c07b@aol.com>
Date: Sun, 1 Feb 1998 13:35:37 EST
To: eldredge AT ap DOT net
Cc: djgpp AT delorie DOT com
Mime-Version: 1.0
Subject: Re: Documentation [was Re: Random implementation]
Content-type: text/plain; charset=US-ASCII
Content-transfer-encoding: 7bit
Precedence: bulk

In a message dated 98-01-31 01:40:25 EST, eldredge AT ap DOT net writes:
>  At 11:22  1/29/1998 EST, Myknees AT aol DOT com wrote:
>  >In a message dated 98-01-29 22:26:14 EST, DJ Delorie writes:
>  >>  Note that anyone who feels that the documentation should have more
>  >>  information in it - of any type - is welcome to mail diffs to the
>  >>  mailing list.  It's the DJGPP way - if you see something that needs
>  >>  fixing, fix it!
[snip]
>  The `-c' switch to `diff' is usually encouraged, since it creates a
`context
>  diff'. This will let the diff work even if the file it is applied to
differs
>  somewhat from your original. Also, since the library docs are written in
>  Texinfo, so should any additions. Looking at other docs sources is a big
>  help here. In this case, `srand' should be written inside an `@code{   }'
>  directive, and I believe by convention parenthesis are not used when
>  mentioning functions by name.

After finding the .txh files in the djlsr201.zip file, I read some texinfo
sources to get an idea of how they work.  Still, I wasn't able to test the
changes that I made to rand.txh, since when I used makeinfo.exe, the resulting
file had no top node.  Since the changes seem simple enough, here they are.

Everything below the line of equals signs is output from diff -c.
=================================
*** rand.txh	Mon Jul 10 01:39:56 1995
--- rand2.txh	Sun Feb  1 13:03:22 1998
***************
*** 11,19 ****
  
  Returns a pseudo-random number from zero to @code{RAND_MAX}. 
  
  @subheading Return Value
  
! The number.
  
  @subheading Example
  
--- 11,23 ----
  
  Returns a pseudo-random number from zero to @code{RAND_MAX}. 
  
+ This function must be seeded before first calling it, e.g. by using
+ the function @code{srand}.  (The function @code{srand} is defined in the
source
+ file for @code{rand}.)
+ 
  @subheading Return Value
  
! The pseudo-random number.
  
  @subheading Example