Update docs & translations

2015-11-09 14:00:10 +01:00
parent b9b630e3b6
commit 74a2e80142
19 changed files with 185 additions and 136 deletions
--- a/man/syncthing-bep.7
+++ b/man/syncthing-bep.7
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "SYNCTHING-BEP" "7" "November 04, 2015" "v0.12" "Syncthing"
+.TH "SYNCTHING-BEP" "7" "November 09, 2015" "v0.12" "Syncthing"
 .SH NAME
 syncthing-bep \- Block Exchange Protocol v1
 .
--- a/man/syncthing-config.5
+++ b/man/syncthing-config.5
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "SYNCTHING-CONFIG" "5" "November 04, 2015" "v0.12" "Syncthing"
+.TH "SYNCTHING-CONFIG" "5" "November 09, 2015" "v0.12" "Syncthing"
 .SH NAME
 syncthing-config \- Syncthing Configuration
 .
@@ -598,6 +598,22 @@ the configuration and index.
 .B releasesURL
 The URL from which release information is loaded, for automatic upgrades.
 .UNINDENT
+.SH SYNCING CONFIGURATION FILES
+.sp
+Syncing configuration files between devices (such that multiple devices are
+using the same configuration files) can cause issues. This is easy to do
+accidentally if you sync your home folder between devices. A common symptom
+of syncing configuration files is two devices ending up with the same Device ID.
+.sp
+If you want to use syncthing to backup your configuration files, it is recommended
+that the files you are backing up are in a folder\-master to prevent other
+devices from overwriting the per device configuration. The folder on the remote
+device(s) should not be used as configuration for the remote devices.
+.sp
+If you\(aqd like to sync your home folder in non\-master mode, you may add the
+folder that stores the configuration files to the ignore list\&.
+If you\(aqd also like to backup your configuration files, add another folder in
+master mode for just the configuration folder.
 .SH AUTHOR
 The Syncthing Authors
 .SH COPYRIGHT
--- 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" "November 04, 2015" "v0.12" "Syncthing"
+.TH "SYNCTHING-DEVICE-IDS" "7" "November 09, 2015" "v0.12" "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" "November 04, 2015" "v0.12" "Syncthing"
+.TH "SYNCTHING-EVENT-API" "7" "November 09, 2015" "v0.12" "Syncthing"
 .SH NAME
 syncthing-event-api \- Event API
 .
--- a/man/syncthing-faq.7
+++ b/man/syncthing-faq.7
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "SYNCTHING-FAQ" "7" "November 04, 2015" "v0.12" "Syncthing"
+.TH "SYNCTHING-FAQ" "7" "November 09, 2015" "v0.12" "Syncthing"
 .SH NAME
 syncthing-faq \- Frequently Asked Questions
 .
--- a/man/syncthing-globaldisco.7
+++ b/man/syncthing-globaldisco.7
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "SYNCTHING-GLOBALDISCO" "7" "November 04, 2015" "v0.12" "Syncthing"
+.TH "SYNCTHING-GLOBALDISCO" "7" "November 09, 2015" "v0.12" "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" "November 04, 2015" "v0.12" "Syncthing"
+.TH "SYNCTHING-LOCALDISCO" "7" "November 09, 2015" "v0.12" "Syncthing"
 .SH NAME
 syncthing-localdisco \- Local Discovery Protocol v3
 .
--- a/man/syncthing-networking.7
+++ b/man/syncthing-networking.7
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "SYNCTHING-NETWORKING" "7" "November 04, 2015" "v0.12" "Syncthing"
+.TH "SYNCTHING-NETWORKING" "7" "November 09, 2015" "v0.12" "Syncthing"
 .SH NAME
 syncthing-networking \- Firewall Setup
 .
--- 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" "November 04, 2015" "v0.12" "Syncthing"
+.TH "SYNCTHING-REST-API" "7" "November 09, 2015" "v0.12" "Syncthing"
 .SH NAME
 syncthing-rest-api \- REST API
 .
@@ -83,30 +83,63 @@ the corresponding GET request. The configuration will be saved to disk and the
 \fBconfigInSync\fP flag set to false. Restart Syncthing to activate.
 .SS GET /rest/system/connections
 .sp
-Returns the list of current connections and some metadata associated
-with the connection/peer.
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+Return format changed in 0.12.0.
+.UNINDENT
+.UNINDENT
+.sp
+Returns the list of configured devices and some metadata associated
+with them. The list also contains the local device itself as not connected.
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
 {
-  "connections": {
-    "SMAHWLH\-AP74FAB\-QWLDYGV\-Q65ASPL\-GAAR2TB\-KEF5FLB\-DRLZCPN\-DJBFZAG": {
-      "address": "172.21.20.78:22000",
-      "at": "2015\-03\-16T21:51:38.672758819+01:00",
-      "clientVersion": "v0.10.27",
-      "inBytesTotal": 415980,
-      "outBytesTotal": 396300
-    }
-  },
-  "total": {
-    "address": "",
-    "at": "2015\-03\-16T21:51:38.672868814+01:00",
-    "clientVersion": "",
-    "inBytesTotal": 415980,
-    "outBytesTotal": 396300
-  }
+   "total" : {
+          "paused" : false,
+          "clientVersion" : "",
+          "at" : "2015\-11\-07T17:29:47.691637262+01:00",
+          "connected" : false,
+          "inBytesTotal" : 1479,
+          "type" : "direct\-accept",
+          "outBytesTotal" : 1318,
+          "address" : ""
+   },
+   "connections" : {
+          "YZJBJFX\-RDBL7WY\-6ZGKJ2D\-4MJB4E7\-ZATSDUY\-LD6Y3L3\-MLFUYWE\-AEMXJAC" : {
+             "connected" : true,
+             "inBytesTotal" : 556,
+             "paused" : false,
+             "at" : "2015\-11\-07T17:29:47.691548971+01:00",
+             "clientVersion" : "v0.12.1",
+             "address" : "127.0.0.1:22002",
+             "type" : "direct\-dial",
+             "outBytesTotal" : 550
+          },
+          "DOVII4U\-SQEEESM\-VZ2CVTC\-CJM4YN5\-QNV7DCU\-5U3ASRL\-YVFG6TH\-W5DV5AA" : {
+             "outBytesTotal" : 0,
+             "type" : "direct\-accept",
+             "address" : "",
+             "at" : "0001\-01\-01T00:00:00Z",
+             "clientVersion" : "",
+             "paused" : false,
+             "inBytesTotal" : 0,
+             "connected" : false
+          },
+          "UYGDMA4\-TPHOFO5\-2VQYDCC\-7CWX7XW\-INZINQT\-LE4B42N\-4JUZTSM\-IWCSXA4" : {
+             "address" : "",
+             "type" : "direct\-accept",
+             "outBytesTotal" : 0,
+             "connected" : false,
+             "inBytesTotal" : 0,
+             "paused" : false,
+             "at" : "0001\-01\-01T00:00:00Z",
+             "clientVersion" : ""
+          }
+   }
 }
 .ft P
 .fi
--- a/man/syncthing-security.7
+++ b/man/syncthing-security.7
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "SYNCTHING-SECURITY" "7" "November 04, 2015" "v0.12" "Syncthing"
+.TH "SYNCTHING-SECURITY" "7" "November 09, 2015" "v0.12" "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" "November 04, 2015" "v0.12" "Syncthing"
+.TH "SYNCTHING-STIGNORE" "5" "November 09, 2015" "v0.12" "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 "TODO" "7" "November 04, 2015" "v0.12" "Syncthing"
+.TH "TODO" "7" "November 09, 2015" "v0.12" "Syncthing"
 .SH NAME
 Todo \- 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" "November 04, 2015" "v0.12" "Syncthing"
+.TH "SYNCTHING" "1" "November 09, 2015" "v0.12" "Syncthing"
 .SH NAME
 syncthing \- Syncthing
 .