gui, man, authors: Update docs, translations, and contributors

AUTHORS

@@ -76,6 +76,7 @@ Cromefire_ <[email protected]> <[email protected]>
 Cyprien Devillez <[email protected]>
 Dale Visser <[email protected]>
 Dan <[email protected]>
+Daniel Barczyk <[email protected]>
 Daniel Bergmann (brgmnn) <[email protected]> <[email protected]>
 Daniel Harte (norgeous) <[email protected]> <[email protected]> <[email protected]>
 Daniel Martí (mvdan) <[email protected]>
@@ -103,7 +104,7 @@ Felix Lampe <[email protected]>
 Felix Unterpaintner (bigbear2nd) <[email protected]>
 Francois-Xavier Gsell (zukoo) <[email protected]>
 Frank Isemann (fti7) <[email protected]>
-Gahl Saraf <[email protected]>
+Gahl Saraf <[email protected]> <[email protected]>
 georgespatton <[email protected]>
 ghjklw <[email protected]>
 Gilli Sigurdsson (gillisig) <[email protected]>
@@ -117,6 +118,7 @@ Heiko Zuerker (Smiley73) <[email protected]>
 Hugo Locurcio <[email protected]>
 Iain Barnett <[email protected]>
 Ian Johnson (anonymouse64) <[email protected]> <[email protected]>
+ignacy123 <[email protected]>
 Ikko Ashimine <[email protected]>
 Ilya Brin <[email protected]>
 Iskander Sharipov (Alex) <[email protected]>
@@ -150,6 +152,7 @@ Jörg Thalheim <[email protected]>
 Jędrzej Kula <[email protected]>
 Kalle Laine <[email protected]>
 Karol Różycki (krozycki) <[email protected]>
+Kebin Liu <[email protected]>
 Keith Turner <[email protected]>
 Kelong Cong (kc1212) <[email protected]> <[email protected]>
 Ken'ichi Kamada (kamadak) <[email protected]>
@@ -239,6 +242,7 @@ Roman Zaynetdinov (zaynetro) <[email protected]>
 Ross Smith II (rasa) <[email protected]>
 rubenbe <[email protected]>
 Ruslan Yevdokymov <[email protected]>
+Ryan Qian <[email protected]>
 Ryan Sullivan (KayoticSully) <[email protected]>
 Sacheendra Talluri (sacheendra) <[email protected]>
 Scott Klupfel (kluppy) <[email protected]>
@@ -251,6 +255,7 @@ Stefan Kuntz (Stefan-Code) <[email protected]> <[email protected]>
 Stefan Tatschner (rumpelsepp) <[email protected]> <[email protected]> <[email protected]>
 Steven Eckhoff <[email protected]>
 Suhas Gundimeda (snugghash) <[email protected]> <[email protected]>
+Syncthing Automation <[email protected]>
 Syncthing Release Automation <[email protected]>
 Taylor Khan (nelsonkhan) <[email protected]>
 Thomas Hipp <[email protected]>
@@ -269,6 +274,7 @@ Unrud (Unrud) <[email protected]> <[email protected]>
 Veeti Paananen (veeti) <[email protected]>
 Victor Buinsky (buinsky) <[email protected]>
 Vil Brekin (Vilbrekin) <[email protected]>
+villekalliomaki <[email protected]>
 Vladimir Rusinov <[email protected]> <[email protected]>
 wangguoliang <[email protected]>
 William A. Kennington III (wkennington) <[email protected]>

gui/default/assets/lang/lang-es-ES.json

@@ -11,7 +11,7 @@
     "Add Folder": "Agregar Carpeta",
     "Add Remote Device": "Añadir un dispositivo",
     "Add devices from the introducer to our device list, for mutually shared folders.": "Añadir dispositivos desde el introductor a nuestra lista de dispositivos, para las carpetas compartidas mutuamente.",
-    "Add ignore patterns": "Agregar patrones a ignorar",
+    "Add ignore patterns": "Añadir patrones a ignorar",
     "Add new folder?": "¿Agregar una carpeta nueva?",
     "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 manera adicional, el intervalo de escaneo será incrementado (por ejemplo, times 60, establece un nuevo intervalo por defecto de una hora). También puedes configurarlo manualmente para cada carpeta tras elegir el número.",
     "Address": "Dirección",
@@ -19,7 +19,7 @@
     "Advanced": "Avanzado",
     "Advanced Configuration": "Configuración Avanzada",
     "All Data": "Todos los datos",
-    "All Time": "All Time",
+    "All Time": "Todo el tiempo",
     "All folders shared with this device must be protected by a password, such that all sent data is unreadable without the given password.": "Todos las carpetas compartidas con este equipo deben ser protegidas con una contraseña, de manera que todos los datos enviados sean ilegibles sin la contraseña dada.",
     "Allow Anonymous Usage Reporting?": "¿Deseas permitir el envío anónimo de informes de uso?",
     "Allowed Networks": "Redes permitidas",
