|author||Daniel P. Berrange <email@example.com>||2012-01-10 13:29:14 +0000|
|committer||Alon Levy <firstname.lastname@example.org>||2012-01-13 18:11:58 +0200|
Improve usefulness of README file
The COPYING file already contains the license text, so the README file need not repeat it. Instead put in a description of what SPICE is, simple install instructions & pointers to mailing lists and bug trackers
Diffstat (limited to 'README')
1 files changed, 77 insertions, 9 deletions
@@ -1,14 +1,82 @@
-Copyright 2009 Red Hat, Inc. and/or its affiliates.
+ SPICE: Simple Protocol for Independent Computing Environments
-This program and libraries is free software; you can redistribute it
-and/or modify it under the terms of the GNU Lesser General Public
+SPICE is a remote display system built for virtual environments which
+allows you to view a computing 'desktop' environment not only on the
+machine where it is running, but from anywhere on the Internet and
+from a wide variety of machine architectures.
+The SPICE package uses GNU autotools, so the build install process
+follows the standard process documented in the INSTALL file. As a
+quick start you can do
+ ./configure --prefix=/usr --sysconfdir=/etc \
+ --localstatedir=/var --libdir=/usr/lib
+ sudo make install
+Or to install into a private user specific location
+ ./configure --prefix=$HOME/spice
+ make install
+The following mandatory dependancies are required in order to
+ Spice protocol >= 0.9.0
+ Celt >= 0.5.1.1, < 0.6.0
+ Pixman >= 0.17.7
+The following optional dependancies increase the available
+ GE Gui >= 0.6.0, < 0.7.0 (GUI app support)
+ OpenGL (GUI app support)
+ Alsa (Linux support)
+ XRandR >= 1.2 (X11 support)
+ Xinerama >= 1.0 (X11 support)
+ libcacard >= 0.1.2 (Smartcard support)
+ Slirp (Tunnelling support)
+To communicate with the development team, or to post patches
+there is a technical mailing list:
+There is also a mailing list for new release announcements:
+To view known bugs, or report new bugs, in SPICE visit
+Bugs found when using an OS distribution's binary packages should
+be reported to the OS vendors' own bug tracker first.
+The latest SPICE code can be found in GIT at:
+SPICE is provided under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
-This library is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
-Lesser General Public License for more details.
+Please see the COPYING file for the complete LGPLv2+ license
+terms, or visit <http://www.gnu.org/licenses/>.
-You should have received a copy of the GNU Lesser General Public
-License along with this library; if not, see <http://www.gnu.org/licenses/>.
+-- End of readme