Refine README about performing make-dist.py on workstation

This should avoid confusion when trying to update pyi2ncommon.

diff --git a/README b/README
index bd6eaa6..2effea8 100644 (file)
--- a/README
+++ b/README
@@ -11,3 +11,12 @@ API documentation: see doc/about_docu.rst
 To build an rpm package, run:
 
   make_dist.py
+
+This needs to be performed using the same python version as the
+one that the rpm will be installed to. Therefore, if you build
+for QA, you should run this on your workstation, not your
+intradev.
+
+Note, that this will create directories "dist" inside the
+pyi2ncommon dir, and "rpmbuild" in your home directory (if they
+do not exist, already).
\ No newline at end of file

diff --git a/doc/index.rst b/doc/index.rst
index 0e42495..d470747 100644 (file)
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -7,7 +7,7 @@ Welcome to pyi2ncommon's documentation!
 =======================================
 
 This library has two main purposes:
-  (1) provide an interface to external python code (i.e., code not running
+  (1) provide an interface for external python code (i.e., code not running
       inside a Intra2net system, most notably QA tests) to some of the internal
       workings of Intra2net systems. This includes:
          - the configuration system (module :py:mod:`pyi2ncommon.cnfvar`)

diff --git a/make_dist.py b/make_dist.py
index 17de73b..bf6c8a7 100755 (executable)
--- a/make_dist.py
+++ b/make_dist.py
@@ -6,6 +6,11 @@ Create source tarball, create rpm from it together with spec file.
 Create a source tarball that is compatible with standard build pipelines. Then
 run rpmbuild on it to create an installable rpm.
 
+The python version, that was used to build the rpm, determines the target paths
+of the rpm (e.g. if building with version 3.13, then the rpm will install its
+files to /usr/lib/python3.13/site-packages). Therefore, rpm building must be
+executed on an appropriate platform.
+
 .. codeauthor:: Intra2net AG <info@intra2net.com>
 """