Update NEWS for v0.9.5
[quvi-tool.git] / README
blob8869ff6e5fc21bb86fe236eb02e5b6c81fc2d495
1 General
2 =======
4 quvi is the command line tool for developing the libquvi scripts and
5 parsing the media properties.
7 gitweb: <http://repo.or.cz/w/quvi-tool.git>
8 Home  : <http://quvi.sourceforge.net/>
11 Installation
12 ============
14 Notes
15 -----
17   * This document does not cover how to use GNU Autotools for building
18 and installing software, instead, refer to the GNU Autotools documentation,
19 the INSTALL file and the "configure --help" output for more information.
21   * If you're not familiar with GNU Autotools and/or installing software
22 from the source code, you may prefer to install quvi using a binary
23 package, instead. You can find quvi packaged for many distros already.
25   * If you have previously installed quvi from the source code to your
26 system, the recommended practice is to uninstall the previous installation
27 first, before you continue with the new one. You would, typically, run
28 "make uninstall" (as root if necessary) from the same directory you ran
29 "make install" from.
31   * If you are building quvi from the git repository code, run the
32 `bootstrap.sh' first. This generates the configuration files. See also
33 the -h output for any additional info.
36 Simple install procedure
37 ------------------------
39   % ./configure && make
41   [ Become root if necessary ]
42   % make install
44 The configure script supports also the following options which are
45 relevant to the installation:
47   --with(out)-manual
49     Install the manual page for quvi.
51 Requirements
52 ------------
54 * libquvi 0.9
55   http://quvi.sourceforge.net/
57 * libcurl 7.21.0
58   http://curl.haxx.se/
59     $ sudo aptitude install libcurl4-gnutls-dev
60        (or libcurl4-openssl-dev)
62 * GLib 2.24.2
63   http://library.gnome.org/devel/glib/
64     $ sudo aptitude install libglib2.0-dev
66 * JsonGlib 0.12
67   http://live.gnome.org/JsonGlib
68   NOTE: builds without: JSON output will be disabled
69     $ sudo aptitude install libjson-glib-dev
71 * libxml 2.7.8
72   http://www.xmlsoft.org/
73   NOTE: builds without: XML output will be disabled
74     $ sudo aptitude install libxml2-dev
76 * pkg-config for tracking the compilation flags needed for libraries
77   http://www.freedesktop.org/software/pkgconfig/
79 * GNU gettext is recommended
80   http://www.gnu.org/software/gettext/
82 * GNU make is recommended
83   http://www.gnu.org/software/make/
86 How to report bugs
87 ==================
89 Please see: http://quvi.sourceforge.net/#bugs
92 Patches
93 =======
95 Please see: http://quvi.sourceforge.net/contrib/
98 License
99 =======
101 quvi is Free Software, licensed under the GNU Affero GPLv3+.