diff options
| author | Xavier Noria <fxn@hashref.com> | 2012-03-25 20:26:35 +0200 |
|---|---|---|
| committer | Xavier Noria <fxn@hashref.com> | 2012-03-25 20:26:35 +0200 |
| commit | 7cc797f1776ce8470b00b7e1dfc89f4df03749c1 (patch) | |
| tree | 6bc76ea8991a09668b5fc4a71bda7d2b6be7315b /guides/source/api_documentation_guidelines.textile | |
| parent | a4bf3045cadcbdd599383f2116c1e6d259e176ce (diff) | |
| download | rails-7cc797f1776ce8470b00b7e1dfc89f4df03749c1.tar.gz rails-7cc797f1776ce8470b00b7e1dfc89f4df03749c1.tar.bz2 rails-7cc797f1776ce8470b00b7e1dfc89f4df03749c1.zip | |
restores example depicting the use of true or false in regular font
There was an example here that mentioned reload_plugins?
but it was deleted. This commit puts another example back.
Diffstat (limited to 'guides/source/api_documentation_guidelines.textile')
| -rw-r--r-- | guides/source/api_documentation_guidelines.textile | 14 |
1 files changed, 14 insertions, 0 deletions
diff --git a/guides/source/api_documentation_guidelines.textile b/guides/source/api_documentation_guidelines.textile index 444490bf0c..c6aa1f0a2b 100644 --- a/guides/source/api_documentation_guidelines.textile +++ b/guides/source/api_documentation_guidelines.textile @@ -133,6 +133,20 @@ h4. Regular Font When "true" and "false" are English words rather than Ruby keywords use a regular font: +<ruby> +# Runs all the validations within the specified context. Returns true if no errors are found, +# false otherwise. +# +# If the argument is false (default is +nil+), the context is set to <tt>:create</tt> if +# <tt>new_record?</tt> is true, and to <tt>:update</tt> if it is not. +# +# Validations with no <tt>:on</tt> option will run no matter the context. Validations with +# some <tt>:on</tt> option will only run in the specified context. +def valid?(context = nil) + ... +end +</ruby> + h3. Description Lists In lists of options, parameters, etc. use a hyphen between the item and its description (reads better than a colon because normally options are symbols): |