changeset 591:1b48ec3d6489

Add file "BUILDING.txt" with some notes now to build and/or distribute
author Franz Glasner <fzglas.hg@dom66.de>
date Sun, 09 Jan 2022 15:42:05 +0100
parents 91e74fb1ea90
children eae394e86e22
files BUILDING.txt
diffstat 1 files changed, 37 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/BUILDING.txt	Sun Jan 09 15:42:05 2022 +0100
@@ -0,0 +1,37 @@
+.. -*- coding: utf-8 -*-
+
+BUILDING
+==========
+
+1. hg kwarchive __arch
+2. cd __arch
+3. Build the documentation. E.g. with
+
+       (cd docs && gmake html)
+
+   The documentation currently has to be built when the _speedups C extension
+   module is *not* available.
+
+4. python setup.py sdist
+
+5. python setup.py bdist_wheel --pure-only
+
+6. Optional: python setup.py bdist_wheel
+
+7. Binary package for Winwows:
+
+   a) Make the Ninja build-file for your system:
+
+        sh windows-dev/pc01/cross.sh
+
+   b) Cross-compile with:
+
+        ninja -f _build-win-amd64.ninja
+
+      Needs currently LLVM-11.
+
+   c) Make the resulting DLL available to setup.py:
+
+        cd configmix && ln -s ../build/_builddir-win-amd64/out/_speedups.pyd _speedups.pyd
+
+   d) python setup.py bdist_wheel --windows-cross-pack -p win_amd64