Merge branch 'slides/72-access-types-module-needs-a-better-comparison-between-pool-specific-and-general-access-types' into 'master'

Resolve "Access Types module needs a better comparison between pool-specific and general access types"

Closes #72

See merge request feng/training/material!269

Author: frank-at-adacore

courses/fundamentals_of_ada/140_access_types-advanced.rst renamed to courses/fundamentals_of_ada/140_access_types-in_depth.rst

@@ -1,5 +1,5 @@
 ***********************
-Advanced Access Types
+Access Types In Depth
 ***********************
 
 .. container:: PRELUDE BEGIN
@@ -43,5 +43,5 @@ Advanced Access Types
 .. include:: 140_access_types/08-memory_management.rst
 .. include:: 140_access_types/09-memory_debugging.rst
 .. include:: 140_access_types/10-memory_control.rst
-.. include:: labs/140_access_types-advanced.lab.rst
+.. include:: labs/140_access_types-in_depth.lab.rst
 .. include:: 140_access_types/99-summary_with_pools.rst

courses/fundamentals_of_ada/140_access_types/01-introduction.rst

@@ -45,6 +45,30 @@ Access Types Design
      int * G_C = &Some_Int;
 .
 
+-----------------------------------------
+Access Types - General vs Pool-Specific
+-----------------------------------------
+
+.. container:: columns
+
+  .. container:: column
+
+    **General Access Types**
+
+      * Point to any object of designated type
+      * Useful for creating aliases to existing objects
+      * Point to existing object via :ada:`'Access` **or** created by :ada:`new`
+      * No automatic memory management
+
+  .. container:: column
+
+    **Pool-Specific Access Types**
+
+      * Tightly coupled to dynamically allocated objects
+      * Used with Ada's controlled memory management (pools)
+      * Can only point to object created by :ada:`new`
+      * Memory management tied to specific storage pool
+
 -------------------------------
 Access Types Can Be Dangerous
 -------------------------------

courses/fundamentals_of_ada/advanced.txt

@@ -5,7 +5,7 @@
 080_expressions-with_quantified.rst
 120_limited_types.rst
 290_advanced_data_hiding.rst
-140_access_types-advanced.rst
+140_access_types-in_depth.rst
 160_genericity.rst
 170_tagged_derivation.rst
 175_multiple_inheritance.rst

courses/fundamentals_of_ada/labs/140_access_types-advanced.lab.rst renamed to courses/fundamentals_of_ada/labs/140_access_types-in_depth.lab.rst

@@ -3,7 +3,7 @@ Lab
 ========
 
 ---------------------------
-Advanced Access Types Lab
+Access Types In Depth Lab
 ---------------------------
 
 * Build an application that adds / removes items from a linked list
@@ -41,64 +41,64 @@ Extra Credit
 Lab Solution - Database
 -------------------------
 
-.. container:: source_include labs/answers/140_access_types-advanced.txt :start-after:--Database :end-before:--Database :code:Ada :number-lines:1
+.. container:: source_include labs/answers/140_access_types-in_depth.txt :start-after:--Database :end-before:--Database :code:Ada :number-lines:1
 
 -------------------------------------
 Lab Solution - Database_List (Spec)
 -------------------------------------
 
-.. container:: source_include labs/answers/140_access_types-advanced.txt :start-after:--Database_List_Spec :end-before:--Database_List_Spec :code:Ada :number-lines:1
+.. container:: source_include labs/answers/140_access_types-in_depth.txt :start-after:--Database_List_Spec :end-before:--Database_List_Spec :code:Ada :number-lines:1
 
 -----------------------------------------------
 Lab Solution - Database_List (Helper Objects)
 -----------------------------------------------
 
-.. container:: source_include labs/answers/140_access_types-advanced.txt :start-after:--Database_List_Helpers :end-before:--Database_List_Helpers :code:Ada :number-lines:1
+.. container:: source_include labs/answers/140_access_types-in_depth.txt :start-after:--Database_List_Helpers :end-before:--Database_List_Helpers :code:Ada :number-lines:1
 
 -----------------------------------------------
 Lab Solution - Database_List (Insert/Delete)
 -----------------------------------------------
 
