edited documentation

mathmech/mm/include/mathmech/atom_types.h

@@ -7,18 +7,17 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file atom_types.h
+ * Header of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #ifndef ATOM_TYPES_H
 #define ATOM_TYPES_H
 
 
-/**
- * @fn reading_atoms
- */
-int reading_atoms (const char *input_at, int *num_types, int *num_mol, int *num_atoms, 
-                   char *ch_atom_types, int *atom_types, const int total_types);
 /**
  * @brief function that reads atom types from input file
  * @code
@@ -39,6 +38,8 @@ int reading_atoms (const char *input_at, int *num_types, int *num_mol, int *num_
  * @return 3              - memory error
  * @return 0              - exit without errors
  */
+int reading_atoms (const char *input_at, int *num_types, int *num_mol, int *num_atoms, 
+                   char *ch_atom_types, int *atom_types, const int total_types);
 
 
 #endif /* ATOM_TYPES_H */

mathmech/mm/include/mathmech/coords.h

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file coords.h
+ * Header of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #ifndef COORDS_H
@@ -16,12 +20,6 @@
 #include <mathmech/var_types.h>
 
 
-/**
- * @fn reading_coords
- */
-int reading_coords (const int mode, const char *filename, const int type_inter, 
-                    const int *label_atom, system_info *_system_info, 
-                    int *true_label_mol, atom_info *_atom_info);
 /**
  * @brief function that reads coordinates from special file format
  * @code
@@ -45,6 +43,9 @@ int reading_coords (const int mode, const char *filename, const int type_inter,
  * @return 3              - memory error
  * @return 0              - exit without errors
  */
+int reading_coords (const int mode, const char *filename, const int type_inter, 
+                    const int *label_atom, system_info *_system_info, 
+                    int *true_label_mol, atom_info *_atom_info);
 
 
 #endif /* COORDS_H */

mathmech/mm/include/mathmech/envir_search.h

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file envir_search.h
+ * Header of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #ifndef ENVIR_SEARCH_H
@@ -16,11 +20,6 @@
 #include <mathmech/var_types.h>
 
 
-/**
- * @fn search_envir
- */
-int search_envir (const int num_of_mol, const system_info _system_info, const float *centr_coords, 
-                  const double rad, int *needed_mol, int *num_needed_mol);
 /**
  * @brief function that searchs environment
  * @code
@@ -37,6 +36,8 @@ int search_envir (const int num_of_mol, const system_info _system_info, const fl
  * 
  * @return 0              - exit without errors
  */
+int search_envir (const int num_of_mol, const system_info _system_info, const float *centr_coords, 
+                  const double rad, int *needed_mol, int *num_needed_mol);
 
 
 #endif /* ENVIR_SEARCH_H */

mathmech/mm/include/mathmech/graph.h

@@ -7,17 +7,17 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file graph.h
+ * Header of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #ifndef GRAPH_H
 #define GRAPH_H
 
 
-/**
- * @fn check_cycle
- */
-int check_cycle (const int N, const int *pn);
 /**
  * @brief function that calculates number of cycles in graph
  * @code
@@ -29,12 +29,9 @@ int check_cycle (const int N, const int *pn);
  * 
  * @return number of cycles
  */
+int check_cycle (const int N, const int *pn);
 
 
-/**
- * @fn check_cycle_size
- */
-int check_cycle_size (const int N, const int *matrix, const int depth, int *n_cycle);
 /**
  * @brief function that returns number of cycles different size
  * @code
@@ -50,12 +47,9 @@ int check_cycle_size (const int N, const int *matrix, const int depth, int *n_cy
  * @return 1              - memory error
  * @return 0              - exit without errors
  */
+int check_cycle_size (const int N, const int *matrix, const int depth, int *n_cycle);
 
 
-/**
- * @fn check_tail
- */
-int check_tail (const int *pn);
 /**
  * @brief function that calculates number of tails
  * @code
@@ -66,12 +60,9 @@ int check_tail (const int *pn);
  * 
  * @return number of tails
  */
+int check_tail (const int *pn);
 
 
-/**
- * @fn graph_analyze
- */
-int graph_analyze (const int N, const int *matrix, const int max_depth, int *iso);
 /**
  * @brief function that analyzes graph isomorhic class
  * @code
@@ -86,6 +77,7 @@ int graph_analyze (const int N, const int *matrix, const int max_depth, int *iso
  * @return 1              - memory error
  * @return 0              - exit without errors
  */
+int graph_analyze (const int N, const int *matrix, const int max_depth, int *iso);
 
 
 #endif /* GRAPH_H */

