JAL-840 updated docs - thanks to AMW for verifying by independent implementation...