added JavaDoc to ascending tuples
added ascending tuple tests