gui, man: Update docs and translations

2017-02-23 07:47:07 +01:00
parent a0e2e7a962
commit 28449f9f5b
50 changed files with 209 additions and 192 deletions
--- a/man/stdiscosrv.1
+++ b/man/stdiscosrv.1
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "STDISCOSRV" "1" "February 06, 2017" "v0.14" "Syncthing"
+.TH "STDISCOSRV" "1" "February 22, 2017" "v0.14" "Syncthing"
 .SH NAME
 stdiscosrv \- Syncthing Discovery Server
 .
--- a/man/strelaysrv.1
+++ b/man/strelaysrv.1
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "STRELAYSRV" "1" "February 06, 2017" "v0.14" "Syncthing"
+.TH "STRELAYSRV" "1" "February 22, 2017" "v0.14" "Syncthing"
 .SH NAME
 strelaysrv \- Syncthing Relay Server
 .
--- a/man/syncthing-bep.7
+++ b/man/syncthing-bep.7
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "SYNCTHING-BEP" "7" "February 06, 2017" "v0.14" "Syncthing"
+.TH "SYNCTHING-BEP" "7" "February 22, 2017" "v0.14" "Syncthing"
 .SH NAME
 syncthing-bep \- Block Exchange Protocol v1
 .
@@ -427,9 +427,9 @@ message FileInfo {
 enum FileInfoType {
    FILE              = 0;
    DIRECTORY         = 1;
-    SYMLINK_FILE      = 2;
-    SYMLINK_DIRECTORY = 3;
-    SYMLINK_UNKNOWN   = 4;
+    SYMLINK_FILE      = 2 [deprecated = true];
+    SYMLINK_DIRECTORY = 3 [deprecated = true];
+    SYMLINK           = 4;
 }

 message BlockInfo {
@@ -465,11 +465,7 @@ operating system conventions. The combination of folder and name uniquely
 identifies each file in a cluster.
 .sp
 The \fBtype\fP field contains the type of the described item. The type is one
-of \fBfile (0)\fP, \fBdirectory (1)\fP, \fBsymlink to file (2)\fP, \fBsymlink to
-directory (3)\fP, or \fBsymlink to unknown target (4)\fP\&. The distinction
-between the various types of symlinks is not required on all operating
-systems \- the implementation SHOULD nonetheless indicate the target type
-when possible.
+of \fBfile (0)\fP, \fBdirectory (1)\fP, or \fBsymlink (4)\fP\&.
 .sp
 The \fBsize\fP field contains the size of the file, in bytes. For directories
 and symlinks the size is zero.
@@ -478,7 +474,7 @@ The \fBpermissions\fP field holds the common Unix permission bits. An
 implementation MAY ignore or interpret these as is suitable on the host
 operating system.
 .sp
-The \fBmodified_ns\fP time is expressed as the number of seconds since the Unix
+The \fBmodified_s\fP time is expressed as the number of seconds since the Unix
 Epoch (1970\-01\-01 00:00:00 UTC). The \fBmodified_ns\fP field holds the
 nanosecond part of the modification time.
 .sp
--- a/man/syncthing-config.5
+++ b/man/syncthing-config.5
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "SYNCTHING-CONFIG" "5" "February 06, 2017" "v0.14" "Syncthing"
+.TH "SYNCTHING-CONFIG" "5" "February 22, 2017" "v0.14" "Syncthing"
 .SH NAME
 syncthing-config \- Syncthing Configuration
 .
@@ -134,7 +134,6 @@ The following shows an example of the default configuration file (IDs will diffe
        <keepTemporariesH>24</keepTemporariesH>
        <cacheIgnoredFiles>false</cacheIgnoredFiles>
        <progressUpdateIntervalS>5</progressUpdateIntervalS>
-        <symlinksEnabled>true</symlinksEnabled>
        <limitBandwidthInLan>false</limitBandwidthInLan>
        <minHomeDiskFreePct>1</minHomeDiskFreePct>
        <releasesURL>https://api.github.com/repos/syncthing/syncthing/releases?per_page=30</releasesURL>
@@ -518,7 +517,6 @@ If set, this is the API key that enables usage of the REST interface.
    <keepTemporariesH>24</keepTemporariesH>
    <cacheIgnoredFiles>false</cacheIgnoredFiles>
    <progressUpdateIntervalS>5</progressUpdateIntervalS>
-    <symlinksEnabled>true</symlinksEnabled>
    <limitBandwidthInLan>false</limitBandwidthInLan>
    <minHomeDiskFreePct>1</minHomeDiskFreePct>
    <releasesURL>https://api.github.com/repos/syncthing/syncthing/releases?per_page=30</releasesURL>
@@ -640,11 +638,6 @@ ignores is usually not significant.
 How often in seconds the progress of ongoing downloads is made available to
 the GUI.
 .TP
-.B symlinksEnabled
-Whether to sync symlinks, if supported by the system. Symlinks are supported
-on all platforms except for Windows, where they are ignored. Syncthing does
-not differentiate between different types of symlinks.
-.TP
 .B limitBandwidthInLan
 Whether to apply bandwidth limits to devices in the same broadcast domain
 as the local device.
--- a/man/syncthing-device-ids.7
+++ b/man/syncthing-device-ids.7
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "SYNCTHING-DEVICE-IDS" "7" "February 06, 2017" "v0.14" "Syncthing"
+.TH "SYNCTHING-DEVICE-IDS" "7" "February 22, 2017" "v0.14" "Syncthing"
 .SH NAME
 syncthing-device-ids \- Understanding Device IDs
 .
--- a/man/syncthing-event-api.7
+++ b/man/syncthing-event-api.7
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "SYNCTHING-EVENT-API" "7" "February 06, 2017" "v0.14" "Syncthing"
+.TH "SYNCTHING-EVENT-API" "7" "February 22, 2017" "v0.14" "Syncthing"
 .SH NAME
 syncthing-event-api \- Event API
 .
@@ -44,8 +44,9 @@ calls is long some events might be missed. This can be detected by noting a
 discontinuity in the event IDs.
 .sp
 If no new events are produced since \fB<lastSeenID>\fP, the HTTP call blocks and
-waits for new events to happen before returning, or if no new events are
-produced within 60 seconds, times out.
+waits for new events to happen before returning. By default it times out after
+60 seconds returning an empty array. The time out duration can be customized
+with the optional parameter \fBtimeout=seconds\fP\&.
 .sp
 To receive only a limited number of events, add the \fBlimit=n\fP parameter with a
 suitable value for \fBn\fP and only the \fIlast\fP \fBn\fP events will be returned. This
@@ -618,26 +619,6 @@ changes during a scan.
 .fi
 .UNINDENT
 .UNINDENT
-.SS Ping
-.sp
-The Ping event is generated automatically every 60 seconds. This means
-that even in the absence of any other activity, the event polling HTTP
-request will return within a minute.
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-{
-    "id": 46,
-    "type": "Ping",
-    "time": "2014\-07\-13T21:13:18.502171586+02:00",
-    "data": null
-}
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
 .SS RemoteIndexUpdated
 .sp
 Generated each time new index information is received from a device.
--- a/man/syncthing-faq.7
+++ b/man/syncthing-faq.7
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "SYNCTHING-FAQ" "7" "February 06, 2017" "v0.14" "Syncthing"
+.TH "SYNCTHING-FAQ" "7" "February 22, 2017" "v0.14" "Syncthing"
 .SH NAME
 syncthing-faq \- Frequently Asked Questions
 .
@@ -77,9 +77,7 @@ The following may be synchronized or not, depending:
 File Permissions (When supported by file system. On Windows, only the
 read only bit is synchronized.)
 .IP \(bu 2
-Symbolic Links (When supported by the OS. On Windows Vista and up,
-requires administrator privileges. Links are synced as is and are not
-followed.)
+Symbolic Links (Except on Windows.)
 .UNINDENT
 .sp
 The following are \fInot\fP synchronized;
--- a/man/syncthing-globaldisco.7
+++ b/man/syncthing-globaldisco.7
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "SYNCTHING-GLOBALDISCO" "7" "February 06, 2017" "v0.14" "Syncthing"
+.TH "SYNCTHING-GLOBALDISCO" "7" "February 22, 2017" "v0.14" "Syncthing"
 .SH NAME
 syncthing-globaldisco \- Global Discovery Protocol v3
 .
--- a/man/syncthing-localdisco.7
+++ b/man/syncthing-localdisco.7
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "SYNCTHING-LOCALDISCO" "7" "February 06, 2017" "v0.14" "Syncthing"
+.TH "SYNCTHING-LOCALDISCO" "7" "February 22, 2017" "v0.14" "Syncthing"
 .SH NAME
 syncthing-localdisco \- Local Discovery Protocol v4
 .
--- a/man/syncthing-networking.7
+++ b/man/syncthing-networking.7
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "SYNCTHING-NETWORKING" "7" "February 06, 2017" "v0.14" "Syncthing"
+.TH "SYNCTHING-NETWORKING" "7" "February 22, 2017" "v0.14" "Syncthing"
 .SH NAME
 syncthing-networking \- Firewall Setup
 .
--- a/man/syncthing-relay.7
+++ b/man/syncthing-relay.7
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "SYNCTHING-RELAY" "7" "February 06, 2017" "v0.14" "Syncthing"
+.TH "SYNCTHING-RELAY" "7" "February 22, 2017" "v0.14" "Syncthing"
 .SH NAME
 syncthing-relay \- Relay Protocol v1
 .
--- a/man/syncthing-rest-api.7
+++ b/man/syncthing-rest-api.7
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "SYNCTHING-REST-API" "7" "February 06, 2017" "v0.14" "Syncthing"
+.TH "SYNCTHING-REST-API" "7" "February 22, 2017" "v0.14" "Syncthing"
 .SH NAME
 syncthing-rest-api \- REST API
 .
@@ -887,8 +887,9 @@ calls is long some events might be missed. This can be detected by noting a
 discontinuity in the event IDs.
 .sp
 If no new events are produced since \fB<lastSeenID>\fP, the HTTP call blocks and
-waits for new events to happen before returning, or if no new events are
-produced within 60 seconds, times out.
+waits for new events to happen before returning. By default it times out after
+60 seconds returning an empty array. The time out duration can be customized
+with the optional parameter \fBtimeout=seconds\fP\&.
 .sp
 To receive only a limited number of events, add the \fBlimit=n\fP parameter with a
 suitable value for \fBn\fP and only the \fIlast\fP \fBn\fP events will be returned. This
@@ -1461,26 +1462,6 @@ changes during a scan.
 .fi
 .UNINDENT
 .UNINDENT
-.SS Ping
-.sp
-The Ping event is generated automatically every 60 seconds. This means
-that even in the absence of any other activity, the event polling HTTP
-request will return within a minute.
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-{
-    "id": 46,
-    "type": "Ping",
-    "time": "2014\-07\-13T21:13:18.502171586+02:00",
-    "data": null
-}
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
 .SS RemoteIndexUpdated
 .sp
 Generated each time new index information is received from a device.
--- a/man/syncthing-security.7
+++ b/man/syncthing-security.7
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "SYNCTHING-SECURITY" "7" "February 06, 2017" "v0.14" "Syncthing"
+.TH "SYNCTHING-SECURITY" "7" "February 22, 2017" "v0.14" "Syncthing"
 .SH NAME
 syncthing-security \- Security Principles
 .
--- a/man/syncthing-stignore.5
+++ b/man/syncthing-stignore.5
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "SYNCTHING-STIGNORE" "5" "February 06, 2017" "v0.14" "Syncthing"
+.TH "SYNCTHING-STIGNORE" "5" "February 22, 2017" "v0.14" "Syncthing"
 .SH NAME
 syncthing-stignore \- Prevent files from being synchronized to other nodes
 .
--- a/man/syncthing-versioning.7
+++ b/man/syncthing-versioning.7
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "SYNCTHING-VERSIONING" "7" "February 06, 2017" "v0.14" "Syncthing"
+.TH "SYNCTHING-VERSIONING" "7" "February 22, 2017" "v0.14" "Syncthing"
 .SH NAME
 syncthing-versioning \- Keep automatic backups of deleted files by other nodes
 .
--- a/man/syncthing.1
+++ b/man/syncthing.1
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "SYNCTHING" "1" "February 06, 2017" "v0.14" "Syncthing"
+.TH "SYNCTHING" "1" "February 22, 2017" "v0.14" "Syncthing"
 .SH NAME
 syncthing \- Syncthing
 .