File: wdired.el.html
wdired.el (the "w" is for writable) provides an alternative way of renaming files.
Have you ever wanted to use C-x r t (string-rectangle), M-%
(query-replace), M-c (capitalize-word), etc... to change the
name of the files in a Dired buffer? Now you can do this. All the
power of Emacs commands are available when renaming files!
This package provides a function that makes the filenames of a
Dired buffer editable, by changing the buffer mode (which inhibits
all of the commands of Dired mode). Here you can edit the names of
one or more files and directories, and when you press C-c C-c,
the renaming takes effect and you are back to Dired mode.
Other things you can do with WDired:
- Move files to another directory (by typing their path,
absolute or relative, as a part of the new filename).
- Change the target of symbolic links.
- Change the permission bits of the filenames (in systems with a
working unix-alike "chmod"). See and customize the variable
wdired-allow-to-change-permissions. To change a single char
(toggling between its two more usual values), you can press the
space bar over it or left-click the mouse. To set any char to a
specific value (this includes the SUID, SGID and STI bits) you
can use the key labeled as the letter you want. Please note that
permissions of the links cannot be changed in that way, because
the change would affect to their targets, and this would not be
WYSIWYG :-).
- Mark files for deletion, by deleting their whole filename.
* Usage:
You can edit the names of the files by typing C-x C-q or
M-x wdired-change-to-wdired-mode. Use C-c C-c when
finished or C-c C-k to abort.
You can customize the behavior of this package from the "WDired"
menu or with M-x customize-group RET wdired RET.
Defined variables (11)
wdired-allow-to-change-permissions | If non-nil, the permissions bits of the files are editable. |
wdired-allow-to-redirect-links | If non-nil, the target of the symbolic links are editable. |
wdired-confirm-overwrite | If nil the renames can overwrite files without asking. |
wdired-create-parent-directories | If non-nil, create parent directories of destination files. |
wdired-keep-marker-rename | Controls marking of files renamed in WDired. |
wdired-mode-hook | Hooks run when changing to WDired mode. |
wdired-mode-map | Keymap used in ‘wdired-mode’. |
wdired-mode-menu | Menu for ‘wdired-mode’. |
wdired-search-replace-filenames | Non-nil to search and replace in file names only. |
wdired-use-dired-vertical-movement | If t, the "up" and "down" movement works as in Dired mode. |
wdired-use-interactive-rename | If non-nil, WDired requires confirmation before actually renaming files. |
Defined functions (29)
wdired--before-change-fn | (BEG END) |
wdired--restore-properties | (BEG END LEN) |
wdired-abort-changes | () |
wdired-capitalize-word | (ARG) |
wdired-change-to-dired-mode | () |
wdired-change-to-wdired-mode | () |
wdired-create-parentdirs | (FILE-NEW) |
wdired-customize | () |
wdired-do-renames | (RENAMES) |
wdired-downcase-word | (ARG) |
wdired-exit | () |
wdired-finish-edit | () |
wdired-flag-for-deletion | (FILENAMES-ORI) |
wdired-get-filename | (&optional NO-DIR OLD) |
wdired-get-previous-link | (&optional OLD MOVE) |
wdired-mode | () |
wdired-mode-menu | (ARG1) |
wdired-mouse-toggle-bit | (EVENT) |
wdired-next-line | (ARG) |
wdired-normalize-filename | (FILE UNQUOTEP) |
wdired-perm-allowed-in-pos | (CHAR POS) |
wdired-perms-to-number | (PERMS) |
wdired-previous-line | (ARG) |
wdired-revert | (&optional ARG NOCONFIRM) |
wdired-search-and-rename | (FILENAME-ORI FILENAME-NEW) |
wdired-set-bit | (&optional CHAR) |
wdired-toggle-bit | () |
wdired-upcase-word | (ARG) |
wdired-xcase-word | (COMMAND ARG) |