[glibmm/glibmm-2-66] Convert README to README.md
- From: Kjell Ahlstedt <kjellahl src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [glibmm/glibmm-2-66] Convert README to README.md
- Date: Mon, 12 Sep 2022 14:06:29 +0000 (UTC)
commit 09c721e0d2d7a56295b9e2928485b7c685ebdbc0
Author: Kjell Ahlstedt <kjellahlstedt gmail com>
Date: Mon Sep 12 16:03:39 2022 +0200
Convert README to README.md
README => README.md | 40 ++++++++++++++++++++++++++++++++++++----
1 file changed, 36 insertions(+), 4 deletions(-)
---
diff --git a/README b/README.md
similarity index 90%
rename from README
rename to README.md
index f13cd66a..c3d5e47d 100644
--- a/README
+++ b/README.md
@@ -1,3 +1,4 @@
+# glibmm
This is glibmm, a C++ API for parts of glib that are useful for C++.
See http://www.gtkmm.org
@@ -13,8 +14,10 @@ See README.win32
## Building from a release tarball
Extract the tarball and go to the extracted directory:
+```
$ tar xf glibmm-@GLIBMM_VERSION tar xz
$ cd glibmm-@GLIBMM_VERSION@
+```
It's easiest to build with Meson, if the tarball was made with Meson,
and to build with Autotools, if the tarball was made with Autotools.
@@ -28,31 +31,46 @@ other subdirectories of untracked/.
Don't call the builddir 'build'. There is a directory called 'build' with
files used by Autotools.
-
+```
$ meson --prefix /some_directory --libdir lib your_builddir .
$ cd your_builddir
+```
If the tarball was made with Autotools, you must enable maintainer-mode:
+```
$ meson configure -Dmaintainer-mode=true
+```
Then, regardless of how the tarball was made:
+```
$ ninja
$ ninja install
+```
You can run the tests like so:
+```
$ ninja test
+```
### Building from a tarball with Autotools
If the tarball was made with Autotools:
+```
$ ./configure --prefix=/some_directory
+```
If the tarball was made with Meson, you must enable maintainer-mode:
+```
$ ./autogen.sh --prefix=/some_directory
+```
Then, regardless of how the tarball was made:
+```
$ make
$ make install
+```
You can build the examples and tests, and run the tests, like so:
+```
$ make check
+```
## Building from git
@@ -60,8 +78,9 @@ Building from git can be difficult so you should prefer building from
a release tarball unless you need to work on the glibmm code itself.
jhbuild can be a good help
- https://gitlab.gnome.org/GNOME/jhbuild
- https://wiki.gnome.org/Projects/Jhbuild
+- https://gitlab.gnome.org/GNOME/jhbuild
+- https://wiki.gnome.org/Projects/Jhbuild
+- https://gnome.pages.gitlab.gnome.org/jhbuild
### Building from git with Meson
@@ -69,24 +88,37 @@ Maintainer-mode is enabled by default when you build from a git clone.
Don't call the builddir 'build'. There is a directory called 'build' with
files used by Autotools.
-
+```
$ meson --prefix /some_directory --libdir lib your_builddir .
$ cd your_builddir
$ ninja
$ ninja install
+```
You can run the tests like so:
+```
$ ninja test
+```
You can create a tarball like so:
+```
$ ninja dist
+```
### Building from git with Autotools
+```
$ ./autogen.sh --prefix=/some_directory
$ make
$ make install
+```
You can build the examples and tests, and run the tests, like so:
+```
$ make check
+```
You can create a tarball like so:
+```
$ make distcheck
+```
or
+```
$ make dist
+```
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]