added documentation for longest_only parameter