mpirun.1.rst: fix MPI_COMM_WORLD font

Put MPI_COMM_WORLD in fixed-width font.

Signed-off-by: Jeff Squyres <[email protected]>

Author: jsquyres

docs/man-openmpi/man1/mpirun.1.rst

@@ -262,7 +262,7 @@ To map processes:
 
 * ``--bynode``: Launch processes one per node, cycling by node in a
   round-robin fashion.  This spreads processes evenly among nodes and
-  assigns MPI_COMM_WORLD ranks in a round-robin, "by node" manner.
+  assigns ``MPI_COMM_WORLD`` ranks in a round-robin, "by node" manner.
   (deprecated in favor of ``--map-by node``)
 
 * ``--cpu-list <cpus>``: Comma-delimited list of processor IDs to
@@ -272,7 +272,7 @@ To map processes:
   .. note:: You can run Run the hwloc ``lstopo(1)`` command to see a
             list of available cores and their logical IDs.
 
-To order processes' ranks in MPI_COMM_WORLD:
+To order processes' ranks in ``MPI_COMM_WORLD``:
 
 * ``--rank-by <mode>``: Rank in round-robin fashion according to the
   specified mode, defaults to slot. Supported options include
@@ -311,15 +311,15 @@ To manage standard I/O:
   specified filename. Any directories in the filename will
   automatically be created.  Each output file will consist of
   ``filename.id``, where the ``id`` will be the processes' rank in
-  MPI_COMM_WORLD, left-filled with zero's for correct ordering in
+  ``MPI_COMM_WORLD``, left-filled with zero's for correct ordering in
   listings. A relative path value will be converted to an absolute
   path based on the cwd where mpirun is executed. Note that this will
   not work on environments where the file system on compute nodes
   differs from that where :ref:`mpirun(1) <man1-mpirun>` is
   executed.
 
-* ``--stdin <rank>``: The MPI_COMM_WORLD rank of the process that is
-  to receive stdin.  The default is to forward stdin to MPI_COMM_WORLD
+* ``--stdin <rank>``: The ``MPI_COMM_WORLD`` rank of the process that is
+  to receive stdin.  The default is to forward stdin to ``MPI_COMM_WORLD``
   rank 0, but this option can be used to forward stdin to any
   process. It is also acceptable to specify none, indicating that no
   processes are to receive stdin.
@@ -329,7 +329,7 @@ To manage standard I/O:
 
 * ``--tag-output``: Tag each line of output to stdout, stderr, and
   stddiag with ``[jobid, MCW_rank]<stdxxx>`` indicating the process
-  jobid and MPI_COMM_WORLD rank of the process that generated the
+  jobid and ``MPI_COMM_WORLD`` rank of the process that generated the
   output, and the channel which generated it.
 
 * ``--timestamp-output``: Timestamp each line of output to stdout,
@@ -342,7 +342,7 @@ To manage standard I/O:
   specified file.
 
 * ``--xterm <ranks>``: Display the output from the processes
-  identified by their MPI_COMM_WORLD ranks in separate xterm
+  identified by their ``MPI_COMM_WORLD`` ranks in separate xterm
   windows. The ranks are specified as a comma-separated list of
   ranges, with a ``-1`` indicating all. A separate window will be created
   for each specified process.
@@ -716,7 +716,7 @@ options that describe mapping policies.
 
 Consider the same hostfile as above, again with ``-n 6``.  The table
 below lists a few ``mpirun`` variations, and shows which
-MPI_COMM_WORLD ranks end up on which node:
+``MPI_COMM_WORLD`` ranks end up on which node:
 
 .. list-table::
    :header-rows: 1
@@ -832,7 +832,7 @@ Open MPI employs a three-phase procedure for assigning process locations
 and ranks:
 
 #. **Mapping**: Assigns a default location to each process
-#. **Ranking**: Assigns an MPI_COMM_WORLD rank value to each process
+#. **Ranking**: Assigns an ``MPI_COMM_WORLD`` rank value to each process
 #. **Binding**: Constrains each process to run on specific processors
 
 The mapping step is used to assign a default location to each process
