IRAF help page for package system, program rename

from NOAO rename -- rename a file or set of files

file
newname
field = root

rename -- rename a file or set of files

USAGE

rename file newname

PARAMETERS

file

A template specifying the file or files to be renamed.

newname

If a single file is being renamed, the new filename, else the new name of the field being renamed in a set of filenames.

field = root

Specifies either the "root" or the "extn" field as the one to be modified.

DESCRIPTION

Rename renames either a single file to "newname", or a set of files, changing either the root or the extension part of each name.

EXAMPLES

1. Rename file "fred" to "jay".

cl> rename fred jay

2. Change the root name of a set of files from "out" to "pkout".

cl> rename out.x,out.o,out.par pkout

3. Change the extension of all ".f77" files from ".f77" to ".f".

cl> rename *.f77 f field=extn

BUGS

Rename cannot be used to move a file to another directory unless the full destination filename is specified. Use movefiles if do not want to type the filename twice.

SEE ALSO

movefiles, copy,

This page automatically generated from the iraf .hlp file. If you would like your local iraf package .hlp files converted into HTML please contact Dave Mills at NOAO.

dmills@noao.edu