Add note to docs, and example that takes a parameter.

Author: emlyn

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

@@ -2770,7 +2770,9 @@ def define(name, &block)
           accepts_block:  true,
           requires_block: true,
           intro_fn:       true,
-          doc:            "Allows you to group a bunch of code and give it your own name for future re-use. Functions are very useful for structuring your code. They are also the gateway into live coding as you may redefine a function whilst a thread is calling it, and the next time the thread calls your function, it will use the latest definition.",
+          doc:            "Allows you to group a bunch of code and give it your own name for future re-use. Functions are very useful for structuring your code. They are also the gateway into live coding as you may redefine a function whilst a thread is calling it, and the next time the thread calls your function, it will use the latest definition.
+
+Note, it is not recommended to start a function name with a capital letter if it takes no parameters.",
           examples:       ["
   # Define a new function called foo
   define :foo do
@@ -2785,7 +2787,16 @@ def define(name, &block)
   # For example, in a block:
   3.times do
     foo
-  end",]
+  end",
+
+  "
+  # Define a new function called play2, taking one parameter
+  define :play2 do |x|
+    play x, release: 2
+  end
+
+  # Call play2, passing in a value for the parameter
+  play2 42"]