3 files changed, 11 insertions, 8 deletions
diff --git a/bin/reproducible_common.py b/bin/reproducible_common.py
index 9be98bb9..37621d26 100755
--- a/bin/reproducible_common.py
+++ b/bin/reproducible_common.py
@@ -1,11 +1,12 @@
 #!/usr/bin/python3
 # -*- coding: utf-8 -*-
-
-# clean-notes: sort and clean the notes stored in notes.git
+#
 # Copyright © 2015 Mattia Rizzolo <mattia@mapreri.org>
 # Licensed under GPL-2+
 #
 # Depends: python3
+#
+# This is included by all reproducible_*.py scripts, it cotains common functions
 
 import os
 import re
diff --git a/bin/reproducible_html_notes.py b/bin/reproducible_html_notes.py
index d5d5e4a3..f86a2926 100755
--- a/bin/reproducible_html_notes.py
+++ b/bin/reproducible_html_notes.py
@@ -1,11 +1,12 @@
 #!/usr/bin/python3
 # -*- coding: utf-8 -*-
-
-# clean-notes: sort and clean the notes stored in notes.git
+#
 # Copyright © 2015 Mattia Rizzolo <mattia@mapreri.org>
 # Licensed under GPL-2+
 #
 # Depends: python3 python3-yaml
+#
+# Build html pages based on the content of the notes.git repository
 
 import yaml
 from reproducible_common import *
diff --git a/bin/reproducible_html_packages.py b/bin/reproducible_html_packages.py
index 097ba718..f4351797 100755
--- a/bin/reproducible_html_packages.py
+++ b/bin/reproducible_html_packages.py
@@ -1,11 +1,12 @@
 #!/usr/bin/python3
 # -*- coding: utf-8 -*-
-
-# clean-notes: sort and clean the notes stored in notes.git
+#
 # Copyright © 2015 Mattia Rizzolo <mattia@mapreri.org>
 # Licensed under GPL-2+
 #
 # Depends: python3
+#
+# Build rb-pkg pages (the pages that describe the package status)
 
 
 from reproducible_common import *
@@ -99,7 +100,7 @@ def gen_extra_links(package, version):
     else:
         log.debug('buildinfo not detected at ' + buildinfo)
     return (links, default_view)
- 
+
 
 def process_packages(packages):
     """
@@ -113,7 +114,7 @@ def process_packages(packages):
         status, version, build_date = check_package_status(pkg)
         log.info('Generating the page of ' + pkg + ' ' + version +
                  ' builded at ' + build_date)
-        
+
         rbuild = RBUILD_PATH + '/' + pkg + '_' + version + '.rbuild.log'
         links, default_view = gen_extra_links(pkg, version)