<html>
<head>
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
</head>
<body bgcolor="#FFFFFF" text="#000000">
<br>
<br>
<div class="moz-cite-prefix">On 05/03/2017 04:39 PM, Martin Buchholz
wrote:<br>
</div>
<blockquote
cite="mid:CA+kOe0-8MboCGc2oi_KjBLzJj_eeWn_9XK8eU=2QZdSYKB9g3g@mail.gmail.com"
type="cite">
<div dir="ltr">Thanks, Jon.
<div><br>
</div>
<div>For the Deque/Queue tables</div>
<div>
<pre style="color:rgb(0,0,0);word-wrap:break-word;white-space:pre-wrap">- * <table BORDER CELLPADDING=3 CELLSPACING=1>
+ * <table class="plain">
</pre>
<div>I expected that we would modify these to</div>
<div><table border=1></div>
<div>which rendered alright and is compliant (although
"border" is a weird boolean) and makes the "border intent"
clear to humans and to browsers.</div>
<div class="gmail_extra"><br>
</div>
<div class="gmail_extra">THIS IS JAVA, so I'd prefer more
verbose meaningful names for these style classes ... hmmm
... class="contrasting_rows" ? To me, "plain" is suggestive
of no borders at all.</div>
<div class="gmail_extra"><br>
</div>
<div class="gmail_extra">Can we have some guidance comments
in <span style="color:rgb(0,0,0);white-space:pre-wrap">stylesheet.css
explaining when to use the different classes?</span></div>
<div class="gmail_extra"><br>
</div>
</div>
</div>
</blockquote>
<br>
Martin,<br>
<br>
If you are specifically requesting that the tables in Deque/Queue
use "<table border=1>" then I will do as you request, but I
note that the "plain" style does more than just `border="1"`. It
adjusts the caption font and the margins above and below the table.
Given that the JSR166 doc comments actually use the <caption>
tag reasonably, the presentation with the non-default font seemed
"better".<br>
<br>
That being said, prior to doing this work, I did some analysis on
the tables coming from doc comments. There are about 484
<tables> with 70 different variants of the opening
<table> tag. Therefore, there was a secondary goal to
simplify the many different visual appearances created using inline
styles.<br>
<br>
How strongly do you feel about the names? As I said at the end of
the email, I would like to do a more complete cleanup of javadoc
support for stylesheets in a subsequent release. This would involve
separating the stylesheet for the HTML generated by the doclet from
a stylesheet provided to accompany the doc comments, and would clean
up the name space and write a moderately formal specification of the
styles in those stylesheets.<br>
<br>
I can put some comments in the default stylesheet for the time
being. <br>
<br>
-- Jon<br>
</body>
</html>