[Yum-devel] [PATCH 2/3] Add docs for update-to/upgrade-to, and explain update/upgrade behaviour.

[tim.lauridsen at gmail.com]

On Thu, Mar 31, 2011 at 12:01 AM, James Antill <james at and.org> wrote:

> ---
>  docs/yum.8 |   18 ++++++++++++++++++
>  1 files changed, 18 insertions(+), 0 deletions(-)
>
> diff --git a/docs/yum.8 b/docs/yum.8
> index 0f1b1ba..39c7253 100644
> --- a/docs/yum.8
> +++ b/docs/yum.8
> @@ -23,10 +23,14 @@ gnome\-packagekit application\&.
>  .br
>  .I \fR * update [package1] [package2] [\&.\&.\&.]
>  .br
> +.I \fR * update-to [package1] [package2] [\&.\&.\&.]
> +.br
>  .I \fR * check\-update
>  .br
>  .I \fR * upgrade [package1] [package2] [\&.\&.\&.]
>  .br
> +.I \fR * upgrade-to [package1] [package2] [\&.\&.\&.]
> +.br
>  .I \fR * distribution-synchronization [package1] [package2] [\&.\&.\&.]
>  .br
>  .I \fR * remove | erase package1 [package2] [\&.\&.\&.]
> @@ -112,6 +116,16 @@ If the main obsoletes configure option is true
> (default) or the \-\-obsoletes
>  flag is present \fByum\fP will include package
>  obsoletes in its calculations - this makes it better for distro\-version
>  changes, for example: upgrading from somelinux 8.0 to somelinux 9.
> +
> +Note that "\fBupdate\fP" works on installed packages first, and only if
> there
> +are no matches does it look for available packages. The difference is most
> +noticable when you do "\fBupdate\fP foo-1-2" which will act exactly as
> +"\fBupdate\fP foo" if foo-1-2 is installed. You can use the
> "\fBupdate-to\fP"
> +if you'd prefer that nothing happen in the above case.
> +.IP
> +.IP "\fBupdate-to\fP"
> +This command works like "\fBupdate\fP" but always specifies the version of
> the
> +package we want to update to.
>  .IP
>  .IP "\fBcheck\-update\fP"
>  Implemented so you could know if your machine had any updates that needed
> to
> @@ -125,6 +139,10 @@ Running in verbose mode also shows obsoletes.
>  Is the same as the update command with the \-\-obsoletes flag set. See
> update
>  for more details.
>  .IP
> +.IP "\fBupgrade-to\fP"
> +This command works like "\fBupgrade\fP" but always specifies the version
> of the
> +package we want to update to.
> +.IP
>  .IP "\fBdistribution\-synchronization\fP or \fBdistro\-sync\fP"
>  Synchronizes the installed package set with the latest packages available,
> this
>  is done by either obsoleting, upgrading or downgrading as appropriate.
> This will
> --
> 1.7.3.4
>
> _______________________________________________
> Yum-devel mailing list
> Yum-devel at lists.baseurl.org
> http://lists.baseurl.org/mailman/listinfo/yum-devel
>

ACK
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.baseurl.org/pipermail/yum-devel/attachments/20110401/f2193e14/attachment.html>