From 8aed3b17273687547a4a66a35d67eef3c5b934a5 Mon Sep 17 00:00:00 2001
From: John Bintz <john@coswellproductions.com>
Date: Thu, 19 Nov 2009 20:54:57 -0500
Subject: [PATCH] doc tweaks

---
 docs/en_US/storyline-post-template-tags.html | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/docs/en_US/storyline-post-template-tags.html b/docs/en_US/storyline-post-template-tags.html
index fa60769..eb11eff 100644
--- a/docs/en_US/storyline-post-template-tags.html
+++ b/docs/en_US/storyline-post-template-tags.html
@@ -1,5 +1,10 @@
 <h1>Storyline Post Template Tags</h1>
 
+<p>
+	<em>ComicPress Core</em> provides a number of functions that allow you to traverse the storyline structure created from your blog's categories.
+	Technical details about these template tags can be found in the <code>functions.inc</code> file within your <em>ComicPress Core</em> installation.
+</p>
+
 <h2>R() and RT()</h2>
 
 <p>
@@ -11,11 +16,11 @@
 <pre class="prettyprint lang-php">
 // use a post programmatically
 $previous_post = R('previous');
-echo get_the_permalink($previous_post->ID);
+echo get_permalink($previous_post);
 
 // use template tags with a post
 Protect(); // save the current Loop post
-RT('previous');
+$previous_post = RT('previous'); // RT() returns the post, too
 the_permalink();
 Restore(); // restore the saved Loop post
 </pre>
@@ -161,12 +166,12 @@ R('previous', null, $other_post);
 </p>
 
 <ul>
-  <li><strong>child_of</strong> =&gt; <em>category slug</em>: Search for matching posts in the provided category and its children.</li>
-  <li><strong>only</strong> =&gt; <em>category slug</em>: Search only the provided category.</li>
+  <li><strong>child_of</strong> =&gt; <em>category ID or slug</em>: Search for matching posts in the provided category and its children.</li>
+  <li><strong>only</strong> =&gt; <em>category ID or slug</em>: Search only the provided category.</li>
   <li><strong>root_of</strong> =&gt; <em>post ID or object</em>: Find the root category the post belongs to and search for posts from that category and in all children.</li>
   <li><strong>from_post</strong> =&gt; <em>post ID or object</em>: Search for matching posts in the category this post belongs to.</li>
-  <li><strong>previous</strong> =&gt; <em>category slug</em>: Search for matching posts in the category before the provided category as defined in the storyline structure.</li>
-  <li><strong>next</strong> =&gt; <em>category slug</em>: Search for matching posts in the category after the provided category as defined in the storyline structure.</li>
+  <li><strong>previous</strong> =&gt; <em>category ID or slug</em>: Search for matching posts in the category before the provided category as defined in the storyline structure.</li>
+  <li><strong>next</strong> =&gt; <em>category ID or slug</em>: Search for matching posts in the category after the provided category as defined in the storyline structure.</li>
   <li><strong>level</strong> =&gt; <em>storyline level</em>: Search for posts in the categories defined at this level in the storyline structure, with level 1 being the topmost categories, level 2 being their direct children, etc.</i>
 </ul>
 
@@ -258,4 +263,4 @@ $parent = SC('parent');
 // or you can provide a category to be relative to
 $next_from_three = SC('next', 3);
 $previous_to_chapter_four = SC('previous', 'chapter-four');
-</pre>
\ No newline at end of file
+</pre>