Document undocumented param
Expand boxdim documentation

I also moved the L= keyword argument back to the end. This enables
self-consistent behavior when specifying the box arguments as 6 positional
arguments. I still recommend always using keyword arguments to avoid issues.

The expanded documentation lists the common use cases I expect users will
want to use and how to implement them with boxdim.