Merge pull request #2694 from ethancrawford/fix_doc_examples

Fix doc examples

Author: samaaron

app/server/ruby/lib/sonicpi/lang/core.rb

@@ -3132,14 +3132,16 @@ def rand_look(*args)
 
 Does not consume a random value from the stream. Therefore, multiple sequential calls to `rand_look` will all return the same value.",
           examples:       ["
-  print rand_look(0.5) #=> will print a number like 0.375030517578125 to the output pane",
+print rand_look(0.5) # will print a number like 0.375030517578125 to the output pane",
 
         "
-  print rand_look(0.5) #=> will print a number like 0.375030517578125 to the output pane
-  print rand_look(0.5) #=> will print the same number again
-  print rand_look(0.5) #=> will print the same number again
-  print rand(0.5) #=> will print a different random number
-  print rand_look(0.5) #=> will print the same number as the previous line again."
+print rand_look(0.5) # will print a number like 0.375030517578125 to the output pane
+print rand_look(0.5) # will print the same number again
+print rand_look(0.5) # will print the same number again
+print rand(0.5) # will still print the same number again
+                # (this is the number rand_look was 'looking ahead' at)
+                # the number is now consumed
+print rand_look(0.5) # will print a new number like 0.3669586181640625 to the output pane"
       ]
 
 
@@ -3160,14 +3162,16 @@ def rand_i_look(*args)
 
 Does not consume a random value from the stream. Therefore, multiple sequential calls to `rand_i_look` will all return the same value.",
           examples:       ["
-print rand_i_look(5) #=> will print either 0, 1, 2, 3, or 4 to the output pane",
+print rand_i_look(5) # will print either 0, 1, 2, 3, or 4 to the output pane",
 
         "
-print rand_i_look(5) #=> will print either 0, 1, 2, 3, or 4 to the output pane
-print rand_i_look(5) #=> will print the same number again
-print rand_i_look(5) #=> will print the same number again
-print rand_i(5) #=> will print either 0, 1, 2, 3, or 4 to the output pane
-print rand_i_look(5) #=> will print the same number as the previous statement"
+print rand_i_look(5) # will print either 0, 1, 2, 3, or 4 to the output pane
+print rand_i_look(5) # will print the same number again
+print rand_i_look(5) # will print the same number again
+print rand_i(5) # will still print the same number again
+                # (this is the number rand_i_look was 'looking ahead' at)
+                # the number is now consumed
+print rand_i_look(5) # will print either 0, 1, 2, 3, or 4 to the output pane"
       ]
 
 
@@ -3315,9 +3319,9 @@ def use_random_seed(seed, &block)
   ## Basic usage
 
   use_random_seed 1 # reset random seed to 1
-  puts rand # => 0.417022004702574
+  puts rand # => 0.733917236328125
   use_random_seed 1 # reset random seed back to 1
-  puts rand  #=> 0.417022004702574
+  puts rand  #=> 0.733917236328125
   ",
   "
   ## Generating melodies
@@ -3372,15 +3376,15 @@ def with_random_seed(seed, &block)
           requires_block: true,
           examples:      ["
   use_random_seed 1 # reset random seed to 1
-  puts rand # => 0.417022004702574
-  puts rand  #=> 0.7203244934421581
+  puts rand # => 0.733917236328125
+  puts rand  #=> 0.464202880859375
   use_random_seed 1 # reset it back to 1
-  puts rand # => 0.417022004702574
+  puts rand # => 0.733917236328125
   with_random_seed 1 do # reset seed back to 1 just for this block
-    puts rand # => 0.417022004702574
-    puts rand #=> 0.7203244934421581
+    puts rand # => 0.733917236328125
+    puts rand #=> 0.464202880859375
   end
-  puts rand # => 0.7203244934421581
+  puts rand # => 0.464202880859375
             # notice how the original generator is restored",
   "
   ## Generating melodies