From cea7e67db255fe127e68b0c96f05ddbe22982285 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Knut=20Olav=20B=C3=B8hmer?= Date: Fri, 29 Jul 2016 02:23:02 +0200 Subject: Update documentation for *empty-attribute-syntax* --- doc/index.html | 19 +++++++++++++++++-- 1 file changed, 17 insertions(+), 2 deletions(-) diff --git a/doc/index.html b/doc/index.html index ab5f777..279eb0a 100644 --- a/doc/index.html +++ b/doc/index.html @@ -327,10 +327,12 @@ is transformed into an (X)HTML tag of the same (usually
(:td :nowrap t) => (write-string "<td nowrap='nowrap' />" s)
- With HTML-MODE set to :SGML: + With HTML-MODE set to :SGML or :HTML5:
(:td :nowrap t) => (write-string "<td nowrap>" s)
+ Attribute minimization is controlled by *EMPTY-ATTRIBUTE-SYNTAX*
+
  • If it is NIL the attribute will be left out completely.
    (:td :nowrap nil) => (write-string "<td />" s)
    @@ -573,6 +575,19 @@ This is the prologue string which will be printed if the prologue"<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Strict//EN\" \"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd\">" +


    [Special variable] +
    *empty-attribute-syntax* + +


    + This controls the attribute minimization. (also called 'boolean attributes', or 'empty attribute syntax' according to the w3 html standard). Set value to T to enable attribute minimization. +

    In XHTML attribute minimization is forbidden, and all attributes must have a value. Thus in XHTML boolean attributes must be defined as +

     <input disabled='disabled' />
    + In HTML5 and SGML HTML boolean attributes can be defined as +
    <input disabled>
    + Gets changed when you set HTML-MODE. Its initial value is NIL +

    +
    +


    [Symbol]
    esc
    [Symbol] @@ -594,7 +609,7 @@ The function HTML-MODE returns the current mode for generating HTML

    Setting it to SGML HTML sets the *prologue* to the doctype string for HTML 4.01 transitional:

    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
    -Code generation in SGML HTML is slightly different from XHTML - there's no need to end empty elements with /> and empty attributes are allowed. +Code generation in HTML5 and SGML HTML is slightly different from XHTML - there's no need to end empty elements with /> and empty attributes are allowed.

    Setting it to HTML5 sets the *prologue* to the following doctype string:

    <!DOCTYPE html>
    -- cgit v1.2.3