From 76dffdc9d7eec0956415edb1024a14865166be09 Mon Sep 17 00:00:00 2001 From: Joseph Hunkeler Date: Mon, 11 Apr 2016 11:12:20 -0400 Subject: Be more verbose about different upgrade paths --- source/updating.rst | 36 +++++++++++++++++++++++++++++++----- 1 file changed, 31 insertions(+), 5 deletions(-) (limited to 'source') diff --git a/source/updating.rst b/source/updating.rst index 2b1495c..0e2a8ef 100644 --- a/source/updating.rst +++ b/source/updating.rst @@ -9,19 +9,45 @@ packages installed in your Anaconda distribution will remain relatively static. Updating AstroConda =================== -The update procedure for AstroConda is relatively straight forward. +There are few simple ways to update packages obtained from AstroConda: + +Method One - Updating the Metapackage +------------------------------------- .. code-block:: sh - # Will update all packages - $ conda update --all + $ conda update -n astroconda astroconda + +Updating the ``astroconda`` metapackage only effects packages that are part of the **official public release** of our software. +Using this method, packages that are in the AstroConda repository, but not controlled by the ``astroconda`` metapackage, +**will not receive updates**. Please use method two below. + +Method Two - Updating All Packages +---------------------------------- + +.. code-block:: sh + + $ conda update -n astroconda --all + +This method will update the ``astroconda`` metapackage, as well all other packages installed in your enviroment. - # Will update packages if a new public release is present - $ conda update astroconda +Please keep in mind, this updates **all packages** regardless if they were installed from AstroConda, Continuum, Inc., +or other third party repositories defined in ``$HOME/.condarc``. (`ref `__) +Method Three - Updating Packages Individually +--------------------------------------------- + +.. code-block:: sh + + $ conda update -n astroconda stsci.tools + +If you are interested in receiving updates for a particular package, then this method is for you. Be aware that packages +may depend on other packages, so the total list returned by this command will be variable. + + Downgrading Packages ==================== -- cgit