@@ -28,14 +28,14 @@
     "An external command handles the versioning. It has to remove the file from the shared folder. If the path to the application contains spaces, it should be quoted.": "Un comando externo maneja el versionado. Tiene que eliminar el fichero de la carpeta compartida. Si la ruta a la aplicación contiene espacios, hay que escribirla entre comillas.",
     "Anonymous Usage Reporting": "Informe anónimo de uso",
     "Anonymous usage report format has changed. Would you like to move to the new format?": "El formato del informe anónimo de uso ha cambiado. ¿Quieres cambiar al nuevo formato?",
-    "Are you sure you want to continue?": "¿Está seguro(a) de que desea continuar?",
-    "Are you sure you want to override all remote changes?": "¿Está seguro(a) de que desea sobreescribir todos los cambios remotos?",
-    "Are you sure you want to permanently delete all these files?": "¿Estás seguro(a) de que quieres eliminar permanentemente todos estos ficheros?",
+    "Are you sure you want to continue?": "¿Seguro que quieres continuar?",
+    "Are you sure you want to override all remote changes?": "¿Seguro que quieres sobreescribir todos los cambios remotos?",
+    "Are you sure you want to permanently delete all these files?": "¿Seguro que quieres eliminar permanentemente todos estos archivos?",
     "Are you sure you want to remove device {%name%}?": "¿Estás seguro de que quieres quitar el dispositivo {{name}}?",
     "Are you sure you want to remove folder {%label%}?": "¿Estás seguro de que quieres quitar la carpeta {{label}}?",
     "Are you sure you want to restore {%count%} files?": "¿Estás seguro de que quieres restaurar {{count}} ficheros?",
-    "Are you sure you want to revert all local changes?": "¿Está seguro(a) de que desea revertir todos los cambios locales?",
-    "Are you sure you want to upgrade?": "¿Está seguro(a) de que desea actualizar?",
+    "Are you sure you want to revert all local changes?": "¿Seguro que quieres revertir todos los cambios locales?",
+    "Are you sure you want to upgrade?": "¿Seguro que quieres actualizar?",
     "Auto Accept": "Auto aceptar",
     "Automatic Crash Reporting": "Informe automático de errores",
     "Automatic upgrade now offers the choice between stable releases and release candidates.": "Ahora la actualización automática permite elegir entre versiones estables o versiones candidatas.",
@@ -48,10 +48,10 @@
     "Cancel": "Cancelar",
     "Changelog": "Registro de cambios",
     "Clean out after": "Limpiar tras",
-    "Cleaning Versions": "Limpiando Versiones",
-    "Cleanup Interval": "Intervalo de Limpieza",
+    "Cleaning Versions": "Limpiando versiones",
+    "Cleanup Interval": "Intervalo de limpieza",
     "Click to see discovery failures": "Clica para ver fallos de descubrimiento.",
-    "Click to see full identification string and QR code.": "Haga clic para ver la cadena de identificación completa y su código QR.",
+    "Click to see full identification string and QR code.": "Haz clic para ver la cadena de identificación completa y el código QR.",
     "Close": "Cerrar",
     "Command": "Acción",
     "Comment, when used at the start of a line": "Comentar, cuando se usa al comienzo de una línea",
@@ -66,17 +66,17 @@
     "Copied from original": "Copiado del original",
     "Copyright © 2014-2019 the following Contributors:": "Copyright © 2014-2019 los siguientes Colaboradores:",
     "Creating ignore patterns, overwriting an existing file at {%path%}.": "Crear patrones a ignorar, sobreescribiendo un fichero existente en {{path}}.",
-    "Currently Shared With Devices": "Actualmente Compartida Con Los Equipos",
-    "Custom Range": "Custom Range",
+    "Currently Shared With Devices": "Actualmente compartida con los equipos",
+    "Custom Range": "Rango personalizado",
     "Danger!": "¡Peligro!",
     "Debugging Facilities": "Ayudas a la depuración",
-    "Default Configuration": "Configuración Por Defecto",
-    "Default Device": "Equipo Por Defecto",
-    "Default Folder": "Carpeta Por Defecto",
+    "Default Configuration": "Configuración por defecto",
+    "Default Device": "Equipo por defecto",
+    "Default Folder": "Carpeta por defecto",
     "Default Folder Path": "Ruta de la carpeta por defecto",
-    "Defaults": "Valores Por Defecto",
+    "Defaults": "Valores por defecto",
     "Delete": "Eliminar",
-    "Delete Unexpected Items": "Borrar Elementos Inesperados",
+    "Delete Unexpected Items": "Borrar elementos inesperados",
     "Deleted": "Eliminado",
     "Deselect All": "Deseleccionar Todo",
     "Deselect devices to stop sharing this folder with.": "Deseleccione los equipos con los cuales dejar de compartir esta carpeta.",
@@ -130,7 +130,7 @@
     "Error": "Error",
     "External File Versioning": "Versionado externo de fichero",
     "Failed Items": "Elementos fallidos",