@@ -864,7 +864,7 @@ gives you detailed control over process binding as well.  Rankfiles
 are discussed :ref:`below <man1-mpirun-rankfiles>`.
 
 The second phase focuses on the ranking of the process within the
-job's MPI_COMM_WORLD.  Open MPI separates this from the mapping
+job's ``MPI_COMM_WORLD``.  Open MPI separates this from the mapping
 procedure to allow more flexibility in the relative placement of MPI
 processes. This is best illustrated by considering the following
 cases where we used the ``--np 8 --map-by ppr:2:package --host aa:4,bb:4`` option:
@@ -1168,7 +1168,7 @@ Rankfiles are text files that specify detailed information about how
 individual processes should be mapped to nodes, and to which
 processor(s) they should be bound.  Each line of a rankfile specifies
 the location of one process (for MPI jobs, the process' "rank" refers
-to its rank in MPI_COMM_WORLD).  The general form of each line in the
+to its rank in ``MPI_COMM_WORLD``).  The general form of each line in the
 rankfile is:
 
 .. code::
@@ -1301,11 +1301,11 @@ Standard I/O
    retained, or removed?
 
 Open MPI directs UNIX standard input to ``/dev/null`` on all processes
-except the MPI_COMM_WORLD rank 0 process. The MPI_COMM_WORLD rank 0
+except the ``MPI_COMM_WORLD`` rank 0 process. The ``MPI_COMM_WORLD`` rank 0
 process inherits standard input from ``mpirun``.
 
 .. note:: The node that invoked ``mpirun`` need not be the same as the
-          node where the MPI_COMM_WORLD rank 0 process resides. Open
+          node where the ``MPI_COMM_WORLD`` rank 0 process resides. Open
           MPI handles the redirection of ``mpirun``'s standard input
           to the rank 0 process.
 
@@ -1322,7 +1322,7 @@ example:
 
    shell$ mpirun -n 2 my_app < my_input > my_output
 
-Note that in this example only the MPI_COMM_WORLD rank 0 process will
+Note that in this example only the ``MPI_COMM_WORLD`` rank 0 process will
 receive the stream from ``my_input`` on stdin.  The stdin on all the other
 nodes will be tied to ``/dev/null``.  However, the stdout from all nodes
 will be collected into the ``my_output`` file.
@@ -1645,15 +1645,15 @@ that job are designated "secondary" jobs):
 
 * If one or more processes in the primary job normally terminate with
   non-zero exit status, ``mpirun`` returns the exit status of the
-  process with the lowest MPI_COMM_WORLD rank to have a non-zero
+  process with the lowest ``MPI_COMM_WORLD`` rank to have a non-zero
   status.
 
 * If all processes in the primary job normally terminate with exit
   status 0, and one or more processes in a secondary job normally
   terminate with non-zero exit status, ``mpirun``:
 
   #. Returns the exit status of the process with the lowest
-     MPI_COMM_WORLD rank in the lowest jobid to have a non-zero
+     ``MPI_COMM_WORLD`` rank in the lowest jobid to have a non-zero
      status, and
   #. Outputs a message summarizing the exit status of the primary and
      all secondary jobs.
@@ -1707,7 +1707,7 @@ processes exited before calling :ref:`MPI_FINALIZE(3) <mpi_finalize>`.
 If an internal error occurred in mpirun, the corresponding error code
 is returned.  In the event that one or more processes exit before
 calling :ref:`MPI_FINALIZE(3) <mpi_finalize>`, the return value of
-the MPI_COMM_WORLD rank of the process that mpirun first notices died
+the ``MPI_COMM_WORLD`` rank of the process that mpirun first notices died
 before calling :ref:`MPI_FINALIZE(3) <mpi_finalize>` will be
 returned.  Note that, in general, this will be the first process that
 died but is not guaranteed to be so.