Numerous updates to project documentation

doc/main.dox

@@ -1,8 +1,13 @@
 /** 
 @mainpage Overview
 
-EPANET is a program that performs extended period simulation of hydraulic and water quality behavior within pressurized pipe networks. A network can consist of pipes, nodes (pipe junctions), pumps, valves and storage tanks or reservoirs. EPANET tracks the flow of water in each pipe, the pressure at each node, the height of water in each tank, and the concentration of a chemical species throughout the network during a multi-time period simulation. In addition to chemical species, water age and source tracing can also be simulated. The EPANET Programmer's Toolkit is a library of functions (or API) that allow programmers to customize the use of EPANET's hydraulic and water quality solution engine to their own applications. Both EPANET and its toolkit were originally developed and are currently maintained by the U.S. Environmental Protection Agency (USEPA).
+EPANET is a program that performs extended period simulation of hydraulic and water quality behavior within water distribution system pipe networks. A network can consist of pipes, nodes (pipe junctions), pumps, valves and storage tanks or reservoirs. EPANET tracks the flow of water in each pipe, the pressure at each node, the height of water in each tank, and the concentration of a chemical species throughout the network during a multi-time period simulation. In addition to chemical species, water age and source tracing can also be simulated. The EPANET Programmer's Toolkit is a library of functions (or API) that allow programmers to customize the use of EPANET's hydraulic and water quality solution engine to their own applications. Both EPANET and its toolkit were originally developed and are currently maintained by the U.S. Environmental Protection Agency (USEPA).
 
+<table style = "border: 0px solid black">
+<tr><td style="vertical-align: top">
+@image html DistributionSystem.png
+@image latex DistributionSystem.eps
+</td><td style="vertical-align: top">
 The OWA-EPANET Toolkit is an open-source version of the original EPANET Toolkit that extends its capabilities by:
 - providing a full set of functions to set and retrieve values for all parameters contained in a network model
 - allowing networks to be built completely from function calls instead of from an input file
@@ -10,6 +15,8 @@ The OWA-EPANET Toolkit is an open-source version of the original EPANET Toolkit
 - adding the ability to use pressure dependent demands in hydraulic analyses
 - producing more robust results with regard to hydraulic convergence, low/zero flow conditions, and water quality mass balance
 - achieving faster run times for single period hydraulic analyses.
+</td></tr>
+</table>
 
 Before using the OWA-EPANET Toolkit one should be familiar with the way that EPANET represents a pipe network, the design and operating information it requires, and the steps it uses to simulate a network's behavior. The following topics provide some introductory material on these subjects:
 - @subpage DataModel "Network Data Model"
@@ -18,15 +25,20 @@ Before using the OWA-EPANET Toolkit one should be familiar with the way that EPA
 
 More detailed information can be obtained from reading the <a href="https://nepis.epa.gov/Adobe/PDF/P1007WWU.pdf">EPANET 2 Users Manual</a>.
 
-__Note:__ OWA (Open Water Analytics) exists on GitHub as an open community for the exchange of information and ideas related to computing in the water & wastewater industries. It's activities and code projects are neither affiliated with nor endorsed by the USEPA.
+__Note:__ <a href="https://github.com/OpenWaterAnalytics">OWA (Open Water Analytics)</a> exists on GitHub as an open community for the exchange of information and ideas related to computing in the water & wastewater industries. It's activities and code projects are neither affiliated with nor endorsed by the USEPA.
 */
 
 /**
 @page DataModel Network Data Model
 
 EPANET models a pipe network as a collection of links connected to nodes. The links represent pipes, pumps, and control valves. The nodes represent junctions, tanks, and reservoirs. The figure below illustrates how these objects can be connected to one another to form a network.
+
+<table style = "border: 0px solid black">
+<tr><td>
 @image html Network.png
 @image latex Network.eps
+</td></tr>
+</table>
 
 Junctions have a user-supplied water withdrawal rate (i.e., consumer demand) associated with them. Tanks are storage units whose water level changes over time. Reservoirs are boundary points where a fixed hydraulic head applies.
 
@@ -60,8 +72,13 @@ for more information on EPANET's data model.
 @page DataFlow Data Flow Diagram
 
 The EPANET Toolkit contains separate code modules for network building, hydraulic analysis, water quality analysis, and report generation. The data flow diagram for analyzing a pipe network is shown below. The processing steps depicted in this diagram can be summarized as follows:
+
+<table style = "border: 0px solid black">
+<tr><td>
 @image html DataFlow.png
 @image latex DataFlow.eps
+</td></tr>
+</table>
 
 - The network builder receives a description of the network being simulated either from an external input file (.inp) or from a series of function calls that create network objects and assign their properties via code. These data are stored in a Project data structure.  
 
@@ -84,8 +101,8 @@ with single threaded applications.
 analyzed concurrently.
 
 Both toolkit versions utilize identical function names and argument lists with the following exceptions:
-- Function names in the single-threaded library begin with `EN` while those in the multi-threaded
-library begin with `EN_`.
+- Function names in the single-threaded library begin with \b EN while those in the multi-threaded
+library begin with \b EN_.
 - The multi-threaded functions contain an additional argument that references a particular network project
 that the function is applied to.
 - The multi-threaded library contains two additional functions that allow users to create and delete