Bug 11511 – DDoc - C variadic parameters cannot be properly documented
Status
RESOLVED
Resolution
FIXED
Severity
normal
Priority
P2
Component
dmd
Product
D
Version
D2
Platform
All
OS
All
Creation time
2013-11-13T08:33:00Z
Last change time
2014-04-27T20:39:56Z
Keywords
ddoc, pull
Assigned to
andrej.mitrovich
Creator
rumbu
Comments
Comment #0 by rumbu — 2013-11-13T08:33:17Z
Assuming the following function:
void foo(int i, ...)
Documentation of the variable parameter list is not formatted correctly:
Example
///Parameters: i = some integer parameter
/// ... = variable length list of arguments
The DDoc output will not automatically align and break the line after "i" documentation
Documenting "..." as something else (e.g. "args") will output a compiler warning.
Proposal: interpret "..." as parameter or accept "args" as replacement without warning.
Comment #1 by andrej.mitrovich — 2014-04-26T18:49:49Z