aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorNikodemus Siivola <nikodemus@random-state.net>2012-04-10 14:14:30 +0300
committerNikodemus Siivola <nikodemus@random-state.net>2012-04-10 14:16:26 +0300
commitda7c6eeb3f3364939154d7c547b5c50b0ce587e6 (patch)
treeea5b61fa24233b7faf06c8724a325668c9bea1a8
parent41a07deefbc6ac865d4ef028122ea0745d6f94b0 (diff)
downloadtl-who-da7c6eeb3f3364939154d7c547b5c50b0ce587e6.tar.gz
tl-who-da7c6eeb3f3364939154d7c547b5c50b0ce587e6.tar.bz2
tl-who-da7c6eeb3f3364939154d7c547b5c50b0ce587e6.zip
document *HTML-NO-INDENT-TAGS*
-rw-r--r--doc/index.html39
1 files changed, 27 insertions, 12 deletions
diff --git a/doc/index.html b/doc/index.html
index 151a2ee..50b0627 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -93,6 +93,7 @@ CL-WHO is for example used by <a href="http://clutu.com/">clutu</a> and <a href=
<li><a href="#*downcase-tokens-p*"><code>*downcase-tokens-p*</code></a>
<li><a href="#*html-empty-tag-aware-p*"><code>*html-empty-tag-aware-p*</code></a>
<li><a href="#*html-empty-tags*"><code>*html-empty-tags*</code></a>
+ <li><a href="#*html-no-indent-tags*"><code>*html-no-indent-tags*</code></a>
<li><a href="#*prologue*"><code>*prologue*</code></a>
<li><a href="#esc"><code>esc</code></a>
<li><a href="#fmt"><code>fmt</code></a>
@@ -460,21 +461,26 @@ time. <code><i>prologue</i></code> should be a string
is guaranteed to be the first thing sent to the stream from within the
body of this macro. If <code><i>prologue</i></code> is <code>T</code>
the prologue string is the value
-of <a href="#*prologue*"><code>*PROLOGUE*</code></a>. CL-WHO will
-usually try not to insert any unnecessary whitespace in order to save
-bandwidth. However, if <code><i>indent</i></code> is <em>true</em>
-line breaks will be inserted and nested tags will be indented
-properly. The value of <code><i>indent</i></code> - if it is an
-integer - will be taken as the initial indentation. If it is not an
-integer it is assumed to mean <code>0</code>. (But note that
-indentation might change the semantics of the generated HTML. This is
-for example the case for the <code>PRE</code>
-and <code>TEXTAREA</code> tags, and in certain situations additional
-whitespace might also change the layout of tables.)
+of <a href="#*prologue*"><code>*PROLOGUE*</code></a>.
+<p>
+CL-WHO will usually try not to insert any unnecessary whitespace in
+order to save bandwidth. However, if <code><i>indent</i></code>
+is <em>true</em> line breaks will be inserted and nested tags will be
+indented properly. The value of <code><i>indent</i></code> - if it is
+an integer - will be taken as the initial indentation. If it is not an
+integer it is assumed to mean <code>0</code>. Value
+of <a href="#*html-no-indent-tags*"><code>*HTML-NO-INDENT-TAGS*</code></a>
+controls which tag-contents are excempt from indentation: by default
+contents of <code>PRE</code> and <code>TEXTAREA</code> tags are not
+indented to avoid spurious layout changes. (Note: in certain
+situations additional whitespace may change the layout of tables.)
+<p>
The <code><i>results</i></code> are the values returned by
the <code><i>forms</i></code>.
<p>
-Note that the keyword arguments <code><i>prologue</i></code> and <code><i>indent</i></code> are used at macro expansion time.
+Note that the keyword arguments <code><i>prologue</i></code>
+and <code><i>indent</i></code>, and the associated variables are
+used <em>at macro expansion time</em>.
<pre>
* (with-html-output (*standard-output* nil :prologue t)
@@ -560,6 +566,15 @@ The initial value is the list
</blockquote>
<p><br>[Special variable]
+<br><a class=none name="*html-no-indent-tags*"><b>*html-no-indent-tags*</b></a>
+
+<blockquote><br>
+The list of HTML tags that should disable indentation inside them even
+when indentation is requested. The initial value is a list containing
+only <code>:pre</code> and <code>:texarea</code>.
+</blockquote>
+
+<p><br>[Special variable]
<br><a class=none name="*prologue*"><b>*prologue*</b></a>
<blockquote><br>