diff --git a/docs/proposal-config.txt b/docs/proposal-config.txt index 93314122..95b8a6d3 100644 --- a/docs/proposal-config.txt +++ b/docs/proposal-config.txt @@ -1,5 +1,6 @@ Configuration + [needs updating] Configuration is documented on a per-use case: if a class uses a certain value from the configuration object, it has to define its name and what the diff --git a/docs/proposal-filter-levels.txt b/docs/proposal-filter-levels.txt index a8306152..ce6c7853 100644 --- a/docs/proposal-filter-levels.txt +++ b/docs/proposal-filter-levels.txt @@ -114,6 +114,10 @@ Partially presentational - table.cellpadding, table.cellspacing, == CSS Risk Analysis == +Currently, there is no support for fine-grained "allowed CSS" specification, +mainly because I'm lazy, partially because no one has asked for it. However, +this will be added eventually. + There are certain CSS elements that are extremely useful inline, but then as you get to more presentation oriented styling it may not always be appropriate to inline them. diff --git a/docs/ref-loose-vs-strict.txt b/docs/ref-loose-vs-strict.txt index 7828aa63..4f47ea7d 100644 --- a/docs/ref-loose-vs-strict.txt +++ b/docs/ref-loose-vs-strict.txt @@ -1,37 +1,18 @@ Loose versus Strict - Changes from one doctype to another + [rename/deprecation pending] -There are changes. Wow, how insightful. Not everything changed is relevant -to HTML Purifier, though, so let's take a look: +The most common change between doctypes are between the two flavors of HTML 4.01 and +XHTML 1.0: Transitional (Loose) and Strict. Besides deprecated attributes and elements +(which are quite easy to identify), there are two content model changes that were +made: -== Major incompatibilities == - -[done] BLOCKQUOTE changes from 'flow' to 'block' +BLOCKQUOTE changes from 'flow' to 'block' current behavior: inline inner contents should not be nuked, block-ify as necessary -[partially-done] U, S, STRIKE cut - current behavior: removed completely - projected behavior: replace with appropriate inline span + CSS -[done] ADDRESS from potpourri to Inline (removes p tags) +ADDRESS from potpourri to Inline (removes p tags) current behavior: block tags silently dropped - ideal behavior: replace tags with something like
. (not high priority) + ideal behavior: replace block elements with something like
. (not high priority, + somewhat difficult to implement) -== Things we can loosen up == - -Tags DIR, MENU, CENTER, ISINDEX, FONT, BASEFONT? allowed in loose - current behavior: transform to strict-valid forms -Attributes allowed in loose (see attribute transforms in 'dev-progress.html') - current behavior: projected to transform into strict-valid forms - -== Periphery issues == - -A tag's attribute 'target' (for selecting frames) cut - current behavior: not allowed at all - projected behavior: use loose doctype if needed, needs valid values -[done] OL/LI tag's attribute 'start'/'value' (for renumbering lists) cut - current behavior: no substitute, just delete when in strict, allow in loose -Attribute 'name' deprecated in favor of 'id' - current behavior: dropped silently - projected behavior: create proper AttrTransform -[done] PRE tag allows SUB/SUP? (strict dtd comment vs syntax, loose disallows) - current behavior: disallow as usual +We're missing strict support for U, S, STRIKE: this needs to be fixed soon (and +is quite simple to fix). diff --git a/docs/ref-proprietary-tags.txt b/docs/ref-proprietary-tags.txt index cf0b60fc..4daba763 100644 --- a/docs/ref-proprietary-tags.txt +++ b/docs/ref-proprietary-tags.txt @@ -18,5 +18,7 @@ HTML Purifier context. , monospace pre-variant (extremely rare) , escapes all tags to the end of document -<ruby> and friends, (more research needed, appears to be XHTML 1.1 markup) <xmp>, monospace, replace with pre + +These should be put into their own Tidy module, not loaded by default(?). These +all qualify as "lenient" transforms. \ No newline at end of file diff --git a/docs/ref-strictness.txt b/docs/ref-strictness.txt index 81907c1e..0167ed86 100644 --- a/docs/ref-strictness.txt +++ b/docs/ref-strictness.txt @@ -1,6 +1,6 @@ Is HTML Purifier Strict or Transitional? - A little bit of helpful guidance + [rename/deprecation pending] Despite the fact that HTML Purifier professes to support both transitional and strict HTML, it rejects a lot of attributes and elements that are actually, indeed, @@ -21,17 +21,13 @@ allows them anyway and 2. older browsers support them better? After all, the whole point about CSS is to seperate styling from content, so inline styling doesn't solve that problem. -It's an icky question, and we'll have to deal with it as more and more -transforms get implemented. As of right now, however, we currently support -these loose-only constructs in loose mode: +[new material] -- <ul start="1">, <li value="1"> attributes -- <u>, <strike>, <s> tags -- flow children in <blockquote> -- mixed children in <address> - -The changed child definitions as well as the ul.start li.value are the most -compelling reasons why loose should be used. We may want offer disabling <u>, -<strike> and <s> by themselves. We may also want to offer no pre-emptive -deprecated conversions. This all must be unified. +HTML Purifier 1.7 creates a new organizational system for deprecated attribute/ +element transformations. They will be unified under the title of "Tidy", which +is what they are: cleaning up after deprecated user markup into standards-compliant +versions. There will also be a change in the default behavior (athough, to the +end user not inspecting the HTML, there will be no change: in fact, it may +work even better). +Consult the Advanced API for more details. \ No newline at end of file diff --git a/docs/ref-whatwg.txt b/docs/ref-whatwg.txt index 78cef953..d89344db 100644 --- a/docs/ref-whatwg.txt +++ b/docs/ref-whatwg.txt @@ -6,4 +6,4 @@ I don't think we need to worry about them. Untrusted users shouldn't be submitting applications, eh? But if some interesting attribute pops up in their spec, and might be worth supporting, stick it here. -(none so far, as you can see) +HTML 5!!! diff --git a/docs/ref-xhtml-1.1.txt b/docs/ref-xhtml-1.1.txt index b32db5a8..bba3c7be 100644 --- a/docs/ref-xhtml-1.1.txt +++ b/docs/ref-xhtml-1.1.txt @@ -1,5 +1,6 @@ XHTML 1.1 and HTML Purifier + [needs updating, most of this is implemented] Todo for XHTML 1.1 support <http://www.w3.org/TR/xhtml11/changes.html> 1. Scratch lang entirely in favor of xml:lang