Index: openacs-4/packages/acs-templating/www/doc/tagref/include.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-templating/www/doc/tagref/include.html,v
diff -u -r1.5 -r1.6
--- openacs-4/packages/acs-templating/www/doc/tagref/include.html	27 Oct 2014 16:40:25 -0000	1.5
+++ openacs-4/packages/acs-templating/www/doc/tagref/include.html	7 Aug 2017 23:48:03 -0000	1.6
@@ -12,76 +12,77 @@
 
     <h3>Summary</h3>
 
-<p>The <tt>include</tt> tag is used to include a dynamic subtemplate
+<p>The <kbd>include</kbd> tag is used to include a dynamic subtemplate
 into the current template.  Subtemplates are evaluated in the same fashion
 as any other dynamic template; the developer may associate data sources and
 other properties to them.</p>
 
 
 <h3>Usage</h3>
 
-<pre>&lt;include src="subtemplate" attribute="value" ...></pre>
+<pre>&lt;include src="subtemplate" attribute="value" ...&gt;</pre>
 
 or
 
-<pre>&lt;include src="/packages/packagename/www/lib/subtemplate" attribute="value" ...></pre>
+<pre>&lt;include src="/packages/packagename/www/lib/subtemplate" attribute="value" ...&gt;</pre>
 
 <h3>Notes</h3>
     <ul>
       <li>Arguments may be passed to the subtemplate by specifying
-	  additional attributes to the <tt>include</tt> tag.  All
-	  attributes except for <tt>src</tt> are assumed to be arguments
+	  additional attributes to the <kbd>include</kbd> tag.  All
+	  attributes except for <kbd>src</kbd> are assumed to be arguments
 	  and are set as variables which the subtemplate may reference
-	  using the <tt>var</tt> tag.  To pass a dynamic variable to the
+	  using the <kbd>var</kbd> tag.  To pass a dynamic variable to the
 	  subtemplate, specify the variable name surrounded by at signs as
 	  the value:
 
-	<pre>&lt;include src="subtemplate" source_id="@source_id@" ...></pre>
+	<pre>&lt;include src="subtemplate" source_id="@source_id@" ...&gt;</pre>
 
-	Note that passing an html string to a subtemplate via <code>@var@</code>
-	will result in passing an html-escaped string. To prevent this, use
-        <code>@var;noquote@</code> when passing html to subtemplates.
+	Note that passing an html string to a subtemplate via
+	<code>@var@</code> will result in passing an html-escaped and
+	internationalized string. To prevent this, use
+	<code>@var;literal@</code> when passing html to subtemplates.
 
         Alternatively the variable can by passed by name (similar to
         call-by-reference) causing a variable alias to be created in
         the scope of the subtemplate. This variant is necessary for
         e.g. passing a Tcl array like a templating datasource. To pass
         e.g. <code>users</code> by reference, use this notation:
 
-	<pre>&lt;include src="subtemplate" &persons="users" ...></pre>
+	<pre>&lt;include src="subtemplate" &amp;persons="users" ...&gt;</pre>
 
 	This is particularly useful for passing onerow and multirow data
 	sourced.  Note that in this case, if the subtemplate modifies the
 	value this will affect the includer.  When the datasource in the
 	included page has the same name (<code>&users="users"</code>), you
-	can use the shorthand <code>&="users"</code>.
+	can use the shorthand <code>&amp;="users"</code>.
       </li>
      
       <li>
-        It is important to note that variables passed through <tt>include</tt>
+        It is important to note that variables passed through <kbd>include</kbd>
 	become available to the .tcl and .adp files being include'd, but it 
-	<b>does not</b> make them settable through <tt>ad_page_contract</tt>.
+	<strong>does not</strong> make them settable through <kbd>ad_page_contract</kbd>.
       
         <p>
 	  So if you'd like to have a template that will return a fragment of a 
 	  page that you'd like to include in other pages, make sure its .tcl 
-	  component does not call <tt>ad_page_contract</tt>. 
+	  component does not call <kbd>ad_page_contract</kbd>. 
 	</p>
 	
 	<p>
 	  If you'd like to include a full page (that is, one which calls 
-	  <tt>ad_page_contract</tt>) then instead of passing a parameter through 
-	  <tt>&lt;include&gt;</tt>, you could use 
-	  <tt><a href="http://openacs.org/api-doc/proc-view?proc=rp%5fform%5fput">rp_form_put</a></tt>
+	  <kbd>ad_page_contract</kbd>) then instead of passing a parameter through 
+	  <kbd>&lt;include&gt;</kbd>, you could use 
+	  <kbd><a href="http://openacs.org/api-doc/proc-view?proc=rp%5fform%5fput">rp_form_put</a></kbd>
 	  to add the variable to that page's form. For additional 
 	  references, see how message-chunk is used throughout the forums package.
 	</p>
       </li>
       
       <li>
-	If the <tt>src</tt> attribute begins with a slash, the path is
+	If the <kbd>src</kbd> attribute begins with a slash, the path is
 	assumed to be relative to the server root, the parent directory of
-	the tcl library.  If not, the path is assumed to be relative to the
+	the Tcl library.  If not, the path is assumed to be relative to the
 	<em>current template</em>, <em>not</em> the URL of the page
 	request.</li>