From 5ebb67d85394b4e14291c394ab0e4aacb1ded619 Mon Sep 17 00:00:00 2001
From: Jane Sandberg <sandbej@linnbenton.edu>
Date: Tue, 20 Nov 2018 08:50:35 -0800
Subject: [PATCH] Docs: documenting multiple emails in patron editor
 (LP1755625)

Signed-off-by: Jane Sandberg <sandbej@linnbenton.edu>
---
 docs/admin/patron_registration.adoc           | 24 +++++++++++++++++++
 ...circulation_patron_records_web_client.adoc | 12 ++++++++++
 docs/root_staff_client_admin.adoc             |  2 ++
 3 files changed, 38 insertions(+)
 create mode 100644 docs/admin/patron_registration.adoc

diff --git a/docs/admin/patron_registration.adoc b/docs/admin/patron_registration.adoc
new file mode 100644
index 0000000000..d13831dc6d
--- /dev/null
+++ b/docs/admin/patron_registration.adoc
@@ -0,0 +1,24 @@
+Patron registration administration
+----------------------------------
+
+Email addresses
+~~~~~~~~~~~~~~~
+
+indexterm:[patrons,email addresses]
+indexterm:[email]
+
+
+It's possible to set up the patron registration form to
+either allow or disallow users to enter multiple email
+addresses for a single patron, separated by a comma.
+
+To do this, go to Administration -> Local Administration
+-> Library Settings Editor.  Search for the setting called
+`ui.patron.edit.au.email.regex`.
+
+If you'd like to allow multiple email addresses, set this
+value to `^(?:(?:\b[^@,\s]+@[^@,\s]+\.[^@.,\s]+\b)(?:,\s?(?!$)|$))*$`
+
+If you'd like to disallow multiple email addresses, set
+this value to `^(?:\b[^@,\s]+@[^@,\s]+\.[^@.,\s]+\b)$`
+
diff --git a/docs/circulation/circulation_patron_records_web_client.adoc b/docs/circulation/circulation_patron_records_web_client.adoc
index 4f99497c16..2a7588cd71 100644
--- a/docs/circulation/circulation_patron_records_web_client.adoc
+++ b/docs/circulation/circulation_patron_records_web_client.adoc
@@ -134,6 +134,18 @@ that is not in the default patron record.
 Date_ button will work, since the permission group determines the expiration date.
 ============================================================================
 
+Email field
+^^^^^^^^^^^
+
+indexterm:[patrons,email addresses]
+indexterm:[email]
+
+It's possible for administrators to set up the email field to allow or disallow
+multiple email addresses for a single patron (usually separated by a comma).
+If you'd like to make changes to whether multiple email addresses
+are allowed here or not, ask your system administrator to change the
+`ui.patron.edit.au.email.regex` library setting.
+
 
 Patron Self-Registration
 ~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/docs/root_staff_client_admin.adoc b/docs/root_staff_client_admin.adoc
index 45cc690dcc..bd3c630d9f 100644
--- a/docs/root_staff_client_admin.adoc
+++ b/docs/root_staff_client_admin.adoc
@@ -106,6 +106,8 @@ include::admin/copy_statuses.adoc[]
 
 include::admin/circing_uncataloged_materials.adoc[]
 
+include::admin/patron_registration.adoc[]
+
 include::admin/patron_self_registration.adoc[]
 
 
-- 
2.43.2