mathmech/mm/include/mathmech/messages.h

@@ -7,17 +7,17 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file messages.h
+ * Header of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #ifndef MESSAGES_H
 #define MESSAGES_H
 
 
-/**
- * @fn message
- */
-int message (const int log, const int mode, const char *text, FILE *output);
 /**
  * @brief function that prints messages to output
  * @code
@@ -32,6 +32,7 @@ int message (const int log, const int mode, const char *text, FILE *output);
  * @return 1              - unknown mode
  * @return 0              - exit without errors
  */
+int message (const int log, const int mode, const char *text, FILE *output);
 
 
 #endif /* MESSAGES_H */

mathmech/mm/include/mathmech/print_struct.h

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file print_struct.h
+ * Header of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #ifndef PRINT_STRUCT_H
@@ -16,11 +20,6 @@
 #include <mathmech/var_types.h>
 
 
-/**
- * @fn print_structure
- */
-int print_structure (const char *output, const int num_needed_mol, const int *needed_mol, 
-                     const system_info _system_info, const atom_info *_atom_info);
 /**
  * @brief function that prints structure to pdb file
  * @code
@@ -35,6 +34,8 @@ int print_structure (const char *output, const int num_needed_mol, const int *ne
  * 
  * @return 0              - exit without errors
  */
+int print_structure (const char *output, const int num_needed_mol, const int *needed_mol, 
+                     const system_info _system_info, const atom_info *_atom_info);
 
 
 #endif /* PRINT_STRUCT_H */

mathmech/mm/include/mathmech/print_trj.h

@@ -7,19 +7,17 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file print_trj.h
+ * Header of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #ifndef PRINT_TRJ_H
 #define PRINT_TRJ_H
 
 
-/**
- * @fn printing_trj
- */
-int printing_trj (const char *filename, const int atoms, const int num_types, const int *num_mol, 
-                  const int *num_atoms, const char *ch_atom_types, const int *atom_types,
-                  const float *coords);
 /**
  * @brief function that prints trajectory snapshots
  * @code
@@ -38,6 +36,9 @@ int printing_trj (const char *filename, const int atoms, const int num_types, co
  * 
  * @return 0              - exit without errors
  */
+int printing_trj (const char *filename, const int atoms, const int num_types, const int *num_mol, 
+                  const int *num_atoms, const char *ch_atom_types, const int *atom_types,
+                  const float *coords);
 
 
 #endif /* PRINT_TRJ_H */

mathmech/mm/include/mathmech/radf.h

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file radf.h
+ * Header of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #ifndef RADF_H
@@ -16,11 +20,6 @@
 #include <mathmech/var_types.h>
 
 
-/**
- * @fn search_rdf
- */
-int search_rdf (const system_info _system_info, const atom_info *_atom_info, 
-                const radf_info _radf_info, int *radf);
 /**
  * @brief function that searchs molecule for rdf massive
  * @code
@@ -34,13 +33,10 @@ int search_rdf (const system_info _system_info, const atom_info *_atom_info,
  * 
  * @return 0              - exit without errors
  */
+int search_rdf (const system_info _system_info, const atom_info *_atom_info, 
+                const radf_info _radf_info, int *radf);
 
 
-/**
- * @fn search_rdf_centr
- */
-int search_rdf_centr (const system_info _system_info, const atom_info *_atom_info, 
-                      const radf_info _radf_info, int *radf);
 /**
  * @brief function that searchs molecule for rdf massive by centered coordinates
  * @code
@@ -55,13 +51,10 @@ int search_rdf_centr (const system_info _system_info, const atom_info *_atom_inf
  * @return 0              - exit without errors
  * @return 1              - error in set center (missing atoms)
  */
+int search_rdf_centr (const system_info _system_info, const atom_info *_atom_info, 
+                      const radf_info _radf_info, int *radf);
 
 
-/**
- * @fn search_radf
- */
-int search_radf (const system_info _system_info, const atom_info *_atom_info, 
-                 const radf_info _radf_info, int *radf);
 /**
  * @brief function that searchs molecule for radf massive
  * @code
@@ -76,6 +69,8 @@ int search_radf (const system_info _system_info, const atom_info *_atom_info,
  * @return 0              - exit without errors
  * @return 1              - error in set center (missing atoms)
  */
+int search_radf (const system_info _system_info, const atom_info *_atom_info, 
+                 const radf_info _radf_info, int *radf);
 
 
 #endif /* RADF_H */