-    "Failed to load file versions.": "Failed to load file versions.",
+    "Failed to load file versions.": "Error al cargar las versiones del archivo.",
     "Failed to load ignore patterns.": "Fallo al cargar patrones a ignorar",
     "Failed to setup, retrying": "Fallo al configurar, reintentando",
     "Failure to connect to IPv6 servers is expected if there is no IPv6 connectivity.": "Se espera un fallo al conectar a los servidores IPv6 si no hay conectividad IPv6.",
@@ -185,9 +185,9 @@
     "Keep Versions": "Mantener versiones",
     "LDAP": "LDAP",
     "Largest First": "Más grande primero",
-    "Last 30 Days": "Last 30 Days",
-    "Last 7 Days": "Last 7 Days",
-    "Last Month": "Last Month",
+    "Last 30 Days": "Últimos 30 días",
+    "Last 7 Days": "Últimos 7 días",
+    "Last Month": "Último mes",
     "Last Scan": "Último escaneo",
     "Last seen": "Visto por última vez",
     "Latest Change": "Último Cambio",
@@ -379,18 +379,18 @@
     "The rate limit must be a non-negative number (0: no limit)": "El límite de velocidad debe ser un número no negativo (0: sin límite)",
     "The rescan interval must be a non-negative number of seconds.": "El intervalo de actualización debe ser un número positivo de segundos.",
     "There are no devices to share this folder with.": "No hay equipos con los cuales compartir esta carpeta.",
-    "There are no file versions to restore.": "There are no file versions to restore.",
+    "There are no file versions to restore.": "No hay versiones de archivo que restaurar.",
     "There are no folders to share with this device.": "No hay carpetas para compartir con este equipo.",
     "They are retried automatically and will be synced when the error is resolved.": "Se reintentarán de forma automática y se sincronizarán cuando se resuelva el error.",
     "This Device": "Este Dispositivo",
-    "This Month": "This Month",
+    "This Month": "Este mes",
     "This can easily give hackers access to read and change any files on your computer.": "Esto podría permitir fácilmente el acceso a hackers para leer y modificar cualquier fichero de tu equipo.",
     "This device cannot automatically discover other devices or announce its own address to be found by others.  Only devices with statically configured addresses can connect.": "Este dispositivo no puede descubrir automáticamente a otros dispositivos o anunciar su propia dirección para que sea encontrado con otros. Solo dispositivos con direcciones configuradas como estáticas pueden conectarse.",
     "This is a major version upgrade.": "Hay una actualización importante.",
     "This setting controls the free space required on the home (i.e., index database) disk.": "Este ajuste controla el espacio libre necesario en el disco principal (por ejemplo, el índice de la base de datos).",
     "Time": "Hora",
     "Time the item was last modified": "Tiempo en el que se modificó el ítem por última vez",
-    "Today": "Today",
+    "Today": "Hoy",
     "Trash Can File Versioning": "Versionado de archivos de la papelera",
     "Type": "Tipo",
     "UNIX Permissions": "Permisos de UNIX",
@@ -402,9 +402,9 @@
     "Unignore": "Designorar",
     "Unknown": "Desconocido",
     "Unshared": "No compartido",
-    "Unshared Devices": "Equipos no Compartidos",
-    "Unshared Folders": "Carpetas no Compartidas",
-    "Untrusted": "No Confiable",
+    "Unshared Devices": "Equipos no compartidos",
+    "Unshared Folders": "Carpetas no compartidas",
+    "Untrusted": "No confiable",
     "Up to Date": "Actualizado",
     "Updated": "Actualizado",
     "Upgrade": "Actualizar",
@@ -420,9 +420,9 @@
     "Versions": "Versiones",
     "Versions Path": "Ruta de las versiones",
     "Versions are automatically deleted if they are older than the maximum age or exceed the number of files allowed in an interval.": "Las versiones se borran automáticamente si son más antiguas que la edad máxima o exceden el número de ficheros permitidos en un intervalo.",
-    "Waiting to Clean": "Esperando para Limpiar",
-    "Waiting to Scan": "Esperando para Escanear",
-    "Waiting to Sync": "Esperando para Sincronizar",
+    "Waiting to Clean": "Esperando para limpiar",
+    "Waiting to Scan": "Esperando para escanear",
+    "Waiting to Sync": "Esperando para sincronizar",
     "Warning": "Advertencia",
     "Warning, this path is a parent directory of an existing folder \"{%otherFolder%}\".": "¡Peligro! Esta ruta es un directorio principal de la carpeta ya existente \"{{otherFolder}}\".",
     "Warning, this path is a parent directory of an existing folder \"{%otherFolderLabel%}\" ({%otherFolder%}).": "'Peligro! Esta ruta es un subdirectorio de la carpeta ya existente \"{{otherFolderLabel}}\"  ({{otherFolder}}).",
@@ -435,7 +435,7 @@
     "When adding a new device, keep in mind that this device must be added on the other side too.": "Cuando añada un nuevo dispositivo, tenga en cuenta que este debe añadirse también en el otro lado.",
     "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.": "Cuando añada una nueva carpeta, tenga en cuenta que su ID se usa para unir carpetas entre dispositivos. Son sensibles a las mayúsculas y deben coincidir exactamente entre todos los dispositivos.",
     "Yes": "Si",
