diff --git a/actionpack/lib/action_view/helpers/capture_helper.rb b/actionpack/lib/action_view/helpers/capture_helper.rb
index 8a74ed04b268dd413188c90d3f62280400ede71d..80bff8a4cd309fa0ab2c42d22937c8f50fdd6ca2 100644
--- a/actionpack/lib/action_view/helpers/capture_helper.rb
+++ b/actionpack/lib/action_view/helpers/capture_helper.rb
@@ -61,7 +61,7 @@ def capture(*args, &block)
       #
       # You can also use this syntax alongside an existing call to <tt>yield</tt> in a layout.  For example:
       #
-      #   <!-- This is the layout -->
+      #   <%# This is the layout %>
       #   <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
       #   <head>
       #	    <title>My Website</title>
@@ -75,7 +75,7 @@ def capture(*args, &block)
       # And now, we'll create a view that has a content_for call that
       # creates the <tt>script</tt> identifier.
       #
-      #   <!-- This is our view -->
+      #   <%# This is our view %>
       #   Please login!
       #
       #   <% content_for :script do %>
@@ -100,7 +100,7 @@ def capture(*args, &block)
       #     <li><%= link_to 'Home', :action => 'index' %></li>
       #   <% end %>
       #
-      #   <!-- Add some other content, or use a different template: -->
+      #   <%#  Add some other content, or use a different template: %>
       # 
       #   <% content_for :navigation do %>
       #     <li><%= link_to 'Login', :action => 'login' %></li>
diff --git a/actionpack/lib/action_view/partials.rb b/actionpack/lib/action_view/partials.rb
index 8fb4c3a7276ac48d3ed9a1e89aab0dbf793bb47b..5988083091996ee1050d03cb84b8004a59a3c272 100644
--- a/actionpack/lib/action_view/partials.rb
+++ b/actionpack/lib/action_view/partials.rb
@@ -50,23 +50,23 @@ module ActionView
   # Partials can have their own layouts applied to them. These layouts are different than the ones that are specified globally
   # for the entire action, but they work in a similar fashion. Imagine a list with two types of users:
   #
-  #   <!-- app/views/users/index.html.erb -->
+  #   <%# app/views/users/index.html.erb &>
   #   Here's the administrator:
   #   <%= render :partial => "user", :layout => "administrator", :locals => { :user => administrator } %>
   #
   #   Here's the editor:
   #   <%= render :partial => "user", :layout => "editor", :locals => { :user => editor } %>
   #
-  #   <!-- app/views/users/_user.html.erb -->
+  #   <%# app/views/users/_user.html.erb &>
   #   Name: <%= user.name %>
   #
-  #   <!-- app/views/users/_administrator.html.erb -->
+  #   <%# app/views/users/_administrator.html.erb &>
   #   <div id="administrator">
   #     Budget: $<%= user.budget %>
   #     <%= yield %>
   #   </div>
   #
-  #   <!-- app/views/users/_editor.html.erb -->
+  #   <%# app/views/users/_editor.html.erb &>
   #   <div id="editor">
   #     Deadline: $<%= user.deadline %>
   #     <%= yield %>
@@ -88,7 +88,7 @@ module ActionView
   #
   # You can also apply a layout to a block within any template:
   #
-  #   <!-- app/views/users/_chief.html.erb -->
+  #   <%# app/views/users/_chief.html.erb &>
   #   <% render(:layout => "administrator", :locals => { :user => chief }) do %>
   #     Title: <%= chief.title %>
   #   <% end %>
