Hi Roger, I think tackling this via the new Developer’s guide project makes sense as it would help folks re-inventing the wheel and making it easier to find what already exists.
Best Lance > On Apr 17, 2020, at 12:55 PM, Roger Riggs <roger.ri...@oracle.com> wrote: > > 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 >>> <http://cr.openjdk.java.net/~rriggs/webrev-hexprinter-8243010/javadoc> >>> >>> [2] Webrev: >>> http://cr.openjdk.java.net/~rriggs/webrev-hexprinter-8243010/ >>> <http://cr.openjdk.java.net/~rriggs/webrev-hexprinter-8243010/> >>> >>> [3] Issue: >>> https://bugs.openjdk.java.net/browse/JDK-8243010 >>> <https://bugs.openjdk.java.net/browse/JDK-8243010> >> >> <oracle_sig_logo.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> >> <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> >> >> >> > <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>