-    "Yesterday": "Yesterday",
+    "Yesterday": "Ayer",
     "You can also select one of these nearby devices:": "Puedes seleccionar también uno de estos dispositivos cercanos:",
     "You can change your choice at any time in the Settings dialog.": "Puedes cambiar tu elección en cualquier momento en el panel de Ajustes.",
     "You can read more about the two release channels at the link below.": "Puedes leer más sobre los dos método de publicación de versiones en el siguiente enlace.",
@@ -443,7 +443,7 @@
     "You have no ignored folders.": "No tienes carpetas ignoradas.",
     "You have unsaved changes. Do you really want to discard them?": "Tienes cambios sin guardar. ¿Quieres descartarlos?",
     "You must keep at least one version.": "Debes mantener al menos una versión.",
-    "You should never add or change anything locally in a \"{%receiveEncrypted%}\" folder.": "Nunca debe agregar o cambiar nada localmente en una carpeta \"{{receiveEncrypted}}\".",
+    "You should never add or change anything locally in a \"{%receiveEncrypted%}\" folder.": "Nunca debes añadir o cambiar nada localmente en una carpeta \"{{receiveEncrypted}}\".",
     "days": "días",
     "directories": "directorios",
     "files": "archivos",

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" "Feb 20, 2022" "v1" "Syncthing"
+.TH "STDISCOSRV" "1" "Feb 23, 2022" "v1" "Syncthing"
 .SH NAME
 stdiscosrv \- Syncthing Discovery Server
 .SH SYNOPSIS

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" "Feb 20, 2022" "v1" "Syncthing"
+.TH "STRELAYSRV" "1" "Feb 23, 2022" "v1" "Syncthing"
 .SH NAME
 strelaysrv \- Syncthing Relay Server
 .SH SYNOPSIS

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" "Feb 20, 2022" "v1" "Syncthing"
+.TH "SYNCTHING-BEP" "7" "Feb 23, 2022" "v1" "Syncthing"
 .SH NAME
 syncthing-bep \- Block Exchange Protocol v1
 .SH INTRODUCTION AND DEFINITIONS
