> Right now, we use the style as seen here : http://www.php.net/manual/en/install.windows.php and it's really not very clear that we are trying to highlight it as something that _must_ be read, since it's really important. (in theory :)). > > I propose something much lighter (not having that ugly border), and have the traditional php purple background / dotted border, like is seen in other places over the site. I think this will help to highlight the warnings, and hopefully make them more "aware" to readers. > > I would propose a diff too, but I am somewhat at a loss to work out _exactly_ where this stuff is defined (and knowing my luck, it may not even be relevant to phpdoc :)). If someone would point it out to me, i would be more than happy to prepare an example.
If you would like to have a special rendering for warning tags, you need to add a customized render part to the html-common.dsl.in file in phpdoc/dsssl. The current warning rendering code can be found in your dsssl style sheets (../phpdoc-tools/dsssl on windows :). Find the current one there, copy it to html-common.dsl, and customize it as you can :) The language it was written in is DSSSL, a LISP dialect. I was unable to understand most of it :(( Goba