Sugar Control Panel

From OLPC
Revision as of 08:43, 1 November 2007 by Erikos (talk | contribs) (Initial import of the sugar-control-panel)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Sugar Control Panel

A control panel will be used to set user preferences like nick name or color on the XO. At the moment this will be a command line tool in which you can access the settings. The requirements for the panel are listed here: [1] The bold ones are those that have been implemented for the command line version of the panel. The following section will describe how to use the sugar-control-panel on the XO.

Usage

Open the terminal activity and type the following command to display the help information for the control panel.

sugar-control-panel -h

will display:

Usage: sugar-control-panel [ option ] key [ args ... ] 
   Control for the sugar environment. 
   Options: 
   -h           show this help message and exit 
   -l           list all the available options 
   -h key       show information about this key 
   -g key       get the current value of the key 
   -s key       set the current value for the key 

The control panel tries to be as self-explanatory as possible. We will go through a typical scenario to show the basic usage. We want to set the jabber server on the XO in order to do testing with an sugar-jhbuild instance. To list all the available commands do:

sugar-control-panel -l

At the moment this will give you something like this:

[erikos@localhost sugar]$ sugar-control-panel -l
color
jabber
language
nick
radio
timezone

To know what the current value of a key is use the -g option:

[erikos@localhost sugar]$ sugar-control-panel -g jabber
jabber.laptop.org

Not sure what to set now do you can use the -h option for each key to display the help for a command:

[erikos@localhost sugar]$ sugar-control-panel -h jabber
Set the jabber server
    server : e.g. 'olpc.collabora.co.uk'

To change the jabber server now use the -s option.

[erikos@localhost sugar]$ sugar-control-panel -s jabber olpc.collabora.co.uk
To apply your changes you have to restart sugar.
Hit at the same time ctrl+alt+erase on the keyboard to do this.

Some of the options require restarting sugar.