[Mesa-dev] [PATCH 00/11] docs: html cleanup

[Andreas Boll]

2012/6/12 Kenneth Graunke <kenneth at whitecape.org>:
> On 06/11/2012 11:18 AM, Andreas Boll wrote:
>> 2012/6/11 Brian Paul <brianp at vmware.com>:
>>> On 06/10/2012 04:57 AM, Andreas Boll wrote:
>>>>
>>>> Hi,
>>>>
>>>> the following patch series is the first part of cleaning up docs/.
>>>>
>>>> Please review and commit.
>>>
>>
>> Please commit/push. I don't have commit access.
>>
>>>
>>> I'm not an HTML expert but these look ok to me.  Can you commit/push or
>>> should I?
>>>
>>>
>>> Q: are lower-case html tags recommended or the usual convention or just your
>>> personal preference?  Just wondering.
>>>
>>
>> Lower-case is recommended, because it's more future-proof wrt. XHTML
>> where lower-case tags are required.
>> I think nowadays it's the usual convention.
>
> Yeah.  XHTML (HTML on top of XML instead of SGML) requires lowercase
> tags, so basically everyone uses that these days.
>
> I'm actually kind of surprised you went with HTML 4 transitional rather
> than XHTML or HTML strict.  But it's not a big deal either way.

HTML transitional is the way to go, if you want to upgrade from legacy
HTML with minimal effort, cause the strict variant removes some
deprecated tags and attributes like 'frame' and 'target', which are
needed for the frame based layout of mesa. So for upgrading to strict
we would have to get rid of the frame based layout and fix the
validation errors introduced by strict first.

Another variant is the XHTML transitional. But before using this
variant we would have to ensure that the markup is XML valid, which
roughly means each opening tag needs a closing one. And there are a
lot of missing end tags in the docs, which are optional in HTML
(SGML).

However this can be achieved with incremental improvement of the
current markup and once these problems are solved, we can upgrade to
strict or rather to XHTML strict.