From a663b24b29ef621e668b4ef16801ebb28b1fd55a Mon Sep 17 00:00:00 2001
From: Marco Esters <mesters@anaconda.com>
Date: Mon, 2 Dec 2024 08:56:53 -0800
Subject: [PATCH] Document uninstaller subcommand for Unix

---
 .../nsis/StandaloneUninstallerOptions.nsh     |  4 +-
 docs/source/howto.md                          | 42 ++++++++++++++++++-
 2 files changed, 43 insertions(+), 3 deletions(-)

diff --git a/constructor/nsis/StandaloneUninstallerOptions.nsh b/constructor/nsis/StandaloneUninstallerOptions.nsh
index c4d3cb4d1..4da385ae5 100644
--- a/constructor/nsis/StandaloneUninstallerOptions.nsh
+++ b/constructor/nsis/StandaloneUninstallerOptions.nsh
@@ -73,8 +73,8 @@ Function un.UninstCustomOptions_Show
     Pop $UninstCustomOptions.RemoveCaches
     ${NSD_SetState} $UninstCustomOptions.RemoveCaches $UninstRemoveCaches_State
     ${NSD_OnClick} $UninstCustomOptions.RemoveCaches un.UninstRemoveCaches_Onclick
-    ${NSD_CreateLabel} 5% "$5u" 90% 20u \
-        "This removes cache such as package caches and notices."
+    ${NSD_CreateLabel} 5% "$5u" 90% 10u \
+        "This removes cache directories such as package caches and notices."
     IntOp $5 $5 + 20
 
     IntOp $5 $5 + 5
diff --git a/docs/source/howto.md b/docs/source/howto.md
index c6fca5056..970cc17fd 100644
--- a/docs/source/howto.md
+++ b/docs/source/howto.md
@@ -160,4 +160,44 @@ If you want to perform the uninstallation steps manually, you can:
 
 ### macOS and Linux
 
-Remove the installation directory. Usually this is a directory in your user's home directory (user installs), or under `/opt` for system-wide installations.
+:::{note}
+The following sections requires installers to be built using the `uninstall_with_conda_exe` option.
+This is currently only implemented for `conda-standalone` 24.11.0 and higher.
+
+For other installers, all files need to be removed manually.
+:::
+
+Unlike Windows, macOS and Linux installers do not ship an uninstaller executable.
+However, some standalone applications (like `conda-standalone`) provide an uninstaller subcommand.
+The following can be used to uninstall an existing installation:
+
+```bash
+$ $INSTDIR/_conda constructor uninstall --prefix $INSTDIR
+```
+
+where `$INSTDIR` is the installation directory. This command recursively removes all environments
+and removes shell initializers that point to `$INSTDIR`.
+
+The command supports additional options to delete files outside the installation directory:
+
+- `--remove-caches`:
+  Removes cache directories such as package caches and notices.
+  Not recommended with multiple conda installations when softlinks are enabled.
+- `--remove-config-files {user,system,all}`:
+   Removes all configuration files such as `.condarc` files outside the installation directory.
+   `user` removes the files inside the current user's home directory
+   and `system` removes all files outside of that directory.
+- `--remove-user-data`:
+  This removes user data files such as the `~/.conda` directory.
+
+These options are not recommended if multiple conda installations are on the same system because
+they delete commonly used files.
+
+:::{note}
+If removing these files requires superuser privileges, use `sudo -E` instead of `sudo` since
+finding these files may rely on environment variables, especially `$HOME`.
+:::
+
+For more detailed implementation notes, see the documentation of the standalone application:
+
+* [conda-standalone](https://github.com/conda/conda-standalone)