Gittrac #4032:  Implemented this feature and a corresponding test;
still needs documentation.