Mercurial: Create Patch Dialog Box
See Also
The Create Patch dialog box enables you to create a new 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 > Create Patch from the main menu.
- right-click the selected item and choose Mercurial > Queues > Create Patch.
In the Create Patch dialog box, you have to set the following properties:
- Patch Name. Specify the name of a patch.
- Patch Message. Enter 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 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).
- 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 not be included in a patch and 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 press 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
Legal Notices