diff --git a/LICENSE b/LICENSE
index ef7e252..eb89d5a 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,3 +1,5 @@
+Copyright © 2017 openSUSE Project
+
 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions
 are met:
@@ -9,9 +11,9 @@ are met:
    notice, this list of conditions and the following disclaimer in the
    documentation and/or other materials provided with the distribution.
  
-3. Neither the name of Novell nor the names of its contributors may
-   be used to endorse or promote products derived from this software
-   without specific prior written permission.
+3. Neither the name of the copyright holder nor the names of its 
+   contributors may be used to endorse or promote products derived from 
+   this software without specific prior written permission.
 
 THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
diff --git a/macros.hpc b/macros.hpc
index 41f8304..8434843 100644
--- a/macros.hpc
+++ b/macros.hpc
@@ -416,12 +416,23 @@ The package %{n_name}%{_p_ext} provides the dependency to get the latest version
 %_hpc_python_sysconfig_path() %(%1 -c "import sysconfig as s; \\\
      print(s.get_paths(%{?3:vars={'platbase':\\"%3\\", 'base' : \\"%3\\"}}).get('%2'));")
 
+# get the python version specific directory for arch specific files in the HPC
+# directory structure.
 %hpc_python_sitearch %{_hpc_python_sysconfig_path %python_flavor platlib %{?hpc_prefix}}
 
 %_hpc_python_ver() %(%1 -c "import sys as s;print(s.version[:3]);")
 
+# get the (abbreviated_) pythin version used for package and directory names.
 %hpc_python_version %{_hpc_python_ver %python_flavor}
 
+# %{hpc_python_master_package [-n <package_name>] [-g <group>] [-l][-L][-a]}
+# -n: specify a package name
+# -g: specify a group name
+# -l: mark the package as library package
+# -L: (for environment modules) create a link from the
+#    `.version.<version_no>` file  to the `.version`-file to
+#     mark the default version.
+# -a: mark package as architecture dependent
 %hpc_python_master_package(n:g:lLa) \
 %{?_python_macro_init} \
 %{lua: \
@@ -483,6 +494,7 @@ The package %{n_name}%{_p_ext} provides the dependency to get the latest version
 #
 # man pages
 #
+# %{hpc_compress_man <num>} compress man page in %hpc_mandir/man<num>
 %hpc_compress_man() \
      [ -n "%{*}" ] || { echo "no man page list!" >&2 ; exit 1; } \
      for j in %{*}; do \
diff --git a/suse-hpc.changes b/suse-hpc.changes
index 91e4ab6..6102fc0 100644
--- a/suse-hpc.changes
+++ b/suse-hpc.changes
@@ -1,3 +1,9 @@
+-------------------------------------------------------------------
+Wed Oct  4 08:15:18 UTC 2017 - eich@suse.com
+
+- Add more documentation.
+- Fix LICENSE and copyright statement in LICENSE.
+
 -------------------------------------------------------------------
 Thu Sep 21 15:10:29 UTC 2017 - nmoreychaisemartin@suse.com