Consolidated build files (2)

Author: jcandy

html/src/build.rst

@@ -6,25 +6,29 @@ First step
 
 You will need suitable python and fortran environments. There is detailed help for
 
-* :doc:`OSX users <build/pre_osx>` (MAC M2)
-* :doc:`Linux users <build/pre_linux>` (MINT, UBUNTU)
-* :doc:`Conda users, works on both OSX and Linux <build/pre_conda>` (CONDA_OMPI_GNU)
+* :ref:`Linux MINT/UBUNTU users <buildlinux>` 
+* :ref:`OSX users <buildosx>` 
+* :ref:`Conda users <buildconda>`
 
-If you need more help, please raise an issue at https://github.com/gafusion/gacode/issues
+If you need more help, please don't hesitate to raise an issue at https://github.com/gafusion/gacode/issues.
 
 Source code
 -----------
 
-You should clone the gacode repository from GitHub. This was you can keep you installation up to date::
+You should clone the gacode repository from GitHub. This was you can keep your installation up to date
 
-  $ git clone [email protected]:gafusion/gacode.git
+.. code::
+   
+   $ git clone [email protected]:gafusion/gacode.git
 
 Concept of platform files
 -------------------------
 
-In order to compile the full GACODE package on a new machine, a version of the **platform files** must be selected. You can use existing ones or create your own.  After cloning the repository, you can query the existing platforms using::
+In order to compile the full GACODE package on a new machine, a version of the **platform files** must be selected. You can use existing ones or create your own.  After cloning the repository, you can query the existing platforms using
 
-  $ ./gacode/shared/bin/gacode_platforms 
+.. code::
+   
+   $ ./gacode/shared/bin/gacode_platforms 
 
 If you decide to create new platform files (say, for a new platform MINE) then create the following files, starting from one of the existing ones (say, CONDA_OMPI_GNU)::
 

html/src/input_gacode.rst

@@ -3,14 +3,13 @@
 input.gacode
 ============
 
-.. |ip| replace:: :doc:`input.gacode <input_gacode>`
-
-To see what a sample |ip| looks like, at the command line type
+To see what a sample ``input.gacode`` looks like, at the command line type
 
 .. code:: bash
 
-	  $ cgyro -g reg14 ; cat reg14/input.gacode
+   $ cgyro -g reg14 ; cat reg14/input.gacode
 
+ 
 Overview
 --------
 

html/src/performance.rst

@@ -161,9 +161,6 @@ To switch from the collisionless to the collisional layout and back, we use a *c
 Parallel Performance and Scalability
 ------------------------------------
 
-\label{sec.performance}
-\vspace{-12pt}
-
 Strong-scaling performance
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -178,8 +175,7 @@ Part (a) of :numref:`fig.nl03` shows strong-scaling results for two CPU-only arc
    .. image:: images/performance/nl03_strong_frontier.png
    .. image:: images/performance/nl03_bar_frontier.png
 
-   The (a) Multi-platform strong-scaling comparison for CGYRO test case \texttt{nl03}, showing wallclock time vs. number of nodes. Frontier is by far the best performer on both a per-node and maximum performance basis. (b) Kernel-level analysis.  
-Left (darker) bars indicate compute time; right (faded) bars indicate the communication time.  Data is normalized to the total time, such  that total bar area is constant (1.0). Lower compute-to-communication ratio on GPU systems reflects the extremely high performance of the GPUs.  Note the significant improvement in communication management from Summit/Perlmutter to Frontier.}}
+   The (a) Multi-platform strong-scaling comparison for CGYRO test case \texttt{nl03}, showing wallclock time vs. number of nodes. Frontier is by far the best performer on both a per-node and maximum performance basis. (b) Kernel-level analysis. Left (darker) bars indicate compute time; right (faded) bars indicate the communication time.  Data is normalized to the total time, such  that total bar area is constant (1.0). Lower compute-to-communication ratio on GPU systems reflects the extremely high performance of the GPUs.  Note the significant improvement in communication management from Summit/Perlmutter to Frontier.
 
 
 Kernel-based performance analysis