Convert README to README.md

1 files changed, 38 insertions, 7 deletions

diff --git a/README b/README.md
index 3b49272..d7011b6 100644
--- a/README
+++ b/README.md
@@ -1,16 +1,16 @@
-cairomm
--------
+# cairomm
 This library provides a C++ interface to cairo.
 See https://www.cairographics.org/cairomm/
 
 See the examples directory for example code.
 
 Use pkg-config to discover the necessary include and linker arguments. For instance,
+```
   pkg-config cairomm-1.0 --cflags --libs
+```
 If you build with Autotools, ideally you would use PKG_CHECK_MODULES in your
 configure.ac file.
 
-
 # Building
 
 Whenever possible, you should use the official binary packages approved by the
@@ -23,8 +23,10 @@ See MSVC_NMake/README
 ## Building from a release tarball
 
 Extract the tarball and go to the extracted directory:
+```
   $ tar xf cairomm-@CAIROMM_VERSION@.tar.xz
   $ cd cairomm-@CAIROMM_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.
@@ -38,31 +40,46 @@ 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
 
@@ -70,8 +87,9 @@ Building from git can be difficult so you should prefer building from
 a release tarball unless you need to work on the cairomm 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
 
@@ -79,24 +97,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
+```