[Issue 10236] Ddoc: Warning on wrong parameter names

[d-bugmail at puremagic.com]

http://d.puremagic.com/issues/show_bug.cgi?id=10236



--- Comment #15 from bearophile_hugs at eml.cc 2013-08-25 19:12:47 PDT ---
(In reply to comment #14)

> This shows three warnings for the first reset(), no warnings for the "ditto". A
> quick fix would be to copy the whole ddoc for the two overloads, but perhaps
> there's something smarter that can be done here?

Here "Params" is used in a non-standard way, it shows the merged arguments of
all the overloads of the "reset" function. This merging should be accepted by
the warning code only if dittos are used. So a possible solution is to create a
set of all the arguments of the overloads tagged with "ditto", and then verify
such set is the same as the set of arguments listed in the "Params" section.

(But usually warnings aren't 100.00% reliable. Usually there are very uncommon
cases where a warning gives false positives and false negatives. This ddoc
warning seems to be nearly perfect, but I don't expect it to be really perfect.
I think here a error rate of 0.1% or 0.01% is acceptable. Keeping warning
implementation simple is sometimes better than trying to further reduce down
that tiny percentage of errors.)

-- 
Configure issuemail: http://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------