Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Missing DDoc #322

Closed
simendsjo opened this issue Sep 22, 2013 · 2 comments
Closed

Missing DDoc #322

simendsjo opened this issue Sep 22, 2013 · 2 comments

Comments

@simendsjo
Copy link
Contributor

Building docs with dmd head reveals some missing parts. Good to see ddoc improving.

 5 args.d:69: Warning: Ddoc: parameter count mismatch                                                                                                                                                             
 6 log.d:110: Warning: Ddoc: parameter count mismatch                                                                                                                                                             
 7 /home/simendsjo/code/d/vibe.d/source/vibe/crypto/passwordhash.d:61: Warning: Ddoc: parameter count mismatch                                                                                                    
 8 /home/simendsjo/code/d/vibe.d/source/vibe/db/mongo/mongo.d:48: Warning: Ddoc: function declaration has no parameter 'host_or_url'                                                                              
 9 /home/simendsjo/code/d/vibe.d/source/vibe/db/mongo/mongo.d:48: Warning: Ddoc: parameter count mismatch                                                                                                         
10 /home/simendsjo/code/d/vibe.d/source/vibe/http/form.d:174: Warning: Ddoc: parameter count mismatch                                                                                                             
11 /home/simendsjo/code/d/vibe.d/source/vibe/stream/counting.d:34: Warning: Ddoc: parameter count mismatch                                                                                                        
12 /home/simendsjo/code/d/vibe.d/source/vibe/stream/operations.d:76: Warning: Ddoc: function declaration has no parameter 'dst'                                                                                   
13 /home/simendsjo/code/d/vibe.d/source/vibe/stream/operations.d:76: Warning: Ddoc: parameter count mismatch                                                                                                      
14 /home/simendsjo/code/d/vibe.d/source/vibe/internal/std/process.d:314: Warning: Ddoc: function declaration has no parameter 'program'                                                                           
15 /home/simendsjo/code/d/vibe.d/source/vibe/internal/std/process.d:314: Warning: Ddoc: parameter count mismatch                                                                                                  
16 /home/simendsjo/code/d/vibe.d/source/vibe/internal/std/process.d:1374: Warning: Ddoc: function declaration has no parameter 'program'                                                                          
17 /home/simendsjo/code/d/vibe.d/source/vibe/internal/std/process.d:1374: Warning: Ddoc: function declaration has no parameter 'command'                                                                          
18 /home/simendsjo/code/d/vibe.d/source/vibe/internal/std/process.d:1374: Warning: Ddoc: function declaration has no parameter 'redirect'                                                                         
19 /home/simendsjo/code/d/vibe.d/source/vibe/internal/std/process.d:1374: Warning: Ddoc: parameter count mismatch                                                                                                 
20 /home/simendsjo/code/d/vibe.d/source/vibe/internal/std/process.d:1634: Warning: Ddoc: function declaration has no parameter 'program'                                                                          
21 /home/simendsjo/code/d/vibe.d/source/vibe/internal/std/process.d:1634: Warning: Ddoc: function declaration has no parameter 'command'                                                                          
22 /home/simendsjo/code/d/vibe.d/source/vibe/internal/std/process.d:1634: Warning: Ddoc: parameter count mismatch                                                                                                 
@s-ludwig
Copy link
Member

Nice! Will fix in the coming days...

@s-ludwig
Copy link
Member

Some of the errors are incorrect because DMD seems to ignore parameters with default values. I also didn't fix the internal.std.process ones, as that code will be removed soon, and there are some cases where multiple functions are documented at the same time, resulting in warnings:

/**
    Params:
        a = ...
        b = ...
*/
void func(int a) {}
/// ditto
void func(int b) {}

So most of the warnings will persist unfortunately.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants