Sugar Control Panel: Difference between revisions

From OLPC
Jump to navigation Jump to search
(Initial import of the sugar-control-panel)
 
(typos, links, grammar)
Line 1: Line 1:
A control panel will be used to set user preferences like nickname 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 [[Requirements | here]]. The bold ones are those that
= 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: [http://wiki.laptop.org/go/Requirements] 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.
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 ==
== Usage ==
Open the terminal activity and type the following command to display the help information for the control panel.
Open the [[Terminal]] activity and type the following command to display the help information for the control panel.
sugar-control-panel -h
sugar-control-panel -h
Line 21: Line 19:


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
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:
commands, do:


sugar-control-panel -l
sugar-control-panel -l
Line 35: Line 33:
timezone
timezone


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


[erikos@localhost sugar]$ sugar-control-panel -g jabber
[erikos@localhost sugar]$ sugar-control-panel -g jabber
jabber.laptop.org
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:
If you are not sure what to set, you can use the -h option for each key to display the help for a command:


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


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


Some of the options require restarting sugar.
Some of the options require restarting Sugar.

Revision as of 14:40, 1 November 2007

A control panel will be used to set user preferences like nickname 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. 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 display what the current value of a key is, use the -g option:

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

If you are not sure what to set, 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, 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.