From d6c31a697003368e642beb29466ba5953f6e6163 Mon Sep 17 00:00:00 2001 From: "Daniel P. Berrange" Date: Tue, 10 Jan 2012 13:29:14 +0000 Subject: 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 --- README | 86 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++------- 1 file changed, 77 insertions(+), 9 deletions(-) (limited to 'README') diff --git a/README b/README index a6596d80..a27dc061 100644 --- a/README +++ b/README @@ -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. + +Installation +------------ + +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 + make + sudo make install + +Or to install into a private user specific location + + ./configure --prefix=$HOME/spice + make + make install + +The following mandatory dependancies are required in order to +build SPICE + + Spice protocol >= 0.9.0 + Celt >= 0.5.1.1, < 0.6.0 + Pixman >= 0.17.7 + OpenSSL + libjpeg + zlib + Cyrus-SASL + +The following optional dependancies increase the available +functionality + + 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) + +Communication +------------- + +To communicate with the development team, or to post patches +there is a technical mailing list: + + http://lists.freedesktop.org/mailman/listinfo/spice-devel + +There is also a mailing list for new release announcements: + + http://lists.freedesktop.org/archives/spice-announce/ + +To view known bugs, or report new bugs, in SPICE visit + + https://bugs.freedesktop.org/describecomponents.cgi?product=Spice + +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: + + http://cgit.freedesktop.org/spice/ + +Licensing +--------- + +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 . -You should have received a copy of the GNU Lesser General Public -License along with this library; if not, see . +-- End of readme -- cgit