Feedback on the new doclet.

Paul Benedict pbenedict at apache.org
Wed Feb 17 19:28:10 UTC 2016


Thank you Jon. One thing I recommend for improvement is removing the
automatic highlighting of the first item in the search box results. First,
the highlighting is gray so I first mistook it for a specialized header --
but it was really just the item selected. I think a yellowish color would
be better. Regardless, I don't think the automatic highlighting should be
done until I roll over or navigate with the keyboard.

Cheers,
Paul

On Wed, Feb 17, 2016 at 12:53 PM, Jonathan Gibbons <
jonathan.gibbons at oracle.com> wrote:

> Paul,
>
> Yes, we know about this one and it's on the list to be fixed.  It's not
> specific to the new doclet;  it happens in the ofl doclet as well, and is
> related to the transition to supporting HTML 5.
>
> That being said, with the recent arrival of the Search feature, the index
> frames on the left hand side are less important than before, and we expect
> that more folk will prefer to work in "No Frames" mode, and use Search to
> navigate to packages and types.
>
> -- Jon
>
>
>
> On 02/17/2016 10:42 AM, Paul Benedict wrote:
>
> In the new doclet, I can no longer resize the "frames". I know they aren't
> HTML frames but the ability to resize them is important; the functionality
> should be restored via scripting. There are long package and class names in
> the wild.
>
> Cheers,
> Paul
>
> On Tue, Feb 16, 2016 at 3:41 PM, Kumar Srinivasan <
> kumar.x.srinivasan at oracle.com> wrote:
>
>> Hello everyone,
>>
>> The  JEP 221 [1] was integrated into jdk9 b104. This feature
>> significantly changes the javadoc tool and replaces the HTML doclet.
>>
>> Please try it out and let us know, if  you observe anything
>> amiss in the generated docs at  javadoc-dev at openjdk.java.net.
>>
>> Thanks in advance
>> Kumar Srinivasan
>>
>> [1] http://openjdk.java.net/jeps/221
>>
>>
>>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.openjdk.java.net/pipermail/javadoc-dev/attachments/20160217/f37d1ad6/attachment.html>


More information about the javadoc-dev mailing list