Index: trunk/phase3/includes/Html.php |
— | — | @@ -89,7 +89,7 @@ |
90 | 90 | * values. If you're hardcoding all the attributes, or there are none, you |
91 | 91 | * should probably type out the string yourself. |
92 | 92 | * |
93 | | - * This is quite similar to Xml::element(), but it implements some useful |
| 93 | + * This is quite similar to Xml::tags(), but it implements some useful |
94 | 94 | * HTML-specific logic. For instance, there is no $allowShortTag |
95 | 95 | * parameter: the closing tag is magically omitted if $element has an empty |
96 | 96 | * content model. If $wgWellFormedXml is false, then a few bytes will be |
— | — | @@ -97,10 +97,6 @@ |
98 | 98 | * features might be added, like allowing arrays for the values of |
99 | 99 | * attributes like class= and media=. |
100 | 100 | * |
101 | | - * One notable difference to Xml::element() is that $contents is *not* |
102 | | - * escaped. This means that Html::element() can be usefully nested, rather |
103 | | - * than using the rather clumsy Xml::openElement() and Xml::closeElement(). |
104 | | - * |
105 | 101 | * @param $element string The element's name, e.g., 'a' |
106 | 102 | * @param $attribs array Associative array of attributes, e.g., array( |
107 | 103 | * 'href' => 'http://www.mediawiki.org/' ). Values will be HTML-escaped. |
— | — | @@ -123,7 +119,8 @@ |
124 | 120 | } |
125 | 121 | |
126 | 122 | /** |
127 | | - * Identical to rawElement(), but HTML-escapes $contents. |
| 123 | + * Identical to rawElement(), but HTML-escapes $contents (like |
| 124 | + * Xml::element()). |
128 | 125 | */ |
129 | 126 | public static function element( $element, $attribs = array(), $contents = '' ) { |
130 | 127 | return self::rawElement( $element, $attribs, strtr( $contents, array( |