diff --git a/Saving%2C-History-and-Version-Control.md b/Saving%2C-History-and-Version-Control.md new file mode 100644 index 0000000..5bc1102 --- /dev/null +++ b/Saving%2C-History-and-Version-Control.md @@ -0,0 +1,27 @@ +## Saving, History and version control + +### History and version control + +Bouquin supports versioning. Every time you save a page/date, it stores a new version of that page. The previous version remains in the database. + +You can click on 'View History' from the toolbar, or via the **File -> History** navigation, or via `Ctrl+Shift+H`, to open the History dialog. + +This will display a list of versions for the page, with the version number, timestamp and a 'note' about the change. + +On the right will be a preview pane that shows that version of the page. + +There is also a 'Diff' tab which will show all the differences between the current version and the version you have selected in the left pane. + +You can click on 'Revert to Selected' to revert to an older or newer version of the page. + +Reverting is a bit like git: it simply moves a 'pointer' to point at the relevant version, without overwriting your current version. **Your current version will still be in the database**, so you can always revert 'back to the future' if you change your mind :) + +If you wish, you can also select one or more revisions and click Delete to delete them (you cannot delete the latest revision). + +### Autosave vs explicit save + +Every 5 seconds or so, Bouquin will autosave the page if there were any unsaved changes. This will be given the note 'autosave' in the version history. + +If you explicitly press `Ctrl+S` or via the **File -> Save** navigation, you will be prompted to optionally set a version note. You can either accept the default which has a reasonably meaningful message, or give it a meaningful note of your own. + +