mathmech/mm/include/mathmech/radf_proc.h

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file radf_proc.h
+ * Header of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #ifndef RADF_PROC_H
@@ -16,12 +20,6 @@
 #include <mathmech/var_types.h>
 
 
-/**
- * @fn print_result
- */
-int print_result (const char *output, const int matrix, const int mode, 
-                  const system_info _system_info, const radf_info _radf_info,
-                  const int *radf);
 /**
  * @brief function that print result to output file
  * @code
@@ -37,6 +35,9 @@ int print_result (const char *output, const int matrix, const int mode,
  * 
  * @return 0              - exit without errors
  */
+int print_result (const char *output, const int matrix, const int mode, 
+                  const system_info _system_info, const radf_info _radf_info,
+                  const int *radf);
 
 
 #endif /* RADF_PROC_H */

mathmech/mm/include/mathmech/read_agl.h

@@ -7,17 +7,17 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file read_agl.h
+ * Header of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #ifndef READ_AGL_H
 #define READ_AGL_H
 
 
-/**
- * @fn reading_agl
- */
-int reading_agl (const char *aglinp, int *num_needed_mol, char *agl_class, int *needed_mol);
 /**
  * @brief function that reads agglomerate from statgen-formated file
  * @code
@@ -31,6 +31,7 @@ int reading_agl (const char *aglinp, int *num_needed_mol, char *agl_class, int *
  * 
  * @return 0              - exit without errors
  */
+int reading_agl (const char *aglinp, int *num_needed_mol, char *agl_class, int *needed_mol);
 
 
 #endif /* READ_AGL_H */

mathmech/mm/include/mathmech/read_gmx.h

@@ -7,17 +7,17 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file read_gmx.h
+ * Header of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #ifndef READ_GMX_H
 #define READ_GMX_H
 
 
-/**
- * @fn translate_coords
- */
-int translate_coords (const float coords, const float cell, float *trans);
 /**
  * @brief funtion that translates coordinate
  * @code
@@ -30,14 +30,9 @@ int translate_coords (const float coords, const float cell, float *trans);
  * 
  * @return 0              - exit without errors
  */
+int translate_coords (const float coords, const float cell, float *trans);
 
 
-/**
- * @fn rw_gmx
- */
-int rw_gmx (const char *input, const int step, const char *output, const int num_types, 
-            const int *num_mol, const int *num_atoms, const char *ch_atom_types, 
-            const int *atom_types, float *coords);
 /**
  * @brief function that read GROMACS trajectory file and write to output
  * @code
@@ -58,6 +53,9 @@ int rw_gmx (const char *input, const int step, const char *output, const int num
  * @return 1              - file does not exist
  * @return 0              - exit without errors
  */
+int rw_gmx (const char *input, const int step, const char *output, const int num_types, 
+            const int *num_mol, const int *num_atoms, const char *ch_atom_types, 
+            const int *atom_types, float *coords);
 
 
 #endif /* READ_GMX_H */

mathmech/mm/include/mathmech/read_puma.h

@@ -7,19 +7,17 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file read_puma.h
+ * Header of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #ifndef READ_PUMA_H
 #define READ_PUMA_H
 
 
-/**
- * @fn rw_puma
- */
-int rw_puma (const char *input, const int step, const char *output, const int num_types, 
-             const int *num_mol, const int *num_atoms, const char *ch_atom_types, 
-             const int *atom_types, float *coords);
 /**
  * @brief function that read PUMA trajectory file and write to output
  * @code
@@ -40,6 +38,9 @@ int rw_puma (const char *input, const int step, const char *output, const int nu
  * @return 1              - file does not exist
  * @return 0              - exit without errors
  */
+int rw_puma (const char *input, const int step, const char *output, const int num_types, 
+             const int *num_mol, const int *num_atoms, const char *ch_atom_types, 
+             const int *atom_types, float *coords);
 
 
 #endif /* READ_PUMA_H */

mathmech/mm/include/mathmech/select_mol.h

@@ -7,17 +7,17 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file select_mol.h
+ * Header of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #ifndef SELECT_MOL_H
 #define SELECT_MOL_H
 
 
-/**
- * @fn select_molecule
- */
-int select_molecule (const float *centr_coords, const int num_needed_mol, int *needed_mol);
 /**
  * @brief function that selects molecules from array of translated molecules
  * @code
@@ -30,6 +30,7 @@ int select_molecule (const float *centr_coords, const int num_needed_mol, int *n
  * 
  * @return 0              - exit without errors
  */
+int select_molecule (const float *centr_coords, const int num_needed_mol, int *needed_mol);
 
 
 #endif /* SELECT_MOL_H */

