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
Comment #2 by github-bugzilla — 2014-04-27T20:39:56Z
Commits pushed to master at https://github.com/D-Programming-Language/dmd https://github.com/D-Programming-Language/dmd/commit/a01afe0188d0b7a26cb4dcebf0b3a8b97f027c56 Fix Issue 11511 - DDoc - C variadic parameters cannot be properly documented. https://github.com/D-Programming-Language/dmd/commit/65a67f99ad642378a4c3aea321af8ef9f5e4918f Merge pull request #3503 from AndrejMitrovic/Fix11511 Issue 11511 - DDoc C variadic parameters cannot be properly documented.