mirror of
https://github.com/syncthing/syncthing.git
synced 2024-11-16 10:28:49 -07:00
118 lines
4.0 KiB
Groff
118 lines
4.0 KiB
Groff
.\" Man page generated from reStructuredText.
|
|
.
|
|
.TH "TODO" "7" "May 30, 2015" "v0.11" "Syncthing"
|
|
.SH NAME
|
|
Todo \- Keep automatic backups of deleted files by other nodes
|
|
.
|
|
.nr rst2man-indent-level 0
|
|
.
|
|
.de1 rstReportMargin
|
|
\\$1 \\n[an-margin]
|
|
level \\n[rst2man-indent-level]
|
|
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
-
|
|
\\n[rst2man-indent0]
|
|
\\n[rst2man-indent1]
|
|
\\n[rst2man-indent2]
|
|
..
|
|
.de1 INDENT
|
|
.\" .rstReportMargin pre:
|
|
. RS \\$1
|
|
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
|
. nr rst2man-indent-level +1
|
|
.\" .rstReportMargin post:
|
|
..
|
|
.de UNINDENT
|
|
. RE
|
|
.\" indent \\n[an-margin]
|
|
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.nr rst2man-indent-level -1
|
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
|
..
|
|
.sp
|
|
\fBWARNING:\fP
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
This page may be out of date and requires review.
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
.sp
|
|
External versioning requires documenting.
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.SH DESCRIPTION
|
|
.sp
|
|
There are 3 types of File Versioning. When you select each in the web interface,
|
|
a short description of each is shown to help you decide.
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
.SH TODO
|
|
.sp
|
|
More detail needed here: Can this be a relative path, or must it be
|
|
an absolute path?
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.sp
|
|
With "Staggered File Versioning" method (only), you would like to specify where
|
|
removed and deleted files are stored as part of the Versioning feature, you can
|
|
specify the path in the "Versions Path" input after this method is selected.
|
|
.SH NO FILE VERSIONING
|
|
.sp
|
|
This is the default setting. With no file versioning, files that are replaced or
|
|
deleted on one device are deleted on other devices that the directory is shared
|
|
with. (Note: If a folder is marked "Master Folder" on a device, that device will
|
|
not accept changes to the files in the folder, and therefore will not have files
|
|
replaced or deleted.)
|
|
.SH SIMPLE FILE VERSIONING
|
|
.sp
|
|
With "Simple File Versioning" files are moved to the ".stversions"
|
|
folder (inside your shared folder) when replaced or deleted on a remote
|
|
device. This option also takes a value in an input titled "Keep
|
|
Versions" which tells Syncthing how many old versions of the file it
|
|
should keep. For example, if you set this value to 5, if a file is
|
|
replaced 5 times on a remote device, you will see 5 time\-stamped
|
|
versions on that file in the ".stversions" folder on the other devices
|
|
sharing the same folder.
|
|
With "Simple File Versioning" files are moved to the ".stversions" folder
|
|
(inside your shared folder) when replaced or deleted on a remote device. This
|
|
option also takes a value in an input titled "Keep Versions" which tells
|
|
Syncthing how many old versions of the file it should keep. For example, if you
|
|
set this value to 5, if a file is replaced 5 times on a remote device, you will
|
|
see 5 time\-stamped versions on that file in the ".stversions" folder on the
|
|
other devices sharing the same folder.
|
|
.SH STAGGERED FILE VERSIONING
|
|
.sp
|
|
With "Staggered File Versioning" files are also moved to the ".stversions"
|
|
folder (inside your shared folder) when replaced or deleted on a remote device
|
|
(just like "Simple File Versioning"), however, Version are automatically deleted
|
|
if they are older than the maximum age or exceed the number of files allowed in
|
|
an interval.
|
|
.sp
|
|
The following intervals are used and they each have a maximum number of files
|
|
that will be kept for each.
|
|
.INDENT 0.0
|
|
.TP
|
|
.B 1 Hour
|
|
For the first hour, the most recent version is kept every 30 seconds.
|
|
.TP
|
|
.B 1 Day
|
|
For the first day, the most recent version is kept every hour.
|
|
.TP
|
|
.B 30 Days
|
|
For the first 30 days, the most recent version is kept every day.
|
|
.TP
|
|
.B Until Maximum Age
|
|
The maximum time to keep a version in days. For example, to keep replaced or
|
|
deleted files in the ".stversions" folder for an entire year, use 365. If
|
|
only or 10 days, use 10. \fBNote: Set to 0 to keep versions forever.\fP
|
|
.UNINDENT
|
|
.SH AUTHOR
|
|
The Syncthing Authors
|
|
.SH COPYRIGHT
|
|
2015, The Syncthing Authors
|
|
.\" Generated by docutils manpage writer.
|
|
.
|