[Issue 10236] Ddoc: Warning on wrong parameter names

d-bugmail at puremagic.com d-bugmail at puremagic.com
Sun Aug 25 18:35:14 PDT 2013


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



--- Comment #14 from Lionello Lunesu <lio+bugzilla at lunesu.com> 2013-08-25 18:35:13 PDT ---
While solving the warnings in druntime, there's only one instance where I
thought the current patch might need to be improved:

  /**
     * Resets this fiber so that it may be re-used.  This routine may only be
     * called for fibers that have terminated, as doing otherwise could result
     * in scope-dependent functionality that is not executed.  Stack-based
     * classes, for example, may not be cleaned up properly if a fiber is reset
     * before it has terminated.
     *
     * Params:
     *  fn = The fiber function.
     *  dg = The fiber function.
     *
     * In:
     *  This fiber must be in state TERM.
     */
    final void reset();

    /// ditto
    final void reset( void function() fn );

    /// ditto
    final void reset( void delegate() dg );

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?

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


More information about the Digitalmars-d-bugs mailing list