Bug 11834 – std.net.curl: ddoc warnings

Status
RESOLVED
Resolution
FIXED
Severity
normal
Priority
P2
Component
phobos
Product
D
Version
D2
Platform
All
OS
All
Creation time
2013-12-27T14:48:00Z
Last change time
2014-08-17T05:03:44Z
Keywords
pull
Assigned to
nobody
Creator
andrei

Comments

Comment #0 by andrei — 2013-12-27T14:48:54Z
std/net/curl.d(2434): Warning: Ddoc: function declaration has no parameter 'dlTotal' std/net/curl.d(2434): Warning: Ddoc: function declaration has no parameter 'dlNow' std/net/curl.d(2434): Warning: Ddoc: function declaration has no parameter 'ulTotal' std/net/curl.d(2434): Warning: Ddoc: function declaration has no parameter 'ulNow' std/net/curl.d(2434): Warning: Ddoc: parameter count mismatch std/net/curl.d(3006): Warning: Ddoc: function declaration has no parameter 'dlTotal' std/net/curl.d(3006): Warning: Ddoc: function declaration has no parameter 'dlNow' std/net/curl.d(3006): Warning: Ddoc: function declaration has no parameter 'ulTotal' std/net/curl.d(3006): Warning: Ddoc: function declaration has no parameter 'ulNow' std/net/curl.d(3006): Warning: Ddoc: parameter count mismatch std/net/curl.d(3343): Warning: Ddoc: function declaration has no parameter 'dlTotal' std/net/curl.d(3343): Warning: Ddoc: function declaration has no parameter 'dlNow' std/net/curl.d(3343): Warning: Ddoc: function declaration has no parameter 'ulTotal' std/net/curl.d(3343): Warning: Ddoc: function declaration has no parameter 'ulNow' std/net/curl.d(3343): Warning: Ddoc: parameter count mismatch produced by make -f posix.mak html
Comment #1 by hsteoh — 2014-08-15T01:34:28Z
The ddoc appears to be documenting the parameters to a delegate parameter to the function, so arguably the use of Params: is abusive for this purpose.
Comment #2 by hsteoh — 2014-08-15T02:19:46Z
Comment #3 by github-bugzilla — 2014-08-16T21:47:03Z
Commit pushed to master at https://github.com/D-Programming-Language/phobos https://github.com/D-Programming-Language/phobos/commit/ff76141da598d8e85e06c11439c449b9fb6e0aef Merge pull request #2427 from quickfur/issue11834 Issue 11834: std.net.curl abuses ddoc params section and causes ddoc warnings