added tests and documentation for issue #748