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

Brian Paul brianp at vmware.com
Mon Jun 11 09:06:52 PDT 2012


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.

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.


>
> 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


More information about the mesa-dev mailing list