Mercurial: Refresh Patch Dialog Box
See Also
The Refresh Patch dialog box enables you to refresh a patch in a current patch queue series, that contains the changes between last committed and current version of one or more text files.
You access this dialog box by selecting a versioned project, file or folder and either:
- choose Team > Mercurial > Queues > Refresh Patch from the main menu.
- right-click the selected item and choose Mercurial > Queues > Refresh Patch.
In the Refresh Patch dialog box, you have to review and specify the following properties:
- Patch Name. Review the name of a patch.
- Patch Message. Update the description of the message to be used as a commit message when the patch is finalized and a made permanent part of the commits history. Click the Recent Messages button to view and select from a list of messages that you have previously entered. Click the Load Template button to select a message template.
- Files To Include In Patch: Displays a list of files that have been locally added, modified, deleted, or already included into a patch.
- Include. Select to include individual files into a patch.
- File. Lists all files that can be included into or excluded from a patch.
- Status. Displays four status values for a file:
- Locally New. Indicates a file placed under Mercurial version control locally (not pushed to a Mercurial repository yet).
- Locally Modified. Indicates a file that contains changes made locally (not pushed to a Mercurial repository yet).
- Locally Removed. Indicates a file that has been deleted locally (not from a Mercurial repository yet).
- Up to date. Indicates that a patch already contains all file's modifications.
Note:
- You can remove a file from a patch by deselecting the file in the Include column or right-clicking the file row in the action column and choosing Exclude from patch.
- Action. Displays Include In Patch if the file is selected or Exclude from Patch if the file is deselected in the Include column.
Note:
- If you deselect a file by choosing the Exclude from Patch action, the file will be removed from the patch, the patch will not contain its changes and the file will remain marked as Locally New, Locally Modified, or Locally Removed in the working copy.
- Repository Path. Displays path to the file in your local repository. You can sort the files by their names by clicking the black arrow in the column header.
Note:
- Right-click a file row to display the following popup menu items:
- Exclude From Patch/Include In Patch. Select to either exclude the file from the patch or include it into the patch.
- Diff. Select to display the Diff Viewer.
- Update Issue:
Track issues related to the change being committed using the following fields:
- Issue Tracker. Choose an issue tracker from the list or click New to create an issue tracker.
- Issue. Specify the issue using its summary or ID.
- Resolve as FIXED. Select to change an issue status to Resolved Fixed.
- Add details to commit message and issue. Select to provide an enhanced commit description.
- After Patch Finish. Choose to update an issue after the patch is finished.
- After Push. Choose to update an issue after the changes contained in a patch are pushed into a remote repository.
- See Also
- About Mercurial Support
- Mercurial Tasks: Quick Reference
- Mercurial: Diff Viewer
- Mercurial: Create Patch Dialog Box
Legal Notices