@@ -48,7 +48,7 @@ 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
-document are to be interpreted as described in [RFC 2119](\fI\%https://datatracker.ietf.org/doc/html/rfc2119\fP).
+document are to be interpreted as described in \fI\%RFC 2119\fP <\fBhttps://datatracker.ietf.org/doc/html/rfc2119.html\fP>\&.
 .SH TRANSPORT AND AUTHENTICATION
 .sp
 BEP is deployed as the highest level in a protocol stack, with the lower

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" "Feb 20, 2022" "v1" "Syncthing"
+.TH "SYNCTHING-CONFIG" "5" "Feb 23, 2022" "v1" "Syncthing"
 .SH NAME
 syncthing-config \- Syncthing Configuration
 .SH SYNOPSIS
@@ -904,9 +904,9 @@ untrusted\&.
 .UNINDENT
 .UNINDENT
 .sp
-There must be exactly one \fBgui\fP element. The GUI configuration is also used
-by the rest\-api and the event\-api\&. The following attributes may
-be set on the \fBgui\fP element:
+There must be exactly one \fBgui\fP element. The GUI configuration is also used by
+the /dev/rest and the /dev/events\&. The following attributes may be
+set on the \fBgui\fP element:
 .INDENT 0.0
 .TP
 .B enabled
@@ -922,7 +922,8 @@ still possible but not required.
 .INDENT 0.0
 .TP
 .B debugging
-This enables profiling and additional debugging endpoints in the rest\-api\&.
+This enables /users/profiling and additional endpoints in the REST
+API, see /rest/debug\&.
 .UNINDENT
 .sp
 The following child elements may be present:

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" "Feb 20, 2022" "v1" "Syncthing"
+.TH "SYNCTHING-DEVICE-IDS" "7" "Feb 23, 2022" "v1" "Syncthing"
 .SH NAME
 syncthing-device-ids \- Understanding Device IDs
 .sp

man/syncthing-event-api.7

@@ -27,13 +27,13 @@ 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" "Feb 20, 2022" "v1" "Syncthing"
+.TH "SYNCTHING-EVENT-API" "7" "Feb 23, 2022" "v1" "Syncthing"
 .SH NAME
 syncthing-event-api \- Event API
 .SH DESCRIPTION
 .sp
 Syncthing provides a simple long polling interface for exposing events from the
-core utility towards a GUI. To receive events, see events\-get\&.
+core utility towards a GUI. To receive events, see /rest/events\-get\&.
 .SH EVENT STRUCTURE
 .sp
 Each event is represented by an object similar to the following:

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" "Feb 20, 2022" "v1" "Syncthing"
+.TH "SYNCTHING-FAQ" "7" "Feb 23, 2022" "v1" "Syncthing"
 .SH NAME
 syncthing-faq \- Frequently Asked Questions
 .INDENT 0.0
@@ -414,11 +414,11 @@ locally may be overwritten by those on other devices.
 .sp
 An alternative way is to shut down Syncthing, move the folder on disk (including
 the \fB\&.stfolder\fP marker), edit the path directly in \fBconfig.xml\fP in the
-configuration folder (see config) and then start Syncthing again.
+configuration folder (see /users/config) and then start Syncthing again.
 .SS How do I configure multiple users on a single machine?
 .sp
 Each user should run their own Syncthing instance. Be aware that you might need
-to configure listening ports such that they do not overlap (see config).
+to configure listening ports such that they do not overlap (see /users/config).
 .SS Does Syncthing support syncing between folders on the same system?
 .sp
 No. Syncthing is not designed to sync locally and the overhead involved in

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" "Feb 20, 2022" "v1" "Syncthing"
+.TH "SYNCTHING-GLOBALDISCO" "7" "Feb 23, 2022" "v1" "Syncthing"
 .SH NAME
 syncthing-globaldisco \- Global Discovery Protocol v3
 .SH ANNOUNCEMENTS

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" "Feb 20, 2022" "v1" "Syncthing"
+.TH "SYNCTHING-LOCALDISCO" "7" "Feb 23, 2022" "v1" "Syncthing"
 .SH NAME
 syncthing-localdisco \- Local Discovery Protocol v4
 .SH MODE OF OPERATION

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" "Feb 20, 2022" "v1" "Syncthing"
+.TH "SYNCTHING-NETWORKING" "7" "Feb 23, 2022" "v1" "Syncthing"
 .SH NAME
 syncthing-networking \- Firewall Setup
 .SH ROUTER SETUP

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" "Feb 20, 2022" "v1" "Syncthing"
+.TH "SYNCTHING-RELAY" "7" "Feb 23, 2022" "v1" "Syncthing"
 .SH NAME
 syncthing-relay \- Relay Protocol v1
 .SH WHAT IS A RELAY?

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" "Feb 20, 2022" "v1" "Syncthing"
+.TH "SYNCTHING-REST-API" "7" "Feb 23, 2022" "v1" "Syncthing"
 .SH NAME
 syncthing-rest-api \- REST API
 .sp
@@ -43,6 +43,13 @@ the configuration file. To use an API key, set the request header
 \fBX\-API\-Key\fP to the API key value. For example, \fBcurl \-X POST \-H
 "X\-API\-Key: abc123" http://localhost:8384/rest/...\fP can be used to invoke
 with \fBcurl\fP (add \fB\-k\fP flag when using HTTPS with a Syncthing generated or self signed certificate).
+.SH RESULT PAGINATION
+.sp
+Some \fIGET\fP endpoints take optional \fBpage\fP and \fBperpage\fP arguments for
+pagination.  No more than \fBperpage\fP (defaults to 65536 if not given) result
+entries are returned in an array.  To access further entries, passing the
+\fBpage\fP parameter will advance in the results by that many pages.  The actually
+used parameters are always returned as attributes in the response object.
 .SH SYSTEM ENDPOINTS
 .SS GET /rest/system/browse
 .sp
@@ -594,7 +601,8 @@ error. The new error will be displayed on any active GUI clients.
 New in version 0.12.0.
 
 .sp
-Returns the list of recent log entries.
+Returns the list of recent log entries.  The optional \fBsince\fP parameter limits
+the results to message newer than the given timestamp in \fI\%RFC 3339\fP <\fBhttps://datatracker.ietf.org/doc/html/rfc3339.html\fP> format.
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -612,6 +620,9 @@ Returns the list of recent log entries.
 .fi
 .UNINDENT
 .UNINDENT
+.SS GET /rest/system/log.txt
+.sp
+Returns the same information, formatted as a text log instead of a JSON object.
 .SS POST /rest/system/pause
 .sp
 Pause the given device or all devices.
@@ -648,13 +659,14 @@ information for that folder will be erased:
 .sp
 .nf
 .ft C
-$ curl \-X POST \-H "X\-API\-Key: abc123" http://localhost:8384/rest/system/reset?folder=ab1c2\-def3g
+curl \-X POST \-H "X\-API\-Key: abc123" http://localhost:8384/rest/system/reset?folder=ab1c2\-def3g
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-\fBCaution\fP: See \fB\-\-reset\-database\fP for \fB\&.stfolder\fP creation side\-effect and caution regarding mountpoints.
+\fBCaution\fP: See \fB\-\-reset\-database\fP for \fB\&.stfolder\fP creation
+side\-effect and caution regarding mountpoints.
 .SS POST /rest/system/restart
 .sp
 Post with empty body to immediately restart Syncthing.
@@ -827,8 +839,8 @@ Returns the current Syncthing version information.
 New in version 1.12.0.
 
 .sp
-These endpoints facilitate access and modification of the configuration in a granular way. Config sent to the endpoints must be in the same
-format as returned by the corresponding GET request. When posting the
+These endpoints facilitate access and modification of the configuration in a granular way. Config sent to the endpoints must be in the
+same format as returned by the corresponding GET request. When posting the
 configuration succeeds, the posted configuration is immediately applied, except
 for changes that require a restart. Query \fI\%/rest/config/restart\-required\fP to check if
 a restart is required.
@@ -857,6 +869,20 @@ Put the desired folder\- respectively device\-ID in place of *id*. \fBGET\fP
 returns the folder/device for the given ID, \fBPUT\fP replaces the entire config,
 \fBPATCH\fP replaces only the given child objects and \fBDELETE\fP removes the
 folder/device.
+.SS /rest/config/defaults/folder, /rest/config/defaults/device
+.sp
+\fBGET\fP returns a template folder / device configuration object with all default
+values, which only needs a unique ID to be applied.  \fBPUT\fP replaces the
+default config (omitted values are reset to the hard\-coded defaults), \fBPATCH\fP
+replaces only the given child objects.
+.SS /rest/config/defaults/ignores
+.sp
+New in version 1.19.0.
+
+.sp
+\fBGET\fP returns an object with a single \fBlines\fP attribute listing ignore
+patterns to be used by default on folders, as an array of single\-line strings.
+\fBPUT\fP replaces the default ignore patterns from an object of the same format.
 .SS /rest/config/options, /rest/config/ldap, /rest/config/gui
 .sp
 \fBGET\fP returns the respective object, \fBPUT\fP replaces the entire object and
@@ -869,9 +895,9 @@ Concerns the mesh network structure.
 New in version 1.18.0.
 
 .sp
-Remove records about a pending remote device which tried to connect.
-Valid values for the \fBdevice\fP parameter are those from the
-corresponding /rest/cluster\-pending\-devices\-get endpoint.
+Remove records about a pending remote device which tried to connect.  Valid
+values for the \fBdevice\fP parameter are those from the corresponding
+cluster\-pending\-devices\-get endpoint.
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -917,12 +943,11 @@ configured in our instance.
 New in version 1.18.0.
 
 .sp
-Remove records about a pending folder announced from a remote device.
-Valid values for the \fBfolder\fP and \fBdevice\fP parameters are those
-from the corresponding /rest/cluster\-pending\-folders\-get
-endpoint.  The \fBdevice\fP parameter is optional and affects
-announcements of this folder from the given device, or from \fIany\fP
-device if omitted.
+Remove records about a pending folder announced from a remote device.  Valid
+values for the \fBfolder\fP and \fBdevice\fP parameters are those from the
+corresponding cluster\-pending\-folders\-get endpoint.  The \fBdevice\fP
+parameter is optional and affects announcements of this folder from the given
+device, or from \fIany\fP device if omitted.
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -934,12 +959,13 @@ $ curl \-X DELETE \-H "X\-API\-Key: abc123" http://localhost:8384/rest/cluster/p
 .UNINDENT
 .UNINDENT
 .sp
-Returns status 200 and no content upon success, or status 500 and a
-plain text error on failure.  A /events/pendingfolderschanged
-event will be generated in response.
+Returns status 200 and no content upon success, or status 500 and a plain text
+error on failure.  A /events/pendingfolderschanged event will be
+generated in response.
 .sp
-For a more permanent effect, also for future announcements of the same
-folder ID, the folder should be ignored in the configuration instead.
+For a more permanent effect, also for future announcements of the same folder
+ID, the folder should be ignored in the configuration
+instead.
 .SS GET /rest/cluster/pending/folders
 .sp
 New in version 1.13.0.
@@ -986,6 +1012,115 @@ Other offering devices are also omitted from the result.
 .fi
 .UNINDENT
 .UNINDENT
+.SH FOLDER ENDPOINTS
+.sp
+Runtime state of the individual shared folders.
+.SS GET /rest/folder/errors
+.sp
+New in version 0.14.53.
+
+.sp
+Takes one mandatory parameter, \fBfolder\fP, and returns the list of errors
+encountered during scanning or pulling.
+.sp
+The results can be paginated using the common pagination parameters\&.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+{
+  "folder": "nnhic\-sxuae",
+  "errors": [
+    {
+      "path": "noperm.txt",
+      "error": "hashing: open /path/to/folder/noperm.txt: permission denied"
+    }
+  ],
+  "page": 1,
+  "perpage": 100
+}
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS GET /rest/folder/pullerrors
+.sp
+Deprecated since version v0.14.53: This endpoint still works as before but is deprecated.  Use
+folder\-errors\-get instead, which returns the same information.
+.sp
+See \fI\%d510e3cca3d5caae42121fa206b3decc981ae59e\fP <\fBhttps://github.com/syncthing/syncthing/commit/d510e3cca3d5caae42121fa206b3decc981ae59e\fP>
+
+.SS GET /rest/folder/versions
+.sp
+New in version 0.14.44.
+
+.sp
+Takes one mandatory parameter, \fBfolder\fP, and returns the list of archived
+files that could be recovered.  How many versions are available depends on the
+/users/versioning configuration.  Each entry specifies when the file
+version was archived as the \fBversionTime\fP, the \fBmodTime\fP when it was last
+modified before being archived, and the size in bytes.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+{
+  "dir1/dir2/bar": [
+    {
+      "versionTime": "2022\-02\-06T20:44:12+01:00",
+      "modTime": "2021\-01\-14T13:21:22+01:00",
+      "size": 4
+    }
+  ],
+  "baz": [
+    {
+      "versionTime": "2022\-02\-06T20:44:20+01:00",
+      "modTime": "2021\-01\-14T13:23:49+01:00",
+      "size": 4
+    }
+  ],
+  "foo": [
+    {
+      "versionTime": "2022\-02\-06T20:55:31+01:00",
+      "modTime": "2022\-02\-06T20:44:13+01:00",
+      "size": 4
+    },
+    {
+      "versionTime": "2022\-02\-06T20:44:20+01:00",
+      "modTime": "2021\-01\-14T13:21:16+01:00",
+      "size": 4
+    }
+  ]
+}
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS POST /rest/folder/versions
+.sp
+Restore archived versions of a given set of files.  Expects an object with
+attributes named after the relative file paths, with timestamps as values
+matching valid \fBversionTime\fP entries in the corresponding
+folder\-versions\-get response object.
+.sp
+Takes the mandatory parameter \fBfolder\fP (folder ID).  Returns an object
+containing any error messages that occurred during restoration of the file, with
+the file path as attribute name.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+curl \-X POST \-H X\-API\-key:... http://127.0.0.1:8384/rest/folder/versions?folder=default \-d \(aq{
+  "dir1/dir2/bar": "2022\-02\-06T20:44:12+01:00",
+  "baz": "2022\-02\-06T20:44:20+01:00"
+}\(aq
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
 .SH DATABASE ENDPOINTS
 .SS GET /rest/db/browse
 .sp
@@ -1233,19 +1368,62 @@ provides a list of strings which represent globbing patterns described by gobwas
 .UNINDENT
 .SS POST /rest/db/ignores
 .sp
-Expects a format similar to the output of \fBGET\fP call, but only
+Expects a format similar to the output of db\-ignores\-get call, but only
 containing the \fBignore\fP field (\fBexpanded\fP field should be omitted).
 It takes one parameter, \fBfolder\fP, and either updates the content of
 the \fB\&.stignore\fP echoing it back as a response, or returns an error.
+.SS GET /rest/db/localchanged
+.sp
+New in version 0.14.55.
+
+.sp
+Takes one mandatory parameter, \fBfolder\fP, and returns the list of files which
+were changed locally in a receive\-only folder.  Thus they differ from the global
+state and could be reverted by pulling from remote devices again, see
+db\-revert\-post\&.
+.sp
+The results can be paginated using the common pagination parameters\&.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+{
+  "files": [
+    {
+      "flags": "0755",
+      "sequence": 6,
+      "modified": "2015\-04\-20T23:06:12+09:00",
+      "name": "ls",
+      "size": 34640,
+      "version": [
+        "5157751870738175669:1"
+      ]
+    }
+  ],
+  "page": 1,
+  "perpage": 100
+}
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+This is an expensive call, increasing CPU and RAM usage on the device.
+Use sparingly.
+.UNINDENT
+.UNINDENT
 .SS GET /rest/db/need
 .sp
 Takes one mandatory parameter, \fBfolder\fP, and returns lists of files which are
 needed by this device in order for it to become in sync.
 .sp
-Furthermore takes an optional \fBpage\fP and \fBperpage\fP arguments for pagination.
-Pagination happens, across the union of all needed files, that is \- across all
-3 sections of the response.
-For example, given the current need state is as follows:
+The results can be paginated using the common pagination parameters\&.  Pagination happens, across the union of all needed files,
+that is \- across all 3 sections of the response.  For example, given the current
+need state is as follows:
 .INDENT 0.0
 .IP 1. 3
 \fBprogress\fP has 15 items
@@ -1262,8 +1440,13 @@ section in the response will have 10 items. If you issue a request query with
 2 items. If you issue a query for \fBpage=3\fP and \fBperpage=10\fP, you will only
 have the last 10 items of the \fBrest\fP section.
 .sp
-In all these calls, \fBtotal\fP will be 30 to indicate the total number of
-available items.
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+Return format changed in version 0.14.43, removing the \fBtotal\fP count
+attribute.
+.UNINDENT
+.UNINDENT
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -1293,8 +1476,7 @@ available items.
       ...
   ],
   "page": 1,
