Fixing issue #839 Better documentation of "directory" override