home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / SRC / msdos_diskaccess.lzh / MS_DISK_ACCESS / Mren.1 < prev    next >
Text File  |  1990-05-10  |  1KB  |  44 lines
  1. .TH MREN 1 local
  2. .SH NAME
  3. mren \- rename an existing MSDOS file
  4. .SH SYNOPSIS
  5. .B mren
  6. [
  7. .B -v
  8. ] sourcefile targetfile
  9. .SH DESCRIPTION
  10. .I Mren
  11. renames an existing file on a MSDOS formatted diskette.  Sub directories
  12. are supported with either the '/' or '\e\' separator.  The use of
  13. the '\e\' separator or wildcards will require the names to be enclosed
  14. in quotes to protect them from the shell.
  15. .PP
  16. .I Mren
  17. will allow the following command line option:
  18. .TP
  19. .B v
  20. Verbose mode.  Display the new file name if the name supplied is
  21. invalid.
  22. .PP
  23. Reasonable care is taken to create a valid MSDOS filename.  If an invalid
  24. MSDOS target name is specified,
  25. .I mren
  26. will change the name (and prompt the user to accept or reject the new name
  27. if the verbose mode is set).
  28. .PP
  29. The path component of the target filename (if supplied) is ignored.  In
  30. other words, you may not use
  31. .I mren
  32. to move a file from one sub directory to another.
  33. .PP 
  34. .I Mren
  35. may also be used to rename directories.
  36. .PP
  37. The environmental variable MCWD may be used to establish a current
  38. working directory (relative to the MSDOS diskette).
  39. .SH SEE ALSO
  40. mwrite(1)
  41. .SH BUGS
  42. Wildcards are only applied to filenames, not to directory names.
  43. MSDOS doesn't use ren to rename directories.
  44.