Se completa un poco la documentacion.

diff --git a/equation.c b/equation.c
index 5268bff26987d3dab9559e50d1f1d8b58fcb99ad..d632c3e9d79edb583258acb3c5f6d804a878c4ca 100644 (file)
--- a/equation.c
+++ b/equation.c
@@ -22,6 +22,12 @@
 
 /**
  * Copia un fragmento de una cadena devolviendo el puntero a la copia.
+ *
+ * \param str Cadena de caracteres original.
+ * \param start Comienzo del fragmento a copiar.
+ * \param len Longitud del fragmento a copiar.
+ *
+ * \return Fragmento copiado.
  */
 char* Equation_copy_fragment(const char* str, size_t start, size_t len) {
     /* Reservo el espacio (incluyendo el caracter nulo). */

diff --git a/equation.h b/equation.h
index e74252463c65fa109cf7f645d09439b3d546f2eb..49dcc11c4da2a6ec015137cd02f5f983e51ba456 100644 (file)
--- a/equation.h
+++ b/equation.h
@@ -20,16 +20,45 @@
 #include <stdlib.h>
 #include <stdio.h>
 
+/**
+ * Ecuación.
+ */
 typedef struct {
+    /** Nombre de la variable. */
     char* variable;
+    /** Expresión. */
     char* expression;
 } Equation;
 
+/**
+ * Crea una nueva Equation.
+ *
+ * \param line Cadena de caracteres de donde extraer la Equation.
+ * \param var_start Comienzo del nombre de la variable.
+ * \param var_len Longitud de la variable.
+ * \param exp_start Comienzo de la expresión.
+ * \param exp_len Longitud de la expresión.
+ *
+ * \return Nueva Equation.
+ */
 Equation* Equation_new(const char* line, size_t var_start, size_t var_len,
         size_t exp_start, size_t exp_len);
 
+/**
+ * Elimina una Equation.
+ *
+ * \param eq Equation a eliminar.
+ */
 void Equation_delete(Equation* eq);
 
+/**
+ * Imprime una Equation.
+ *
+ * \param eq Equation a imprimir.
+ * \param fp Archivo donde imprimirla.
+ *
+ * \return Cantidad de caracteres impresos.
+ */
 size_t Equation_print(Equation* eq, FILE* fp);
 
 #endif /* EQUATION_H */

diff --git a/parseerror.h b/parseerror.h
index 63f3d8cc506aef98fd13a31c9acffc42908a03b1..628e9f03378d471d11dfbac07703afb97220c546 100644 (file)
--- a/parseerror.h
+++ b/parseerror.h
@@ -21,27 +21,65 @@
 #include <stdlib.h>
 #include <stdio.h>
 
+/**
+ * Error de interpretación.
+ */
 typedef struct {
+    /** Línea en la que se produjo el error. */
     size_t  line;
+    /** Posición en la que se produjo el error. */
     size_t  pos;
+    /** Mensaje de error. */
     char*   message;
 } ParseError;
 
+/**
+ * Crea un nuevo ParseError.
+ *
+ * \return Nuevo ParseError.
+ */
 ParseError* ParseError_new(void);
 
+/**
+ * Elimina un ParseError.
+ *
+ * \param pe ParseError a eliminar.
+ */
 void ParseError_delete(ParseError* pe);
 
 /**
+ * Cambia el mensaje al ParseError.
+ *
+ * \param pe ParseError al cual cambiar el mensaje de error.
+ * \param msg Nuevo mensaje.
+ *
  * \return TRUE si se pudo alocar la memoria necesaria, FALSE si no.
  */
 bool ParseError_set_message(ParseError* pe, const char* msg);
 
 /**
+ * Cambia el mensaje especificando posición del error.
+ * Se epecifica la posición, el caracter incorrecto y que tipo de caracteres se
+ * esperaban.
+ *
+ * \param pe ParseError al cual cambiar el mensaje de error.
+ * \param msg Mensaje con los caracteres que se esperaban.
+ * \param pos Posición en la que se produjo el error.
+ * \param wrong_char Caracter incorrecto.
+ *
  * \return TRUE si se pudo alocar la memoria necesaria, FALSE si no.
  */
 bool ParseError_set_pos_message(ParseError* pe, const char* msg, size_t pos,
         char wrong_char);
 
+/**
+ * Imprime un ParseError.
+ *
+ * \param pe ParseError a imprimir.
+ * \param fp Archivo en el cual imprimirlo.
+ *
+ * \return cantidad de caracteres impresos.
+ */
 size_t ParseError_print(ParseError* pe, FILE* fp);
 
 #endif /* PARSEERROR_H */

diff --git a/parser_equation.h b/parser_equation.h
index 1b0a18cabc9e4c4cd222f2b3e64c98474c841b9d..c14470483ab6ece3742a094fa5c7caa1201b51e3 100644 (file)
--- a/parser_equation.h
+++ b/parser_equation.h
@@ -24,6 +24,8 @@
 
 size_t DLList_equation_print(DLList* l, FILE* fp);
 
+void DLList_equation_delete(DLList* l);
+
 /* TODO:
  *
  * opcion1:
@@ -42,6 +44,4 @@ size_t DLList_equation_print(DLList* l, FILE* fp);
 bool parser_equation(const char* line, size_t len, DLList* equation_list,
         ParseError* error);
 
-void DLList_equation_delete(DLList* l);
-
 #endif /* PARSER_EQUATION_H */