coding style change proposal: function parameter names in headers

[Ingo Strüwing]

Hi,

I propose to demand function parameter names in header files.

We do not document functions in header files. The documentation goes to
the C/C++ file where it is defined.

With parameter names in header files, one would not need to look up the
source file for every function call.

Example:

  Restore_info* prepare_for_restore(String*, LEX_STRING,
                                    const char*, bool,
                                    const char*);

This declaration forces me to look into kernel.cc whenever I want to
call it.

  Restore_info* prepare_for_restore(String *backupdir,
                                    LEX_STRING orig_dir,
                                    const char *query,
                                    bool with_compression,
                                    const char *comment);

In this case there is a good chance that I do not need to consult the
function comment in the source file.

Regards
Ingo
-- 
Ingo Strüwing, Database Group
Sun Microsystems GmbH, Sonnenallee 1, D-85551 Kirchheim-Heimstetten
Geschäftsführer: Thomas Schröder, Wolfgang Engels, Dr. Roland Bömer
Vorsitzender des Aufsichtsrates: Martin Häring   HRB München 161028