xmldiffmrg

Parses, compares, and merges XML file versions

Applicability

Product

Command type

VersionVault

command

Platform

Windows®

Synopsis

  • Start the GUI without specifying an operation:
    xmldiffmrg
  • Parse one file:
    xmldiffmrg [ –xview ] [ –visible_blank ] [ pname1 ]
  • Compare files:
    xmldiffmrg –xcompare [ –blank_ignore –visible_blank ]
    [ –hstack |–vstack ] [ pname1 ... pname7 ]
  • Merge files:
    xmldiffmrg –xmerge [ –out pname | –to to-version ] [ –query | –abort
    | –qall ] [ –encoding { utf-16 | utf-8 | iso-8859-1 | ascii } ]

    [ –hstack |–vstack ] [ –visible_blank ] [ –base base_contributor ]

    [ pname1 ... pname7 ]

Description

The xmldiffmrg command starts a GUI in which you compare and merge versions of XML elements. xmldiffmrg parses XML, which enables you to do the following:

  • Compare and merge XML structure and content without understanding XML markup.
  • Expand, collapse, browse, and filter the data tree resulting from a comparison or merge operation.

For general information about comparing and merging element versions, see Developing Software.

Restrictions

Identities

For all operations except creating a merge arrow, no special identity is required. To create a merge arrow, you must have one of the following identities:

  • Element owner
  • Element group member
  • VOB owner
  • Member of the VersionVault administrators group (VersionVault)

Locks

An error occurs if one or more of these objects are locked: VOB, element type, element, branch type, branch, hyperlink type.

Mastership

(Replicated VOBs only) No mastership restrictions.

Options and arguments

Specifying the operation to be performed

Default
For a single pname argument, –xview; for multiple contributors, none.
–xview
Parses a single contributor.
–xcompare
Compares contributors.
–xmerge
Merges contributors.

Treatment of white space

Default
The default behavior differs according to whether the nodes contain white space only, or both white space and other characters, as follows:
  • In white-space-only nodes, white space is ignored unless there's a difference in the nodes being compared or merged.
  • In nodes that contain white space and other characters, a white-space character is treated the same as any other character.
–visible_blank
White-space characters are made visible by alternate glyphs representing the white space.
–blank_ignore
Ignores white-space characters in white-space-only nodes. This option does not affect the comparison of nodes that contain both white space and other characters.

Contributor pane stacking

Default
–hstack.
–hstack
Each contributor being compared or merged is displayed in a separate contributor pane that is stacked horizontally (side by side), with the base contributor on the left.
–vstack
Specifies contributor panes are to be stacked vertically, with the base contributor on top.

Destination of the merge output

Default
None; the GUI prompts for a destination if none is specified in the command line.
–out pname
Specifies the pathname to which the merge output is written after all conflicts are resolved. Use this option to perform a merge that does not overwrite any of its contributors.
–to to-version
Specifies the file that is to be the merge target. to-version is both a contributor to the merge and the destination of the merged output.

Controlling user interaction

Default
Performs merges as automatically as possible, prompting you to make a choice only when two or more contributors differ from the base contributor.
–query
Changes in the to-version are accepted unless a conflict exists. Turns off automatic merging for nontrivial merges and prompts you to proceed with every change in the other contributors.
–abort
Cancels the command instead of engaging in a user interaction; a merge takes place only if it is completely automatic. If two or more contributors differ from the base contributor, a warning is issued and the command is canceled. This command is useful in shell scripts that batch many merges (for example, all file elements in a directory) into a single procedure.
–qall
Turns off automated merging. You are prompted to make a choice every time a contributor differs from the base contributor. This option is turned on when xmldiffmrg cannot determine a common ancestor (or other base contributor), and you do not use –base.

Character encoding

Default
None.
–encoding { utf-16 | utf-8 | iso-8859-1 | ascii}
If an output file is generated, use the specified (case-insensitive) encoding type. The generated output contains an XML Declaration statement containing the specified encoding attribute if required. If a character code cannot be represented in the specified encoding, it is written out as an XML character reference in the form

&xnnnn;

where nnnn is a hexadecimal character index.

Specifying the base contributor

Default
pname1.
–base base_contributor
Specifies the base contributor; typically, but not always, this is the closest common ancestor of the contributors.

Specifying the contributors

Default
None; if no contributor is specified on the command line, a dialog box prompts for contributors.
pname1 ... pname7
Specifies the contributors. A maximum of seven contributors may be specified, inclusive of a contributor specified by –base.