dud: A dub replacement

[Rumbu]

On Wednesday, 20 November 2019 at 13:37:39 UTC, Jacob Carlborg 
wrote:
> On Wednesday, 20 November 2019 at 11:40:19 UTC, Robert Schadek 
> wrote:
>
>> Here is disagree, to a degree I consider comments a code smell.
>> If I have to write them, I failed to convey the information
>> needed to understand the code in the code.
>
> You think this is a code smell: 
> https://dlang.org/phobos/std_array.html ?
>
> --
> /Jacob Carlborg

When a function signature looks like this

ElementEncodingType!(ElementType!RoR)[] join(RoR, R)(RoR ror, 
scope R sep)
if (isInputRange!RoR && isInputRange!(Unqual!(ElementType!RoR)) 
&& isInputRange!R && is(Unqual!(ElementType!(ElementType!RoR)) == 
Unqual!(ElementType!R)))

or like this:

E[] replaceFirst(E, R1, R2)(E[] subject, R1 from, R2 to)
if (isDynamicArray!(E[]) && isForwardRange!R1 && 
is(typeof(appender!(E[])().put(from[0..1]))) && isForwardRange!R2 
&& is(typeof(appender!(E[])().put(to[0..1]))));

it's understandable why documentation is mandatory.