manpage: Advise vfs_fruit:veto_appledouble=yes can break rsync
authorAdam Nielsen <malvineous@shikadi.net>
Sun, 15 Oct 2017 01:56:32 +0000 (11:56 +1000)
committerAndrew Bartlett <abartlet@samba.org>
Mon, 17 Dec 2018 00:24:15 +0000 (01:24 +0100)
Reviewed-by: Andreas Schneider <asn@samba.org>
Reviewed-by: Uri Simchoni <uri@samba.org>
Reviewed-by: Andrew Bartlett <abartlet@samba.org>
docs-xml/manpages/vfs_fruit.8.xml

index e4ca7bd182894ee59e86e890998041627c967772..c5bd593a1392e7a3fe5de43ea67bb707e411439c 100644 (file)
              <parameter>file</parameter>, vfs_fruit may create ._ AppleDouble
              files. This options controls whether these ._ AppleDouble files
              are vetoed which prevents the client from accessing them.</para>
-             <para>Vetoing ._ files may break some applications, eg
-             extracting Mac ZIP archives from Mac clients failes,
-             because they contain ._ files. Setting this option to
+             <para>Vetoing ._ files may break some applications, e.g.
+             extracting Mac ZIP archives from Mac clients fails,
+             because they contain ._ files. <command>rsync</command> will
+             also be unable to sync files beginning with underscores, as
+             the temporary files it uses for these will start with ._ and
+             so cannot be created.</para>
+             <para>Setting this option to
              false will fix this, but the abstraction leak of
              exposing the internally created ._ files may have other
              unknown side effects.</para>