Ejemplo documentación frases.h

#ifndef _FRASES_H
#define _FRASES_H
/**
 * @file frases.h
 * Modulo frases
 *
 * Incluir una descripción detallada de lo que hace el módulo.
 *
 * @author Tomas Olo Dejas
 * @date 2013-02-04
 * @version 1.0
 */

#include <stdlib.h>
#include <string.h>

/**
 * saludo personalizado.
 *
 * Personaliza el saludo al usuario según su nombre.
 * Imp: Esta función reserva memoria que es preciso liberar.
 * @param nombre una cadena de caracteres.
 * @return una cadena caracteres con el saludo personalizado.
*/
char * saludo(char nombre[]);

/**
 * despidida
 *
 * Frase de despedida
 *
 * @return una cadena caracteres con la frase despedida.
*/
char * despedida();

#endif