placement algorithm option, renamed a few options, a bit less code, started documentation
new syntax for most arguments; a bit more documentation; now robust to the absence of a weighting method