This was causing me some problems. I think someone should look at this page closely. First of all it was reporting the default for &descendentDepth is 1 which is not correct, it is 10 (typo?). I think there are some other inaccuracies on that page as well.
http://modxcms.com/ditto_parameters.html