mathmech/mm/include/mathmech/set_center.h

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file set_center.h
+ * Header of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #ifndef SET_CENTER_H
@@ -16,11 +20,6 @@
 #include <mathmech/var_types.h>
 
 
-/**
- * @fn set_center
- */
-int set_center (const system_info _system_info, const atom_info *_atom_info, 
-                float *centr_coords);
 /**
  * @brief function that searchs center mass of molecules
  * @code
@@ -33,6 +32,8 @@ int set_center (const system_info _system_info, const atom_info *_atom_info,
  * 
  * @return 0              - exit without errors
  */
+int set_center (const system_info _system_info, const atom_info *_atom_info, 
+                float *centr_coords);
 
 
 #endif /* SET_CENTER_H */

mathmech/mm/include/mathmech/stat_print.h

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file stat_print.h
+ * Header of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #ifndef STAT_PRINT_H
@@ -16,13 +20,6 @@
 #include <mathmech/var_types.h>
 
 
-/**
- * @fn printing_agl
- */
-int printing_agl (const char *input, const char *output, const int *connect, 
-                  const system_info _system_info, const int *true_label_mol, 
-                  const int *num_mol_agl, const int *agl, const int *stat, 
-                  const int max_depth, int *type_agl);
 /**
  * @brief function that prints agglomerates to output file
  * @code
@@ -44,6 +41,10 @@ int printing_agl (const char *input, const char *output, const int *connect,
  * @return 1              - memory error
  * @return 0              - exit without errors
  */
+int printing_agl (const char *input, const char *output, const int *connect, 
+                  const system_info _system_info, const int *true_label_mol, 
+                  const int *num_mol_agl, const int *agl, const int *stat, 
+                  const int max_depth, int *type_agl);
 
 
 #endif /* STAT_PRINT_H */

mathmech/mm/include/mathmech/stat_select.h

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file stat_select.h
+ * Header of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #ifndef STAT_SELECT_H
@@ -16,11 +20,6 @@
 #include <mathmech/var_types.h>
 
 
-/**
- * @fn create_matrix
- */
-int create_matrix (const system_info _system_info, const atom_info *_atom_info, 
-                   const int num_of_inter, const float *crit, int *connect);
 /**
  * @brief function that creates connectivity matrix
  * @code
@@ -36,6 +35,8 @@ int create_matrix (const system_info _system_info, const atom_info *_atom_info,
  * @return 1              - memory error
  * @return 0              - exit without errors
  */
+int create_matrix (const system_info _system_info, const atom_info *_atom_info, 
+                   const int num_of_inter, const float *crit, int *connect);
 
 
 #endif /* STAT_SELECT_H */

mathmech/mm/include/mathmech/stat_sort.h

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file stat_sort.h
+ * Header of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #ifndef STAT_SORT_H
@@ -16,11 +20,6 @@
 #include <mathmech/var_types.h>
 
 
-/**
- * @fn proc_matrix
- */
-int proc_matrix (const system_info _system_info, const int *connect, int *num_mol_agl, 
-                 int *agl, int *stat, int *stat_all);
 /**
  * @brief function that processes connectivity matrix
  * @code
@@ -38,6 +37,8 @@ int proc_matrix (const system_info _system_info, const int *connect, int *num_mo
  * @return 1              - memory error
  * @return 0              - exit without errors
  */
+int proc_matrix (const system_info _system_info, const int *connect, int *num_mol_agl, 
+                 int *agl, int *stat, int *stat_all);
 
 
 #endif /* STAT_SORT_H */

mathmech/mm/include/mathmech/summary_stat.h

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file summary_stat.h
+ * Header of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #ifndef SUMMARY_STAT_H
@@ -16,11 +20,6 @@
 #include <mathmech/var_types.h>
 
 
-/**
- * @fn summary_statistic
- */
-int summary_statistic (const char *filename, const system_info _system_info, 
-                       const int max_depth, const int *type_agl, const int *stat_all);
 /**
  * @brief function that prints summary statistic
  * @code
@@ -36,6 +35,8 @@ int summary_statistic (const char *filename, const system_info _system_info,
  * 
  * @return 0              - exit without errors
  */
+int summary_statistic (const char *filename, const system_info _system_info, 
+                       const int max_depth, const int *type_agl, const int *stat_all);
 
 
 #endif /* SUMMARY_STAT_H */

