summaryrefslogtreecommitdiff
path: root/source/updating.rst
diff options
context:
space:
mode:
Diffstat (limited to 'source/updating.rst')
-rw-r--r--source/updating.rst36
1 files changed, 31 insertions, 5 deletions
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 <http://conda.pydata.org/docs/using/pkgs.html#package-update>`__)
+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
====================