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

This commit is contained in:
Syncthing Release Automation
2023-05-01 03:45:35 +00:00
parent f38e9628a1
commit dae5eab787
18 changed files with 56 additions and 18 deletions
+38 -1
View File
@@ -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" "Apr 12, 2023" "v1.23.3" "Syncthing"
.TH "SYNCTHING-FAQ" "7" "Apr 29, 2023" "v1.23.3" "Syncthing"
.SH NAME
syncthing-faq \- Frequently Asked Questions
.INDENT 0.0
@@ -72,6 +72,8 @@ syncthing-faq \- Frequently Asked Questions
\fI\%Does the audit log contain every change?\fP
.IP \(bu 2
\fI\%Why does Syncthing connect to this unknown/suspicious address?\fP
.IP \(bu 2
\fI\%I am seeing the error message “folder marker missing”. What do I do?\fP
.UNINDENT
.IP \(bu 2
\fI\%Usage\fP
@@ -377,6 +379,41 @@ 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 concerned 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.
.SS I am seeing the error message “folder marker missing”. What do I do?
.sp
Syncthing uses a specific marker usually called \fB\&.stfolder\fP to determine whether
a folder is healthy. This is a safety check to ensure that your folder is properly
readable and present on disk. For example, if you remove a USB drive from your computer
or unmount a filesystem, then syncthing must know whether you have really deleted \fBall\fP of
your files. Therefore, syncthing always checks that the \fB\&.stfolder\fP is present.
.sp
When this error appears, syncthing assumes that the folder has encountered some type of error
and will stop syncing it until the \fB\&.stfolder\fP reappears. Once that happens, all changes made
to the folder locally will be synced (i.e. missing files will be considered deletions).
.INDENT 0.0
.IP \(bu 2
If you get this error message, check the folder in question on your storage. If you have
unmounted the folder (or a parent of it), you must remount it for syncthing to resume syncing
this folder.
.IP \(bu 2
If you have moved the folder, you must either move it back to its original location, or remove the
folder from within the syncthing UI and re\-add it at its new location.
.IP \(bu 2
If the folder is present on disk, with all of its children files and directories, but the \fB\&.stfolder\fP
is still missing:
.sp
It is possible that a file cleaning software has removed the \fB\&.stfolder\fP\&. Some software
removes empty folders, and the \fB\&.stfolder\fP is often empty. This happens particularly often on Android.
To remediate, recreate the \fB\&.stfolder\fP and add a dummy file in it, or add an exception to your
cleaning software.
.UNINDENT
.sp
If you are still unsure what has happened, you can remove the folder from within the syncthing UI and re\-add it
at the same location. This causes syncthing to attempt an automatic re\-creation of the \fB\&.stfolder\fP\&. Next,
it will also reset the database state of this folder. It will be considered a “new” folder, meaning that its files
will be merged with files from remote devices.
.sp
Also see the \fI\%marker FAQ\fP for more information about the folder marker.
.SH USAGE
.SS What if there is a conflict?
.sp