Changes

=== Required packages ===

=== Required packages ===

At first, install PackageKit related packages. The following command will install two Polkit authentication agents, one for Gnome session (if you start sugar emulator from Gnome Desktop Environment) and LXPolkit that will be used from Sugar session.

First, install PackageKit related packages. The following command will install two Polkit authentication agents, one for Gnome session (if you start sugar emulator from Gnome Desktop Environment) and LXPolkit that will be used from Sugar session.

Fedora specific instructions:

Fedora specific instructions:

  sh installer.sh

  sh installer.sh

Relogin from X session to take into account new PATH environment variable value.

Relogin from X session to take into account the new PATH environment variable value.

=== Sources install ===

=== Sources install ===

== Usage ==

== Usage ==

Read the [[Platform_Team/Sweets/Glossary|Sweets Glossary]] to understand the basic conception. The rest of the text will operate with following terms:

Read the [[Platform_Team/Sweets/Glossary|Sweets Glossary]] to understand the basic concept (and [[Platform_Team/Infrastructure|overview]] of the bigger picture). The rest of the text will operate with the following terms:

* {{Code|SWEET}}, the full ''interface'' url, like {{Code|http://sweets.sugarlabs.org/sdk/sugar}}, or the short one, like {{Code|sdk/sugar}};

* {{Code|SWEET}}, the full ''interface'' url, like {{Code|http://sweets.sugarlabs.org/sdk/sugar}}, or the short one, like {{Code|sdk/sugar}};

* {{Code|COMMAND}}, ''sweet'''s command that points how to run particular ''sweet''; by default, ''sweet''s have only {{Code|run}} command but it is possible to have several commands;

* {{Code|COMMAND}}, ''sweet'''s command that indicates how to run a particular ''sweet''; by default, ''sweet''s have only the {{Code|run}} command but it is possible to have several commands;

* {{Code|VERSION}}, ''sweet'''s version

* {{Code|VERSION}}, ''sweet'''s version

See the [[#Sugar_via_Sweets|Sugar via Sweets]] section for real examples how use ''Sweets'' to run Sugar Shell.

See the [[#Sugar_via_Sweets|Sugar via Sweets]] section for real examples of how to use ''Sweets'' to run Sugar Shell.

=== Launch ===

=== Launch ===

To launch a ''sweet'' with verbatim passing optional {{Code|ARGUMENTS}}:

To launch a ''sweet'' with verbatim passing of optional {{Code|ARGUMENTS}}:

  sweets SWEET [ARGUMENTS]

  sweets SWEET [ARGUMENTS]

Sometimes ''sweet''s support several launching command, it is possible to specify one during the launch:

Sometimes ''sweet''s support several launching commands; it is possible to specify one during the launch:

  sweets SWEET:COMMAND

  sweets SWEET:COMMAND

To run particular, not the latest, version:

To run a particular, but not the latest, version:

  sweets SWEET[''=''|''>=''|''<=''VERSION]

  sweets SWEET[''=''|''>=''|''<=''VERSION]

  sweets status SWEET -v

  sweets status SWEET -v

To get information, e.g., a list of supported commands, about already known sweet:

To get information, e.g., a list of supported commands, about an already known sweet:

  sweets show SWEET

  sweets show SWEET

=== Troubleshooting ===

=== Troubleshooting ===

If {{Code|sweets}} can't find proper ''implementation'', see the {{Code|e}} lines in the output of:

If {{Code|sweets}} can't find a proper ''implementation'', see the {{Code|e}} lines in the output of:

  sweets status SWEET -vdd

  sweets status SWEET -vdd

=== Search ===

=== Search ===

It is possible to search ''sweet''s among locally known ones and registered on http://sweets.sugarlabs.org (not yet implemented). The search is based on [http://xapian.org/ Xapian] search engine. Thus, it is possible to use Xapian's [http://xapian.org/docs/queryparser.html query language].

It is possible to search ''sweet''s among locally known ones and those registered on http://sweets.sugarlabs.org (not yet implemented). The search is based on [http://xapian.org/ Xapian] search engine. Thus, it is possible to use Xapian's [http://xapian.org/docs/queryparser.html query language].

For command format is:

For command format is: