VirtualBox

Opened 14 years ago

Closed 14 years ago

#5663 closed defect (fixed)

Manual section 5>Differencing images>1 Snapshots>C thrown away needs clarification

Reported by: Mark Cranness Owned by: umoeller
Component: documentation Version: VirtualBox 3.1.0
Keywords: manual snapshot differencing delete Cc:
Guest type: other Host type: other

Description

The manual says this about Restore Snapshot:

The differencing images holding all the write operations since the snapshot was taken are thrown away, and the original parent images are made active again. (If you restored the "root" snapshot, then this will be the root disk images; otherwise, some other differencing image descended from it.) This effectively restores the old machine state.

This is true when deleting the 'Current' snapshot, namely the bolded immediate parent of the 'Current State'.

However, this is ambigious and unclear when deleting any other snapshot, because the term 'the snapshot' is ambigious. The user might think that the snapshot refers to the snapshot being restored (it does not) and that the entire child tree under it will be thrown away (it will not).

Instead, how about:

The differencing images associated with the current machine state are thrown away, and...

Change History (3)

comment:1 by Mark Cranness, 14 years ago

Sorry: This is true when deleting the 'Current' snapshot, namely the bolded immediate parent of the 'Current State'.

This is true when Restoring the 'Current' snapshot, namely the bolded immediate parent of the 'Current State'.

comment:2 by umoeller, 14 years ago

Owner: set to umoeller
Status: newassigned

Thanks for the remark. It's hard to be accurate and easy to understand at the same time... the "differencing images" had to be in plural because there's one for each hard disk attachment. I'll come up with a better wording.

comment:3 by umoeller, 14 years ago

Resolution: fixed
Status: assignedclosed

I now have: "For each disk image attached to the machine, the differencing image holding all the write operations since the current snapshot was taken is thrown away, and the original parent image is made active again. (If you restored the "root" snapshot, then this will be the root disk image for each attachment; otherwise, some other differencing image descended from it.) This effectively restores the old machine state."

I hope that makes it better, otherwise please reopen!

Note: See TracTickets for help on using tickets.

© 2023 Oracle
ContactPrivacy policyTerms of Use