- newfunction(:bool2str, :type => :rvalue, :doc => <<-EOS
- Converts a boolean to a string.
+ newfunction(:bool2str, :type => :rvalue, :doc => <<-DOC
+ @summary
+ Converts a boolean to a string using optionally supplied arguments.
+
+ The optional second and third arguments represent what true and false will be
+ converted to respectively. If only one argument is given, it will be
+ converted from a boolean to a string containing 'true' or 'false'.
+
+ @return
+ The converted value to string of the given Boolean
+
+ **Examples of usage**
+
+ ```
+ bool2str(true) => 'true'
+ bool2str(true, 'yes', 'no') => 'yes'
+ bool2str(false, 't', 'f') => 'f'
+ ```
+