Arrow tail error, javadoc and code efficiencies