Added and corrected documentation for the 'shared' option