using <note>

docs/en/designers/language-builtin-functions/language-function-config-load.xml

@@ -95,12 +95,14 @@
   within a section with the added attribute
   <emphasis>section</emphasis>.
  </para>
+ <note>
   <para>
-  NOTE: <emphasis>Config file sections</emphasis> and the built-in
+   <emphasis>Config file sections</emphasis> and the built-in
    template function called <emphasis>section</emphasis> have nothing
    to do with each other, they just happen to share a common naming
    convention.
   </para>
+ </note>
  <example>
   <title>function config_load with section</title>
   <programlisting>

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

@@ -237,13 +237,15 @@ e-mail: jane@mydomain.com&lt;p&gt;</programlisting>
 		Sections also have their own variables that handle section properties.
 		These are indicated like so: {$smarty.section.sectionname.varname}
 		</para>
+		<note>
 		 <para>
-		NOTE: As of Smarty 1.5.0, the syntax for section property variables has
+		  As of Smarty 1.5.0, the syntax for section property variables has
  		  been changed from {%sectionname.varname%} to
 		  {$smarty.section.sectionname.varname}. The old syntax is still
 		  supported, but you will only see reference to the new syntax in the
 		  manual examples.
 		 </para>
+		</note>
 			<sect2 id="section.property.index">
 			<title>index</title>
 			<para>
@@ -339,12 +341,14 @@ e-mail: jane@mydomain.com&lt;p&gt;</programlisting>
 			<para>
         	iteration is used to display the current loop iteration.
 			</para>
+			<note>
 			 <para>
-			NOTE: This is not affected by the section properties start, step and
+			  This is not affected by the section properties start, step and
 			  max, unlike the index property. Iteration also starts with 1
 			  instead of 0 like index. rownum is an alias to iteration, they work
 			  identical.
 			 </para>
+			</note>
 	<example>
 	<title>section property iteration</title>
 	<programlisting>

docs/en/programmers/api-variables/variable-php-handling.xml

@@ -18,11 +18,13 @@
        <listitem><para>SMARTY_PHP_ALLOW - Smarty will execute the tags
          as PHP code.</para></listitem>
       </itemizedlist>
+      <note>
        <para>
-       NOTE: Embedding PHP code into templates is highly discouraged.
+        Embedding PHP code into templates is highly discouraged.
         Use <link linkend="language.custom.functions">custom functions</link> or
         <link linkend="language.modifiers">modifiers</link> instead.
        </para>
+      </note>
 </sect1>
 <!-- Keep this comment at the end of the file
 Local variables: