Hi Lance,
The test library is a bit of a black box usually approached from the
angle of existing tests.
And unfortunately, there is a lower bar for documentation and API
development.
Perhaps an item to be looked at as part of the new developer guide project.
Thanks, Roger
On 4/17/20 11:34 AM, Lance Andersen wrote:
Hi Roger,
Thank you for creating this as it looks good.
A couple of quick questions
- Will the javadoc be hosted somewhere
- Maybe I have not stumbled onto it yet, but is there a document/wiki
somewhere that describes all of the useful test libraries vs
discovering as you go?
Best
Lance
On Apr 16, 2020, at 3:17 PM, Roger Riggs <roger.ri...@oracle.com
<mailto:roger.ri...@oracle.com>> wrote:
Please review[2] and comment on a new Hex printing utility to support
OpenJDK tests.
The usefulness of a hex printing has been discussed from time to time
with
many suggestions as to the API shape and features.
To get an idea of the API and features, take a look at the javadoc[1].
It covers the basic formatting of offset, and values, and extends the
descriptive part beyond simple ASCII or printable so that a custom
formatter
can interpret the byte stream in parallel to the bytes.
The webrev includes changes to existing tests that currently
use HexDumpEncoder to use HexPrinter.
Comments appreciated, Roger
[1]Javadoc:
http://cr.openjdk.java.net/~rriggs/webrev-hexprinter-8243010/javadoc
[2] Webrev:
http://cr.openjdk.java.net/~rriggs/webrev-hexprinter-8243010/
[3] Issue:
https://bugs.openjdk.java.net/browse/JDK-8243010
<http://oracle.com/us/design/oracle-email-sig-198324.gif>
<http://oracle.com/us/design/oracle-email-sig-198324.gif><http://oracle.com/us/design/oracle-email-sig-198324.gif>
<http://oracle.com/us/design/oracle-email-sig-198324.gif>Lance
Andersen| Principal Member of Technical Staff | +1.781.442.2037
Oracle Java Engineering
1 Network Drive
Burlington, MA 01803
lance.ander...@oracle.com <mailto:lance.ander...@oracle.com>