Update documentation to 5.5

Author: fredericDelaporte

_posts/2022-11-20-nhibernate-5-4-released.md

@@ -1,30 +1,25 @@
 ---
 layout: post
-title: "NHibernate 5.4 Released"
-date: 2020-11-20T17:20:00Z
+title: "NHibernate 5.5 Released"
+date: 2023-12-24T17:30:00Z
 author: fredericDelaporte
 gravatar: 5eaae4002cdfc206faf907aaf38d8a09
 tags:
   - Release Notes
 ---
-NHibernate 5.4.0 is now released.
+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/36?closed=1) or [the release notes](https://github.com/nhibernate/nhibernate-core/blob/5.4.0/releasenotes.txt).
+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.4.0/
-- https://www.nuget.org/packages/NHibernate/5.4.0
-
-##### Highlights #####
-* NHibernate has gained three new target frameworks: .Net 6, .Net Framework 4.8 and .Net Standard 2.1. NHibernate NuGet package provides them, along with the older targets, .Net Core 2.0, .Net Framework 4.6.1 and .Net Standard 2.0. These new targets allow some NHibernate optimizations for applications using them. The same limitations apply for .Net 6 and .Net Standard 2.1 as for .Net Core 2.0 and .Net Standard 2.0, see NHibernate 5.1.0 release notes.
-* A new batching strategy is available, minimizing the batching memory footprint. See [#2959](https://github.com/nhibernate/nhibernate-core/pull/2959). Using it may increase CPU usage.
-* 201 issues were resolved in this release.
+https://sourceforge.net/projects/nhibernate/files/NHibernate/5.5.0/
+https://www.nuget.org/packages/NHibernate/5.5.0
 
 ##### Possible Breaking Changes #####
-* Linq and criteria queries on unmapped entities will throw instead of returning an empty result list. See [#1106](https://github.com/nhibernate/nhibernate-core/pull/1106), [#1095](https://github.com/nhibernate/nhibernate-core/pull/1095).
-* The second level cache UpdateTimestampsCache does not use locks anymore. This may slightly increase the number of cases where stale data is returned by the query cache. See [#2742](https://github.com/nhibernate/nhibernate-core/pull/2742).
-* Equality and hashcode access on uninitialized persistent collections will no more trigger their loading. See [#2461](https://github.com/nhibernate/nhibernate-core/pull/2461).
-* DB2CoreDriver now uses named parameters instead of positional ones. See [#2546](https://github.com/nhibernate/nhibernate-core/pull/2546).
+* `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.
 
 --
 

_posts/2023-12-24-nhibernate-5-5-released.md

@@ -0,0 +1,31 @@
+---
+layout: post
+title: "NHibernate 5.4 Released"
+date: 2022-11-20T17:20:00Z
+author: fredericDelaporte
+gravatar: 5eaae4002cdfc206faf907aaf38d8a09
+tags:
+  - Release Notes
+---
+NHibernate 5.4.0 is now released.
+
+For a list of resolved issues & pull requests, see the [milestone](https://github.com/nhibernate/nhibernate-core/milestone/36?closed=1) or [the release notes](https://github.com/nhibernate/nhibernate-core/blob/5.4.0/releasenotes.txt).
+
+Binaries are available on NuGet and SourceForge:
+- https://sourceforge.net/projects/nhibernate/files/NHibernate/5.4.0/
+- https://www.nuget.org/packages/NHibernate/5.4.0
+
+##### Highlights #####
+* NHibernate has gained three new target frameworks: .Net 6, .Net Framework 4.8 and .Net Standard 2.1. NHibernate NuGet package provides them, along with the older targets, .Net Core 2.0, .Net Framework 4.6.1 and .Net Standard 2.0. These new targets allow some NHibernate optimizations for applications using them. The same limitations apply for .Net 6 and .Net Standard 2.1 as for .Net Core 2.0 and .Net Standard 2.0, see NHibernate 5.1.0 release notes.
+* A new batching strategy is available, minimizing the batching memory footprint. See [#2959](https://github.com/nhibernate/nhibernate-core/pull/2959). Using it may increase CPU usage.
+* 201 issues were resolved in this release.
+
+##### Possible Breaking Changes #####
+* Linq and criteria queries on unmapped entities will throw instead of returning an empty result list. See [#1106](https://github.com/nhibernate/nhibernate-core/pull/1106), [#1095](https://github.com/nhibernate/nhibernate-core/pull/1095).
+* The second level cache UpdateTimestampsCache does not use locks anymore. This may slightly increase the number of cases where stale data is returned by the query cache. See [#2742](https://github.com/nhibernate/nhibernate-core/pull/2742).
+* Equality and hashcode access on uninitialized persistent collections will no more trigger their loading. See [#2461](https://github.com/nhibernate/nhibernate-core/pull/2461).
+* DB2CoreDriver now uses named parameters instead of positional ones. See [#2546](https://github.com/nhibernate/nhibernate-core/pull/2546).
+
+--
+
+Huge thanks to everyone involved in this release.

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>,

doc/nh/en/index.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>

doc/nh/en/nhibernate.reference.chm

@@ -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>