comments

c/tex_parser/tex_parser.h

@@ -32,18 +32,25 @@ enum tex_parser_error {
 /**
  * struct tex_table_row_s - LaTeX table row
  *
+ * @cells:
+ * @row_line:
  *
  */
 struct tex_table_row_s {
 	char **cells;
-	char *after; // \hline, \cline{4-5} etc.
+	char *row_line; // \hline, \cline{4-5} etc.
 };
 
 /**
  * struct tex_table_s - LaTeX table
  *
- *
- *
+ * @document_offset:
+ * @document_size:
+ * @id:
+ * @col_props:
+ * @head_table:
+ * @foot_table:
+ * @main_table:
  */
 struct tex_table_s {
 	size_t document_offset; // offset (in sybmols) in the LaTeX document
@@ -56,8 +63,9 @@ struct tex_table_s {
 };
 
 /**
+ * struct tex_graphics - LaTeX graphics
  *
- *
+ * @something:
  */
 struct tex_graphics {
 	void *something;
@@ -66,9 +74,9 @@ struct tex_graphics {
 /**
  * enum tex_element_type - Type of LaTeX element
  *
- * TEX_ELEM_TEXT:                       Text containing non-arable code
- * TEX_ELEM_TABLE:                      LaTeX table or longtable
- * TEX_ELEM_GRAPHICS:                   LaTeX graphics (images, plots)
+ * @TEX_ELEM_TEXT:                       Text containing non-arable code
+ * @TEX_ELEM_TABLE:                      LaTeX table or longtable
+ * @TEX_ELEM_GRAPHICS:                   LaTeX graphics (images, plots)
  *
  * Need some description here...
  */
@@ -117,7 +125,7 @@ struct tex_struct_s {
  *
  * Parses LaTeX text string @source of length len to *@tex_struct.
  * If some error occurs, parser returns immediatly with error info in *@error.
- * @tex_struct or @error can't be %NULL,
+ * @tex_struct or @error can't be %NULL; *@tex_struct *@error must be %NULL.
  */
 void tex_parse(const char *source, size_t len, struct tex_struct_s **tex_struct, struct zerror_s **error);