https://issues.dlang.org/show_bug.cgi?id=17183

          Issue ID: 17183
           Summary: Improve std.algorithm.mutate.remove documentation
           Product: D
           Version: D2
          Hardware: All
                OS: All
            Status: NEW
          Severity: enhancement
          Priority: P1
         Component: phobos
          Assignee: nobody@puremagic.com
          Reporter: bugzilla@digitalmars.com

The current state of the documentation:

http://dlang.org/phobos/std_algorithm_mutation.html#.remove

Improvements:

http://www.digitalmars.com/d/archives/digitalmars/D/syntax_sugar_std.path_buildPath_instead_of_from_std.path_.buildPath_297885.html#N297931

--