Update documentation for render :file. References #2858.

git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@3015 5ecf4fe2-1ee6-0310-87b1-e25e094e27de
This commit is contained in:
Jeremy Kemper
2005-11-14 00:12:46 +00:00
parent da2d4d6d57
commit 5cd2f32697
2 changed files with 14 additions and 8 deletions

View File

@@ -1,5 +1,7 @@
*SVN*
* Update documentation for render :file. #2858 [Tom Werner]
* Only include builtin filters whose filenames match /^[a-z][a-z_]*_helper.rb$/ to avoid including operating system metadata such as ._foo_helper.rb. #2855 [court3nay@gmail.com]
* Added FormHelper#form_for and FormHelper#fields_for that makes it easier to work with forms for single objects also if they don't reside in instance variables [DHH]. Examples:

View File

@@ -460,8 +460,7 @@ module ActionController #:nodoc:
end
protected
# Renders the content that'll be returned to the browser as the response body. This can just be as regular text, but is
# more often the compilation of a template.
# Renders the content that will be returned to the browser as the response body.
#
# === Rendering an action
#
@@ -521,14 +520,19 @@ module ActionController #:nodoc:
#
# === Rendering a file
#
# File rendering works just like action rendering except that it takes an absolute path.
# The current layout is not applied automatically.
# File rendering works just like action rendering except that it takes a filesystem path. By default, the path
# is assumed to be absolute, and the current layout is not applied.
#
# # Renders the template located in /path/to/some/template.r(html|xml)
# render :file => "/path/to/some/template"
# # Renders the template located at the absolute filesystem path
# render :file => "/path/to/some/template.rhtml"
# render :file => "c:/path/to/some/template.rhtml"
#
# # Renders the same template within the current layout, but with a 404 status code
# render :file => "/path/to/some/template", :layout => true, :status => 404
# # Renders a template within the current layout, and with a 404 status code
# render :file => "/path/to/some/template.rhtml", :layout => true, :status => 404
# render :file => "c:/path/to/some/template.rhtml", :layout => true, :status => 404
#
# # Renders a template relative to the template root and chooses the proper file extension
# render :file => "some/template", :use_full_path => true
#
# _Deprecation_ _notice_: This used to have the signature <tt>render_file(path, status = 200)</tt>
#