annotate BUILDING.txt @ 654:0d6673d06c2c

Add support for using "tomllib" (in Python's stdlib since 3.11) and "tomli" TOML packages. They are preferred if they are found to be installed. But note that the declared dependency for the "toml" extra nevertheless is the "toml" package. Because it is available for all supported Python versions. So use Python 3.11+ or install "tomli" manually if you want to use the alternate packages.
author Franz Glasner <fzglas.hg@dom66.de>
date Thu, 19 May 2022 22:10:59 +0200
parents e8ff899c363c
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
591
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
1 .. -*- coding: utf-8 -*-
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
2
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
3 BUILDING
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
4 ==========
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
5
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
6 1. hg kwarchive __arch
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
7 2. cd __arch
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
8 3. Build the documentation. E.g. with
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
9
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
10 (cd docs && gmake html)
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
11
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
12 The documentation currently has to be built when the _speedups C extension
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
13 module is *not* available.
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
14
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
15 4. python setup.py sdist
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
16
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
17 5. python setup.py bdist_wheel --pure-only
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
18
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
19 6. Optional: python setup.py bdist_wheel
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
20
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
21 7. Binary package for Winwows:
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
22
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
23 a) Make the Ninja build-file for your system:
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
24
621
e8ff899c363c FIX: Hostname in BUILDING
Franz Glasner <f.glasner@feldmann-mg.com>
parents: 591
diff changeset
25 sh windows-dev/pc03/cross.sh
591
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
26
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
27 b) Cross-compile with:
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
28
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
29 ninja -f _build-win-amd64.ninja
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
30
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
31 Needs currently LLVM-11.
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
32
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
33 c) Make the resulting DLL available to setup.py:
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
34
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
35 cd configmix && ln -s ../build/_builddir-win-amd64/out/_speedups.pyd _speedups.pyd
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
36
1b48ec3d6489 Add file "BUILDING.txt" with some notes now to build and/or distribute
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
37 d) python setup.py bdist_wheel --windows-cross-pack -p win_amd64