Re: Some problems in `add-log-current-defun'

[Masatake YAMATO]

>     void ssort(void * base, size_t n, size_t sz, CFT cmp)
>     /*
>         Sort the "n" elements of vector "base" into increasing order
>         using the comparison function pointed to by "cmp".
>         The elements are of size "sz".
> 
>         Shell sort (Knuth, Vol3, pg84)
>     */
>     {
>         /* ...  */
>     }
> 
> That seems like common usage -- not weird.  It would be nice to handle
> that usage correctly.  However, if we have never handled it in the
> past, I think it is not urgent to fix it now.
> 
> Masatake YAMATO <address@hidden> thinks that code is badly formatted.
> Masatake, why do you think so?

Just because I have never seen such a comment style. So to be exact
I should write it is not badly formatted, but it is rare comment style
in my experiences. Usually I have seen following comment style:

    /*
        Sort the "n" elements of vector "base" into increasing order
        using the comparison function pointed to by "cmp".
        The elements are of size "sz".

        Shell sort (Knuth, Vol3, pg84)
    */
    void ssort(void * base, size_t n, size_t sz, CFT cmp)
    {
        /* ...  */
    }

Masatake YAMATO