VersionControl

Version 9.3 by Sergiu Dumitriu on 2009/07/18

Version Control

Any change made to a document is saved under Version Control. You can see the version of a document by looking at the bottom of the document. For example, on the following document the version is 5.4 and has last been modified by "Sergiu":

versioncontrol1.png

As the image shows, the document version consists of two numbers, separated by a dot: <Major>.<Minor>. The XWiki versioning system allows the distinction between major and minor edits. When editing a page, the user has the option to decide whether his edit brings major or minor changes to the document. Saving a major version will increase the first component and reset the second to "1", while a minor version will just increase the second component.

Clicking on the "History" button when viewing a page displays all the versions that were previously saved:

versioncontrol2.png

Besides listing the document versions, the history page can be used to perform other actions as well:

  • compare any two versions
  • set an older version as the current version (restore); available only if the user has edit rights on the document
  • delete a version completely from the history (useful for removing spam, for example); available only if the user has administration rights

By default, minor edits do not appear in the document history. The option "Show minor edits" will list all the versions, including minor ones.

Comparing 2 versions highlights the differences between them, grouped by what part of the document they affect: the content, metadata, attachments, comments, objects, class definition:

versioncontrol3.png

Get Connected