From baa9eeebe4915ac192cdb31dbcbf11383e380572 Mon Sep 17 00:00:00 2001 From: Xavier Claessens Date: Tue, 27 Oct 2020 23:03:53 -0400 Subject: dist: Allow packaging subproject in same git repo as main project --- docs/markdown/Creating-releases.md | 18 ++++++++++++++++++ docs/markdown/snippets/dist_subproject.md | 16 ++++++++++++++++ 2 files changed, 34 insertions(+) create mode 100644 docs/markdown/snippets/dist_subproject.md (limited to 'docs') diff --git a/docs/markdown/Creating-releases.md b/docs/markdown/Creating-releases.md index 040fb530a..55242a641 100644 --- a/docs/markdown/Creating-releases.md +++ b/docs/markdown/Creating-releases.md @@ -58,3 +58,21 @@ for example when done in CI that already does its own testing. So with `--no-tests` you can tell Meson "Do not build and test generated packages.". +## Release a subproject separately + +*Since 0.57.0* the `meson dist` command can now create a distribution tarball +for a subproject in the same git repository as the main project. This can be +useful if parts of the project (e.g. libraries) can be built and distributed +separately. In that case they can be moved into `subprojects/mysub` and running +`meson dist` in that directory will now create a tarball containing only the +source code from that subdir and not the rest of the main project or other +subprojects. + +For example: +```sh +git clone https://github.com/myproject +cd myproject/subprojects/mysubproject +meson builddir +meson dist -C builddir +``` +This produces `builddir/meson-dist/mysubproject-1.0.tar.xz` tarball. diff --git a/docs/markdown/snippets/dist_subproject.md b/docs/markdown/snippets/dist_subproject.md new file mode 100644 index 000000000..2520ccdab --- /dev/null +++ b/docs/markdown/snippets/dist_subproject.md @@ -0,0 +1,16 @@ +## Package a subproject + +The `meson dist` command can now create a distribution tarball for a subproject +in the same git repository as the main project. This can be useful if parts of +the project (e.g. libraries) can be built and distributed separately. In that +case they can be moved into `subprojects/mysub` and running `meson dist` in that +directory will now create a tarball containing only the source code from that +subdir and not the rest of the main project or other subprojects. + +For example: +```sh +git clone https://github.com/myproject +cd myproject/subprojects/mysubproject +meson builddir +meson dist -C builddir +``` -- cgit v1.2.3