Merging Reviewed Files

If you attempt to accept a reviewed file and Flare detects a conflict, a dialog opens so that you can take the appropriate action.

[Menu Proxy — Headings — Online — Depth3 ]

Example You send a file to a reviewer. Before the reviewer returns the file, you make changes to the original file in your project. Then you receive the reviewed file and attempt to accept it so that it becomes part of your project. Flare detects a conflict because the original has changed, so you are given a few options. You can merge the changes from the files, keep the edits from the reviewer (undoing your changes), or keep your edits (discarding those from the reviewer).

How to Merge Reviewed Files

  1. Go through the process of accepting a reviewed file (see Accepting Reviewed Files). If a conflict exists, a dialog opens.
  2. In this dialog, you can choose from the following options and click OK.
    • Merge changes in merge tool Opens a merging interface, which lets you see exactly what changes were made and choose which to keep.
    • Undo my local changes Removes your changes and keeps changes from the reviewer.
    • Discard reviewer changes Removes changes from the reviewer and keeps your changes.

    If you selected the first option, the Merge Changes dialog opens, showing the original (local) file on one side and the reviewed file on the other side, with changes shown in different colors.

  3. (Optional) If you want to change the colors associated with the changes, you can click Options.
  4. (Optional) By default the files are shown in a WYSIWYG (What You See Is What You Get) view. But you can click Merge as Text to work in the markup instead; you can left-click to resolve conflicts (accept changes) when merging as text.
  5. You can use the Merge Changes dialog to view and select changes. You can take actions in the following ways.
    • Right-Click Icon You can right-click on the icon next to a change on either the local or reviewed side. This displays a context menu, which lets you keep or ignore a particular change.
    • Left-Click Icon You can left-click on the icon next to a change on either the local or reviewed side. When you do this, the change from one side is kept and the change from the other side is ignored. If you left-click the icon again, the results are toggled; the first change is ignored and the other is kept.
    • Type Content If you want to use your changes as well as those from the reviewer, and even tweak the paragraph a bit more, you can click in the area at the bottom of the dialog and simply type content.
    • Previous/Next Conflict When you are finished resolving the first conflict, you can use the "Previous Conflict" and "Next Conflict" buttons at the bottom of the dialog to work on other conflicts in the topic.
  6. After all conflicts have been resolved, click OK.

    A backup of the original file is added to the Backups window pane. This lets you restore that file if you do not want to keep the merged version. See Backups.

Icons for File Differences

Following are descriptions of the various icons you might see in the Merge Changes dialog when merging files.

Icon

Description

Difference Content Changed icon

Changed Content This indicates that the content has changed but there is no conflict. Therefore, no action is needed.

Difference Tag Changed icon

Changed Tag This is the same as the "Changed Content" icon, except the content has not changed, just a tag, such as a style or span.

Difference New icon

New Content This indicates that there is new content, but there is no conflict with your changes. Therefore, no action is needed.

Difference Deleted icon

Deleted This indicates that content was deleted, but there is no conflict with your changes. Therefore, no action is needed.

Following are descriptions of conflict icons.

Icon

Description

Difference Content Changed Conflict icon

Changed Content—Conflict This indicates that the content has changed and a conflict exists. Therefore, user action is required. This icon appears in both the left and right panes of the Merge Changes dialog at the spot of the conflict. You must click on one of the icons to "Accept" that particular change.

Difference Content Changed Keep icon

Conflict Change—Accepted This indicates that a change with a conflict has been accepted after clicking on Difference Content Changed Conflict icon. The bottom pane of the Merge Changes dialog updates to show the accepted content.

Difference Content Changed Denied icon

Conflict Change—Not Accepted This indicates that a change with a conflict will not be accepted. When you accept a conflict change and that side of the Merge Changes dialog displays Difference Content Changed Keep icon, the opposite pane where the conflict exists will display Difference Content Changed Denied icon.

Difference Tag Changed Conflict icon

Changed Tag—Conflict This indicates that the tag has changed and a conflict exists. Therefore, user action is required. This icon appears in both the left and right panes of the Merge Changes dialog at the spot of the conflict. You must click on one of the icons to "Accept" that particular change.

Difference Tag Changed Conflict Keep icon

Conflict Tag—Accepted This indicates that a change with a conflict in a tag has been accepted after clicking on Difference Tag Changed Conflict icon. The bottom pane of the Merge Changes dialog updates to show the accepted content.

Difference Tag Changed Conflict Ignore icon

Conflict Tag—Not Accepted This indicates that a change with a conflict in a tag will not be accepted. When you accept a conflict change and that side of the Merge Changes dialog displays Difference Tag Changed Conflict Keep icon, the opposite pane where the conflict exists will display Difference Tag Changed Conflict Ignore icon.