doc: lots of code block clarifications

These changes also revealed some typos
and we fixed lots of links and codes that
were present.

Signed-off-by: Nick Papior <nickpapior@gmail.com>

Author: zerothi

docs/man-openmpi/man3/MPI_Accumulate.3.rst

@@ -145,7 +145,7 @@ The MPI standard prescribes portable Fortran syntax for the
 *TARGET_DISP* argument only for Fortran 90. FORTRAN 77 users may use the
 non-portable syntax
 
-::
+.. code-block:: fortran
 
         INTEGER*MPI_ADDRESS_KIND TARGET_DISP
 

docs/man-openmpi/man3/MPI_Add_error_class.3.rst

@@ -6,9 +6,7 @@ MPI_Add_error_class
 
 .. include_body
 
-::
-
-   MPI_Add_error_class - Creates a new error class and returns its value
+:ref:`MPI_Add_error_class` - Creates a new error class and returns its value
 
 
 SYNTAX

docs/man-openmpi/man3/MPI_Add_error_string.3.rst

@@ -6,9 +6,7 @@ MPI_Add_error_string
 
 .. include_body
 
-::
-
-   MPI_Add_error_string - Associates a string with an error code or class
+:ref:`MPI_Add_error_string` - Associates a string with an error code or class
 
 
 SYNTAX

docs/man-openmpi/man3/MPI_Address.3.rst

@@ -55,25 +55,24 @@ function. Returns the (byte) address of location.
 
 Example: Using :ref:`MPI_Address` for an array.
 
-::
+.. code-block:: fortran
 
    REAL A(100,100)
 
-|
-| INTEGER I1, I2, DIFF
-| CALL MPI_ADDRESS(A(1,1), I1, IERROR)
-| CALL MPI_ADDRESS(A(10,10), I2, IERROR)
-| DIFF = I2 - I1
-| ! The value of DIFF is 909*sizeofreal; the values of I1 and I2 are
-| ! implementation dependent.
+   INTEGER I1, I2, DIFF
+   CALL MPI_ADDRESS(A(1,1), I1, IERROR)
+   CALL MPI_ADDRESS(A(10,10), I2, IERROR)
+   DIFF = I2 - I1
+   ! The value of DIFF is 909*sizeof(real)
+   !the values of I1 and I2 are implementation dependent.
 
 
 NOTES
 -----
 
 This routine is provided for both Fortran and C programmers and may be
 useful when writing portable code. In the current release, the address
-returned by this routine will be the same as that produced by the C &
+returned by this routine will be the same as that produced by the C ``&``
 operator.
 
 C users may be tempted to avoid using :ref:`MPI_Address` and rely on the

docs/man-openmpi/man3/MPI_Aint_add.3.rst

@@ -73,7 +73,7 @@ in the same object referenced by *base*, as described in MPI-3.1 section
 correct MPI_Aint representation of the output address, as if the process
 that originally produced *base* had called:
 
-::
+.. code-block:: c
 
    MPI_Get_address ((char *) base + disp, &result);
 

docs/man-openmpi/man3/MPI_Allgather.3.rst

@@ -129,21 +129,23 @@ any other process.
 The outcome of a call to :ref:`MPI_Allgather` is as if all processes
 executed n calls to
 
-::
+.. code-block:: c
+
+     MPI_Gather(sendbuf, sendcount, sendtype, recvbuf, recvcount,
+                recvtype, root, comm);
 
-     MPI_Gather(sendbuf,sendcount,sendtype,recvbuf,recvcount,
-                recvtype,root,comm),
+     // for root = 0 , ..., n-1.
 
-for root = 0 , ..., n-1. The rules for correct usage of :ref:`MPI_Allgather`
+The rules for correct usage of :ref:`MPI_Allgather`
 are easily found from the corresponding rules for :ref:`MPI_Gather`.
 
 **Example:** The all-gather version of Example 1 in :ref:`MPI_Gather`. Using
 :ref:`MPI_Allgather`, we will gather 100 ints from every process in the group
 to every process.
 