-  "perpage": 100,
-  "total": 2000
+  "perpage": 100
 }
 .ft P
 .fi
@@ -1304,7 +1486,8 @@ available items.
 \fBNOTE:\fP
 .INDENT 0.0
 .INDENT 3.5
-This is an expensive call, increasing CPU and RAM usage on the device. Use sparingly.
+This is an expensive call, increasing CPU and RAM usage on the device.
+Use sparingly.
 .UNINDENT
 .UNINDENT
 .SS POST /rest/db/override
@@ -1338,7 +1521,50 @@ curl \-X POST http://127.0.0.1:8384/rest/db/prio?folder=default&file=foo/bar
 .UNINDENT
 .UNINDENT
 .sp
-Response contains the same output as \fBGET /rest/db/need\fP
+Response contains the same output as db\-need\-get\&.
+.SS GET /rest/db/remoteneed
+.sp
+New in version 0.14.43.
+
+.sp
+Takes the mandatory parameters \fBfolder\fP and \fBdevice\fP, and returns the list
+of files which are needed by that remote device in order for it to become in
+sync with the shared folder.
+.sp
+The results can be paginated using the common pagination parameters\&.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+{
+  "files": [
+    {
+      "flags": "0755",
+      "sequence": 6,
+      "modified": "2015\-04\-20T23:06:12+09:00",
+      "name": "ls",
+      "size": 34640,
+      "version": [
+        "5157751870738175669:1"
+      ]
+    }
+  ],
+  "page": 1,
+  "perpage": 100
+}
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+This is an expensive call, increasing CPU and RAM usage on the device.
+Use sparingly.
+.UNINDENT
+.UNINDENT
 .SS POST /rest/db/revert
 .sp
 New in version 0.14.50.
