diff --git a/include/pasm.h b/include/pasm.h
index f5a51ea..e234cc1 100644
--- a/include/pasm.h
+++ b/include/pasm.h
@@ -2,4 +2,9 @@
 #include <stdlib.h>
 #include <stdio.h>
 
+/* filename: path of the pasm script, will use file argument if NULL                    */
+/* file: char** containing the lines of a pasm script, will be used if filename is NULL */
+/* lines: number of lines in the file argument, will be used if filename is NULL        */
+/* _fstream: file descriptor for the output (can be a socket), default: stderr          */
+/* return value: nonzero if an error occurred                                           */
 int pasm_run_script(const char *filename, char **file, size_t lines, int _fstream);
diff --git a/src/pasm.c b/src/pasm.c
index 632cc48..0964a2a 100644
--- a/src/pasm.c
+++ b/src/pasm.c
@@ -66,6 +66,11 @@ int check_errors(char *line) {
     return 0;
 }
 
+/* filename: path of the pasm script, will use file argument if NULL                    */
+/* file: char** containing the lines of a pasm script, will be used if filename is NULL */
+/* lines: number of lines in the file argument, will be used if filename is NULL        */
+/* _fstream: file descriptor for the output (can be a socket), default: stderr          */
+/* return value: nonzero if an error occurred                                           */
 int pasm_run_script(const char *filename, char **file, size_t lines, int _fstream) {
     fstream = _fstream;