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

[Andreas Boll]

Cc: Ian

2012/6/11 Andreas Boll <andreas.boll.dev at gmail.com>:
> 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.
>
> You should either use upper- or lower-case tags to be consistent.
> So I'm tending to write lower-case only
> and it's definitly less use of the shift key ;)
>
>>
>>>
>>> The next steps are:
>>> - finish html cleanup (more well-formed html)
>>>     Tools I'm using:
>>>     * http://validator.w3.org/
>>>     * http://tidy.sourceforge.net/
>>> - update docs content
>>> - drop obsolete docs
>>
>>
>> OK.
>>
>>
>>
>>>
>>> @ release manager
>>> Is there a script for converting the git shortlog into html in
>>> relnotes-*.html or are they converted by hand?
>>> The reason I'm asking is that not all html special chars are correctly
>>> escaped and the changes are not well-formed.
>>
>>
>> I'm not sure how Ian's been doing that.  If any sort of git/sh script is
>> used, it should probably be checked into the tree or documented with the
>> rest of the new-release instructions.
>>
>> Ian?
>>
>> -Brian