[packagekit] First Patch

[Richard Hughes]

On Fri, 2009-02-13 at 22:25 +0530, "G" wrote:
> Hi 
> 
> Please find the patch file attached which contains some changes in the
> pk-introduction.xml file.  

Cool, cheers for working on the docs.

> Do let me know your comments on the same.
> --- a/docs/api/spec/pk-introduction.xml
> +++ b/docs/api/spec/pk-introduction.xml
> @@ -94,6 +94,16 @@
>          <literal>--default-backend=</literal> configure setting.
>        </para>
>      </sect2>
> +    <sect2 id="config-main-default">
> +      <title>BackendSpawnNiceValue</title>
> +      <para>
> +        Set the priority of the spawned backend to this priority.
> +       This ensures the process does not hog the system when

You want the same number of indent spaces.

>  performing actions.
> +       Values range from -20 (most favorable) to 19 (least favorable)
> +       A niceness value of 0 will not attempt to set any priority.
> +       default = 10
> +      </para>

What does this parameter actually mean? The geeky text in
PackageKit.conf is okay, but I would rather have:

A nice value of 19 will put any other task first, and will make
PackageKit perform actions more slowly. It will not however slow down
other tasks on the computer. A value of -20 will make PackageKit very
fast, but will interrupt other programs. This is not recommended.

You see? We've taken what "nice" is and made it clear to the end user.
It's good to do a bit of research about what option actually does.

Anyway, this is better than nothing, so please could you send me
(offlist) your RSA SSH public key, and your chosen username for the
server, and I'll add you to committers.

Thanks,

Richard.