diff --git a/docs/designers.sgml b/docs/designers.sgml
index 64a2b9e3..8b24167b 100644
--- a/docs/designers.sgml
+++ b/docs/designers.sgml
@@ -1684,8 +1684,8 @@ cell: 760-1234&lt;br&gt;</programlisting>
 			By default, php files are only included once even if called
 			multiple times in the template. You can specify that it should be
 			included every time with the <emphasis>once</emphasis> attribute.
-			Setting once to true will include the php script each time it is
-			included.
+			Setting once to false will include the php script each time it is
+			included in the template.
 			</para>
 			<para>
 			You can optionally pass the <emphasis>assign</emphasis> attribute,
@@ -1693,6 +1693,10 @@ cell: 760-1234&lt;br&gt;</programlisting>
 			<emphasis>include_php</emphasis> will be assigned to instead of
 			displayed.
 			</para>
+			<para>
+			The smarty object is available as $this within the PHP script that you
+			include.
+			</para>
 <example>
 <title>function include_php</title>
 <programlisting>