From 41ccee59226737e5a2289151bd389a5220d35546 Mon Sep 17 00:00:00 2001
From: twojstaryzdomu <twojstaryzdomu@github.com>
Date: Tue, 11 Jan 2022 18:03:37 +0100
Subject: [PATCH] Document order of precedence for symlink handling options

---
 rsync.1.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/rsync.1.md b/rsync.1.md
index 3d812d5ec..8e8512a90 100644
--- a/rsync.1.md
+++ b/rsync.1.md
@@ -4160,6 +4160,14 @@ first line that is a complete subset of your options:
     recent files existing on the destination, allow any less recent directory
     to be replaced by more recent symlinks.
 
+Note that some options are mutually exclusive.  The first option listed
+below prevails over the others, when multiple symlink mode options are
+specified.
+
+0.  `--update-links`
+0.  `--copy-links`
+0.  `--links`
+
 # DIAGNOSTICS
 
 rsync occasionally produces error messages that may seem a little cryptic.  The