-.. container:: source_include labs/answers/140_access_types-advanced.txt :start-after:--Database_List_Substance :end-before:--Database_List_Substance :code:Ada :number-lines:35
+.. container:: source_include labs/answers/140_access_types-in_depth.txt :start-after:--Database_List_Substance :end-before:--Database_List_Substance :code:Ada :number-lines:35
 
 ---------------------
 Lab Solution - Main
 ---------------------
 
-.. container:: source_include labs/answers/140_access_types-advanced.txt :start-after:--Main :end-before:--Main :code:Ada :number-lines:1
+.. container:: source_include labs/answers/140_access_types-in_depth.txt :start-after:--Main :end-before:--Main :code:Ada :number-lines:1
 
 ---------------------------------
 Lab Solution - Simple_IO (Spec)
 ---------------------------------
 
-.. container:: source_include labs/answers/140_access_types-advanced.txt :start-after:--Simple_IO_Spec :end-before:--Simple_IO_Spec :code:Ada :number-lines:1
+.. container:: source_include labs/answers/140_access_types-in_depth.txt :start-after:--Simple_IO_Spec :end-before:--Simple_IO_Spec :code:Ada :number-lines:1
 
 ---------------------------------
 Lab Solution - Simple_IO (Body)
 ---------------------------------
 
-.. container:: source_include labs/answers/140_access_types-advanced.txt :start-after:--Simple_IO_Body :end-before:--Simple_IO_Body :code:Ada :number-lines:1
+.. container:: source_include labs/answers/140_access_types-in_depth.txt :start-after:--Simple_IO_Body :end-before:--Simple_IO_Body :code:Ada :number-lines:1
 
 ------------------------------------------
 Lab Solution - Memory_Mgmt (Debug Pools)
 ------------------------------------------
 
-.. container:: source_include labs/answers/140_access_types-advanced.txt :start-after:--Memory_Mgmt_Debug :end-before:--Memory_Mgmt_Debug :code:Ada :number-lines:1
+.. container:: source_include labs/answers/140_access_types-in_depth.txt :start-after:--Memory_Mgmt_Debug :end-before:--Memory_Mgmt_Debug :code:Ada :number-lines:1
 
 -------------------------------------------------
 Lab Solution - Memory_Mgmt (Storage Pools Spec)
 -------------------------------------------------
 
-.. container:: source_include labs/answers/140_access_types-advanced.txt :start-after:--Memory_Mgmt_Spec :end-before:--Memory_Mgmt_Spec :code:Ada :number-lines:1
+.. container:: source_include labs/answers/140_access_types-in_depth.txt :start-after:--Memory_Mgmt_Spec :end-before:--Memory_Mgmt_Spec :code:Ada :number-lines:1
 
 ------------------------------------------------
 Lab Solution - Memory_Mgmt (Storage Pools 1/2)
 ------------------------------------------------
 
-.. container:: source_include labs/answers/140_access_types-advanced.txt :start-after:--Memory_Mgmt_Helpers :end-before:--Memory_Mgmt_Helpers :code:Ada :number-lines:1
+.. container:: source_include labs/answers/140_access_types-in_depth.txt :start-after:--Memory_Mgmt_Helpers :end-before:--Memory_Mgmt_Helpers :code:Ada :number-lines:1
 
 ------------------------------------------------
 Lab Solution - Memory_Mgmt (Storage Pools 2/2)
 ------------------------------------------------
 
-.. container:: source_include labs/answers/140_access_types-advanced.txt :start-after:--Memory_Mgmt_Substance :end-before:--Memory_Mgmt_Substance :code:Ada :number-lines:49
+.. container:: source_include labs/answers/140_access_types-in_depth.txt :start-after:--Memory_Mgmt_Substance :end-before:--Memory_Mgmt_Substance :code:Ada :number-lines:49