Add subdirectories

darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz

1 files changed, 25 insertions, 0 deletions

diff --git a/doc_src/random.txt b/doc_src/random.txt
new file mode 100644
index 00000000..5b0713c3
--- /dev/null
+++ b/doc_src/random.txt
@@ -0,0 +1,25 @@
+
+\section random random - Generate random number
+
+\subsection random-synopsis Synopsis
+ <tt>random [SEED]</tt>
+
+\subsection random-description Description
+
+The \c random command is used to generate a random number in the
+interval 0<=N<32767. If an argument is given, it is used to seed the
+random number generator. This can be useful for debugging purposes,
+where it can be desirable to get the same random number sequence
+multiple times. If the random number generator is called without first
+seeding it, the current time will be used as the seed.
+
+\subsection random-example Example
+
+The following code will count down from a random number to 1:
+
+<pre>
+for i in (seq (random) -1 1)
+	echo $i
+	sleep
+end
+</pre>