Next: , Previous: Change Logs and VC, Up: Miscellaneous VC


23.7.9.2 Renaming VC Work Files and Master Files

When you rename a registered file, you must also rename its master file correspondingly to get proper results. Use vc-rename-file to rename the source file as you specify, and rename its master file accordingly. It also updates any snapshots (see Snapshots) that mention the file, so that they use the new name; despite this, the snapshot thus modified may not completely work (see Snapshot Caveats).

Some backends do not provide an explicit rename operation to their repositories. After issuing vc-rename-file, use C-x v v on the original and renamed buffers and provide the necessary edit log.

You cannot use vc-rename-file on a file that is locked by someone else.