From 6693fe5d6df5617a2cc2b13262293fba15518e4f Mon Sep 17 00:00:00 2001
From: Richard Heck <rgheck@lyx.org>
Date: Thu, 19 Jan 2017 15:23:35 -0500
Subject: [PATCH] Add some remarks about defining formatted references.

---
 lib/doc/UserGuide.lyx | 45 +++++++++++++++++++++++++++++++++++++++----
 status.22x            |  3 +++
 2 files changed, 44 insertions(+), 4 deletions(-)

diff --git a/lib/doc/UserGuide.lyx b/lib/doc/UserGuide.lyx
index 15995f31b1..9b189b3109 100644
--- a/lib/doc/UserGuide.lyx
+++ b/lib/doc/UserGuide.lyx
@@ -26479,8 +26479,12 @@ newref
 \series default
  (refstyle) in the \SpecialChar LaTeX
  preamble of the document.
- For example redefining all references to figures (which have the label
- shortcut 
+ For example, if you are using 
+\series bold
+refstyle
+\series default
+, then redefining all references to figures (which have the label shortcut
+ 
 \begin_inset Quotes eld
 \end_inset
 
@@ -26508,8 +26512,41 @@ pageref{#1}}}
 \begin_inset Newline newline
 \end_inset
 
-For more information about the format, have a look at the package documentations
-, 
+Please note that neither 
+\series bold
+prettyref
+\series default
+ nor 
+\series bold
+refstyle
+\series default
+ (nor LyX itself) defines reference formats for all available types.
+ This is especially true for the wide variety of mathematical `theorem'
+ environments.
+ So if you want to make formatted references to, say, Propositions, then
+ you will need to define the relevant format yourself.
+ For 
+\series bold
+prettyref
+\series default
+, you might do so as follows: 
+\begin_inset Newline newline
+\end_inset
+
+
+\series bold
+
+\backslash
+newrefformat{prop}{Proposition 
+\backslash
+ref{#1}}
+\series default
+
+\begin_inset Newline newline
+\end_inset
+
+For more information about the defining formatted references, have a look
+ at the package documentations, 
 \begin_inset CommandInset citation
 LatexCommand cite
 key "prettyref,refstyle"
diff --git a/status.22x b/status.22x
index a9f1fb22cd..6897b34eef 100644
--- a/status.22x
+++ b/status.22x
@@ -192,6 +192,9 @@ What's new
 
 - Fix compilation of the Fexynman diagram example file.
 
+- Added some comments to User Guide section 6.1 about defining formatted
+  references (bug 10545).
+
 
 * LYXHTML
 
-- 
2.39.5