-::
+.. code-block:: c
 
-   MPI_Comm comm;
+       MPI_Comm comm;
        int gsize,sendarray[100];
        int *rbuf;
        ...
@@ -167,12 +169,12 @@ receive its own contribution to the receive buffer. Specifically, the
 outcome of a call to :ref:`MPI_Allgather` that used the in-place option is
 identical to the case in which all processes executed *n* calls to
 
-::
+.. code-block:: c
 
       MPI_Allgather( MPI_IN_PLACE, 0, MPI_DATATYPE_NULL, recvbuf,
-      recvcount, recvtype, root, comm )
+                     recvcount, recvtype, root, comm )
 
-   for root =0, ... , n-1.
+      // for root =0, ... , n-1.
 
 Note that MPI_IN_PLACE is a special kind of value; it has the same
 restrictions on its use as MPI_BOTTOM.

docs/man-openmpi/man3/MPI_Allgatherv.3.rst

@@ -134,12 +134,14 @@ recvtype at any other process.
 
 The outcome is as if all processes executed calls to
 
-::
+.. code-block:: c
+
+   MPI_Allgatherv(sendbuf, sendcount, sendtype, recvbuf, recvcount,
+                 displs,recvtype,root,comm);
 
-   MPI_Allgatherv(sendbuf,sendcount,sendtype,recvbuf,recvcount,
-               displs,recvtype,root,comm)
+   // for root = 0 , ..., n-1.
 
-for root = 0 , ..., n-1. The rules for correct usage of :ref:`MPI_Allgatherv`
+The rules for correct usage of :ref:`MPI_Allgatherv`
 are easily found from the corresponding rules for :ref:`MPI_Gatherv`.
 
 
@@ -155,12 +157,12 @@ receive its own contribution to the receive buffer. Specifically, the
 outcome of a call to :ref:`MPI_Allgatherv` that used the in-place option is
 identical to the case in which all processes executed *n* calls to
 
-::
+.. code-block:: c
 
       MPI_Allgatherv ( MPI_IN_PLACE, 0, MPI_DATATYPE_NULL, recvbuf,
-      recvcounts, displs, recvtype, root, comm )
+                       recvcounts, displs, recvtype, root, comm );
 
-   for root =0, ... , n-1.
+      // for root =0, ... , n-1.
 
 Note that MPI_IN_PLACE is a special kind of value; it has the same
 restrictions on its use as MPI_BOTTOM.

docs/man-openmpi/man3/MPI_Allreduce.3.rst

@@ -117,7 +117,7 @@ of all the group members.
 array that are distributed across a group of processes and returns the
 answer at all nodes (compare with Example 2, with :ref:`MPI_Reduce`, below).
 
-::
+.. code-block:: fortran
 
    SUBROUTINE PAR_BLAS2(m, n, a, b, c, comm)
    REAL a(m), b(m,n)    ! local slice of array
@@ -143,7 +143,7 @@ answer at all nodes (compare with Example 2, with :ref:`MPI_Reduce`, below).
 array that are distributed across a group of processes and returns the
 answer at node zero.
 
-::
+.. code-block:: fortran
 
    SUBROUTINE PAR_BLAS2(m, n, a, b, c, comm)
    REAL a(m), b(m,n)    ! local slice of array

docs/man-openmpi/man3/MPI_Alltoallv.3.rst

@@ -145,7 +145,7 @@ process performs 2n (n being the number of processes in communicator
 *comm*) independent point-to-point communications (including
 communication with itself).
 
-::
+.. code-block:: c
 
    	MPI_Comm_size(comm, &n);
    	for (i = 0, i < n; i++)

docs/man-openmpi/man3/MPI_Alltoallw.3.rst

@@ -148,7 +148,7 @@ where each process performs 2n (n being the number of processes in
 communicator *comm) independent point-to-point communications*
 (including communication with itself).
 
-::
+.. code-block:: c
 
    	MPI_Comm_size(comm, &n);
    	for (i = 0, i < n; i++)