minor formatting and changes

docs/en/designers/language-builtin-functions/language-function-capture.xml

@@ -56,7 +56,8 @@
  </informaltable>
 
 
- <caution>
+ <note>
+ <title>Caution</title>
   <para>
    Be careful when capturing <link
    linkend="language.function.insert"><varname>{insert}</varname></link>
@@ -67,10 +68,11 @@
    commands that you expect to run
    within cached content, do not capture this content.
   </para>
- </caution>
+ </note>
+
  <para>
   <example>
-   <title>{capture} with a the name attribute</title>
+   <title>{capture} with the name attribute</title>
    <programlisting>
 <![CDATA[
 {* we don't want to print a div tag unless content is displayed *}

docs/en/designers/language-builtin-functions/language-function-php.xml

@@ -12,13 +12,13 @@
 <title>Technical Note</title>
 <para>
    To access PHP variables in <varname>{php}</varname> blocks you will need to use the PHP
-   <ulink url="&url.php-manual;global">global</ulink>
+   <ulink url="&url.php-manual;global"><literal>global</literal></ulink>
    keyword.
 </para>
 </note>
 
  <example>
-  <title>Example php in {php} tags</title>
+  <title>php code within {php} tags</title>
   <programlisting>
 <![CDATA[
 {php}

docs/en/designers/language-builtin-functions/language-function-section.xml

@@ -97,7 +97,7 @@
     </para></listitem>
 
     <listitem><para>
-    Sections can be nested, and the nested
+    {section}'s can be nested, and the nested
    <varname>{section}</varname> names must be unique from each other.
    </para></listitem>
 
@@ -352,9 +352,9 @@ $smarty->assign('address',$addr);
  <example>
   <title>Nested {section}'s</title>
   <para>
-  Sections can be nested as deep as you like. With nested sections,
+  {section}'s can be nested as deep as you like. With nested {section}'s,
   you can access complex data structures, such as multi-dimensional
-  arrays. This is a php script thats assign's the arrays.
+  arrays. This is an example <filename>.php</filename> script thats assign's the arrays.
   </para>
   <programlisting role="php">
 <![CDATA[