@@ -1503,6 +1729,11 @@ To receive only a limited number of events, add the \fBlimit=<n>\fP parameter wi
 suitable value for \fBn\fP and only the \fIlast\fP \fBn\fP events will be returned. This
 can be used to catch up with the latest event ID after a disconnection for
 example: \fB/rest/events?since=0&limit=1\fP\&.
+.SS GET /rest/events/disk
+.sp
+This convenience endpoint provides the same event stream, but pre\-filtered to show
+only /events/localchangedetected and /events/remotechangedetected
+event types.  The \fBevents\fP parameter is not used.
 .SH STATISTICS ENDPOINTS
 .SS GET /rest/stats/device
 .sp
@@ -1532,14 +1763,13 @@ last scan time and the last synced file.
 .sp
 .nf
 .ft C
-$ curl \-s http://localhost:8384/rest/stats/folder | json
 {
-  "folderid" : {
+  "folderid": {
     "lastScan": "2016\-06\-02T13:28:01.288181412\-04:00",
-    "lastFile" : {
-      "filename" : "file/name",
-        "at" : "2015\-04\-16T22:04:18.3066971+01:00"
-      }
+    "lastFile": {
+      "filename": "file/name",
+      "at": "2015\-04\-16T22:04:18.3066971+01:00"
+    }
   }
 }
 .ft P
@@ -1663,6 +1893,50 @@ Returns the data sent in the anonymous usage report.
 .fi
 .UNINDENT
 .UNINDENT
+.SH DEBUG ENDPOINTS
+.SS Debug Endpoints
+.sp
+These endpoints require the \fBgui.debugging\fP configuration option to
+be enabled and yield an access denied error code otherwise.
+.SS GET /rest/debug/peerCompletion
+.sp
+Summarizes the completion precentage for each remote device.  Returns an object
+with device IDs as keys and an integer percentage as values.
+.SS GET /rest/debug/httpmetrics
+.sp
+Returns statistics about each served REST API endpoint, to diagnose how much
+time was spent generating the responses.
+.SS GET /rest/debug/cpuprof
+.sp
+Used to capture a profile of what Syncthing is doing on the CPU.  See
+/users/profiling\&.
+.SS GET /rest/debug/heapprof
+.sp
+Used to capture a profile of what Syncthing is doing with the heap memory.  See
+/users/profiling\&.
+.SS GET /rest/debug/support
+.sp
+Collects information about the running instance for troubleshooting purposes.
+Returns a “support bundle” as a zipped archive, which should be sent to the
+developers after verifying it contains no sensitive personal information.
+Credentials for the web GUI and the API key are automatically redacted already.
+.SS GET /rest/debug/file
+.sp
+Shows diagnostics about a certain file in a shared folder.  Takes the \fBfolder\fP
+(folder ID) and \fBfile\fP (folder relative path) parameters.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+$ curl \-H X\-API\-Key:... "http://localhost:8384/rest/debug/file?folder=default&file=foo/bar"
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+The returned object contains the same info as db\-file\-get, plus a summary
+of \fBglobalVersions\fP\&.
 .SH AUTHOR
 The Syncthing Authors
 .SH COPYRIGHT

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" "Feb 20, 2022" "v1" "Syncthing"
+.TH "SYNCTHING-SECURITY" "7" "Feb 23, 2022" "v1" "Syncthing"
 .SH NAME
 syncthing-security \- Security Principles
 .sp

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" "Feb 20, 2022" "v1" "Syncthing"
+.TH "SYNCTHING-STIGNORE" "5" "Feb 23, 2022" "v1" "Syncthing"
 .SH NAME
 syncthing-stignore \- Prevent files from being synchronized to other nodes
 .SH SYNOPSIS

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" "Feb 20, 2022" "v1" "Syncthing"
+.TH "SYNCTHING-VERSIONING" "7" "Feb 23, 2022" "v1" "Syncthing"
 .SH NAME
 syncthing-versioning \- Keep automatic backups of deleted files by other nodes
 .sp

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" "Feb 20, 2022" "v1" "Syncthing"
+.TH "SYNCTHING" "1" "Feb 23, 2022" "v1" "Syncthing"
 .SH NAME
 syncthing \- Syncthing
 .SH SYNOPSIS