From b6b0d0664df6c6d18739c1021999298283af66e5 Mon Sep 17 00:00:00 2001 From: Jakob Borg Date: Wed, 9 May 2018 07:45:15 +0200 Subject: [PATCH] gui, man: Update docs & translations --- gui/default/assets/lang/lang-fr.json | 2 +- gui/default/assets/lang/lang-ko-KR.json | 14 ++-- gui/default/assets/lang/lang-pt-PT.json | 10 +-- man/stdiscosrv.1 | 2 +- man/strelaysrv.1 | 2 +- man/syncthing-bep.7 | 100 ++++++++++++++++++++++-- man/syncthing-config.5 | 2 +- man/syncthing-device-ids.7 | 2 +- man/syncthing-event-api.7 | 2 +- man/syncthing-faq.7 | 2 +- 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 +- 19 files changed, 121 insertions(+), 35 deletions(-) diff --git a/gui/default/assets/lang/lang-fr.json b/gui/default/assets/lang/lang-fr.json index 79b4c4be6..2f4586e58 100644 --- a/gui/default/assets/lang/lang-fr.json +++ b/gui/default/assets/lang/lang-fr.json @@ -12,7 +12,7 @@ "Add Remote Device": "Ajouter un appareil...", "Add devices from the introducer to our device list, for mutually shared folders.": "ATTENTION !!! Lui permettre d'ajouter et enlever des membres à toutes mes listes de membres des partages dont il fait (ou fera !) partie (ceci permet de créer automatiquement toutes les liaisons point à point possibles en complétant mes listes par les siennes, meilleur débit de réception par cumul des débits d'envoi, indépendance vis à vis de l'introducteur, etc).", "Add new folder?": "Ajouter ce partage ?", - "Additionally the full rescan interval will be increased (times 60, i.e. new default of 1h). You can also configure it manually for every folder later after choosing No.": "De plus, l'intervalle de réanalyse complète sera augmenté (60 fois, c.-à-d. une nouvelle valeur par défaut de 1h). Vous pouvez également la configurer manuellement plus tard, pour chaque partage, après avoir choisi Non.", + "Additionally the full rescan interval will be increased (times 60, i.e. new default of 1h). You can also configure it manually for every folder later after choosing No.": "Dans ce cas, l'intervalle de réanalyse complète sera augmenté (60 fois, c.-à-d. une nouvelle valeur par défaut de 1h). Vous pouvez également la configurer manuellement plus tard, pour chaque partage, après avoir choisi Non.", "Address": "Adresse", "Addresses": "Adresses", "Advanced": "Avancé", diff --git a/gui/default/assets/lang/lang-ko-KR.json b/gui/default/assets/lang/lang-ko-KR.json index c257d3218..a1ac5338f 100644 --- a/gui/default/assets/lang/lang-ko-KR.json +++ b/gui/default/assets/lang/lang-ko-KR.json @@ -12,7 +12,7 @@ "Add Remote Device": "다른 기기 추가", "Add devices from the introducer to our device list, for mutually shared folders.": "상호 공유 폴더에 대해 유도자의 장치를 장치 목록에 추가합니다.", "Add new folder?": "새로운 폴더를 추가하시겠습니까?", - "Additionally the full rescan interval will be increased (times 60, i.e. new default of 1h). You can also configure it manually for every folder later after choosing No.": "Additionally the full rescan interval will be increased (times 60, i.e. new default of 1h). You can also configure it manually for every folder later after choosing No.", + "Additionally the full rescan interval will be increased (times 60, i.e. new default of 1h). You can also configure it manually for every folder later after choosing No.": "추가적으로 전체 탐색 간격이 늘어납니다 (시간이 60, 즉 기본값 인 1 시간). 아니요를 선택한 후에 모든 폴더에 대해 직접 설정도 가능합니다.", "Address": "주소", "Addresses": "주소", "Advanced": "고급", @@ -50,7 +50,7 @@ "Connection Error": "연결 에러", "Connection Type": "연결 종류", "Connections": "연결", - "Continuously watching for changes is now available within Syncthing. This will detect changes on disk and issue a scan on only the modified paths. The benefits are that changes are propagated quicker and that less full scans are required.": "Continuously watching for changes is now available within Syncthing. This will detect changes on disk and issue a scan on only the modified paths. The benefits are that changes are propagated quicker and that less full scans are required.", + "Continuously watching for changes is now available within Syncthing. This will detect changes on disk and issue a scan on only the modified paths. The benefits are that changes are propagated quicker and that less full scans are required.": "Syncthing는 변경 사항을 지속적으로 감지 할 수 있습니다. 이렇게 하면 디스크의 변경 사항을 감지하고 수정 된 경로에서만 검사를 실행합니다. 이점은 변경 사항이 더 빠르게 전파되고 전체 탐색 횟수가 줄어듭니다.", "Copied from elsewhere": "다른 곳에서 복사됨", "Copied from original": "원본에서 복사됨", "Copyright © 2014-2016 the following Contributors:": "Copyright © 2014-2016 the following Contributors:", @@ -77,7 +77,7 @@ "Discovery Failures": "탐색 실패", "Do not restore": "복구 하지 않기", "Do not restore all": "모두 복구 하지 않기", - "Do you want to enable watching for changes for all your folders?": "Do you want to enable watching for changes for all your folders?", + "Do you want to enable watching for changes for all your folders?": "변경 사항 감시를 당신의 모든 폴더에서 활성화 하는걸 원하시나요?", "Documentation": "문서", "Download Rate": "다운로드 속도", "Downloaded": "다운로드됨", @@ -117,7 +117,7 @@ "Folder Path": "폴더 경로", "Folder Type": "폴더 유형", "Folders": "폴더", - "Full Rescan Interval (s)": "모두 재 탐색 간격 (s)", + "Full Rescan Interval (s)": "전체 탐색 간격 (s)", "GUI": "GUI", "GUI Authentication Password": "GUI 인증 비밀번호", "GUI Authentication User": "GUI 인증 사용자", @@ -333,9 +333,9 @@ "Warning, this path is a parent directory of an existing folder \"{%otherFolderLabel%}\" ({%otherFolder%}).": "경고, 이 경로는 현재 존재하는 폴더 \"{{otherFolderLabel}}\" ({{otherFolder}}) 의 상위 폴더 입니다.", "Warning, this path is a subdirectory of an existing folder \"{%otherFolder%}\".": "경고, 이 경로는 현재 존재하는 폴더 \"{{otherFolder}}\" 의 하위 폴더 입니다.", "Warning, this path is a subdirectory of an existing folder \"{%otherFolderLabel%}\" ({%otherFolder%}).": "경고, 이 경로는 현재 존재하는 폴더 \"{{otherFolderLabel}}\" ({{otherFolder}}) 의 하위 폴더 입니다.", - "Warning: If you are using an external watcher like {%syncthingInotify%}, you should make sure it is deactivated.": "Warning: If you are using an external watcher like {{syncthingInotify}}, you should make sure it is deactivated.", - "Watch for Changes": "Watch for Changes", - "Watching for Changes": "Watching for Changes", + "Warning: If you are using an external watcher like {%syncthingInotify%}, you should make sure it is deactivated.": "경고 : {{syncthingInotify}} 와 같은 외부 감시 도구를 사용하는 경우 비활성화되어 있는지 확인해야 합니다.", + "Watch for Changes": "변경 사항 감시", + "Watching for Changes": "변경 사항 감시", "When adding a new device, keep in mind that this device must be added on the other side too.": "새 장치를 추가할 시 추가한 기기 쪽에서도 이 장치를 추가해야 합니다.", "When adding a new folder, keep in mind that the Folder ID is used to tie folders together between devices. They are case sensitive and must match exactly between all devices.": "새 폴더를 추가할 시 폴더 ID는 장치간에 폴더를 묶을 때 사용됩니다. 대소문자를 구분하며 모든 장치에서 같은 ID를 사용해야 합니다.", "Yes": "예", diff --git a/gui/default/assets/lang/lang-pt-PT.json b/gui/default/assets/lang/lang-pt-PT.json index 3d618e6f3..d77660e98 100644 --- a/gui/default/assets/lang/lang-pt-PT.json +++ b/gui/default/assets/lang/lang-pt-PT.json @@ -166,7 +166,7 @@ "Mod. Device": "Dispositivo mod.", "Mod. Time": "Quando foi mod.", "Move to top of queue": "Mover para o topo da fila", - "Multi level wildcard (matches multiple directory levels)": "Caractere polivalente multi-nível (faz corresponder a vários níveis de pastas)", + "Multi level wildcard (matches multiple directory levels)": "Símbolo polivalente multi-nível (faz corresponder a vários níveis de pastas)", "Never": "Nunca", "New Device": "Novo dispositivo", "New Folder": "Nova pasta", @@ -187,7 +187,7 @@ "Outgoing Rate Limit (KiB/s)": "Limite da velocidade de envio (KiB/s)", "Override Changes": "Sobrepor alterações", "Path": "Caminho", - "Path to the folder on the local computer. Will be created if it does not exist. The tilde character (~) can be used as a shortcut for": "Caminho para a pasta no computador local. Será criada, caso não exista. O caractere (~) pode ser utilizado como atalho para", + "Path to the folder on the local computer. Will be created if it does not exist. The tilde character (~) can be used as a shortcut for": "Caminho para a pasta no computador local. Será criada, caso não exista. O til (~) pode ser utilizado como atalho para", "Path where new auto accepted folders will be created, as well as the default suggested path when adding new folders via the UI. Tilde character (~) expands to {%tilde%}.": "Caminho no qual as novas pastas aceites automaticamente serão criadas, assim como o caminho predefinido sugerido ao adicionar novas pastas através da interface do utilizador. O til (~) expande para {{tilde}}.", "Path where versions should be stored (leave empty for the default .stversions directory in the shared folder).": "Caminho da pasta onde as versões deverão ser guardadas (deixe vazio para ficar a pasta predefinida .stversions dentro da pasta partilhada).", "Path where versions should be stored (leave empty for the default .stversions folder in the folder).": "Caminho onde as versões são guardadas (deixe vazio para usar a pasta predefinida .stversions dentro da pasta a que se refere).", @@ -220,7 +220,7 @@ "Rescan": "Verificar agora", "Rescan All": "Verificar todas agora", "Rescan Interval": "Intervalo entre verificações", - "Rescans": "Verificação de alterações", + "Rescans": "Verificações", "Restart": "Reiniciar", "Restart Needed": "É preciso reiniciar", "Restarting": "Reiniciando", @@ -232,7 +232,7 @@ "Running": "Em execução", "Save": "Gravar", "Scan Time Remaining": "Tempo restante da verificação", - "Scanning": "Verificando", + "Scanning": "Verificação de alterações", "See external versioner help for supported templated command line parameters.": "Veja a ajuda do gestor de versões externo para saber que parâmetros da linha de comandos são suportados.", "See external versioning help for supported templated command line parameters.": "Veja a ajuda externa sobre gestão de versões para ver os modelos suportados de parâmetros para a linha de comandos.", "Select a version": "Seleccione uma versão", @@ -257,7 +257,7 @@ "Shutdown": "Desligar", "Shutdown Complete": "Encerramento completado", "Simple File Versioning": "Simples", - "Single level wildcard (matches within a directory only)": "Caractere polivalente de um só nível (faz corresponder apenas dentro de uma pasta)", + "Single level wildcard (matches within a directory only)": "Símbolo polivalente de um só nível (faz corresponder apenas dentro de uma pasta)", "Size": "Tamanho", "Smallest First": "Primeiro os menores", "Some items could not be restored:": "Não foi possível restaurar alguns dos itens:", diff --git a/man/stdiscosrv.1 b/man/stdiscosrv.1 index ef672e89b..d4ae9afd1 100644 --- a/man/stdiscosrv.1 +++ b/man/stdiscosrv.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "STDISCOSRV" "1" "Apr 18, 2018" "v0.14" "Syncthing" +.TH "STDISCOSRV" "1" "May 05, 2018" "v0.14" "Syncthing" .SH NAME stdiscosrv \- Syncthing Discovery Server . diff --git a/man/strelaysrv.1 b/man/strelaysrv.1 index fdcd72acd..cf627218e 100644 --- a/man/strelaysrv.1 +++ b/man/strelaysrv.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "STRELAYSRV" "1" "Apr 18, 2018" "v0.14" "Syncthing" +.TH "STRELAYSRV" "1" "May 05, 2018" "v0.14" "Syncthing" .SH NAME strelaysrv \- Syncthing Relay Server . diff --git a/man/syncthing-bep.7 b/man/syncthing-bep.7 index d6acbf564..321a4842b 100644 --- a/man/syncthing-bep.7 +++ b/man/syncthing-bep.7 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "SYNCTHING-BEP" "7" "Apr 18, 2018" "v0.14" "Syncthing" +.TH "SYNCTHING-BEP" "7" "May 05, 2018" "v0.14" "Syncthing" .SH NAME syncthing-bep \- Block Exchange Protocol v1 . @@ -41,8 +41,10 @@ forms the \fIglobal model\fP\&. Each device strives to get its folders in sync with the global model by requesting missing or outdated blocks from the other devices in the cluster. .sp -File data is described and transferred in units of \fIblocks\fP, each being -128 KiB (131072 bytes) in size. +File data is described and transferred in units of \fIblocks\fP, each being from +128 KiB (131072 bytes) to 16 MiB in size, in steps of powers of two. The +block size may vary between files but is constant in any given file, except +for the last block which may be smaller. .sp The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this @@ -421,7 +423,8 @@ message FileInfo { bool invalid = 7; bool no_permissions = 8; Vector version = 9; - int64 sequence = 10; + int64 sequence = 10; + int32 block_size = 13; repeated BlockInfo Blocks = 16; string symlink_target = 17; @@ -513,10 +516,16 @@ The \fBsequence\fP field is the value of a device local monotonic clock at the time of last local database update to a file. The clock ticks on every local database update, thus forming a sequence number over database updates. .sp +The \fBblock_size\fP field is the size, in bytes, of each individual block in +the block list (except, possibly, the last block). If this field is missing +or zero, the block size is assumed to be 128 KiB (131072 bytes). Valid +values of this field are the powers of two from 128 KiB through 16 MiB. See +also \fI\%Selection of Block Size\fP\&. +.sp The \fBblocks\fP list contains the size and hash for each block in the file. -Each block represents a 128 KiB slice of the file, except for the last block -which may represent a smaller amount of data. The block list is empty for -directories and symlinks. +Each block represents a \fBblock_size\fP\-sized slice of the file, except for +the last block which may represent a smaller amount of data. The block list +is empty for directories and symlinks. .sp The \fBsymlink_target\fP field contains the symlink target, for entries of symlink type. It is empty for all other entry types. @@ -839,6 +848,83 @@ a connection close. This size was chosen to accommodate Index messages containing a large block list. It’s intended that the limit may be further reduced in a future protocol update supporting variable block sizes (and thus shorter block lists for large files). +.SH SELECTION OF BLOCK SIZE +.sp +The desired block size for any given file is the smallest block size that +results in fewer than 2000 blocks, or the maximum block size for larger +files. This rule results in the following table of block sizes per file +size: +.TS +center; +|l|l|. +_ +T{ +File Size +T} T{ +Block Size +T} +_ +T{ +0 \- 250 MiB +T} T{ +128 KiB +T} +_ +T{ +250 MiB \- 500 MiB +T} T{ +256 KiB +T} +_ +T{ +500 MiB \- 1 GiB +T} T{ +512 KiB +T} +_ +T{ +1 GiB \- 2 GiB +T} T{ +1 MiB +T} +_ +T{ +2 GiB \- 4 GiB +T} T{ +2 MiB +T} +_ +T{ +4 GiB \- 8 GiB +T} T{ +4 MiB +T} +_ +T{ +8 GiB \- 16 GiB +T} T{ +8 MiB +T} +_ +T{ +16 GiB \- up +T} T{ +16 MiB +T} +_ +.TE +.sp +An implementation MAY deviate from the block size rule when there is good +reason to do so. For example, if a file has been indexed at a certain block +size and grows beyond 2000 blocks it may be retained at the current block +size for practical reasons. When there is no overriding reason to the +contrary, such as when indexing a new file for the first time, the block +size rule above SHOULD be followed. +.sp +An implementation MUST therefore accept files with a block size differing +from the above rule. This does not mean that arbitrary block sizes are +allowed. The block size used MUST be exactly one of the power\-of\-two block +sizes listed in the table above. .SH EXAMPLE EXCHANGE .TS center; diff --git a/man/syncthing-config.5 b/man/syncthing-config.5 index d18d4d934..242a18d86 100644 --- a/man/syncthing-config.5 +++ b/man/syncthing-config.5 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "SYNCTHING-CONFIG" "5" "Apr 18, 2018" "v0.14" "Syncthing" +.TH "SYNCTHING-CONFIG" "5" "May 05, 2018" "v0.14" "Syncthing" .SH NAME syncthing-config \- Syncthing Configuration . diff --git a/man/syncthing-device-ids.7 b/man/syncthing-device-ids.7 index 313facfbb..ce699297b 100644 --- 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" "Apr 18, 2018" "v0.14" "Syncthing" +.TH "SYNCTHING-DEVICE-IDS" "7" "May 05, 2018" "v0.14" "Syncthing" .SH NAME syncthing-device-ids \- Understanding Device IDs . diff --git a/man/syncthing-event-api.7 b/man/syncthing-event-api.7 index e0f198616..78662be58 100644 --- 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" "Apr 18, 2018" "v0.14" "Syncthing" +.TH "SYNCTHING-EVENT-API" "7" "May 05, 2018" "v0.14" "Syncthing" .SH NAME syncthing-event-api \- Event API . diff --git a/man/syncthing-faq.7 b/man/syncthing-faq.7 index 649eddef0..7f4376b69 100644 --- a/man/syncthing-faq.7 +++ b/man/syncthing-faq.7 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "SYNCTHING-FAQ" "7" "Apr 18, 2018" "v0.14" "Syncthing" +.TH "SYNCTHING-FAQ" "7" "May 05, 2018" "v0.14" "Syncthing" .SH NAME syncthing-faq \- Frequently Asked Questions . diff --git a/man/syncthing-globaldisco.7 b/man/syncthing-globaldisco.7 index 194437438..927a9254c 100644 --- a/man/syncthing-globaldisco.7 +++ b/man/syncthing-globaldisco.7 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "SYNCTHING-GLOBALDISCO" "7" "Apr 18, 2018" "v0.14" "Syncthing" +.TH "SYNCTHING-GLOBALDISCO" "7" "May 05, 2018" "v0.14" "Syncthing" .SH NAME syncthing-globaldisco \- Global Discovery Protocol v3 . diff --git a/man/syncthing-localdisco.7 b/man/syncthing-localdisco.7 index 1326a2403..f6ae4e377 100644 --- a/man/syncthing-localdisco.7 +++ b/man/syncthing-localdisco.7 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "SYNCTHING-LOCALDISCO" "7" "Apr 18, 2018" "v0.14" "Syncthing" +.TH "SYNCTHING-LOCALDISCO" "7" "May 05, 2018" "v0.14" "Syncthing" .SH NAME syncthing-localdisco \- Local Discovery Protocol v4 . diff --git a/man/syncthing-networking.7 b/man/syncthing-networking.7 index bbc3b3431..47bb07eed 100644 --- a/man/syncthing-networking.7 +++ b/man/syncthing-networking.7 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "SYNCTHING-NETWORKING" "7" "Apr 18, 2018" "v0.14" "Syncthing" +.TH "SYNCTHING-NETWORKING" "7" "May 05, 2018" "v0.14" "Syncthing" .SH NAME syncthing-networking \- Firewall Setup . diff --git a/man/syncthing-relay.7 b/man/syncthing-relay.7 index 176668acd..412a8b031 100644 --- a/man/syncthing-relay.7 +++ b/man/syncthing-relay.7 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "SYNCTHING-RELAY" "7" "Apr 18, 2018" "v0.14" "Syncthing" +.TH "SYNCTHING-RELAY" "7" "May 05, 2018" "v0.14" "Syncthing" .SH NAME syncthing-relay \- Relay Protocol v1 . diff --git a/man/syncthing-rest-api.7 b/man/syncthing-rest-api.7 index 4ac99291b..5d69849bc 100644 --- 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" "Apr 18, 2018" "v0.14" "Syncthing" +.TH "SYNCTHING-REST-API" "7" "May 05, 2018" "v0.14" "Syncthing" .SH NAME syncthing-rest-api \- REST API . diff --git a/man/syncthing-security.7 b/man/syncthing-security.7 index f84d8acbc..96425bac9 100644 --- a/man/syncthing-security.7 +++ b/man/syncthing-security.7 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "SYNCTHING-SECURITY" "7" "Apr 18, 2018" "v0.14" "Syncthing" +.TH "SYNCTHING-SECURITY" "7" "May 05, 2018" "v0.14" "Syncthing" .SH NAME syncthing-security \- Security Principles . diff --git a/man/syncthing-stignore.5 b/man/syncthing-stignore.5 index 642f94ae9..cd9ec6b02 100644 --- a/man/syncthing-stignore.5 +++ b/man/syncthing-stignore.5 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "SYNCTHING-STIGNORE" "5" "Apr 18, 2018" "v0.14" "Syncthing" +.TH "SYNCTHING-STIGNORE" "5" "May 05, 2018" "v0.14" "Syncthing" .SH NAME syncthing-stignore \- Prevent files from being synchronized to other nodes . diff --git a/man/syncthing-versioning.7 b/man/syncthing-versioning.7 index 1ea622cb9..824e5dcd6 100644 --- a/man/syncthing-versioning.7 +++ b/man/syncthing-versioning.7 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "SYNCTHING-VERSIONING" "7" "Apr 18, 2018" "v0.14" "Syncthing" +.TH "SYNCTHING-VERSIONING" "7" "May 05, 2018" "v0.14" "Syncthing" .SH NAME syncthing-versioning \- Keep automatic backups of deleted files by other nodes . diff --git a/man/syncthing.1 b/man/syncthing.1 index 84eed15d3..9bddec95c 100644 --- a/man/syncthing.1 +++ b/man/syncthing.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "SYNCTHING" "1" "Apr 18, 2018" "v0.14" "Syncthing" +.TH "SYNCTHING" "1" "May 05, 2018" "v0.14" "Syncthing" .SH NAME syncthing \- Syncthing .