title: Should function declarations include parameter names?
body: <p>What would you actually consider a better coding style: declaring the parameter names of functions/methods inside the header, or only in the source file, as it is possible to do both? If you actually consider declaring parameter names of functions/methods only in the source file, how would you then declare default values?</p>
  
  <p>Outside header:</p>
  
  <pre><code>//One.hpp
  #ifndef ONE_HPP
  #define ONE_HPP
  namespace eins {
  
  /** \brief description
   *  
   * \param one represents ....
   * \param two represents ....
   */
  void function(int,int);
  
  }
  #endif
  
  // One.cpp
  #include "One.hpp"
  
  eins::function(int one,int two) {
    //Do stuff//
  }
  </code></pre>
  
  <p>Inside header:</p>
  
  <pre><code>//One.hpp
  #ifndef ONE_HPP
  #define ONE_HPP
  namespace eins {
  
  /** \brief description
   *  
   * \param one represents ....
   * \param two represents ....
   */
  void function(int one,int two);
  
  }
  #endif
  
  // One.cpp
  #include "One.hpp"
  
  eins::function(int one,int two) {
    //Do stuff//
  }
  </code></pre>
  
  <p>My personal point of view is that the first way is better, as the user is actually forced to read the comments/API and cannot be misguided to just read the parameter names. But I am not sure about this and actually declaring default values would break my style as you have to do that in the header declaration of a function/method.</p>