From ca908270ec88a90ab5bf103bb7664640920d1a34 Mon Sep 17 00:00:00 2001 From: Jakob Borg Date: Wed, 18 Aug 2021 07:45:38 +0200 Subject: [PATCH] gui, man, authors: Update docs, translations, and contributors --- gui/default/assets/lang/lang-bg.json | 2 +- gui/default/assets/lang/lang-ja.json | 18 +++--- man/stdiscosrv.1 | 2 +- man/strelaysrv.1 | 2 +- man/syncthing-bep.7 | 2 +- man/syncthing-config.5 | 93 ++++++++++++++-------------- man/syncthing-device-ids.7 | 2 +- man/syncthing-event-api.7 | 2 +- man/syncthing-faq.7 | 44 ++++++------- man/syncthing-globaldisco.7 | 2 +- man/syncthing-localdisco.7 | 2 +- man/syncthing-networking.7 | 2 +- man/syncthing-relay.7 | 2 +- man/syncthing-rest-api.7 | 2 +- man/syncthing-security.7 | 2 +- man/syncthing-stignore.5 | 2 +- man/syncthing-versioning.7 | 2 +- man/syncthing.1 | 2 +- 18 files changed, 94 insertions(+), 91 deletions(-) diff --git a/gui/default/assets/lang/lang-bg.json b/gui/default/assets/lang/lang-bg.json index 4758d22c3..3ea4f7e76 100644 --- a/gui/default/assets/lang/lang-bg.json +++ b/gui/default/assets/lang/lang-bg.json @@ -42,7 +42,7 @@ "Available debug logging facilities:": "Достъпни улеснения при отстраняване на дефекти:", "Be careful!": "Внимание!", "Bugs": "Дефекти", - "Cancel": "Cancel", + "Cancel": "Отказ", "Changelog": "Дневник на промените", "Clean out after": "Почистване след", "Cleaning Versions": "Cleaning Versions", diff --git a/gui/default/assets/lang/lang-ja.json b/gui/default/assets/lang/lang-ja.json index 1b6f356a0..cc7035ced 100644 --- a/gui/default/assets/lang/lang-ja.json +++ b/gui/default/assets/lang/lang-ja.json @@ -18,7 +18,7 @@ "Advanced": "高度な設定", "Advanced Configuration": "高度な設定", "All Data": "全てのデータ", - "All folders shared with this device must be protected by a password, such that all sent data is unreadable without the given password.": "All folders shared with this device must be protected by a password, such that all sent data is unreadable without the given password.", + "All folders shared with this device must be protected by a password, such that all sent data is unreadable without the given password.": "このデバイスと共有するすべてのフォルダーはパスワードによって保護されなければならず、送信されたすべてのデータは指定したパスワードがなければ読み取れません。", "Allow Anonymous Usage Reporting?": "匿名で使用状況をレポートすることを許可しますか?", "Allowed Networks": "許可されているネットワーク", "Alphabetic": "アルファベット順", @@ -38,7 +38,7 @@ "Automatic upgrade now offers the choice between stable releases and release candidates.": "自動アップグレードは、安定版とリリース候補版のいずれかを選べるようになりました。", "Automatic upgrades": "自動アップグレード", "Automatic upgrades are always enabled for candidate releases.": "Automatic upgrades are always enabled for candidate releases.", - "Automatically create or share folders that this device advertises at the default path.": "Automatically create or share folders that this device advertises at the default path.", + "Automatically create or share folders that this device advertises at the default path.": "このデバイスが通知するデフォルトのパスで自動的にフォルダを作成、共有します。", "Available debug logging facilities:": "Available debug logging facilities:", "Be careful!": "注意!", "Bugs": "バグ", @@ -76,7 +76,7 @@ "Deleted": "削除", "Deselect All": "すべて選択解除", "Deselect devices to stop sharing this folder with.": "このフォルダの共有を停止したいデバイスがある場合は、当該デバイスの選択を解除してください。", - "Deselect folders to stop sharing with this device.": "Deselect folders to stop sharing with this device.", + "Deselect folders to stop sharing with this device.": "このデバイスとの共有を停止するフォルダーを選択解除します。", "Device": "デバイス", "Device \"{%name%}\" ({%device%} at {%address%}) wants to connect. Add new device?": "デバイス「{{name}}」 ({{address}} の {{device}}) が接続を求めています。新しいデバイスとして追加しますか?", "Device ID": "デバイスID", @@ -120,7 +120,7 @@ "Enabled": "有効", "Enter a non-negative number (e.g., \"2.35\") and select a unit. Percentages are as part of the total disk size.": "0以上の数 (例: 2.35) を入力し、単位を選択してください。パーセントはディスク容量全体に対する割合です。", "Enter a non-privileged port number (1024 - 65535).": "非特権ポート番号 (1024 - 65535) を入力してください。", - "Enter comma separated (\"tcp://ip:port\", \"tcp://host:port\") addresses or \"dynamic\" to perform automatic discovery of the address.": "Enter comma separated (\"tcp://ip:port\", \"tcp://host:port\") addresses or \"dynamic\" to perform automatic discovery of the address.", + "Enter comma separated (\"tcp://ip:port\", \"tcp://host:port\") addresses or \"dynamic\" to perform automatic discovery of the address.": "カンマ区切りのアドレス(\"tcp://ip:port\", \"tcp://host:port\")を入力するか、「dynamic」でアドレスの自動検出を行います。", "Enter ignore patterns, one per line.": "無視するファイル名のパターンを、一行につき一条件で入力してください。", "Enter up to three octal digits.": "Enter up to three octal digits.", "Error": "エラー", @@ -151,7 +151,7 @@ "GUI": "GUI", "GUI Authentication Password": "GUI認証パスワード", "GUI Authentication User": "GUI認証ユーザー名", - "GUI Authentication: Set User and Password": "GUI Authentication: Set User and Password", + "GUI Authentication: Set User and Password": "GUI認証: ユーザーとパスワードを設定", "GUI Listen Address": "GUI待ち受けアドレス", "GUI Theme": "GUIテーマ", "General": "一般", @@ -164,7 +164,7 @@ "However, your current settings indicate you might not want it enabled. We have disabled automatic crash reporting for you.": "However, your current settings indicate you might not want it enabled. We have disabled automatic crash reporting for you.", "Identification": "Identification", "If untrusted, enter encryption password": "信頼しない場合、暗号化パスワードを入力", - "If you want to prevent other users on this computer from accessing Syncthing and through it your files, consider setting up authentication.": "If you want to prevent other users on this computer from accessing Syncthing and through it your files, consider setting up authentication.", + "If you want to prevent other users on this computer from accessing Syncthing and through it your files, consider setting up authentication.": "このコンピューター上の他のユーザーがSyncthingやあなたのファイルにアクセスできないようにしたい場合は、認証の設定を検討してください。", "Ignore": "無視", "Ignore Patterns": "無視するファイル名", "Ignore Permissions": "パーミッションを無視する", @@ -283,7 +283,7 @@ "Select All": "すべて選択", "Select a version": "バージョンを選択してください", "Select additional devices to share this folder with.": "このフォルダの共有に追加したいデバイスがある場合は、当該デバイスを選択してください。", - "Select additional folders to share with this device.": "Select additional folders to share with this device.", + "Select additional folders to share with this device.": "このデバイスと共有する追加のフォルダーを選択します。", "Select latest version": "最も新しいバージョンを選択", "Select oldest version": "最も古いバージョンを選択", "Select the folders to share with this device.": "このデバイスと共有するフォルダーを選択してください。", @@ -337,7 +337,7 @@ "Syncthing seems to be down, or there is a problem with your Internet connection. Retrying…": "Syncthingが落ちているか、インターネット接続に問題があります。リトライ中です…", "Syncthing seems to be experiencing a problem processing your request. Please refresh the page or restart Syncthing if the problem persists.": "リクエストの処理に問題があるようです。問題が継続する場合、ページを更新するかSyncthingを再起動してください。", "Take me back": "キャンセル", - "The GUI address is overridden by startup options. Changes here will not take effect while the override is in place.": "The GUI address is overridden by startup options. Changes here will not take effect while the override is in place.", + "The GUI address is overridden by startup options. Changes here will not take effect while the override is in place.": "GUIアドレスはスタートアップオプションによってオーバーライドされます。ここでの変更はオーバーライドが行われている間は有効になりません。", "The Syncthing Authors": "The Syncthing Authors", "The Syncthing admin interface is configured to allow remote access without a password.": "Syncthingの管理画面が、パスワードなしで外部からアクセスできるように設定されています。", "The aggregated statistics are publicly available at the URL below.": "集計結果は以下のURLで公開されています。", @@ -402,7 +402,7 @@ "Usage reporting is always enabled for candidate releases.": "リリース候補版では常に使用状況レポートが送信されます。", "Use HTTPS for GUI": "GUIにHTTPSを使用する", "Use notifications from the filesystem to detect changed items.": "Use notifications from the filesystem to detect changed items.", - "Username/Password has not been set for the GUI authentication. Please consider setting it up.": "Username/Password has not been set for the GUI authentication. Please consider setting it up.", + "Username/Password has not been set for the GUI authentication. Please consider setting it up.": "GUI認証のためのユーザー名/パスワードが設定されていません。設定を検討してください。", "Version": "バージョン", "Versions": "バージョン", "Versions Path": "古いバージョンを保存するパス", diff --git a/man/stdiscosrv.1 b/man/stdiscosrv.1 index 655c2ac42..108c96279 100644 --- a/man/stdiscosrv.1 +++ b/man/stdiscosrv.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "STDISCOSRV" "1" "Jul 31, 2021" "v1" "Syncthing" +.TH "STDISCOSRV" "1" "Aug 17, 2021" "v1" "Syncthing" .SH NAME stdiscosrv \- Syncthing Discovery Server .SH SYNOPSIS diff --git a/man/strelaysrv.1 b/man/strelaysrv.1 index 821fdbb31..18be1d97d 100644 --- a/man/strelaysrv.1 +++ b/man/strelaysrv.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "STRELAYSRV" "1" "Jul 31, 2021" "v1" "Syncthing" +.TH "STRELAYSRV" "1" "Aug 17, 2021" "v1" "Syncthing" .SH NAME strelaysrv \- Syncthing Relay Server .SH SYNOPSIS diff --git a/man/syncthing-bep.7 b/man/syncthing-bep.7 index 8a77c28a4..2c6bbb1c9 100644 --- a/man/syncthing-bep.7 +++ b/man/syncthing-bep.7 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-BEP" "7" "Jul 31, 2021" "v1" "Syncthing" +.TH "SYNCTHING-BEP" "7" "Aug 17, 2021" "v1" "Syncthing" .SH NAME syncthing-bep \- Block Exchange Protocol v1 .SH INTRODUCTION AND DEFINITIONS diff --git a/man/syncthing-config.5 b/man/syncthing-config.5 index f6b66b0de..ddf0b79f6 100644 --- a/man/syncthing-config.5 +++ b/man/syncthing-config.5 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-CONFIG" "5" "Jul 31, 2021" "v1" "Syncthing" +.TH "SYNCTHING-CONFIG" "5" "Aug 17, 2021" "v1" "Syncthing" .SH NAME syncthing-config \- Syncthing Configuration .SH SYNOPSIS @@ -247,7 +247,7 @@ GUI. .B ignoredFolder Contains the ID of the folder that should be ignored. This folder will always be skipped when advertised from a remote device, i.e. this will be -logged, but there will be no dialog about it in the web GUI. +logged, but there will be no dialog shown in the web GUI. .UNINDENT .SH FOLDER ELEMENT .INDENT 0.0 @@ -291,7 +291,7 @@ element: .INDENT 0.0 .TP .B id -The folder ID, must be unique. (mandatory) +The folder ID, which must be unique. (mandatory) .TP .B label The label of a folder is a human readable and descriptive local name. May @@ -323,17 +323,17 @@ changes to other devices. .UNINDENT .TP .B rescanIntervalS -The rescan interval, in seconds. Can be set to zero to disable when external +The rescan interval, in seconds. Can be set to \fB0\fP to disable when external plugins are used to trigger rescans. .TP .B fsWatcherEnabled -If enabled this detects changes to files in the folder and scans them. +If set to \fBtrue\fP, this detects changes to files in the folder and scans them. .UNINDENT .INDENT 0.0 .TP .B fsWatcherDelayS The duration during which changes detected are accumulated, before a scan is -scheduled (only takes effect if \fBfsWatcherEnabled\fP is true). +scheduled (only takes effect if \fBfsWatcherEnabled\fP is set to \fBtrue\fP). .TP .B ignorePerms True if the folder should ignore permissions. @@ -374,8 +374,8 @@ versioning .INDENT 0.0 .TP .B copiers, pullers, hashers -The number of copier, puller and hasher routines to use, or zero for the -system determined optimum. These are low level performance options for +The number of copier, puller and hasher routines to use, or \fB0\fP for the +system determined optimums. These are low level performance options for advanced users only; do not change unless requested to or you’ve actually read and understood the code yourself. :) .TP @@ -409,29 +409,29 @@ the 1 KB becomes known to the pulling device. \fBWARNING:\fP .INDENT 7.0 .INDENT 3.5 -Enabling this is highly not recommended \- use at your own risk. +Enabling this is highly discouraged \- use at your own risk. You have been warned. .UNINDENT .UNINDENT .sp -When set to true, this device will pretend not to see instructions to +When set to \fBtrue\fP, this device will pretend not to see instructions to delete files from other devices. .TP .B scanProgressIntervalS -The interval with which scan progress information is sent to the GUI. Zero -means the default value (two seconds). +The interval in seconds with which scan progress information is sent to the GUI. Setting to \fB0\fP +will cause Syncthing to use the default value of two. .TP .B pullerPauseS Tweak for rate limiting the puller when it retries pulling files. Don’t -change these unless you know what you’re doing. +change this unless you know what you’re doing. .TP .B maxConflicts The maximum number of conflict copies to keep around for any given file. -The default, \-1, means an unlimited number. Setting this to zero disables +The default, \fB\-1\fP, means an unlimited number. Setting this to \fB0\fP disables conflict copies altogether. .TP .B disableSparseFiles -By default, blocks containing all zeroes are not written, causing files -to be sparse on filesystems that support the concept. When set to true, +By default, blocks containing all zeros are not written, causing files +to be sparse on filesystems that support this feature. When set to \fBtrue\fP, sparse files will not be created. .TP .B disableTempIndexes @@ -439,33 +439,33 @@ By default, devices exchange information about blocks available in transfers that are still in progress, which allows other devices to download parts of files that are not yet fully downloaded on your own device, essentially making transfers more torrent like. When set to -true, such information is not exchanged for this folder. +\fBtrue\fP, such information is not exchanged for this folder. .TP .B paused True if this folder is (temporarily) suspended. .TP .B weakHashThresholdPct Use weak hash if more than the given percentage of the file has changed. Set -to \-1 to always use weak hash. Default value is 25. +to \fB\-1\fP to always use weak hash. Default is \fB25\fP\&. .TP .B markerName Name of a directory or file in the folder root to be used as -marker\-faq\&. Default is “.stfolder”. +marker\-faq\&. Default is \fB\&.stfolder\fP\&. .TP .B copyOwnershipFromParent On Unix systems, tries to copy file/folder ownership from the parent directory (the directory it’s located in). -Requires running Syncthing as privileged user, or granting it additional capabilities (e.g. CAP_CHOWN on Linux). +Requires running Syncthing as a privileged user, or granting it additional capabilities (e.g. CAP_CHOWN on Linux). .TP .B modTimeWindowS Allowed modification timestamp difference when comparing files for equivalence. To be used on file systems which have unstable modification timestamps that might change after being recorded -during the last write operation. Defaults to 2 on Android when the -folder is located on a FAT partition, and always to 0 elsewhere. +during the last write operation. Default is \fB2\fP on Android when the +folder is located on a FAT partition, and \fB0\fP otherwise. .TP .B maxConcurrentWrites -Maximum number of concurrent write operations while syncing. Defaults to 2. Increasing this might increase or -decrease disk performance, depending on the underlying storage. +Maximum number of concurrent write operations while syncing. Increasing this might increase or +decrease disk performance, depending on the underlying storage. Default is \fB2\fP\&. .UNINDENT .sp disableFsync @@ -494,7 +494,7 @@ Available options: .TP .B standard (default): The blocks of a file are split into N equal continuous sequences, where N is the number of connected -devices. Each device starts downloading it’s own sequence, after which it picks other devices +devices. Each device starts downloading its own sequence, after which it picks other devices sequences at random. Provides acceptable data distribution and minimal spinning disk strain. .TP .B random: @@ -596,10 +596,10 @@ to even if the original introducer is no longer listing the remote device as kno Defines which device has introduced us to this device. Used only for following de\-introductions. .TP .B certName -The device certificate common name, if it is not the default “syncthing”. +The device certificate’s common name, if it is not the default “syncthing”. .UNINDENT .sp -From following child elements at least one \fBaddress\fP child must exist. +From the following child elements at least one \fBaddress\fP child must exist. .INDENT 0.0 .TP .B address @@ -706,8 +706,8 @@ If not \fBtrue\fP, the GUI and API will not be started. .TP .B tls If set to \fBtrue\fP, TLS (HTTPS) will be enforced. Non\-HTTPS requests will -be redirected to HTTPS. When this is set to \fBfalse\fP, TLS connections are -still possible but it is not mandatory. +be redirected to HTTPS. When set to \fBfalse\fP, TLS connections are +still possible but not required. .TP .B debugging This enables profiling and additional debugging endpoints in the rest\-api\&. @@ -721,10 +721,10 @@ Set the listen address. One address element must be present. Allowed address for .INDENT 7.0 .TP .B IPv4 address and port (\fB127.0.0.1:8384\fP) -The address and port is used as given. +The address and port are used as given. .TP .B IPv6 address and port (\fB[::1]:8384\fP) -The address and port is used as given. The address must be enclosed in +The address and port are used as given. The address must be enclosed in square brackets. .TP .B Wildcard and port (\fB0.0.0.0:12345\fP, \fB[::]:12345\fP, \fB:12345\fP) @@ -733,11 +733,11 @@ interfaces via both IPv4 and IPv6. .TP .B UNIX socket location (\fB/var/run/st.sock\fP) If the address is an absolute path it is interpreted as the path to a UNIX socket. -(Added in v0.14.52.) .UNINDENT .TP .B unixSocketPermissions -In the case that a UNIX socket location is used for \fBaddress\fP, set this to an octal to override the default permissions of the socket. +When \fBaddress\fP is set to a UNIX socket location, set this to an octal value +to override the default permissions of the socket. .TP .B user Set to require authentication. @@ -756,8 +756,8 @@ without authorization. A warning will displayed about this setting on startup. The name of the theme to use. .TP .B authMode -Authentication mode to use. If not present authentication mode (static) -is controlled by presence of user/password fields for backward compatibility. +Authentication mode to use. If not present, the authentication mode (static) +is controlled by the presence of user/password fields for backward compatibility. .INDENT 7.0 .TP .B static @@ -792,7 +792,7 @@ LDAP server address (server:port). .TP .B bindDN BindDN for user authentication. -Special %s variable should be used to pass username to LDAP. +Special \fB%s\fP variable should be used to pass username to LDAP. .UNINDENT .sp transport @@ -814,7 +814,7 @@ StartTLS connection mode. .INDENT 0.0 .TP .B insecureSkipVerify -Skip verification (true or false). +Skip verification (\fBtrue\fP or \fBfalse\fP). .UNINDENT .SH OPTIONS ELEMENT .INDENT 0.0 @@ -878,12 +878,12 @@ The \fBoptions\fP element contains all other global configuration options. .TP .B listenAddress The listen address for incoming sync connections. See -\fI\%Listen Addresses\fP for allowed syntax. +\fI\%Listen Addresses\fP for the allowed syntax. .TP .B globalAnnounceServer A URI to a global announce (discovery) server, or the word \fBdefault\fP to include the default servers. Any number of globalAnnounceServer elements -may be present. The syntax for non\-default entries is that of a HTTP or +may be present. The syntax for non\-default entries is that of an HTTP or HTTPS URL. A number of options may be added as query options to the URL: \fBinsecure\fP to prevent certificate validation (required for HTTP URLs) and \fBid=\fP to perform certificate pinning. The device ID to @@ -914,7 +914,7 @@ The number of seconds to wait between each attempt to connect to currently unconnected devices. .TP .B relaysEnabled -When true, relays will be connected to and potentially used for device to device connections. +When \fBtrue\fP, relays will be connected to and potentially used for device to device connections. .TP .B relayReconnectIntervalM Sets the interval, in minutes, between relay reconnect attempts. @@ -956,19 +956,19 @@ When true, the UR URL can be http instead of https, or have a self\-signed certificate. The default is \fBfalse\fP\&. .TP .B urInitialDelayS -The time to wait from startup to the first usage report being sent. Allows +The time to wait from startup for the first usage report to be sent. Allows the system to stabilize before reporting statistics. .TP .B restartOnWakeup Whether to perform a restart of Syncthing when it is detected that we are -waking from sleep mode (i.e. a folded up laptop). +waking from sleep mode (i.e. an unfolding laptop). .TP .B autoUpgradeIntervalH -Check for a newer version after this many hours. Set to zero to disable +Check for a newer version after this many hours. Set to \fB0\fP to disable automatic upgrades. .TP .B upgradeToPreReleases -If true, automatic upgrades include release candidates (see +If \fBtrue\fP, automatic upgrades include release candidates (see releases). .TP .B keepTemporariesH @@ -1048,7 +1048,10 @@ as part of launching Syncthing, set this option to \fBfalse\fP\&. .UNINDENT .SS Listen Addresses .sp -The following address types are accepted in sync protocol listen addresses. If you want Syncthing to listen on multiple addresses, you can either: add multiple \fB\fP tags in the configuration file or enter several addresses separated by commas in the GUI. +The following address types are accepted in sync protocol listen addresses. +If you want Syncthing to listen on multiple addresses, you can either: add +multiple \fB\fP tags in the configuration file or enter several +addresses separated by commas in the GUI. .INDENT 0.0 .TP .B Default listen addresses (\fBdefault\fP) diff --git a/man/syncthing-device-ids.7 b/man/syncthing-device-ids.7 index fe3515d16..fbc5fa793 100644 --- a/man/syncthing-device-ids.7 +++ b/man/syncthing-device-ids.7 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-DEVICE-IDS" "7" "Jul 31, 2021" "v1" "Syncthing" +.TH "SYNCTHING-DEVICE-IDS" "7" "Aug 17, 2021" "v1" "Syncthing" .SH NAME syncthing-device-ids \- Understanding Device IDs .sp diff --git a/man/syncthing-event-api.7 b/man/syncthing-event-api.7 index ab4c7095b..2d3afd441 100644 --- a/man/syncthing-event-api.7 +++ b/man/syncthing-event-api.7 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-EVENT-API" "7" "Jul 31, 2021" "v1" "Syncthing" +.TH "SYNCTHING-EVENT-API" "7" "Aug 17, 2021" "v1" "Syncthing" .SH NAME syncthing-event-api \- Event API .SH DESCRIPTION diff --git a/man/syncthing-faq.7 b/man/syncthing-faq.7 index 98022dfe7..554a08830 100644 --- a/man/syncthing-faq.7 +++ b/man/syncthing-faq.7 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-FAQ" "7" "Jul 31, 2021" "v1" "Syncthing" +.TH "SYNCTHING-FAQ" "7" "Aug 17, 2021" "v1" "Syncthing" .SH NAME syncthing-faq \- Frequently Asked Questions .INDENT 0.0 @@ -348,14 +348,14 @@ known state (before disconnect or network delay) and the current state at the neighbour, and if there were updates, deletes, creates, conflicts, which were overlapping we only see the \fIlatest change\fP for a given file or directory (and the node where that latest change occurred). When we connect to multiple neighbours -Syncthing decides which neighbor has the latest state, or if the states conflict +Syncthing decides which neighbour has the latest state, or if the states conflict it initiates the conflict resolution procedure, which in the end results in a consistent up\-to\-date state with all the neighbours. .SS Why does Syncthing connect to this unknown/suspicious address? .sp If you see outgoing connections to odd and unexpected addresses these are most likely connections to relay servers\&. Relay servers -are run by volunteers all over the world. They usually listen on port 443 or +are run by volunteers all over the world. They usually listen on ports 443 or 22067, though this is controlled by the user running it. You can compare the address you are concernced about with \fI\%the current list of active relays\fP <\fBhttps://relays.syncthing.net\fP>\&. Relays do not and can not see the data transmitted via them. @@ -417,26 +417,26 @@ programs to achieve this such as \fI\%rsync\fP <\fBhttps://rsync.samba.org/\fP> \fI\%Unison\fP <\fBhttps://www.cis.upenn.edu/~bcpierce/unison\fP>\&. .SS When I do have two distinct Syncthing\-managed folders on two hosts, how does Syncthing handle moving files between them? .sp -Syncthing does not specially handle this case, and most files most likely get +Syncthing does not specially handle this case, and most files will most likely get re\-downloaded. .sp -In detail, the behavior depends on the scan order. If you have folder A and B, -and move files from A to B, if A gets scanned first, it will announce removal of -the files to others who will remove the files. As you rescan B, B will -announce addition of new files, and other peers will have nowhere to get +In detail, the behavior depends on the scan order. If you have folders A and B, +and move files from A to B, if A gets scanned first, it will announce the removal of +the files to others who will then remove the files. As you rescan B, B will +announce the addition of new files, and other peers will have nowhere to get them from apart from re\-downloading them. .sp -If B gets rescanned first, B will announce additions first, remote -peers will reconstruct the files (not rename, more like copy block by -block) from A, and then as A gets rescanned remove the files from A. +If B gets rescanned first, B will announce additions first, and remote +peers will then reconstruct the files (not rename, more like copying block by +block) from A, and then as A gets rescanned, it will remove the files from A. .sp A workaround would be to copy first from A to B, rescan B, wait for B to -rebuild on remote ends, and then delete from A. +copy the files on the remote side, and then delete from A. .SS Is Syncthing my ideal backup application? .sp No. Syncthing is not a great backup application because all changes to your files (modifications, deletions, etc.) will be propagated to all your -devices. You can enable versioning, but we encourage the use of other tools +devices. You can enable versioning, but we encourage you to use other tools to keep your data safe from your (or our) mistakes. .SS How can I exclude files with brackets (\fB[]\fP) in the name? .sp @@ -448,13 +448,13 @@ To match an actual file \fIcalled\fP \fBq[abc]x\fP the pattern needs to “escap the brackets, like so: \fBq\e[abc\e]x\fP\&. .sp On Windows, escaping special characters is not supported as the \fB\e\fP -character is used as a path separator. On the other hand, special characters -such as \fB[\fP and \fB?\fP are not allowed in file names on Windows. +character is used as a path separator. .SS How do I access the web GUI from another computer? .sp The default listening address is 127.0.0.1:8384, so you can only access the -GUI from the same machine. This is for security reasons. Change the \fBGUI -listen address\fP through the web UI from \fB127.0.0.1:8384\fP to +GUI from the same machine. This is for security reasons. To access the web +GUI from another computer, change the \fBGUI listen address\fP through the web +UI from \fB127.0.0.1:8384\fP to \fB0.0.0.0:8384\fP or change the config.xml: .INDENT 0.0 .INDENT 3.5 @@ -544,7 +544,7 @@ to get an idea how to do that. .sp If you use a package manager such as Debian’s apt\-get, you should upgrade using the package manager. If you use the binary packages linked from -Syncthing.net, you can use Syncthing built in automatic upgrades. +Syncthing.net, you can use Syncthing’s built\-in automatic upgrade functionality. .INDENT 0.0 .IP \(bu 2 If automatic upgrades is enabled (which is the default), Syncthing will @@ -556,7 +556,7 @@ released. Pressing it will perform an upgrade. To force an upgrade from the command line, run \fBsyncthing \-upgrade\fP\&. .UNINDENT .sp -Note that your system should have CA certificates installed which allow a +Note that your system should have CA certificates installed which allows a secure connection to GitHub (e.g. FreeBSD requires \fBsudo pkg install ca_root_nss\fP). If \fBcurl\fP or \fBwget\fP works with normal HTTPS sites, then so should Syncthing. @@ -577,7 +577,7 @@ of the command, not the package), look into the local documentation for that, it will almost certainly cover 100% of what you want to do. If you don’t have \fBstart\-stop\-daemon\fP, there are a bunch of other software packages you could use to do this. The most well known is called daemontools, and can be found in the -standard package repositories for almost every modern Linux distribution. +standard package repositories for almost every modern Linux distribution. Other popular tools with similar functionality include S6 and the aforementioned runit. .SS How do I increase the inotify limit to get my filesystem watcher to work? @@ -625,14 +625,14 @@ This only takes effect after a reboot. To adjust the limit immediately, run: .sp .nf .ft C -sudo sh \-c \(aqecho 204800 > /proc/sys/fs/inotify/max_user_watches\(aq +echo 204800 | sudo tee /proc/sys/fs/inotify/max_user_watches .ft P .fi .UNINDENT .UNINDENT .SS How do I reset the GUI password? .sp -If you’ve forgotten/lost the GUI password, you can remove it by deleting the \fB\fP and \fB\fP XML tags from the \fB\fP block in file \fBconfig.xml\fP\&. This should be done while Syncthing is not running. The location of the file depends on OS and is described in the configuration documentation. +If you’ve forgotten/lost the GUI password, you can remove it by deleting the \fB\fP and \fB\fP XML tags from the \fB\fP block in file \fBconfig.xml\fP\&. This should be done while Syncthing is not running. The location of the file depends on the OS and is described in the configuration documentation. .sp For example, the two emphasized lines below would be removed from the file. .INDENT 0.0 diff --git a/man/syncthing-globaldisco.7 b/man/syncthing-globaldisco.7 index e5fbc70ea..96bc09d81 100644 --- a/man/syncthing-globaldisco.7 +++ b/man/syncthing-globaldisco.7 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-GLOBALDISCO" "7" "Jul 31, 2021" "v1" "Syncthing" +.TH "SYNCTHING-GLOBALDISCO" "7" "Aug 17, 2021" "v1" "Syncthing" .SH NAME syncthing-globaldisco \- Global Discovery Protocol v3 .SH ANNOUNCEMENTS diff --git a/man/syncthing-localdisco.7 b/man/syncthing-localdisco.7 index 5d0eea084..d9ef6f60e 100644 --- a/man/syncthing-localdisco.7 +++ b/man/syncthing-localdisco.7 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-LOCALDISCO" "7" "Jul 31, 2021" "v1" "Syncthing" +.TH "SYNCTHING-LOCALDISCO" "7" "Aug 17, 2021" "v1" "Syncthing" .SH NAME syncthing-localdisco \- Local Discovery Protocol v4 .SH MODE OF OPERATION diff --git a/man/syncthing-networking.7 b/man/syncthing-networking.7 index 69759f4c7..33dc8fcf6 100644 --- a/man/syncthing-networking.7 +++ b/man/syncthing-networking.7 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-NETWORKING" "7" "Jul 31, 2021" "v1" "Syncthing" +.TH "SYNCTHING-NETWORKING" "7" "Aug 17, 2021" "v1" "Syncthing" .SH NAME syncthing-networking \- Firewall Setup .SH ROUTER SETUP diff --git a/man/syncthing-relay.7 b/man/syncthing-relay.7 index af6570b14..e333acd23 100644 --- a/man/syncthing-relay.7 +++ b/man/syncthing-relay.7 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-RELAY" "7" "Jul 31, 2021" "v1" "Syncthing" +.TH "SYNCTHING-RELAY" "7" "Aug 17, 2021" "v1" "Syncthing" .SH NAME syncthing-relay \- Relay Protocol v1 .SH WHAT IS A RELAY? diff --git a/man/syncthing-rest-api.7 b/man/syncthing-rest-api.7 index 6549e2025..8e72c907b 100644 --- a/man/syncthing-rest-api.7 +++ b/man/syncthing-rest-api.7 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-REST-API" "7" "Jul 31, 2021" "v1" "Syncthing" +.TH "SYNCTHING-REST-API" "7" "Aug 17, 2021" "v1" "Syncthing" .SH NAME syncthing-rest-api \- REST API .sp diff --git a/man/syncthing-security.7 b/man/syncthing-security.7 index 225a8903b..6729dfcc9 100644 --- a/man/syncthing-security.7 +++ b/man/syncthing-security.7 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-SECURITY" "7" "Jul 31, 2021" "v1" "Syncthing" +.TH "SYNCTHING-SECURITY" "7" "Aug 17, 2021" "v1" "Syncthing" .SH NAME syncthing-security \- Security Principles .sp diff --git a/man/syncthing-stignore.5 b/man/syncthing-stignore.5 index 060cb7ecd..7e1b7fc1e 100644 --- a/man/syncthing-stignore.5 +++ b/man/syncthing-stignore.5 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-STIGNORE" "5" "Jul 31, 2021" "v1" "Syncthing" +.TH "SYNCTHING-STIGNORE" "5" "Aug 17, 2021" "v1" "Syncthing" .SH NAME syncthing-stignore \- Prevent files from being synchronized to other nodes .SH SYNOPSIS diff --git a/man/syncthing-versioning.7 b/man/syncthing-versioning.7 index 0911ddd99..3c721f387 100644 --- a/man/syncthing-versioning.7 +++ b/man/syncthing-versioning.7 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-VERSIONING" "7" "Jul 31, 2021" "v1" "Syncthing" +.TH "SYNCTHING-VERSIONING" "7" "Aug 17, 2021" "v1" "Syncthing" .SH NAME syncthing-versioning \- Keep automatic backups of deleted files by other nodes .sp diff --git a/man/syncthing.1 b/man/syncthing.1 index de2b474e2..6840b4763 100644 --- a/man/syncthing.1 +++ b/man/syncthing.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING" "1" "Jul 31, 2021" "v1" "Syncthing" +.TH "SYNCTHING" "1" "Aug 17, 2021" "v1" "Syncthing" .SH NAME syncthing \- Syncthing .SH SYNOPSIS