aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorGuido Günther <agx@sigxcpu.org>2017-02-02 17:08:11 +0100
committerGuido Günther <agx@sigxcpu.org>2017-02-02 17:08:11 +0100
commitb4747c0f9e4f815c85359bd2bdab333b5c1191b1 (patch)
tree8c9dfaf7fff90e6cfc3a1f9a483ef697d1f1da77 /README.md
parentec8418734c0f69d922075fbfb22f2814d67351df (diff)
Make it render nicely in cgit
Diffstat (limited to 'README.md')
-rw-r--r--README.md31
1 files changed, 31 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e54b001
--- /dev/null
+++ b/README.md
@@ -0,0 +1,31 @@
+Libplanfahr is a GObject based library to query public transport inforation. It
+(in principle) supports different providers although at the moment only one is
+implemented. It features GObject introspection so you can use it from languages
+like JavaScript and Python.
+
+The API is by no means stable yet.
+
+It depends on glib, libsoup, libxml2, gnome-common and gtk-doc-tools:
+
+ apt-get install libsoup2.4-dev libglib2.0-dev libxml2-dev libgirepository1.0-dev \
+ gnome-common gtk-doc-tools
+
+To build from source use:
+
+ ./autogen.sh
+ ./configure
+ make
+
+To install use
+
+ make install
+
+To run from the compiled source code use
+
+ ./run <program>
+
+for example
+
+ ./run python3 examples/trip-query.py Gelsenkirchen Essen
+
+If you want to contribute to libplanfahr see the HACKING document.