Docs: documenting multiple emails in patron editor (LP1755625)

Signed-off-by: Jane Sandberg <sandbej@linnbenton.edu>

diff --git a/docs/admin/patron_registration.adoc b/docs/admin/patron_registration.adoc
new file mode 100644 (file)
index 0000000..d13831d
--- /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 4f99497..2a7588c 100644 (file)
--- 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 45cc690..bd3c630 100644 (file)
--- 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[]