Link to step-83.

diff --git a/include/deal.II/base/discrete_time.h b/include/deal.II/base/discrete_time.h
index bb74b434ebb01f1d77f03bfb0218f60c4dcd9122..b7dc64c092c2957f7585f0479f041007b28102d7 100644 (file)
--- a/include/deal.II/base/discrete_time.h
+++ b/include/deal.II/base/discrete_time.h
@@ -25,7 +25,8 @@ DEAL_II_NAMESPACE_OPEN
  * $T_{\text{start}}$ to an end time $T_{\text{end}}$. It also allows adjusting
  * the time step size during the simulation. This class provides the necessary
  * interface to be incorporated in any time-dependent simulation.
- * The usage of this class is demonstrated in step-19 and step-21.
+ * The usage of this class is demonstrated in step-19 (and step-83) as well as
+ * step-21.
  *
  * This class provides a number of invariants that are guaranteed to be
  * true at all times.
@@ -404,6 +405,8 @@ public:
    * Write or read the data of this object to or from a stream for the purpose
    * of serialization using the [BOOST serialization
    * library](https://www.boost.org/doc/libs/1_74_0/libs/serialization/doc/index.html).
+   *
+   * This function is used in step-83.
    */
   template <class Archive>
   void

diff --git a/include/deal.II/grid/tria.h b/include/deal.II/grid/tria.h
index 3effb34c5676c2bcba3e067c11134c8e43667a40..d5eb9e8a7e5ee7c77ab0f3f8260ad3b68ec493aa 100644 (file)
--- a/include/deal.II/grid/tria.h
+++ b/include/deal.II/grid/tria.h
@@ -3672,6 +3672,8 @@ public:
    * Write and read the data of this object from a stream for the purpose
    * of serialization. using the [BOOST serialization
    * library](https://www.boost.org/doc/libs/1_74_0/libs/serialization/doc/index.html).
+   *
+   * This function is used in step-83.
    */
   template <class Archive>
   void

diff --git a/include/deal.II/particles/particle_handler.h b/include/deal.II/particles/particle_handler.h
index c6fd1fde6c3bb9cbebd3082f5ad5d05c1c551cee..4d9eada9bce29e1112b7ed0640cd7284b2c92a4f 100644 (file)
--- a/include/deal.II/particles/particle_handler.h
+++ b/include/deal.II/particles/particle_handler.h
@@ -56,7 +56,7 @@ namespace Particles
    *
    * For examples on how to use this class to track particles, store properties
    * on particles, and let the properties on the particles influence the
-   * finite-element solution see step-19, step-68, and step-70.
+   * finite-element solution see step-19, step-68, step-70, and step-83.
    */
   template <int dim, int spacedim = dim>
   class ParticleHandler : public Subscriptor
@@ -821,6 +821,8 @@ namespace Particles
     /**
      * Serialize the contents of this class using the [BOOST serialization
      * library](https://www.boost.org/doc/libs/1_74_0/libs/serialization/doc/index.html).
+     *
+     * This function is used in step-83.
      */
     template <class Archive>
     void
@@ -1321,13 +1323,15 @@ namespace Particles
   inline void
   ParticleHandler<dim, spacedim>::serialize(Archive &ar, const unsigned int)
   {
-    // Note that we do not serialize the particle data itself. Instead we
+    // Note that we do not serialize the particle data itself (i.e., the
+    // 'particles' member variable). Instead we
     // use the serialization functionality of the triangulation class, because
     // this guarantees that data is immediately shipped to new processes if
     // the domain is distributed differently after resuming from a checkpoint.
-    ar //&particles
-      &global_number_of_particles &global_max_particles_per_cell
-        &next_free_particle_index;
+    //
+    // See step-83 for how to serialize ParticleHandler objects.
+    ar &global_number_of_particles &global_max_particles_per_cell
+      &next_free_particle_index;
   }