aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorEli Schwartz <eschwartz@archlinux.org>2022-03-08 21:33:40 -0500
committerEli Schwartz <eschwartz@archlinux.org>2022-03-08 21:34:39 -0500
commit7cc4ca2cbb38360743f1d56a5a709bbd51b53ad6 (patch)
treedfc772753ff9031b02dd3ee951472d9c74a9a09b /docs
parentf5176f01b9e0e9623a749082b556ed7d87ce74dd (diff)
downloadmeson-7cc4ca2cbb38360743f1d56a5a709bbd51b53ad6.zip
meson-7cc4ca2cbb38360743f1d56a5a709bbd51b53ad6.tar.gz
meson-7cc4ca2cbb38360743f1d56a5a709bbd51b53ad6.tar.bz2
Revert "Add new env2cross command."
This reverts commit e257a870fe5e676c55a2282b0e7fc9be34bba2ac. The PR adding this command had infinitely hanging CI, and now that it is merged to master we cannot get any CI on any PR to succeed.
Diffstat (limited to 'docs')
-rw-r--r--docs/markdown/snippets/env2cross.md40
1 files changed, 0 insertions, 40 deletions
diff --git a/docs/markdown/snippets/env2cross.md b/docs/markdown/snippets/env2cross.md
deleted file mode 100644
index bb53145..0000000
--- a/docs/markdown/snippets/env2cross.md
+++ /dev/null
@@ -1,40 +0,0 @@
-## Experimental command to convert environments to cross files
-
-Meson has a new command `env2mfile` that can be used to convert
-"environment variable based" cross and native compilation environments
-to Meson machine files. This is especially convenient for e.g. distro
-packagers so they can easily generate unambiguous configuration files
-for packge building.
-
-As an example here's how you would generate a cross file that takes
-its settings from the `CC`, `CXX`, `CFLAGS` etc environment variables.
-
- meson env2mfile --cross --system=baremetal --cpu=armv7 --cpu-family=arm -o armcross.txt
-
-The command also has support for generating Debian build files using
-system introspection:
-
- meson env2mfile --cross --debarch armhf -o debarmhf_cross.txt
-
-Note how you don't need to specify any system details, the command
-gets them transparently via `dpkg-architecture`.
-
-Creating a native file is done in the same way:
-
- meson env2mfile --native -o current_system.txt
-
-This system will detect if the `_FOR_BUILD` environment variables are
-enabled and then uses them as needed.
-
-With this you should be able to convert any envvar-based cross build
-setup to cross and native files and then use those. Thit means, among
-other things, that you can then run your compilations from any shell,
-not just the special one that has all the environment variables set.
-
-As this functionality is still a bit in flux, the specific behaviour
-and command line arguments to use are subject to change. Because of
-this the main documentation has not yet been updated.
-
-Please try this for your use cases and report to us if it is working.
-Patches to make the autodetection work on other distros and platforms
-are also welcome.