Skip to content

Commit

Permalink
Update cylc clean docs
Browse files Browse the repository at this point in the history
  • Loading branch information
MetRonnie committed Feb 14, 2022
1 parent 0906b58 commit 6e7758f
Showing 1 changed file with 9 additions and 14 deletions.
23 changes: 9 additions & 14 deletions src/user-guide/removing-workflows.rst
Original file line number Diff line number Diff line change
Expand Up @@ -34,13 +34,6 @@ Simple example of using ``cylc clean``:
$ cylc clean myflow/run1
INFO - Removing directory: ~/cylc-run/myflow/run1
.. note::

Trying to clean a directory that contains more than one
run directory is not allowed, as a safety feature. You can override
this using the ``--force`` option, but this will not clean remote install
targets or follow symlink dirs as described below.

Cleaning on remote install targets
----------------------------------
Expand All @@ -60,8 +53,9 @@ filesystem.
.. note::

This relies on determining which platforms were used from the workflow
database. If the database is missing, you will have to manually remove the
files on remote install targets.
database. If the platforms recorded in the database are out of date with
the global configuration, or if the database is missing altogether, you will
have to manually remove the files on remote install targets.

You can also clean on just the local filesystem using the ``--local`` option,
or just the remote install target using the ``--remote`` option.
Expand Down Expand Up @@ -110,12 +104,13 @@ A note on symlink directories
:cylc:conf:`global.cylc[install][symlink dirs]`, you might want to read
this explanation of how Cylc handles them during cleaning.

If you manually delete a run directory (e.g., using ``rm`` or the file
manager), only the symlinks themselves will be deleted, not the actual targets.
In contrast, ``cylc clean`` follows the symlinks and deletes the targets.
If you manually delete a run directory (e.g., using the ``rm`` command or the
file manager), only the symlinks themselves will be deleted, not the actual
targets. In contrast, ``cylc clean`` follows the symlinks and deletes the
targets.

- It does this for the symlinks that can be set in
:cylc:conf:`global.cylc[install][symlink dirs]` only, not any custom
- It only does this for the symlinks that can be set in
:cylc:conf:`global.cylc[install][symlink dirs]`, not any custom
user-created symlinks.
- It does not actually look up the global configuration at time of cleaning;
it simply detects what symlinks are present out of the possible ones.
Expand Down

0 comments on commit 6e7758f

Please sign in to comment.