home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / unix / doc / mv.man < prev    next >
Text File  |  1993-06-13  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. MV(1L)                                                     MV(1L)
  5.  
  6.  
  7. NAME
  8.        mv - rename files
  9.  
  10. SYNOPSIS
  11.        mv [options] source dest
  12.        mv [options] source... directory
  13.        Options:
  14.        [-bfiuv]       [-S      backup-suffix]      [-V      {num-
  15.        bered,existing,simple}] [--backup]  [--force]  [--interac-
  16.        tive]   [--update]   [--verbose]  [--suffix=backup-suffix]
  17.        [--version-control={numbered,existing,simple}]    [--help]
  18.        [--version]
  19.  
  20. DESCRIPTION
  21.        This  manual page documents the GNU version of mv.  If the
  22.        last argument names an existing directory, mv  moves  each
  23.        other  given  file  into a file with the same name in that
  24.        directory.  Otherwise, if only two  files  are  given,  it
  25.        moves  the  first  onto the second.  It is an error if the
  26.        last argument is not a directory and more than  two  files
  27.        are given.  It can move only regular files across filesys-
  28.        tems.
  29.  
  30.        If a destination file is unwritable, the standard input is
  31.        a  tty,  and  the  -f  or  --force option is not given, mv
  32.        prompts the user for whether to overwrite  the  file.   If
  33.        the  response  does not begin with `y' or `Y', the file is
  34.        skipped.
  35.  
  36.    OPTIONS
  37.        -b, --backup
  38.               Make backups of files that are about to be removed.
  39.  
  40.        -f, --force
  41.               Remove  existing destination files and never prompt
  42.               the user.
  43.  
  44.        -i, --interactive
  45.               Prompt whether to overwrite each  destination  file
  46.               that  already  exists.   If  the  response does not
  47.               begin with `y' or `Y', the file is skipped.
  48.  
  49.        -u, --update
  50.               Do not move a nondirectory  that  has  an  existing
  51.               destination  with  the  same  or newer modification
  52.               time.
  53.  
  54.        -v, --verbose
  55.               Print the name of each file before moving it.
  56.  
  57.        --help Print a usage message and exit with a non-zero sta-
  58.               tus.
  59.  
  60.  
  61.  
  62.  
  63.  
  64. FSF                     GNU File Utilities                      1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MV(1L)                                                     MV(1L)
  71.  
  72.  
  73.        --version
  74.               Print  version  information  on standard error then
  75.               exit.
  76.  
  77.        -S, --suffix backup-suffix
  78.               The suffix used for making simple backup files  can
  79.               be  set  with  the SIMPLE_BACKUP_SUFFIX environment
  80.               variable, which can be overridden by  this  option.
  81.               If  neither  of those is given, the default is `~',
  82.               as it is in Emacs.
  83.  
  84.        -V, --version-control {numbered,existing,simple}
  85.               The type of backups made can be set with  the  VER-
  86.               SION_CONTROL  environment  variable,  which  can be
  87.               overridden by this option.  If  VERSION_CONTROL  is
  88.               not  set  and this option is not given, the default
  89.               backup type is `existing'.  The value of  the  VER-
  90.               SION_CONTROL  environment variable and the argument
  91.               to this option are like  the  GNU  Emacs  `version-
  92.               control'  variable;  they  also  recognize synonyms
  93.               that are more descriptive.  The  valid  values  are
  94.               (unique abbreviations are accepted):
  95.  
  96.               `t' or `numbered'
  97.                      Always make numbered backups.
  98.  
  99.               `nil' or `existing'
  100.                      Make  numbered backups of files that already
  101.                      have them, simple backups of the others.
  102.  
  103.               `never' or `simple'
  104.                      Always make simple backups.
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. FSF                     GNU File Utilities                      2
  131.  
  132.  
  133.