Ticket #9268: comments_doc.2.diff

docs/ref/contrib/comments/index.txt

@@ -175 +175 @@
 
     <form action="{% comment_form_target %}" method="POST">
 
+Specifying the redirect page after comment post
+-----------------------------------------------
+
+To specify the page you want to redirect to after the comment has been
+posted, you can include a hidden tag called ``next`` in your comment form::
+
+    <input type="hidden" name="next" value="page_to_redirect" />
+
+Redirecting after a preview or error
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you use the comment preview, or an error occurs in your comment post,
+you will be taken to the template named ``comments/preview.html``. The value you specified for ``next``
+on your post page isn't automatically carried over to the preview page.
+
+You need to again specify the redirect page with a hidden form tag::
+
+    <input type="hidden" name="next" value="{{ data.next }}" />
+
+``data`` contains all of the posted values from the original comment post
+page. ``data.next`` gives us the value of ``next``.
+
 Notes on the comment form
 -------------------------