.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "VIDIR 1"
.TH VIDIR 1 2024-02-25 moreutils " "
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
vidir \- edit directories and filenames
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBvidir\fR [\fB\-\-verbose\fR] [\fIdirectory\fR|\fIfile\fR|\fB\-\fR]...
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBvidir\fR allows editing of directories and filenames in a text editor.  If no
\&\fIdirectory\fR is specified, the filenames of the current directory are edited.
.PP
When editing a directory, each item in the directory will appear on its own
numbered line. These numbers are how vidir keeps track of what items are
changed. Delete lines to remove files from the directory, or
edit filenames to rename files. You can also switch pairs of numbers to
swap filenames.
.PP
Filenames to be edited may be given any combination of \fIdirectory\fRs (which
will be expanded to the non-recursive list of all files within \fIdirectory\fR),
\&\fIfile\fRs, or \fI\-\fR.  If the latter is specified, \fBvidir\fR reads a list of
filenames from stdin and displays those for editing.
.SH OPTIONS
.IX Header "OPTIONS"
.IP "\-v, \-\-verbose" 4
.IX Item "-v, --verbose"
Verbosely display the actions taken by the program.
.SH EXAMPLES
.IX Header "EXAMPLES"
.IP vidir 4
.IX Item "vidir"
.PD 0
.IP "vidir *.jpeg" 4
.IX Item "vidir *.jpeg"
.PD
Typical uses.
.IP "find | vidir \-" 4
.IX Item "find | vidir -"
Edit subdirectory contents too. To delete subdirectories,
delete all their contents and the subdirectory itself in the editor.
.IP "find \-type f | vidir \-" 4
.IX Item "find -type f | vidir -"
Edit all files under the current directory and subdirectories.
.SH "ENVIRONMENT VARIABLES"
.IX Header "ENVIRONMENT VARIABLES"
.IP EDITOR 4
.IX Item "EDITOR"
Editor to use.
.IP VISUAL 4
.IX Item "VISUAL"
Also supported to determine what editor to use.
.SH AUTHOR
.IX Header "AUTHOR"
Copyright 2006 by Joey Hess <id@joeyh.name>
.PP
Licensed under the GNU GPL.