updated the remove-dim as discussed in the mailing list
updated documentation