Description for PR #8327

builds/install/misc/replication.conf

@@ -122,6 +122,45 @@ database
 	# Multiple entries are allowed (for different synchronous replicas).
 	#
 	# sync_replica = 
+	#
+	# It's also possible to configure replicas as separate sub-sections, e.g.:
+	#
+	# sync_replica = server1:replica
+	# {
+	#   username = john
+	#   password = smith
+	# }
+	#
+	# sync_replica = server2:replica
+	# {
+	#   username = john
+	#   password = smith
+	# }
+	#
+	# This way characters ':' and '@' are allowed inside username/password or database pathname.
+	#
+	# Alternative parameters -- username_env, password_env, username_file, password_file -- allow
+	# to specify username and password externally, using either environment variables or
+	# plain text files respectively, e.g.:
+	#
+	# sync_replica = server2:/my/replica/database.fdb
+	# {
+	#   username_env = FB_REPL_USER
+	#   password_file = /opt/firebird/repl_pwd.txt
+	# }
+	#
+	# sync_replica = server2:/my/replica/database.fdb
+	# {
+	#   username_file = /opt/firebird/repl_user.txt
+	#   password_env = FB_REPL_PWD
+	# }
+	#
+	# If username_file / password_file is specified, the first non-empty line of the provided file
+	#
+	# If username_file or password_file values represent a relative pathname,
+	# it's resolved based on the Firebird root directory:
+	#
+	# password_file = repl_pwd.txt # => resolves to /opt/firebird/repl_pwd.txt
 
 
 	### REPLICA SIDE SETTINGS