mathmech/mm/include/mathmech/var_types.h

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file var_types.h
+ * Header of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #ifndef VAR_TYPES_H
@@ -16,6 +20,15 @@
 
 /**
  * @struct atom_info
+ * @brief atom information structure
+ * @var atom_info::label_mol
+ * massive of numbers of molecule for atoms
+ * @var atom_info::type_atoms
+ * massive of atom types
+ * @var atom_info::coords
+ * massive of coordinates
+ * @var atom_info::ch_type_atoms
+ * massive of char atom types
  */
 typedef struct
 {
@@ -24,17 +37,23 @@ typedef struct
   char ch_type_atoms[2];
   float coords[3];
 } atom_info;
-/**
- * @brief atom information structure
- * @var label_mol         massive of numbers of molecule for atoms
- * @var type_atoms        massive of atom types
- * @var coords            massive of coordinates
- * @var ch_type_atoms     massive of char atom types
- */
 
 
 /**
  * @struct radf_info
+ * @brief radf information structure
+ * @var radf_info::r_min
+ * minimal radius
+ * @var radf_info::r_max
+ * maximal radius
+ * @var radf_info::r_step
+ * radius step
+ * @var radf_info::ang_min
+ * minimal angle
+ * @var radf_info::ang_max
+ * minimal angle
+ * @var radf_info::ang_step
+ * angle step
  */
 typedef struct
 {
@@ -45,19 +64,21 @@ typedef struct
   float ang_max;
   float ang_step;
 } radf_info;
-/**
- * @brief radf information structure
- * @var r_min             minimal radius
- * @var r_max             maximal radius
- * @var r_step            radius step
- * @var ang_min           minimal angle
- * @var ang_max           minimal angle
- * @var ang_step          angle step
- */
 
 
 /**
  * @struct system_info
+ * @brief system information structure
+ * @var system_info::from
+ * last trajectory step
+ * @var system_info::to
+ * first trajectory step
+ * @var system_info::cell
+ * cell size
+ * @var system_info::num_atoms
+ * number of atoms
+ * @var system_info::num_mol
+ * number of molecules
  */
 typedef struct
 {
@@ -67,14 +88,6 @@ typedef struct
   int num_atoms;
   int num_mol;
 } system_info;
-/**
- * @brief system information structure
- * @var from              last trajectory step
- * @var to                first trajectory step
- * @var cell              cell size
- * @var num_atoms         number of atoms
- * @var num_mol           number of molecules
- */
 
 
 #endif /* VAR_TYPES_H */

mathmech/mm/src/atom_types.c

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file atom_types.c
+ * Source code of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #include <stdio.h>

mathmech/mm/src/coords.c

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file coords.c
+ * Source code of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #include <stdio.h>

mathmech/mm/src/envir_search.c

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file envir_search.c
+ * Source code of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #include <math.h>

mathmech/mm/src/graph.c

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file graph.c
+ * Source code of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #include <math.h>

mathmech/mm/src/main.c

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file main.c
+ * Source code of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #include <math.h>

mathmech/mm/src/messages.c

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file messages.c
+ * Source code of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #include <stdio.h>

mathmech/mm/src/print_struct.c

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file print_struct.c
+ * Source code of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #include <stdio.h>

mathmech/mm/src/print_trj.c

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file print_trj.c
+ * Source code of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #include <stdio.h>

mathmech/mm/src/radf.c

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file radf.c
+ * Source code of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #include <math.h>

mathmech/mm/src/radf_proc.c

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file radf_proc.c
+ * Source code of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #include <math.h>

mathmech/mm/src/read_agl.c

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file read_agl.c
+ * Source code of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #include <stdio.h>

mathmech/mm/src/read_gmx.c

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file read_gmx.c
+ * Source code of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #include <math.h>

mathmech/mm/src/read_puma.c

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file read_puma.c
+ * Source code of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #include <stdio.h>

mathmech/mm/src/select_mol.c

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file select_mol.c
+ * Source code of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #include <math.h>

mathmech/mm/src/set_center.c

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file set_center.c
+ * Source code of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #include <mathmech/set_center.h>

mathmech/mm/src/stat_print.c

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file stat_print.c
+ * Source code of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #include <stdio.h>

mathmech/mm/src/stat_select.c

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file stat_select.c
+ * Source code of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #include <math.h>

mathmech/mm/src/stat_sort.c

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file stat_sort.c
+ * Source code of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #include <stdlib.h>

mathmech/mm/src/summary_stat.c

@@ -7,7 +7,11 @@
  * ----------------------------------------------------------------------------
  */
 /**
- * @file
+ * @file summary_stat.c
+ * Source code of mathmech library
+ * @author Evgeniy Alekseev (arcanis)
+ * @copyright Beerware
+ * @bug No known bugs
  */
 
 #include <stdio.h>