Document all AttrTransforms.

git-svn-id: http://htmlpurifier.org/svnroot/htmlpurifier/trunk@309 48356398-32a2-884e-a903-53898d9a118a

library/HTMLPurifier/AttrTransform/BdoDir.php

@@ -11,6 +11,9 @@ HTMLPurifier_ConfigDef::define(
     'attribute in HTML, or ltr if that is not specified.'
 );
 
+/**
+ * Post-trasnform that ensures that bdo tags have the dir attribute set.
+ */
 class HTMLPurifier_AttrTransform_BdoDir extends HTMLPurifier_AttrTransform
 {
     

library/HTMLPurifier/AttrTransform/ImgRequired.php

@@ -19,6 +19,9 @@ HTMLPurifier_ConfigDef::define(
     'image is valid but there was no alt attribute present.'
 );
 
+/**
+ * Post-transform that ensures the required attrs of img (alt and src) are set
+ */
 class HTMLPurifier_AttrTransform_ImgRequired extends HTMLPurifier_AttrTransform
 {
     

library/HTMLPurifier/AttrTransform/Lang.php

@@ -2,9 +2,11 @@
 
 require_once 'HTMLPurifier/AttrTransform.php';
 
-// this transformation may be done pre or post validation, but post is
+/**
-// preferred, since invalid languages then will have been dropped.
+ * Post-transform that copies lang's value to xml:lang (and vice-versa)
-
+ * @note Theoretically speaking, this could be a pre-transform, but putting
+ *       post is more efficient.
+ */
 class HTMLPurifier_AttrTransform_Lang extends HTMLPurifier_AttrTransform
 {
     

library/HTMLPurifier/AttrTransform/TextAlign.php

@@ -2,6 +2,9 @@
 
 require_once 'HTMLPurifier/AttrTransform.php';
 
+/**
+ * Pre-transform that changes deprecated align attribute to text-align.
+ */
 class HTMLPurifier_AttrTransform_TextAlign
     extends HTMLPurifier_AttrTransform {