added comments by alberto

Author: nicola-giuliani

README.md

@@ -13,23 +13,23 @@ We provide the following capabilities
 - Automatic treatment of sharp edges via the double nodes technique.
 - Usage of Lagrangian Finite Elements of arbitrary order. We also provide interfaces with discontinuous elements.
 - Distributed memory (MPI) parallelisation of the standard collocation BEM for the Laplace equation.
-- Coupling with a FMM to get a performance improvement.
-- Hybrid Distributed (MPI) - Shared (TBB) memory parallelisation for the BEM-FMM code
+- Coupling with a Fast Multiple Method (FMM) to get a performance improvement.
+- Hybrid Distributed (MPI) - Shared (Intel Threaded Building Block) memory parallelisation for the BEM-FMM code
 - Recovery of both primal (potential) and dual (potential normal derivative) unknowns.
-- L2 projection  of the full 3D potential gradient for post processing.
+- L2 projection of the full 3D potential gradient for post processing.
 - Extensive tuning via parameter file using the [deal2lkit](https://github.com/mathLab/deal2lkit) library 
 
 
 ## Code Structure
 We have subdivided the code in main classes to handle the many different aspects of a complete BEM simulation.
 
-- Driver. This class is in charge of organising the overall BEM simulation. It has interfaces with all the other classes in order to have a complete simulation.
+- Driver. This class is in charge of organising the overall BEM simulation. It has interfaces with all the other classes in order to perform a complete simulation.
 - ComputationalDomain. This class handles, and provides to the other classes, ONLY the geometry of the problem. In particular
  - it handles the domain decomposition using a graph partitioning tool (METIS);
  - it reads the domain from an external file.
-- BoundaryCondition. The class handling the boundary conditions. In particular
+- BoundaryCondition. The class handles the boundary conditions. In particular
 	- it reads the boundary conditions for the potential and its normal derivative; 
-	- given the peculiarities of the BEM the boundary conditions represent the actual unknowns, thus it creates the vector containing the variables and fills them with the proper data;
+	- given the peculiarities of the BEM, the boundary conditions represent the actual unknowns, thus it creates the vectors containing the two variables and fills them with the proper data;
 	- it performs the error analysis on both unknowns.
 
 - BEMProblem. This class is the core of the BEM simulation
@@ -39,13 +39,15 @@ We have subdivided the code in main classes to handle the many different aspects
 	- it eventually interacts with the FMM accelerator.
 - BEMFMA. This class handles the accelerator, in particular
 	- it sets up an hierarchical 3D space subdivision (octree);
-	- it receives two distributed vectors representinf the unknowns and performs a full FMM matrix vector product.
+	- it receives two distributed vectors representing the unknowns and performs a full FMM matrix vector product.
 
 ## Install Procedure
 In order to successfully compile the code you need 
 
-- to install the [deal.II](https://github.com/dealii/dealii) library allowing both for multiprocessors and multithreaded environment.
 - to install the Trilinos and Metis wrappers of the library, see the official [instructions](https://www.dealii.org/developer/readme.html) 
+- to install the [deal.II](https://github.com/dealii/dealii) library allowing both for multiprocessors and multithreaded environment.
+- to install the [deal2lkit](https://github.com/mathLab/deal2lkit) library allowing both for multiprocessors and multithreaded environment.
+
 
 Then you can clone the repository and compile it
 

include/boundary_conditions.h

@@ -77,9 +77,9 @@
 #include <deal2lkit/utilities.h>
 
 /**
-* - BoundaryCondition. The class handling the boundary conditions. In particular
+* - BoundaryCondition. The class handles the boundary conditions. In particular
 *   - it reads the boundary conditions for the potential and its normal derivative;
-*   - given the peculiarities of the BEM the boundary conditions represent the actual unknowns, thus it creates the vector containing the variables and fills them with the proper data;
+*   - given the peculiarities of the BEM, the boundary conditions represent the actual unknowns, thus it creates the vectors containing the variables and fills them with the proper data;
 *   - it performs the error analysis on both unknowns.
 */
 template <int dim>