From e13d287e56e812676627f14491f9c0052cc54282 Mon Sep 17 00:00:00 2001
From: Boris Kolpackov <boris@codesynthesis.com>
Date: Sun, 23 Jan 2011 12:45:15 +0200
Subject: Add note on pragma file inclusion options

---
 doc/manual.xhtml | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

(limited to 'doc')

diff --git a/doc/manual.xhtml b/doc/manual.xhtml
index 0bee542..deb2bd8 100644
--- a/doc/manual.xhtml
+++ b/doc/manual.xhtml
@@ -5118,6 +5118,33 @@ private:
 };
   </pre>
 
+  <p>If we would like to factor the ODB pragmas into a separate file,
+     we can include this file into the original header file (the one
+     that defines the persistent types) using the <code>#include</code>
+     directive, for example:</p>
+
+  <pre class="c++">
+// person.hxx
+
+class person
+{
+  ...
+};
+
+#ifdef ODB_COMPILER
+#  include "person-pragmas.hxx"
+#endif
+  </pre>
+
+  <p>Alternatively, instead of using the <code>#include</code> directive,
+     we can use the <code>--odb-epilogue</code> option to make the pragmas
+     known to the ODB compiler when compiling the original header file,
+     for example:</p>
+
+  <pre class="terminal">
+--odb-epilogue  '#include "person-pragmas.hxx"'
+  </pre>
+
   <p>The following three sections cover the specifiers applicable
      to the <code>object</code>, <code>value</code>, and <code>member</code>
      qualifiers.</p>
-- 
cgit v1.1