Update documentation to 5.5 (#65)

And update some old http links.
nhibernate · Dec 24, 2023 · 23b73ee · 23b73ee
1 parent 1163b2c
commit 23b73ee
Show file tree

Hide file tree

Showing 83 changed files with 26,247 additions and 117 deletions.
diff --git a/_posts/2022-11-20-nhibernate-5-4-released.md b/_posts/2022-11-20-nhibernate-5-4-released.md
@@ -1,7 +1,7 @@
 ---
 layout: post
 title: "NHibernate 5.4 Released"
-date: 2020-11-20T17:20:00Z
+date: 2022-11-20T17:20:00Z
 author: fredericDelaporte
 gravatar: 5eaae4002cdfc206faf907aaf38d8a09
 tags:

diff --git a/_posts/2023-12-24-nhibernate-5-5-released.md b/_posts/2023-12-24-nhibernate-5-5-released.md
@@ -0,0 +1,26 @@
+---
+layout: post
+title: "NHibernate 5.5 Released"
+date: 2023-12-24T17:30:00Z
+author: fredericDelaporte
+gravatar: 5eaae4002cdfc206faf907aaf38d8a09
+tags:
+  - Release Notes
+---
+NHibernate 5.5.0 is now released.
+
+For a list of resolved issues & pull requests, see the [milestone](https://github.com/nhibernate/nhibernate-core/milestone/52?closed=1) or [the release notes](https://github.com/nhibernate/nhibernate-core/blob/5.5.0/releasenotes.txt).
+
+Binaries are available on NuGet and SourceForge:
+https://sourceforge.net/projects/nhibernate/files/NHibernate/5.5.0/
+https://www.nuget.org/packages/NHibernate/5.5.0
+
+##### Possible Breaking Changes #####
+* `Object.Finalize` is no more proxified when the entity base class has a destructor. See #3205.
+* Default not-found behavior now works correctly on many-to-many Criteria fetch. It now throws ObjectNotFoundException exception for not found records. See #2687.
+
+62 issues were resolved in this release.
+
+--
+
+Huge thanks to everyone involved in this release.
diff --git a/doc/index.html b/doc/index.html
@@ -5,7 +5,7 @@
 <h2>Current Reference</h2>
 <ul>
 	<li>
-		<a href="/doc/nhibernate-reference/index.html">The NHibernate Reference, v5.4</a>
+		<a href="/doc/nhibernate-reference/index.html">The NHibernate Reference, v5.5</a>
 		(<a href="/doc/nhibernate-reference/index.html">HTML</a>,
 		<a href="/doc/nh/en/index.html">single page HTML</a>,
 		<a href="/doc/nh/en/nhibernate_reference.pdf">PDF</a>,
@@ -17,6 +17,13 @@ <h2>Current Reference</h2>
 
 <h2>Previous Reference</h2>
 <ul>
+	<li>
+		<a href="/previous-doc/v5.4/ref/index.html">The NHibernate Reference, v5.4</a>
+		(<a href="/previous-doc/v5.4/ref/index.html">HTML</a>,
+		<a href="/previous-doc/v5.4/single/index.html">single page HTML</a>,
+		<a href="/previous-doc/v5.4/single/nhibernate_reference.pdf">PDF</a>,
+		<a href="/previous-doc/v5.4/single/nhibernate.reference.chm">CHM</a>)
+	</li>
 	<li>
 		<a href="/previous-doc/v5.3/ref/index.html">The NHibernate Reference, v5.3</a>
 		(<a href="/previous-doc/v5.3/ref/index.html">HTML</a>,

diff --git a/doc/nh/en/index.html b/doc/nh/en/index.html
diff --git a/doc/nh/en/nhibernate.reference.chm b/doc/nh/en/nhibernate.reference.chm
diff --git a/doc/nh/en/nhibernate_reference.pdf b/doc/nh/en/nhibernate_reference.pdf
diff --git a/doc/nhibernate-reference/architecture.html b/doc/nhibernate-reference/architecture.html
@@ -6,7 +6,14 @@
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <meta http-equiv="X-UA-Compatible" content="IE=edge">
-   <title>Chapter&nbsp;2.&nbsp;Architecture</title><link rel="stylesheet" href="../shared/css/html.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="index.html" title="NHibernate - Relational Persistence for Idiomatic .NET"><link rel="up" href="index.html" title="NHibernate - Relational Persistence for Idiomatic .NET"><link rel="previous" href="quickstart.html" title="Chapter&nbsp;1.&nbsp;Quick-start with IIS and Microsoft SQL Server"><link rel="next" href="session-configuration.html" title="Chapter&nbsp;3.&nbsp;ISessionFactory Configuration"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter&nbsp;2.&nbsp;Architecture</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="quickstart.html">Prev</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="session-configuration.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="architecture"></a>Chapter&nbsp;2.&nbsp;Architecture</h2></div></div><div></div></div>{% include google_adsense.html %}<div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="architecture-overview"></a>2.1.&nbsp;Overview</h2></div></div><div></div></div><p>
+    <title>Chapter&nbsp;2.&nbsp;Architecture</title><link rel="stylesheet" href="../shared/css/html.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="index.html" title="NHibernate - Relational Persistence for Idiomatic .NET"><link rel="up" href="index.html" title="NHibernate - Relational Persistence for Idiomatic .NET"><link rel="previous" href="quickstart.html" title="Chapter&nbsp;1.&nbsp;Quick-start with IIS and Microsoft SQL Server"><link rel="next" href="session-configuration.html" title="Chapter&nbsp;3.&nbsp;ISessionFactory Configuration">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+    <div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter&nbsp;2.&nbsp;Architecture</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="quickstart.html">Prev</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="session-configuration.html">Next</a></td></tr></table><hr></div>
+    <div class="chapter" lang="en">
+        <div class="titlepage"><div><div><h2 class="title"><a name="architecture"></a>Chapter&nbsp;2.&nbsp;Architecture</h2></div></div><div></div></div>
+        {% include google_adsense.html %}
+        <div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="architecture-overview"></a>2.1.&nbsp;Overview</h2></div></div><div></div></div><p>
             A (very) high-level view of the NHibernate architecture:
         </p><div class="mediaobject" align="center"><img src="../shared/images/overview.png" align="middle"></div><p>
             This diagram shows NHibernate using the database and configuration data to
@@ -151,4 +158,6 @@
             there are corresponding short names: <tt class="literal">async_local</tt>, <tt class="literal">call</tt>,
             <tt class="literal">thread_static</tt>, <tt class="literal">web</tt> and <tt class="literal">wcf_operation</tt>,
             respectively.
-        </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="quickstart.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="session-configuration.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter&nbsp;1.&nbsp;Quick-start with IIS and Microsoft SQL Server&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;3.&nbsp;ISessionFactory Configuration</td></tr></table></div>{% include google_analytics.html %}</body></html>
+        </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="quickstart.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="session-configuration.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter&nbsp;1.&nbsp;Quick-start with IIS and Microsoft SQL Server&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;3.&nbsp;ISessionFactory Configuration</td></tr></table></div>
+    {% include google_analytics.html %}
+</body></html>
diff --git a/doc/nhibernate-reference/associations.html b/doc/nhibernate-reference/associations.html
@@ -6,7 +6,14 @@
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <meta http-equiv="X-UA-Compatible" content="IE=edge">
-   <title>Chapter&nbsp;7.&nbsp;Association Mappings</title><link rel="stylesheet" href="../shared/css/html.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="index.html" title="NHibernate - Relational Persistence for Idiomatic .NET"><link rel="up" href="index.html" title="NHibernate - Relational Persistence for Idiomatic .NET"><link rel="previous" href="collections.html" title="Chapter&nbsp;6.&nbsp;Collection Mapping"><link rel="next" href="components.html" title="Chapter&nbsp;8.&nbsp;Component Mapping"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter&nbsp;7.&nbsp;Association Mappings</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="collections.html">Prev</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="components.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="associations"></a>Chapter&nbsp;7.&nbsp;Association Mappings</h2></div></div><div></div></div>{% include google_adsense.html %}<div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="associations-intro"></a>7.1.&nbsp;Introduction</h2></div></div><div></div></div><p>
+    <title>Chapter&nbsp;7.&nbsp;Association Mappings</title><link rel="stylesheet" href="../shared/css/html.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="index.html" title="NHibernate - Relational Persistence for Idiomatic .NET"><link rel="up" href="index.html" title="NHibernate - Relational Persistence for Idiomatic .NET"><link rel="previous" href="collections.html" title="Chapter&nbsp;6.&nbsp;Collection Mapping"><link rel="next" href="components.html" title="Chapter&nbsp;8.&nbsp;Component Mapping">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+    <div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter&nbsp;7.&nbsp;Association Mappings</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="collections.html">Prev</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="components.html">Next</a></td></tr></table><hr></div>
+    <div class="chapter" lang="en">
+        <div class="titlepage"><div><div><h2 class="title"><a name="associations"></a>Chapter&nbsp;7.&nbsp;Association Mappings</h2></div></div><div></div></div>
+        {% include google_adsense.html %}
+        <div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="associations-intro"></a>7.1.&nbsp;Introduction</h2></div></div><div></div></div><p>
             Association mappings are often the most difficult thing to implement correctly. In this section
             we examine some canonical cases one by one, starting with unidirectional mappings and then
             bidirectional cases. We will use <tt class="literal">Person</tt> and <tt class="literal">Address</tt> in all
@@ -428,4 +435,6 @@
 &lt;/join&gt;</pre><p>
             This functionality allows a degree of creativity and flexibility, but it is more practical to
             handle these kinds of cases by using queries.
-        </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="collections.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="components.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter&nbsp;6.&nbsp;Collection Mapping&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;8.&nbsp;Component Mapping</td></tr></table></div>{% include google_analytics.html %}</body></html>
+        </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="collections.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="components.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter&nbsp;6.&nbsp;Collection Mapping&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;8.&nbsp;Component Mapping</td></tr></table></div>
+    {% include google_analytics.html %}
+</body></html>
diff --git a/doc/nhibernate-reference/batch.html b/doc/nhibernate-reference/batch.html
@@ -6,7 +6,14 @@
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <meta http-equiv="X-UA-Compatible" content="IE=edge">
-   <title>Chapter&nbsp;14.&nbsp;Batch processing</title><link rel="stylesheet" href="../shared/css/html.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="index.html" title="NHibernate - Relational Persistence for Idiomatic .NET"><link rel="up" href="index.html" title="NHibernate - Relational Persistence for Idiomatic .NET"><link rel="previous" href="events.html" title="Chapter&nbsp;13.&nbsp;Interceptors and events"><link rel="next" href="queryhql.html" title="Chapter&nbsp;15.&nbsp;HQL: The Hibernate Query Language"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter&nbsp;14.&nbsp;Batch processing</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="events.html">Prev</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="queryhql.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="batch"></a>Chapter&nbsp;14.&nbsp;Batch processing</h2></div></div><div></div></div>{% include google_adsense.html %}<p>
+    <title>Chapter&nbsp;14.&nbsp;Batch processing</title><link rel="stylesheet" href="../shared/css/html.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="index.html" title="NHibernate - Relational Persistence for Idiomatic .NET"><link rel="up" href="index.html" title="NHibernate - Relational Persistence for Idiomatic .NET"><link rel="previous" href="events.html" title="Chapter&nbsp;13.&nbsp;Interceptors and events"><link rel="next" href="queryhql.html" title="Chapter&nbsp;15.&nbsp;HQL: The Hibernate Query Language">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+    <div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter&nbsp;14.&nbsp;Batch processing</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="events.html">Prev</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="queryhql.html">Next</a></td></tr></table><hr></div>
+    <div class="chapter" lang="en">
+        <div class="titlepage"><div><div><h2 class="title"><a name="batch"></a>Chapter&nbsp;14.&nbsp;Batch processing</h2></div></div><div></div></div>
+        {% include google_adsense.html %}
+        <p>
         A naive approach to inserting 100 000 rows in the database using NHibernate might 
         look like this:
     </p><pre class="programlisting">using (ISession session = sessionFactory.OpenSession())
@@ -228,4 +235,6 @@
     int createdEntities = s.CreateQuery(hqlInsert)
         .ExecuteUpdate();
     tx.Commit();
-}</pre></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="events.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="queryhql.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter&nbsp;13.&nbsp;Interceptors and events&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;15.&nbsp;HQL: The Hibernate Query Language</td></tr></table></div>{% include google_analytics.html %}</body></html>
+}</pre></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="events.html">Prev</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="queryhql.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter&nbsp;13.&nbsp;Interceptors and events&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;15.&nbsp;HQL: The Hibernate Query Language</td></tr></table></div>
+    {% include google_analytics.html %}
+</body></html>