Mail Archives: djgpp/1998/02/01/18:13:49
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
- Raw text -