D-Programming-Language/phobos — pull request #769 by ntrel (2012-09-03 15:09:30+00:00)
Title: Document std.algorithm eponymous template members

Function signatures are currently not shown in the std.algorithm docs for eponymous template members. This is confusing, especially as some readers won't be familiar with the eponymous template feature.

This PR moves the doc-comment for each eponymous template to the eponymous template member and adds a short 'Eponymous template' doc-comment for the template block itself. Using 'Eponymous template' explicitly provides a phrase that programmers unaware of the feature can search for.

Note: the github combined diff looks very noisy because of the indentation changes on doc-comments, so I committed the indentation changes separately from the other commits. (`git show --ignore-all-space 895626` reports no changes).

This is a win for documentation readers, but it does make reading the source code a bit more awkward (unless you use an editor that supports comment folding) as each template line is now quite far from the template body.