Red Hat Bugzilla – Bug 746553
SPICE is undocumented
Last modified: 2012-06-02 15:03:22 EDT
Description of problem:
I don't know how to use SPICE, and I can't find any information from Fedora.
Version-Release number of selected component (if applicable):
My process is as follows:
[pete@thefool ~]$ man spicec
No manual entry for spicec
[pete@thefool ~]$ help spicec
bash: help: no help topics match `spice'. Try `help help' or `man -k spice' or `info spice'.
[pete@thefool ~]$ spicec --help
spicec - Spice client
spice client version
Now I know how spicec likes options passed to it. What am I connecting to? how do I configure spice-server?
[pete@thefool ~]$ yum info spice-server
(package overview, no usage info, but there is a url for spice-space.org where I can download .pdf documentation - this will help, but it really isn't optimal...)
so, I run a query with my search engine of choice:
Your search - site:http://docs.fedoraproject.org/en-US/index.html SPICE - did not match any documents.
Nothing at all for documentation.
I don't have a RHEL installation, but I did check my Centos6 VM host whose guests I'm trying to connect to with spicec - nothing there either.
man qemu | less +/spice
That helps a bit, sure. For what it's worth, the changelogs in /usr/share are more revealing than anything. I'm still failing with spicec, and the program itself isn't verbose enough to help me, but I think I've made that point to my satisfaction. I'm going to see about improving the fp.o documentation on this - the bug report as a feature request, I don't want it to turn into a support ticket.
I don't see any reason to keep this bug open. The issues I experienced at the time of reporting that had me searching for documentation were specific to my implementation, and have since been resolved. With the extraneous factors accounted for, spicec is functioning as expected.