/* ///////////////////////////////////////////////////////////////////// */
/*! 
  \file  
  \brief Documentation template for C source files.

  Detailed description of the file goes here.         

  \authors A. Mignone (mignone@ph.unito.it)\n
           C. Zanni   (zanni@oato.inaf.it)\n
           G. Muscianisi (g.muscianisi@cineca.it)
           P. Tzeferacos (petros.tzeferacos@ph.unito.it)
           T. Matsakos  
  \date   Aug 16, 2012
*/
/* ///////////////////////////////////////////////////////////////////// */

/*! This is a comment for the following macro */
#define NEW_MACRO(a)  (a+1)

int global_var1; /**< This is the description of global_var1 */

/* ********************************************************************* */
void MyFunctionTemplate (void)
/*!
 * Start commenting the function here.
 *
 * \param [in]      state pointer to State_1D structure
 * \param [in]      beg   initial index of computation 
 * \param [in]      end   final   index of computation
 * \param [in,out]  d     pointer to PLUTO Data structure
 * \param [out]     src   2D array of source terms
 * \param [in]      grid  pointer to an array of Grid structures
 *
 * \b References
 *    - ".." \n
 *      Mignone et al, JCP (2010) xx, xx
 *
 * \return  This function has no return value.
 * \see
 * \attention
 * \note  --
 * \todo  --
 *
 *********************************************************************** */
{

/* ---------------------------------------------------------------- */
/*! This is a buil-int comment                                      */
/* ---------------------------------------------------------------- */

}


/* ********************************************************************* */
/*! Structure comment here
   ********************************************************************* */