Agreed. This is very cryptic, IMHO. On Wed, Oct 3, 2012 at 10:42 AM, Matt Benson <gudnabr...@gmail.com> wrote: > Urgh; I find these method names rather painful. Why wouldn't we > simply provide endianness and bit ordering as enums, and parameterize > accordingly? > > Matt > > On Wed, Oct 3, 2012 at 9:07 AM, Gary Gregory <garydgreg...@gmail.com> wrote: >> On Wed, Oct 3, 2012 at 7:28 AM, Jörg Schaible <joerg.schai...@gmx.de> wrote: >> >>> Jörg Schaible wrote: >>> >>> > >>> > sebb wrote: >>> >>> [snip] >>> >>> >> I find the naming convention rather difficult to follow. >>> >> >>> >> For example, the letter 's' sometimes means 'array' and sometimes means >>> >> 'string' Also M0 is not obvious as an abbreviation, nor is BeM0 >>> > >>> > I am all open for better names, all *I* want to have is the >>> functionality. >>> >>> Has anyone a better idea for the names? >>> >> >> I would probably loose the plural to indicate an array. >> >> I would expand M0 to Msb0 which itself is an acronym. Abbreviating an >> acronym is to mysterious to me. >> >> So I'd end up with: >> >> boolBeMsb0ToHexDigit(boolean[] src) >> >> instead of: >> >> boolsBeM0ToHexDigit(boolean[] src) >> >> I would use real examples in the Javadoc: >> >> * <p> >> * (true, false, false, false) is converted as follow: '8' ... >> >> instead of: >> >> * <p> >> * (1, 0, 0, 0) is converted as follow: '8' ... >> >> and use [ ] instead of ( ) to show an array >> >> my 2c, >> >> Gary >> >> >>> - Jörg >>> >>> >>> --------------------------------------------------------------------- >>> To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org >>> For additional commands, e-mail: dev-h...@commons.apache.org >>> >>> >> >> >> -- >> E-Mail: garydgreg...@gmail.com | ggreg...@apache.org >> JUnit in Action, 2nd Ed: <http://goog_1249600977>http://bit.ly/ECvg0 >> Spring Batch in Action: <http://s.apache.org/HOq>http://bit.ly/bqpbCK >> Blog: http://garygregory.wordpress.com >> Home: http://garygregory.com/ >> Tweet! http://twitter.com/GaryGregory > > --------------------------------------------------------------------- > To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org > For additional commands, e-mail: dev-h...@commons.apache.org >
--------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org For additional commands, e-mail: dev-h...@commons.apache.org