Delete

The Delete internal command can be used to:

 

Command Arguments:

Argument

Type

Possible values

Description

ALL

/S

(no value)

Delete all files and folders without prompting. This can be used to override the Ask for confirmation for each file before deleting and Ask for confirmation for each folder before deleting options on the File Operations / Delete Files page in Preferences.

Example: Delete ALL

EMPTYRECYCLE

/O

(no value)

Empty the system recycle bin. You can combine with the FORCE argument to suppress the confirmation prompt, and the QUIET argument to suppress the progress dialog.

Example: Delete EMPTYRECYCLE FORCE QUIET

 

 

<drive letter>

Empty the recycle bin for a specific drive.

Example: Delete EMPTYRECYCLE=C:

FAILNOTEMPTY

/S

(no value)

Fail when attempting to delete a non-empty folder, or any file. Must be combined with the NORECYCLE argument.

Example: Delete FAILNOTEMPTY NORECYCLE

Use SKIPNOTEMPTY instead if you want the command to continue considering other items after encountering a file or non-empty folder.

FILE

/M

<filename> ...

Specifies the name of the file or files to delete. If you don't provide this argument the command will delete all selected items in the source Lister. This is the default argument for the Delete command - you don't need to specify the FILE keyword.

If you only specify the filename instead of the full path of the file or files, Opus will look in the current source folder. You can also specify a wildcard pattern. Remember that if the filename contains spaces you need to enclose it in quotes.

Example: Delete *.tmp

FILTER

/O

(no value)

Delete with filtering enabled (without having to activate the delete filter in the Lister first). Opus will prompt you to define the filter.

Example: Delete FILTER

 

 

<filter>

Delete using the specified filter. This must have previously been created from the File Operations / Filters page in Preferences.

You can also directly specify a simple wildcard pattern. When specifying a simple wildcard pattern as the filter, it only affects which files are deleted; all selected folders and sub-folders are deleted unless they contain a file which doesn't match the filter and thus isn't deleted.

Example: Delete FILTER "temp files"

 

 

shift

Delete with filtering enabled if the Shift key is held down. Opus will prompt you to define the filter.

Example: Delete FILTER=shift

 

 

alt

Delete with filtering enabled if the Alt key is held down.


Example: Delete FILTER=alt

 

 

ctrl

Delete with filtering enabled if the Ctrl key is held down.

Example: Delete FILTER=ctrl

FORCE

/S

(no value)

Force the deletion of any files that are marked as read-only (have the R attribute set). This overrides the Delete read-only files automatically (without asking) option on the File Operations / Delete Files page in Preferences.

Example: Delete FORCE

NOFROMFOCUS

/S

(no value)

The default behaviour for the Delete command is to operate on either the source file display, or the Folder Tree, depending on which one has the input focus. This lets you use the same command to delete folders in the tree as well as items in the file display. Specify this argument to force the command to always operate on the source file display and ignore the folder tree.

Example: Delete NOFROMFOCUS

NORECYCLE

/S

(no value)

Prevent the use of the recycle bin - files will be permanently deleted. This overrides the Delete to Recycle Bin where possible option on the File Operations / Delete Files page in Preferences.

Example: Delete NORECYCLE

QUIET

/S

(no value)

Prevent the display of any confirmation dialogs or error messages.

Example: Delete FORCE QUIET

RECYCLE

/S

(no value)

Delete files by moving them to the recycle bin (if possible - not all drives support the recycle bin). Deletes to the recycle bin are not permanent - the files can be recovered until the bin is emptied. This overrides the Delete to Recycle Bin where possible option on the File Operations / Delete Files page in Preferences.

Example: Delete RECYCLE

REMOVECOLLECTION

/O

(no value)

Remove selected files and folders from the file collection. If used outside of a file collection this command will do nothing.

Example: Delete REMOVECOLLECTION

 

 

auto

When used on files and folders in a file collection, the items will be removed from the collection. When used outside of a file collection, the items will be deleted as normal.

Example: Delete REMOVECOLLECTION=auto

SECURE

/O

(no value)

Perform a secure delete using the number of passes specified on the File Operations / Delete Files page in Preferences.

Example: Delete SECURE

 

 

<passes>

Perform a secure delete using the specified number of passes (from 1 to 32 depending on your level of paranoia :)

Example: Delete SECURE=5

SHIFT

/S

(no value)

Modifies the behaviour of the Delete command if the Shift key is held down.

  • If the Delete to Recycle Bin option is selected on the File Operations / Delete Files page in Preferences, holding the Shift key down will disable the use of the recycle bin.
  • If the Delete to Recycle Bin option is not selected, the command acts as if the ALL and FORCE arguments are specified.

In either case, if the Shift key is not held down, the SHIFT argument has no effect on the normal operation of the command. This argument is used to emulate the behaviour of Explorer.

Example: Delete SHIFT

SKIPNOTEMPTY

/S

(no value)

Skip over non-empty folders, and all files, without deleting them, while still considering subsequent items for deletion. Must be combined with NORECYCLE.

Example: Delete NORECYCLE SKIPNOTEMPTY

Use FAILNOTEMPTY instead if you want the command to stop completely as soon as it encounters any file or non-empty folder.