introduction.asciidoc

@@ -11,47 +11,47 @@ Introduction
 ------------
 
 [[aim-of-opal-and-history]]
-Aim of *OPAL* and History
+Aim of _OPAL_ and History
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-*OPAL* is a tool for charged-particle optics in accelerator structures
-and beam lines. Using the *mad* language with extensions, *OPAL* is
-derived from *mad9p* and is based on the *classic* class library, which
+_OPAL_ is a tool for charged-particle optics in accelerator structures
+and beam lines. Using the _mad_ language with extensions, _OPAL_ is
+derived from _mad9p_ and is based on the _classic_ class library, which
 was started in 1995 by an international collaboration. IPPL (Independent
 Parallel Particle Layer) is the framework which provides parallel
-particles and fields using data parallel approach. *OPAL* is built from
+particles and fields using data parallel approach. _OPAL_ is built from
 the ground up as a parallel application exemplifying the fact that HPC
 (High Performance Computing) is the third leg of science, complementing
 theory and the experiment. HPC is made possible now through the
 increasingly sophisticated mathematical models and evolving computer
-power available on the desktop and in super computer centers. *OPAL*
+power available on the desktop and in super computer centers. _OPAL_
 runs on your laptop as well as on the largest HPC clusters available
 today.
 
-The *OPAL* framework makes it easy to add new features in the form of
-new *C++* classes.
+The _OPAL_ framework makes it easy to add new features in the form of
+new _C++_ classes.
 
-*OPAL* comes in the following flavors:
+_OPAL_ comes in the following flavors:
 
-* *OPAL-cycl*
-* *OPAL-t*
+* _OPAL-cycl_
+* _OPAL-t_
 
-*OPAL-cycl* tracks particles with 3D space charge including neighboring
+_OPAL-cycl_ tracks particles with 3D space charge including neighboring
 turns in cyclotrons with time as the independent variable.
 
-*OPAL-t* is a super-set of *Impact-t* and can be used to model guns,
+_OPAL-t_ is a super-set of _Impact-t_ and can be used to model guns,
 injectors, ERLs and complete XFELs excluding the undulator.
 
-It should be noted that not all features of *OPAL* are available in both
+It should be noted that not all features of _OPAL_ are available in both
 flavors. +
 The following icon `DOPAL-t` means that a feature is not yet available
-in *OPAL-t*. A similar icon is used for *OPAL-cycl*.
+in _OPAL-t_. A similar icon is used for _OPAL-cycl_.
 
 [[parallel-processing-capabilities]]
 Parallel Processing Capabilities
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-*OPAL* is built to harness the power of parallel processing for an
+_OPAL_ is built to harness the power of parallel processing for an
 improved quantitative understanding of particle accelerators. This goal
 can only be achieved with detailed 3D modelling capabilities and a
 sufficient number of simulation particles to obtain meaningful
@@ -83,16 +83,16 @@ Quality Management
 
 Documentation and quality assurance are given our highest attention
 since we are convinced that adequate documentation is a key factor in
-the usefulness of a code like *OPAL* to study present and future
+the usefulness of a code like _OPAL_ to study present and future
 particle accelerators. Using tools such as a source code version control
 system (https://git-scm.com[git]), source code documentation using
 Doxygen (found http://amas.web.psi.ch/docs/opal/html/[here]) and the
 extensive user manual you are now enjoying, we are committed to
 providing users as well as co-developers with state-of-the-art
-documentation to *OPAL*.
+documentation to _OPAL_.
 
 One example of an non trivial test-example is the PSI DC GUN. In
-Figure <<guncomp1,2>> the comparison between *Impact-t* and *OPAL-t* is
+Figure <<guncomp1,2>> the comparison between _Impact-t_ and _OPAL-t_ is
 shown. This example is part of the regression test suite that is run
 every night. The input file is found in Section <<examplesbeamlines>>.
 
@@ -101,7 +101,7 @@ size. Comments and _active contributions_ from readers are therefore
 most welcome. They may be sent to `andreas.adelmann@psi.ch`.
 
 [#guncomp1]
-.Figure 2 : Comparison of energy and emittance in latexmath:[x] between *Impact-t* and *OPAL-t*
+.Figure 2 : Comparison of energy and emittance in latexmath:[x] between _Impact-t_ and _OPAL-t_
 image:figures/Gun/GunCompEn.png[width=375]
 image:figures/Gun/GunCompEx.png[width=375]
 
@@ -120,7 +120,7 @@ to a file with extension .stat. The frequency with which this data is
 written can be controlled with the `OPTION` statement
 see Section <<option>> with the flag `STATDUMPFREQ`.
 
-.Figure 3 : H5root enables a variety of data analysis and post processing task on *OPAL* data
+.Figure 3 : H5root enables a variety of data analysis and post processing task on _OPAL_ data
 image:figures/H5rootPicture1.png[width=250]
 image:figures/H5rootPicture2.png[width=250]
 image:figures/H5rootPicture3.png[width=250]
@@ -129,14 +129,14 @@ image:figures/H5rootPicture3.png[width=250]
 Change History
 ~~~~~~~~~~~~~~
 
-See Appendix <<changelog>> for a detailed list of changes in *OPAL*.
+See Appendix <<changelog>> for a detailed list of changes in _OPAL_.
 
 [[known-issues-and-limitations]]
 Known Issues and Limitations
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 [[opal-cycl]]
-*OPAL-cycl*
+_OPAL-cycl_
 ^^^^^^^^^^^
 
 * Restart with the option `PSDUMPLOCALFRAME` does not work yet,
@@ -149,7 +149,7 @@ Acknowledgments
 
 The contributions of various individuals and groups are acknowledged in
 the relevant chapters, however a few individuals have or had
-considerable influence on the development of *OPAL*, namely Chris
+considerable influence on the development of _OPAL_, namely Chris
 Iselin, John Jowett, Julian Cummings, Ji Qiang, Robert Ryne and Stefan
 Adam. For the `H5root`  visualization tool credits go to Thomas
 Schietinger.
@@ -162,7 +162,7 @@ and Tulin Kaman.
 Citation
 ~~~~~~~~
 
-Please cite *OPAL* in the following way:
+Please cite _OPAL_ in the following way:
 
 ....
 @techreport{opal:1,